orca

Build swaps, liquidity positions, and pools on Orca Whirlpools using the TypeScript SDK.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/Kaleb-Rupe/aurora --skill orca-kaleb-rupe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: orca
Source: https://github.com/Kaleb-Rupe/aurora/tree/main/system/aurora-bridge/.claude/skills/orca
Command: npx skills add https://github.com/Kaleb-Rupe/aurora --skill orca-kaleb-rupe

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @orca-so/whirlpools, @solana/kit, @orca-so/whirlpools-sdk, @coral-xyz/anchor, @solana/web3.js.

What problem does it solve? Developers building on Solana or Eclipse need reliable guidance for integrating with Orca's Whirlpools CLMM, but the SDK spans two major versions (Web3.js v1 legacy and v2), multiple network configurations, and complex concepts like tick spacing and concentrated liquidity ranges. This Skill consolidates working code examples, API references, program addresses, and troubleshooting steps into one place. ## Core Features & Use Cases - Token Swaps: Execute exact-input and exact-output swaps with slippage protection, quotes, and price impact estimates using the new or legacy Whirlpools SDK. - Liquidity Position Management: Open concentrated or full-range positions, increase/decrease liquidity, harvest fees and rewards, and close positions programmatically. - Pool Creation & Discovery: Create splash pools or concentrated liquidity pools with correct tick spacing, fetch pool data, and find pools by token pair. - Use Case: A developer building a DeFi portfolio manager can use the included OrcaClient template to fetch all positions for a wallet, check uncollected fees, and harvest rewards above a USD threshold automatically. ## Quick Start Ask the assistant to set up the Orca Whirlpools SDK on Solana devnet and execute a token swap on the SOL/USDC pool using the provided template.

Frequently Asked Questions about orca

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I swap tokens using the Orca Whirlpools SDK?

Use the swap function from @orca-so/whirlpools with an RPC client, swap parameters specifying input amount and mint, the pool address, and slippage tolerance in basis points. For custom transaction building, use swapInstructions to get instructions and a quote with expected output and price impact.

What is the difference between the new and legacy Orca Whirlpools SDK?

The new @orca-so/whirlpools SDK uses Solana Web3.js v2 with @solana/kit, while the legacy @orca-so/whirlpools-sdk uses Web3.js v1 with Anchor. The new SDK is not compatible with Web3.js v1 projects, so choose based on your existing Solana dependencies.

How do I open a concentrated liquidity position on Orca?

Call openPositionInstructions with the pool address, a liquidity parameter (tokenA, tokenB, or liquidity amount), lower and upper price bounds, and slippage tolerance. It returns the position mint, required token amounts, and a callback to send the transaction.

Which tick spacing should I use when creating an Orca pool?

Use tick spacing 1 (0.01% fee) for stablecoins, 8 (0.04%) for correlated pairs, 64 (0.30%) for standard pairs, and 128 (1.00%) for volatile or exotic pairs. Only these four values are valid for concentrated liquidity pools.

Why does my Orca swap fail with SlippageExceeded?

SlippageExceeded occurs when the price moves beyond your tolerance before the transaction confirms. Increase the slippage tolerance in basis points, split large swaps into smaller chunks, or configure dynamic priority fees so the transaction lands faster.

Does the Orca Whirlpools SDK work on networks other than Solana mainnet?

Yes, the SDK supports Solana mainnet, Solana devnet, Eclipse mainnet, and Eclipse testnet through built-in configuration presets passed to setWhirlpoolsConfig. The Whirlpool program ID is the same across all four networks.