@junobuild/functions 0.5.3 → 0.5.5-next-2026-01-16

package/src/canisters/declarations/ledger-icrc/icrc_index.did.d.ts

@@ -12,25 +12,36 @@ import type { Principal } from '@icp-sdk/core/principal';
 
 export interface Account {
   'owner' : Principal,
-  'subaccount' : [] | [Uint8Array],
+  'subaccount' : [] | [SubAccount],
 }
 export interface Approve {
-  'fee' : [] | [bigint],
+  'fee' : [] | [Tokens],
   'from' : Account,
   'memo' : [] | [Uint8Array],
   'created_at_time' : [] | [bigint],
-  'amount' : bigint,
-  'expected_allowance' : [] | [bigint],
+  'amount' : Tokens,
+  'expected_allowance' : [] | [Tokens],
   'expires_at' : [] | [bigint],
   'spender' : Account,
 }
+export type Block = Value;
+export type BlockIndex = bigint;
 export interface Burn {
+  'fee' : [] | [bigint],
   'from' : Account,
   'memo' : [] | [Uint8Array],
   'created_at_time' : [] | [bigint],
-  'amount' : bigint,
+  'amount' : Tokens,
   'spender' : [] | [Account],
 }
+export interface FeeCollector {
+  'ts' : [] | [bigint],
+  'fee_collector' : [] | [Account],
+  'caller' : [] | [Principal],
+}
+export interface FeeCollectorRanges {
+  'ranges' : Array<[Account, Array<[BlockIndex, BlockIndex]>]>,
+}
 export interface GetAccountTransactionsArgs {
   /**
    * Maximum number of transactions to fetch.
@@ -39,62 +50,103 @@ export interface GetAccountTransactionsArgs {
   /**
    * The txid of the last transaction seen by the client.
    * If None then the results will start from the most recent
-   * txid.
+   * txid. If set then the results will start from the next
+   * most recent txid after start (start won't be included).
    */
-  'start' : [] | [TxId],
+  'start' : [] | [BlockIndex],
   'account' : Account,
 }
+export interface GetBlocksRequest { 'start' : bigint, 'length' : bigint }
+export interface GetBlocksResponse {
+  'blocks' : Array<Block>,
+  'chain_length' : bigint,
+}
 export interface GetTransactions {
+  'balance' : Tokens,
   'transactions' : Array<TransactionWithId>,
   /**
    * The txid of the oldest transaction the account has
    */
-  'oldest_tx_id' : [] | [TxId],
+  'oldest_tx_id' : [] | [BlockIndex],
 }
 export interface GetTransactionsErr { 'message' : string }
 export type GetTransactionsResult = { 'Ok' : GetTransactions } |
   { 'Err' : GetTransactionsErr };
-/**
- * The initialization parameters of the Index canister.
- */
-export interface InitArgs { 'ledger_id' : Principal }
+export type IndexArg = { 'Upgrade' : UpgradeArg } |
+  { 'Init' : InitArg };
+export interface InitArg {
+  'ledger_id' : Principal,
+  /**
+   * The interval in seconds in which to retrieve blocks from the ledger. A lower value makes the index more
+   * responsive in showing new blocks, but increases the consumption of cycles of both the index and ledger canisters.
+   * A higher values means that it takes longer for new blocks to show up in the index.
+   */
+  'retrieve_blocks_from_ledger_interval_seconds' : [] | [bigint],
+}
 export interface ListSubaccountsArgs {
   'owner' : Principal,
   'start' : [] | [SubAccount],
 }
+export type Map = Array<[string, Value]>;
 export interface Mint {
   'to' : Account,
+  'fee' : [] | [bigint],
   'memo' : [] | [Uint8Array],
   'created_at_time' : [] | [bigint],
-  'amount' : bigint,
+  'amount' : Tokens,
 }
+export interface Status { 'num_blocks_synced' : BlockIndex }
 export type SubAccount = Uint8Array;
+export type Tokens = bigint;
 export interface Transaction {
   'burn' : [] | [Burn],
   'kind' : string,
   'mint' : [] | [Mint],
   'approve' : [] | [Approve],
+  'fee_collector' : [] | [FeeCollector],
   'timestamp' : bigint,
   'transfer' : [] | [Transfer],
 }
-export interface TransactionWithId { 'id' : TxId, 'transaction' : Transaction }
+export interface TransactionWithId {
+  'id' : BlockIndex,
+  'transaction' : Transaction,
+}
 export interface Transfer {
   'to' : Account,
-  'fee' : [] | [bigint],
+  'fee' : [] | [Tokens],
   'from' : Account,
   'memo' : [] | [Uint8Array],
   'created_at_time' : [] | [bigint],
-  'amount' : bigint,
+  'amount' : Tokens,
   'spender' : [] | [Account],
 }
