thinkium-web3js
v1.2.0-app
Published
Thinkium JavaScript API, middleware to talk to a thinkium node over RPC
Downloads
20
Readme
Installation
npm
npm install thinkium-web3js
Yarn
yarn add thinkium-web3js
As a Browser module
- Include
web3.min.js
in your html file. (not required for the meteor package)
Usage
Use the web3
object directly from the global namespace:
var Web3 = require('thinkium-web3js');
var web3 = new Web3();
Set a provider (HttpProvider
let rpcUrl = 'https://rpcproxy.thinkium.org';
web3.setProvider(new web3.providers.HttpProvider(rpcUrl));
There you go, now you can use it:
var account = web3.thk.GetAccount(chainId, address);
var balance = account.balance;
You can find more examples in the example
directory.
Usage
1. Get account info
method: web3.thk.GetAccount
params:
| name | type | required| description | | :------:| :------: | :------: | :------: | | chainId | string | true | chain id | | address | string | true | account address |
response:
| name | type | required| description |
| :------:| :------: | :------: | :------: |
| address | string | true | account address |
| nonce | int | true | transactions count |
| balance| bigint | true | balance of tkm |
| storageRoot| string | false | |
|codeHash| string | false | |
example:
var response = web3.thk.GetAccount("2", "0x2c7536e3605d9c16a7a3d7b1898e529396a65c23");
response:
{
"address": "0x2c7536e3605d9c16a7a3d7b1898e529396a65c23",
"balance": 9.99999985e+26,
"codeHash": null,
"nonce": 43,
"storageRoot": null
}
2. send transaction
method: web3.thk.SendTx
params:
| name | type | required| description | | :------:| :------: | :------: | :------: | | Transaction | dict | true | transaction detail |
Transaction:
| name | type | required| description |
| :------:| :------: | :------: | :------: |
| chainId | string | true | chain id |
| fromChainId | string | true | from chain id |
| toChainId | string | true | to chain id |
|from | string | true | from account address |
|to | string | true | receiver address |
| nonce | string | true | transaction count |
| value | string | true | transfer amount |
| input | string | true | encoded params |
| sig | string | true | signature of the transaction |
| pub | string | true | account public key |
response:
| name | type | required| description | | :------:| :------: | :------: | :------: | | TXhash | string | true | transaction hash |
example:
var response = web3.thk.SendTx({
chainId: '2',
fromChainId: '2',
toChainId: '2',
from: '0x0000000000000000000000000000000000000000',
to: '0x0e50cea0402d2a396b0db1c5d08155bd219cc52e',
nonce: '1',
value: '0',
input: '0xc3bea9af000000000000000000000000ca35b7d915458ef540ade6068dfe2f44e8fa733c',
sig: '0x7d5c7b6b28dd66bada7cfb153fe03433deb331cc74ca82de3ddf49708f1174895404682fcb9bcb30fdb7f6d041b78c56d87e18df1ca6e7e2bd75e38a6a1c8d631c',
pub: '0x044e3b81af9c2234cad09d679ce6035ed1392347ce64ce405f5dcd36228a25de6e47fd35c4215d1edf53e6f83de344615ce719bdb0fd878f6ed76f06dd277956de'
});
response:
{
"TXhash": "0x22024c2e429196ac76d0e557ac0cf6141f5b500c56fde845582b837c9dab236b"
}
3. get transaction info by hash
method: web3.thk.GetTransactionByHash
params:
| name | type | required| description | | :------:| :------: | :------: | :------: | | chainId | string | true | chain id | |hash | string | true | transaction hash |
response:
| name | type | required| description | | :------:| :------: | :------: | :------: | | Transaction | dict | true | transaction details | | root | string | true | Save the current state of the "account" when the receive object is created | | status | int | true | Transaction status: 1: success, 0: fail | | logs | array[dict] | false | An array of log objects generated by this transaction | | transactionHash | string | true | transaction hash | | contractAddress | string | true | contract address | | out | string | true | Call to return result data |
Transaction:
| name | type | required| description | | :------:| :------: | :------: | :------: | | chainID | int| true | chain id | | from | string | true | from address | | to | string | true | receiver address | | nonce | string | true | The number of previous transactions by the originator of the transaction | | val | string | true | Transfer amount | | input | string | true | Parameters when calling contracts |
example:
var response = web3.thk.GetTransactionByHash('1', '0xca222630130bad1555ad633d67d2beefbf405d36fdc3e1abd4260f201284292c');
response:
{
"tx": {
"chainid": 1,
"from": "0x853d5281d92cc5c8d0d1bce1f2f7b125ca4e09e7",
"to": "0x2f9bbce6f7d314fbe2b59901d0653a443bc11edd",
"nonce": 24,
"value": 40000000000000000000,
"input": "0x88ffe867",
"hash": "",
"uselocal": false,
"extra": "0x",
"timestamp": 0
},
"root": "eyJmZWUiOiI3MDM1NTIwMDAwMDAwMDAwMCIsInJvb3QiOm51bGx9",
"status": 1,
"logs": [
{
"address": "0x2f9bbce6f7d314fbe2b59901d0653a443bc11edd",
"blockNumber": "0x5aacf3",
"data": "0x000000000000000000000000853d5281d92cc5c8d0d1bce1f2f7b125ca4e09e70000000000000000000000000000000000000000000000022b1c8c1227a00000000000000000000000000000000000000000000000000000000000005e65d45a",
"logIndex": "0x0",
"topics": [
"0xaba4f973c8f45a52365c8348704e79653e4b58ebd452f2d2115423a62ef7a3e1"
],
"transactionHash": "0xca222630130bad1555ad633d67d2beefbf405d36fdc3e1abd4260f201284292c",
"transactionIndex": "0x0"
}
],
"transactionHash": "0xca222630130bad1555ad633d67d2beefbf405d36fdc3e1abd4260f201284292c",
"contractAddress": "0x0000000000000000000000000000000000000000",
"out": "0x",
"gasUsed": 175888,
"gasFee": "70355200000000000",
"blockHeight": 5942515
}
4. Get chain information
method: web3.thk.GetStats
params:
| name | type | required| description | | :------:| :------: | :------: | :------: | | chainId | string | true | chain id |
response:
| name | type | required| description | | :------:| :------: | :------: | :------: | | currentheight |bigint | true | Current block height | | txcount | int | true | Total transactions | | tps | int | true | Transaction Per Second | | tpsLastEpoch | int | true | Number of transactions in the previous period | | lives | int | true | Survival time of the chain | | accountcount | int | true | Number of accounts | | epochlength | int | true | How many blocks does the current period contain | | epochduration | int | true | Running time of current period | | lastepochduration | int | true | Running time of last period | | currentcomm | array | true | The current members of the chain |
example:
var response = web3.thk.GetStats('103')
response
{
"accountcount": 0,
"currentcomm": [
"0xbfebdb4661c93456c29dcc22ea32340b6a0e400bef924923a53dfe22ad90cbd5069135ef591d65515aa40ef34970599cc7c331667db7f744e89fe8ec305ede9a",
"0x0df134ddc7bebb8abe61d8649a3054c107908719a4c5fa49be9ffb32037f84a0768d91bcd33e28c8c410760146eead90a72db6880c2d6eb5cac2f10d2be3563f",
"0x37e7ab457bf4d38a96c06f0fc616e001a0eac9f7b7e8407f97bfd39b30569f069541a27cae9e681aff9d50616970b6b554d0893b25561453f58dc6e174e8e70a",
"0x8c9cba550f746efcd98635fa6b300cd25ac08b54dda8f067dcba07bb4026c51478a1ac2dd5db3c89179ceab5f10d2f59d6d83f1f9ff652000a0c390b3fbc382e",
"0xfa1688066b16f61c72b02af5834a9bb79b746a962c8ed82d6f4afce1c5f7ac1987f291b6063e438d3b6c12856a677901878302b1a5865c837252f1db18cdbd2f",
"0x58c484fbb8d825e92b8e8d62c469e327fc8a55f2d521bb041d352ffb1a4e68cf1675c834e87daeea941f268601086c37df270a1048472a424b30af53053a34f7",
"0xcdda504db1913c22e961c3f1dfb07941f22b7a0f3b4d3e2a48bc69ad67c0061c21d793e75c35b8f8dcc3a733b8c051fed1ca8d157cea26a65c0bb3c00f8a59f5",
"0x70d6885ebb21b83377fcd6387f820b087753e5cbfc0bdb6dcd1b3f116680bbebf615441c55db54e36e587131fc9b645fca412b7c6b428d17bb8c24a1f3ae42c7",
"0xcd2eb869ab358cb7f56f0abcf50623eb46bdf63ef52986fdd377948a87b6e2bf667649b658f6e1705b81e9d4a3380dfdcaa122ab69686ad0d30959aadfa999e5",
"0x89b0bbcc4df1e4f1be61a527144491be88d86e09db48238ccb07cbd9af19728ff8143318d679184ee058cd57458206ae955d16e16ed5267bdb0819bf6c22c986",
"0x9b2c2ffb7e950275b1451a1833e885f555b3c05b02a0cb869427bf252c2eb44d2ac46de7c770f2c621b2118681d3fcfcdf8b38bccdb38622748fdba1b97e2780",
"0x7fa9213bf8027e846d2eb6e5b17f6caea7f80a1c0522f85927744e388afa756b21edcaab7d439b6661024225af1f9a5c3f8eab12a8a60402dc08147f697fe988",
"0x2010f9c48b2af6679a0821efb657a96fbd8d2621ad20e97ed93eaabaea408baf086ad0009ab235c490e66a11e3ea1924aeaba2955ea7d3f2f9cbd933d41df362",
"0xc1f4b9c3b129d88ff072aca7c958c57dbbcd3e1e47718990efa799989a5c16893b70bdc1d3af728169bc9cae5f0c1c22ae37c9aa3026789e1e68fb2f68920909",
"0xd9b5f2c6fafe7391e182a98194b972961a8b4e24afa0152f4da0df9f84bbadb496451dc0b7ff4332e311914a93f7c5f60f07953edcbeef8ccc1637157ee0d5c5",
"0x73bf86fbc73b5e6f12613a4eeeb8883a6af2d646bab8dd47e117f89d5a5c2369fc908b9003a1db5e4187a11245d61b23b73c2572326048d33860b5b0be9c03c1",
"0x59c9add6f7ae1d1cc5e79579f309b720b37da127f171ba0e65a3e083bb27698ff22ca505f3298acf70106344b1d07104db15e317f14822e341ecdc21a1e87929",
"0xb7023c7412e51ff1afa679756b354cf74578c93fbbad8eee2c0a2e60347eb4b857e6e45ab41444010e408e9548d749577c1e6f0301d0d14ee0d3844647761cd7",
"0x482c7b2e66aabbee8fad39d64faab09f2d0059e1193a5470ec21875cdbd17ce4986f180ab498620d768ef3cba031ee0b534eba21a4c581e3e0842548c5527748",
"0xe14da122de07cf0d1553fd91b729e6db6a68a103cf6eff190757f6b3bc34bcc88d2f7877d03ccb3e2be980dbe3b65dca6c10d9ae2823ecb4f8d88770b019f22f",
"0x7af07f8cfa74b9367a10b86eac1883fdbc9eab7814675d8bd7138ec6aa805dda80aa115c9ffe416429f87efb008d30f9c1eaf9c2a8cce274a3f05a7ed0b082ad",
"0x338035e5aa2c7ce1320c272c0c782c150a589f686767b483f044c746acd65d85af26b4a475ded3adc46cc1b2283f7b1f79ef877d3fef8f275a36e9c2a7bd23b9",
"0x842409950306aebbcc580bbfd044067e6bc2530cb3f426c1eea1c3b1fd48487e6e01d5392e5b5e2bde9145931c4451b22d779d805237d7b23ce934ecc3447065",
"0xf9828acc66c3e41ccc00a3683bf5417712a4914f12c1c709eec572483b189feebfcd5e718075e8bd56803243e8a637308c1e535fbe82ef8e6377a45aeeae56c8",
"0xccc192ed5565d43671c6c1acaf53fd95b9010abf2ba4263854756d6bcfa4d7d2e1fbd43bc1f63cab2f1c74e3956b6ce0d38ebcd555c8e3085a05037be7670731",
"0x567beb3b4827fbd138ee88592791efadb2a1ced4a57bf6f775b5950566169f19d16904f3c4a1f1f758843a5fba9e5052b97afa8f07de443869dee58700f72dc4",
"0x67023c6cffb20c1a213f2e038427936adc674c09d54ef1afb1dcfdc8b40a48a80f1ccb51718d3b5bd5d1303e2f365a364d31ce8b6de9f14f18fcde4d43ddfcad",
"0x250f3081d864de9796f4f9c505accc293f9ff7822c9d1ac4a5840981f486159121560eff795ae974c83971fb1f27e2984924934e9da43c9eda8423474398cd4f"
],
"currentheight": 1590270,
"epochduration": 2911,
"epochlength": 1000,
"gaslimit": 2500000,
"gasprice": "400000000000",
"lastepochduration": 2757,
"lives": 818243,
"tps": 0,
"tpsLastEpoch": 0,
"txcount": 2
}
5. Obtain the transaction information of the specified account within a certain height range on the corresponding chain
method: web3.thk.GetTransactions
params:
| name | type | required| description | | :------:| :------: | :------: | :------: | | chainId | string | true | chain id | | address | string | true | account address | | startHeight | string | true | start height | | endHeight | string | true | end height |
response:
| name | type | required| description | | :------:| :------: | :------: | :------: | | [] | []transactons | true | transaction array |
transactons:
| name | type | required| description | | :------:| :------: | :------: | :------: | | chainId | int | true | chain id | | from | string | true | from address | | to | string | true | receiver address | | nonce | int | true | transaction count | | value | int | true | transfer amount | | timestamp | int | true | transaction timestamp | | input | string | true | encode params | | hash | string | true | transaction hash |
example:
var response = web3.thk.GetTransactions('2', "4fa1c4e6182b6b7f3bca273390cf587b50b47311", 50, 70);
response:
[
{
"chainid": 2,
"from": "0x2c7536e3605d9c16a7a3d7b1898e529396a65c23",
"to": "0x0000000000000000000000000000000000020000",
"nonce": 0,
"value": 0,
"input": "0x000000022c7536e3605d9c16a7a3d7b1898e529396a65c230000000000000000000000034fa1c4e6182b6b7f3bca273390cf587b50b4731100000000000456440101",
"hash": "0x0ea5dad47833fc6286357b6bd6c1a4e910def5f4432a1a59bde0f816c3dd18e0",
"timestamp": 1560425588
},
{
"chainid": 2,
"from": "0x2c7536e3605d9c16a7a3d7b1898e529396a65c23",
"to": "0x133c5bfef5d486052b061b44af113f20057341a8",
"nonce": 1,
"value": 0,
"input": "0xa9059cbb00000000000000000000000066261e3faf00ef1537b22f37d8db85f57066f58f0000000000000000000000000000000000000000000000000000000000004e20",
"hash": "0x1dbbda2d229db82ff12b3bea82d49225e6bebd645def4c06da157ddbe5660066",
"timestamp": 1560425596
}
]
6. call transaction
method: web3.thk.CallTransaction
params:
| name | type | required| description | | :------:| :------: | :------: | :------: | | Transaction | dict | true | transaction detail |
params:
| name | type | required| description | | :------:| :------: | :------: | :------: | | chainId | string | true | chain id | | fromChainId | string | true | from chain | | toChainId | string | true | to chain | | from | string | true | from account address | | to | string | true | receiver address | | nonce | string | true | transactions count of account | | value | string | true | transfer amount | | input | string | true | encoded params |
response:
| name | type | required| description | | :------:| :------: | :------: | :------: | | out | string | true | call result |
example:
var response = web3.thk.CallTransaction({
chainId: '2',
fromChainId: '2',
toChainId: '2',
from: '0x0000000000000000000000000000000000000000',
to: '0x0e50cea0402d2a396b0db1c5d08155bd219cc52e',
nonce: '22',
value: '0',
input: '0xe98b7f4d0000000000000000000000000000000000000000000000000000000000000001'
});
response:
{
"Transaction": {
"chainID": 2,
"from": "0x0000000000000000000000000000000000000000",
"to": "0x0e50cea0402d2a396b0db1c5d08155bd219cc52e",
"nonce": 2,
"value": 0,
"input": "0xe98b7f4d0000000000000000000000000000000000000000000000000000000000000001",
"hash": '',
"timestamp": 0
},
"root": null,
"status": 0,
"logs": null,
"transactionHash": "0x9936cab441360985fc9e27904f0767c1c39fe8e0edb83709a0cdad52470a4592",
"contractAddress": "0x0000000000000000000000000000000000000000",
"out": "0x"
}
7. get block info
method: web3.thk.GetBlockHeader
params:
| name | type | required| description | | :------:| :------: | :------: | :------: | | chainId | string | true | chain id | | height | string | true | the block height |
response:
| name | type | required| description | | :------:| :------: | :------: | :------: | | hash | string | true | block hash | | previoushash | string | true | previous block hash | | chainid | int | true | chain id | | height | int | true | block height | | mergeroot | string | true | Merge other chain transfer data hash | | deltaroot | string | true | inter-chain transfer hash | | stateroot | string | true | state-hash | | txcount | int | true | transaction count | | timestamp | int | true | timestamp |
example:
var response = web3.thk.GetBlockHeader('2', '30');
response:
{
"hash": "0x71603186004fd46d32cda0780c4f4cf77ce13b396b1b8132b2c632173441b9d2",
"previoushash": "0xd0f6e9c89eb6be655632911e3743b5a994423c3526653dc55b62ebea3ff56c43",
"chainid": 2,
"height": 30,
"mergeroot": "0xdddfde85423a0d7da064c1b5a8cc1ff18d4a209027ef95ecceae0e6ed8f7c1af",
"deltaroot": "0xdddfde85423a0d7da064c1b5a8cc1ff18d4a209027ef95ecceae0e6ed8f7c1af",
"stateroot": "0x0b672749b02da6bf8f3aa50238140ce7fae5af3e926d4eb06d4cfb707a90702e",
"txcount": 1,
"timestamp": 1547777358
}
8. Gets the transaction of the specified block
method: web3.thk.getBlockTxs
params:
| name | type | required| description | | :------:| :------: | :------: | :------: | | chainId | string | true | chain id | | height | string | true | the block height | | page | string | true | page index | | size | string | true | size of the page |
response:
| name | type | required| description | | :------:| :------: | :------: | :------: | | elections | dict | true | | | accountchanges | array | true | tansaction info |
accountchanges:
| name | type | required| description | | :------:| :------: | :------: | :------: | | chainid | string | true | chain id | | height | int| true | start height | | from | string| true | from account address | | to | string| true | receiver address | | nonce | int| true | transactions count | | value | int| true | transfer amount | | timestamp | int| true | transaction timestamp |
example:
var response = web3.thk.GetBlockTxs('2', '30', '1', '10');
response:
{
"elections": null,
"accountchanges": [
{
"chainId": 2,
"height": 30,
"from": "0x4fa1c4e6182b6b7f3bca273390cf587b50b47311",
"to": "0x4fa1c4e6182b6b7f3bca273390cf587b50b47311",
"nonce": 30,
"value": 1,
"input": "0x",
"hash": "0x4bff6fad0cd46599289e4e465987cfc94278363b12eca3f37572be8c2ce1b061",
"timestamp": 1547777358
}
]
}
9. compile contract
see test/contract/deploy_test.js
params:
var input = {
language: 'Solidity',
sources: {
'test.sol': { //contract file name
content: contractContent //contract codes
}
},
settings: {
outputSelection: {
'*': {
'*': ['*']
}
}
}
};
example:
var solc = require('solc');
function compileContract(contractContent) {
const input = {
language: 'Solidity',
sources: {
'test.sol': {
content: contractContent
}
},
settings: {
outputSelection: {
'*': {
'*': ['*']
}
}
}
};
const output = JSON.parse(solc.compile(JSON.stringify(input)));
return output.contracts['test.sol']
}
let contents = `pragma solidity >= 0.5.0;
contract HelloWorld {
uint256 age = 17;
string nickname = "Hello";
function getAge() public view returns (uint256 data){
return age;
}
function getNickname() public view returns (string memory data){
return nickname;
}
function setNickname(string memory data) public {
nickname = data;
}
}`;
const result = compileContract(contents)['HelloWorld'];
const contractAbi = result.abi;
const contractByteCode = result.evm.bytecode.object.slice(0, 2) === '0x' ? result.evm.bytecode.object : '0x' + result.evm.bytecode.object;
10.1 deploy contract
see test/contract/deploy_test.js
example:
function deployContract(abi, codes) {
let contracts = web3.thk.contract(abi).new({data: codes});
console.log("contracts: " + JSON.stringify(contracts, null, 1));
if (contracts.transactionHash) {
sleep(5);
const res = web3.thk.GetTransactionByHash(web3.thk.defaultChainId, contracts.transactionHash);
return res.contractAddress
}
return '';
}
const contractAddress = deployContract(contractAbi, contractByteCode);
console.log('contractAddress: ', contractAddress);
console.log('contractAbi: ', contractAbi);
10.2 new contract instance and call contract methods
// get new instance of the contract with giving the abi and contract address
function fromAbi(abi, address) {
return web3.thk.contract(abi, address).at(address);
}
const helloWorld = fromAbi(contractAbi, contractAddress);
// call method 'setNickname'
helloWorld.setNickname("world");
sleep(5); // wait a moment for the transaction executed
console.log("contract function res:", helloWorld.getNickname());
11. check machine health
method: web3.thk.Ping
params:
| name | type | required| description | | :------:| :------: | :------: | :------: | | address | string | true | ip+port |
response:
| name | type | required| description | | :------:| :------: | :------: | :------: | | nodeId | string | true | node id | | version | string | true | version| | isDataNode | bool | true | whether data-node | | dataNodeOf | int | true | | | lastMsgTime | int64 | true | last message time | | lastEventTime | int64 | true | last event time | | lastBlockTime | int64 | true | last block time | | overflow | bool | true | over flow | | lastBlocks |map | true | last block | | opTypes | map | true | type |
example:
var response = web3.thk.Ping("192.168.1.13:22010")
response:
{
"nodeId": "0x5e17128ba224a96d6e84be0c7f899febea26c55c78940610d78a0d22dbd0ab03cc3233491de0b5eb770dbf850b509bd191723df4fc40520bcbab565d46543d6e",
"version": "V1.0.0",
"isDataNode": true,
"dataNodeOf": 0,
"lastMsgTime": 1560850367,
"lastEventTime": 1560850367,
"lastBlockTime": 1560850367,
"overflow": false,
"lastBlocks": {
"0": 159927
},
"opTypes": {
"0": [
"DATA"
]
}
}
12. Proof of check generation
method: web3.thk.RpcMakeVccProof
params:
| name | type | required| description | | :------:| :------: | :------: | :------: | | transaction | dict | true | transaction info |
transaction:
| name | type | required| description | | :------:| :------: | :------: | :------: | | chainId | string | true | chain id | | fromChainId | string | true | from chain id | | toChainId | string | true | from chain id | | from | string | true | from address | | to | string | true | to address | | nonce | string | true | The number of previous transactions by the originator of the transaction | | value | string | true | Transfer amount | | ExpireHeight | int | true | Expiration height |
response:
| name | type | required| description | | :------:| :------: | :------: | :------: | | input | string | true | Generated check proof |
example:
let obj = {
chainId: '2',
from: '0x2c7536e3605d9c16a7a3d7b1898e529396a65c23',
to: '0x2c7536e3605d9c16a7a3d7b1898e529396a65c23',
fromChainId: '2',
toChainId: '3',
value: '1000000000000000',
expireheight: '54223',
nonce: '47'
};
var response = web3.thk.RpcMakeVccProof(obj)
response:
{
"input": "0x95000000022c7536e3605d9c16a7a3d7b1898e529396a65c23000000000000002f000000032c7536e3605d9c16a7a3d7b1898e529396a65c23000000000000d3cf07038d7ea4c6800002a2d30bc06dc891383f7c61c310c9109aae0407508ced3f5562670b13cc5f093777a65a0193941093a1b6df76df5387752a24b904aac80067c3aa0ea7eb1b40074d4a30889e0083412744c2000080809409934080c20202808100018187aa9f339cf1ba6ffe6986f68c639a835fac453ac37d0df6e72091b1cd1cd30001019424930080c20000c02c83b4898418ce3324a2deeacf5848d49981f8ad2ad60c810c23e78e840dbc1781000524ac33cdd9e9bf0cbdfc4d357d81d5d1638dd7516ec38d779300f5f6e76d9b7ee0eccda334e611eb97288b59a36e78b25eb15746f593036a56ab50f89174f60062e715f8969d49b1ada75ce66977ab01219068e1adcf104eb328442fa3002759eca078605c1b0ad6ff4323f7c23307585d3dddd504f96e7a7f722f9802d2a1b7130047aeaaba37848d7c13a6df0328565e15ba9401b2485ac662423afcc01bb4000110"
}
13. Generate proof of cancellation check
method: web3.thk.MakeCCCExistenceProof
params:
| name | type | required| description | | :------:| :------: | :------: | :------: | | transaction | dict | true | transaction info |
transaction:
| name | type | required| description | | :------:| :------: | :------: | :------: | | chainId | string | true | chain id | | fromChainId | string | true | from chain id | | toChainId | string | true | to chain id | | from | string | true | from address | | to | string | true | receiver address | | nonce | string | true | The number of previous transactions by the originator of the transaction | | value | string | true | Transfer amount | | ExpireHeight | int | true | Expiration height |
response:
| name | type | required| description | | :------:| :------: | :------: | :------: | | input | string | true | encoded params | | existence | bool | true | Have you ever deposited a check |
example:
let obj = {
chainId: '2',
from: '0x2c7536e3605d9c16a7a3d7b1898e529396a65c23',
to: '0x2c7536e3605d9c16a7a3d7b1898e529396a65c23',
fromChainId: '2',
toChainId: '3',
value: '1000000000000000',
expireheight: '54223',
nonce: '47'
}
var response = web3.thk.MakeCCCExistenceProof(obj)
response:
{
"existence": false,
"input": "0x95000000022c7536e3605d9c16a7a3d7b1898e529396a65c23000000000000002f000000032c7536e3605d9c16a7a3d7b1898e529396a65c23000000000000d3cf07038d7ea4c6800002a2d30bc06dc891383f7c61c310c9109aae0407508ced3f5562670b13cc5f093777a65a0193941093a1b6df76df5387752a24b904aac80067c3aa0ea7eb1b40074d4a30889e0083412744c2000080809409934080c20202808100018187aa9f339cf1ba6ffe6986f68c639a835fac453ac37d0df6e72091b1cd1cd30001019424930080c20000c02c83b4898418ce3324a2deeacf5848d49981f8ad2ad60c810c23e78e840dbc1781000524ac33cdd9e9bf0cbdfc4d357d81d5d1638dd7516ec38d779300f5f6e76d9b7ee0eccda334e611eb97288b59a36e78b25eb15746f593036a56ab50f89174f60062e715f8969d49b1ada75ce66977ab01219068e1adcf104eb328442fa3002759eca078605c1b0ad6ff4323f7c23307585d3dddd504f96e7a7f722f9802d2a1b7130047aeaaba37848d7c13a6df0328565e15ba9401b2485ac662423afcc01bb4000110"
}
14.get chain info
method: web3.thk.GetChainInfo
params:
| name | type | required| description | | :------:| :------: | :------: | :------: | | chainIds | []int | true | chain id(notice:get all if chainIds not present) |
response:
| name | type | required| description | | :------:| :------: | :------: | :------: | | [] | []chainInfo | true | chain info array |
chainInfo:
| name | type | required| description | | :------:| :------: | :------: | :------: | | chainId | int | true | chain id | | datanodes | []dataNode | true | data node array | | mode | int | true | mode | | parent | int | true | |
dataNode:
| name | type | required| description | | :------:| :------: | :------: | :------: | | dataNodeId | int | true | data node id | | dataNodeIp | string | true | data node ip | | dataNodePort | int | true | data node port |
example:
var response = web3.thk.GetChainInfo([])
response:
[
{
"chainId": 0,
"datanodes": [
{
"dataNodeId": "0x5e17128ba224a96d6e84be0c7f899febea26c55c78940610d78a0d22dbd0ab03cc3233491d0b5eb770dbf850b509bd191723df4fc40520bcbab565d46543d6e",
"dataNodeIp": "192.168.1.13",
"dataNodePort": 22010
}
],
"mode": 5,
"parent": 1048576
},
{
"chainId": 1,
"datanodes": [
{
"dataNodeId": "0x96dc94580e0eadd78691807f6eac9759b9964daa8b46da4378902b040e0eb102cb48413308d2131e9e5557321f30ba9287794f689854e6d2e63928a082e79286",
"dataNodeIp": "192.168.1.13",
"dataNodePort": 22014
}
],
"mode": 6,
"parent": 0
},
{
"chainId": 2,
"datanodes": [
{
"dataNodeId": "0xa93b150f11c422d8700554859281be8e34a91a859e0e021af186002c7e4a2661ea2467a63b417030d68e2fdddeb4342943dff13225da77124abf912fd092f71f",
"dataNodeIp": "192.168.1.13",
"dataNodePort": 22018
}
],
"mode": 6,
"parent": 0
},
{
"chainId": 3,
"datanodes": [
{
"dataNodeId": "0x783f4b2490461ecfd8ee8d3451e434de06bacb0ffff56de53a33fe545589094fa0b929eeaa62dc5203d1e831ccdd37d206d0b85b193921efb223bf0cb2f37b4c",
"dataNodeIp": "192.168.1.13",
"dataNodePort": 22022
}
],
"mode": 7,
"parent": 1
},
{
"chainId": 4,
"datanodes": [
{
"dataNodeId": "0x44c98ab831f3ca4553e491bba06753e959ceb55d43e18bc76539572feb1e0dbaf2fbfc19f571d6544e82be1c7c39760f6a023d4be4dcb9473dd580c731d03926 ",
"dataNodeIp": "192.168.1.13",
"dataNodePort": 22026
}
],
"mode": 7,
"parent": 1
}
]
15.get committee info
method: web3.thk.GetCommittee
params:
| name | type | required| description | | :------:| :------: | :------: | :------: | | chainId | string | true | chain id | | epoch | string | true | epoch |
response:
| name | type | required| description | | :------:| :------: | :------: | :------: | | chainId | int | true | chain id | | MemberDetails | []string | true | committees detail | | Epoch | int | true | epoch |
example:
var response = web3.thk.GetCommittee("1", "411")
response:
[
"0xe90a151759bf070969aae664e00502bb08568c85a73874492a3ec480c5178d5da29c790896fc62106e32d172819dec94202ff90f3b7ba3e6adf38508bc58cf43",
"0x3224de0da639511fec588d2e28f4472476b1600d003a10e38e0456426337624aaecd6636e5ce7ff95fc10746471ce7b680f664ccbf17057ca18c761706afa391",
"0xad88dc0c0cf7d9e4a62f97e81f33556f65abba96b3c7108a732ff20f1a23530ca7730a6885d91ac718e1bb6ebad5e18bf8b7a58b91cbf717b48b723c7ceedef6",
"0x8c7872c0c96a9f5b396120a0a45706678ab7a34c34a146ce9329c894f8cb9de41ec10edbf6b9c85796fd9e91d8d651a53578f164c8ee71a2d2cbfef9d5a4c6a4",
"0xdb3e5b5ea24e1d760a59cf22cfafeed5a4e57af2108fc0df3bf457a82f754264b3fdf9d77fcab306a9809ebcd76de91e382d912a90e3f37edf4eb04f3f036d0b",
"0x4ce2edd98452036c804f3f2eeef157672be2ccf647369eb42eb49ab9f428821f9990efde3cf7f16e4c64616c10b673077f4278c6dd2fc6021da8ad0085a522a2",
"0xd1f889690f8c75bbada89a4c8893b8bf6fe29be3b5c3d8a2d772024a340d59d375f39ed88498666a57da10af885ad63a414f8a10153fb739eb1ebfcef57cc883"
]