@axerunners/axed-rpc
v2.0.0
Published
AXE Client Library to connect to AXE Core (axed) via RPC
Downloads
33
Readme
axed-rpc
Axe Client Library to connect to Axe Core (axed) via RPC
Install
axed-rpc runs on node, and can be installed via npm:
npm install @axerunners/axed-rpc
Usage
RpcClient
Config parameters :
- protocol : (string - optional) - (default: 'https') - Set the protocol to be used. Either `http` or `https`.
- user : (string - optional) - (default: 'user') - Set the user credential.
- pass : (string - optional) - (default: 'pass') - Set the password credential.
- host : (string - optional) - (default: '127.0.0.1') - The host you want to connect with.
- port : (integer - optional) - (default: 9337) - Set the port on which perform the RPC command.
Promise vs callback based
require('@axerunners/axed-rpc/promise')
to have promises returnedrequire('@axerunners/axed-rpc')
to have callback functions returned
Examples
Config:
var config = {
protocol: 'http',
user: 'axe',
pass: 'local321',
host: '127.0.0.1',
port: 19337
};
Promise based:
var RpcClient = require('@axerunners/axed-rpc/promise');
var rpc = new RpcClient(config);
rpc.getRawMemPool()
.then(ret => {
return Promise.all(ret.result.map(r => rpc.getRawTransaction(r)))
})
.then(rawTxs => {
rawTxs.forEach(rawTx => {
console.log(`RawTX: ${rawTx.result}`);
})
})
.catch(err => {
console.log(err)
})
Callback based (legacy):
var run = function() {
var bitcore = require('@axerunners/axecore-lib');
var RpcClient = require('@axerunners/axed-rpc');
var rpc = new RpcClient(config);
var txids = [];
function showNewTransactions() {
rpc.getRawMemPool(function (err, ret) {
if (err) {
console.error(err);
return setTimeout(showNewTransactions, 10000);
}
function batchCall() {
ret.result.forEach(function (txid) {
if (txids.indexOf(txid) === -1) {
rpc.getRawTransaction(txid);
}
});
}
rpc.batch(batchCall, function(err, rawtxs) {
if (err) {
console.error(err);
return setTimeout(showNewTransactions, 10000);
}
rawtxs.map(function (rawtx) {
var tx = new bitcore.Transaction(rawtx.result);
console.log('\n\n\n' + tx.id + ':', tx.toObject());
});
txids = ret.result;
setTimeout(showNewTransactions, 2500);
});
});
}
showNewTransactions();
};
Help
You can dynamically access to the help of each method by doing
const RpcClient = require('@axerunners/axed-rpc');
var client = new RPCclient({
protocol:'http',
user: 'axe',
pass: 'local321',
host: '127.0.0.1',
port: 19337
});
var cb = function (err, data) {
console.log(data)
};
// Get full help
client.help(cb);
// Get help of specific method
client.help('getinfo',cb);
Contributing
Feel free to dive in! Open an issue or submit PRs.