@dfinity/ledger NPM

ledger-js

A library for interfacing with ICRC ledgers on the Internet Computer.

Installation

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

npm i @dfinity/ledger

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 LedgerCanister. It has to be instantiated with a canister ID.

e.g. fetching a token metadata.

import { IcrcLedgerCanister } from "@dfinity/ledger";
import { createAgent } from "@dfinity/utils";

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

const { metadata } = LedgerCanister.create({
  agent,
  canisterId: MY_LEDGER_CANISTER_ID,
});

const data = await metadata();

Features

ledger-js implements following features:

:toolbox: Functions

:gear: encodeIcrcAccount

Encodes an Icrc-1 account compatible into a string. Formatting Reference: https://github.com/dfinity/ICRC-1/pull/55/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5R238

Function	Type
`encodeIcrcAccount`	`({ owner, subaccount, }: IcrcAccount) => string`

Parameters:

account: : Principal, subaccount?: Uint8Array }

:gear: decodeIcrcAccount

Decodes a string into an Icrc-1 compatible account. Formatting Reference: https://github.com/dfinity/ICRC-1/pull/55/files#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5R268

Function	Type
`decodeIcrcAccount`	`(accountString: string) => IcrcAccount`

Parameters:

accountString: string

:factory: IcrcLedgerCanister

Constructors

public

Methods

:gear: create

Method	Type
`create`	`(options: IcrcLedgerCanisterOptions<_SERVICE>) => IcrcLedgerCanister`

:gear: metadata

The token metadata (name, symbol, etc.).

Method	Type
`metadata`	`(params: QueryParams) => Promise<IcrcTokenMetadataResponse>`

:gear: transactionFee

The ledger transaction fees.

Method	Type
`transactionFee`	`(params: QueryParams) => Promise<bigint>`

:gear: balance

Returns the balance of the given account.

Method	Type
`balance`	`(params: BalanceParams) => Promise<bigint>`

Parameters:

params: The parameters to get the balance of an account.

:gear: transfer

Transfers tokens from the sender to the given account.

Method	Type
`transfer`	`(params: TransferParams) => Promise<bigint>`

Parameters:

params: The parameters to transfer tokens.

Resources

Ledger & Tokenization Working Group Standards

internet computer internet-computer ic dfinity Ledger ICRC-1 ledger token

@infinitebrahmanuniverse/nolb-_df @everything-registry/sub-chunk-240 yolosns-2 @infinityswapofficial/token-lists quickfixicrc1

0.0.13-next-2023-08-09

2 years ago

0.0.13-next-2023-08-08

2 years ago

0.0.16-next-2023-09-12.1

2 years ago

0.0.13-next-2023-08-07

2 years ago

0.0.13-next-2023-08-19

2 years ago

0.0.13-next-2023-08-18

2 years ago

0.0.13-next-2023-08-17

2 years ago

0.0.13-next-2023-08-16

2 years ago

0.0.13-next-2023-08-15

2 years ago

0.0.11-next-2023-07-01.1

2 years ago

0.0.13-next-2023-08-14

2 years ago

0.0.13-next-2023-08-13

2 years ago

0.0.13-next-2023-08-12

2 years ago

0.0.13-next-2023-08-11

2 years ago

0.0.13-next-2023-08-10

2 years ago

0.0.16-next-2023-09-05

2 years ago

0.0.16-next-2023-09-07

2 years ago

0.0.16-next-2023-09-06

2 years ago

0.0.16-next-2023-09-09

2 years ago

0.0.16-next-2023-09-08

2 years ago

0.0.13-next-2023-08-24

2 years ago

0.0.13-next-2023-08-23

2 years ago

0.0.13-next-2023-08-22

2 years ago

0.0.13-next-2023-08-21

2 years ago

0.0.13-next-2023-08-20

2 years ago

1.0.0-next-2023-10-02.1

2 years ago

0.0.16-next-2023-09-22.1

2 years ago

0.0.12-next-2023-08-02.1

2 years ago

0.0.12-next-2023-07-24.1

2 years ago

