Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zondax/ledger-cosmos-js


https://github.com/zondax/ledger-cosmos-js

cosmos-sdk

Last synced: about 1 month ago
JSON representation

Awesome Lists containing this project

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)