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
//! Rust SDK for [Mina Protocol's](https://minaprotocol.com) Archive Node
//! GraphQL endpoint defined by [`o1-labs/Archive-Node-API`](https://github.com/o1-labs/Archive-Node-API).
//!
//! Companion to the daemon-targeting [`mina-sdk`](https://crates.io/crates/mina-sdk)
//! crate. This crate targets the separate **archive** endpoint — events,
//! actions, blocks, network state.
//!
//! # Quick start
//!
//! ```no_run
//! # async fn example() -> mina_archive_sdk::Result<()> {
//! use mina_archive_sdk::{ArchiveClient, BlockStatusFilter, EventFilterOptionsInput};
//!
//! let client = ArchiveClient::new("https://archive.example/graphql");
//! let events = client.get_events(
//! EventFilterOptionsInput::for_address("B62q...")
//! .status(BlockStatusFilter::Canonical)
//! .from(100)
//! .to(200),
//! ).await?;
//!
//! for group in events {
//! let height = group.block_info.map(|b| b.height).unwrap_or(-1);
//! let count = group.event_data.map(|d| d.len()).unwrap_or(0);
//! println!("block {height}: {count} event(s)");
//! }
//! # Ok(())
//! # }
//! ```
//!
//! # Currency
//!
//! Coinbase / fee / user-command amounts are returned as nanomina decimal
//! strings. Use [`Currency`] for safe parsing and arithmetic:
//!
//! ```
//! use mina_archive_sdk::Currency;
//!
//! let coinbase = Currency::from_graphql("720000000000").unwrap();
//! assert_eq!(coinbase.mina(), "720.000000000");
//!
//! let fee = Currency::from_mina("0.01").unwrap();
//! let total = coinbase + fee;
//! ```
//!
//! # Error handling
//!
//! All fallible operations return [`Result<T>`](Result), which uses [`Error`].
//! Match on variants:
//!
//! ```no_run
//! # async fn example() -> mina_archive_sdk::Result<()> {
//! use mina_archive_sdk::{ArchiveClient, EventFilterOptionsInput, Error};
//!
//! let client = ArchiveClient::new("https://archive.example/graphql");
//! match client.get_events(EventFilterOptionsInput::for_address("B62q...")).await {
//! Ok(events) => println!("got {} groups", events.len()),
//! Err(Error::Graphql { messages, .. }) => eprintln!("server rejected the query: {messages}"),
//! Err(Error::Connection { attempts, .. }) => eprintln!("archive unreachable after {attempts} tries"),
//! Err(e) => eprintln!("error: {e}"),
//! }
//! # Ok(())
//! # }
//! ```
pub use ;
pub use Currency;
pub use ;
pub use ;