Developers

Integration guide

Run Lucida locally and integrate against the development application safely.

Requirements

Runtime. Node.js 20 or newer and a PostgreSQL database.
Solana environment. A localnet or devnet RPC endpoint, aligned Solana and Anchor tooling, and configured development program IDs.
Wallet. A wallet-standard compatible browser wallet. Never load production keypairs into application code.

Quick start

npm install
npx prisma generate
npx prisma db push
npm run dev

# validation
npm run typecheck
npm run lux:test
npm run build

Configuration

Configure the RPC URL, Lucida program ID, USDC mint and treasury accounts, database URL, authentication secret, and any strategy-specific addresses through environment variables. Keep localnet, devnet, and mainnet configuration physically and operationally separate.

Recommended integration boundary

Integrators should consume versioned API responses or generated program clients rather than reimplementing instruction discriminators and account layouts. Validate every RPC response, account owner, mint, token program, and transaction effect before persisting user-facing state.

Mainnet requires an explicit release

Do not infer mainnet readiness from a successful local build. Deployment requires reviewed program artifacts, published addresses, multisig authorities, simulation, monitoring, and human approval.