0.0.11-next-2023-06-29.1

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

0.0.14-next-2023-08-28.1

2 years ago

0.0.12-next-2023-08-04.1

2 years ago

0.0.12-next-2023-07-19

2 years ago

0.0.12-next-2023-07-17

2 years ago

0.0.12-next-2023-07-18

2 years ago

0.0.12-next-2023-07-11

2 years ago

0.0.12-next-2023-07-12

2 years ago

0.0.12-next-2023-07-10

2 years ago

0.0.12-next-2023-07-15

2 years ago

0.0.12-next-2023-07-16

2 years ago

0.0.12-next-2023-07-13

2 years ago

0.0.12-next-2023-07-14

2 years ago

0.0.14-next-2023-09-03

2 years ago

0.0.14-next-2023-09-02

2 years ago

0.0.14-next-2023-09-04

2 years ago

0.0.14-next-2023-09-01

2 years ago

0.0.14-next-2023-08-30

2 years ago

0.0.14-next-2023-08-31

2 years ago

0.0.12-next-2023-07-03.1

2 years ago

0.0.12-next-2023-07-28

2 years ago

0.0.12-next-2023-07-29

2 years ago

0.0.12-next-2023-07-22

2 years ago

0.0.12-next-2023-07-23

2 years ago

0.0.12-next-2023-07-20

2 years ago

0.0.12-next-2023-07-21

2 years ago

0.0.12-next-2023-07-26

2 years ago

0.0.12-next-2023-07-27

2 years ago

0.0.12-next-2023-07-24

2 years ago

0.0.12-next-2023-07-25

2 years ago

0.0.14-next-2023-08-25

2 years ago

0.0.14-next-2023-08-26

2 years ago

0.0.11-next-2023-06-30.1

2 years ago

0.0.14-next-2023-08-24

2 years ago

0.0.11-next-2023-06-30.2

2 years ago

0.0.12-next-2023-07-30

2 years ago

0.0.14-next-2023-08-29

2 years ago

0.0.14-next-2023-08-27

2 years ago

0.0.14-next-2023-08-28

2 years ago

1.0.0-next-2023-10-02

2 years ago

0.0.12-next-2023-07-08

2 years ago

0.0.12-next-2023-07-09

2 years ago

0.0.12-next-2023-07-06

2 years ago

0.0.12-next-2023-07-07

2 years ago

0.0.12-next-2023-07-04

2 years ago

0.0.12-next-2023-07-05

2 years ago

0.0.12-next-2023-07-03

2 years ago

0.0.13-next-2023-08-14.1

2 years ago

1.0.0

2 years ago

0.0.16-next-2023-09-21

2 years ago

0.0.16-next-2023-09-20

2 years ago

0.0.16-next-2023-09-23

2 years ago

0.0.16-next-2023-09-22

2 years ago

0.0.16-next-2023-09-25

2 years ago

0.0.16-next-2023-10-02

2 years ago

0.0.16-next-2023-09-24

2 years ago

0.0.16-next-2023-09-27

2 years ago

0.0.16-next-2023-09-26

2 years ago

0.0.16-next-2023-09-29

2 years ago

0.0.16-next-2023-09-28

2 years ago

0.0.16-next-2023-09-18.1

2 years ago

0.0.16-next-2023-09-18.2

2 years ago

0.0.16-next-2023-10-01

2 years ago

0.0.16-next-2023-09-10

2 years ago

0.0.15-next-2023-09-05

2 years ago

0.0.16-next-2023-09-12

2 years ago

0.0.16-next-2023-09-11

2 years ago

0.0.16-next-2023-09-14

2 years ago

0.0.16-next-2023-09-13

2 years ago

0.0.16-next-2023-09-16

2 years ago

0.0.16-next-2023-09-15

2 years ago

0.0.16-next-2023-09-18

2 years ago

0.0.16-next-2023-09-17

2 years ago

0.0.15-next-2023-09-04

2 years ago

0.0.16-next-2023-09-19

2 years ago

0.0.16-next-2023-09-21.1

2 years ago

0.0.12-next-2023-08-07

