Skip to content

ThinkiumGroup/web3.go

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
common
common
 
 
test
test
 
 
web3
web3
 
 
.gitattributes
.gitattributes
 
 
.gitignore
.gitignore
 
 
README.md
README.md
 
 
go.mod
go.mod
 
 

Repository files navigation

web3.go-thk

Installation

go get -u github.com/ThinkiumGroup/web3.go

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")
{
  "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:

transaction := util.Transaction{
ChainId: "2", FromChainId: "2", ToChainId: "2", From: "0x2c7536e3605d9c16a7a3d7b1898e529396a65c23",
To: "0x0000000000000000000000000000000000020000", Value: "0", Input: "0x000000022c7536e3605d9c16a7a3d7b1898e529396a65c23000000000000000a000000034fa1c4e6182b6b7f3bca273390cf587b50b4731100000000000456440101", Nonce: 10,
}
err = connection.Thk.SignTransaction(&transaction, privatekey)
txhash, err := connection.Thk.SendTx(&transaction)

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:

response := web3.thk.GetTransactionByHash("2", "0x3cbd7226fb9d4c9bbd27cdc230a647ecd19aa2997e23ab899778026093f45326")

response:

{
  "Transaction": {
    "chainID": 2,
    "from": "0x2c7536e3605d9c16a7a3d7b1898e529396a65c23",
    "input": "0x",
    "nonce": 42,
    "to": "0x6ea0fefc17c877c7a4b0f139728ed39dc134a967",
    "value": 2333
  },
  "blockHeight": 117354,
  "contractAddress": "0x0000000000000000000000000000000000000000",
  "logs": null,
  "out": "0x",
  "root": null,
  "status": 1,
  "transactionHash": "0x0000000000000000000000000000000000000000000000000000000000000000"
}

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("1")
{
  "accountcount": 0,
  "currentcomm": [
    "0xd1f889690f8c75bbada89a4c8893b8bf6fe29be3b5c3d8a2d772024a340d59d375f39ed88498666a57da10af885ad63a414f8a10153fb739eb1ebfcef57cc883",
    "0xe90a151759bf070969aae664e00502bb08568c85a73874492a3ec480c5178d5da29c790896fc62106e32d172819dec94202ff90f3b7ba3e6adf38508bc58cf43",
    "0x84385cc16d8e0a47909ee998d51370e5f56d7c85716e045c99760bedb180346da7d00b575ba23b76ffcd0969ae84e1e6b6943ec408f40b44825128577d8a895d",
    "0xd0c7107542af7e0019e1340a77a00131d60f49f5543de76b1d5768660e6d694b5dee3e206049bf0009d2859db0b7378240667d85eeb8138426efe9fd3568ebe3"
  ],
  "currentheight": 124262,
  "epochduration": 797,
  "epochlength": 300,
  "lastepochduration": 796,
  "lives": 242529,
  "tps": 0,
  "tpsLastEpoch": 0,
  "txcount": 10
}

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”, ”0x2c7536e3605d9c16a7a3d7b1898e529396a65c23”, ”50”,”100”)

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 connection = web3.NewWeb3(providers.NewHTTPProvider("192.168.1.13:8089", 10, false))
from := "0x2c7536e3605d9c16a7a3d7b1898e529396a65c23"
to := "0x6ea0fefc17c877c7a4b0f139728ed39dc134a967"
transaction := util.Transaction{
ChainId: "2", FromChainId: "2", ToChainId: "2", From: from,
To: to, Value: "2333", Input: "", Nonce: "1",
}
res, err := connection.Thk.CallTransaction(&transaction)

Response:

{
  "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("1","30")

response:

{
  "chainid": 1,
  "deltaroot": null,
  "hash": "0x6bd6a3d1068a3b748edc7ef70aee98749e33ddc3e03e10ca49dc4ca5fad4237c",
  "height": 30,
  "mergeroot": null,
  "previoushash": "0xfed93048d70bd961582bbd0498f109b78d471a90a3e7b1e0aa65b91f4982de97",
  "stateroot": "0xacf1890a60e805815cbf6e93fdb9f7a0184bc51290a39802e0c67e961ab41f35",
  "timestamp": 1560425446,
  "txcount": 0
}

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","433", "1", "10")

response:

{
  "elections": null,
  "accountchanges": [
    {
      "chainid": 2,
      "from": "0x2c7536e3605d9c16a7a3d7b1898e529396a65c23",
      "to": "0x66261e3faf00ef1537b22f37d8db85f57066f58f",
      "nonce": 11,
      "input": "0x",
      "hash": "0xf976d11b1a1593e242d5ed8ad77cf6df1b12c5a9c3e50d4c98fbf2ace7738bb3",
      "value": 10000000000000000000,
      "timestamp": 1560426508
    }
  ]
}

10. 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"
    ]
  }
}

11. 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:

var response = web3.thk.RpcMakeVccProof("2","0x2c7536e3605d9c16a7a3d7b1898e529396a65c23", "0x4fa1c4e6182b6b7f3bca273390cf587b50b47311", "2", "1", "284228","25")

