Blocks
Block submission and lookup.
Block submission and lookup. Every POST /blocks/* endpoint takes a block that
is already signed and already carries a valid proof-of-work nonce — the node
computes neither on your behalf.
POSTPOSTPOSTPOSTPOSTPOSTPOSTPOSTPOSTPOSTGETPOSTGET
/blocks/burnSubmit burn block — Permanently destroys XE from the issuing account. XE only — burning XUSD is rejected. The block carries no destination, no source and no counterpart; the amount must be greater than zero and within the account balance. An optional memo is allowed.
/blocks/leaseSubmit lease block — Consumer requests compute from a provider, escrowing the XUSD cost. Asset must be XUSD, and the block must reference the provider's active performance certificate, which locks the price multiplier.
/blocks/lease_acceptSubmit lease_accept block — Provider accepts a lease request and stakes XUSD. Requires timekeeper attestations, the same certificate hash the consumer referenced, and the emission parameters locked at accept time (locked_r must be set).
/blocks/lease_cancelSubmit lease_cancel block — Consumer cancels its own lease while it is still in the created state, refunding the escrowed XUSD. Asset must be XUSD, and only the account that issued the lease block may cancel it.
/blocks/lease_force_settleSubmit lease_force_settle block — Consumer resolves an accepted lease the provider never settled: the escrowed cost is refunded and the provider's stake is not returned. Asset must be XUSD. Requires timekeeper attestations whose median is past expiry plus the settle grace plus the force-settle gap, and still inside the escrow-expiry window.
/blocks/lease_settleSubmit lease_settle block — Provider settles an expired lease on its own chain, minting the XE emission. Asset must be XE. Requires timekeeper attestations whose median falls inside the settle window — at or after expiry and no later than expiry plus the settle grace.
/blocks/mintSubmit mint block — Creates new XUSD on an authorized minter's own chain. The account must be listed in the state chain's sys.minter config — every other account is rejected. XUSD only, with no destination, no source and no memo. The minter then distributes the XUSD by ordinary send and receive.
/blocks/multisig_openOpen multisig account — Opens a new multisig account whose address is derived from the keyset hash, and registers the keyset on the ledger. The account must not already exist, `previous` must be `0`, and `balance` must be 0.
/blocks/multisig_updateRotate multisig keyset — Rotates the keyset on an existing multisig account. Must be signed by the current keyset's threshold.
/blocks/receiveSubmit receive block — Submits a signed receive block that credits a pending send to the recipient. A receive whose source send is contested by an unresolved conflict is deferred (503) until the conflict resolves; a receive of a live lease escrow is rejected outright.
/blocks/recentRecent blocks — Returns recently processed blocks across all accounts, newest first. The node caches the newest 1000 blocks for up to a second and serves the requested window from that cache, so `limit` cannot reach further back than 1000 blocks.
/blocks/sendSubmit send block — Submits a signed send block carrying a valid proof-of-work nonce. Debits the sender and creates a pending entry the recipient must then receive. The amount must be greater than zero, within the account balance, and addressed to a different account.
/blocks/{hash}Get block by hash — Returns a block by hash, with a `finalized` flag alongside the block's own fields.