cielo-rs-sdk 0.1.0

Rust library for interacting with the Cielo API.
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

/*!
# Cielo Rust SDK

Cielo Rust SDK is a Rust library for interacting with the [Cielo API](https://developer.cielo.finance/reference/getfeed). It provides a convenient way to fetch and filter feed data from the Cielo platform.

<div class="warning">
This is not an official SDK. It is a personal project for learning Rust and API development. The included endpoints are primarily for personal use in my own projects and may not cover all features of the Cielo API.
</div>

## Features

- Configurable retry strategy for API requests.
- Fetch feed data with various filters.

## Configuration

You can configure the retry strategy by providing optional parameters when creating the [`CieloApi`] instance:

- `min_retry_interval`: Minimum retry interval in milliseconds.
- `max_retry_interval`: Maximum retry interval in milliseconds.
- `max_retries`: Maximum number of retries.

## Usage

<div class="warning">
The feed data is linked to your account, so the filters you set will be applied to your existing feed data. This means that if you filter by a wallet address, the wallet address should already be in your watchlist for this to work.
</div>

### Creating a CieloApi Instance

```
use cielo_rs_sdk::CieloApi;

let api_key = "your_api_key";
let client = CieloApi::new(api_key, None, None, None)
    .expect("Failed to create CieloApi");
```

### Fetching Feed Data

```no_run
# use cielo_rs_sdk::{CieloApi, api};
# #[tokio::main]
# async fn main() {
# let api_key = "your_api_key";
# let cielo_api = CieloApi::new(api_key, None, None, None).unwrap();
let filters = api::feed::Filters {
    wallet: Some("your_wallet_address".to_string()),
    limit: Some(10),
    list_id: None,
    chains: Some(vec!["solana".to_string()]),
    tx_types: Some(vec![api::feed::TxType::Swap]),
    tokens: None,
    min_usd: Some(100),
    new_trades: Some(true),
    start_from: None,
    from_timestamp: None,
    to_timestamp: None,
    include_market_cap: Some(true),
};
let feed = cielo_api.get_feed(filters).await.unwrap();
# }
*/

#![warn(
    missing_docs,
    rustdoc::unescaped_backticks,
    clippy::missing_errors_doc,
    clippy::missing_docs_in_private_items
)]

mod constants;
mod error;
mod reqwest_ext;

pub mod api;
pub mod models;

// Re-export the CieloApi struct
pub use api::CieloApi;
pub use error::Error;