Skip to content

Latest commit

 

History

148 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

💠 Coldstar -- Air-Gapped Solana Vault

Colosseum #62 Solana License: MIT GitHub stars Whitepaper

Programmable cold-signing infrastructure for Solana. Any USB drive becomes an air-gapped cold wallet. Air-gapped signing, FairScore reputation gating, Jupiter DEX integration, and native RWA support — built for DAOs, traders, and developers who need hardware-grade security without a $200 device. By ChainLabs Technologies.

Traction

  • 107 wallets created, 37 actively signing (35% retention)
  • Partnerships: Superteam IE, Superteam UK, DeAura, Bonk Advisory, Jito
  • Revenue: 1% transaction fee (capped at $10) + Jito staking tips + native RWA swaps

The Problem

Hardware wallets cost $50–$300, suffer data breaches, and aren't programmable. This blocks DAOs, traders, and developers from using cold security in practice.

The Solution

Air-gapped cold wallet + reputation-gated transactions + DeFi integration. Private keys never touch the network. Every outbound transfer is scored by FairScore before execution.

Create transaction online --> Sign on air-gapped USB --> Broadcast
                             Private keys NEVER touch the network

Install

git clone https://github.com/ExpertVagabond/coldstar-colosseum
cd coldstar-colosseum
pip install -r local_requirements.txt
python main.py

MCP Server (for AI agents)

npx coldstar-mcp
{
  "mcpServers": {
    "coldstar": {
      "command": "npx",
      "args": ["-y", "coldstar-mcp"],
      "env": { "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com" }
    }
  }
}

8 MCP tools: check_reputation, get_token_price, get_swap_quote, check_wallet_balance, validate_transaction, list_supported_tokens, get_portfolio, estimate_swap_cost

FairScore Reputation Gating

Every outbound transfer is gated by FairScale's FairScore API:

Tier Score Action Limit
Bronze 0-19 BLOCKED --
Silver 20-39 Warning 10 SOL
Gold 40-59 Proceed 100 SOL
Platinum 60-79 Proceed 500 SOL
Diamond 80-100 Proceed Unlimited

Features

  • Air-Gap Security -- Alpine Linux with network drivers blacklisted, QR code signing
  • DeFi Integration -- Jupiter DEX routes, Pyth price feeds, SPL token support
  • Reputation Gating -- FairScore blocks low-reputation recipients at infrastructure level
  • DAO Governance -- Multi-sig vaults, on-chain voting, air-gapped approval
  • Beautiful TUI -- Rich terminal UI with portfolio dashboard and USB flashing tool
  • Agent-Friendly -- MCP server with 8 tools for autonomous wallet operations

Architecture

ONLINE DEVICE                         OFFLINE DEVICE (Air-Gapped)
+--------------------------+          +---------------------------+
| Coldstar CLI             |   QR /   | USB Cold Wallet           |
| - Check balance (RPC)   |   USB    | - Private key storage     |
| - Get prices (Pyth)     | <------> | - Transaction signing     |
| - Create unsigned txs   |          | - ZERO network access     |
| - Query Jupiter routes  |          | - Alpine Linux (<50MB)    |
+--------------------------+          +---------------------------+

Comparison

Feature Coldstar Hardware Wallet Hot Wallet
Air-Gap Yes Yes No
Cost $10 $79-279 Free
Open Source Yes No Varies
DeFi / Jupiter Yes Limited Yes
Reputation Gating Yes No No
Agent-Friendly Yes No Risky
DAO Governance Yes No No

Tech Stack

Layer Technology
OS Alpine Linux (<50MB)
Language Python 3.11+
UI Rich (terminal)
Blockchain Solders (Solana Rust SDK)
DEX Jupiter Aggregator
Oracles Pyth Network
Reputation FairScale FairScore API
DAO Anchor Programs (devnet)

Deployed Infrastructure

Related Projects

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/my-feature)
  3. Commit your changes
  4. Open a Pull Request

Security Issues: Private advisory

Links

License

MIT -- ChainLabs Technologies

About

Air-gapped Solana cold wallet. Bootable USB + Alpine Linux, Ed25519 offline keygen, Rust secure signer with mlock/zeroize. Colosseum Agent #127.

Topics

Resources

Security policy

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages