build_set_remarks_unsigned
Build unsigned SetRemarks transactions to manage key-value remarks on Xahau ledger objects. Attach, update, or delete remarks with optional immutability. Returns unsigned JSON.
Instructions
Assemble an UNSIGNED SetRemarks (Remarks amendment) — attach, update, or delete key-value remarks on a ledger object you own (or, for URITokens/trustlines, issue). Each remark: name (required), value (omit to DELETE), immutable (Flags:1 = permanent). Max 32 per object, names unique, 1–256 bytes each; cost +1 drop/byte. RemarkName/RemarkValue are hex (non-hex text is UTF-8 encoded). Powers dynamic NFTs and rich object annotations. Returns unsigned JSON + preflight. Never signs; testnet by default.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"account": "<account>",
"objectId": "<objectId>",
"remarks": "<remarks>"
},
"name": "build_set_remarks_unsigned"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | Yes | ||
| network | No | testnet | |
| remarks | Yes | ||
| objectId | Yes | 64-hex ledger object ID to annotate (AccountRoot, URIToken, Offer, Escrow, trustline, …) |