Destination finality

This page is for settlement operators. After you pay a recipient, Veri-Fill waits until your payout is final on the destination chain. What finality means on each chain, and how long it typically takes, is on Finality. Then it signs the release that lets you take the payer’s funds from the settlement vault. Use the values on this page to decide how long to wait for that release. Payers do not wait for the release. They see finalizing as soon as your payout is on chain, and completed once it is final.

Read the live values

curl -sS https://veri-fill.production-testnet.atum.xyz/v1/finality-config
curl -sS https://veri-fill.production-mainnet.atum.xyz/v1/finality-config

The values differ between testnet and mainnet and can change, so read them from the endpoint instead of hard-coding them. Example entries:

{
  "chains": [
    { "chain_id": "eip155:1", "finality": "finalized", "min_confirmations": 12, "block_time_ms": 12000, "time_to_final_ms": 1200000 },
    { "chain_id": "tron:mainnet", "finality": "depth", "min_confirmations": 19, "soft_blocks_at_tip": 2, "block_time_ms": 3000, "time_to_final_ms": 57000 },
    { "chain_id": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp", "commitment": "finalized", "block_time_ms": 400 }
  ]
}

Confirmations

Field	Meaning
`finality`	EVM and Tron: the rule your payout must meet. `depth`: `min_confirmations` blocks deep. `finalized`: also at or below the chain’s finalized block.
`min_confirmations`	EVM and Tron: how many blocks deep your payout must be, counting the block that includes it. `1` means that block is enough.
`time_to_final_ms`	EVM and Tron: a conservative estimate of the time from your payout being mined to it meeting `finality`.
`commitment`	Solana: the commitment level the payout must reach (`confirmed` or `finalized`).
`block_time_ms`	Typical time between blocks. Use it to pace your polling.
`soft_blocks_at_tip`	Tron only: extra blocks to allow for when polling. Veri-Fill does not require them.

Expected wait for the release on EVM and Tron: about time_to_final_ms.

What has to fit before the deadline

Only the payout has to be on the destination chain before the payment’s fulfillment_deadline. The confirmations above do not need to finish before it. Everything before the payout does count: depositing the payer’s funds in the settlement vault and waiting for that deposit to be confirmed on the source chain. Include it when you decide whether a deadline is long enough, and decline with DEADLINE_TOO_SHORT when it is not. See Quote expiry and declines.

Next steps

Topic	Guide
How long your quotes stay valid, and when to decline	Quote expiry and declines
Veri-Fill endpoints	Veri-Fill API
Run the reference agent	Operating a settler agent

Overview

Start building

Settlement Reference

Destination finality

Read the live values

Confirmations

What has to fit before the deadline

Next steps

​Read the live values

​Confirmations

​What has to fit before the deadline

​Next steps

Read the live values

Confirmations

What has to fit before the deadline

Next steps