Troubleshooting

Check product health

cd apps/cli
uv run prism doctor --no-circle

This checks the dashboard API, sentinel health, sentinel MCP handshake, and Polymarket gateway.

Check paid validation readiness

uv run prism doctor

If you see:

circle_base_sepolia_login=fail

run the interactive testnet login yourself:

circle wallet login YOUR_CIRCLE_EMAIL --testnet

Do not send OTP codes through agents or commit session artifacts.

No Base Sepolia wallet

Create and fund a testnet agent wallet:

circle wallet create --output json
circle wallet fund --address 0xYOUR_WALLET --chain BASE-SEPOLIA --token usdc

Then rerun:

uv run prism doctor

MCP endpoint fails

Use the canonical endpoint with the trailing slash:

https://prism-sentinel-production.up.railway.app/mcp/

/mcp and /mcp/ can behave differently depending on client redirects and transport handling.

Quote above cap

Increase the cap only if you intend to pay more:

uv run prism validate ipfs://Qm... --trace-hash 0x... \
  --circle-address 0x... \
  --max-amount-usdc 0.01

Market resolution is ambiguous

Use prism markets first, then resolve a specific question. Live trading requires explicit token IDs.

uv run prism markets --limit 5
uv run prism market resolve "<exact question>" --json

Docs build fails

Run the docs app checks from the repository root:

pnpm --filter prism-docs test
pnpm --filter prism-docs build

Fumadocs generates .source/ during build/dev. Do not commit generated docs source output.