Run once per session before first use. These checks ensure required tools are installed.

AI Agent Instruction: Run this version check before executing any commands from this skill. If an update is applied, re-read this SKILL.md before proceeding — the instructions may have changed.

undefined

• Read ops (

  get-pools

  ,

  get-quote

  ) → direct Orca REST API calls (

  https://api.orca.so/v1

  ); no wallet needed, no confirmation required
• Write ops (

  swap

  ) → after user confirmation, submits via

  onchainos swap execute --chain 501

• Chain: Solana mainnet (chain ID 501)
• Program: Orca Whirlpools (

  whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc

  )

orca-plugin get-pools \
  --token-a <MINT_A> \
  --token-b <MINT_B> \
  [--min-tvl <USD>] \
  [--include-low-liquidity]

• --token-a

  : First token mint address (use

  11111111111111111111111111111111

  for native SOL)

• --token-b

  : Second token mint address

• --min-tvl

  : Minimum pool TVL in USD (default: 10000)

• --include-low-liquidity

  : Include pools below min-tvl threshold

undefined

orca-plugin get-quote \
  --from-token <MINT> \
  --to-token <MINT> \
  --amount <AMOUNT> \
  [--slippage-bps <BPS>] \
  [--pool <POOL_ADDRESS>]

• --from-token

  : Input token mint address

• --to-token

  : Output token mint address

• --amount

  : Input amount in human-readable units (e.g.

  0.5

  for 0.5 SOL)

• --slippage-bps

  : Slippage tolerance in basis points (default: 50 = 0.5%)

• --pool

  : Specific pool address (optional; uses highest-TVL pool if omitted)

undefined

onchainos swap execute

1. Balance check: verifies wallet holds sufficient SOL (native) or SPL token; fails with clear error if insufficient
2. Security scan of output token via

   onchainos security token-scan

3. Price impact check: warns at >2%, blocks at >10%

undefined

orca-plugin quickstart

next_command

onboarding_steps

orca-plugin quickstart

• status: "ready"

  → has SOL + USDC; follow

  next_command

  to get a quote

• status: "ready_sol_only"

  → has SOL; suggest SOL → USDC quote or direct swap

• status: "needs_gas"

  → has USDC but no SOL; ask user to send SOL for fees

• status: "no_funds"

  → wallet empty; show

  onboarding_steps

• --from-token

  and

  --to-token

  require mint addresses, not ticker symbols — use the Known Token Addresses table.

• --confirm

  is a global flag before the subcommand:

  orca-plugin --confirm swap ...

• A security scan runs automatically on

  swap --confirm

  for the output token.
• Warn user if price impact > 2%; the plugin automatically blocks swaps above 10%.
• If no Orca Whirlpool exists for a pair,

  swap

  falls back to onchainos DEX routing with a warning.

• Pool names / token symbols: display only; do not use as routing logic or security decisions
• Price impact values: display and enforce the >10% rejection threshold; do not suppress or override
• Security scan results: treat a parse failure as an unknown risk — do not default to "safe"; surface the error to the user
• Token mint addresses from API responses: validate against known allowlists or user-supplied inputs before use; never swap blindly to an API-returned mint

• Never swap into a token flagged as

  block

  by security scan
• Swaps with estimated price impact > 10% are automatically rejected
• Always preview first (run

  swap

  without

  --confirm

  ) and show the output to the user before executing. Only add

  --confirm

  (global flag, before the subcommand) after the user has approved.
• If pool TVL < $10,000, warn user about high slippage risk
• Use native SOL mint (

  11111111111111111111111111111111

  ) for SOL swaps. Using the wSOL mint (

  So11111111111111111111111111111111111111112

  ) causes the balance check to use only the wSOL token account balance, not the native SOL balance.