tronic 0.5.1

A modular, async-first Rust client for the Tron blockchain.
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

use alloy_primitives::U256;
use time::OffsetDateTime;

use crate::domain::address::TronAddress;
use crate::domain::estimate::ResourceState;
use crate::domain::transaction::TxCode;
use crate::domain::trx::Trx;
use crate::domain::{Hash32, Message};
use crate::protocol::ProtoConvError;
use crate::protocol::transaction::result::ContractResult;

#[derive(thiserror::Error)]
pub enum Error {
    #[error("unexpected error: {0}")]
    Unexpected(#[from] eyre::Error),
    #[error("not found: {0}")]
    NotFound(String),
    #[error("tron address is not on blockchain (0 incoming transactions)")]
    NoAccount(TronAddress),
    #[error("tron protocol: {0}")]
    TronProtocol(#[from] tonic::Status),
    #[error("transaction failed with: {0}")]
    FailedTransaction(String, Option<ContractResult>),
    #[error("transport error: {0}")]
    Transport(#[from] tonic::transport::Error),
    #[error("bad header: {0}")]
    BadHeader(#[from] http::header::InvalidHeaderName),
    #[error("invalid uri: {0}")]
    InvalidUri(#[from] http::uri::InvalidUri),
    #[error("failed to decode proto: {0}")]
    Decode(#[from] prost::DecodeError),
    #[error("bad header value: {0}")]
    BadHeaderValue(#[from] http::header::InvalidHeaderValue),
    #[error("signature failure: {0}")]
    Signature(#[from] k256::ecdsa::signature::Error),
    #[error("invalid input: {0}")]
    InvalidInput(String),
    #[error("precondigion failed: {0}")]
    PreconditionFailed(String),
    #[error("expired at: {0}")]
    Expired(OffsetDateTime),
    #[error("insufficient resources: {0:#?}")]
    InsufficientResources(ResourceState),
    #[error(
        "insufficient token balance: {balance}, but need: {need} for {token}"
    )]
    InsufficientTokenBalance {
        balance: U256,
        need: U256,
        token: &'static str,
    },
    #[error("insufficient balance: {balance}, but need: {need}")]
    InsufficientBalance { balance: Trx, need: Trx },
    #[error(
        "insufficient balance to unfreeze: {frozen}, but trying to unfreeze: {trying_to_unfreeze}"
    )]
    InsufficientFrozen {
        frozen: Trx,
        trying_to_unfreeze: Trx,
    },
    #[error("transaction error: {txid:?}, {result:?}, {msg}")]
    Transaction {
        txid: Hash32,
        result: TxCode,
        msg: Message,
    },
    #[error("transaction was not confirmed within the expected time")]
    TransactionTimeout,
    #[error("failed to convert protocol to rust datatype: {0}")]
    ProtoConv(#[from] ProtoConvError),
}

crate::impl_debug!(Error);