Skip to main content

Hedgers

Buy protection against the FX movement defined by an event. The Stellar wallet keeps the current BlockFinaX workflow: discover an event, review capacity and price, buy notional exposure, wait for settlement, then claim a qualifying payout.

What you are buying​

Review the pair, whether it is a Cap or a Floor, initial rate, strike and payout limit, expiry, premium rate, fees, maximum payout, and oracle policy. Protection is bounded by those terms; it is not necessarily compensation for every loss on an invoice. The displayed premium must state its actual Stellar USDC amount.

End to end buy protection​

  1. Connect a Stellar-compatible signer and select the correct network.
  2. Read the event and its remaining funded capacity. Verify the asset issuer and Soroban deployment.
  3. For a classic account, confirm account funding and the USDC trustline. For a contract account, use its supported SAC balance and authorization flow.
  4. Prepare buy_protection with event ID, notional, maximum cost, payer, beneficiary, and deadline.
  5. Review the simulated asset transfer and account authorization, then sign the XDR and required auth entries.
  6. Wait for confirmed ledger success; store the position ID and receipt.
  7. At expiry, follow the event's fixing status. Prepare and sign claim_payout when an entitlement is finalized.

There is no EVM ERC20 approve step in this flow. The token transfer must be authorized through the tested Stellar/Soroban transaction. Application login alone cannot move funds. See builder pattern.

Payment and treasury integration​

A fintech can associate the position with an invoice or payment reference and display the protection alongside an ordinary USDC payment. Buying protection does not execute the invoice payment or guarantee an anchor's conversion rate. Keep those receipts separate. Query the network-qualified position and verify the account owns the claim before requesting its signature.

Failure modes​

Display network mismatch, insufficient balance, missing trustline, expired intent, unavailable capacity, user refusal, and oracle delay distinctly. An unknown submission result stays pending until reconciled. Do not buy a second position automatically after a timeout.