@ledgerhq/hw-app-canton/README.md

Ledger Hardware Wallet Canton Application API

<img src="https://user-images.githubusercontent.com/4631227/191834116-59cf590e-25cc-4956-ae5c-812ea464f324.png" height="100" />

[GitHub](https://github.com/LedgerHQ/ledger-live/),
[Ledger Devs Discord](https://developers.ledger.com/discord-pro),
[Developer Portal](https://developers.ledger.com/)

## @ledgerhq/hw-app-canton

Ledger Hardware Wallet Canton JavaScript bindings.

***

## Are you adding Ledger support to your software wallet?

You may be using this package to communicate with the Canton Nano App.

For a smooth and quick integration:

*   See the developers’ documentation on the [Developer Portal](https://developers.ledger.com/docs/transport/overview/) and
*   Go on [Discord](https://developers.ledger.com/discord-pro/) to chat with developer support and the developer community.

## API

<!-- Generated by documentation.js. Update this documentation by updating the source code. -->

#### Table of Contents

*   [Canton](#canton)
    *   [Parameters](#parameters)
    *   [getAddress](#getaddress)
        *   [Parameters](#parameters-1)
    *   [signTransaction](#signtransaction)
        *   [Parameters](#parameters-2)
    *   [getAppConfiguration](#getappconfiguration)
*   [MockCantonDevice](#mockcantondevice)

### Canton

Canton BOLOS API

#### Parameters

*   `transport` **Transport**&#x20;
*   `scrambleKey`   (optional, default `"canton_default_scramble_key"`)

#### getAddress

Get a Canton address for a given BIP-32 path.

##### Parameters

*   `path` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** a path in BIP-32 format
*   `display` **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** whether to display the address on the device (optional, default `false`)

Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<CantonAddress>** the address and public key

#### signTransaction

Sign a Canton transaction.

##### Parameters

*   `path` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** a path in BIP-32 format
*   `rawTx` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** the raw transaction to sign

Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<CantonSignature>** the signature

#### getAppConfiguration

Get the app configuration.

Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<AppConfig>** the app configuration including version

### MockCantonDevice

Mock Canton "@ledgerhq/hw-app-canton" device implementation for development and testing