odos-sdk 0.13.4

Rust SDK for Odos
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

# Odos Rust SDK

A [Rust](https://www.rust-lang.org/) SDK for [Odos](https://docs.odos.xyz/)

[![Crates.io](https://img.shields.io/crates/v/odos-sdk.svg)](https://crates.io/crates/odos-sdk)
[![Crates.io Downloads](https://img.shields.io/crates/d/odos-sdk.svg)](https://crates.io/crates/odos-sdk)
[![License](https://img.shields.io/crates/l/odos-sdk.svg)](https://github.com/semiotic-ai/odos-rs/blob/main/LICENSE)
[![Rust Version](https://img.shields.io/badge/rust-2021-blue.svg?logo=rust)](https://www.rust-lang.org)
[![Maintenance](https://img.shields.io/badge/maintenance-actively--developed-brightgreen.svg)](https://github.com/semiotic-ai/odos-rs/)

---

## One-to-one Swap Example

```rust
use alloy_chains::NamedChain;
use alloy_primitives::{Address, U256};
use erc20_rs::Erc20;
use odos_sdk::{Erc20, OdosSorV2, QuoteRequest, SwapContext};

/// Token address of the token to swap
const TOKEN: &str = "0x4200000000000000000000000000000000000006";
/// Top holder of the token at time of writing according to https://etherscan.io/token/0x4200000000000000000000000000000000000006#balances
const HOLDER: &str = "0xb2cc224c1c9feE385f8ad6a55b4d94E92359DC59";
/// Odos v2 router address on Base
const ROUTER: &str = "0x19cEeAd7105607Cd444F5ad10dd51356436095a1";
/// Recipient of the swap
const RECIPIENT: &str = "0x83384D138420436f4b0DaE97b02002dd5011a7D9";

const USDC: &str = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";

let chain = NamedChain::Base;

let token_address = TOKEN.parse::<Address>().unwrap();

let token_contract = Erc20::new(token_address, &self.provider);
let balance = token_contract.balance_of(account).await?;

let quote_request = QuoteRequest::builder()
    .chain_id(chain.into())
    .input_tokens(vec![(token_address, balance).into()])
    .output_tokens(vec![(USDC.parse::<Address>().unwrap(), 1).into()])
    .slippage_limit_percent(1.0)
    .user_addr(signer_provider.signer_address().to_string())
    .compact(false)
    .simple(false)
    .referral_code(0)
    .disable_rfqs(true)
    .build();

let sor_client = OdosSorV2::new();

let quote = sor_client.get_swap_quote(&quote_request).await.unwrap();

let token_contract = Erc20::new(token_address, root_provider.clone());

// Approve the router to spend the token on behalf of the signer
let pending_tx = token_contract
    .approve(
        signer_provider.signer_address(),
        ROUTER.parse::<Address>().unwrap(),
        token_balance,
    )
    .await
    .unwrap();

let receipt = pending_tx.get_receipt().await.unwrap();

// Assert the transaction was successful
assert!(receipt.status());

let swap_params = SwapContext::builder()
    .chain(chain)
    .router_address(ROUTER.parse::<Address>().unwrap())
    .signer_address(signer_provider.signer_address())
    .output_recipient(RECIPIENT.parse::<Address>().unwrap())
    .token_address(token_address)
    .token_amount(token_balance)
    .path_id(String::from(quote.path_id()))
    .build();

let tx_request = sor_client
    .build_base_transaction(&swap_params)
    .await
    .unwrap();

// User can apply custom gas parameters to the transaction as they see fit

let pending_tx = signer_provider.send_transaction(tx_request).await.unwrap();

let receipt = pending_tx.get_receipt().await.unwrap();

// Assert the transaction was successful
assert!(receipt.status());
```