Skip to content

CkEthMinterDid

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:959

add_ckerc20_token: ActorMethod<[AddCkErc20Token], undefined>

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:964

Add a ckERC-20 token to be supported by the minter. This call is restricted to the orchestrator ID.

decode_ledger_memo: ActorMethod<[DecodeLedgerMemoArgs], DecodeLedgerMemoResult>

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:968

Decode ledger memos produced by the minter when minting (deposits) or burning (withdrawals).

eip_1559_transaction_price: ActorMethod<[[] | [Eip1559TransactionPriceArg]], Eip1559TransactionPrice>

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:975

Estimate the price of a transaction issued by the minter when converting ckETH to ETH.

get_canister_status: ActorMethod<[], CanisterStatusResponse>

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:982

Retrieve the status of the minter canister.

get_events: ActorMethod<[{ length: bigint; start: bigint; }], { events: Event[]; total_event_count: bigint; }>

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:988

Retrieve events from the minter’s audit log. The endpoint can return fewer events than requested to bound the response size. IMPORTANT: this endpoint is meant as a debugging tool and is not guaranteed to be backwards-compatible.

get_minter_info: ActorMethod<[], MinterInfo>

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:995

Returns internal minter parameters

is_address_blocked: ActorMethod<[string], boolean>

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:999

Check if an address is blocked by the minter.

minter_address: ActorMethod<[], string>

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:1007

Retrieve the Ethereum address controlled by the minter:

  • Deposits will be transferred from the helper smart contract to this address
  • Withdrawals will originate from this address IMPORTANT: Do NOT send ETH to this address directly. Use the helper smart contract instead so that the minter knows to which IC principal the funds should be deposited.

retrieve_eth_status: ActorMethod<[bigint], RetrieveEthStatus>

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:1011

Retrieve the status of a Eth withdrawal request.

smart_contract_address: ActorMethod<[], string>

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:1020

Address of the helper smart contract. Returns “N/A” if the helper smart contract is not set. IMPORTANT:

  • Use this address to send ETH to the minter to convert it to ckETH.
  • In case the smart contract needs to be updated the returned address will change! Always check the address before making a transfer.

withdraw_erc20: ActorMethod<[WithdrawErc20Arg], { Ok: RetrieveErc20Request; } | { Err: WithdrawErc20Error; }>

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:1024

Withdraw the specified amount of ERC-20 tokens to the given Ethereum address.

withdraw_eth: ActorMethod<[WithdrawalArg], { Ok: RetrieveEthRequest; } | { Err: WithdrawalError; }>

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:1032

Withdraw the specified amount in Wei to the given Ethereum address. IMPORTANT: The current gas limit is set to 21,000 for a transaction so withdrawals to smart contract addresses will likely fail.

withdrawal_status: ActorMethod<[WithdrawalSearchParameter], WithdrawalDetail[]>

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:1039

Return details of all withdrawals matching the given search parameter.


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:16

ICRC-1 account type.

owner: Principal

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:17

subaccount: [] | [Uint8Array<ArrayBufferLike>]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:18


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:20

address: string

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:32

The Ethereum address of the ERC-20 smart contract.

chain_id: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:28

Ethereum chain ID.

ckerc20_ledger_id: Principal

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:24

The ledger ID for that ckERC20 token.

ckerc20_token_symbol: string

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:36

The ckERC20 token symbol on the ledger.


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:104

cycles: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:107

idle_cycles_burned_per_day: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:110

memory_size: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:106

module_hash: [] | [Uint8Array<ArrayBufferLike>]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:111

query_stats: QueryStats

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:109

reserved_cycles: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:112

settings: DefiniteCanisterSettings

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:108

status: CanisterStatusType

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:105


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:118

ckerc20_token_symbol: string

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:121

erc20_contract_address: string

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:119

ledger_canister_id: Principal

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:120


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:123

encoded_memo: Uint8Array

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:131

The encoded memo from a minter transaction on the ledger

memo_type: MemoType

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:127

The encoded memo type


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:167

compute_allocation: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:174

controllers: Principal[]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:169

