golos-lib-js

Golos.js - JavaScript API для блокчейна Golos.

Установка

$ npm install golos-lib-js --save

Полная документация здесь: https://github.com/golos-blockchain/libs/tree/master/golos-lib-js/docs

React и Webpack 5

В этом случае есть свои важные нюансы, описано здесь.

Использование без npm/yarn

Библиотека доступна на jsDelivr CDN и Unpkg CDN, и может быть использована в любых Web-страницах, даже если вы не используете Node.js. Просто добавьте ее через <script>, как показано в примере ниже. Проблем с полифиллами в этом случае нет, все включено в саму библиотеку. Все, что нужно, - это браузер.

<script src="./golos.min.js"></script>
<script>
// По умолчанию библиотека подключается к одной из нод майннета блокчейна Golos
golos.api.getAccounts(['ned', 'dan'], (err, response) => {
    console.log(err, response);
});
</script>

Сборка своей golos-lib-js (с загрузкой в npm)

Вы можете собрать свою собственную копию golos-lib-js, чтобы дополнительно проаудировать ее, или, к примеру, доработать для использования в специфических проектах\задачах.

См. здесь.

Загрузка модуля WebAssembly

См. здесь.

Протоколы WebSockets и HTTP

Библиотека поддерживает 2 транспортных протокола: ws/wss и http/https, для общения с нодами блокчейна Golos. Данные внутри библиотеки передаются в формате JSON-RPC.

Рекомендуемые ноды:

wss://api-golos.blckchnd.com/ws
wss://api.aleksw.space/ws
wss://golos.lexai.host/ws

https://api-golos.blckchnd.com/
https://api.aleksw.space/
https://golos.lexai.host/

golos.config.set('websocket','wss://golos.lexai.host/ws');

или

golos.config.set('websocket','https://golos.lexai.host/');

Примеры

Проголосовать за пост или комментарий:

var golos = require('golos');

var wif = golos.auth.toWif(username, password, 'posting');
golos.broadcast.vote(wif, voter, author, permlink, weight, (err, result) => {
    console.log(err, result);
});

Получить данные об аккаунтах:

golos.api.getAccounts(['ned', 'dan'], (err, result) => {
    console.log(err, result);
});

Прочие примеры см. в документации.

Issues

Если вы нашли какой-то баг, пожалуйста, сообщите об этом, создав issue!

Лицензия

MIT