The Solana wallet service owns Solana key derivation, transaction signing, and transaction broadcast for the Solana mediator. The mediator calls this service instead of holding private keys directly.
The wallet derives a Solana account from the Keymaster mnemonic using the configured SLIP-0010/BIP-44 derivation path. The default path is m/44'/501'/0'/0'.
All wallet endpoints are under /api/v1. The X-Archon-Admin-Key header is mandatory on every route except GET /wallet/version: if ARCHON_ADMIN_API_KEY is unset, guarded endpoints return 403 Admin API key not configured; if it is set but the request header is missing or wrong, they return 401.
| endpoint | description |
|---|---|
GET /wallet/version |
Returns { version, commit }; the only endpoint that does not require an admin key |
POST /wallet/setup |
Re-derives the wallet keypair and returns { ok, address, network } |
GET /wallet/address |
Returns the derived Solana funding address |
GET /wallet/balance |
Returns SOL balance |
GET /wallet/info |
Returns address, balance, balanceLamports, slot, network, and derivation path |
POST /wallet/airdrop |
Requests SOL on devnet, testnet, or local networks (rejected on mainnet-beta) |
POST /wallet/send |
Sends SOL |
POST /wallet/anchor |
Publishes an Archon batch memo |
GET /wallet/transaction/:txid |
Returns signature confirmation status |
| variable | default | description |
|---|---|---|
ARCHON_WALLET_PORT |
4262 |
HTTP API port |
ARCHON_WALLET_METRICS_PORT |
4263 |
Metrics server port |
ARCHON_KEYMASTER_URL |
http://localhost:4226 |
Keymaster service URL |
ARCHON_ADMIN_API_KEY |
none | Admin API key for service-to-service calls |
ARCHON_WALLET_SOL_NETWORK |
ARCHON_SOL_NETWORK or mainnet-beta |
mainnet-beta, devnet, testnet, or local |
ARCHON_WALLET_SOL_RPC_URL |
ARCHON_SOL_RPC_URL or network derived |
Solana JSON-RPC endpoint |
ARCHON_WALLET_SOL_COMMITMENT |
ARCHON_SOL_COMMITMENT or confirmed |
Solana commitment |
ARCHON_SOL_MEMO_PROGRAM_ID |
Memo program | Solana Memo program ID used for anchors |
ARCHON_WALLET_SOL_DERIVATION_PATH |
m/44'/501'/0'/0' |
HD derivation path |