sage-auth

Sage Auth

Authentication and key management for Sage wallet.

Endpoints

Session Management

Endpoint	Payload	Description
login	{"fingerprint": 1234567890}	Login to wallet
logout	{}	End session

Key Management

Endpoint	Payload	Description
get_keys	{}	List all wallet keys
get_key	{"fingerprint": 1234567890}	Get specific key info
get_secret_key	{"fingerprint": 1234567890}	Get mnemonic (sensitive!)
generate_mnemonic	{"use_24_words": false}	Generate new mnemonic
import_key	See below	Import wallet from mnemonic
delete_key	{"fingerprint": 1234567890}	Delete wallet key
rename_key	{"fingerprint": 1234567890, "name": "My Wallet"}	Rename wallet
set_wallet_emoji	{"fingerprint": 1234567890, "emoji": "🌱"}	Set emoji

Import Key Payload

{
  "name": "My Wallet",
  "key": "abandon abandon abandon ... about",
  "derivation_index": 0,
  "hardened": true,
  "unhardened": true,
  "save_secrets": true,
  "login": true,
  "emoji": "🌱"
}

Database Management

Endpoint	Payload	Description
resync	{"fingerprint": 1234567890, "delete_coins": false, ...}	Resync wallet
delete_database	{"fingerprint": 1234567890, "network": "mainnet"}	Delete wallet DB

Themes

Endpoint	Payload	Description
get_user_themes	{}	List theme NFTs
get_user_theme	{"nft_id": "nft1..."}	Get specific theme
save_user_theme	{"nft_id": "nft1..."}	Save theme
delete_user_theme	{"nft_id": "nft1..."}	Delete theme

Examples

# Login
sage_rpc login '{"fingerprint": 1234567890}'

# List keys
sage_rpc get_keys '{}'

# Generate new mnemonic
sage_rpc generate_mnemonic '{"use_24_words": true}'

# Import wallet
sage_rpc import_key '{
  "name": "Trading Wallet",
  "key": "word1 word2 ... word24",
  "save_secrets": true,
  "login": true
}'

Security Notes

• get_secret_key returns the mnemonic — handle with extreme care
• Never log or store mnemonic in plaintext
• Use save_secrets: false for watch-only imports