Documentation / Setup & Deployment
Setup & Deployment
01Prerequisites
- Node.js v22+
- Rust with the
wasm32-unknown-unknowntarget - Freighter or xBull browser extension
- stellar CLI for contract deployment
02Frontend
Install & run locally
cd frontend
npm install
cp .env.example .env.local # edit for mainnet/testnet
npm run devOpen http://localhost:3000.
03Soroban contracts
Build & test
cd contracts/anchorfx-escrow
cargo build --target wasm32-unknown-unknown --release
cargo test
cd ../anchorfx-oracle
cargo build --target wasm32-unknown-unknown --release
cargo test04Deployment
Testnet
cd frontend
node deploy.cjs <TESTNET_SECRET_KEY>Mainnet
cd frontend
node deploy.cjs <MAINNET_SECRET_KEY> --mainnetFrontend (Vercel)
vercel --prodINFO
Contract addresses
Deployed addresses are written to
.env.<net>.contracts and documented in the README & growth report. Mainnet escrow & oracle addresses are in the Overview page.05CI / CD
GitHub Actions runs the contract tests, WASM release build, formatting, clippy, frontend build, test, typecheck, eslint, and prettier on every push. Vercel auto-deploys production on push to main.
- Contract tests:
cargo test(escrow + oracle), WASM release build,cargo fmt --check,clippy -D warnings - Frontend:
npm ci,next build, vitest,tsc --noEmit, eslint, prettier - 61 tests total (27 contract + 34 frontend), zero warnings