junobuild-shared 0.8.0

Shared utilities for Juno.
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

use crate::ledger::types::icrc::{IcrcTransferFromResult, IcrcTransferResult};
use candid::Principal;
use ic_cdk::call::{Call, CallResult};
use icrc_ledger_types::icrc1::transfer::TransferArg;
use icrc_ledger_types::icrc2::transfer_from::TransferFromArgs;

/// Initiates a transfer of tokens on a specified ledger using the provided ICRC-1 arguments.
///
/// This function performs a transfer using the `icrc1_transfer` method on the specified ledger
/// and returns the result of the transfer operation.
///
/// # Arguments
/// * `ledger_id` - A `Principal` representing the ID of the ledger where the transfer will be executed.
/// * `args` - A `TransferArg` struct containing the details of the ICRC-1 transfer.
///
/// # Returns
/// A `CallResult<IcrcTransferResult>` indicating either the success or failure of the ICRC-1 token transfer.
pub async fn icrc_transfer_token(
    ledger_id: Principal,
    args: TransferArg,
) -> CallResult<IcrcTransferResult> {
    Ok(Call::bounded_wait(ledger_id, "icrc1_transfer")
        .with_arg(args)
        .await?
        .candid::<IcrcTransferResult>()?)
}

/// Initiates a transfer from a specified account on a ledger using the provided ICRC-2 arguments.
///
/// This function performs a transfer using the `icrc2_transfer_from` method on the specified ledger
/// and returns the result of the transfer operation.
///
/// # Arguments
/// * `ledger_id` - A `Principal` representing the ID of the ledger where the transfer will be executed.
/// * `args` - A `TransferFromArgs` struct containing the details of the ICRC-2 transfer, including the source account.
///
/// # Returns
/// A `CallResult<IcrcTransferFromResult>` indicating either the success or failure of the ICRC-2 token transfer.
pub async fn icrc_transfer_token_from(
    ledger_id: Principal,
    args: TransferFromArgs,
) -> CallResult<IcrcTransferFromResult> {
    Ok(Call::bounded_wait(ledger_id, "icrc2_transfer_from")
        .with_arg(args)
        .await?
        .candid::<IcrcTransferFromResult>()?)
}