cosjs

A js sdk to interact with coschain for human beings.

install

npm i @coschain/cosjs --save

In browser:

<script src="https://cdn.jsdelivr.net/npm/@coschain/cosjs/dist/cosjs.min.js"></script>
<script>
    let cos = new Cos("test", "https://testnode.contentos.io");

    (async () => {
      let result = await cos.wallet.accountInfo("initminer");
      console.log(result);
    })();
</script>

Usage

choose different environment

for testnode

const Cos = require('@coschain/cosjs');

let cos = new Cos("test", "https://testnode.contentos.io");

for mainnode

const Cos = require('@coschain/cosjs');

let cos = new Cos("main", "https://mainnode.contentos.io");

Example: transfer

const Cos = require('@coschain/cosjs');

let cos = new Cos("test", "https://testnode.contentos.io");

cos.wallet.addAccount("alice", "herPrivKey");


(async() => {
    let result = await cos.wallet.transfer("alice", "bob", "1.000000", "memo");
    console.log(result);
})();

Example: contract call

I have deployed a simple hello contract on testnode. The contract source

const Cos = require('@coschain/cosjs');

let cos = new Cos("test", "https://testnode.contentos.io");

cos.wallet.addAccount("alice", "herPrivKey");


(async() => {
  let result = await cos.wallet.contractCall("alice", "initminer", "hello", "greet", "[]", "0.000000");
  console.log(result.invoice);
})();

tips

1. When trying to call a method of contract, the contract's creator should be known.
2. The parameter args is a stringify json. Just like "[\"COC\", \"COC\", 10000000, 3]".
3. Deploying or calling a contract is a stamina-bound operation. You can stake some cos to acquire more stamina before calling a contract.

For stake cos

(async() => {
  await cos.wallet.cosToStake("initminer", "1.000000", "initminer");
})();

Example: query table

const Cos = require('@coschain/cosjs');

let cos = new Cos("test", "https://testnode.contentos.io");

(async () => {
  let result = await cos.wallet.queryTable("liuxingfeiyu", "kryptontest", "arenas", "creator", '', 30, false);
  console.log(result);
})();

Example: generate a key-pair with a mnemonic

const Cos = require('@coschain/cosjs');
let cos = new Cos("", "");

let [pubkey, privkey, mnemonic] = cos.wallet.generateKeysWithMonemonic();
console.log(pubkey, privkey, mnemonic);

Example: generate a key-pair from a mnemonic

const Cos = require('@coschain/cosjs');
let cos = new Cos("", "");

let [pubkey, privkey] = cos.wallet.generateKeysFromMnemonic("foil confirm transfer resource use outer rack earth present lawsuit flock clay post unlock zoo muffin truck pretty across sibling wild next man fresh");
console.log(pubkey, privkey);

About

It is a wrapper for cos-grpc-js. The module is designed for Node.js and browser.

Wallet Apis

• addAccount(name: string, privateKey: string)
• generateKeysFromMnemonic(words: string): [string, string]
• generateKeysWithMonemonic(): [string, string, string]
• accountInfo(name: string, raw: ?boolean)
• bpInfo(bp: string, raw: ?boolean)
• transactionInfo(trxId: string, raw: ?boolean)
• chainInfo(raw: ?boolean)
• blockProducerList(start: raw_type.vest, limit: number, lastBlockProducer: grpc.BlockProducerResponse, raw: ?boolean)
• createAccount(creator: string, newAccount: string, pubkey: string)
• transfer(sender: string, receiver: string, amount: string, memo: string)
• cosToVest(account: string, amount: string)
• vestToCos(account: string, amount: string)
• cosToStake(account: string, amount: string, toAccount: string)
• stakeToCos(account: string, amount: string, toAccount: string)
• post(sender: string, title: string, content: string, tagsStr: string)
• reply(sender: string, parent_uuid: string, content: string)
• vote(sender: string, idx: string)
• contractCall(caller: string, owner: string, contract: string, method: string, args: string, payment: string)
• voteToBlockProducer(voterValue: string, bpValue: string, cancel: boolean)
• queryTable(owner: string, contract: string, table: string, field: string, begin: string, limit: number, reverse: boolean)
• delegateVest(sender: string, receiver: string, amount: string, expiration: number)
• unDelegateVest(sender: string, orderId: number)
• vestDelegationOrderList(account: string, limit: number, is_lender: boolean)