Whirpools is an open-source concentrated liquidity AMM contract on the Solana blockchain.
This repository contains the Rust smart contract as well as the Typescript SDK (@orca-so/whirlpools-sdk) to interact with a deployed program.
The contract has been audited by Kudelski and Neodyme.
The contract has been deployed using verifiable build, so that you can ensure that the hash of the on-chain program matches the hash of the program of the given codebase.
- Anchor 0.29.0
- Solana 1.17.22
- Rust 1.68.0
Install Anchor using instructions found here.
Set up a valid Solana keypair at the path specified in the wallet in Anchor.toml to do local testing with anchor test flows.
$NODE_PATH must be set to the node_modules directory of your global installs.
For example, using Node 16.10.0 installed through nvm, the $NODE_PATH is the following:
$ echo $NODE_PATH
/Users/<home_dir>/.nvm/versions/node/v16.10.0/lib/node_modules
Instructions on how to interact with the Whirlpools contract is documented in the Orca Developer Portal.
- Run "cargo test --lib" to run Rust unit tests
Use the SDK to interact with a deployed Whirlpools program via Typescript.
In your package, run:
yarn add "@orca-so/whirlpools-sdk"
yarn add "@orca-so/common-sdk"
yarn add "@coral-xyz/[email protected]"
yarn add "@solana/web3.js"
yarn add "@solana/spl-token"
yarn add "decimal.js"
Read instructions on how to use the SDK on the Orca Developer Portal.
In the whirlpools/sdk folder, run:
anchor test
In the sdk folder, run yarn run docs
You can also see the generated TypeDoc.
You can find sample code covering basic operations here.
Questions
Have problems integrating with the SDK? Pop by over to the Orca Discord #dev-questions channel and chat with one of our engineers.
Feedback
Got ideas on how to improve the system? Open up an issue on github with the prefix [FEEDBACK] and let's brainstorm more about it together!