Coldstar: Air-Gapped Cold Wallet for Solana

Technical whitepaper and documentation for Coldstar β€” an open-source, command-line cold wallet management tool for the Solana blockchain that prioritizes security through air-gapped transaction signing.

Website GitHub Colosseum

Abstract

Coldstar is an open-source, command-line cold wallet management tool for the Solana blockchain that prioritizes security through air-gapped transaction signing. This whitepaper describes the implementation β€” a Python-based CLI application that enables users to create bootable USB cold wallets, generate Ed25519 keypairs offline, and sign transactions without network exposure.

By leveraging Alpine Linux as a minimal operating system and industry-standard cryptographic libraries, Coldstar provides enterprise-grade security with full code transparency and reproducibility.

Key Features

  • Complete air-gap isolation during private key generation and transaction signing
  • Minimal Alpine Linux (~50MB) bootable USB creation
  • Python-based terminal interface with rich UI components
  • Ed25519 cryptographic operations using audited libraries
  • Offline transaction signing with online broadcasting separation
  • Rust secure signer module for hardware-level key protection
  • Cross-platform support (Windows, Linux, macOS)

Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚     HOST SYSTEM (Online)      β”‚     β”‚   COLD WALLET (Air-Gapped)   β”‚
β”‚                                β”‚     β”‚                                β”‚
β”‚  β€’ Transaction creation        β”‚     β”‚  β€’ Key generation              β”‚
β”‚  β€’ Broadcasting signed tx      │────▢│  β€’ Transaction signing         β”‚
β”‚  β€’ Balance checking            │◀────│  β€’ Alpine Linux USB boot       β”‚
β”‚  β€’ Network communication       β”‚ QR  β”‚  β€’ Secure memory wiping        β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Documents

Document Description
whitepaper.md Full technical whitepaper (36 KB)
documentation/ARCHITECTURE.md System architecture deep-dive
documentation/INTEGRATION_GUIDE.md Integration and deployment guide
documentation/IMPLEMENTATION_SUMMARY.md Implementation details
documentation/RUST_INTEGRATION_COMPLETE.md Rust secure signer module
documentation/SECURE_SIGNER_README.md Secure signer documentation
documentation/INSTALL.md Installation guide
documentation/FIRST_BOOT_QUICKSTART.md First boot quick start
documentation/CHANGELOG.md Version history

Security Model

  1. Air-Gap Isolation: Private keys never touch internet-connected systems
  2. Minimal OS: Alpine Linux reduces attack surface to ~50MB
  3. Secure Memory: Cryptographic material is wiped from RAM after use
  4. No Proprietary Hardware: Works with commodity USB drives ($5-10)
  5. Full Transparency: 100% open-source codebase (Python + Rust)
  6. Ed25519: Industry-standard elliptic curve cryptography

Technical Stack

Component Technology
Language Python 3.x + Rust
Crypto Ed25519 (NaCl/libsodium)
Boot OS Alpine Linux
Blockchain Solana
Signing Rust secure signer (mlock, zeroize)
UI Rich terminal interface
Transfer QR codes (air-gap bridge)

Related Resources

Resource Link
Live Site coldstar.dev
Colosseum Entry Agent #127, Project #62
GitHub (Public) coldstar-colosseum
Purple Squirrel AI Collection Full Collection
AIDP Neural Cloud Paper aidp-neural-cloud-paper

Citation

@techreport{coldstar-whitepaper-2025,
  title={COLDSTAR: A Python-Based Air-Gapped Cold Wallet Tool for Solana},
  author={Syrem and Karsten, Matthew},
  year={2025},
  institution={ChainLabs Technologies / Purple Squirrel Media},
  note={Technical Whitepaper v1.0.0},
  url={https://coldstar.dev}
}

License

MIT

Contact

Downloads last month

-

Downloads are not tracked for this model. How to track
Inference Providers NEW
This model isn't deployed by any Inference Provider. πŸ™‹ Ask for provider support

Collection including purplesquirrelnetworks/coldstar-whitepaper