sage-txn - SKILL.md Agent Skill

name: sage-txn description: Sage transaction operations. List transactions, sign coin spends, view without signing, submit transactions.

Sage Transactions

Transaction signing and submission.

Endpoints

Query Transactions

Endpoint	Payload	Description
`get_transactions`	See below	List transactions
`get_transaction`	`{"height": 1234567}`	Get by height
`get_pending_transactions`	`{}`	List pending

get_transactions Payload

{
  "offset": 0,
  "limit": 50,
  "ascending": false,
  "find_value": null
}

Sign & Submit

Endpoint	Payload	Description
`sign_coin_spends`	See below	Sign transaction
`view_coin_spends`	`{"coin_spends": [...]}`	Preview without signing
`submit_transaction`	`{"spend_bundle": {...}}`	Broadcast

sign_coin_spends

{
  "coin_spends": [
    {
      "coin": {
        "parent_coin_info": "0x...",
        "puzzle_hash": "0x...",
        "amount": 1000000000000
      },
      "puzzle_reveal": "0x...",
      "solution": "0x..."
    }
  ],
  "auto_submit": false,
  "partial": false
}

partial: true for multi-sig partial signatures

submit_transaction

{
  "spend_bundle": {
    "coin_spends": [...],
    "aggregated_signature": "0x..."
  }
}

Transaction Record Structure

{
  "height": 1234567,
  "timestamp": 1700000000,
  "fee": "100000000",
  "inputs": [...],
  "outputs": [...]
}

Pending Transaction Structure

{
  "transaction_id": "0x...",
  "fee": "100000000",
  "submitted_at": 1700000000,
  "coin_spends": [...]
}

Examples

# List recent transactions
sage_rpc get_transactions '{"limit": 20, "ascending": false}'

# Get pending
sage_rpc get_pending_transactions '{}'

# View coin spends (preview)
sage_rpc view_coin_spends '{"coin_spends": [...]}'

# Sign and submit
sage_rpc sign_coin_spends '{
  "coin_spends": [...],
  "auto_submit": true
}'

# Manual submit
sage_rpc submit_transaction '{"spend_bundle": {...}}'

Workflow

Build coin spends (from other endpoints with auto_submit: false)
Optionally view_coin_spends to preview
sign_coin_spends to create spend bundle
submit_transaction to broadcast (or use auto_submit: true)

Notes

auto_submit: true signs and broadcasts in one call
partial: true for multi-signature workflows
Pending transactions await mempool confirmation