-export type TxId = bigint;
+export interface UpgradeArg {
+  'ledger_id' : [] | [Principal],
+  /**
+   * The interval in seconds in which to retrieve blocks from the ledger. A lower value makes the index more
+   * responsive in showing new blocks, but increases the consumption of cycles of both the index and ledger canisters.
+   * A higher values means that it takes longer for new blocks to show up in the index.
+   */
+  'retrieve_blocks_from_ledger_interval_seconds' : [] | [bigint],
+}
+export type Value = { 'Int' : bigint } |
+  { 'Map' : Map } |
+  { 'Nat' : bigint } |
+  { 'Nat64' : bigint } |
+  { 'Blob' : Uint8Array } |
+  { 'Text' : string } |
+  { 'Array' : Array<Value> };
 export interface _SERVICE {
   'get_account_transactions' : ActorMethod<
     [GetAccountTransactionsArgs],
     GetTransactionsResult
   >,
+  'get_blocks' : ActorMethod<[GetBlocksRequest], GetBlocksResponse>,
+  'get_fee_collectors_ranges' : ActorMethod<[], FeeCollectorRanges>,
+  'icrc1_balance_of' : ActorMethod<[Account], Tokens>,
   'ledger_id' : ActorMethod<[], Principal>,
   'list_subaccounts' : ActorMethod<[ListSubaccountsArgs], Array<SubAccount>>,
+  'status' : ActorMethod<[], Status>,
 }
 export declare const idlService: IDL.ServiceClass;
 export declare const idlInitArgs: IDL.Type[];

package/src/canisters/declarations/ledger-icrc/icrc_index.did.idl.js

@@ -8,47 +8,68 @@
 
 import {IDL} from '@icp-sdk/core/candid';
 
-export const InitArgs = IDL.Record({ledger_id: IDL.Principal});
-export const TxId = IDL.Nat;
+export const Value = IDL.Rec();
+export const UpgradeArg = IDL.Record({
+  ledger_id: IDL.Opt(IDL.Principal),
+  retrieve_blocks_from_ledger_interval_seconds: IDL.Opt(IDL.Nat64)
+});
+export const InitArg = IDL.Record({
+  ledger_id: IDL.Principal,
+  retrieve_blocks_from_ledger_interval_seconds: IDL.Opt(IDL.Nat64)
+});
+export const IndexArg = IDL.Variant({
+  Upgrade: UpgradeArg,
+  Init: InitArg
+});
+export const BlockIndex = IDL.Nat;
+export const SubAccount = IDL.Vec(IDL.Nat8);
 export const Account = IDL.Record({
   owner: IDL.Principal,
-  subaccount: IDL.Opt(IDL.Vec(IDL.Nat8))
+  subaccount: IDL.Opt(SubAccount)
 });
 export const GetAccountTransactionsArgs = IDL.Record({
   max_results: IDL.Nat,
-  start: IDL.Opt(TxId),
+  start: IDL.Opt(BlockIndex),
   account: Account
 });
+export const Tokens = IDL.Nat;
 export const Burn = IDL.Record({
+  fee: IDL.Opt(IDL.Nat),
   from: Account,
   memo: IDL.Opt(IDL.Vec(IDL.Nat8)),
   created_at_time: IDL.Opt(IDL.Nat64),
-  amount: IDL.Nat,
+  amount: Tokens,
   spender: IDL.Opt(Account)
 });
 export const Mint = IDL.Record({
   to: Account,
+  fee: IDL.Opt(IDL.Nat),
   memo: IDL.Opt(IDL.Vec(IDL.Nat8)),
   created_at_time: IDL.Opt(IDL.Nat64),
-  amount: IDL.Nat
+  amount: Tokens
 });
 export const Approve = IDL.Record({
-  fee: IDL.Opt(IDL.Nat),
+  fee: IDL.Opt(Tokens),
   from: Account,
   memo: IDL.Opt(IDL.Vec(IDL.Nat8)),
   created_at_time: IDL.Opt(IDL.Nat64),
-  amount: IDL.Nat,
-  expected_allowance: IDL.Opt(IDL.Nat),
+  amount: Tokens,
+  expected_allowance: IDL.Opt(Tokens),
   expires_at: IDL.Opt(IDL.Nat64),
   spender: Account
 });