freezing_threshold: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:168

log_visibility: LogVisibility

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:171

memory_allocation: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:173

reserved_cycles_limit: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:170

wasm_memory_limit: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:172


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:181

Estimate price of an EIP-1559 transaction when converting ckETH to ETH or ckERC20 to ERC20, see https://eips.ethereum.org/EIPS/eip-1559

gas_limit: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:205

Maximum amount of gas transaction is authorized to consume.

max_fee_per_gas: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:191

Maximum amount of Wei per gas unit that the transaction is willing to pay in total. This covers the base fee determined by the network and the max_priority_fee_per_gas.

max_priority_fee_per_gas: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:186

Maximum amount of Wei per gas unit that the transaction gives to miners to incentivize them to include their transaction (priority fee).

max_transaction_fee: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:196

Maximum amount of Wei that can be charged for the transaction, computed as max_fee_per_gas * gas_limit

timestamp: [] | [bigint]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:201

Timestamp of when the price was estimated. Nanoseconds since the UNIX epoch.


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:212

Argument to Eip1559TransactionPrice. When specified, it is to lookup transaction price for a ckERC20 token withdrawal. When not specified (null), it is for ETH withdrawal.

ckerc20_ledger_id: Principal

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:216

The ledger ID for that ckERC20 token.


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:218

transaction_hash: string

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:219


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:234

