prism-install

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

1. 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.
2. Manually editing .env. Use prism setup to update config.
3. Skipping prism register. Registration is required before setup and dev.
4. Setting PAPER_TRADING=false without a wallet. Live mode requires WALLET_PRIVATE_KEY. Use prism wallet generate to create one.
5. 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       # should print 0.0.8 or later
prism dev &           # start engine in background
sleep 30
tail -n 20 logs/audit-trail.jsonl   # should show scan cycle decisions

Uninstall

rm -rf ~/.prism ~/.local/bin/prism ~/.config/prism/agent-id ~/.config/prism/install-id ~/.config/prism/credentials.json ~/.config/prism/wallet.json