response:

{
  "input": "0x95000000022c7536e3605d9c16a7a3d7b1898e529396a65c230000000000000019000000034fa1c4e6182b6b7f3bca273390cf587b50b473110000000000045644010102a301e64dc0d4e0daf294ed06960285719c81945b516931f46f689b7c330a041445e9d0c23c93941093a1b0dfbdbf5e039a614e6fc5e077e373c8c706fbd529454ee64e9dcae974df7b346bc200008080940a934080c2ffff8081000462f62879bcb53487b2b5a7705622002ceef2792208cd5596957e787d413679bc9ed0f9274d52040f0c7edc5465031d95141fb5e170c213ca2dade245d87fb18782552b2a7176b962e3a53b772c88ecdd99ccd8dc677b32f08394be0c72ad602d70eeb30cf600eb18284aef075aebac26863d38b639d7859ff5058266ed6fb72000010a9424930080c20000c0ed5a50458bbdee9150090681de9f958784b4de973a05869ac006cdfe62f9bbaa810005bdf41875ebf61043535eb71e9ae6e1409200a44f84f6c8e364a20999ef58a02ab485c3b70ab1171549b8ba7d7e7b2bd734563318bea9782b5328a53bb429421fde7c23dfe73d9fb6cc75caa077409f6c47c06425e617441fbd788634617136a0eca078605c1b0ad6ff4323f7c23307585d3dddd504f96e7a7f722f9802d2a1b7d9333ab2116cd47b78b4a9df5c24a62ec1a559d90d92476e2f9ab4fb6c536194000110"
}

12. 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:

var response = web3.thk.MakeCCCExistenceProof("3","0x2c7536e3605d9c16a7a3d7b1898e529396a65c23", "0x4fa1c4e6182b6b7f3bca273390cf587b50b47311", "3", "3", "1","284228", "66")

response:

{
  "existence": false,
  "input": "0x96000000032c7536e3605d9c16a7a3d7b1898e529396a65c230000000000000042000000034fa1c4e6182b6b7f3bca273390cf587b50b473110000000000045644010103a301e6cfc0948eaf91f6454fc73d796a5d219080ed568159a17915972046471ebddef4839a9294a1fe93a1b0dfc4e4f4c830bbe175349a2e40f2b36e9ff2c1882c072a50d1173744662e6a57c20000c040c4e4f4c830bbe175349a2e40f2b36e9ff2c1882c072a50d1173744662e6a57809404934080c2fdfd808100044d398e46e89ea357f971c9c164d7410d8d320866c225d2d7acc558bdfffa13c7b0d714935f98aaf7965de3caa4b1ea069c944ddcde81dcd35718b765a3ace55e87ff331742bc9bd34e940861649e30a570e4a3695507dd97cbe6353b5b4dca61c8d3a1f913d6feecc9432edbb0d3e141054c6b5a4b4f7a58c34c3de7e68f8ad6000103919425930080c20000c038da7c56bfaab9b73df7714a931570683b63b746790a04886b5cf339535f0a9481000516652bf7d0a127262a7e44d4846584069c4a6ca866c8b5d85785f01b52de4590edec92d65fa4c0c82a6351785089d275c865ba3ae403548671a8c862bdf8ae6ba7aefc67d042b85d3ddf744d02bb7fa1427ad5375b0b5acd84305dd3ffaed995eca078605c1b0ad6ff4323f7c23307585d3dddd504f96e7a7f722f9802d2a1b7fdf0b76142223be82c013d51c23f864ba5a7e07461b66ee053bc52b3e5bda584000111"
}

13.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": "0x5e17128ba224a96d6e84be0c7f899febea26c55c78940610d78a0d22dbd0ab03cc3233491de0b5eb770dbf850b509bd191723df4fc40520bcbab565d46543d6e",
        "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
  }
]

14.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","100")

response:

[
  "0xd1f889690f8c75bbada89a4c8893b8bf6fe29be3b5c3d8a2d772024a340d59d375f39ed88498666a57da10af885ad63a414f8a10153fb739eb1ebfcef57cc883",
  "0xe90a151759bf070969aae664e00502bb08568c85a73874492a3ec480c5178d5da29c790896fc62106e32d172819dec94202ff90f3b7ba3e6adf38508bc58cf43",
  "0x84385cc16d8e0a47909ee998d51370e5f56d7c85716e045c99760bedb180346da7d00b575ba23b76ffcd0969ae84e1e6b6943ec408f40b44825128577d8a895d",
  "0xd0c7107542af7e0019e1340a77a00131d60f49f5543de76b1d5768660e6d694b5dee3e206049bf0009d2859db0b7378240667d85eeb8138426efe9fd3568ebe3"
]

About

No description, website, or topics provided.

Resources

Readme
Activity
Custom properties

Stars

0 stars

Watchers

1 watching

Forks

1 fork
Report repository

Releases

7 tags

Packages

 
 
 

Contributors

Languages