Skip to content

Commit a685353

Browse files
authored
Minor documentation updates (#679)
* Update API docs link. Update Rust SDK version compatibility. Fix logo bug. Update general README * Improve formatting of version references * Fix * Update readme lp bot * Add changesets
1 parent b3ae6a2 commit a685353

File tree

9 files changed

+43
-33
lines changed

9 files changed

+43
-33
lines changed

.changeset/empty-ants-roll.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
"@orca-so/whirlpools-docs-rust": patch
3+
---
4+
5+
Updated the Solana SDK compatibility version for Rust SDKs.

.changeset/fair-wombats-kneel.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
"@orca-so/whirlpools-example-rust-repositioning-bot": patch
3+
---
4+
5+
Updated installation guide.

.changeset/good-icons-beg.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
"@orca-so/whirlpools-docs": patch
3+
---
4+
5+
Updated Solana SDK version compatibility for Rust SDKs. Updated API docs reference. Fixed a bug causing the Orca logo to appear streched on Safari.

README.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,6 @@ This monorepo contains all the code needed to build, deploy and interact with th
3434

3535
### Requirements
3636

37-
- Rust 1.78.0
3837
- Anchor v0.29.0
3938
- Solana v1.17.22
4039

docs/rust/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@
44

55
The Whirlpools SDKs are Orca's primary set of SDKs designed to provide enhanced, modular interaction with the Whirlpool Program on Solana and Eclipse. Whether you are managing liquidity, building applications that require pool infrastructure, or building automation tools that interact with the program, our SDKs cover a spectrum of functionality from low-level granular control to high-level abstractions. This offering is divided into three main components:
66

7-
### 1. High-Level SDK (in development, requires Solana SDK v1.18)
7+
### 1. High-Level SDK, compatible with Solana SDK versions `^1.18.0` but `<2.0.0`
88
The High-Level SDK is our top recommendation for anyone who wants to integrate with the Whirlpool Program. It builds upon the Low-Level and Core SDKs to provide an easy-to-use interface for interacting with the Whirlpool Program. This SDK abstracts many of the underlying complexities, such as tick array management, and makes managing pools and positions, and executing swaps much simpler. It is suitable for developers who need efficient, high-level functionalities and want to minimize manual configuration and management.
99

1010
### 2. Core SDK
1111
The Core SDK provides essential utilities for math operations and quotes, required for working with liquidity pools. This library focuses on calculations such as determining position status, price conversions, and computing quotes on adjusting liquidity and swaps. It is written in Rust but has been compiled to WebAssembly (Wasm) for easy integration into TypeScript projects.
1212

13-
### 3. Low-Level SDK (requires Solana SDK \<v2)
13+
### 3. Low-Level SDK, compatible with Solana SDK versions `^1.16.0` but `<2.0.0`
1414
The Low-Level SDK is autogenerated from the Whirlpool Program's Interface Description Language (IDL). This SDK provides direct program interactions and is designed for developers who need complete, low-level control over Whirlpool operations. It covers direct access to Solana accounts, instructions, and transactions.

docs/whirlpool/docs/01-Welcome.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -28,8 +28,8 @@ What follows is a brief overview of our SDK suite, distinguishing between the Wh
2828
The Whirlpools SDKs are our primary set of SDKs designed to provide enhanced, modular interaction with the Whirlpool Program. This offering is divided into three main components:
2929

3030
#### 1. High-Level SDK
31-
- **TypeScript**: [@orca-so/whirlpools](https://www.npmjs.com/package/@orca-so/whirlpools) (Requires Solana Web3.js SDK ≥v2.0)
32-
- **Rust**: orca_whirlpools (requires Solana SDK v1.18)
31+
- **TypeScript**: [@orca-so/whirlpools](https://www.npmjs.com/package/@orca-so/whirlpools) (Compatible with Solana Web3.js SDK version `^2.0`)
32+
- **Rust**: [orca_whirlpools](https://crates.io/crates/orca_whirlpools) (Compatible with Solana SDK versions `^1.18.0` but `<2.0.0`)
3333
- **Description**: The High-Level SDK is our top recommendation for anyone who wants to integrate with the Whirlpool Program. It builds upon the Low-Level and Core SDKs to provide an easy-to-use interface for interacting with the Whirlpool Program. This SDK abstracts many of the underlying complexities, such as tick array management, and makes managing pools and positions, and executing swaps much simpler. It is suitable for developers who need efficient, high-level functionalities and want to minimize manual configuration and management.
3434

3535
#### 2. Core SDK
@@ -38,12 +38,12 @@ The Whirlpools SDKs are our primary set of SDKs designed to provide enhanced, mo
3838
- **Description**: The Core SDK provides essential utilities for math operations and quotes, required for working with liquidity pools. This library focuses on calculations such as determining position status, price conversions, and computing quotes on adjusting liquidity and swaps. It is written in Rust but has been compiled to WebAssembly (Wasm) for easy integration into TypeScript projects.
3939

4040
#### 3. Low-Level SDK
41-
- **TypeScript**: [@orca-so/whirlpools-client](https://www.npmjs.com/package/@orca-so/whirlpools-client) (Requires Solana Web3.js SDK ≥v2.0)
42-
- **Rust**: [orca_whirlpools_client](https://crates.io/crates/orca_whirlpools_client) (Requires Solana SDK \<v2)
41+
- **TypeScript**: [@orca-so/whirlpools-client](https://www.npmjs.com/package/@orca-so/whirlpools-client) (Compatible with Solana Web3.js SDK version `^2.0`)
42+
- **Rust**: [orca_whirlpools_client](https://crates.io/crates/orca_whirlpools_client) (Compatible with Solana SDK versions `^1.16.0` but `<2.0.0`)
4343
- **Description**: The Low-Level SDK is autogenerated from the Whirlpool Program's Interface Description Language (IDL) using Codama. This SDK provides direct program interactions and is designed for developers who need complete, low-level control over Whirlpool operations. It covers direct access to Solana accounts, instructions, and transactions.
4444

4545
### Legacy SDK
46-
- **TypeScript**: [@orca-so/whirlpools-sdk](https://www.npmjs.com/package/@orca-so/whirlpools-sdk) (Requires Solana Web3.js SDK \<v2.0)
46+
- **TypeScript**: [@orca-so/whirlpools-sdk](https://www.npmjs.com/package/@orca-so/whirlpools-sdk) (Requires Solana Web3.js SDK `<v2.0`)
4747
- **Description**: Despite being called "Legacy", this SDK remains a reliable choice for integrating with projects that use Solana Web3.js versions older than v2.0. It offers foundational tools for interacting with Orca's Whirlpool Program and includes utilities from @orca-so/common-sdk.
4848

4949
## How to use this documentation
Lines changed: 7 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,14 @@
11
---
22
sidebar-label: API
33
---
4-
import DocCard from '@theme/DocCard';
4+
import DocCard from "@theme/DocCard";
55

6-
# API Endpoints
6+
# API
7+
Read and test endpoints through the Orca's public API documentation to learn more about the available endpoints and how to interact with them.
78

89
<DocCard item={{
9-
type: 'link',
10-
href: 'https://api.mainnet.orca.so/v1/whirlpool/list',
11-
label: 'Whirlpool List',
12-
description: 'https://api.mainnet.orca.so/v1/whirlpool/list'
10+
type: "link",
11+
href: "https://api.orca.so/docs",
12+
label: "Orca's public API",
13+
description: "https://api.mainnet.orca.so/v1/whirlpool/list"
1314
}} />
14-
15-
<DocCard item={{
16-
type: 'link',
17-
href: 'https://api.mainnet.orca.so/v1/token/list',
18-
label: 'Token List',
19-
description: 'https://api.mainnet.orca.so/v1/token/list'
20-
}} />

docs/whirlpool/static/index.css

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,6 @@
2727

2828
img {
2929
display: block;
30-
width: 100%;
3130
margin-left: auto;
3231
margin-right: auto;
33-
}
32+
}

examples/rust-sdk/whirlpool_repositioning_bot/README.md

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -25,19 +25,22 @@ A Rust-based CLI bot for interacting with the Orca Whirlpools program on Solana.
2525
1. Clone this repository:
2626
```bash
2727
git clone https://github.com/orca-so/whirlpools.git
28-
cd examples/rust-sdk/lp-bot
28+
cd examples/rust-sdk/whirlpool_repositioning_bot
2929
```
30-
2. Build the bot:
30+
2. Update `Cargo.toml`
31+
This project uses the local version of the dependencies. If you want to move this example project outside of this repo, update the `Cargo.toml`:
32+
```toml
33+
# other dependencies
34+
orca_whirlpools = { version = "^1.0" }
35+
orca_whirlpools_client = { version = "^1.0" }
36+
orca_whirlpools_core = { version = "^1.0" }
37+
# rest of the dependencies
38+
```
39+
3. Build the bot:
3140
```bash
3241
cargo build --release
3342
```
34-
3. The executable will be located in target/release/lp-bot
35-
36-
> NOTE: This project uses the local version of the dependency. If you want to move this example project outside of this monorepo, make sure you install the necessary dependecies:
37-
```bash
38-
cargo add orca_whirlpools orca_whirlpools_client orca_whirlpools_core
39-
```
40-
43+
4. The executable will be located in target/release/whirlpool_repositioning_bot
4144

4245
---
4346

@@ -104,7 +107,7 @@ Monitor with turbo priority fees:
104107
```bash
105108
examples/
106109
├── rust-sdk/
107-
└── lp-bot/
110+
└── whirlpool_repositioning_bot/
108111
└── src/
109112
├── main.rs # Entry point
110113
├── cli.rs # CLI argument parsing

0 commit comments

Comments
 (0)