| name | prism-install |
| description | Install, configure, and run the Prism liquidity agent for automated Meteora DLMM rebalancing on Solana |
Prism Install
Use this skill when an agent needs to set up or operate the Prism liquidity agent for automated Meteora DLMM rebalancing on Solana.
When to Use
- User asks to install a Solana liquidity agent, trading bot, or DLMM rebalancer
- User wants to automate Meteora DLMM pool positions
- User wants to earn fees from concentrated-liquidity pools without manual management
- User mentions
prism, prism-liquidity-agent, or @irfndi/prism-liquidity-agent
Installation
The one-liner installer handles Bun (installs if missing), detects your OS/architecture, downloads a compiled bundle from Cloudflare R2, verifies its SHA-256 checksum, extracts it to ~/.prism, and writes a prism wrapper to ~/.local/bin/.
curl -fsSL https://raw.githubusercontent.com/irfndi/prism-liquidity-agent/main/scripts/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"
Agent Operating Contract
Use the installed prism wrapper as the product boundary. The release installer provides the checksum-verified platform bundle under ~/.prism and the global command under ~/.local/bin/prism.
curl -fsSL https://raw.githubusercontent.com/irfndi/prism-liquidity-agent/main/scripts/install.sh \
| PRISM_SKIP_SETUP=1 bash
export PATH="$HOME/.local/bin:$PATH"
prism register
prism version
prism doctor
prism setup --non-interactive --rpc-url="$SOLANA_RPC_URL"
prism dev
Upgrade with prism update --check-only and prism update. Do not edit the Prism checkout, run bun run dev, or run bun install during agent operations; those commands are for Prism development. bun add --global prism is unsupported because no npm package with that name is published.
Configuration
Non-interactive (for agents):
prism setup --non-interactive --rpc-url="$SOLANA_RPC_URL" --rpc-fallback-url="${SOLANA_RPC_FALLBACK_URL:-}"
Interactive (for humans):
prism setup
This writes .env with the RPC provider settings, an optional watchlist, and paper-trading defaults. The default mode is paper trading — no real funds are at risk.
If you don't know which pools to watch, also set ENABLE_POOL_DISCOVERY=true in .env so the agent can find candidates on its own.
Start Trading
prism dev
Decisions are logged to logs/audit-trail.jsonl. To stop, send SIGINT (Ctrl+C).
Available Commands
| Command | Purpose |
|---|
prism dev | Start the trading engine |
prism setup | Interactive .env wizard |
prism register | Create the required cloud account |
prism doctor [--fix] | Validate registration, providers, and local state |
prism whoami | Show cloud account info (requires prism register) |
prism backtest | Run a historical simulation |
prism update | Check for and apply updates |
prism issue "<msg>" | Store an issue in Prism Cloud D1 |
prism wallet {generate,import,show} | Manage the local Solana keypair |
prism link-telegram | Link the cloud account to @prism_agent_bot |
Three Layers (CLI boundary plus required account)
The API account is required before prism setup and prism dev so telemetry,
errors, feedback, and usage have an owner. Telegram remains optional.
| Layer | Purpose | Required? |
|---|
| CLI (local) | Runs the trading engine, persists positions to SQLite | Yes |
| API (cloud) | Account, telemetry, errors, feedback, whoami, subscription | Yes for agents |
| Telegram (chat) | Monitor and control the agent from @prism_agent_bot | No |
Common Mistakes
- Running
bun run dev instead of prism dev. prism dev goes through the CLI wrapper that resolves the install root and respects config. bun run dev bypasses that.
- Manually editing
.env. Use prism setup to update config.
- Skipping
prism register. Registration is required before setup and dev.
- Setting
PAPER_TRADING=false without a wallet. Live mode requires WALLET_PRIVATE_KEY. Use prism wallet generate to create one.
- Forgetting to export
PATH. After the one-liner install, ~/.local/bin must be on PATH.
Troubleshooting
| Symptom | Cause | Fix |
|---|
prism: command not found | ~/.local/bin not on PATH | export PATH="$HOME/.local/bin:$PATH" |
Bun not found during install | Bun not installed | Installer auto-installs Bun; check $HOME/.bun/bin |
sqlite-vec fails on Linux | Bundled SQLite lacks extensions | Engine falls back to system libsqlite3.so automatically |
BigInt serialization error from embeddings | ONNX runtime issue in Node.js | Set EMBEDDINGS_BACKEND=fallback in .env (default) |
| Helius 401/403 | Invalid API key | Re-run prism setup with a valid key or custom RPC URL |
| Engine starts but makes no decisions | Empty watchlist and ENABLE_POOL_DISCOVERY=false | Set ENABLE_POOL_DISCOVERY=true in .env |
Verify Installation
prism --version
prism dev &
sleep 30
tail -n 20 logs/audit-trail.jsonl
Uninstall
rm -rf ~/.prism ~/.local/bin/prism ~/.config/prism/agent-id ~/.config/prism/install-id ~/.config/prism/credentials.json ~/.config/prism/wallet.json