2 years ago

0.0.12-next-2023-08-02

2 years ago

0.0.12-next-2023-07-31

2 years ago

0.0.12-next-2023-08-01

2 years ago

0.0.12-next-2023-08-04

2 years ago

0.0.12-next-2023-08-03

2 years ago

0.0.12-next-2023-08-06

2 years ago

0.0.12-next-2023-08-05

2 years ago

0.0.11-next-2023-07-03

2 years ago

0.0.11-next-2023-07-01

2 years ago

0.0.11-next-2023-07-02

2 years ago

0.0.16-next-2023-09-30

2 years ago

0.0.11-next-2023-06-30

2 years ago

0.0.11-next-2023-06-29

2 years ago

0.0.11-next-2023-06-28

2 years ago

0.0.11-next-2023-06-27

2 years ago

0.0.11-next-2023-06-26.1

2 years ago

0.0.11-next-2023-06-26.2

2 years ago

0.0.11-next-2023-06-24

2 years ago

0.0.11-next-2023-06-25

2 years ago

0.0.11-next-2023-06-26

2 years ago

0.0.11-next-2023-06-23

2 years ago

0.0.8-next-2023-04-19

2 years ago

0.0.8-next-2023-04-18

2 years ago

0.0.9-next-2023-06-12.1

2 years ago

0.0.8-next-2023-04-24

2 years ago

0.0.8-next-2023-04-25

2 years ago

0.0.8-next-2023-04-22

2 years ago

0.0.8-next-2023-04-23

2 years ago

0.0.8-next-2023-04-20

2 years ago

0.0.8-next-2023-04-21

2 years ago

0.0.8-next-2023-04-28

2 years ago

0.0.8-next-2023-04-29

2 years ago

0.0.8-next-2023-04-26

2 years ago

0.0.8-next-2023-04-27

2 years ago

0.0.8-next-2023-04-24.1

2 years ago

0.0.8-next-2023-04-24.2

2 years ago

0.0.11-next-2023-06-22.1

2 years ago

0.0.9-next-2023-06-13.1

2 years ago

0.0.9-next-2023-06-13.2

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

0.0.9-next-2023-06-06.1

2 years ago

0.0.10-next-2023-06-21

2 years ago

0.0.6-next-2023-04-18

2 years ago

0.0.6-next-2023-04-17

2 years ago

0.0.10

2 years ago

0.0.9-next-2023-05-30.1

2 years ago

0.0.8-next-2023-04-27.1

2 years ago

0.0.9-next-2023-06-08

2 years ago

0.0.9-next-2023-06-07

2 years ago

0.0.9-next-2023-06-06

2 years ago

0.0.9-next-2023-06-05

2 years ago

0.0.9-next-2023-06-09

2 years ago

0.0.9-next-2023-05-31

2 years ago

0.0.9-next-2023-05-30

2 years ago

0.0.9-next-2023-06-04

2 years ago

0.0.9-next-2023-06-03

2 years ago

0.0.9-next-2023-06-02

2 years ago

0.0.9-next-2023-06-01

2 years ago

0.0.8-next-2023-04-20.1

2 years ago

0.0.9-next-2023-05-29

2 years ago

0.0.9-next-2023-05-28

2 years ago

0.0.9-next-2023-05-27

2 years ago

0.0.9-next-2023-05-26

2 years ago

0.0.9-next-2023-05-25

2 years ago

0.0.9-next-2023-05-24

2 years ago

0.0.10-next-2023-06-21.1

2 years ago

0.0.10-next-2023-06-21.2

2 years ago

0.0.9-next-2023-06-20

2 years ago

0.0.8-next-2023-05-24

2 years ago

0.0.8-next-2023-05-23

2 years ago

0.0.8-next-2023-05-20

2 years ago

0.0.8-next-2023-05-22

2 years ago

0.0.8-next-2023-05-21

2 years ago

0.0.9-next-2023-06-19

2 years ago

0.0.9-next-2023-06-18

2 years ago

0.0.9-next-2023-06-17

2 years ago

0.0.9-next-2023-06-16

