# @cosmjs/ledger-amino

> A library for signing Amino-encoded transactions using Ledger devices

Latest version **0.39.0** (published 2026-05-04) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @cosmjs/ledger-amino
pnpm add @cosmjs/ledger-amino
yarn add @cosmjs/ledger-amino
bun add @cosmjs/ledger-amino
```

## Health

**Score 60/100 (C)** — status: active.

Positive: has types; esm support; no vulnerabilities; high quality score.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.39.0 |
| Published | 2026-05-04 |
| First published | 2021-01-26 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 7 |
| Unpacked size | 24.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 699 |
| Maintainers | webmaster128, kiki-skip |

## Links

- npm: https://www.npmjs.com/package/@cosmjs/ledger-amino
- Repository: https://github.com/CosmWasm/cosmjs/tree/main/packages/ledger-amino
- npm.io page: https://npm.io/package/@cosmjs/ledger-amino

## Dependencies (7)

- [semver](https://npm.io/package/semver.md) ^7.5.2
- [@cosmjs/math](https://npm.io/package/@cosmjs/math.md) ^0.39.0
- [@cosmjs/amino](https://npm.io/package/@cosmjs/amino.md) ^0.39.0
- [@cosmjs/utils](https://npm.io/package/@cosmjs/utils.md) ^0.39.0
- [@cosmjs/crypto](https://npm.io/package/@cosmjs/crypto.md) ^0.39.0
- [@cosmjs/encoding](https://npm.io/package/@cosmjs/encoding.md) ^0.39.0
- [@zondax/ledger-cosmos-js](https://npm.io/package/@zondax/ledger-cosmos-js.md) ^4.0.1

## Recent versions

- 0.39.0 (latest) — 2026-05-04
- 0.37.1 (backports-unsorted) — 2025-12-31
- 0.38.0-rc.1 (next) — 2025-12-24
- 0.38.1 — 2025-12-31
- 0.38.0 — 2025-12-30
- 0.38.0-rc.0 — 2025-12-24
- 0.37.0 — 2025-10-29
- 0.35.2 — 2025-10-29
- 0.37.0-rc.1 — 2025-10-24
- 0.36.2-0 — 2025-10-24
- 0.36.2 — 2025-10-24
- 0.35.1 — 2025-10-22
- 0.34.1 — 2025-10-22
- 0.37.0-rc.0 — 2025-10-17
- 0.36.1 — 2025-10-02
- … 81 more at https://npm.io/package/@cosmjs/ledger-amino/versions

## README

# @cosmjs/ledger-amino

![typescript](https://img.shields.io/npm/types/@cosmjs/ledger-amino.svg)
[![npm version](https://img.shields.io/npm/v/@cosmjs/ledger-amino.svg)](https://www.npmjs.com/package/@cosmjs/ledger-amino)
[![license](https://img.shields.io/npm/l/@cosmjs/ledger-amino.svg)](https://github.com/cosmos/cosmjs/blob/v0.35.0/LICENSE)
![minimum node version](https://img.shields.io/node/v/@cosmjs/ledger-amino.svg)
![minified size](https://img.shields.io/bundlephobia/min/@cosmjs/ledger-amino.svg)
![monthly downloads](https://img.shields.io/npm/dm/@cosmjs/ledger-amino.svg)

## Supported platforms

This library must be provided with a Ledger transport, and has been tested with
appropriate transports for Node.js as well as certain browsers. In our demo code
we use
[@ledgerhq/hw-transport-node-hid](https://github.com/LedgerHQ/ledgerjs/tree/master/packages/hw-transport-node-hid)
to connect to Ledger devices from Node.js. We use the
[@ledgerhq/hw-transport-webusb](https://github.com/LedgerHQ/ledgerjs/tree/master/packages/hw-transport-webusb)
library to connect to Ledger devices from the browser via USB. You can check the
support status of this library
[here](https://github.com/LedgerHQ/ledgerjs/tree/master/packages/hw-transport-webusb#support-status).

## Running the demo

### Node.js

Connect the Ledger device via USB, open the Cosmos app, then run the demo (this
will also build the package):

```sh
yarn demo-node
```

### Browser

Serve the project locally:

```sh
# Build and bundle the demo for web
yarn pack-demo-web

# Host the `ledger-amino` package directory, for example using Python 3
python3 -m http.server
```

Visit the demo page in a browser, for example if using the Python 3 option:
http://localhost:8000/demo.

Then follow the instructions on that page.

## Running tests

The tests in this package require a Ledger device
[initialized with the mnemonic](https://support.ledger.com/hc/en-us/articles/360005434914)
from
[scripts/wasmd/README.md#preset-accounts](https://github.com/cosmos/cosmjs/blob/main/scripts/wasmd/README.md#preset-accounts)
(see "Ledger: accounts for Ledger based demos and tests") with an installed
"Cosmos (ATOM)" app. The device must be connected via USB, unlocked and the
Cosmos app must be opened. The tests require the user to manually approve
transactions.

### Stargate tests

Start a local Stargate blockchain as described in
[scripts/simapp50/README.md](https://github.com/cosmos/cosmjs/blob/main/scripts/simapp50/README.md)
and execute:

```sh
export LEDGER_ENABLED=1
export SIMAPP50_ENABLED=1
yarn test
```

## License

This package is part of the cosmjs repository, licensed under the Apache License
2.0 (see [NOTICE](https://github.com/cosmos/cosmjs/blob/main/NOTICE) and
[LICENSE](https://github.com/cosmos/cosmjs/blob/main/LICENSE)).

---
_Source: https://npm.io/package/@cosmjs/ledger-amino · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._