canic-core 0.59.0

Canic — a canister orchestration and management toolkit for the Internet Computer
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
121

use crate::{
    InternalError,
    cdk::{
        candid::Nat,
        icrc_ledger_types::icrc1::transfer::TransferArg,
        types::{Account, Principal, Subaccount},
    },
    ids::BuildNetwork,
    infra::{
        InfraError,
        ic::icp_refill::{
            IcpRefillCanisterOverrides, IcpRefillCanisters, IcpRefillInfra,
            IcpXdrConversionRateResponse, Icrc1TransferResult, NotifyTopUpArg, NotifyTopUpResult,
        },
    },
    ops::ic::IcOpsError,
};
use thiserror::Error as ThisError;

///
/// IcpRefillOpsError
///

#[derive(Debug, ThisError)]
pub enum IcpRefillOpsError {
    #[error(transparent)]
    Infra(#[from] InfraError),
}

impl From<IcpRefillOpsError> for InternalError {
    fn from(err: IcpRefillOpsError) -> Self {
        IcOpsError::from(err).into()
    }
}

///
/// IcpRefillOps
///

pub struct IcpRefillOps;

impl IcpRefillOps {
    #[must_use]
    pub fn topup_memo() -> Vec<u8> {
        IcpRefillInfra::topup_memo()
    }

    pub fn cmc_topup_account(
        cmc_canister_id: Principal,
        target_canister: Principal,
    ) -> Result<Account, InternalError> {
        map_infra(IcpRefillInfra::cmc_topup_account(
            cmc_canister_id,
            target_canister,
        ))
    }

    #[must_use]
    pub fn transfer_arg(
        from_subaccount: Option<Subaccount>,
        to: Account,
        amount_e8s: u64,
        fee_e8s: u64,
        memo: Vec<u8>,
        created_at_time_ns: u64,
    ) -> TransferArg {
        IcpRefillInfra::transfer_arg(
            from_subaccount,
            to,
            amount_e8s,
            fee_e8s,
            memo,
            created_at_time_ns,
        )
    }

    pub fn checked_block_index(block_index: Nat) -> Result<u64, InternalError> {
        map_infra(IcpRefillInfra::checked_block_index(block_index))
    }

    pub fn resolve_canisters(
        network: BuildNetwork,
        overrides: IcpRefillCanisterOverrides,
    ) -> Result<IcpRefillCanisters, InternalError> {
        map_infra(IcpRefillInfra::resolve_canisters(network, overrides))
    }

    pub async fn icrc1_fee(ledger_id: Principal) -> Result<Nat, InternalError> {
        map_infra(IcpRefillInfra::icrc1_fee(ledger_id).await)
    }

    pub async fn icrc1_decimals(ledger_id: Principal) -> Result<u8, InternalError> {
        map_infra(IcpRefillInfra::icrc1_decimals(ledger_id).await)
    }

    pub async fn icrc1_transfer(
        ledger_id: Principal,
        args: TransferArg,
    ) -> Result<Icrc1TransferResult, InternalError> {
        map_infra(IcpRefillInfra::icrc1_transfer(ledger_id, args).await)
    }

    pub async fn notify_top_up(
        cmc_id: Principal,
        args: NotifyTopUpArg,
    ) -> Result<NotifyTopUpResult, InternalError> {
        map_infra(IcpRefillInfra::notify_top_up(cmc_id, args).await)
    }

    pub async fn get_icp_xdr_conversion_rate(
        cmc_id: Principal,
    ) -> Result<IcpXdrConversionRateResponse, InternalError> {
        map_infra(IcpRefillInfra::get_icp_xdr_conversion_rate(cmc_id).await)
    }
}

fn map_infra<T>(result: Result<T, InfraError>) -> Result<T, InternalError> {
    result
        .map_err(IcpRefillOpsError::from)
        .map_err(InternalError::from)
}