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.
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
- Air-Gap Isolation: Private keys never touch internet-connected systems
- Minimal OS: Alpine Linux reduces attack surface to ~50MB
- Secure Memory: Cryptographic material is wiped from RAM after use
- No Proprietary Hardware: Works with commodity USB drives ($5-10)
- Full Transparency: 100% open-source codebase (Python + Rust)
- 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
- Organization: Purple Squirrel Media
- Maintainer: Matthew Karsten
- Email: matthew@purplesquirrelmedia.io
- Twitter: @buildcoldstar