+export const FeeCollector = IDL.Record({
+  ts: IDL.Opt(IDL.Nat64),
+  fee_collector: IDL.Opt(Account),
+  caller: IDL.Opt(IDL.Principal)
+});
 export const Transfer = IDL.Record({
   to: Account,
-  fee: IDL.Opt(IDL.Nat),
+  fee: IDL.Opt(Tokens),
   from: Account,
   memo: IDL.Opt(IDL.Vec(IDL.Nat8)),
   created_at_time: IDL.Opt(IDL.Nat64),
-  amount: IDL.Nat,
+  amount: Tokens,
   spender: IDL.Opt(Account)
 });
 export const Transaction = IDL.Record({
@@ -56,78 +77,130 @@ export const Transaction = IDL.Record({
   kind: IDL.Text,
   mint: IDL.Opt(Mint),
   approve: IDL.Opt(Approve),
+  fee_collector: IDL.Opt(FeeCollector),
   timestamp: IDL.Nat64,
   transfer: IDL.Opt(Transfer)
 });
 export const TransactionWithId = IDL.Record({
-  id: TxId,
+  id: BlockIndex,
   transaction: Transaction
 });
 export const GetTransactions = IDL.Record({
+  balance: Tokens,
   transactions: IDL.Vec(TransactionWithId),
-  oldest_tx_id: IDL.Opt(TxId)
+  oldest_tx_id: IDL.Opt(BlockIndex)
 });
 export const GetTransactionsErr = IDL.Record({message: IDL.Text});
 export const GetTransactionsResult = IDL.Variant({
   Ok: GetTransactions,
   Err: GetTransactionsErr
 });
-export const SubAccount = IDL.Vec(IDL.Nat8);
+export const GetBlocksRequest = IDL.Record({
+  start: IDL.Nat,
+  length: IDL.Nat
+});
+export const Map = IDL.Vec(IDL.Tuple(IDL.Text, Value));
+Value.fill(
+  IDL.Variant({
+    Int: IDL.Int,
+    Map: Map,
+    Nat: IDL.Nat,
+    Nat64: IDL.Nat64,
+    Blob: IDL.Vec(IDL.Nat8),
+    Text: IDL.Text,
+    Array: IDL.Vec(Value)
+  })
+);
+export const Block = Value;
+export const GetBlocksResponse = IDL.Record({
+  blocks: IDL.Vec(Block),
+  chain_length: IDL.Nat64
+});
+export const FeeCollectorRanges = IDL.Record({
+  ranges: IDL.Vec(IDL.Tuple(Account, IDL.Vec(IDL.Tuple(BlockIndex, BlockIndex))))
+});
 export const ListSubaccountsArgs = IDL.Record({
   owner: IDL.Principal,
   start: IDL.Opt(SubAccount)
 });
+export const Status = IDL.Record({num_blocks_synced: BlockIndex});
 
 export const idlService = IDL.Service({
-  get_account_transactions: IDL.Func([GetAccountTransactionsArgs], [GetTransactionsResult], []),
+  get_account_transactions: IDL.Func(
+    [GetAccountTransactionsArgs],
+    [GetTransactionsResult],
+    ['query']
+  ),
+  get_blocks: IDL.Func([GetBlocksRequest], [GetBlocksResponse], ['query']),
+  get_fee_collectors_ranges: IDL.Func([], [FeeCollectorRanges], ['query']),
+  icrc1_balance_of: IDL.Func([Account], [Tokens], ['query']),
   ledger_id: IDL.Func([], [IDL.Principal], ['query']),
-  list_subaccounts: IDL.Func([ListSubaccountsArgs], [IDL.Vec(SubAccount)], ['query'])
+  list_subaccounts: IDL.Func([ListSubaccountsArgs], [IDL.Vec(SubAccount)], ['query']),
+  status: IDL.Func([], [Status], ['query'])
 });
 
-export const idlInitArgs = [InitArgs];
+export const idlInitArgs = [IDL.Opt(IndexArg)];
 
 export const idlFactory = ({IDL}) => {
-  const InitArgs = IDL.Record({ledger_id: IDL.Principal});
-  const TxId = IDL.Nat;
+  const Value = IDL.Rec();
+  const UpgradeArg = IDL.Record({
+    ledger_id: IDL.Opt(IDL.Principal),
+    retrieve_blocks_from_ledger_interval_seconds: IDL.Opt(IDL.Nat64)
+  });
+  const InitArg = IDL.Record({
+    ledger_id: IDL.Principal,
+    retrieve_blocks_from_ledger_interval_seconds: IDL.Opt(IDL.Nat64)
+  });
+  const IndexArg = IDL.Variant({Upgrade: UpgradeArg, Init: InitArg});
+  const BlockIndex = IDL.Nat;
+  const SubAccount = IDL.Vec(IDL.Nat8);
   const Account = IDL.Record({
     owner: IDL.Principal,
-    subaccount: IDL.Opt(IDL.Vec(IDL.Nat8))
+    subaccount: IDL.Opt(SubAccount)
   });
   const GetAccountTransactionsArgs = IDL.Record({
     max_results: IDL.Nat,
-    start: IDL.Opt(TxId),
+    start: IDL.Opt(BlockIndex),
     account: Account
   });
+  const Tokens = IDL.Nat;
   const Burn = IDL.Record({
+    fee: IDL.Opt(IDL.Nat),
     from: Account,
     memo: IDL.Opt(IDL.Vec(IDL.Nat8)),
     created_at_time: IDL.Opt(IDL.Nat64),
-    amount: IDL.Nat,
+    amount: Tokens,
     spender: IDL.Opt(Account)
   });
   const Mint = IDL.Record({
     to: Account,
+    fee: IDL.Opt(IDL.Nat),
     memo: IDL.Opt(IDL.Vec(IDL.Nat8)),
     created_at_time: IDL.Opt(IDL.Nat64),
-    amount: IDL.Nat
+    amount: Tokens
   });
   const Approve = IDL.Record({
-    fee: IDL.Opt(IDL.Nat),
+    fee: IDL.Opt(Tokens),
     from: Account,
     memo: IDL.Opt(IDL.Vec(IDL.Nat8)),
     created_at_time: IDL.Opt(IDL.Nat64),
-    amount: IDL.Nat,
-    expected_allowance: IDL.Opt(IDL.Nat),
+    amount: Tokens,
+    expected_allowance: IDL.Opt(Tokens),
     expires_at: IDL.Opt(IDL.Nat64),
     spender: Account
   });
+  const FeeCollector = IDL.Record({
+    ts: IDL.Opt(IDL.Nat64),
+    fee_collector: IDL.Opt(Account),
+    caller: IDL.Opt(IDL.Principal)
+  });
   const Transfer = IDL.Record({
     to: Account,
-    fee: IDL.Opt(IDL.Nat),
+    fee: IDL.Opt(Tokens),
     from: Account,
     memo: IDL.Opt(IDL.Vec(IDL.Nat8)),
     created_at_time: IDL.Opt(IDL.Nat64),
-    amount: IDL.Nat,
+    amount: Tokens,
     spender: IDL.Opt(Account)
   });
   const Transaction = IDL.Record({
@@ -135,37 +208,79 @@ export const idlFactory = ({IDL}) => {
     kind: IDL.Text,
     mint: IDL.Opt(Mint),
     approve: IDL.Opt(Approve),
+    fee_collector: IDL.Opt(FeeCollector),
     timestamp: IDL.Nat64,
     transfer: IDL.Opt(Transfer)
   });
   const TransactionWithId = IDL.Record({
-    id: TxId,
+    id: BlockIndex,
     transaction: Transaction
   });
   const GetTransactions = IDL.Record({
+    balance: Tokens,
     transactions: IDL.Vec(TransactionWithId),
-    oldest_tx_id: IDL.Opt(TxId)
+    oldest_tx_id: IDL.Opt(BlockIndex)
   });
   const GetTransactionsErr = IDL.Record({message: IDL.Text});
   const GetTransactionsResult = IDL.Variant({
     Ok: GetTransactions,
     Err: GetTransactionsErr
   });
-  const SubAccount = IDL.Vec(IDL.Nat8);
+  const GetBlocksRequest = IDL.Record({
+    start: IDL.Nat,
+    length: IDL.Nat
+  });
+  const Map = IDL.Vec(IDL.Tuple(IDL.Text, Value));
+  Value.fill(
+    IDL.Variant({
+      Int: IDL.Int,
+      Map: Map,
+      Nat: IDL.Nat,
+      Nat64: IDL.Nat64,
+      Blob: IDL.Vec(IDL.Nat8),
+      Text: IDL.Text,
+      Array: IDL.Vec(Value)
+    })
+  );
+  const Block = Value;
+  const GetBlocksResponse = IDL.Record({
+    blocks: IDL.Vec(Block),
+    chain_length: IDL.Nat64
+  });
+  const FeeCollectorRanges = IDL.Record({
+    ranges: IDL.Vec(IDL.Tuple(Account, IDL.Vec(IDL.Tuple(BlockIndex, BlockIndex))))
+  });
   const ListSubaccountsArgs = IDL.Record({
     owner: IDL.Principal,
     start: IDL.Opt(SubAccount)
   });
+  const Status = IDL.Record({num_blocks_synced: BlockIndex});
 
   return IDL.Service({
-    get_account_transactions: IDL.Func([GetAccountTransactionsArgs], [GetTransactionsResult], []),
+    get_account_transactions: IDL.Func(
+      [GetAccountTransactionsArgs],
+      [GetTransactionsResult],
+      ['query']
+    ),
+    get_blocks: IDL.Func([GetBlocksRequest], [GetBlocksResponse], ['query']),
+    get_fee_collectors_ranges: IDL.Func([], [FeeCollectorRanges], ['query']),
+    icrc1_balance_of: IDL.Func([Account], [Tokens], ['query']),
     ledger_id: IDL.Func([], [IDL.Principal], ['query']),
-    list_subaccounts: IDL.Func([ListSubaccountsArgs], [IDL.Vec(SubAccount)], ['query'])
+    list_subaccounts: IDL.Func([ListSubaccountsArgs], [IDL.Vec(SubAccount)], ['query']),
+    status: IDL.Func([], [Status], ['query'])
   });
 };
 
 export const init = ({IDL}) => {
-  const InitArgs = IDL.Record({ledger_id: IDL.Principal});
+  const UpgradeArg = IDL.Record({
+    ledger_id: IDL.Opt(IDL.Principal),
+    retrieve_blocks_from_ledger_interval_seconds: IDL.Opt(IDL.Nat64)
+  });
+  const InitArg = IDL.Record({
+    ledger_id: IDL.Principal,
+    retrieve_blocks_from_ledger_interval_seconds: IDL.Opt(IDL.Nat64)
+  });
+  const IndexArg = IDL.Variant({Upgrade: UpgradeArg, Init: InitArg});
 
-  return [InitArgs];
+  return [IDL.Opt(IndexArg)];
 };

package/src/canisters/declarations/ledger-icrc/icrc_ledger.did.d.ts

@@ -120,6 +120,11 @@ export interface DataCertificate {
  */
 export type Duration = bigint;
 export interface FeatureFlags { 'icrc2' : boolean }
+export interface FeeCollector {
+  'ts' : [] | [bigint],
+  'fee_collector' : [] | [Account],
+  'caller' : [] | [Principal],
+}
 export interface FieldsDisplay {
   'fields' : Array<[string, Icrc21Value]>,
   'intent' : string,
@@ -396,6 +401,7 @@ export interface Transaction {
   'kind' : string,
   'mint' : [] | [Mint],
   'approve' : [] | [Approve],
+  'fee_collector' : [] | [FeeCollector],
   'timestamp' : Timestamp,
   'transfer' : [] | [Transfer],
 }

package/src/canisters/declarations/ledger-icrc/icrc_ledger.did.idl.js

@@ -148,6 +148,11 @@ export const Approve = IDL.Record({
   expires_at: IDL.Opt(Timestamp),
   spender: Account
 });
+export const FeeCollector = IDL.Record({
+  ts: IDL.Opt(IDL.Nat64),
+  fee_collector: IDL.Opt(Account),
+  caller: IDL.Opt(IDL.Principal)
+});
 export const Transfer = IDL.Record({
   to: Account,
   fee: IDL.Opt(IDL.Nat),
@@ -162,6 +167,7 @@ export const Transaction = IDL.Record({
   kind: IDL.Text,
   mint: IDL.Opt(Mint),
   approve: IDL.Opt(Approve),
+  fee_collector: IDL.Opt(FeeCollector),
   timestamp: Timestamp,
   transfer: IDL.Opt(Transfer)
 });
@@ -567,6 +573,11 @@ export const idlFactory = ({IDL}) => {
     expires_at: IDL.Opt(Timestamp),
     spender: Account
   });
+  const FeeCollector = IDL.Record({
+    ts: IDL.Opt(IDL.Nat64),
+    fee_collector: IDL.Opt(Account),
+    caller: IDL.Opt(IDL.Principal)
+  });
   const Transfer = IDL.Record({
     to: Account,
     fee: IDL.Opt(IDL.Nat),
@@ -581,6 +592,7 @@ export const idlFactory = ({IDL}) => {
     kind: IDL.Text,
     mint: IDL.Opt(Mint),
     approve: IDL.Opt(Approve),
+    fee_collector: IDL.Opt(FeeCollector),
     timestamp: Timestamp,
     transfer: IDL.Opt(Transfer)
   });