Crate chio_settle 

Chio settlement runtime over the official web3 contract family.

chio-settle turns approved Chio capital instructions into real contract calls, projects on-chain state back into the frozen web3 receipt family, and exposes the bounded Solana-native settlement model used for Ed25519-first parity checks.

Modules

channel

Structs

ApprovalBinding

Approval-bound settlement parameters the caller MUST supply.

BondLifecycleObservation

BondLockRequest

CcipDeliveryObservation

CcipLaneConfig

CcipReconciliationOutcome

CcipSettlementMessage

CcipSettlementPayload

CircleNanopaymentPolicy

CommitmentConsistencyReport

DeadLetterRecord

Permanent record persisted in the settle_dead_letters table.

DevnetContracts

DevnetMocks

DualSignReleaseInput

Eip3009Domain

Erc4337PaymasterPolicy

EscrowDispatchRequest

EscrowExecutionProjection

EscrowSnapshot

EvmBondSnapshot

EvmLogEntry

EvmSignature

EvmTransactionReceipt

ExecutionProjectionInput

InMemoryEip3009NonceStore

Process-local single-use EIP-3009 nonce store.

LocalDevnetDeployment

OffchainSettlementReceiptArtifact

Prepare-only off-chain settlement receipt binding the EIP-3009 authorization digest to a governed receipt.

PreparedAuthorizedChannelMerkleReleaseV1

PreparedBondExpiry

PreparedBondImpair

PreparedBondLock

PreparedBondRelease

PreparedCircleNanopayment

PreparedDualSignRelease

PreparedErc20Approval

PreparedEscrowCreate

PreparedEscrowRefund

PreparedEvmCall

PreparedMerkleRelease

PreparedPaymasterCompatibility

PreparedRootPublication

PreparedSolanaSettlement

PreparedTransferWithAuthorization

RailBinding

Resolved EVM rail parameters sourced from operator config.

RetryPolicy

Bounded retry envelope for settlement routing.

SettlementAmountTier

SettlementAnchorContentBinding

SettlementAttemptClaim

Persisted row and lease state required to commit a settlement transition.

SettlementAutomationExecution

SettlementChainConfig

SettlementCommitment

SettlementControlChangeRecord

SettlementControlState

SettlementEmergencyControls

SettlementEvidenceConfig

SettlementFailureCodeParseError

Unknown durable settlement failure code.

SettlementFailureReason

Bounded failure reason safe for durable storage and telemetry labels.

SettlementFinalityAssessment

SettlementIdempotencyKey

Durable identity and claim fence for one at-least-once hook invocation.

SettlementIncidentAlert

SettlementIndexerCursor

SettlementIndexerCursorInput

SettlementLaneRuntimeStatus

SettlementLaneRuntimeStatusInput

SettlementObservation

Observation handed to a SettlementHook by the kernel observer slot once a receipt has been signed and persisted. The structure is deliberately storage-agnostic: it carries the finalized-receipt identity plus the financial coordinates required to route the settlement through chio-settle/ops.rs.

SettlementOracleConfig

SettlementPolicyConfig

SettlementRecoveryRecord

SettlementRuntimeReport

SettlementStoreBinding

Opaque identity shared by receipt and outcome views of one durable writer.

SettlementWatchdogJob

SolanaSettlementConfig

SolanaSettlementRequest

TransferWithAuthorizationInput

X402PaymentRequirements

Enums

BondLifecycleStatus

CcipMessageStatus

EscrowExecutionAmount

EscrowLifecycleStatus

EvidenceSubstrateMode

NonceOutcome

Outcome of a Eip3009NonceStore::record_if_fresh call.

PreparedBondProofRoot

RetryDecision

Decision returned by classify_attempt.

RetryPolicyError

Invalid bounded retry policy.

SettlementAlertSeverity

SettlementAutomationOutcome

SettlementAutomationTriggerKind

SettlementClaimValidationError

Invalid settlement claim parameters.

SettlementEmergencyMode

SettlementError

SettlementFailureClass

Retry disposition for a settlement failure.

SettlementFailureCode

Closed settlement failure taxonomy.

SettlementFinalityStatus

SettlementHookError

Errors that may surface from a SettlementHook. All variants are fail-closed: the paired observer runtime preserves their typed disposition for durable routing, while the dispatch path is never rolled back.

SettlementIndexerStatus

SettlementOperationKind

SettlementOracleAuthority

SettlementOutcome

Outcome returned by a settlement hook.

SettlementRecoveryAction

SettlementRoute

