@hiveio/workerbee
v1.27.6-rc9
Published
Hive automation library based on the wax and beekeeper
Downloads
18
Keywords
Readme
WorkerBee
Hive automation library based on the wax and beekeeper
Install
This is a Node.js module available through the npm registry.
Before installing, download and install Node.js. Node.js 18 or higher is required.
Installation is done using the
npm install
command:
npm install @hiveio/workerbee
If you want to use development versions of our packages, set @hiveio
scope to use our GitLab registry:
echo @hiveio:registry=https://gitlab.syncad.com/api/v4/groups/136/-/packages/npm/ >> .npmrc
npm install @hiveio/workerbee
Usage
Iterating indefinitely over new blocks
import WorkerBee from "@hiveio/workerbee";
const bot = new WorkerBee();
bot.on("error", console.error);
await bot.start();
for await(const { block, number } of bot)
console.info(`Got block #${block.block_id} (${number})`);
Wait for the next block using observer
import WorkerBee from "@hiveio/workerbee";
const bot = new WorkerBee();
bot.on("error", console.error);
await bot.start();
const block = await new Promise(blockResolve => {
bot.once("block", blockResolve);
}); // Get one latest block
console.info(`Waiting for block: #${block.number + 1}`);
const observer = bot.observe.block(block.number + 1);
observer.subscribe({
next() {
console.info('Block detected');
}
});
Observe given account for operations in blockchain
import WorkerBee from "@hiveio/workerbee";
const bot = new WorkerBee();
bot.on("error", console.error);
await bot.start();
const observer = bot.observe.accountOperations("gtg");
observer.subscribe({
next(op) {
console.info(op);
}
});
Observe given account for full manabar regeneration
import WorkerBee from "@hiveio/workerbee";
const bot = new WorkerBee();
bot.on("error", console.error);
await bot.start();
const observer = bot.observe.accountFullManabar("gtg");
observer.subscribe({
next(acc) {
console.info(acc.voting_manabar); // { "current_mana": "0", "last_update_time": 0 }
}
});
Broadcast and observe transaction in blockchain
import WorkerBee from "@hiveio/workerbee";
import beekeeperFactory from "@hiveio/beekeeper";
const beekeeper = await beekeeperFactory();
const session = await beekeeper.createSession("my.salt");
const { wallet } = await session.createWallet("w0", "mypassword");
const publicKey = await wallet.importKey("5JkFnXrLM2ap9t3AmAxBJvQHF7xSKtnTrCTginQCkhzU5S7ecPT");
const bot = new WorkerBee();
bot.on("error", console.error);
await bot.start();
// Build transaction
const transaction = await bot.chain.createTransaction();
transaction.pushOperation({
vote: {
voter: "otom",
author: "c0ff33a",
permlink: "ewxhnjbj",
weight: 2200
}
});
transaction.sign(wallet, publicKey);
// Broadcast our transaction with custom internal expiration time
const observer = await bot.broadcast(transaction);
// Observe if our transaction has been applied
observer.subscribe({
next(tx) {
console.info(tx, "applied in blockchain");
},
error() {
console.error("Transaction observation time expired");
}
});
API
See API definition in our Wiki
Support and tests
Tested on the latest Chromium (v117) and Node.js v18.19.0
Automated CI test runs are available.
To run the tests on your own, clone the Wax repo and install the dependencies and then compile the project:
sudo npm install -g pnpm
pnpm install
Compile source:
npm run build
Then run tests:
npm run test
License
See license in the LICENSE.md file