Repolode
orca-so

orca-so/whirlpools

Open-source concentrated liquidity AMM smart contract on Solana, with Rust and TypeScript SDKs for interacting with it.

Stars
566
Forks
363
Open issues
72
Last commit
5 days ago

What is it?

Whirlpools is a concentrated liquidity automated market maker (AMM) built as a smart contract on the Solana blockchain. Liquidity providers can place capital within chosen price ranges, which lets trades execute against deeper liquidity at those prices than a traditional constant-product pool would offer.

The repository contains the Rust on-chain program along with several SDKs. The high-level packages @orca-so/whirlpools for TypeScript and orca_whirlpools for Rust cover most use cases, while lower-level client and core math/quoting packages are available for more specific integrations. A legacy TypeScript SDK remains the option for projects built on Solana Web3.js.

The program is deployed at a fixed address on mainnet and devnet, and the project uses verifiable builds so the on-chain binary's hash can be checked against this source code. Several security firms have audited the program.

Key features

  • 01Concentrated liquidity positions within chosen price ranges on Solana
  • 02Rust on-chain program deployed on mainnet and devnet
  • 03TypeScript and Rust SDKs for high-level integration
  • 04Lower-level client and quoting/math packages for custom integrations
  • 05Verifiable builds to check on-chain binaries against source

Use cases

  • Building a Solana trading or swap frontend that routes through a concentrated liquidity pool
  • Integrating liquidity provision or quoting into a Solana DeFi application
  • Studying or auditing a production concentrated liquidity AMM implementation on Solana

Quick start

  1. 1

    Install JavaScript dependencies with yarn

    yarn
  2. 2

    Build the project

    yarn build
  3. 3

    Install the high-level TypeScript SDK in your project

Things to know

  • Requires Anchor v0.32.1 and Solana v2.1.0 toolchains for local development.
  • The license is not clearly specified in the metadata (NOASSERTION).

Topics

FAQ

What is whirlpools?
Open-source concentrated liquidity AMM smart contract on Solana, with Rust and TypeScript SDKs for interacting with it. Whirlpools is a concentrated liquidity automated market maker (AMM) built as a smart contract on the Solana blockchain. Liquidity providers can place capital within chosen price ranges, which lets trades execute against deeper liquidity at those prices than a traditional constant-product pool would offer.
Is whirlpools free to use? What license does it have?
whirlpools is open source under the Other license. Check the license terms before using it in commercial products.
Is whirlpools still maintained?
Actively maintained. The last commit to whirlpools was on Nov 3, 2026.
What can I use whirlpools for?
Building a Solana trading or swap frontend that routes through a concentrated liquidity pool Integrating liquidity provision or quoting into a Solana DeFi application Studying or auditing a production concentrated liquidity AMM implementation on Solana
How do I install whirlpools?
Install JavaScript dependencies with yarn: yarn Build the project: yarn build Install the high-level TypeScript SDK in your project
Where can I get whirlpools?
The source code and installation instructions are on GitHub: https://github.com/orca-so/whirlpools

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects