sage-walletconnect

name	sage-walletconnect
description	Sage WalletConnect integration. Filter coins, get asset coins, sign messages, send transactions for dApp connectivity.

Sage WalletConnect

WalletConnect protocol integration for dApp connectivity.

Endpoints

Coin Operations

Endpoint	Payload	Description
filter_unlocked_coins	{"coin_ids": [...]}	Filter to unlocked
get_asset_coins	See below	Get spendable coins

get_asset_coins Payload

{
  "type": "cat",
  "asset_id": "a628c1c2...",
  "included_locked": false,
  "offset": 0,
  "limit": 50
}

Asset types: "cat", "did", "nft"

Message Signing

Endpoint	Payload	Description
sign_message_with_public_key	{"message": "...", "public_key": "0x..."}	Sign with pubkey
sign_message_by_address	{"message": "...", "address": "xch1..."}	Sign with address key

Transaction

Endpoint	Payload	Description
send_transaction_immediately	{"spend_bundle": {...}}	Direct broadcast

Spendable Coin Structure

{
  "coin": {
    "parent_coin_info": "0x...",
    "puzzle_hash": "0x...",
    "amount": 1000000000000
  },
  "coin_name": "0x...",
  "puzzle": "0x...",
  "confirmed_block_index": 1234567,
  "locked": false,
  "lineage_proof": {
    "parent_name": "0x...",
    "inner_puzzle_hash": "0x...",
    "amount": 1000
  }
}

Sign Message Response

{
  "public_key": "0x...",
  "signature": "0x..."
}

Send Transaction Response

{
  "status": 1,
  "error": null
}

Status: 1 = success, other = error

Examples

# Filter unlocked coins
sage_rpc filter_unlocked_coins '{"coin_ids": ["0xabc...", "0xdef..."]}'

# Get CAT coins for WalletConnect
sage_rpc get_asset_coins '{
  "type": "cat",
  "asset_id": "a628c1c2...",
  "limit": 20
}'

# Sign message with address
sage_rpc sign_message_by_address '{
  "message": "Login to MyDApp",
  "address": "xch1abc..."
}'

# Sign with specific pubkey
sage_rpc sign_message_with_public_key '{
  "message": "Verify ownership",
  "public_key": "0x89abcdef..."
}'

# Send transaction directly
sage_rpc send_transaction_immediately '{
  "spend_bundle": {
    "coin_spends": [...],
    "aggregated_signature": "0x..."
  }
}'

WalletConnect Flow

1. dApp requests connection
2. User approves in Sage
3. dApp calls get_asset_coins to find spendable coins
4. dApp builds transaction
5. User signs via sign_message_* or transaction signing
6. dApp broadcasts or calls send_transaction_immediately

Notes

• WalletConnect enables dApp ↔ wallet communication
• lineage_proof is required for CAT spends
• Message signing proves address ownership without spending