@dfinity/cketh v3.3.3

cketh-js

A library for interfacing with ckETH on the Internet Computer.

Table of contents

• Installation
• Usage
• Features

Installation

You can use cketh-js by installing it in your project.

npm i @dfinity/cketh

The bundle needs peer dependencies, be sure that following resources are available in your project as well.

npm i @dfinity/agent @dfinity/candid @dfinity/principal @dfinity/utils

Usage

The features are available through the class CkETHMinterCanister. It has to be instantiated with a canister ID.

import { CkETHMinterCanister } from "@dfinity/cketh";
import { createAgent } from "@dfinity/utils";

const agent = await createAgent({
  identity,
  host: HOST,
});

const { getSmartContractAddress } = CkETHMinterCanister.create({
  agent,
  canisterId: MY_CKETH_MINTER_CANISTER_ID,
});

const address = await getSmartContractAddress({});

Features

cketh-js implements following features:

:factory: CkETHMinterCanister

:link: Source

Methods

• create
• getSmartContractAddress
• withdrawEth
• withdrawErc20
• eip1559TransactionPrice
• retrieveEthStatus
• getMinterInfo

:gear: create

:link: Source

:gear: getSmartContractAddress

The address of the helper smart contract may change in the future when the minter is upgraded. Please verify the address of the helper contract before any important transfer by querying the minter as follows.

Parameters:

• params: The parameters to resolve the ckETH smart contract address.
• params.certified: query or update call

:link: Source

:gear: withdrawEth

Submits a request to convert ckETH to ETH after making an ICRC-2 approval.

Preconditions:

The caller allowed the minter's principal to spend its funds using icrc2_approve on the ckETH ledger.

Parameters:

• params: The parameters to withdrawal ckETH to ETH.
• params.address: The destination ETH address.
• params.amount: The ETH amount in wei.

:link: Source

:gear: withdrawErc20

Submits a request to convert ckErc20 to Erc20 - e.g. ckUSDC to USDC - after making ICRC-2 approvals for the ckETH and related ckErc20 ledgers.

Preconditions:

The caller allowed the minter's principal to spend its funds using icrc2_approve on the ckErc20 ledger and to burn some of the user’s ckETH tokens to pay for the transaction fees on the CkETH ledger.

Parameters:

• params: The parameters to withdrawal ckErc20 to Erc20.
• params.address: The destination ETH address.
• params.amount: The ETH amount in wei.
• params.ledgerCanisterId: The ledger canister ID of the ckErc20.

:link: Source

:gear: eip1559TransactionPrice

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

Parameters:

• params: - The parameters to get the minter info.
• params.ckErc20LedgerId: - The optional identifier for a particular ckERC20 ledger.
• params.certified: - Indicates whether this is a certified query or an update call.

:link: Source

:gear: retrieveEthStatus

Retrieve the status of a withdrawal request.

:link: Source

:gear: getMinterInfo

Returns internal minter parameters such as the minimal withdrawal amount, the last observed block number, etc.

Parameters:

• params: The parameters to get the minter info.
• params.certified: query or update call

:link: Source

:factory: CkETHOrchestratorCanister

Class representing the CkETH Orchestrator Canister, which manages the Ledger and Index canisters of ckERC20 tokens.

:link: Source

Methods

• create
• getOrchestratorInfo

:gear: create

Creates an instance of CkETHOrchestratorCanister.

Parameters:

• options: - Options for creating the canister.

:link: Source

:gear: getOrchestratorInfo

Retrieves orchestrator information, which contains the list of existing ckERC20 Ledger and Index canisters.

Parameters:

• params: - The query parameters.
• params.certified: - Whether to execute a certified (update) call.

:link: Source

Resources

• ckETH Minter
• ckETH testnet deployment arguments
• How to Acquire ckETH blog post by Jennifer Tran