Result of atomically recording a claimed settlement outcome.

SettlementRouteError

Failure returned by the durable settlement router.

SettlementRouteErrorClass

Bounded class for settlement routing failures.

SettlementRoutingInput

Normalized outcome accepted by durable settlement routing.

SettlementRuntimeStatus

SettlementSkipReason

Closed reason for an observation that requires no settlement work.

SettlementWatchdogKind

X402SettlementMode

Constants

CHIO_CCIP_SETTLEMENT_MESSAGE_SCHEMA

CHIO_OFFCHAIN_SETTLEMENT_RECEIPT_SCHEMA

Versioned schema identifier for off-chain settlement receipts.

CHIO_SETTLEMENT_AUTOMATION_JOB_SCHEMA

CHIO_SETTLE_RUNTIME_REPORT_SCHEMA

DEFAULT_BACKOFF_CAP_MS

Hard cap on a single backoff interval (avoids unbounded growth).

DEFAULT_BACKOFF_MULTIPLIER

Multiplier applied to the previous backoff to produce the next.

DEFAULT_INITIAL_BACKOFF_MS

Initial backoff for the first retry attempt.

DEFAULT_MAX_EIP3009_NONCE_ENTRIES

Default hard capacity for retained EIP-3009 authorization nonces.

DEFAULT_MAX_RETRIES

Bound on the number of retries before a transient failure is downgraded to a permanent dead-letter row. The total attempt count is max_retries + 1 (the original call plus the retries).

MAX_SETTLEMENT_CLAIM_BATCH

Maximum number of rows returned by one settlement claim.

MAX_SETTLEMENT_LEASE_MS

Maximum settlement claim lease duration in milliseconds.

MAX_SETTLEMENT_WORKER_ID_BYTES

Maximum UTF-8 byte length of a settlement worker identifier.

SETTLEMENT_COMPLETION_FLOW_ROW_ID_PREFIX

SETTLEMENT_OBSERVATION_SCHEMA

Schema string emitted on the wire for SettlementObservation frames.

SETTLEMENT_OUTCOME_SCHEMA

Schema string emitted on the wire for SettlementOutcome frames.

SETTLE_DEAD_LETTER_SCHEMA

Schema string emitted on the wire for DeadLetterRecord frames.

SOLANA_ED25519_PROGRAM_ID

Traits

Eip3009NonceStore

Single-use nonce store for EIP-3009 authorization replay resistance.

PreparedEvmSubmission

SettlementHook

Hook routing finalized receipts through chio-settle/ops.rs.

SettlementOutcomeStore

Atomic leased store for settlement outcomes.

Functions

approval_binding_from_governed

Bridge a verified GovernedApprovalToken and a resolved RailBinding into an ApprovalBinding suitable for prepare_transfer_with_authorization.

assess_watchdog_execution

build_bond_watchdog_job

build_failure_receipt

build_reversal_receipt

build_settlement_watchdog_job

build_x402_payment_requirements

classify_attempt

Classify one attempt’s outcome under the supplied policy.

classify_settlement_lane

compare_commitments

confirm_transaction

ensure_settlement_operation_allowed

estimate_call_gas

evaluate_circle_nanopayment

finalize_bond_lock

finalize_escrow_dispatch

inspect_finality

inspect_finality_for_receipt

observe_bond

prepare_authorized_channel_merkle_release

prepare_bond_expiry

prepare_bond_impair

prepare_bond_lock

prepare_bond_proof_root_publication

prepare_bond_release

prepare_ccip_settlement_message

prepare_dual_sign_release

prepare_erc20_approval

prepare_escrow_refund

prepare_merkle_release

prepare_merkle_release_root_publication

prepare_paymaster_compatibility

prepare_solana_settlement

prepare_transfer_with_authorization

Prepare an EIP-3009 transferWithAuthorization digest, enforcing the money-safety invariants before any signature is broadcast:

prepare_web3_escrow_dispatch

project_escrow_execution_receipt

read_bond_snapshot

read_escrow_snapshot

reconcile_ccip_delivery

scale_chio_amount_to_token_minor_units

scale_token_minor_units_to_chio_amount

settlement_completion_flow_receipt_id

settlement_completion_flow_row_id

settlement_devnet_rpc_egress_contract

static_validate_call

submit_call

validate_offchain_settlement_receipt

Validate an OffchainSettlementReceiptArtifact for structural integrity.

validate_settlement_claim

Validate parameters shared by settlement claim operations.

verify_solana_binding_and_receipt