Contracts
The rules of BlockFinaX are enforced on chain. These contracts hold every dollar of capital, check every quote, and settle every position. Read them, call them directly, or use the API, which prepares the same calls for you.
Stellar
Currency poolPools, underwriter balances and positions: buy protection, back sales, settle and pay out.
Stellar
Pool oracleCollects operator rates after expiry and records one agreed settlement rate per position.
Off-chain
Pricing engineComputes each contract's fair rate and signs it as the quote the currency pool verifies.
Base
Deposit contractsPersonal deposit addresses that forward USDC to a user's Stellar wallet through Circle CCTP.
Circle
Circle CCTPCircle's burn-and-mint transfer protocol, used to move USDC between Base and Stellar.
How the contracts connect
The protocol map shows how the contracts connect to users and services.
Which contract do I need?
| You want to | Contract | Key functions |
|---|---|---|
| Buy protection for a customer | Currency pool | buy_protection, claim_payout |
| Provide or manage liquidity | Currency pool | deposit, request_withdrawal, set_lp_preferences |
| Run a pool | Currency pool | create_pool, set_tenor, set_structures |
| Price a contract or check a quote | Pricing engine, Currency pool | quote, signQuote, buy_protection |
| Follow settlement | Pool oracle, Currency pool | get_consensus, settle_position |
| Let customers fund from Base | Deposit contracts | addressFor, flush |
Function types
| Badge | Meaning |
|---|---|
| READ | Reads state. Free to simulate; no signature. |
| WRITE | Changes state. Needs the caller's authorisation unless marked "anyone". |
| ADMIN | Owner only. Listed for transparency; see Privileged controls. |
Networks
| Contract | Network | Address |
|---|---|---|
| Currency pool | Stellar testnet | CAEKJTUSZIWY5OMK6EVOSNPMEULI3MDO3BLP6Y5OKPHRNKM6KTH5YURM |
| Pool oracle | Stellar testnet | CBOXFJTK5DGVKOEMEYMHMLYKXUHL2ZETWZY3HEF3FO7PO3GD42YH4G5Q |
| Deposit factory | Base Sepolia | 0x05672D3bD02b1ebBFA6F4f5C104A7f2b7d0a2291 |
| Deposit implementation | Base Sepolia | 0x937a715805Bd525CBBF2817f5Eb184a322D7016c |