Settlement

On-chain settlement, with proofs and receipts.

The settlement engine of Tenzro Network — escrow, micropayment channels, atomic batch processing, and verifiable receipts. Anchors every payment, inference, and coordination event.

Overview

Where coordination resolves to a permanent, verifiable record.

Settlement is what makes the network's coordination durable. Every payment, every inference, every credential issuance, every agent action produces a settlement event — either inline on the ledger or anchored via a commitment to an off-chain DA layer. Escrow holds high-value coordination. Channels handle high-volume micropayments. Batching aggregates settlement for efficiency. All cryptographically verifiable.

Capabilities

What the settlement engine handles.

On-chain escrow

Consensus-mediated CreateEscrow / ReleaseEscrow / RefundEscrow typed transactions. Vault addresses derived deterministically.

Micropayment channels

Off-chain per-token billing with Ed25519-signed state updates. Strict signature verification on every channel update.

Atomic batching

BatchProcessor aggregates multiple settlements into one atomic on-chain operation. Rollback on any failure.

Verifiable receipts

ReceiptEnvelope with kind, storage mode, inline summary, payload, DA pointer, and SHA-256 commitment.

DA offload

Large payloads off-chain via DA pointers (IrohBlobs / EigenDA / Celestia / Avail adapters). Commitments stay on-chain.

Proof verification

Plonky3 STARK verification, TEE attestation, and signature verification before settlement is accepted.

Dispute resolution

Channel disputes resolved on-chain. Latest signed state wins. Time-bounded challenge windows.

Network fee routing

FeeCollector routes the network commission (default 0.5%) to treasury. Validators earn separate gas fees.

Settlement RPCs

tenzro_settle, tenzro_getSettlement, tenzro_updatePaymentChannel, tenzro_getEscrow. Escrow writes flow through signed CreateEscrow / ReleaseEscrow / RefundEscrow typed transactions via tenzro_signAndSendTransaction.

Settlement modes

Four ways coordination settles.

01
Immediate
Single-transaction on-chain settlement with cryptographic proof verification (ZK proofs, TEE attestations, signed receipts).
02
Channel
Open a channel, exchange off-chain signed states, close to ledger when done. Optimal for high-volume, low-value flows like per-token inference.
03
Escrow
Funds locked at a derived vault address. Released on receipt verification, refunded on expiry. Atomic against fraud.
04
Batched
Aggregate many settlements into one block-level atomic operation. Reduces gas, preserves auditability via inclusion proofs.
05
DA-offloaded
Settlement payload too large for inline storage — commitment recorded on-chain, payload retrievable from DA layer with verification.
06
Cross-chain (7683)
ERC-7683 cross-chain intents with origin → destination order flow, proof routes (LayerZero, Wormhole, deBridge, Hyperlane).

Specifications

Engine crate: tenzro-settlement
Network fee: 0.5% default, routed to treasury
Escrow selectors: CreateEscrow 0x01000010, ReleaseEscrow 0x01000011, RefundEscrow 0x01000012
Receipt commit: SHA-256(canonical_payload), tagged by ReceiptKind
DA primitives: ReceiptEnvelope + DaPointer (IrohBlobs / EigenDA / Celestia / Avail behind feature flags)
Cross-chain: ERC-7683 CrossChainOrder + ResolvedCrossChainOrder + FillInstruction

Get started

Ship on the open network.

Settle on Tenzro

Settlement docs