Skip to main content Home Skills Automation & Agents sage-wallet Interact with the Sage Chia blockchain wallet via RPC. Use for XCH transactions, CAT tokens, NFTs, DIDs, offers, options, coin management, and wallet configuration. Supports cross-platform setups (Mac/Linux/Windows) with configurable RPC endpoints and SSL certificates. Invoke with /sage commands or natural language like "send XCH", "check my NFTs", "create an offer", "mint a CAT token".
bunx add-skill moltbot/skills -s sage-wallet archive backup clawdbot clawdhub skill
Sage Wallet Skill
RPC interface to Sage wallet for Chia blockchain operations.
Configuration
User settings stored in {workspace}/config/sage-wallet.json:
{
"platform": "auto",
"rpc_url": "https://127.0.0.1:9257",
"cert_path": null,
"key_path": null,
"fingerprint": null,
"auto_login": false
}
Platform Defaults
Platform Cert Path Key Path mac ~/Library/Application Support/com.rigidnetwork.sage/ssl/wallet.crt...wallet.keylinux ~/.local/share/sage/ssl/wallet.crt...wallet.key
windows %APPDATA%\com.rigidnetwork.sage\ssl\wallet.crt...wallet.key
When platform is "auto", detect via uname -s.
Slash Commands
Configuration Command Action /sage statusShow config and test connection /sage configDisplay current settings /sage config platform <auto|mac|linux|windows>Set platform /sage config rpc <url>Set RPC URL /sage config cert <path>Set SSL cert path /sage config key <path>Set SSL key path /sage config fingerprint <fp>Set default wallet fingerprint /sage config autologin <on|off>Toggle auto-login /sage config resetReset to defaults
Operations Route to appropriate sub-skill based on domain:
Domain Sub-Skill Example Commands Auth & Keys sage-auth/sage login, /sage logout, /sage keysXCH sage-xch/sage send xch, /sage balance, /sage combineCAT Tokens sage-cat/sage cats, /sage send cat, /sage issue catNFTs sage-nft/sage nfts, /sage mint nft, /sage transfer nftDIDs sage-did/sage dids, /sage create didOffers sage-offers/sage offers, /sage make offer, /sage take offerOptions sage-options/sage options, /sage mint optionCoins sage-coins/sage coins, /sage check addressTransactions sage-txn/sage pending, /sage submitNetwork sage-network/sage peers, /sage networkSystem sage-system/sage sync, /sage versionWalletConnect sage-walletconnect/sage wc sign
Global Parameters All commands accept optional overrides:
--fingerprint <fp> β Use specific wallet--rpc <url> β Override RPC URL--cert <path> β Override cert path--key <path> β Override key path
Scripts
scripts/sage-config.sh β Config managementscripts/sage-rpc.sh β RPC caller with mTLS
Making RPC Calls # Source the RPC helper
source scripts/sage-rpc.sh
# Call an endpoint
sage_rpc "get_sync_status" '{}'
sage_rpc "send_xch" '{"address":"xch1...","amount":"1000000000000","fee":"100000000"}'
Sub-Skills Each sub-skill handles a specific domain. Load the appropriate one based on the operation:
Sub-Skill When to Load sage-auth Login, logout, key management, mnemonics sage-xch Send/receive XCH, combine, split coins sage-cat CAT token operations sage-nft NFT minting, transfers, collections sage-did DID creation and management sage-offers Offer creation, acceptance, cancellation sage-options Options protocol operations sage-coins Coin queries, address validation sage-txn Transaction signing, submission sage-network Peer and network settings sage-system Sync status, version, database sage-walletconnect WalletConnect integration
First Run
Check for config file; create if missing
Detect platform if set to "auto"
Verify cert/key files exist
If missing, prompt user to configure paths
Test connection with GetVersion
If certs not found, guide user:
Sage certificates not found. Configure with:
/sage config cert /path/to/wallet.crt
/sage config key /path/to/wallet.key
Error Handling RPC errors return HTTP status codes:
400 β Bad request (invalid params)401 β Unauthorized (cert mismatch)404 β Not found500 β Internal error Always check response for error field before processing data.
Amount Formatting Sage uses mojos (1 XCH = 1,000,000,000,000 mojos). The Amount type in requests/responses is a string representing mojos. Convert for display:
1 XCH = "1000000000000"
0.001 XCH = "1000000000"
