# @zondax/ledger-cosmos-js

> Node API for Cosmos App (Ledger Nano S/S+/X)

Latest version **4.2.0** (published 2026-09-15) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @zondax/ledger-cosmos-js
pnpm add @zondax/ledger-cosmos-js
yarn add @zondax/ledger-cosmos-js
bun add @zondax/ledger-cosmos-js
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 4.2.0 |
| Published | 2026-09-15 |
| First published | 2020-10-02 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 5 |
| Unpacked size | 49.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 31 |
| Author | Zondax AG |
| Maintainers | jleni, emmanuel-zondax |
| Keywords | Ledger, Typescript, Tendermint, Cosmos |

## Links

- npm: https://www.npmjs.com/package/@zondax/ledger-cosmos-js
- Repository: https://github.com/Zondax/ledger-cosmos-js
- Issues: https://github.com/Zondax/ledger-cosmos-js/issues
- npm.io page: https://npm.io/package/@zondax/ledger-cosmos-js

## Dependencies (5)

- [buffer](https://npm.io/package/buffer.md) ^6.0.3
- [ripemd160](https://npm.io/package/ripemd160.md) ^2.0.2
- [@scure/base](https://npm.io/package/@scure/base.md) ^1.2.6
- [@noble/hashes](https://npm.io/package/@noble/hashes.md) ^1.8.0
- [@zondax/ledger-js](https://npm.io/package/@zondax/ledger-js.md) ^2.1.0

## Alternatives

- [@openai/codex-sdk](https://npm.io/package/@openai/codex-sdk.md) — 731.4K weekly downloads
- [babel-plugin-transform-react-jsx](https://npm.io/package/babel-plugin-transform-react-jsx.md) — 565.0K weekly downloads
- [babel-helper-remove-or-void](https://npm.io/package/babel-helper-remove-or-void.md) — 508.5K weekly downloads
- [@pnpm/store-controller-types](https://npm.io/package/@pnpm/store-controller-types.md) — 186.9K weekly downloads
- [react-native-signature-canvas](https://npm.io/package/react-native-signature-canvas.md) — 155.6K weekly downloads

## Recent versions

- 4.2.0 (latest) — 2026-09-15
- 4.1.0 — 2026-09-11
- 4.0.1 — 2025-04-11
- 4.0.0 — 2024-09-01
- 3.0.3 — 2023-07-13
- 3.0.2 — 2022-12-07
- 3.0.1 — 2022-08-30
- 3.0.0 — 2022-08-30
- 2.1.8 — 2020-10-02

## README

# @zondax/ledger-cosmos-js

![zondax](docs/zondax_light.png)

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![Main](https://github.com/cosmos/ledger-cosmos-js/workflows/Main/badge.svg)](https://github.com/cosmos/ledger-cosmos-js/actions?query=workflow%3AMain)
[![npm version](https://badge.fury.io/js/%40cosmos%2Fledger-cosmos-js.svg)](https://badge.fury.io/js/%40cosmos%2Fledger-cosmos-js)

This package provides a basic client library to communicate with a Tendermint/Cosmos App running in a Ledger Nano S/S+/X devices

We recommend using the npmjs package in order to receive updates/fixes.

# Available commands

| Operation            | Response                    | Command                     |
| -------------------- | --------------------------- | --------------------------- |
| getVersion           | app version                 | ---------------             |
| publicKey            | pubkey                      | path (legacy command)       |
| getAddressAndPubKey  | pubkey + address            | path + ( showInDevice )     |
| showAddressAndPubKey | signed message              | path                        |
| appInfo              | name, version, flags, etc   | ---------------             |
| deviceInfo           | fw and mcu version, id, etc | Only available in dashboard |
| sign                 | signed message              | path + message + (HRP)      |

getAddress command requires that you set the derivation path (account, change, index) and has an option parameter to display the address on the device. By default, it will retrieve the information without user confirmation.

# Testing with real devices

It is possible to test this package with a real Ledger Nano device. To accomplish that, you will need to follow these steps:

- Install the application in the Ledger device
- Install the dependencies from this project
- Run tests

```shell script
yarn install
yarn test:integration
```

# Who we are?

We are Zondax, a company pioneering blockchain services. If you want to know more about us, please visit us at [zondax.ch](https://zondax.ch)

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