Eosblockchain NPM

EOS Blockchain

npm

eosblockchain is a Javascript library based on EosJS developed to for integrating with EOSIO-based blockchains for ease of use API's using the EOSIO Nodeos RPC API. The documentation for eosjs is structured in the following way:

NPM

The official distribution package can be found at NPM

Add dependency to your project

yarn add eosblockchain

npm install --save eosblockchain

Connection to the Blockchain node

init() method connects to the EOSIO Nodeos RPC API url and private key of the account to implement the digital signature of the transitions.

const eos = require('eosblockchain');

var options = {
    url: 'https://api.testnet.eos.io',
    signatureKey: '5K1i8x6QE8nEUaJTvhtWZsy6r9b3tPWrSV2dexBhmQfRBLFHFoT' 
};

eos.init(options);

Run a Smart Contract action

run () method performs a network contract action, with the authorized account.

var example_data = {
    data: '2020-05-08',
    lat: 48.4567,
    lng: 16.6789
    value: 18.2
};

eos.run(myaccount, 'action', example_data, (err, result) => {

    if (err) {
        ....
    } else {
        ....
    }

});

Read data from a table of a Smart Contract

getTable() methods reads all data from a table of a Smart Contract with the authorized account.

var options = {
    table : 'exampletable',     // name of table
    limit: -1                   // number of records 
};

eos.getTable(myaccount, options, (error, response) => {
    if (err) {
        console.error('no data');
    } else {
        console.log('OK.');
    }
})

Obtain a Public / Private key pair

getKeys() generates a public / private key pair

    getKeys(keys => {
        console.log(keys);    
    });

Create an Account

Create an account in the blockchian network

    var options = {
        name: '',               // blank for a random name otherwise the maximum length must be 12 characters
        symbol: 'EOS',
        ram: 10000,             // undefined set default value = 8192
        stake_net: '1.000',     // undefined set default value = 1.000
        stake_cpu: '1.000'      // undefined set default value = 1.000
    };

    eos.createAccount(options, (err, account, result) => {
                      
        if (err) {
            throw err;
        };

        console.table(account);
        console.log('Result ---- \n' + JSON.stringify(result));

    });