hadron-sdk 0.2.2

Rust client SDK for the Hadron protocol
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

# hadron-sdk

Rust client SDK for the [Hadron](https://hadron.fi) protocol on Solana.

Build, sign, and send instructions for Hadron AMM pools — deposits, withdrawals, swaps, curve management, oracle updates, and more.

## Usage

```toml
[dependencies]
hadron-sdk = "0.1"

# Optional: enable RPC helpers for loading pools directly from chain
hadron-sdk = { version = "0.1", features = ["rpc"] }
```

### Load an existing pool (with `rpc` feature)

```rust,no_run
use hadron_sdk::Hadron;
use solana_client::rpc_client::RpcClient;
use solana_sdk::pubkey::Pubkey;

let rpc = RpcClient::new("https://api.mainnet-beta.solana.com");
let pool_address: Pubkey = "...".parse().unwrap();

let pool = Hadron::load(&rpc, &pool_address).unwrap();
println!("Midprice: {}", pool.get_midprice());
println!("Spread: {} bps", pool.get_spread_bps());
```

### Load from raw account data (no RPC dependency)

```rust,ignore
use hadron_sdk::Hadron;

let pool = Hadron::from_accounts(
    pool_address,
    &config_data,
    &oracle_data,
    &curve_meta_data,
    &curve_prefabs_data,
).unwrap();
```

### Build a swap instruction

```rust,ignore
use hadron_sdk::{Hadron, SwapParams};

let ix = pool.swap(&user_pubkey, &SwapParams {
    is_x: true,
    amount_in: 1_000_000,
    min_out: 950_000,
    fee_recipient,
    expiration: None,
});
```

### Initialize a new pool

```rust,ignore
use hadron_sdk::{Hadron, InitializeParams, helpers::math::to_q32};

let (instructions, pool_address, seed) = Hadron::initialize(
    &payer,
    &InitializeParams {
        seed: None, // auto-generated
        mint_x,
        mint_y,
        authority: payer,
        initial_midprice_q32: to_q32(100.0),
        oracle_mode: None,
        max_prefab_slots: None,
        max_curve_points: None,
        token_program_x: None,
        token_program_y: None,
    },
    &hadron_sdk::HADRON_PROGRAM_ID,
);
```

### Set price curves

```rust,ignore
use hadron_sdk::{Interpolation, Side, SetCurvePointInput, SetCurveBothParams, SetCurveHalfParams};
use hadron_sdk::helpers::math::to_q32;

let [bid_ix, ask_ix] = pool.set_curve_both(&authority, &SetCurveBothParams {
    bid: SetCurveHalfParams {
        default_interpolation: Interpolation::Linear,
        points: vec![
            SetCurvePointInput { amount_in: 0, price_factor_q32: to_q32(0.999), interpolation: None, params: None },
            SetCurvePointInput { amount_in: 1_000_000, price_factor_q32: to_q32(0.995), interpolation: None, params: None },
        ],
        slot: None,
        x_mode: None,
    },
    ask: SetCurveHalfParams {
        default_interpolation: Interpolation::Linear,
        points: vec![
            SetCurvePointInput { amount_in: 0, price_factor_q32: to_q32(0.999), interpolation: None, params: None },
            SetCurvePointInput { amount_in: 1_000_000, price_factor_q32: to_q32(0.995), interpolation: None, params: None },
        ],
        slot: None,
        x_mode: None,
    },
});
```

## Features

| Feature | Description |
|---------|-------------|
| *(default)* | Instruction builders, account decoders, PDA derivation, math helpers |
| `rpc` | Adds `Hadron::load()`, `load_from_seed()`, `refetch_states()` via `solana-client` |

## License

Apache-2.0