&nbsp

CosmosJS - Cosmos JavaScript Library

⭐ Was developed: Cosmostation

⭐ Is developing: Oraichain

⭐ Will develop: Oraichain and the community

A JavasSript Open Source Library for Oraichain, Cosmos Network and other Cosmos based networks using the latest Cosmos SDK Stargate version upgrade.

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.

Installation

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

NPM

npm install @oraichain/cosmosjs

Yarn

yarn add @oraichain/cosmosjs

Import

NodeJS

const Cosmos = require("@oraichain/cosmosjs").default;

ES6 module

import Cosmos from "@oraichain/cosmosjs";

Usage

Cosmos: Generate Cosmos address from mnemonic

const Cosmos = require("@oraichain/cosmosjs").default;

const lcdUrl = "http://localhost:1317";
const chainId = "Oraichain";
const mnemonic = "foo bar";
const toAddr = "orai1x6xl5kls4xkmkv3rst5tndmxtqt0u8dxhnw7cg";
const amount = 10;
const fees = 100;

const message = Cosmos.message;
const cosmos = new Cosmos(lcdUrl, chainId);

cosmos.setBech32MainPrefix('orai');
const childKey = cosmos.getChildKey(mnemonic);
const address = cosmos.getAddress(mnemonic);

Transfer ORAI to designated address.

const msgSend = new message.cosmos.bank.v1beta1.MsgSend({
    from_address: cosmos.getAddress(childKey),
    to_address: toAddr,
    amount: [{ denom: cosmos.bech32MainPrefix, amount: String(amount) }]
});

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: ''
});

try {
    const response = cosmos.submit(childKey, txBody, 'BROADCAST_MODE_BLOCK', isNaN(fees) ? 0 : parseInt(fees)).then((response) => { console.log(response) });
} catch (ex) {
    console.log(ex);
}

Run the script

Assume the filename is demo.js. Run:

node demo.js

Supporting Message Types (Updating...)

Since we have Typescript, you can easily know which message types the library supports. We will update the list of message types often.

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