modbender Sage XCH Transactions
XCH (Chia) transaction operations.
Amount Format
All amounts in mojos (string): 1 XCH = "1000000000000"
Endpoints
Send XCH
| Endpoint | Description |
|---|---|
send_xch |
Send to single address |
bulk_send_xch |
Send to multiple addresses |
multi_send |
Send multiple asset types |
send_xch
{
"address": "xch1...",
"amount": "1000000000000",
"fee": "100000000",
"memos": ["optional memo"],
"clawback": null,
"auto_submit": true
}
bulk_send_xch
{
"addresses": ["xch1...", "xch1..."],
"amount": "100000000000",
"fee": "100000000",
"memos": [],
"auto_submit": true
}
multi_send
{
"payments": [
{"asset_id": null, "address": "xch1...", "amount": "1000000000000", "memos": []},
{"asset_id": "a628c1c2...", "address": "xch1...", "amount": "1000", "memos": []}
],
"fee": "100000000",
"auto_submit": true
}
Coin Management
| Endpoint | Payload | Description |
|---|---|---|
combine |
{"coin_ids": [...], "fee": "...", "auto_submit": true} |
Merge coins |
split |
{"coin_ids": [...], "output_count": 10, "fee": "...", "auto_submit": true} |
Split coin |
auto_combine_xch |
See below | Auto-merge small coins |
auto_combine_xch
{
"max_coins": 500,
"max_coin_amount": "1000000000000",
"fee": "100000000",
"auto_submit": true
}
Clawback
| Endpoint | Payload | Description |
|---|---|---|
finalize_clawback |
{"coin_ids": [...], "fee": "...", "auto_submit": true} |
Complete clawback |
Response Format
All transaction endpoints return:
{
"summary": {
"fee": "100000000",
"inputs": [...],
"outputs": [...]
},
"coin_spends": [...]
}
Examples
# Send 1 XCH
sage_rpc send_xch '{
"address": "xch1abc...",
"amount": "1000000000000",
"fee": "100000000",
"auto_submit": true
}'
# Combine dust
sage_rpc auto_combine_xch '{
"max_coins": 100,
"fee": "50000000",
"auto_submit": true
}'
Clawback Feature
Send with clawback (recoverable for N seconds):
{
"address": "xch1...",
"amount": "1000000000000",
"fee": "100000000",
"clawback": 86400,
"auto_submit": true
}
After clawback period, recipient runs finalize_clawback to claim.