How kaspahub21/kaspire-kaspa-wallet works
Kaspire is a self-custody Kaspa wallet for Android and Chromium browsers. A user initiates wallet actions in either client; the Rust security core derives keys, validates transaction data, constructs transactions, and signs locally, while network services supply untrusted blockchain or marketplace data. The repository also contains covenant-language tooling and NFT marketplace services. The README documents the client/security boundary and major capabilities; sampled source confirms only selected internal calls, so other relationships are omitted rather than inferred.
Main entry points: lib.rs Secure core · MainActivity.kt Android wallet · wallet.ts Browser extension · offer-service.ts NFT offers
Components 25
Wallet clients
- Android wallet
apps/mobile_flutter/android/app/src/main/kotlin/space/kasvault/wallet/MainActivity.kt - Browser extension
apps/browser_extension/src/ui/wallet.ts - Injected provider
apps/browser_extension/src/inpage/provider.ts
Signing and security
- Secure core
crates/kaspa_secure_core/src/lib.rs - Android JNI
crates/kaspa_secure_core/src/android.rs - Transaction validation
crates/kaspa_secure_core/src/transaction.rs - P2SH account
crates/kaspa_secure_core/src/hidden_kas.rs - Vault recovery
crates/kaspa_secure_core/src/vault_recovery.rs
Kaspa asset features
- dot.k names
crates/kaspa_secure_core/src/dotk.rs - KCC20 tokens
crates/kaspa_secure_core/src/kcc20.rs - Braid assets
crates/kaspa_secure_core/src/braid.rs - Covenant vaults
crates/kaspa_secure_core/src/covenant_vault.rs
Market services
- K-Agora sales
crates/kaspa_secure_core/src/dotk_market.rs - KasForge swaps
crates/kaspa_secure_core/src/kasforge.rs - KForge swaps
crates/kaspa_secure_core/src/kforge.rs - NFT market
crates/kaspa_secure_core/src/nft_market.rs - NFT Nexus
services/nft-nexus/src/server/services/nft-service.ts - NFT offers
services/nft-nexus/src/server/services/offer-service.ts - Nexus database
services/nft-nexus/src/lib/db/prisma.ts
Covenant tooling
- SilverScript compiler
crates/silverscript_lang/compiler/compile.rs - Static checker
crates/silverscript_lang/compiler/static_check.rs - Covenant declarations
crates/silverscript_lang/compiler/covenant_declarations.rs
Other components
- Android user
- Web dApp
- Kaspa network
Connections 27
- Android user → Android wallet: uses
README.md - Web dApp → Injected provider: requests access
README.md - Injected provider → Browser extension: forwards approved requests
- Android wallet → Android JNI: invokes JNI
README.md - Android JNI → Secure core: calls Rust core
crates/kaspa_secure_core/src/lib.rs - Browser extension → Secure core: uses packaged WASM
README.md - Secure core → Transaction validation: validates and builds
crates/kaspa_secure_core/src/lib.rs - Android wallet → Kaspa network: fetches blockchain data
README.md - Browser extension → Kaspa network: fetches blockchain data
README.md - Secure core → P2SH account: provides account logic
crates/kaspa_secure_core/src/lib.rs - Secure core → Vault recovery: provides recovery logic
crates/kaspa_secure_core/src/lib.rs - Secure core → dot.k names: derives names
README.md - Android wallet → K-Agora sales: offers K-Agora
README.md - Browser extension → K-Agora sales: offers K-Agora
README.md - Secure core → KCC20 tokens: provides token logic
crates/kaspa_secure_core/src/lib.rs - Braid assets → KCC20 tokens: uses token routines
crates/kaspa_secure_core/src/braid.rs - Secure core → KasForge swaps: provides swap logic
crates/kaspa_secure_core/src/lib.rs - Secure core → KForge swaps: provides swap logic
crates/kaspa_secure_core/src/lib.rs - Android wallet → Covenant vaults: offers vaults
README.md - Secure core → Covenant vaults: builds and signs vault transactions
crates/kaspa_secure_core/src/covenant_vault.rs - Android wallet → NFT market: supports NFT markets
- Browser extension → NFT market: supports NFT markets
- NFT Nexus → Nexus database: stores snapshots
- NFT offers → NFT Nexus: refreshes NFT snapshots
services/nft-nexus/src/server/services/offer-service.ts - NFT offers → Nexus database: persists offers
- SilverScript compiler → Covenant declarations: lowers declarations
crates/silverscript_lang/compiler/compile.rs - SilverScript compiler → Static checker: runs checks
crates/silverscript_lang/compiler/compile.rs