JavaScript SDK

iost.js is the JavaScript SDK that is used to interact with the IOST blockchain. It can be used in web browsers and on the NodeJS platform. It can send transactions, view account information, get block data, interface with storage, etc.

Github Repository

• https://github.com/iost-official/iost.js

Installation – NodeJS Project

  npm install iost

Installation – Content Delivery Network

  <script type="text/javascript" src="https://cdn.jsdelivr.net/npm/[email protected]/dist/iost.min.js"></script>

Example Code

const IOST = require('iost')

// use RPC
const rpc = new IOST.RPC(new IOST.HTTPProvider("http://localhost:30001"));
rpc.blockchain.getChainInfo().then(console.log);

// init iost sdk
let iost = new IOST({ // will use default setting if not set
    gasRatio: 100,
    gasLimit: 2000000,
    delay:0,
}, new IOST.HTTPProvider('http://localhost:30001'));

let account = "abc";
let kp = new IOST.KeyPair(/* your private key in type Buffer */);

iost.setPublisher(account, kp);

// send a call
let handler = iost.callABI("iost.token", "transfer", ["iost", "form", "to", "1000.000"]);

handler
    .onPending(console.log)
    .onSuccess(console.log)
    .onFailed(console.log)
    .send()
    .listen(); // if not listen, only onPending or onFailed (at sending tx) will be called

API Calls

Storage

        storage.put(k, v);

        storage.has(k);

        storage.get(k);

        storage.del(k);
  
        storage.mapPut(k, f, v);

        storage.mapGet(k, f);
 
        storage.mapHas(k, f);

        storage.mapKeys(k);
 
        storage.mapLen(k);

        storage.mapDel(k, f);
 
        storage.globalHas(c, k);

        storage.globalGet(c, k);
 
        storage.globalMapGet(c, k, f);

        storage.globalMapHas(c, k, f);
 
        storage.globalMapKeys(c, k);
  
        storage.globalMapLen(c, k);
 

Blockchain

        
        blockchain.deposit(from, amount, "memo");
   
        blockchain.withdraw(to, amount, "memo");
 
        blockchain.blockInfo();
 
        block;

        tx;

        blockchain.txInfo();
 
        blockchain.contextInfo();
 
        blockchain.contractName();

        blockchain.publisher();

        blockchain.receipt(data);