Merge branch 'maciej-icrc2-types' into 'master'

feat(icrc2): add icrc2 types to the icrc-ledger-types library

The types reflect the types in dfinity/ICRC-1#109 

See merge request dfinity-lab/public/ic!12563

Author: maciejdfinity

packages/icrc-ledger-types/src/icrc2/allowance.rs

@@ -0,0 +1,16 @@
+use candid::{CandidType, Deserialize, Nat};
+
+use super::super::icrc1::account::Account;
+
+#[derive(CandidType, Deserialize, Clone, Debug, PartialEq, Eq)]
+pub struct AllowanceArgs {
+    pub account: Account,
+    pub spender: Account,
+}
+
+#[derive(CandidType, Deserialize, Clone, Debug, PartialEq, Eq)]
+pub struct Allowance {
+    pub allowance: Nat,
+    #[serde(default)]
+    pub expired_at: Option<u64>,
+}

packages/icrc-ledger-types/src/icrc2/approve.rs

@@ -0,0 +1,39 @@
+use candid::{CandidType, Deserialize, Nat};
+
+use super::super::icrc1::account::{Account, Subaccount};
+use super::super::icrc1::transfer::Memo;
+
+#[derive(CandidType, Deserialize, Clone, Debug, PartialEq, Eq)]
+pub struct ApproveArgs {
+    #[serde(default)]
+    pub from_subaccount: Option<Subaccount>,
+    pub spender: Account,
+    pub amount: Nat,
+    #[serde(default)]
+    pub expected_allowance: Option<Nat>,
+    #[serde(default)]
+    pub expired_at: Option<u64>,
+    #[serde(default)]
+    pub fee: Option<Nat>,
+    #[serde(default)]
+    pub memo: Option<Memo>,
+    #[serde(default)]
+    pub created_at_time: Option<u64>,
+}
+
+#[derive(CandidType, Deserialize, Clone, Debug, PartialEq, Eq)]
+pub enum ApproveError {
+    BadFee { expected_fee: Nat },
+    // The caller does not have enough funds to pay the approval fee.
+    InsufficientFunds { balance: Nat },
+    // The caller specified the [expected_allowance] field, and the current
+    // allowance did not match the given value.
+    AllowanceChanged { current_allowance: Nat },
+    // The approval request expired before the ledger had a chance to apply it.
+    Expired { ledger_time: u64 },
+    TooOld,
+    CreatedInFuture { ledger_time: u64 },
+    Duplicate { duplicate_of: Nat },
+    TemporarilyUnavailable,
+    GenericError { error_code: Nat, message: String },
+}

packages/icrc-ledger-types/src/icrc2/mod.rs

@@ -0,0 +1,3 @@
+pub mod allowance;
+pub mod approve;
+pub mod transfer_from;

packages/icrc-ledger-types/src/icrc2/transfer_from.rs

@@ -0,0 +1,34 @@
+use candid::{CandidType, Deserialize, Nat};
+
+use super::super::icrc1::account::{Account, Subaccount};
+use super::super::icrc1::transfer::Memo;
+
+#[derive(CandidType, Deserialize, Clone, Debug, PartialEq, Eq)]
+pub struct TransferFromArgs {
+    #[serde(default)]
+    pub spender_subaccount: Option<Subaccount>,
+    pub from: Account,
+    pub to: Account,
+    pub amount: Nat,
+    #[serde(default)]
+    pub fee: Option<Nat>,
+    #[serde(default)]
+    pub memo: Option<Memo>,
+    #[serde(default)]
+    pub created_at_time: Option<u64>,
+}
+
+#[derive(CandidType, Deserialize, Clone, Debug, PartialEq, Eq)]
+pub enum TransferFromError {
+    BadFee { expected_fee: Nat },
+    BadBurn { min_burn_amount: Nat },
+    // The [from] account does not hold enough funds for the transfer.
+    InsufficientFunds { balance: Nat },
+    // The caller exceeded its allowance.
+    InsufficientAllowance { allowance: Nat },
+    TooOld,
+    CreatedInFuture { ledger_time: u64 },
+    Duplicate { duplicate_of: Nat },
+    TemporarilyUnavailable,
+    GenericError { error_code: Nat, message: String },
+}

packages/icrc-ledger-types/src/lib.rs

@@ -1,3 +1,4 @@
 pub mod icrc;
 pub mod icrc1;
+pub mod icrc2;
 pub mod icrc3;