Skip to content
This repository has been archived by the owner on Dec 14, 2022. It is now read-only.

oraichain/cosmosjs

Repository files navigation

Cosmostation logo   Oraichain logo

CosmosJS - Cosmos JavaScript Library (Deprecated)

⭐ Was developed: Oraichain

⚠️ This repository is now archived because Cosmjs developed by Cosmos is more widely used. This repo offers no different use cases, and shall be referenced as a studying tool for Web3.

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.

License

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

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

Oraichain's Services and Community

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Booyoun

💻 🐛 🚧

Le Duc Pham

💻

Thanh Tu Pham

💻

JayB

💻 📖 🚧

billy rennekamp

💻 🐛

Tony Phuong Nguyen

💻

Tobias Schwarz

💻

Scott Burch

🚧

billy rennekamp

🚧

Pierre Grimaud

🚧

Taariq Levack

🚧

This project follows the all-contributors specification. Contributions of any kind welcome!