Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/cosmostation/cosmosjs

:star: CosmosJS - Cosmos JavaScript Library
https://github.com/cosmostation/cosmosjs

akash-network amino atom band blockchain certik cosmos cosmos-address cosmos-sdk cosmosjs iov iris juno kava protobuf secret-network sign tendermint wasm

Last synced: 3 months ago
JSON representation

:star: CosmosJS - Cosmos JavaScript Library

Host: GitHub
URL: https://github.com/cosmostation/cosmosjs
Owner: cosmostation
License: mit
Archived: true
Created: 2019-05-17T09:45:20.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2022-04-15T06:00:10.000Z (over 2 years ago)
Last Synced: 2024-07-09T01:58:49.000Z (4 months ago)
Topics: akash-network, amino, atom, band, blockchain, certik, cosmos, cosmos-address, cosmos-sdk, cosmosjs, iov, iris, juno, kava, protobuf, secret-network, sign, tendermint, wasm
Language: JavaScript
Homepage:
Size: 1.74 MB
Stars: 166
Watchers: 5
Forks: 78
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-ccamel - cosmostation/cosmosjs - :star: CosmosJS - Cosmos JavaScript Library (JavaScript)

README

        
[![NPM Downloads](https://img.shields.io/npm/dt/@cosmostation/cosmosjs.svg)](https://www.npmjs.com/package/@cosmostation/cosmosjs)

> **IMPORTANT** THIS REPO IS DEPRECATED. Please use [cosmos/cosmjs](https://github.com/cosmos/cosmjs) instead of this repository.



  





    CosmosJS - Cosmos JavaScript Library 



*:star: Developed / Developing by [Cosmostation](https://www.cosmostation.io/)*

A Javascript Open Source Library for blockchain made using by Cosmos SDK like [Cosmoshub](https://cosmos.network/), [IRISnet](https://www.irisnet.org/), [Akash Network](https://akash.network/), and [Juno](https://www.junonetwork.io/).

This library supports cosmos address generation and verification. It enables you to create an offline signature functions of different types of transaction messages. It will eventually support all the other blockchains that are based on Tendermint in the future.

> :warning: If you need for classic version for amino signing, download a version under v0.9.7

[![License](https://img.shields.io/npm/l/@cosmostation/cosmosjs.svg)](https://www.npmjs.com/package/@cosmostation/cosmosjs)

[![Latest Stable Version](https://img.shields.io/npm/v/@cosmostation/cosmosjs.svg)](https://www.npmjs.com/package/@cosmostation/cosmosjs)

[![NPM Downloads](https://img.shields.io/npm/dm/@cosmostation/cosmosjs.svg)](https://www.npmjs.com/package/@cosmostation/cosmosjs)

## Installation

In order to fully use this library, you need to run a local or remote full node and set up its rest server, which acts as an intermediary between the front-end and the full-node.

### NPM (Protobuf)

```bash

npm install @cosmostation/cosmosjs

```

### Yarn (Protobuf)

```bash

yarn add @cosmostation/cosmosjs

```

### NPM (Amino)

- https://github.com/cosmostation/cosmosjs/tree/classic

```bash

npm install @cosmostation/[email protected]

```

### Yarn (Amino)

- https://github.com/cosmostation/cosmosjs/tree/classic

```bash

yarn add @cosmostation/[email protected]

```

## Import 

```js

import { Cosmos } from "../src/index.js";

```

## Usage

- You need to import Cosmos-sdk Protobuf message file as js. It is created by [gen-proto.sh](https://github.com/cosmos-client/cosmos-client-ts/blob/master/gen-proto.sh).

- @cosmostation/[email protected]+ is running above nodejs v14+

- You can run with this option for ES6.

```sh

$ node --es-module-specifier-resolution=node example/cosmoshub.js

```

- Import the message file that is converted from Cosmos-sdk proto.

```js

import message from "@cosmostation/cosmosjs/src/messages/proto";

```

- Stargate-final: Generate Cosmos address from mnemonic 

```js

const mnemonic = "..."

const chainId = "cosmoshub-4";

const cosmos = new Cosmos(lcdUrl, chainId);

cosmos.setPath("m/44'/118'/0'/0/0");

const address = cosmos.getAddress(mnemonic);

```

Generate both privKey and pubKeyAny that are needed for signing. 

```js

const privKey = cosmos.getECPairPriv(mnemonic);

const pubKeyAny = cosmos.getPubKeyAny(privKey);

```

Transfer ATOM to designated address. 

* Make sure to input proper type, account number, and sequence of the cosmos account to generate protobuf structure. You can get those account information on blockchain. Protobuf signing is different from Amino signing.

```js

cosmos.getAccounts(address).then(data => {

	// signDoc = (1)txBody + (2)authInfo

	// ---------------------------------- (1)txBody ----------------------------------

	const msgSend = new message.cosmos.bank.v1beta1.MsgSend({

		from_address: address,

		to_address: "cosmos1jf874x5vr6wkza6ahvamck4sy4w76aq4w9c4s5",

		amount: [{ denom: "uatom", amount: String(100000) }]		// 6 decimal places (1000000 uatom = 1 ATOM)

	});

	const msgSendAny = new message.google.protobuf.Any({

		type_url: "/cosmos.bank.v1beta1.MsgSend",

		value: message.cosmos.bank.v1beta1.MsgSend.encode(msgSend).finish()

	});

	const txBody = new message.cosmos.tx.v1beta1.TxBody({ messages: [msgSendAny], memo: "" });

	// --------------------------------- (2)authInfo ---------------------------------

	const signerInfo = new message.cosmos.tx.v1beta1.SignerInfo({

		public_key: pubKeyAny,

		mode_info: { single: { mode: message.cosmos.tx.signing.v1beta1.SignMode.SIGN_MODE_DIRECT } },

		sequence: data.account.sequence

	});

	const feeValue = new message.cosmos.tx.v1beta1.Fee({

		amount: [{ denom: "uatom", amount: String(5000) }],

		gas_limit: 200000

	});

	const authInfo = new message.cosmos.tx.v1beta1.AuthInfo({ signer_infos: [signerInfo], fee: feeValue });

	...

});

```

Sign transaction by using stdSignMsg and broadcast by using [/cosmos/tx/v1beta1/txs](https://v1.cosmos.network/rpc/v0.41.4) REST API

```js

const signedTxBytes = cosmos.sign(txBody, authInfo, data.account.account_number, privKey);

cosmos.broadcast(signedTxBytes).then(response => console.log(response));

```

Now it is time to transfer CW20 tokens via Cosmosjs! Copy the CW20 contract into the variable of cw20Contract. You can instantiate and execute cosmwasm contracts on JUNO. It is possible to create your own CW20 token [here](https://junomint.ezstaking.io/).

```js

cosmos.getAccounts(address).then(data => {

	// signDoc = (1)txBody + (2)authInfo

	// ---------------------------------- (1)txBody ----------------------------------

	let cw20Contract = "juno10rktvmllvgctcmhl5vv8kl3mdksukyqf2tdveh8drpn0sppugwwqjzz30z";

	let transferBytes = new Buffer('{"transfer":{"amount":"1","recipient":"juno1cx4nq77x3unvl2xsa9fmm9drxkexzkjnzwt2y7"}}');

	const msgExecuteContract = new message.cosmwasm.wasm.v1.MsgExecuteContract({

		sender: address,

		contract: cw20Contract,

		msg: transferBytes,

		funds: []

	});

	const msgExecuteContractAny = new message.google.protobuf.Any({

		type_url: "/cosmwasm.wasm.v1.MsgExecuteContract",

		value: message.cosmwasm.wasm.v1.MsgExecuteContract.encode(msgExecuteContract).finish()

	});

	const txBody = new message.cosmos.tx.v1beta1.TxBody({ messages: [msgExecuteContractAny], memo: "" });

});

```

In addition, you can query CW20 token balance using wasmQuery.

```js

cosmos.wasmQuery(

	'juno168ctmpyppk90d34p3jjy658zf5a5l3w8wk35wht6ccqj4mr0yv8s4j5awr',

	'{"balance": {"address": "juno1sautwkp7mzftvqtct3ugtq9xuuq680tzqzvf5g"}}'

).then(json => {

	let smartCode = json.result.smart;

	let decoded = new Buffer(smartCode, 'base64').toString();

	let parsed = JSON.parse(decoded);

	console.log("NETA balance: ", parsed.balance);

})

```

Official LCD url([https://api.cosmos.network](https://api.cosmos.network/node_info)).

- This rest server URL may be disabled at any time. In order to maintain stable blockchain service, it is recommended to prepare your rest server.

- Setting up the rest server: (https://docs.cosmos.network/master/core/grpc_rest.html#rest-server)

## Supporting Message Types (Updating...)

We will continue to update the protobuf signing structure.

## Documentation

This library is simple and easy to use. We don't have any formal documentation yet other than examples. Ask for help if our examples aren't enough to guide you

## Contribution

- Contributions, suggestions, improvements, and feature requests are always welcome

When opening a PR with a minor fix, make sure to add #trivial to the title/description of said PR.

## Cosmostation's Services and Community

- [Official Website](https://www.cosmostation.io)

- [Mintscan Explorer](https://www.mintscan.io)

- [Web Wallet](https://wallet.cosmostation.io)

- [Android Wallet](https://bit.ly/2BWex9D)

- [iOS Wallet](https://apple.co/2IAM3Xm)

- [Telegram - International](https://t.me/cosmostation)

- [Kakao - Koreans](https://open.kakao.com/o/g6KKSe5)

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

  

    
_Booyoun
💻 🐛 🚧

    
_JayB
💻 📖 🚧

    
_{billy rennekamp}
💻 🐛

    
_{Tony Phuong Nguyen}
💻

    
_{Tobias Schwarz}
💻

    
_{Scott Burch}
🚧

    
_{billy rennekamp}
🚧

    
_{Pierre Grimaud}
🚧

    
_{Taariq Levack}
🚧

    
_ɐʇɯon3ɹ
🚧

  

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!