eosjs中文手冊[v20]——EOS區塊鏈的JavaScript開發包
阿新 • • 發佈:2018-12-21
eosjs是訪問EOS區塊鏈的JavaScript開發包,它通過RPC API訪問EOS節點,
同時包含了金鑰簽名、交易序列化等本地操作。
新版的nodeos需要使用eosjs v20版本訪問,中文文件由匯智網翻譯整理,
訪問地址:eosjs v20 中文手冊
引入eosjs包
在ES模組中使用import引入eosjs包,例如:
import { Api, JsonRpc, RpcError } from 'eosjs'; import JsSignatureProvider from 'eosjs/dist/eosjs-jssig'; // development only
在nodejs的commonjs模組中,使用require引入eosjs包,例如:
const { Api, JsonRpc, RpcError } = require('eosjs'); const JsSignatureProvider = require('eosjs/dist/eosjs-jssig'); // development only const fetch = require('node-fetch'); // node only; not needed in browsers const { TextEncoder, TextDecoder } = require('util'); // node only; native TextEncoder/Decoder const { TextEncoder, TextDecoder } = require('text-encoding'); // React Native, IE11, and Edge Browsers only
簽名提供器
eosjs中的簽名提供器負責對交易進行簽名。例如:
const defaultPrivateKey = "5JtUScZK2XEp3g9gh7F8bwtPTRAkASmNrrftmx4AxDKD5K4zDnr"; // useraaaaaaaa
const signatureProvider = new JsSignatureProvider([defaultPrivateKey]);
目前eosjs中包含的JsSignatureProvider在記憶體中管理私鑰,在瀏覽器裡使用
這個簽名提供器是不安全的,僅限開發環境使用。
JSON-RPC呼叫
JsonRpc
const rpc = new JsonRpc('http://127.0.0.1:8888', { fetch });
API
在瀏覽器中使用Api
類時,需要宣告textDecoder和textEncoder:
const api = new Api({ rpc, signatureProvider, textDecoder: new TextDecoder(), textEncoder: new TextEncoder() });
交易提交
使用Api
例項的transact()
方法提交一個交易到區塊鏈上,例如:
(async () => {
const result = await api.transact({
actions: [{
account: 'eosio.token',
name: 'transfer',
authorization: [{
actor: 'useraaaaaaaa',
permission: 'active',
}],
data: {
from: 'useraaaaaaaa',
to: 'useraaaaaaab',
quantity: '0.0001 SYS',
memo: '',
},
}]
}, {
blocksBehind: 3,
expireSeconds: 30,
});
console.dir(result);
})();
transact()的第二個引數是一個選項物件,可以包含以下欄位:
- broadcast:是否廣播交易,預設值:true
- blocksBehind:TAPOS欄位,節點用來判斷交易是否超時
- expiresSeconds:TAPOS欄位,節點用來判斷交易是否超時
錯誤處理
使用RpcError
來處理RPC錯誤:
try {
const result = await api.transact({
...
} catch (e) {
console.log('\nCaught exception: ' + e);
if (e instanceof RpcError)
console.log(JSON.stringify(e.json, null, 2));
}
匯智網原創翻譯,轉載請標明出處。這裡是eosjs中文手冊v20
- java以太坊開發教程,主要是針對java和android程式設計師進行區塊鏈以太坊開發的web3j詳解。
- python以太坊,主要是針對python工程師使用web3.py進行區塊鏈以太坊開發的詳解。
- php以太坊,主要是介紹使用php進行智慧合約開發互動,進行賬號建立、交易、轉賬、代幣開發以及過濾器和交易等內容。
- 以太坊入門教程,主要介紹智慧合約與dapp應用開發,適合入門。
- 以太坊開發進階教程,主要是介紹使用node.js、mongodb、區塊鏈、ipfs實現去中心化電商DApp實戰,適合進階。
- C#以太坊,主要講解如何使用C#開發基於.Net的以太坊應用,包括賬戶管理、狀態與交易、智慧合約開發與互動、過濾器和交易等。
- EOS教程,本課程幫助你快速入門EOS區塊鏈去中心化應用的開發,內容涵蓋EOS工具鏈、賬戶與錢包、發行代幣、智慧合約開發與部署、使用程式碼與智慧合約互動等核心知識點,最後綜合運用各知識點完成一個便籤DApp的開發。
- java比特幣開發教程,本課程面向初學者,內容即涵蓋比特幣的核心概念,例如區塊鏈儲存、去中心化共識機制、金鑰與指令碼、交易與UTXO等,同時也詳細講解如何在Java程式碼中整合比特幣支援功能,例如建立地址、管理錢包、構造裸交易等,是Java工程師不可多得的比特幣開發學習課程。
- php比特幣開發教程,本課程面向初學者,內容即涵蓋比特幣的核心概念,例如區塊鏈儲存、去中心化共識機制、金鑰與指令碼、交易與UTXO等,同時也詳細講解如何在Php程式碼中整合比特幣支援功能,例如建立地址、管理錢包、構造裸交易等,是Php工程師不可多得的比特幣開發學習課程。
- tendermint區塊鏈開發詳解,本課程適合希望使用tendermint進行區塊鏈開發的工程師,課程內容即包括tendermint應用開發模型中的核心概念,例如ABCI介面、默克爾樹、多版本狀態庫等,也包括代幣發行等豐富的實操程式碼,是go語言工程師快速入門區塊鏈開發的最佳選擇。