Documentation / User Guide

User Guide

01Connect a wallet

Install Freighter or xBull from its official store page.
Open the AnchorFX app and go to the Wallet page.
Choose your wallet provider and approve the connection request.
Your public address and XLM balance appear. You are now ready to use the app.

02Create an escrow

An escrow locks funds on-chain for a corridor, referencing the FX rate published by the oracle.

Go to the Settlement page.
Select the sender and receiver addresses.
Choose the token and amount, and pick a corridor (e.g. US → PH).
Review the quoted FX rate and confirm. Your wallet signs the transaction.
The escrow is created with a Created status and the transaction is tracked live.

INFO

Rate validity

The FX rate is only valid while the oracle rate is fresh. If the rate expires before the escrow is created, the contract reverts and you must refresh the rate.

03Approve (receiver)

The receiver must approve the escrow terms before it can settle. This is the second-party confirmation that makes settlement atomic and non-repudiable.

From the Settlement dashboard, select the escrow awaiting approval.
Review the amount, corridor, and rate.
Sign the CounterpartyApproved transaction.

04Settle

An authorized admin settles the escrow to release funds to the receiver at the agreed rate. Settlement is final and written on-chain.

Escrow states after action

Created ─ approve ─> CounterpartyApproved ─ settle ─> Settled
Created ─ timeout ─> Refunded
Created ─ admin ─> Cancelled

05Refund & cancel

If the receiver never approves, the sender can refund after the timeout and reclaim their locked funds. An admin can cancel a stuck escrow or pause the whole protocol via the circuit breaker.

06Explore on-chain activity

No wallet? Use the public explorer and live rates pages:

/explorer — browse all escrows and their status.
/rates — live oracle FX rates.
/status — network + contract health and analytics.
/developers — public API reference.

NOTE

Gasless users

AnchorFX supports fee sponsorship: submit an XDR to /api/sponsor and AnchorFX pays the network fee, letting non-crypto users settle without holding XLM.

02Create an escrow

An escrow locks funds on-chain for a corridor, referencing the FX rate published by the oracle.

Go to the Settlement page.

Select the sender and receiver addresses.

Choose the token and amount, and pick a corridor (e.g. US → PH).

Review the quoted FX rate and confirm. Your wallet signs the transaction.

The escrow is created with a Created status and the transaction is tracked live.

INFO

Rate validity

The FX rate is only valid while the oracle rate is fresh. If the rate expires before the escrow is created, the contract reverts and you must refresh the rate.

06Explore on-chain activity

No wallet? Use the public explorer and live rates pages:

/explorer — browse all escrows and their status.

/rates — live oracle FX rates.

/status — network + contract health and analytics.

/developers — public API reference.

NOTE

Gasless users

AnchorFX supports fee sponsorship: submit an XDR to /api/sponsor and AnchorFX pays the network fee, letting non-crypto users settle without holding XLM.