An Orca Whirlpool concentrated-liquidity module and agent runtime for reading, analyzing, opening, monitoring, and closing CLMM positions on Solana.
Install | Runtime | Monitoring | Safety | Development | Contributing
This repository contains:
- package: the published
orca-clmm-agentnpm package. - agent: an operational trading agent example that consumes the package.
- functions: cloud functions that consume the package for pool, yield, and wallet-value jobs.
- agent-runtime: an experimental Codex CLI container that consumes this Orca module and can also carry broader trading clients.
npm install orca-clmm-agentimport { getOrcaPositions } from "orca-clmm-agent";
import { createSolanaRpc, mainnet } from "@solana/kit";
const rpc = createSolanaRpc(mainnet(process.env.RPC_URL!));
const positions = await getOrcaPositions("wallet-address", rpc);See the package README for the full API-oriented usage notes.
The optional agent-runtime image provides a Codex CLI container with this Orca CLMM package, Solana, Orca, LI.FI, SPL Token, CCXT, TypeScript, and Python tooling preinstalled. The repository stays Orca-specific; the runtime is where broader trading and routing clients belong.
The runtime image does not bake in credentials. For unattended trading, keep private keys in a separate executor service that enforces policy before signing.
See agentic monitoring for the current position monitoring and Codex hook architecture. See runtime verification for the latest live container checks.
Some examples can send real mainnet transactions. Treat scripts that load a wallet keypair as live unless they explicitly say otherwise.
Never commit wallet files, .env files, seed phrases, API keys, RPC
credentials, or exchange credentials. See SECURITY.md before
changing repository visibility.
cd package
npm ci
npm run build
npm run test:unitLive RPC integration tests are separate:
cd package
RPC_URL=https://your-rpc.example npm run test:integration