Overview
This page lists only the Spark CLI commands that were personally verified to work in local testing. Commands not listed here were not verified in this pass and are intentionally omitted.Verification scope
- Date: January 28, 2026
- Environment: local dev build via
cargo run -p openagents-cli --bin oa -- ... - Network:
testnet(Spark SDK maps testnet/signet to regtest) - Auth:
SPARK_MNEMONICset to a BIP39 seed; no API key required for regtest
CLI entrypoints
Both binaries behave the same:openagentsoa
oa.
Verified commands
Key management
Wallet basics
Receive
Send
Send a Spark invoice:Payments
Parse inputs
Deposits
Fiat helpers
Tokens (metadata only)
Message signing
Optimization
Settings
Notes
- Mainnet requires an API key; regtest/testnet does not.
- For wallet commands, you can pass the mnemonic via
--mnemonic,--mnemonic-file,--stdin, or setSPARK_MNEMONIC. - Commands not listed here were not verified in this pass (e.g., LNURL, lightning address, faucet, issuer operations, on-chain claim/refund flows).
Known issues / unverified commands
oa spark wallet sync: returned{}then the process logged a backgroundh2panic (state=Closed(ScheduledLibraryReset(CANCEL))). The command itself returned successfully, but this needs investigation in the SDK/runtime.oa spark lightning-address check|get|register|delete: not verified; CLI failed with “LNURL server is not configured”.oa spark lnurl prepare|pay|withdraw: not verified (no LNURL endpoint available in test env).oa spark faucet: not verified (faucet auth required).oa spark tokens issuer ...: not verified; balance returned “No issuer token found”.oa spark deposits claim|refund: not verified (no unclaimed deposits available).oa spark send --token-identifier ...: not verified; token send failed with “No payment created from token invoice”.