04a74aac83
Renamed Secp256k1Wallet -> Secp256k1HdWallet Renamed Secp256k1Key -> Secp256k1Wallet Renamed fromPrivateKey function Fixed linter issues Rename Secp256k1Wallet.fromMnemonic everywhere Revert "Rename Secp256k1Wallet.fromMnemonic everywhere" This reverts commit 18c52968bc1a234755c61d1d5c67850222239bd7. Revert "Fixed linter issues" This reverts commit 8e6fce93d809f160e8dafa9478f56f9effcf561a. Revert "Renamed fromPrivateKey function" This reverts commit d628f186bb126d4fc2b205dbc0b95b3198af02df. Revert "Renamed Secp256k1Key -> Secp256k1Wallet" This reverts commit 35a082701de9bd2c8cf89b25a168f12212d4ba8a. Revert "Renamed Secp256k1Wallet -> Secp256k1HdWallet" This reverts commit bd69f293e1ae7d96ad0afd295af360de70863e13. Ran linter Renamed fromPrivateKey Updated Typescript definitions |
||
|---|---|---|
| .circleci | ||
| docs | ||
| packages | ||
| scripts | ||
| .editorconfig | ||
| .eslintignore | ||
| .eslintrc.js | ||
| .gitattributes | ||
| .gitignore | ||
| .mergify.yml | ||
| .nycrc.yml | ||
| .prettierrc.json | ||
| CHANGELOG.md | ||
| codecov.yml | ||
| HACKING.md | ||
| jasmine-spec-reporter.config.json | ||
| lerna.json | ||
| LICENSE | ||
| NOTICE | ||
| package.json | ||
| README.md | ||
| tsconfig.json | ||
| yarn.lock | ||
CosmJS is the Swiss Army knife to power JavaScript based client solutions ranging from Web apps/explorers over browser extensions to server-side clients like faucets/scrapers in the Cosmos ecosystem.
"Cosm" is short for Cosmos and "JS" is short for runs everywhere – we actually develop in TypeScript.
Packages
CosmJS is a library that consists of many smaller npm packages within the @cosmjs namespace, a so called monorepo. Here are some of them to get an idea:
| Package | Description | Latest |
|---|---|---|
| @cosmjs/launchpad | A client library for the Cosmos SDK 0.37 (cosmoshub-3), 0.38 and 0.39 (Launchpad) |  |
| @cosmjs/faucet | A faucet application for node.js |  |
| @cosmjs/cosmwasm | Client for chains with the CosmWasm module enabled |  |
| @cosmjs/crypto | Cryptography for blockchain projects, e.g. hashing (SHA-2, Keccak256, Ripemd160), signing (secp256k1, ed25519), HD key derivation (BIPO39, SLIP-0010), KDFs and symmetric encryption for key storage (PBKDF2, Argon2, XChaCha20Poly1305) |  |
| @cosmjs/encoding | Encoding helpers for blockchain projects |  |
| @cosmjs/math | Safe integers; decimals for handling financial amounts |  |
Modularity
We're pretty proud of the modularity and a clean dependency tree in this monorepo. This ensures software quality on our side and lets users pick exactly what they need. Here you see how everything fits together (every item is a npm package; right depends on left):
If this was not enough to scare you away, check out the version including app runtime dependencies: cosmjs-tree-full.png.
Supported JS environments
Currently the codebase supports the following runtime environments:
- Node.js 10+
- Modern browsers (Chromium/Firefox/Safari, no Internet Explorer or Edge Spartan)
- Browser extensions (Chromium/Firefox)
Our current JavaScript target standard is ES2017, giving us native async/await support. We use WebAssembly to implement certain cryptographic functions.
We're happy to adjust this list according to users' needs as long as you don't ask for Internet Explorer support. If your environment does not support Wasm, we can work on a solution with swapable implementations.
Roadmap
In addition to the development board and our release milestones, we maintain a higher level roadmap in this Trello board.
Development
See HACKING.md.