RaumFi v3 Quickstart

Quickstart guide for building RaumFi v3 Stellar Soroban CLMM contracts, generating bindings, and running the Next.js frontend against testnet configuration.

Prerequisites

Node.js 18+, npm, the Rust toolchain, the Soroban CLI, and jq (used by the binding-generation scripts). Rust targets:

rustup target add wasm32-unknown-unknown
rustup target add wasm32v1-none

Frontend

cd frontend && npm install
npm run dev              # start the dev server
npm run build             # production build
npm run start               # serve the production build (port 3105)
npm run test                 # vitest run
npm run test:coverage         # vitest run --coverage

The frontend doesn't need its own contract deployment to run against - it ships pre-pointed at the testnet IDs in frontend/src/contracts/config.ts (see Reference).

Soroban workspace

cd soroban_clmm
cargo build --workspace
cargo test --workspace
./scripts/test_backend.sh        # backend test run used by CI

./scripts/deploy.sh                 # example deployment flow
./scripts/generate_bindings.sh        # regenerates frontend/src/contracts/* clients after a redeploy

soroban_clmm/scripts/ also has narrower helpers worth knowing about: create_pool.sh and setup_pools.sh for standing up pools post-deploy, full_redeploy.sh / redeploy_full.sh for a clean redeploy of the whole stack, and recover_stuck_liquidity.sh / remove_liquidity.sh for position cleanup.

Run frontend and backend coverage together from the repository root with ./scripts/test_coverage.sh.