Skip to content

Execution & Settlement

How confirmed Intents are recorded as on-chain commitments and settled across on-chain and off-chain rails.

Overview

When a submitter confirms a quoted Intent, Ezys records an Execution Commitment on-chain — an immutable, auditable record of the agreed terms. Ezys does not hold or move funds; actual asset transfers are carried out by the liquidity sources and settlement partners referenced in the commitment.

Settlement follows one of two paths depending on asset type: on-chain assets settle near-instantly via smart contracts, while off-chain (fiat) assets are settled through partner rails with on-chain guarantees to ensure fulfillment.

Definitions

Execution Commitment

The on-chain record created when a submitter confirms a quoted Intent.

EC(I) = (intent, solution, legs, timestamp)

where:
  intent   = original Intent
  solution = selected Solution (path, price)
  legs     = { L₁, L₂, ..., Lₖ }
  timestamp = commitment time

Leg

A single asset transfer within a settlement. Each Execution Commitment consists of one or more Legs.

L = (from, to, asset, amount)

where:
  from   = sender address (wallet address or account ID)
  to     = receiver address (wallet address or account ID)
  asset  = asset code (e.g. USDC, KRW)
  amount = transfer amount

Typical 2-Leg Structure

EC(I) = { L₁, L₂ }

Example — USDC → KRW:
  L₁ = (user_wallet,  solver_vault,   USDC, 1000)
  L₂ = (solver_bank,  user_bank_acct, KRW,  1424500)

On-chain Settlement

On-chain Legs settle near-instantly via smart contract execution. When the Execution Commitment is recorded, the corresponding on-chain asset transfer is triggered automatically.

Off-chain Settlement

Off-chain Legs involve fiat currency transfers that cannot settle atomically on-chain. To bridge the gap between on-chain commitment and off-chain finality, Ezys employs a Settlement Guarantee — a mechanism that ensures the off-chain obligation recorded in the Execution Commitment is verifiably fulfilled.

The specific guarantee mechanism depends on the settlement partner's capabilities:

MechanismHow it worksWhen used
Direct SettlementPartner executes fiat transfer directly upon commitment; status is confirmed via partner APIPartners with real-time fiat rails (e.g. integrated banking partners)
PBM (Purpose Bound Money)A token is minted on-chain representing the fiat obligation; burned once the off-chain transfer is confirmedPartners without real-time confirmation capabilities

In all cases, the on-chain Execution Commitment serves as the source of truth, and settlement status is tracked until the off-chain transfer is verified as complete.

Intent Lifecycle (Full)

The complete lifecycle of an Intent from submission through settlement.

Submit → Quoted → Confirmed → Executing → Settled
                           ↘ Expired (if not confirmed in time)
                                      ↘ Failed (settlement failure)
StatusDescription
quotedFirm quote issued, awaiting confirmation
executingConfirmed, Execution Commitment recorded, settlement in progress
settledAll Legs completed
expiredQuote expired before confirmation
rejectedConstraints could not be met
cancelledCancelled by the submitter