@ic-reactor/mcp 0.0.0-stage → 0.0.0

package/examples/canister-studio/src/canisters/icp_ledger.ts

@@ -0,0 +1,584 @@
+// Generated by Meant from a Meant Contract. Do not edit.
+import * as $ from "@meantjs/schema";
+
+export type Account = { owner: $.Principal; subaccount: Uint8Array | null };
+const $Account: $.Schema<Account> = $.c.rec(() => $.c.record({ owner: $.c.principal, subaccount: $.c.opt($.c.blob()) }));
+export { $Account as Account };
+
+/** Arguments for the `account_balance` call. */
+export type AccountBalanceArgs = { account: Uint8Array };
+/** Arguments for the `account_balance` call. */
+const $AccountBalanceArgs: $.Schema<AccountBalanceArgs> = $.c.rec(() => $.c.record({ account: $.c.blob() }));
+export { $AccountBalanceArgs as AccountBalanceArgs };
+
+export type AccountBalanceArgsDfx = { account: string };
+const $AccountBalanceArgsDfx: $.Schema<AccountBalanceArgsDfx> = $.c.rec(() => $.c.record({ account: $.c.text }));
+export { $AccountBalanceArgsDfx as AccountBalanceArgsDfx };
+
+/**
+ * AccountIdentifier is a 32-byte array.
+ * The first 4 bytes is big-endian encoding of a CRC32 checksum of the last 28 bytes.
+ */
+export type AccountIdentifier = Uint8Array;
+/**
+ * AccountIdentifier is a 32-byte array.
+ * The first 4 bytes is big-endian encoding of a CRC32 checksum of the last 28 bytes.
+ */
+const $AccountIdentifier: $.Schema<AccountIdentifier> = $.c.rec(() => $.c.blob());
+export { $AccountIdentifier as AccountIdentifier };
+
+export type Allowance = { allowance: bigint; expires_at: bigint | null };
+const $Allowance: $.Schema<Allowance> = $.c.rec(() => $.c.record({ allowance: $.c.nat, expires_at: $.c.opt($.c.nat64) }));
+export { $Allowance as Allowance };
+
+export type AllowanceArgs = { account: Account; spender: Account };
+const $AllowanceArgs: $.Schema<AllowanceArgs> = $.c.rec(() => $.c.record({ account: $Account, spender: $Account }));
+export { $AllowanceArgs as AllowanceArgs };
+
+/** The allowances returned by the `get_allowances` endpoint. */
+export type Allowances = Array<{ from_account_id: string; to_spender_id: string; allowance: Tokens; expires_at: bigint | null }>;
+/** The allowances returned by the `get_allowances` endpoint. */
+const $Allowances: $.Schema<Allowances> = $.c.rec(() => $.c.vec($.c.record({ from_account_id: $.c.text, to_spender_id: $.c.text, allowance: $Tokens, expires_at: $.c.opt($.c.nat64) })));
+export { $Allowances as Allowances };
+
+export type ApproveArgs = { fee: bigint | null; memo: Uint8Array | null; from_subaccount: Uint8Array | null; created_at_time: bigint | null; amount: bigint; expected_allowance: bigint | null; expires_at: bigint | null; spender: Account };
+const $ApproveArgs: $.Schema<ApproveArgs> = $.c.rec(() => $.c.record({ fee: $.c.opt($.c.nat), memo: $.c.opt($.c.blob()), from_subaccount: $.c.opt($.c.blob()), created_at_time: $.c.opt($.c.nat64), amount: $.c.nat, expected_allowance: $.c.opt($.c.nat), expires_at: $.c.opt($.c.nat64), spender: $Account }));
+export { $ApproveArgs as ApproveArgs };
+
+export type ApproveError = { tag: "GenericError"; value: { message: string; error_code: bigint } } | { tag: "TemporarilyUnavailable" } | { tag: "Duplicate"; value: { duplicate_of: bigint } } | { tag: "BadFee"; value: { expected_fee: bigint } } | { tag: "AllowanceChanged"; value: { current_allowance: bigint } } | { tag: "CreatedInFuture"; value: { ledger_time: bigint } } | { tag: "TooOld" } | { tag: "Expired"; value: { ledger_time: bigint } } | { tag: "InsufficientFunds"; value: { balance: bigint } };
+const $ApproveError: $.Schema<ApproveError> = $.c.rec(() => $.c.variant({ GenericError: $.c.record({ message: $.c.text, error_code: $.c.nat }), TemporarilyUnavailable: $.c.null, Duplicate: $.c.record({ duplicate_of: $.c.nat }), BadFee: $.c.record({ expected_fee: $.c.nat }), AllowanceChanged: $.c.record({ current_allowance: $.c.nat }), CreatedInFuture: $.c.record({ ledger_time: $.c.nat64 }), TooOld: $.c.null, Expired: $.c.record({ ledger_time: $.c.nat64 }), InsufficientFunds: $.c.record({ balance: $.c.nat }) }));
+export { $ApproveError as ApproveError };
+
+export type ApproveResult = { tag: "Ok"; value: bigint } | { tag: "Err"; value: ApproveError };
+const $ApproveResult: $.Schema<ApproveResult> = $.c.rec(() => $.c.variant({ Ok: $.c.nat, Err: $ApproveError }));
+export { $ApproveResult as ApproveResult };
+
+export type Archive = { canister_id: $.Principal };
+const $Archive: $.Schema<Archive> = $.c.rec(() => $.c.record({ canister_id: $.c.principal }));
+export { $Archive as Archive };
+
+export type ArchiveOptions = { num_blocks_to_archive: bigint; max_transactions_per_response: bigint | null; trigger_threshold: bigint; more_controller_ids: Array<$.Principal> | null; max_message_size_bytes: bigint | null; cycles_for_archive_creation: bigint | null; node_max_memory_size_bytes: bigint | null; controller_id: $.Principal };
+const $ArchiveOptions: $.Schema<ArchiveOptions> = $.c.rec(() => $.c.record({ num_blocks_to_archive: $.c.nat64, max_transactions_per_response: $.c.opt($.c.nat64), trigger_threshold: $.c.nat64, more_controller_ids: $.c.opt($.c.vec($.c.principal)), max_message_size_bytes: $.c.opt($.c.nat64), cycles_for_archive_creation: $.c.opt($.c.nat64), node_max_memory_size_bytes: $.c.opt($.c.nat64), controller_id: $.c.principal }));
+export { $ArchiveOptions as ArchiveOptions };
+
+export type ArchivedBlocksRange = {
+  /**
+   * The function that should be called to fetch the archived blocks.
+   * The range of the blocks accessible using this function is given by [from]
+   * and [len] fields above.
+   */
+  callback: QueryArchiveFn;
+  /** The index of the first archived block that can be fetched using the callback. */
+  start: bigint;
+  /** The number of blocks that can be fetch using the callback. */
+  length: bigint;
+};
+const $ArchivedBlocksRange: $.Schema<ArchivedBlocksRange> = $.c.rec(() => $.c.record({ callback: $QueryArchiveFn, start: $.c.nat64, length: $.c.nat64 }));
+export { $ArchivedBlocksRange as ArchivedBlocksRange };
+
+export type ArchivedEncodedBlocksRange = { callback: { principal: $.Principal; method: string }; start: bigint; length: bigint };
+const $ArchivedEncodedBlocksRange: $.Schema<ArchivedEncodedBlocksRange> = $.c.rec(() => $.c.record({ callback: $.c.func([$GetBlocksArgs], [$.c.variant({ Ok: $.c.vec($.c.blob()), Err: $QueryArchiveError })], "query"), start: $.c.nat64, length: $.c.nat64 }));
+export { $ArchivedEncodedBlocksRange as ArchivedEncodedBlocksRange };
+
+export type Archives = { archives: Array<Archive> };
+const $Archives: $.Schema<Archives> = $.c.rec(() => $.c.record({ archives: $.c.vec($Archive) }));
+export { $Archives as Archives };
+
+export type Block = { transaction: Transaction; timestamp: TimeStamp; parent_hash: Uint8Array | null };
+const $Block: $.Schema<Block> = $.c.rec(() => $.c.record({ transaction: $Transaction, timestamp: $TimeStamp, parent_hash: $.c.opt($.c.blob()) }));
+export { $Block as Block };
+
+/** Sequence number of a block produced by the ledger. */
+export type BlockIndex = bigint;
+/** Sequence number of a block produced by the ledger. */
+const $BlockIndex: $.Schema<BlockIndex> = $.c.rec(() => $.c.nat64);
+export { $BlockIndex as BlockIndex };
+
+/** A prefix of the block range specified in the [GetBlocksArgs] request. */
+export type BlockRange = {
+  /**
+   * A prefix of the requested block range.
+   * The index of the first block is equal to [GetBlocksArgs.from].
+   *
+   * Note that the number of blocks might be less than the requested
+   * [GetBlocksArgs.len] for various reasons, for example:
+   *
+   * 1. The query might have hit the replica with an outdated state
+   * that doesn't have the full block range yet.
+   * 2. The requested range is too large to fit into a single reply.
+   *
+   * NOTE: the list of blocks can be empty if:
+   * 1. [GetBlocksArgs.len] was zero.
+   * 2. [GetBlocksArgs.from] was larger than the last block known to the canister.
+   */
+  blocks: Array<Block>;
+};
+/** A prefix of the block range specified in the [GetBlocksArgs] request. */
+const $BlockRange: $.Schema<BlockRange> = $.c.rec(() => $.c.record({ blocks: $.c.vec($Block) }));
+export { $BlockRange as BlockRange };
+
+export type Duration = { secs: bigint; nanos: number };
+const $Duration: $.Schema<Duration> = $.c.rec(() => $.c.record({ secs: $.c.nat64, nanos: $.c.nat32 }));
+export { $Duration as Duration };
+
+export type FeatureFlags = { icrc2: boolean };
+const $FeatureFlags: $.Schema<FeatureFlags> = $.c.rec(() => $.c.record({ icrc2: $.c.bool }));
+export { $FeatureFlags as FeatureFlags };
+
+export type FieldsDisplay = { fields: Array<[string, Icrc21Value]>; intent: string };
+const $FieldsDisplay: $.Schema<FieldsDisplay> = $.c.rec(() => $.c.record({ fields: $.c.vec($.c.tuple([$.c.text, $Icrc21Value])), intent: $.c.text }));
+export { $FieldsDisplay as FieldsDisplay };
+
+/**
+ * The arguments for the `get_allowances` endpoint.
+ * The `prev_spender_id` argument can be used for pagination. If specified
+ * the endpoint returns allowances that are lexicographically greater than
+ * (`from_account_id`, `prev_spender_id`) - start with spender after `prev_spender_id`.
+ */
+export type GetAllowancesArgs = { prev_spender_id: string | null; from_account_id: string; take: bigint | null };
+/**
+ * The arguments for the `get_allowances` endpoint.
+ * The `prev_spender_id` argument can be used for pagination. If specified
+ * the endpoint returns allowances that are lexicographically greater than
+ * (`from_account_id`, `prev_spender_id`) - start with spender after `prev_spender_id`.
+ */
+const $GetAllowancesArgs: $.Schema<GetAllowancesArgs> = $.c.rec(() => $.c.record({ prev_spender_id: $.c.opt($.c.text), from_account_id: $.c.text, take: $.c.opt($.c.nat64) }));
+export { $GetAllowancesArgs as GetAllowancesArgs };
+
+export type GetBlocksArgs = {
+  /** The index of the first block to fetch. */
+  start: bigint;
+  /** Max number of blocks to fetch. */
+  length: bigint;
+};
+const $GetBlocksArgs: $.Schema<GetBlocksArgs> = $.c.rec(() => $.c.record({ start: $.c.nat64, length: $.c.nat64 }));
+export { $GetBlocksArgs as GetBlocksArgs };
+
+export type Icrc1BlockIndex = bigint;
+const $Icrc1BlockIndex: $.Schema<Icrc1BlockIndex> = $.c.rec(() => $.c.nat);
+export { $Icrc1BlockIndex as Icrc1BlockIndex };
+
+/** Number of nanoseconds since the UNIX epoch in UTC timezone. */
+export type Icrc1Timestamp = bigint;
+/** Number of nanoseconds since the UNIX epoch in UTC timezone. */
+const $Icrc1Timestamp: $.Schema<Icrc1Timestamp> = $.c.rec(() => $.c.nat64);
+export { $Icrc1Timestamp as Icrc1Timestamp };
+
+export type Icrc1Tokens = bigint;
+const $Icrc1Tokens: $.Schema<Icrc1Tokens> = $.c.rec(() => $.c.nat);
+export { $Icrc1Tokens as Icrc1Tokens };
+
+export type Icrc1TransferError = { tag: "GenericError"; value: { message: string; error_code: bigint } } | { tag: "TemporarilyUnavailable" } | { tag: "BadBurn"; value: { min_burn_amount: bigint } } | { tag: "Duplicate"; value: { duplicate_of: bigint } } | { tag: "BadFee"; value: { expected_fee: bigint } } | { tag: "CreatedInFuture"; value: { ledger_time: bigint } } | { tag: "TooOld" } | { tag: "InsufficientFunds"; value: { balance: bigint } };
+const $Icrc1TransferError: $.Schema<Icrc1TransferError> = $.c.rec(() => $.c.variant({ GenericError: $.c.record({ message: $.c.text, error_code: $.c.nat }), TemporarilyUnavailable: $.c.null, BadBurn: $.c.record({ min_burn_amount: $.c.nat }), Duplicate: $.c.record({ duplicate_of: $.c.nat }), BadFee: $.c.record({ expected_fee: $.c.nat }), CreatedInFuture: $.c.record({ ledger_time: $.c.nat64 }), TooOld: $.c.null, InsufficientFunds: $.c.record({ balance: $.c.nat }) }));
+export { $Icrc1TransferError as Icrc1TransferError };
+
+export type Icrc1TransferResult = { tag: "Ok"; value: bigint } | { tag: "Err"; value: Icrc1TransferError };
+const $Icrc1TransferResult: $.Schema<Icrc1TransferResult> = $.c.rec(() => $.c.variant({ Ok: $.c.nat, Err: $Icrc1TransferError }));
+export { $Icrc1TransferResult as Icrc1TransferResult };
+
+export type Icrc21Value = { tag: "Text"; value: { content: string } } | { tag: "TokenAmount"; value: { decimals: number; amount: bigint; symbol: string } } | { tag: "TimestampSeconds"; value: { amount: bigint } } | { tag: "DurationSeconds"; value: { amount: bigint } };
+const $Icrc21Value: $.Schema<Icrc21Value> = $.c.rec(() => $.c.variant({ Text: $.c.record({ content: $.c.text }), TokenAmount: $.c.record({ decimals: $.c.nat8, amount: $.c.nat64, symbol: $.c.text }), TimestampSeconds: $.c.record({ amount: $.c.nat64 }), DurationSeconds: $.c.record({ amount: $.c.nat64 }) }));
+export { $Icrc21Value as Icrc21Value };
+
+export type InitArgs = { send_whitelist: Array<$.Principal>; token_symbol: string | null; transfer_fee: Tokens | null; minting_account: string; transaction_window: Duration | null; max_message_size_bytes: bigint | null; icrc1_minting_account: Account | null; archive_options: ArchiveOptions | null; initial_values: Array<[string, Tokens]>; token_name: string | null; feature_flags: FeatureFlags | null };
+const $InitArgs: $.Schema<InitArgs> = $.c.rec(() => $.c.record({ send_whitelist: $.c.vec($.c.principal), token_symbol: $.c.opt($.c.text), transfer_fee: $.c.opt($Tokens), minting_account: $.c.text, transaction_window: $.c.opt($Duration), max_message_size_bytes: $.c.opt($.c.nat64), icrc1_minting_account: $.c.opt($Account), archive_options: $.c.opt($ArchiveOptions), initial_values: $.c.vec($.c.tuple([$.c.text, $Tokens])), token_name: $.c.opt($.c.text), feature_flags: $.c.opt($FeatureFlags) }));
+export { $InitArgs as InitArgs };
+
+export type LedgerCanisterPayload = { tag: "Upgrade"; value: UpgradeArgs | null } | { tag: "Init"; value: InitArgs };
+const $LedgerCanisterPayload: $.Schema<LedgerCanisterPayload> = $.c.rec(() => $.c.variant({ Upgrade: $.c.opt($UpgradeArgs), Init: $InitArgs }));
+export { $LedgerCanisterPayload as LedgerCanisterPayload };
+
+/**
+ * An arbitrary number associated with a transaction.
+ * The caller can set it in a `transfer` call as a correlation identifier.
+ */
+export type Memo = bigint;
+/**
+ * An arbitrary number associated with a transaction.
+ * The caller can set it in a `transfer` call as a correlation identifier.
+ */
+const $Memo: $.Schema<Memo> = $.c.rec(() => $.c.nat64);
+export { $Memo as Memo };
+
+export type Operation =
+  | {
+      tag: "Approve";
+      value: {
+        fee: Tokens;
+        from: Uint8Array;
+        /** This field is deprecated and should not be used. */
+        allowance_e8s: bigint;
+        allowance: Tokens;
+        expected_allowance: Tokens | null;
+        expires_at: TimeStamp | null;
+        spender: Uint8Array;
+      };
+    }
+  | { tag: "Burn"; value: { from: Uint8Array; amount: Tokens; spender: Uint8Array | null } }
+  | { tag: "Mint"; value: { to: Uint8Array; amount: Tokens } }
+  | { tag: "Transfer"; value: { to: Uint8Array; fee: Tokens; from: Uint8Array; amount: Tokens; spender: Uint8Array | null } };
+const $Operation: $.Schema<Operation> = $.c.rec(() => $.c.variant({ Approve: $.c.record({ fee: $Tokens, from: $.c.blob(), allowance_e8s: $.c.int, allowance: $Tokens, expected_allowance: $.c.opt($Tokens), expires_at: $.c.opt($TimeStamp), spender: $.c.blob() }), Burn: $.c.record({ from: $.c.blob(), amount: $Tokens, spender: $.c.opt($.c.blob()) }), Mint: $.c.record({ to: $.c.blob(), amount: $Tokens }), Transfer: $.c.record({ to: $.c.blob(), fee: $Tokens, from: $.c.blob(), amount: $Tokens, spender: $.c.opt($.c.blob()) }) }));
+export { $Operation as Operation };
+
+/** An error indicating that the arguments passed to [QueryArchiveFn] were invalid. */
+export type QueryArchiveError =
+  | {
+      /**
+       * [GetBlocksArgs.from] argument was smaller than the first block
+       * served by the canister that received the request.
+       */
+      tag: "BadFirstBlockIndex";
+      value: { requested_index: bigint; first_valid_index: bigint };
+    }
+  | {
+      /** Reserved for future use. */
+      tag: "Other";
+      value: { error_message: string; error_code: bigint };
+    };
+/** An error indicating that the arguments passed to [QueryArchiveFn] were invalid. */
+const $QueryArchiveError: $.Schema<QueryArchiveError> = $.c.rec(() => $.c.variant({ BadFirstBlockIndex: $.c.record({ requested_index: $.c.nat64, first_valid_index: $.c.nat64 }), Other: $.c.record({ error_message: $.c.text, error_code: $.c.nat64 }) }));
+export { $QueryArchiveError as QueryArchiveError };
+
+/** A function that is used for fetching archived ledger blocks. */
+export type QueryArchiveFn = { principal: $.Principal; method: string };
+/** A function that is used for fetching archived ledger blocks. */
+const $QueryArchiveFn: $.Schema<QueryArchiveFn> = $.c.rec(() => $.c.func([$GetBlocksArgs], [$QueryArchiveResult], "query"));
+export { $QueryArchiveFn as QueryArchiveFn };
+
+export type QueryArchiveResult =
+  | {
+      /** Successfully fetched zero or more blocks. */
+      tag: "Ok";
+      value: BlockRange;
+    }
+  | {
+      /** The [GetBlocksArgs] request was invalid. */
+      tag: "Err";
+      value: QueryArchiveError;
+    };
+const $QueryArchiveResult: $.Schema<QueryArchiveResult> = $.c.rec(() => $.c.variant({ Ok: $BlockRange, Err: $QueryArchiveError }));
+export { $QueryArchiveResult as QueryArchiveResult };
+
+/**
+ * The result of a "query_blocks" call.
+ *
+ * The structure of the result is somewhat complicated because the main ledger canister might
+ * not have all the blocks that the caller requested: One or more "archive" canisters might
+ * store some of the requested blocks.
+ *
+ * Note: as of Q4 2021 when this interface is authored, the IC doesn't support making nested
+ * query calls within a query call.
+ */
+export type QueryBlocksResponse = {
+  /**
+   * System certificate for the hash of the latest block in the chain.
+   * Only present if `query_blocks` is called in a non-replicated query context.
+   */
+  certificate: Uint8Array | null;
+  /**
+   * List of blocks that were available in the ledger when it processed the call.
+   *
+   * The blocks form a contiguous range, with the first block having index
+   * [first_block_index] (see below), and the last block having index
+   * [first_block_index] + len(blocks) - 1.
+   *
+   * The block range can be an arbitrary sub-range of the originally requested range.
+   */
+  blocks: Array<Block>;
+  /**
+   * The total number of blocks in the chain.
+   * If the chain length is positive, the index of the last block is `chain_len - 1`.
+   */
+  chain_length: bigint;
+  /**
+   * The index of the first block in "blocks".
+   * If the blocks vector is empty, the exact value of this field is not specified.
+   */
+  first_block_index: bigint;
+  /**
+   * Encoding of instructions for fetching archived blocks whose indices fall into the
+   * requested range.
+   *
+   * For each entry `e` in [archived_blocks], `[e.from, e.from + len)` is a sub-range
+   * of the originally requested block range.
+   */
+  archived_blocks: Array<ArchivedBlocksRange>;
+};
+/**
+ * The result of a "query_blocks" call.
+ *
+ * The structure of the result is somewhat complicated because the main ledger canister might
+ * not have all the blocks that the caller requested: One or more "archive" canisters might
+ * store some of the requested blocks.
+ *
+ * Note: as of Q4 2021 when this interface is authored, the IC doesn't support making nested
+ * query calls within a query call.
+ */
+const $QueryBlocksResponse: $.Schema<QueryBlocksResponse> = $.c.rec(() => $.c.record({ certificate: $.c.opt($.c.blob()), blocks: $.c.vec($Block), chain_length: $.c.nat64, first_block_index: $.c.nat64, archived_blocks: $.c.vec($ArchivedBlocksRange) }));
+export { $QueryBlocksResponse as QueryBlocksResponse };
+
+export type QueryEncodedBlocksResponse = { certificate: Uint8Array | null; blocks: Array<Uint8Array>; chain_length: bigint; first_block_index: bigint; archived_blocks: Array<ArchivedEncodedBlocksRange> };
+const $QueryEncodedBlocksResponse: $.Schema<QueryEncodedBlocksResponse> = $.c.rec(() => $.c.record({ certificate: $.c.opt($.c.blob()), blocks: $.c.vec($.c.blob()), chain_length: $.c.nat64, first_block_index: $.c.nat64, archived_blocks: $.c.vec($ArchivedEncodedBlocksRange) }));
+export { $QueryEncodedBlocksResponse as QueryEncodedBlocksResponse };
+
+export type RemoveApprovalArgs = { fee: bigint | null; from_subaccount: Uint8Array | null; spender: Uint8Array };
+const $RemoveApprovalArgs: $.Schema<RemoveApprovalArgs> = $.c.rec(() => $.c.record({ fee: $.c.opt($.c.nat), from_subaccount: $.c.opt($.c.blob()), spender: $.c.blob() }));
+export { $RemoveApprovalArgs as RemoveApprovalArgs };
+
+/** Arguments for the `send_dfx` call. */
+export type SendArgs = { to: string; fee: Tokens; memo: bigint; from_subaccount: Uint8Array | null; created_at_time: TimeStamp | null; amount: Tokens };
+/** Arguments for the `send_dfx` call. */
+const $SendArgs: $.Schema<SendArgs> = $.c.rec(() => $.c.record({ to: $.c.text, fee: $Tokens, memo: $.c.nat64, from_subaccount: $.c.opt($.c.blob()), created_at_time: $.c.opt($TimeStamp), amount: $Tokens }));
+export { $SendArgs as SendArgs };
+
+/**
+ * Subaccount is an arbitrary 32-byte byte array.
+ * Ledger uses subaccounts to compute the source address, which enables one
+ * principal to control multiple ledger accounts.
+ */
+export type SubAccount = Uint8Array;
+/**
+ * Subaccount is an arbitrary 32-byte byte array.
+ * Ledger uses subaccounts to compute the source address, which enables one
+ * principal to control multiple ledger accounts.
+ */
+const $SubAccount: $.Schema<SubAccount> = $.c.rec(() => $.c.blob());
+export { $SubAccount as SubAccount };
+
+/** Account identifier encoded as a 64-byte ASCII hex string. */
+export type TextAccountIdentifier = string;
+/** Account identifier encoded as a 64-byte ASCII hex string. */
+const $TextAccountIdentifier: $.Schema<TextAccountIdentifier> = $.c.rec(() => $.c.text);
+export { $TextAccountIdentifier as TextAccountIdentifier };
+
+/** Number of nanoseconds from the UNIX epoch in UTC timezone. */
+export type TimeStamp = { timestamp_nanos: bigint };
+/** Number of nanoseconds from the UNIX epoch in UTC timezone. */
+const $TimeStamp: $.Schema<TimeStamp> = $.c.rec(() => $.c.record({ timestamp_nanos: $.c.nat64 }));
+export { $TimeStamp as TimeStamp };
+
+export type TipOfChainRes = { certification: Uint8Array | null; tip_index: bigint };
+const $TipOfChainRes: $.Schema<TipOfChainRes> = $.c.rec(() => $.c.record({ certification: $.c.opt($.c.blob()), tip_index: $.c.nat64 }));
+export { $TipOfChainRes as TipOfChainRes };
+
+/** Amount of tokens, measured in 10^-8 of a token. */
+export type Tokens = { e8s: bigint };
+/** Amount of tokens, measured in 10^-8 of a token. */
+const $Tokens: $.Schema<Tokens> = $.c.rec(() => $.c.record({ e8s: $.c.nat64 }));
+export { $Tokens as Tokens };
+
+export type Transaction = { memo: bigint; icrc1_memo: Uint8Array | null; operation: Operation | null; created_at_time: TimeStamp };
+const $Transaction: $.Schema<Transaction> = $.c.rec(() => $.c.record({ memo: $.c.nat64, icrc1_memo: $.c.opt($.c.blob()), operation: $.c.opt($Operation), created_at_time: $TimeStamp }));
+export { $Transaction as Transaction };
+
+export type TransferArg = { to: Account; fee: bigint | null; memo: Uint8Array | null; from_subaccount: Uint8Array | null; created_at_time: bigint | null; amount: bigint };
+const $TransferArg: $.Schema<TransferArg> = $.c.rec(() => $.c.record({ to: $Account, fee: $.c.opt($.c.nat), memo: $.c.opt($.c.blob()), from_subaccount: $.c.opt($.c.blob()), created_at_time: $.c.opt($.c.nat64), amount: $.c.nat }));
+export { $TransferArg as TransferArg };
+
+/** Arguments for the `transfer` call. */
+export type TransferArgs = {
+  /**
+   * The destination account.
+   * If the transfer is successful, the balance of this address increases by `amount`.
+   */
+  to: Uint8Array;
+  /**
+   * The amount that the caller pays for the transaction.
+   * Must be 10000 e8s.
+   */
+  fee: Tokens;
+  /**
+   * Transaction memo.
+   * See comments for the `Memo` type.
+   */
+  memo: bigint;
+  /**
+   * The subaccount from which the caller wants to transfer funds.
+   * If null, the ledger uses the default (all zeros) subaccount to compute the source address.
+   * See comments for the `SubAccount` type.
+   */
+  from_subaccount: Uint8Array | null;
+  /**
+   * The point in time when the caller created this request.
+   * If null, the ledger uses current IC time as the timestamp.
+   */
+  created_at_time: TimeStamp | null;
+  /** The amount that the caller wants to transfer to the destination address. */
+  amount: Tokens;
+};
+/** Arguments for the `transfer` call. */
+const $TransferArgs: $.Schema<TransferArgs> = $.c.rec(() => $.c.record({ to: $.c.blob(), fee: $Tokens, memo: $.c.nat64, from_subaccount: $.c.opt($.c.blob()), created_at_time: $.c.opt($TimeStamp), amount: $Tokens }));
+export { $TransferArgs as TransferArgs };
+
+export type TransferError =
+  | {
+      /**
+       * The request is too old.
+       * The ledger only accepts requests created within 24 hours window.
+       * This is a non-recoverable error.
+       */
+      tag: "TxTooOld";
+      value: { allowed_window_nanos: bigint };
+    }
+  | {
+      /**
+       * The fee that the caller specified in the transfer request was not the one that ledger expects.
+       * The caller can change the transfer fee to the `expected_fee` and retry the request.
+       */
+      tag: "BadFee";
+      value: { expected_fee: Tokens };
+    }
+  | {
+      /**
+       * The ledger has already executed the request.
+       * `duplicate_of` field is equal to the index of the block containing the original transaction.
+       */
+      tag: "TxDuplicate";
+      value: { duplicate_of: bigint };
+    }
+  | {
+      /**
+       * The caller specified `created_at_time` that is too far in future.
+       * The caller can retry the request later.
+       */
+      tag: "TxCreatedInFuture";
+    }
+  | {
+      /** The account specified by the caller doesn't have enough funds. */
+      tag: "InsufficientFunds";
+      value: { balance: Tokens };
+    };
+const $TransferError: $.Schema<TransferError> = $.c.rec(() => $.c.variant({ TxTooOld: $.c.record({ allowed_window_nanos: $.c.nat64 }), BadFee: $.c.record({ expected_fee: $Tokens }), TxDuplicate: $.c.record({ duplicate_of: $.c.nat64 }), TxCreatedInFuture: $.c.null, InsufficientFunds: $.c.record({ balance: $Tokens }) }));
+export { $TransferError as TransferError };
+
+export type TransferFee = {
+  /** The fee to pay to perform a transfer */
+  transfer_fee: Tokens;
+};
+const $TransferFee: $.Schema<TransferFee> = $.c.rec(() => $.c.record({ transfer_fee: $Tokens }));
+export { $TransferFee as TransferFee };
+
+export type TransferFeeArg = Record<string, never>;
+const $TransferFeeArg: $.Schema<TransferFeeArg> = $.c.rec(() => $.c.unit());
+export { $TransferFeeArg as TransferFeeArg };
+
+export type TransferFromArgs = { to: Account; fee: bigint | null; spender_subaccount: Uint8Array | null; from: Account; memo: Uint8Array | null; created_at_time: bigint | null; amount: bigint };
+const $TransferFromArgs: $.Schema<TransferFromArgs> = $.c.rec(() => $.c.record({ to: $Account, fee: $.c.opt($.c.nat), spender_subaccount: $.c.opt($.c.blob()), from: $Account, memo: $.c.opt($.c.blob()), created_at_time: $.c.opt($.c.nat64), amount: $.c.nat }));
+export { $TransferFromArgs as TransferFromArgs };
+
+export type TransferFromError = { tag: "GenericError"; value: { message: string; error_code: bigint } } | { tag: "TemporarilyUnavailable" } | { tag: "InsufficientAllowance"; value: { allowance: bigint } } | { tag: "BadBurn"; value: { min_burn_amount: bigint } } | { tag: "Duplicate"; value: { duplicate_of: bigint } } | { tag: "BadFee"; value: { expected_fee: bigint } } | { tag: "CreatedInFuture"; value: { ledger_time: bigint } } | { tag: "TooOld" } | { tag: "InsufficientFunds"; value: { balance: bigint } };
+const $TransferFromError: $.Schema<TransferFromError> = $.c.rec(() => $.c.variant({ GenericError: $.c.record({ message: $.c.text, error_code: $.c.nat }), TemporarilyUnavailable: $.c.null, InsufficientAllowance: $.c.record({ allowance: $.c.nat }), BadBurn: $.c.record({ min_burn_amount: $.c.nat }), Duplicate: $.c.record({ duplicate_of: $.c.nat }), BadFee: $.c.record({ expected_fee: $.c.nat }), CreatedInFuture: $.c.record({ ledger_time: $.c.nat64 }), TooOld: $.c.null, InsufficientFunds: $.c.record({ balance: $.c.nat }) }));
+export { $TransferFromError as TransferFromError };
+
+export type TransferFromResult = { tag: "Ok"; value: bigint } | { tag: "Err"; value: TransferFromError };
+const $TransferFromResult: $.Schema<TransferFromResult> = $.c.rec(() => $.c.variant({ Ok: $.c.nat, Err: $TransferFromError }));
+export { $TransferFromResult as TransferFromResult };
+
+export type TransferResult = { tag: "Ok"; value: bigint } | { tag: "Err"; value: TransferError };
+const $TransferResult: $.Schema<TransferResult> = $.c.rec(() => $.c.variant({ Ok: $.c.nat64, Err: $TransferError }));
+export { $TransferResult as TransferResult };
+
+export type UpgradeArgs = { icrc1_minting_account: Account | null; feature_flags: FeatureFlags | null };
+const $UpgradeArgs: $.Schema<UpgradeArgs> = $.c.rec(() => $.c.record({ icrc1_minting_account: $.c.opt($Account), feature_flags: $.c.opt($FeatureFlags) }));
+export { $UpgradeArgs as UpgradeArgs };
+
+/** The value returned from the [icrc1_metadata] endpoint. */
+export type Value = { tag: "Int"; value: bigint } | { tag: "Nat"; value: bigint } | { tag: "Blob"; value: Uint8Array } | { tag: "Text"; value: string };
+/** The value returned from the [icrc1_metadata] endpoint. */
+const $Value: $.Schema<Value> = $.c.rec(() => $.c.variant({ Int: $.c.int, Nat: $.c.nat, Blob: $.c.blob(), Text: $.c.text }));
+export { $Value as Value };
+
+export type icrc21_consent_info = { metadata: icrc21_consent_message_metadata; consent_message: icrc21_consent_message };
+const $icrc21_consent_info: $.Schema<icrc21_consent_info> = $.c.rec(() => $.c.record({ metadata: $icrc21_consent_message_metadata, consent_message: $icrc21_consent_message }));
+export { $icrc21_consent_info as icrc21_consent_info };
+
+export type icrc21_consent_message = { tag: "FieldsDisplayMessage"; value: FieldsDisplay } | { tag: "GenericDisplayMessage"; value: string };
+const $icrc21_consent_message: $.Schema<icrc21_consent_message> = $.c.rec(() => $.c.variant({ FieldsDisplayMessage: $FieldsDisplay, GenericDisplayMessage: $.c.text }));
+export { $icrc21_consent_message as icrc21_consent_message };
+
+export type icrc21_consent_message_metadata = { utc_offset_minutes: number | null; language: string };
+const $icrc21_consent_message_metadata: $.Schema<icrc21_consent_message_metadata> = $.c.rec(() => $.c.record({ utc_offset_minutes: $.c.opt($.c.int16), language: $.c.text }));
+export { $icrc21_consent_message_metadata as icrc21_consent_message_metadata };
+
+export type icrc21_consent_message_request = { arg: Uint8Array; method: string; user_preferences: icrc21_consent_message_spec };
+const $icrc21_consent_message_request: $.Schema<icrc21_consent_message_request> = $.c.rec(() => $.c.record({ arg: $.c.blob(), method: $.c.text, user_preferences: $icrc21_consent_message_spec }));
+export { $icrc21_consent_message_request as icrc21_consent_message_request };
+
+export type icrc21_consent_message_response = { tag: "Ok"; value: icrc21_consent_info } | { tag: "Err"; value: icrc21_error };
+const $icrc21_consent_message_response: $.Schema<icrc21_consent_message_response> = $.c.rec(() => $.c.variant({ Ok: $icrc21_consent_info, Err: $icrc21_error }));
+export { $icrc21_consent_message_response as icrc21_consent_message_response };
+
+export type icrc21_consent_message_spec = { metadata: icrc21_consent_message_metadata; device_spec: { tag: "GenericDisplay" } | { tag: "FieldsDisplay" } | null };
+const $icrc21_consent_message_spec: $.Schema<icrc21_consent_message_spec> = $.c.rec(() => $.c.record({ metadata: $icrc21_consent_message_metadata, device_spec: $.c.opt($.c.variant({ GenericDisplay: $.c.null, FieldsDisplay: $.c.null })) }));
+export { $icrc21_consent_message_spec as icrc21_consent_message_spec };
+
+export type icrc21_error =
+  | {
+      /** Any error not covered by the above variants. */
+      tag: "GenericError";
+      value: { description: string; error_code: bigint };
+    }
+  | { tag: "InsufficientPayment"; value: icrc21_error_info }
+  | { tag: "UnsupportedCanisterCall"; value: icrc21_error_info }
+  | { tag: "ConsentMessageUnavailable"; value: icrc21_error_info };
+const $icrc21_error: $.Schema<icrc21_error> = $.c.rec(() => $.c.variant({ GenericError: $.c.record({ description: $.c.text, error_code: $.c.nat }), InsufficientPayment: $icrc21_error_info, UnsupportedCanisterCall: $icrc21_error_info, ConsentMessageUnavailable: $icrc21_error_info }));
+export { $icrc21_error as icrc21_error };
+
+export type icrc21_error_info = { description: string };
+const $icrc21_error_info: $.Schema<icrc21_error_info> = $.c.rec(() => $.c.record({ description: $.c.text }));
+export { $icrc21_error_info as icrc21_error_info };
+
+const $actor: $.Schema<$.Principal> = $.c.rec(() => $.c.service({ icrc1_balance_of: $.c.func([$Account], [$.c.nat], "query"), decimals: $.c.func([], [$.c.record({ decimals: $.c.nat32 })], "query"), icrc1_decimals: $.c.func([], [$.c.nat8], "query"), icrc2_allowance: $.c.func([$AllowanceArgs], [$Allowance], "query"), get_allowances: $.c.func([$GetAllowancesArgs], [$Allowances], "query"), icrc1_fee: $.c.func([], [$.c.nat], "query"), icrc1_supported_standards: $.c.func([], [$.c.vec($.c.record({ url: $.c.text, name: $.c.text }))], "query"), transfer_fee: $.c.func([$.c.unit()], [$TransferFee], "query"), icrc1_metadata: $.c.func([], [$.c.vec($.c.tuple([$.c.text, $Value]))], "query"), name: $.c.func([], [$.c.record({ name: $.c.text })], "query"), icrc1_symbol: $.c.func([], [$.c.text], "query"), query_encoded_blocks: $.c.func([$GetBlocksArgs], [$QueryEncodedBlocksResponse], "query"), remove_approval: $.c.func([$RemoveApprovalArgs], [$ApproveResult], "update"), account_balance_dfx: $.c.func([$AccountBalanceArgsDfx], [$Tokens], "query"), icrc2_approve: $.c.func([$ApproveArgs], [$ApproveResult], "update"), icrc1_minting_account: $.c.func([], [$.c.opt($Account)], "query"), icrc1_name: $.c.func([], [$.c.text], "query"), icrc1_total_supply: $.c.func([], [$.c.nat], "query"), account_identifier: $.c.func([$Account], [$.c.blob()], "query"), tip_of_chain: $.c.func([], [$TipOfChainRes], "query"), account_balance: $.c.func([$AccountBalanceArgs], [$Tokens], "query"), icrc2_transfer_from: $.c.func([$TransferFromArgs], [$TransferFromResult], "update"), icrc10_supported_standards: $.c.func([], [$.c.vec($.c.record({ url: $.c.text, name: $.c.text }))], "query"), query_blocks: $.c.func([$GetBlocksArgs], [$QueryBlocksResponse], "query"), transfer: $.c.func([$TransferArgs], [$TransferResult], "update"), icrc1_transfer: $.c.func([$TransferArg], [$Icrc1TransferResult], "update"), icrc21_canister_call_consent_message: $.c.func([$icrc21_consent_message_request], [$icrc21_consent_message_response], "update"), send_dfx: $.c.func([$SendArgs], [$.c.nat64], "update"), archives: $.c.func([], [$Archives], "query"), symbol: $.c.func([], [$.c.record({ symbol: $.c.text })], "query"), is_ledger_ready: $.c.func([], [$.c.bool], "query") }));
+export type Actor = {
+  icrc1_balance_of: ((arg0: Account) => Promise<bigint>) & $.WithMode<"query">;
+  /** Returns token decimals. */
+  decimals: (() => Promise<{ decimals: number }>) & $.WithMode<"query">;
+  icrc1_decimals: (() => Promise<number>) & $.WithMode<"query">;
+  icrc2_allowance: ((arg0: AllowanceArgs) => Promise<Allowance>) & $.WithMode<"query">;
+  get_allowances: ((arg0: GetAllowancesArgs) => Promise<Allowances>) & $.WithMode<"query">;
+  icrc1_fee: (() => Promise<bigint>) & $.WithMode<"query">;
+  icrc1_supported_standards: (() => Promise<Array<{ url: string; name: string }>>) & $.WithMode<"query">;
+  /** Returns the current transfer_fee. */
+  transfer_fee: ((arg0: Record<string, never>) => Promise<TransferFee>) & $.WithMode<"query">;
+  icrc1_metadata: (() => Promise<Array<[string, Value]>>) & $.WithMode<"query">;
+  /** Returns token name. */
+  name: (() => Promise<{ name: string }>) & $.WithMode<"query">;
+  icrc1_symbol: (() => Promise<string>) & $.WithMode<"query">;
+  /** Queries encoded blocks in the specified range */
+  query_encoded_blocks: ((arg0: GetBlocksArgs) => Promise<QueryEncodedBlocksResponse>) & $.WithMode<"query">;
+  remove_approval: ((arg0: RemoveApprovalArgs) => Promise<ApproveResult>) & $.WithMode<"update">;
+  account_balance_dfx: ((arg0: AccountBalanceArgsDfx) => Promise<Tokens>) & $.WithMode<"query">;
+  icrc2_approve: ((arg0: ApproveArgs) => Promise<ApproveResult>) & $.WithMode<"update">;
+  icrc1_minting_account: (() => Promise<Account | null>) & $.WithMode<"query">;
+  /**
+   * The following methods implement the ICRC-1 Token Standard.
+   * https://github.com/dfinity/ICRC-1/tree/main/standards/ICRC-1
+   */
+  icrc1_name: (() => Promise<string>) & $.WithMode<"query">;
+  icrc1_total_supply: (() => Promise<bigint>) & $.WithMode<"query">;
+  /** Returns the account identifier for the given Principal and subaccount. */
+  account_identifier: ((arg0: Account) => Promise<Uint8Array>) & $.WithMode<"query">;
+  tip_of_chain: (() => Promise<TipOfChainRes>) & $.WithMode<"query">;
+  /** Returns the amount of Tokens on the specified account. */
+  account_balance: ((arg0: AccountBalanceArgs) => Promise<Tokens>) & $.WithMode<"query">;
+  icrc2_transfer_from: ((arg0: TransferFromArgs) => Promise<TransferFromResult>) & $.WithMode<"update">;
+  icrc10_supported_standards: (() => Promise<Array<{ url: string; name: string }>>) & $.WithMode<"query">;
+  /** Queries blocks in the specified range. */
+  query_blocks: ((arg0: GetBlocksArgs) => Promise<QueryBlocksResponse>) & $.WithMode<"query">;
+  /**
+   * Transfers tokens from a subaccount of the caller to the destination address.
+   * The source address is computed from the principal of the caller and the specified subaccount.
+   * When successful, returns the index of the block containing the transaction.
+   */
+  transfer: ((arg0: TransferArgs) => Promise<TransferResult>) & $.WithMode<"update">;
+  icrc1_transfer: ((arg0: TransferArg) => Promise<Icrc1TransferResult>) & $.WithMode<"update">;
+  icrc21_canister_call_consent_message: ((arg0: icrc21_consent_message_request) => Promise<icrc21_consent_message_response>) & $.WithMode<"update">;
+  send_dfx: ((arg0: SendArgs) => Promise<bigint>) & $.WithMode<"update">;
+  /** Returns the existing archive canisters information. */
+  archives: (() => Promise<Archives>) & $.WithMode<"query">;
+  /** Returns token symbol. */
+  symbol: (() => Promise<{ symbol: string }>) & $.WithMode<"query">;
+  is_ledger_ready: (() => Promise<boolean>) & $.WithMode<"query">;
+};
+export { $actor as actor };
+// Note: the actor is a service class; init args are install-time metadata not exposed here (issue #104).