2 years ago

0.0.9-next-2023-06-11

2 years ago

0.0.9-next-2023-06-10

2 years ago

0.0.9-next-2023-06-15

2 years ago

0.0.9-next-2023-06-14

2 years ago

0.0.9-next-2023-06-13

2 years ago

0.0.9-next-2023-06-12

2 years ago

0.0.7-next-2023-04-18

2 years ago

0.0.8-next-2023-05-02

2 years ago

0.0.8-next-2023-05-01

2 years ago

0.0.8-next-2023-05-04

2 years ago

0.0.8-next-2023-05-03

2 years ago

0.0.8-next-2023-04-30

2 years ago

0.0.8-next-2023-05-09

2 years ago

0.0.8-next-2023-05-06

2 years ago

0.0.8-next-2023-05-05

2 years ago

0.0.8-next-2023-05-08

2 years ago

0.0.8-next-2023-05-07

2 years ago

0.0.9-next-2023-06-15.1

2 years ago

0.0.8-next-2023-05-13

2 years ago

0.0.8-next-2023-05-12

2 years ago

0.0.8-next-2023-05-15

2 years ago

0.0.8-next-2023-05-14

2 years ago

0.0.11-next-2023-06-21

2 years ago

0.0.11-next-2023-06-22

2 years ago

0.0.8-next-2023-05-11

2 years ago

0.0.8-next-2023-05-10

2 years ago

0.0.8-next-2023-05-17

2 years ago

0.0.8-next-2023-05-16

2 years ago

0.0.8-next-2023-05-19

2 years ago

0.0.8-next-2023-05-18

2 years ago

0.0.6-next-2023-04-04.1

2 years ago

0.0.6-next-2023-04-04.2

2 years ago

0.0.6-next-2023-04-13.2

2 years ago

0.0.6-next-2023-04-13.1

2 years ago

0.0.6-next-2023-04-07

2 years ago

0.0.6-next-2023-04-06

2 years ago

0.0.6-next-2023-04-09

2 years ago

0.0.6-next-2023-04-08

2 years ago

0.0.6-next-2023-04-01

2 years ago

0.0.6-next-2023-03-30

2 years ago

0.0.6-next-2023-03-31

2 years ago

0.0.6-next-2023-04-03

2 years ago

0.0.6-next-2023-04-02

2 years ago

0.0.6-next-2023-04-05

2 years ago

0.0.6-next-2023-04-04

2 years ago

0.0.6-next-2023-04-10

2 years ago

0.0.6-next-2023-04-12

2 years ago

0.0.6-next-2023-04-11

2 years ago

0.0.6-next-2023-04-14

2 years ago

0.0.6-next-2023-04-13

2 years ago

0.0.6-next-2023-04-16

2 years ago

0.0.6-next-2023-04-15

2 years ago

0.0.6-next-2023-02-28

2 years ago

0.0.6-next-2023-02-26

2 years ago

0.0.6-next-2023-02-27

2 years ago

0.0.6-next-2023-02-20

2 years ago

0.0.6-next-2023-02-21

2 years ago

0.0.6-next-2023-02-24

2 years ago

0.0.6-next-2023-02-25

2 years ago

0.0.6-next-2023-02-22

2 years ago

0.0.6-next-2023-03-07.1

2 years ago

0.0.6-next-2023-02-23

2 years ago

0.0.6-next-2023-02-27.1

2 years ago

0.0.6-next-2023-03-29

2 years ago

0.0.6-next-2023-03-27

2 years ago

0.0.6-next-2023-03-28

2 years ago

0.0.6-next-2023-03-21

2 years ago

0.0.6-next-2023-03-22

2 years ago

0.0.6-next-2023-03-20

2 years ago

0.0.6-next-2023-03-25

2 years ago

0.0.6-next-2023-03-26

2 years ago

0.0.6-next-2023-03-23

2 years ago

0.0.6-next-2023-03-24

2 years ago

0.0.6-next-2023-03-18

2 years ago

0.0.6-next-2023-03-19

2 years ago

0.0.6-next-2023-03-16

2 years ago

