Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.b1nary.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Environments

b1nary runs on two environments. Use testnet for development and testing, production for real trading.

​
Production (Base mainnet + Solana mainnet)

ChainsBase (chain ID 8453) and Solana mainnet
APIhttps://api.b1nary.app
Apphttps://b1nary.app
Explorershttps://basescan.org, https://solscan.io
AssetsETH, cbBTC, SOL, TSLAx. Puts are collateralized with USDC. Covered calls use WETH/cbBTC on Base or wSOL/TSLAx on Solana.
Base USDC0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Solana USDC4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU

​
Solana production programs

Program / AccountAddress
b1nary Batch SettlerGpR6id2cHu5fUGsFm7NUKkB4NzfuEDa6brPzkSrgAzvS
Solana Margin PoolFH3z4BYRZMFU8YzpJoFXUbrdoYksdERnWbZvDAEc3qcC
CCTP V2 Token Messenger MinterCCTPV2vPZJS2u2BBsUoscuikbYjnpFmbFsvVuJdgUMQe
CCTP V2 Message TransmitterCCTPV2Sm4AdWt5296sk4P66VBZ7bEhcARwFaaS9YPbeC
wSOL MintSo11111111111111111111111111111111111111112
TSLAx MintXsDoVfqeBukxuZHWhdvWHBhgEHjGNst4MLodqsJHzoB

​
Testnet (Base Sepolia)

ChainBase Sepolia (chain ID 84532)
APIhttps://optionsprotocolbackend-staging.up.railway.app
Apphttps://staging.b1nary.app
Block explorerhttps://sepolia.basescan.org
RPChttps://sepolia.base.org
AssetsETH, BTC (mock tokens). No real money.

​
Account model

b1nary groups wallets under a product-level account.
  • Base trading uses a gas-sponsored smart trading account.
  • Solana trading uses a gas-sponsored embedded trading account.
  • External wallets like Rabby, MetaMask, and Phantom are funding wallets for deposits and withdrawals.
  • Agents should treat verified trading wallets as the canonical source for balances and positions.
  • USDC can be consolidated across Base and Solana with Circle CCTP V2 before a trade or withdrawal.
Use:
  • GET /b1nary-account?privy_user_id=...
  • GET /b1nary-account/by-wallet?chain=base&address=0x...
  • GET /b1nary-account/by-wallet?chain=solana&address=...
  • GET /b1nary-account/positions?privy_user_id=...

​
Integration paths

App users sign in with wallet/Privy. b1nary creates and manages gas-sponsored trading accounts on Base and Solana. Agents and integrators can either use the app account model or interact directly with the contracts/programs. For cross-chain UX, prefer the account model and bridge endpoints.

​
Setup for agents

1

Get test tokens (testnet only)

Call POST /faucet with {"address": "0xYourWallet"}. You receive 0.005 ETH (gas), 50 LETH (test WETH), and 100,000 LUSD (test USDC). One claim per wallet.
curl -X POST https://optionsprotocolbackend-staging.up.railway.app/faucet \
  -H "Content-Type: application/json" \
  -d '{"address": "0xYourWalletAddress"}'
2

Approve collateral to MarginPool

On Base, call approve(MarginPool, max) on the collateral token. For puts: approve USDC. For calls: approve WETH or cbBTC. On Solana, b1nary prepares sponsored setup transactions for token accounts, approvals, and wSOL wrapping when needed.
3

Read prices and execute

GET /prices returns the live option price sheet with signed quotes for Base and Solana. Pick an option, calculate collateral, and either execute directly on the target chain or use bridge-and-trade if USDC is on the other chain. See the Integration Guide for examples.

​
Decimal reference

TypeDecimalsExample
oToken amounts8100000000 = 1 ETH notional
Strike prices (on-chain)8240000000000 = $2,400
USDC65000000 = 5 USDC
WETH181000000000000000000 = 1 WETH
cbBTC8100000000 = 1 cbBTC
SOL / wSOL91000000000 = 1 SOL
TSLAx8100000000 = 1 TSLAx
Base EVM contracts are UUPS-proxied and verified on BaseScan. Solana programs are deployed on Solana mainnet.