Skip to content
SineraDocs

Fees and settlement

How ATP holds funds in escrow, pays out each outcome, charges fees, and handles refunds.

When an Atom finalizes, ATP splits the escrowed amount between Buyer, Seller and any fee claims. The split follows fixed formulas, so everyone can predict the result before they sign.

Implementation candidate

Escrow

At creation, the payer's tokens move into the EscrowVault in the same transaction that creates the Atom. To fund an Atom, the payer approves the vault of the active configuration, not AtomCore. Approving AtomCore will not fund escrow.

The vault checks every transfer by exact balance change. Tokens that charge a fee on transfer, rebase or tax recipients are not supported. The token issuer can still pause, blacklist or seize funds, and that can block a transfer. A payout failure reverts the whole settlement.

Funding from a card or exchange is a separate step that ends in the root wallet. It never creates escrow by itself.

Settlement

The gross split follows the Seller share in basis points (BPS). One BPS is 0.01%.

sellerGross = floor(escrowAmount * sellerShareBps / 10_000)
buyerGross  = escrowAmount - sellerGross

The Buyer share goes to the refund beneficiary, which is always the root Buyer. The Seller share goes to the root Seller. A SPLIT has 0.01% granularity, so it cannot express every arbitrary amount. The Seller part is rounded down and the Buyer gets the remainder.

Settlement always conserves value:

buyerOut + sellerOut + companyFee + ecosystemFee + heldDisputeFee = escrowAmount

Core tells the settlement engine which finalization route was used. A submitter flag, the outcome alone or elapsed time cannot choose the fee.

Fee schedule

RouteFee basisRate
Ordinary completion, paid in SINSeller gross150 BPS
Ordinary completion, paid in a supported stablecoinSeller gross250 BPS
Cancellation or expiry while pendingNothingNo fee
Dispute settled by Buyer and Seller togetherEntire escrow500 BPS
Dispute settled by Sinera approval plus one rootEntire escrow1500 BPS
Dispute settled by an independent awardEntire escrow1500 BPS

Creation rejects any other fee class or rate before escrow is taken.

Ordinary completion

The fee is split between a company claim and an ecosystem claim:

totalFee     = floor(sellerGross * totalFeeBps / 10_000)
companyFee   = floor(totalFee / 2)
ecosystemFee = totalFee - companyFee
sellerOut    = sellerGross - totalFee
buyerOut     = buyerGross

Disputed settlement

A dispute route charges its rate on the whole escrow, then splits the fee between the parties. No ordinary fee is added.

heldDisputeFee = floor(escrowAmount * r / 10_000)
sellerFee      = floor(sellerGross * r / 10_000)
buyerFee       = heldDisputeFee - sellerFee
sellerOut      = sellerGross - sellerFee
buyerOut       = buyerGross - buyerFee

Here r is 500 or 1500. The total fee is rounded down once from the whole escrow. The Buyer can therefore pay one extra smallest unit. A party that receives nothing pays no fee. A full refund after a dispute still pays the route's fee.

The 500 BPS rate applies in both live phases of a case. No rate changes with time.

Fee claims

Settlement pays Buyer and Seller directly. Each nonzero fee becomes a separate fee claim in the vault, tied to its Atom and kind: company, ecosystem or dispute. Anyone can call claimFee once to pay a claim to its fixed recipient, and the caller cannot redirect it.

A failed claim rolls back only that claim, so it can be retried. It never reverses the Atom's finality or the payouts to the parties. A claim is an obligation. It is not proof that the recipient received cash.

All fee terms are fixed per Atom in a fee snapshot that the parties sign. Changing the configuration or disabling a token later does not change an existing Atom.

Refunds

A refund is an outcome like any other. It happens in these cases:

  • Cancelled or expired while pending. The full escrow returns to the root Buyer, and no fee applies.
  • Dispute resolved as REFUND. The Buyer receives the escrow minus the route's dispute fee.
  • Partial refund as SPLIT. The Buyer receives its share, minus its part of the fee.

Refunds go to the root Buyer, even when someone else paid. A refund does not restore a delegation session's spend budget.

Assets

When an Atom reserves inventory, the asset registry conserves it in the same way. The locked quantity must equal what is entitled to the Buyer, consumed, unlocked to the Seller and burned. A valid dispute decision signs those quantities explicitly.

Next