0.0.6-next-2023-03-17

2 years ago

0.0.6-next-2023-03-21.1

2 years ago

0.0.6-next-2023-03-10

2 years ago

0.0.6-next-2023-03-11

2 years ago

0.0.6-next-2023-03-14

2 years ago

0.0.6-next-2023-03-15

2 years ago

0.0.6-next-2023-03-12

2 years ago

0.0.6-next-2023-03-06.1

2 years ago

0.0.6-next-2023-03-13

2 years ago

0.0.6-next-2023-02-22.1

2 years ago

0.0.6-next-2023-03-07

2 years ago

0.0.6-next-2023-03-08

2 years ago

0.0.6-next-2023-03-05

2 years ago

0.0.6-next-2023-03-06

2 years ago

0.0.6-next-2023-03-09

2 years ago

0.0.6-next-2023-03-13.1

2 years ago

0.0.6-next-2023-03-03

2 years ago

0.0.6-next-2023-03-04

2 years ago

0.0.6-next-2023-03-01

2 years ago

0.0.6-next-2023-03-02

2 years ago

0.0.6-next-2023-02-19

2 years ago

0.0.6-next-2023-02-18

2 years ago

0.0.6-next-2023-02-17

2 years ago

0.0.6-next-2023-02-16

2 years ago

0.0.6-next-2023-02-15.1

2 years ago

0.0.6-next-2023-02-15

2 years ago

0.0.6-next-2023-02-14.2

2 years ago

0.0.6-next-2023-02-14.1

2 years ago

0.0.6-next-2023-02-14

2 years ago

0.0.6-next-2023-02-13.3

2 years ago

0.0.6-next-2023-02-13.2

2 years ago

0.0.6-next-2023-02-13.1

2 years ago

0.0.6-next-2023-02-13

2 years ago

0.0.6-next-2023-02-12

2 years ago

0.0.6-next-2023-02-11

2 years ago

0.0.6-next-2023-02-10

2 years ago

0.0.6-next-2023-02-09

2 years ago

0.0.6-next-2023-02-08.1

2 years ago

0.0.6-next-2023-02-08

2 years ago

0.0.6-next-2023-02-07.1

2 years ago

0.0.6-next-2023-02-07

2 years ago

0.0.5

2 years ago

0.0.5-next-2023-02-07

2 years ago

0.0.5-next-2023-02-06

2 years ago

0.0.5-next-2023-02-05

2 years ago

0.0.5-next-2023-02-04

2 years ago

0.0.5-next-2023-02-03

2 years ago

0.0.5-next-2023-02-02

2 years ago

0.0.5-next-2023-02-01

2 years ago

0.0.5-next-2023-01-31.1

2 years ago

0.0.5-next-2023-01-31

2 years ago

0.0.5-next-2023-01-30.2

2 years ago

0.0.5-next-2023-01-30.1

2 years ago

0.0.5-next-2023-01-30

2 years ago

0.0.5-next-2023-01-29

2 years ago

0.0.5-next-2023-01-28.1

2 years ago

0.0.5-next-2023-01-28

2 years ago

0.0.4

2 years ago

0.0.4-next-2023-01-28.1

2 years ago

0.0.4-next-2023-01-28

2 years ago

0.0.4-next-2023-01-27

2 years ago

0.0.4-next-2023-01-26.1

2 years ago

0.0.4-next-2023-01-26

2 years ago

0.0.4-next-2023-01-25.1

2 years ago

0.0.4-next-2023-01-25

2 years ago

0.0.4-next-2023-01-24

2 years ago

0.0.3

2 years ago

0.0.2-next-2023-01-24

2 years ago

0.0.2

2 years ago

0.0.1

2 years ago

@dfinity/ledger v1.0.0

ledger-js

Table of contents

Installation

Usage

Features

:toolbox: Functions

:gear: encodeIcrcAccount

:gear: decodeIcrcAccount

:factory: IcrcLedgerCanister

Constructors

Methods

:gear: create

:gear: metadata

:gear: transactionFee

:gear: balance

:gear: transfer

Resources