Ledger

Read one published commit-ledger batch

get/ledger/batches/{nonce}

Request

  • Base URL: https://kellian.app/api/v1
  • URL: https://kellian.app/api/v1/ledger/batches/{nonce}
  • Auth: none required

Path parameters

noncestring required

Batch nonce, decimal.

Response

Success

noncestring required

The contract's own strictly-sequential batch counter, as a decimal string (uint64 on chain).

chainIdinteger required

Compiled protocol release chain ID (Base 8453).

state'claimed' | 'committed' | 'finalized' required

claimed = the batch is built and its fills are bound to it, but the transaction is not mined yet (no txHash). committed = mined. finalized = its block reached finality on Base.

prevRootstring required

The root this batch chains FROM. It must equal the root the contract already held, which is what makes the published history unrewritable.

newRootstring required

Merkle root over every non-zero balance in the ledger after this batch. Recomputable from the published journal payloads alone.

txHashstring nullable required

Base transaction that published this batch. Null while the batch is claimed.

blockNumberstring nullable required

Block the batch transaction was mined in, as a decimal string. Null until it is mined.

matchCountinteger required

Fills published in this batch.

creditCountinteger required

Original movement legs for journal batches; legacy rows count net collateral credits.

eventsEmittedboolean required

Journal batches always emit their complete payload. On legacy batches this field indicates per-fill ERC-1155 transfer events.

committedAtstring date-time nullable required
finalizedAtstring date-time nullable required
createdAtstring date-time required
explorerTxUrlstring uri

The batch transaction on the chain's configured block explorer.

Changes

No recorded changes to this operation across all 1 revision of this API.