sage-cat

Sage CAT Tokens

CAT (Chia Asset Token) operations.

Endpoints

Query CATs

Endpoint	Payload	Description
get_cats	{}	List wallet CATs
get_all_cats	{}	List all known CATs
get_token	{"asset_id": "a628..."}	Get token details

Token Metadata

Endpoint	Payload	Description
update_cat	{"record": {...}}	Update CAT metadata
resync_cat	{"asset_id": "a628..."}	Resync CAT balance

Send CAT

Endpoint	Description
send_cat	Send to single address
bulk_send_cat	Send to multiple addresses

send_cat

{
  "asset_id": "a628c1c2c6fcb74d53746157e438e108eab5c0bb3e5c80ff9b1910b3e4832913",
  "address": "xch1...",
  "amount": "1000",
  "fee": "100000000",
  "include_hint": true,
  "memos": [],
  "clawback": null,
  "auto_submit": true
}

bulk_send_cat

{
  "asset_id": "a628...",
  "addresses": ["xch1...", "xch1..."],
  "amount": "100",
  "fee": "100000000",
  "include_hint": true,
  "memos": [],
  "auto_submit": true
}

Issue CAT

Create new token:

{
  "name": "My Token",
  "ticker": "MYT",
  "amount": "1000000",
  "fee": "100000000",
  "auto_submit": true
}

Combine CAT Coins

{
  "asset_id": "a628...",
  "max_coins": 100,
  "max_coin_amount": "1000000",
  "fee": "100000000",
  "auto_submit": true
}

Token Record Structure

{
  "asset_id": "a628c1c2...",
  "name": "Spacebucks",
  "ticker": "SBX",
  "balance": "1000000",
  "icon_url": "https://...",
  "visible": true
}

Examples

# List CATs
sage_rpc get_cats '{}'

# Send CAT
sage_rpc send_cat '{
  "asset_id": "a628c1c2c6fcb74d53746157e438e108eab5c0bb3e5c80ff9b1910b3e4832913",
  "address": "xch1recipient...",
  "amount": "100",
  "fee": "100000000",
  "auto_submit": true
}'

# Issue new token
sage_rpc issue_cat '{
  "name": "Community Token",
  "ticker": "COM",
  "amount": "21000000",
  "fee": "100000000",
  "auto_submit": true
}'

Notes

• CAT amounts are in the token's smallest unit (no decimals)
• include_hint adds the asset_id to help receivers identify the token
• Asset IDs are 64-character hex strings