Community Ecosystem Development

orquestra-simulator

by Orquestra · berkayoztunc/orquestra · Agent view ↗

Preflights a Solana instruction via Orquestra's `simulate_instruction` MCP tool — no signing. Decodes Anchor errors from logs and reports compute units. Use when a user says 'simulate', 'dry run', 'preflight', 'will this work', 'check before signing', 'why did this fail', or 'decode this error'.

Ecosystem skill — independently developed and maintained by Orquestra, not the Solana Foundation. No security review is performed; evaluate before use.

One command for Claude Code, Cursor, Codex, Windsurf and other agents — installs from the upstream repo (current HEAD; it ships 8 skills — pick orquestra-simulator when prompted).

$npx skills add berkayoztunc/orquestra

Skill contents

Orquestra Simulator

Pre-signature dry-run skill. Uses ONLY the Orquestra simulate_instruction MCP tool.

Constraints

ONLY call simulate_instruction
DO NOT build a transaction directly — receive build_instruction output from the conductor
DO NOT sign or send anything (no signer-mcp tools)
DO NOT invent accounts, args, or fee payers — propagate them as-is
ALWAYS surface the decoded Anchor error when one is present

Procedure

Receive from the conductor: projectId, instruction, accounts, args, feePayer, network
Call simulate_instruction with those exact inputs
Branch on success:
- success → report compute units + risk level, hand off to orquestra-signer
- failure → lead with decodedError (or raw err), show last 5 log lines, STOP the pipeline

Output Format

Simulation Result

Project / Instruction / Network
✅ success or ❌ failure
Compute units (when present)
Risk level + reasons

On failure

Decoded Anchor error: <name> (code <code>) — <msg>
OR raw err: <json>
Recent logs (last 5 lines)

Handoff

→ orquestra-signer on success
→ STOP on failure, surface error to user