All documents

Start here

  1. Overview
  2. Installation
  3. macOS quick start
  4. macOS USB support
  5. Plug-in checks: quick reference

How it works

  1. Architecture
  2. Security
  3. Rust secure signer
  4. Whitepaper
  5. Plug-in checks
  6. Plug-in checks: implementation
  7. Wallet generation
  8. Automatic wallet generation
  9. USB flash process
  10. USB flash: step 7 reference

Integration

  1. Integration guide
  2. Integration status
  3. Rust integration

Project

  1. Changelog
  2. Implementation summary
  3. Project status
  4. Deliverables
Source: documentation/STEP7_QUICK_REFERENCE.md Repo commit 76db186

Step 7 Implementation - Quick Reference

What Changed?

BEFORE: 6-step flash process Manual wallet creation later
AFTER: 7-step flash process Wallet AUTO-GENERATED in Step 7

The 7 Steps

  1. [1/7] Download Alpine Linux

  2. [2/7] Extract filesystem

  3. [3/7] Configure offline OS

  4. [4/7] Configure Python

  5. [5/7] Create bootable image

  6. [6/7] Flash to USB

  7. [7/7] Generate wallet NEW!

What Step 7 Does

  1. Generates Solana keypair (Ed25519)

  2. Prompts user for encryption password

  3. Encrypts private key (Argon2i + XSalsa20-Poly1305)

  4. Saves keypair.json (encrypted)

  5. Saves pubkey.txt (wallet address)

  6. Clears keypair from memory

  7. Displays public key to user

  8. Wallet is ready!

Files Modified

src/iso_builder.py

  • Added _generate_wallet_on_usb() method
  • Updated flash methods to call Step 7
  • Changed all steps from /6 to /7

main.py

  • Updated process description
  • Added wallet display after flash
  • Changed steps from /6 to /7

USB Structure After Flash

D:\
├── wallet/
│   ├── keypair.json    🔐 Encrypted private key
│   └── pubkey.txt      📍 Wallet address
├── inbox/              📥 Unsigned transactions
├── outbox/             📤 Signed transactions
└── README.txt          📄 Instructions

Usage

RECEIVE SOL:

Share public key Others send SOL Done!

SEND SOL:

Mount USB Enter password Sign Broadcast

Security

Password-protected
Argon2i key derivation
XSalsa20-Poly1305 encryption
Memory cleared after use
Secure file permissions

Benefits

Immediate use - Ready to receive SOL
Time saving - No manual wallet gen
Easy - Less technical knowledge needed
Secure - Same encryption as before
Convenient - One-command setup

Testing

python main.py
# → Flash Cold Wallet to USB
# → Follow 7 steps
# → Wallet generated in Step 7
# → Public key displayed
# → USB ready to use!

Key Methods

iso_builder.py:

  • _generate_wallet_on_usb(mount_point)
  • _flash_to_usb_windows() [calls Step 7]
  • _flash_to_usb_linux() [calls Step 7]

main.py:

  • flash_cold_wallet() [displays wallet info]

Important Notes

Remember password - Cannot recover without it!
Write down public key - Needed to receive SOL
Keep USB secure - Contains encrypted key
Offline signing - Maximum security

Documentation Created

IMPLEMENTATION_SUMMARY.md - Complete summary
WALLET_GENERATION_UPDATE.md - Detailed docs
STEP7_VISUAL_GUIDE.md - Visual guide
STEP7_CODE_FLOW.py - Code flow
STEP7_QUICK_REFERENCE.md - This file

Ready to Use!

*B - Love U 3000 *