Learn
Everything you need to know to get started with RecursaAI on Solana
Quick Start
New to RecursaAI? Here is the fastest way to get started:
Connect your wallet
Click the Connect Wallet button in the top right corner. Supports Phantom, Solflare, and more.
Browse strategies
Explore yield strategies across JupLend, Kamino, Project0, Save Finance, Lulo, Loopscale, Exponent Finance, Meteora, Orca, Raydium, Jupiter Perps, Flash Trade, and Phoenix/Rise. Filter by risk, APY, or token.
Create a position
Select a strategy, set your leverage, and create a loop position with a single transaction.
Operator runbooks
Operator + developer-depth guides for every shipped feature. Each card opens the full Markdown on GitHub.
User guides
Features you can configure yourself, documented at operator depth — set up real Telegram alerts, run your own keeper, rotate flipped funding legs.
Self-hosted keeper
Authorize your own keeper wallet per-position. Docker image, PDA setup, OR-semantics.
Notifications (Telegram + Web Push)
Wire Telegram bot + Web Push VAPID keys so you get liquidation + trigger alerts in real time.
Delta funding auto-roll
How the keeper detects funding-spread flips and surfaces a one-click rotate-to-flipped-legs intent.
Flash-loan close design
Atomic unwind via Kamino flash loans for heavily-leveraged positions — no mid-close HF buffer needed.
Operator runbooks
What you run when you're on-call. Health probes, deploy steps, mainnet gates, HA plan.
Monitoring & alerting
Service /healthz probes, alert routing, on-call runbook for keeper + nginx + frontend.
Ops deploy runbook
morningstar bare-metal sidecar + nginx + keeper systemd sync steps. Run this before every production deploy.
Dependency audit posture
Npm audit baseline policy for high / critical advisories across root, app, and keeper lockfiles.
Incident playbooks
On-call response paths for keeper-wallet drained, Pyth stale > 60s, and admin-key compromise. Symptoms, containment, recovery, post-mortem.
Mainnet pre-flight checklist
The list gating mainnet deployment. Every item links to the code / config to review.
Production environment inventory
Env vars, hot keys, sidecar URLs, registry IDs, oracle sources, smoke wallets, and emergency-control owners for mainnet.
App Cloudflare cutover
Issue #492 gate sequence for mainnet app env, server-side RPC proxy, Cloudflare KV, runtime smoke, and credential-leak evidence.
Keeper sidecar cutover
Issue #491 gate sequence for keeper, Pyth poster, Kamino farms, live health, wallet balances, restart, and rollback evidence.
Environment matrix
Per-network app, keeper, sidecar, and SDK env vars for switching between devnet, testnet, and mainnet without source edits.
Mainnet registry verification
Source-backed program ID, key account, on-chain executable, and close-verification evidence for every mainnet integration registry slot.
Oracle token LUT inventory
Mainnet pricing, token allowlist, Pyth feed, lookup-table, and inventory checker runbook for launch readiness.
Lending mainnet readiness
Launch-readiness ledger for JupLend, Kamino, Save, MarginFi Native, and Project0 account inventory, smoke gates, and execution blockers.
JupLend Borrow Multiply spike
Issue #831 SDK spike for JupLend Borrow/Multiply builders, Recursa account binding, smoke route selection, and promotion gates.
Lulo mainnet readiness
Issue #495 launch ledger for Lulo Protected and Boost smoke evidence, env gates, USDC-only mint policy, and $25k cap accounting.
LST smoke evidence
Evidence schema, validator commands, UI smoke steps, and promotion gates for launchable LST mainnet lifecycles.
LP smoke evidence
Evidence schema, checker commands, blocked-state rules, and promotion gates for Meteora, Orca, and Raydium LP lifecycles.
LP certification ledger
Issue #607 route ledger for Meteora DLMM, Orca Whirlpool, Raydium CLMM/CPMM/farm, smoke commands, fee evidence, and parent closeout blockers.
LST certification ledger
Issue #606 route ledger for JitoSOL, mSOL, Sanctum INF, Jito Restaking VRTs, smoke commands, and parent closeout blockers.
Expanded surface readiness
Issue #458 repo-side closeout ledger for expanded strategy categories, child task status, release handoff issues, and production smoke gates.
Mainnet signoff evidence
Final launch evidence packet checklist and offline JSON checker for production deploy, smoke, config, and route signoff.
Mainnet deploy budget
Program deploy-wallet funding plan, rent calculation, balance separation, and evidence checker for issue #500.
Emergency controls
Mainnet pause, rollback, keeper rotation, registry disable, launch-cap, and communications rehearsal gate for issue #501.
Product video readiness
Colosseum recording readiness checklist for price freshness, explorer links, route claims, and demo-visible smoke gates.
RWA source verification
Mainnet source, pricing, eligibility, market-hours, and keeper-unwind decisions for every launch RWA and tokenized-equity route.
Colosseum demo script
Exact recording flow, route labels, fallback language, and evidence checklist for the Colosseum demo.
Security audit checklist
Internal pre-mainnet audit sign-off, launch-gating findings, and rules for filing follow-up security issues.
APY source certification
Issue #972 matrix for APY source units, freshness, display labels, preview behavior, and promotion gates across strategy families.
Strategy snapshot replay
Issue #1029 capture/replay runbook for sanitized live strategy snapshots, optimizer drift checks, and reviewed rank expectation updates.
Mainnet day-0 smoke tests
The first transactions to run after the program is deployed. Tiny amounts, every instruction path.
Perps mainnet smoke
Issue #496 smoke runbook for Jupiter Perps, Flash Trade, and Phoenix/Rise entry, close, flat-state, and waiver evidence.
Delta perps lifecycle smoke
Issue #680 completion bar for Flash/Phoenix Recursa create, intent, flat proof, final close, and UI lifecycle evidence.
Delta arb lifecycle smoke
Issue #717 promotion bar for cross-DEX arb two-leg open, close, flat-proof, final close, and UI evidence.
Imperial proof model
Issue #953/#954 design and program gate for Imperial Perps routed-position identity, sidecar proof binding, flat-state evidence, fee policy, and certification blockers.
Titan mainnet smoke
Issue #660 Titan-first swap smoke commands, credentials, route evidence, fallback checks, and on-chain verification requirements.
RWA demo smoke plan
Colosseum demo and mainnet smoke paths for Hastra, ONyc, xStocks, and gated treasury/fund RWA routes.
Tokenized equity QA runbook
xStocks and Ondo GM coverage map, approved-universe workflow, issue closure matrix, and mainnet smoke checklist.
Keeper + UI high-availability plan
Redundancy strategy for the hot paths so a single-node failure doesn't take positions offline.
Publishing to npm — runbook
Step-by-step for releasing @recursa-ai/idl, @recursa-ai/sdk, @recursa-ai/mcp. Covers one-time scope setup, version bumps, the release-npm.sh runner, post-publish verification, and rollback via npm deprecate.
Developer docs
How the thing is built. Test coverage map, adapter integration matrix, release-pass audit reports.
Testing coverage map
Which instruction / hook / component has which test. Grows with every feature.
Latest E2E audit report
Most recent end-to-end audit findings: gaps, fixes, deferred items.
E2E testing — runbook
How to run Playwright specs locally + against devnet. Default suite, devnet lifecycle opt-in, testid registry.
Adapter integration matrix
Which adapters (JupLend / Kamino / Project0 / Exponent / Jupiter Perps / Flash Trade / Jupiter Swap) are wired end-to-end vs stubbed.
Phoenix testing matrix
CI-safe Rise SDK builder fixtures, optional live Phoenix smoke tests, and the execution gate before enabling Phoenix-backed Recursa opens.
Post-Phoenix perp matrix
Venue-by-venue decision record for Flash Trade, GMTrade, Adrena, Pacifica, and Zeta/Bullet after Phoenix, with Drift explicitly excluded.
Native lending execution
Save Finance and MarginFi native execution classification, state-binding requirements, keeper gates, and follow-up implementation checklist.
RWA strategy research
Protocol and asset research for RWA yield support, pricing sources, risk boundaries, and demo-priority integrations.
Exponent RWA mainnet smoke
Issue #813 certification flow for Exponent PT/YT managed open, exit or redeem, Recursa final close, and treasury fee evidence.
Credix RWA evaluation
Decision record for Credix private-credit route feasibility, pass gating, CPI readiness, and when to revisit execution.
Known gaps tracker
Running list of gaps between code + docs + product. Mostly closes after every release pass.
Agent skill (Anthropic SKILLS.md)
Canonical capability doc for LLM agents (Claude Projects / MCP / LangGraph). Pairs with @recursa-ai/sdk + @recursa-ai/mcp.
Orchestrator architecture (phases 7-25)
Single reference for the open / close / keeper orchestrator: path matrix, LUT strategy (Recursa + Kamino + Jupiter), ComputeBudget calibration table, telemetry pipeline + dashboard, multi-tx fallback, ops runbook.