payload: { SkippedBlock: { block_number: bigint; contract_address: [] | [string]; }; } | { AcceptedErc20Deposit: { block_number: bigint; erc20_contract_address: string; from_address: string; log_index: bigint; principal: Principal; subaccount: [] | [Subaccount]; transaction_hash: string; value: bigint; }; } | { SignedTransaction: { raw_transaction: string; withdrawal_id: bigint; }; } | { Upgrade: UpgradeArg; } | { Init: InitArg; } | { AddedCkErc20Token: { address: string; chain_id: bigint; ckerc20_ledger_id: Principal; ckerc20_token_symbol: string; }; } | { SyncedDepositWithSubaccountToBlock: { block_number: bigint; }; } | { QuarantinedDeposit: { event_source: EventSource; }; } | { SyncedToBlock: { block_number: bigint; }; } | { AcceptedDeposit: { block_number: bigint; from_address: string; log_index: bigint; principal: Principal; subaccount: [] | [Subaccount]; transaction_hash: string; value: bigint; }; } | { ReplacedTransaction: { transaction: UnsignedTransaction; withdrawal_id: bigint; }; } | { QuarantinedReimbursement: { index: ReimbursementIndex; }; } | { MintedCkEth: { event_source: EventSource; mint_block_index: bigint; }; } | { ReimbursedEthWithdrawal: { reimbursed_amount: bigint; reimbursed_in_block: bigint; transaction_hash: [] | [string]; withdrawal_id: bigint; }; } | { FailedErc20WithdrawalRequest: { reimbursed_amount: bigint; to: Principal; to_subaccount: [] | [Uint8Array<ArrayBufferLike>]; withdrawal_id: bigint; }; } | { ReimbursedErc20Withdrawal: { burn_in_block: bigint; ledger_id: Principal; reimbursed_amount: bigint; reimbursed_in_block: bigint; transaction_hash: [] | [string]; withdrawal_id: bigint; }; } | { MintedCkErc20: { ckerc20_token_symbol: string; erc20_contract_address: string; event_source: EventSource; mint_block_index: bigint; }; } | { CreatedTransaction: { transaction: UnsignedTransaction; withdrawal_id: bigint; }; } | { InvalidDeposit: { event_source: EventSource; reason: string; }; } | { SyncedErc20ToBlock: { block_number: bigint; }; } | { AcceptedErc20WithdrawalRequest: { ckerc20_ledger_burn_index: bigint; ckerc20_ledger_id: Principal; cketh_ledger_burn_index: bigint; created_at: bigint; destination: string; erc20_contract_address: string; from: Principal; from_subaccount: [] | [Uint8Array<ArrayBufferLike>]; max_transaction_fee: bigint; withdrawal_amount: bigint; }; } | { AcceptedEthWithdrawalRequest: { created_at: [] | [bigint]; destination: string; from: Principal; from_subaccount: [] | [Uint8Array<ArrayBufferLike>]; ledger_burn_index: bigint; withdrawal_amount: bigint; }; } | { FinalizedTransaction: { transaction_receipt: TransactionReceipt; withdrawal_id: bigint; }; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:236

timestamp: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:235


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:371

log_index: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:373

transaction_hash: string

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:372


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:375

max_fee_per_gas: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:385

Maximum amount of Wei per gas unit that the transaction is willing to pay in total. This covers the base fee determined by the network and the max_priority_fee_per_gas.

max_priority_fee_per_gas: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:380

Maximum amount of Wei per gas unit that the transaction gives to miners to incentivize them to include their transaction (priority fee).

timestamp: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:390

Timestamp of when the price was estimated. Nanoseconds since the UNIX epoch.


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:395

The initialization parameters of the minter canister.

ecdsa_key_name: string

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:409

The name of the ECDSA key to use. E.g., “dfx_test_key” on the local replica.

ethereum_block_height: BlockTag

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:437

Determine ethereum block height observed by minter.

ethereum_contract_address: [] | [string]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:429

Address of the helper smart contract.

ethereum_network: EthereumNetwork

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:399

The minter will interact with this Ethereum network.

evm_rpc_id: [] | [Principal]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:419

The principal of the EVM RPC canister that handles the communication with the Ethereum blockchain. If not specified, uses the production or staging EVM RPC canister based on the ethereum_network field.

last_scraped_block_number: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:404

Block number to start scrapping from on the Ethereum network. Scrapping the logs will resume at last_scraped_block_number + 1 (inclusive).

ledger_id: Principal

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:425

The principal of the ledger that handles ckETH transfers. The default account of the ckETH minter must be configured as the minting account of the ledger.

minimum_withdrawal_amount: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:433

Minimum amount in Wei that can be withdrawn.

next_transaction_nonce: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:413

Nonce of the next transaction to be sent to the Ethereum network.


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:530

cketh_ledger_id: [] | [Principal]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:572

Canister ID of the ckETH ledger.

deposit_with_subaccount_helper_contract_address
Section titled “deposit_with_subaccount_helper_contract_address”

deposit_with_subaccount_helper_contract_address: [] | [string]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:534

Address of the ETH or ERC20 deposit with subaccount helper smart contract.

erc20_balances: [] | [object[]]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:590

Amount of ETH in Wei controlled by the minter. This might be less that the actual amount available on the minter_address().

erc20_helper_contract_address: [] | [string]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:556

Address of the ERC20 helper smart contract

eth_balance: [] | [bigint]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:539

Amount of ETH in Wei controlled by the minter. This might be less that the actual amount available on the minter_address().

eth_helper_contract_address: [] | [string]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:543

Address of the ETH helper smart contract.

ethereum_block_height: [] | [BlockTag]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:604

Determine ethereum block height observed by minter.

evm_rpc_id: [] | [Principal]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:552

Canister ID of the EVM RPC canister that handles the communication with the Ethereum blockchain.

last_deposit_with_subaccount_scraped_block_number
Section titled “last_deposit_with_subaccount_scraped_block_number”

last_deposit_with_subaccount_scraped_block_number: [] | [bigint]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:600

Last scraped block number for logs of the deposit with subaccount helper contract.

last_erc20_scraped_block_number: [] | [bigint]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:560

Last scraped block number for logs of the ERC20 helper contract.

last_eth_scraped_block_number: [] | [bigint]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:581

Last scraped block number for logs of the ETH helper contract.

last_gas_fee_estimate: [] | [GasFeeEstimate]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:568

Last gas fee estimate.

last_observed_block_number: [] | [bigint]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:547

Last Ethereum block number observed by the minter.

minimum_withdrawal_amount: [] | [bigint]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:585

Minimum amount in Wei that can be withdrawn when converting ckETH -> ETH.

minter_address: [] | [string]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:596

Ethereum address controlled by the minter via threshold ECDSA.

smart_contract_address: [] | [string]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:577

(Deprecated) Address of the ETH helper smart contract. Use eth_helper_contract_address.

supported_ckerc20_tokens: [] | [CkErc20Token[]]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:564

Information of supported ERC20 tokens.


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:606

num_calls_total: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:609

num_instructions_total: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:608

request_payload_bytes_total: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:610

response_payload_bytes_total: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:607


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:621

ckerc20_block_index: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:625

Burn index on the ledger handling the withdrawn ckERC20 token.

cketh_block_index: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:630

Burn index on the ckETH ledger. ckETH is needed to pay for the transaction fees.


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:632

block_index: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:633


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:671

block_hash: string

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:675

block_number: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:676

effective_gas_price: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:672

gas_used: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:677

status: { Success: null; } | { Failure: null; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:673

transaction_hash: string

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:674


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:708

access_list: object[]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:717

address: string

storage_keys: Uint8Array<ArrayBufferLike>[]

chain_id: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:714

data: Uint8Array

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:712

destination: string

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:709

gas_limit: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:716

max_fee_per_gas: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:713

max_priority_fee_per_gas: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:711

nonce: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:715

value: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:710


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:719

deposit_with_subaccount_helper_contract_address
Section titled “deposit_with_subaccount_helper_contract_address”

deposit_with_subaccount_helper_contract_address: [] | [string]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:723

Change the deposit with subaccount helper smart contract address.

erc20_helper_contract_address: [] | [string]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:741

Change the ERC-20 helper smart contract address.

ethereum_block_height: [] | [BlockTag]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:761

Change the ethereum block height observed by the minter.

ethereum_contract_address: [] | [string]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:749

Change the ETH helper smart contract address.

evm_rpc_id: [] | [Principal]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:732

The principal of the EVM RPC canister that handles the communication with the Ethereum blockchain.

last_deposit_with_subaccount_scraped_block_number
Section titled “last_deposit_with_subaccount_scraped_block_number”

last_deposit_with_subaccount_scraped_block_number: [] | [bigint]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:757

Change the last scraped block number of the deposit with subaccount helper smart contract.

last_erc20_scraped_block_number: [] | [bigint]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:745

Change the last scraped block number of the ERC-20 helper smart contract.

ledger_suite_orchestrator_id: [] | [Principal]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:737

The principal of the ledger suite orchestrator that handles the ICRC1 ledger suites for all ckERC20 tokens.

minimum_withdrawal_amount: [] | [bigint]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:753

Change the minimum amount in Wei that can be withdrawn.

next_transaction_nonce: [] | [bigint]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:727

Change the nonce of the next transaction to be sent to the Ethereum network.


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:824

amount: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:836

The amount of ckETH in Wei that the client wants to withdraw.

from_subaccount: [] | [Subaccount]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:832

The subaccount to burn ckETH from.

recipient: string

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:828

The address to which the minter should deposit ETH.


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:841

Details of a withdrawal request and its status.

from: Principal

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:861

Sender’s principal.

from_subaccount: [] | [Uint8Array<ArrayBufferLike>]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:865

Sender’s subaccount (if given).

max_transaction_fee: [] | [bigint]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:869

Max transaction fee in Wei (transaction fee paid by the sender).

recipient_address: string

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:873

Address to send tokens to.

status: WithdrawalStatus

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:845

Withdrawal status

token_symbol: string

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:849

Symbol of the withdrawal token (either ckETH or ckERC20 token symbol).

withdrawal_amount: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:853

Amount of tokens in base unit that was withdrawn.

withdrawal_id: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:857

Withdrawal id (i.e. burn index on the ckETH ledger).


Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:763

amount: bigint

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:785

Amount of tokens to withdraw. The amount is in the smallest unit of the token, e.g., ckUSDC uses 6 decimals and so to withdraw 1 ckUSDC, the amount should be 1_000_000.

ckerc20_ledger_id: Principal

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:767

The ledger ID for that ckERC20 token.

from_ckerc20_subaccount: [] | [Subaccount]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:779

The subaccount to burn ckERC20 from.

from_cketh_subaccount: [] | [Subaccount]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:775

The subaccount to burn ckETH from to pay for the transaction fee.

recipient: string

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:771

Ethereum address to withdraw to.

BlockTag = { Safe: null; } | { Finalized: null; } | { Latest: null; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:38

{ Safe: null; }

Safe: null

/ The latest safe head block.

{ Finalized: null; }

Finalized: null

/ The latest finalized block.

{ Latest: null; }

Latest: null

/ The latest mined block.


BurnMemo = { Erc20Convert: { ckerc20_withdrawal_id: bigint; to_address: string; }; } | { Erc20GasFee: { ckerc20_token_symbol: string; ckerc20_withdrawal_amount: bigint; to_address: string; }; } | { Convert: { to_address: string; }; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:57

{ Erc20Convert: { ckerc20_withdrawal_id: bigint; to_address: string; }; }

Erc20Convert: object

The minter processed a ckERC20 withdrawal request.

ckerc20_withdrawal_id: bigint

ckETH ledger burn index identifying the burn to pay for the transaction fee.

to_address: string

The destination of the withdrawal request.

{ Erc20GasFee: { ckerc20_token_symbol: string; ckerc20_withdrawal_amount: bigint; to_address: string; }; }

Erc20GasFee: object

The minter processed a ckERC20 withdrawal request and that burn pays the transaction fee.

ckerc20_token_symbol: string

ckERC20 token symbol of the withdrawal request.

ckerc20_withdrawal_amount: bigint

The amount of the ckERC20 withdrawal request.

to_address: string

The destination of the withdrawal request.

{ Convert: { to_address: string; }; }

Convert: object

The minter processed a withdrawal request.

to_address: string

The destination of the withdrawal request.


CanisterStatusType = { stopped: null; } | { stopping: null; } | { running: null; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:114


DecodedMemo = { Burn: [] | [BurnMemo]; } | { Mint: [] | [MintMemo]; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:154

{ Burn: [] | [BurnMemo]; }

Burn: [] | [BurnMemo]

The decoded BurnMemo - opt since other variants of BurnMemo could be added in the future.

{ Mint: [] | [MintMemo]; }

Mint: [] | [MintMemo]

The decoded MintMemo - opt since other variants of MintMemo could be added in the future.


DecodeLedgerMemoError = object

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:133

InvalidMemo: string

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:137

The provided memo could not be decoded.


DecodeLedgerMemoResult = { Ok: [] | [DecodedMemo]; } | { Err: [] | [DecodeLedgerMemoError]; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:139

{ Ok: [] | [DecodedMemo]; }

Ok: [] | [DecodedMemo]

The decoded memo, if the minter was able to decode it. This field is opt, so that other memo types can be added in the future.

{ Err: [] | [DecodeLedgerMemoError]; }

Err: [] | [DecodeLedgerMemoError]

An error in case the minter was not able to decode the provided memo. This field is opt, so that other error types can be added in the future.


EthereumNetwork = { Mainnet: null; } | { Sepolia: null; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:221

{ Mainnet: null; }

Mainnet: null

The public Ethereum mainnet.

{ Sepolia: null; }

Sepolia: null

The public Ethereum Sepolia testnet.


LedgerError = { TemporarilyUnavailable: string; } | { InsufficientAllowance: { allowance: bigint; failed_burn_amount: bigint; ledger_id: Principal; token_symbol: string; }; } | { AmountTooLow: { failed_burn_amount: bigint; ledger_id: Principal; minimum_burn_amount: bigint; token_symbol: string; }; } | { InsufficientFunds: { balance: bigint; failed_burn_amount: bigint; ledger_id: Principal; token_symbol: string; }; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:439

{ TemporarilyUnavailable: string; }

TemporarilyUnavailable: string

The ledger is overloaded, retry the request. The payload contains a human-readable message explaining what caused the unavailability.

{ InsufficientAllowance: { allowance: bigint; failed_burn_amount: bigint; ledger_id: Principal; token_symbol: string; }; }

InsufficientAllowance: object

The allowance given to the minter is too low.

allowance: bigint

failed_burn_amount: bigint

ledger_id: Principal

token_symbol: string

{ AmountTooLow: { failed_burn_amount: bigint; ledger_id: Principal; minimum_burn_amount: bigint; token_symbol: string; }; }

AmountTooLow: object

The withdrawal amount is too low and doesn’t cover the ledger transaction fee.

failed_burn_amount: bigint

ledger_id: Principal

minimum_burn_amount: bigint

token_symbol: string

{ InsufficientFunds: { balance: bigint; failed_burn_amount: bigint; ledger_id: Principal; token_symbol: string; }; }

InsufficientFunds: object

The balance of the withdrawal account is too low.

balance: bigint

failed_burn_amount: bigint

ledger_id: Principal

token_symbol: string


LogVisibility = { controllers: null; } | { public: null; } | { allowed_viewers: Principal[]; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:480


MemoType = { Burn: null; } | { Mint: null; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:484


MinterArg = { UpgradeArg: UpgradeArg; } | { InitArg: InitArg; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:529


MintMemo = { ReimburseWithdrawal: { withdrawal_id: bigint; }; } | { ReimburseTransaction: { tx_hash: string; withdrawal_id: bigint; }; } | { Convert: { from_address: string; log_index: bigint; tx_hash: string; }; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:485

{ ReimburseWithdrawal: { withdrawal_id: bigint; }; }

ReimburseWithdrawal: object

The minter failed to process a withdrawal request, so no transaction was issued, but some reimbursement was made.

withdrawal_id: bigint

The id corresponding to the withdrawal request.

{ ReimburseTransaction: { tx_hash: string; withdrawal_id: bigint; }; }

ReimburseTransaction: object

tx_hash: string

Hash of the failed transaction.

withdrawal_id: bigint

The id corresponding to the withdrawal request.

{ Convert: { from_address: string; log_index: bigint; tx_hash: string; }; }

Convert: object

The minter received some ETH or ERC20 token.

from_address: string

The sender of the ETH or ERC20 token.

log_index: bigint

Integer of the log index position in the block.

tx_hash: string

Hash of the transaction.


ReimbursementIndex = { CkErc20: { ckerc20_ledger_burn_index: bigint; cketh_ledger_burn_index: bigint; ledger_id: Principal; }; } | { CkEth: { ledger_burn_index: bigint; }; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:612


RetrieveEthStatus = { NotFound: null; } | { TxFinalized: TxFinalizedStatus; } | { TxSent: EthTransaction; } | { TxCreated: null; } | { Pending: null; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:638

Retrieve the status of a withdrawal request.

{ NotFound: null; }

NotFound: null

Withdrawal request is not found.

{ TxFinalized: TxFinalizedStatus; }

TxFinalized: TxFinalizedStatus

Ethereum transaction is finalized.

{ TxSent: EthTransaction; }

TxSent: EthTransaction

Ethereum transaction was signed and is sent to the network.

{ TxCreated: null; }

TxCreated: null

Transaction fees were estimated and an Ethereum transaction was created. Transaction is not signed yet.

{ Pending: null; }

Pending: null

Withdrawal request is waiting to be processed.


Subaccount = Uint8Array

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:670


TxFinalizedStatus = { Success: { effective_transaction_fee: [] | [bigint]; transaction_hash: string; }; } | { Reimbursed: { reimbursed_amount: bigint; reimbursed_in_block: bigint; transaction_hash: string; }; } | { PendingReimbursement: EthTransaction; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:682

Status of a finalized transaction.

{ Success: { effective_transaction_fee: [] | [bigint]; transaction_hash: string; }; }

Success: object

Transaction was successful.

effective_transaction_fee: [] | [bigint]

transaction_hash: string

{ Reimbursed: { reimbursed_amount: bigint; reimbursed_in_block: bigint; transaction_hash: string; }; }

Reimbursed: object

Transaction failed, user got reimbursed.

reimbursed_amount: bigint

reimbursed_in_block: bigint

transaction_hash: string

{ PendingReimbursement: EthTransaction; }

PendingReimbursement: EthTransaction

Transaction failed and will be reimbursed,


WithdrawalError = { TemporarilyUnavailable: string; } | { InsufficientAllowance: { allowance: bigint; }; } | { AmountTooLow: { min_withdrawal_amount: bigint; }; } | { RecipientAddressBlocked: { address: string; }; } | { InsufficientFunds: { balance: bigint; }; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:875

{ TemporarilyUnavailable: string; }

TemporarilyUnavailable: string

The minter or the ckETH ledger is temporarily unavailable, retry the request. The payload contains a human-readable message explaining what caused the unavailability.

{ InsufficientAllowance: { allowance: bigint; }; }

InsufficientAllowance: object

The allowance given to the minter is too low.

allowance: bigint

{ AmountTooLow: { min_withdrawal_amount: bigint; }; }

AmountTooLow: object

The withdrawal amount is too low. The payload contains the minimal withdrawal amount.

min_withdrawal_amount: bigint

{ RecipientAddressBlocked: { address: string; }; }

RecipientAddressBlocked: object

Recipient’s address is blocked. No withdrawal can be made to that address.

address: string

{ InsufficientFunds: { balance: bigint; }; }

InsufficientFunds: object

The ckETH balance of the withdrawal account is too low.

balance: bigint


WithdrawalSearchParameter = { ByRecipient: string; } | { BySenderAccount: Account; } | { ByWithdrawalId: bigint; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:912

Search parameter for withdrawals.

{ ByRecipient: string; }

ByRecipient: string

Search by recipient’s ETH address.

{ BySenderAccount: Account; }

BySenderAccount: Account

Search by sender’s token account.

{ ByWithdrawalId: bigint; }

ByWithdrawalId: bigint

Search by ckETH burn index (which is also used to index ckERC20 withdrawals).


WithdrawalStatus = { TxFinalized: TxFinalizedStatus; } | { TxSent: EthTransaction; } | { TxCreated: null; } | { Pending: null; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:934

Status of a withdrawal request.

{ TxFinalized: TxFinalizedStatus; }

TxFinalized: TxFinalizedStatus

Transaction already finalized.

{ TxSent: EthTransaction; }

TxSent: EthTransaction

Transaction sent but not yet finalized.

{ TxCreated: null; }

TxCreated: null

Transaction created byt not yet sent.

{ Pending: null; }

Pending: null

Request is pending, i.e. transaction is not yet created.


WithdrawErc20Error = { TokenNotSupported: { supported_tokens: CkErc20Token[]; }; } | { TemporarilyUnavailable: string; } | { CkErc20LedgerError: { cketh_block_index: bigint; error: LedgerError; }; } | { CkEthLedgerError: { error: LedgerError; }; } | { RecipientAddressBlocked: { address: string; }; }

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:787

{ TokenNotSupported: { supported_tokens: CkErc20Token[]; }; }

TokenNotSupported: object

The user provided ckERC20 token is not supported by the minter.

supported_tokens: CkErc20Token[]

{ TemporarilyUnavailable: string; }

TemporarilyUnavailable: string

The minter is temporarily unavailable, retry the request. The payload contains a human-readable message explaining what caused the unavailability.

{ CkErc20LedgerError: { cketh_block_index: bigint; error: LedgerError; }; }

CkErc20LedgerError: object

The minter could not burn the requested amount of ckERC20 tokens. The cketh_block_index identifies the burn that occurred on the ckETH ledger and that will be reimbursed.

cketh_block_index: bigint

error: LedgerError

{ CkEthLedgerError: { error: LedgerError; }; }

CkEthLedgerError: object

The minter could not burn the required amount of ckETH to pay for the transaction fees.

error: LedgerError

{ RecipientAddressBlocked: { address: string; }; }

RecipientAddressBlocked: object

Recipient’s address is blocked. No withdrawal can be made to that address.

address: string

const idlFactory: IDL.InterfaceFactory

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:1044


const init: (args) => IDL.Type[]

Defined in: packages/canisters/src/declarations/cketh/minter.d.ts:1045

typeof IDL

IDL.Type[]