# NULS API-RESTFUL
NULS customized the Nuls 2.0 wallet version required for docking. The docking wallet embeds the NULS-API
module. The module encapsulates the NULS-SDK function, uses the HTTP protocol to access the interface, and supports JSON-RPC
and RESTful
formats.
mainnet and test wallet download address
NULS-API offline operation tool download address
# Settings
The default port number for the NULS-API
module is 18004, which can be modified in the nuls.ncf configuration file, as follows:
[nuls-API]
#httpServerStart port
serverPort=18004
# Description
In order to better understand the related business of nuls2.0, and the meaning of the return value of the interface, do some explanation here in advance.
# Online & Offline
The nuls-api
module provides several online and offline interfaces.
Online interface: The wallet must operate normally and be able to connect to other nodes in the network to properly synchronize blocks and broadcast data.Before calling the online interface, it is best to sync to the latest block.The data generated by the interface is saved in the wallet.For example, create an account, change a password, transfer money, get a block header, and so on.
Offline interface: Nuls 2.0 provides a NULS-API tool for offline operation .No need to install a wallet, you can run independently on a server that is not connected to the network.The user receives the relevant parameters by calling the offline interface, and obtains the return value, and the corresponding data is not stored in the wallet.For example, creating an account offline, offline assembly transfer transactions, offline signatures, and the like.
# Field Description
Chain's chainId:
Nuls2.0 supports multi-chain parallel and cross-chain transfer. Each chain is distinguished by chain id. The chain id of the nuls main network is 1, and the chain id of the nuls test network is 2.
Chain assets:
Nuls 2.0 supports each chain in addition to the default assets, dynamically add assets according to business needs.Each asset of each chain is distinguished by a composite primary key of the chain ID and the asset ID.For example, NULS of the NULS main network, chainId=1, assetId=1
Type value of the transaction:
Nuls 2.0 has multiple transactions by default. Each transaction has different functions. When calling the interface to query the transaction details, the type field can be used to distinguish different transaction types. The following are the enumeration values of the transaction type:
Value | Description |
---|---|
int COIN_BASE = 1; | coinBase block reward |
int TRANSFER = 2; | transfer |
int ACCOUNT_ALIAS = 3; | Set the account alias |
int REGISTER_AGENT = 4; | New consensus node |
int DEPOSIT = 5; | Entrusted to participate in the consensus |
int CANCEL_DEPOSIT = 6; | cancel the delegate consensus |
int YELLOW_PUNISH = 7; | yellow card |
int RED_PUNISH = 8; | red card |
int STOP_AGENT = 9; | Unregister the consensus node |
int CROSS_CHAIN = 10; | Cross-chain transfer |
int REGISTER_CHAIN_AND_ASSET = 11; | registration chain |
int DESTROY_CHAIN_AND_ASSET = 12; | Logout chain |
int ADD_ASSET_TO_CHAIN = 13; | Add an asset to the chain |
int REMOVE_ASSET_FROM_CHAIN = 14; | Delete the assets on the chain |
int CREATE_CONTRACT = 15; | Create a smart contract |
int CALL_CONTRACT = 16; | Call smart contract |
int DELETE_CONTRACT = 17; | delete the smart contract |
int CONTRACT_TRANSFER = 18; | Internal transfer of the contract |
int CONTRACT_RETURN_GAS = 19; | Contract execution fee refund |
int CONTRACT_CREATE_AGENT = 20; | contract new consensus node |
int CONTRACT_DEPOSIT = 21; | Contract commissioned to participate in the consensus |
int CONTRACT_CANCEL_DEPOSIT = 22; | Contract cancellation commission consensus |
int CONTRACT_STOP_AGENT = 23; | Contract cancellation consensus node |
int VERIFIER_CHANGE = 24; | certifier change |
From and to: of the transaction
Take a transfer transaction as an example: tx.type = 2
From is the transferer of the transfer transaction, each from a certain amount of assets transferred as a transferer, wherein the nonce value will change after each transfer, you can get the current latest nonce value by calling the query account balance interface.
To is the recipient of the transfer transaction, each to is regarded as the recipient receives the amount of an asset, where lockTime is the lock time.When the lock time is greater than 0, it means that the real time exceeds this value, the asset can be used normally; when lockTime = -1, it means permanent lock, special transaction is needed to unlock, such as participation in the consensus and cancellation of the consensus .
Transaction fee = the sum of the main assets of the chain - the sum of the main assets of the chain
# interview method
json-rpc
access method
Add request header Content-Type: application/json;charset=UTF-8
HttpMethod: POST
URL: http://{ip}:{port}/jsonrpc
Example: http://127.0.0.1:18004/jsonrpc
Request data format:
{ "jsonrpc":"2.0", "method": "methodCMD", //interface name "params":[], //All interface parameters are passed as arrays, and the order of the parameters cannot be changed. If the parameters are not required, they must also be filled in null placeholders. "id":1234 }
RESTful
access method
- Add request header Content-Type: application/json;charset=UTF-8
For the rest, please refer to the RESTFUL interface documentation
# Interface debugging
We provide the import files (JSON-RPC
and RESTFUL
) of the Postman
interface tuning tool. After importing, you can debug the interface.
JSON-PRC Interface Debugging - POSTMAN Import File
RESTFUL Interface Debugging - POSTMAN Import File
# Interface List
# 1.0 Get information about this chain
# Cmd: /api/info
- Get information about this chain
# HttpMethod: GET
######Parameter list
- No parameters
#####Return values | Field Name | Field Type | Parameter Description || --------------- |:------😐 ------------ || chainId | string | ID of this chain || assetId | string | ID of the default primary asset of this chain || inflationAmount | string | The initial number of default primary assets for this chain || agentChainId | string | Chain ID of the chain consensus asset || agentAssetId | string | ID of the chain consensus asset |### 1.1 Creating accounts in batches
# Cmd: /api/account
- The created account exists in the local wallet #####HttpMethod: POST
#####Form JSON data:
{
"count" : 0,
"prefix" : null,
"password" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
form | accountcreateform | Create Account Form in Batch | Yes |
count | int | New Account Quantity | Yes |
prefix | string | address prefix | no |
password | string | Account Password | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
list | list<string> | Account Address |
# Example request data:
request path: [TBD]
request form data:
{
"count" : 1,
"password" : "abcd1234"
}
#####Example response data:
{
"success" : true,
"data" : {
"list" : [ "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG" ]
}
}
# 1.2 Modify account password
# Cmd: /api/account/password/{address}
- Change account password
# HttpMethod: PUT
#####Form JSON data:
{
"password" : null,
"newPassword" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
address | string | account address | yes |
form | accountupdatepasswordform | Account Password Information Form | Yes |
password | string | original password | yes |
newPassword | string | new password | yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | boolean | Whether to modify successfully |
# 1.3 Export account private key
# Cmd: /api/account/prikey/{address}
- Only the private key of the existing account of the local wallet can be exported**_ #####HttpMethod: POST
#####Form JSON data:
{
"password" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
address | string | account address | yes |
form | accountpasswordform | Account Password Information Form | Yes |
password | string | Password | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | private key |
# Example request data:
request path: http://localhost:18004/api/account/prikey/tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG
request form data:
{
"password" : "abcd1111"
}
#####Example response data:
{
"success" : true,
"data" : {
"value" : "c55c80b0afcbebea36bc2cc1f07a1946935fe578c0c8c35190180f99619d5f48"
}
}
# 1.4 Importing an account based on a private key
# Cmd: /api/account/import/pri
- When importing the private key, you need to enter the password to encrypt the plaintext private key #####HttpMethod: POST
#####Form JSON data
{
"priKey" : null,
"password" : null,
"overwrite" : false
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
form | accountprikeypasswordform | Import account form based on private key | Yes |
priKey | string | Private Key | Yes |
password | string | Password | Yes |
overwrite | boolean | Whether to overwrite the account: false: Do not overwrite import, true: Overwrite import | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | Account Address |
# Example request data:
request path: [TBD]
request form data:
{
"priKey" : "c55c80b0afcbebea36bc2cc1f07a1946935fe578c0c8c35190180f99619d5f48",
"password" : "abcd1234",
"overwrite" : true
}
#####Example response data:
{
"success" : true,
"data" : {
"value" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG"
}
}
# 1.5 Importing accounts based on keyStore
# Cmd: /api/account/import/keystore
- Import account according to keyStore #####HttpMethod: POST
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Import account based on private key | inputstream | Import account form based on private key | Yes |
Import accounts based on private key | inputstream | Import account form based on private key | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | Account Address |
# 1.6 Importing accounts based on the keystore file path
# Cmd: /api/account/import/keystore/path
- Import account according to the keystore file path #####HttpMethod: POST
#####Form JSON data
{
"path" : null,
"password" : null,
"overwrite" : false
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
form | accountkeystoreimportform | Import account form based on keystore file path | Yes |
path | string | local keystore file path | Yes |
password | string | Password | Yes |
overwrite | boolean | Whether to overwrite the account: false: Do not overwrite import, true: Overwrite import | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | Account Address |
{
"path" : "e:\\tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG.keystore",
"password" : "abcd1234",
"overwrite" : true
}
#####Example response data:
{
"success" : true,
"data" : {
"value" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG"
}
}
# 1.7 Importing accounts based on keystore strings
# Cmd: /api/account/import/keystore/json
- Import account based on keystore string #####HttpMethod: POST
#####Form JSON data
{
"keystore" : {
"address" : null,
"encryptedPrivateKey" : null,
"pubKey" : null,
"prikey" : null
},
"password" : null,
"overwrite" : false
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
form | accountkeystorejsonimportform | Import Account Form from Keystore String | Yes |
keystore | object | keystore string | yes |
address | string | Account Address | Yes |
encryptedPrivateKey | string | Encrypted Private Key | Yes |
pubKey | string | Public Key | Yes |
prikey | string | Private Key | Yes |
password | string | Password | Yes |
overwrite | boolean | Whether to overwrite the account: false: Do not overwrite import, true: Overwrite import | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | Account Address |
# Example request data:
request path: [TBD]
request form data:
{
"keystore" : {
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"encryptedPrivateKey" : "54793157409d0414248ef290eac96270c1a0115d712e845f0eb372bb977cbc0cafe39d598175473fa1bd5329dd1fae95",
"pubKey" : "023cee1aa6158ee640c8f48f9a9fa9735c8ed5426f2c353b0ed65e123033d820e6",
"prikey" : null
},
"password" : "abcd1234",
"overwrite" : true
}
#####Example response data:
{
"success" : true,
"data" : {
"value" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG"
}
}
# 1.8 Account backup, export the AccountKeyStore file to the specified directory
# Cmd: /api/account/export/{address}
- Account backup, export AccountKeyStore file to the specified directory #####HttpMethod: POST
#####Form JSON data
{
"password" : null,
"path" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
address | string | account address | yes |
form | accountkeystorebackup | keystone export information form | Yes |
password | string | Password | Yes |
path | string | File Path | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
path | string | Exported file path |
# Example request data:
request path: http://localhost:18004/api/account/export/tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG
request form data:
{
"password" : "abcd1234",
"path" : "e:/"
}
#####Example response data:
{
"success" : true,
"data" : {
"path" : "e:\\\\tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG.keystore"
}
}
# 1.9 Account Settings Alias
# Cmd: /api/account/alias
- The alias format is a combination of 1-20 digits lowercase letters and numbers. Setting an alias will destroy 1 nuls #####HttpMethod: POST
#####Form JSON data
{
"address" : null,
"alias" : null,
"password" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
form | setaliasform | Account Settings Alias Form | Yes |
address | string | Account Address | Yes |
alias | string | alias | yes |
password | string | Account Password | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | set the hash of the alias transaction |
# 1.10 Querying account balance
# Cmd: /api/accountledger/balance/{address}
- According to the asset chain ID and asset ID, query the balance and nonce value of the corresponding assets of the chain account #####HttpMethod: POST
#####Form JSON data
{
"assetChainId" : 0,
"assetId" : 0
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
balanceDto | balanceform | Account Balance Form | Yes |
assetChainId | int | Asset Chain ID | Yes |
assetId | int | Asset ID | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
total | string | total balance |
freeze | string | lock amount |
available | string | Available balances |
timeLock | string | Time Locked Amount |
consensusLock | string | Consensus Locked Amount |
nonce | string | account asset nonce value |
nonceType | int | 1: confirmed nonce value, 0: unconfirmed nonce value |
# Example request data:
request path: http://localhost:18004/api/accountledger/balance/tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG
request form data:
{
"assetChainId" : 2,
"assetId" : 1
}
#####Example response data:
{
"success" : true,
"data" : {
"total" : "10000000000000",
"freeze" : "0",
"available" : "10000000000000",
"timeLock" : "0",
"consensusLock" : "0",
"nonce" : "0000000000000000",
"nonceType" : 1
}
}
# 1.11 Verify that the address format is correct
# Cmd: /api/account/address/validate
- Verify that the address format is correct #####HttpMethod: POST
#####Parameter list No parameters
#####Return values No return value <!--
# Example request data:
request path: [TBD]
request form data: no
#####Example response data: [TBD] -->
# 1.12 Offline - Create an account in bulk
# Cmd: /api/account/offline
- The created account will not be saved to the wallet, and the interface directly returns the keystore information of the account #####HttpMethod: POST
#####Form JSON data
{
"count" : 0,
"prefix" : null,
"password" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
form | accountcreateform | Offline Batch Create Account Form | Yes |
count | int | New Account Quantity | Yes |
prefix | string | address prefix | no |
password | string | Account Password | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
list | list<object> | Account keystore list |
address | string | Account Address |
pubKey | string | Public Key |
prikey | string | Clear Text Private Key |
encryptedPrivateKey | string | Encrypted Private Key |
# Example request data:
request path: [TBD]
request form data:
{
"count" : 1,
"prefix" : "tNULS",
"password" : "abcd1234"
}
#####Example response data:
{
"success" : true,
"data" : [ {
"address" : "tNULSeBaMoS1x2VryPZGyaVSfbaqcLfhqhbXit",
"pubKey" : "03a299ec3c3bbb3da290a10c1deafae08f1f630e5edab89cde65f4dc0c42537c42",
"prikey" : "",
"encryptedPrivateKey" : "56070f74ebbcbf0097d5ceca5fc075b76f5f59bd3851be02cab08d953330c327267a2406bc6173e3093520744219c491"
} ]
}
# 1.13 Obtaining the account clear text private key offline
# Cmd: /api/account/priKey/offline
- Obtain the account clear text private key offline #####HttpMethod: POST
#####Form JSON data
{
"address" : null,
"encryptedPriKey" : null,
"password" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
form | getprikeyform | Get the account clear text private key form offline | Yes |
address | string | Account Address | Yes |
encryptedPriKey | string | Account Ciphertext Private Key | Yes |
password | string | Account Password | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | Cleartext private key |
# Example request data:
request path: [TBD]
request form data:
{
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"encryptedPriKey" : "54793157409d0414248ef290eac96270c1a0115d712e845f0eb372bb977cbc0cafe39d598175473fa1bd5329dd1fae95",
"password" : "abcd1234"
}
#####Example response data:
{
"success" : true,
"data" : {
"priKey" : "c55c80b0afcbebea36bc2cc1f07a1946935fe578c0c8c35190180f99619d5f48"
}
}
# 1.14 Modify account password offline
# Cmd: /api/account/password/offline/
- Offline account password
# HttpMethod: PUT
#####Form JSON data
{
"address" : null,
"encryptedPriKey" : null,
"oldPassword" : null,
"newPassword" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
form | resetpasswordform | Offline Change Account Password Form | Yes |
address | string | Account Address | Yes |
encryptedPriKey | string | Account Ciphertext Private Key | Yes |
oldPassword | string | Account original password | Yes |
newPassword | string | Account New Password | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | Encrypted private key after resetting password |
# 1.15 Multiple Account Summary Signature
# Cmd: /api/account/multi/sign
- Multi-account transfer transaction for signature offline assembly. When calling interface, parameters can pass address and private key, or pass address and encrypted private key and encrypted password #####HttpMethod: POST
#####Form JSON data
{
"dtoList" : [ {
"address" : null,
"priKey" : null,
"encryptedPrivateKey" : null,
"password" : null
} ],
"txHex" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
form | multisignform | Multiple Account Summary Signature Form | Yes |
dtoList | list<object> | keystore collection | Yes |
address | string | address | |
priKey | string | Clear Text Private Key | No |
encryptedPrivateKey | string | Encrypt private key | No |
password | string | Password | No |
txHex | string | Transaction Serialization Hex String | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Signed transaction hex string |
# Example request data:
request path: [TBD]
request form data:
{
"dtoList" : [ {
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"priKey" : "c55c80b0afcbebea36bc2cc1f07a1946935fe578c0c8c35190180f99619d5f48",
"encryptedPrivateKey" : null,
"password" : null
} ],
"txHex" : "02003fac2d5d00008c0117020001efa328e600912da9872390a675486ab9e8ec211402000100e0c8100000000000000000000000000000000000000000000000000000000000080000000000000000000117020001f7ec6473df12e751d64cf20a8baa7edd50810f810200010040420f0000000000000000000000000000000000000000000000000000000000000000000000000000"
}
#####Example response data:
{
"success" : true,
"data" : {
"txHex" : "02003fac2d5d00008c0117020001efa328e600912da9872390a675486ab9e8ec211402000100e0c8100000000000000000000000000000000000000000000000000000000000080000000000000000000117020001f7ec6473df12e751d64cf20a8baa7edd50810f810200010040420f000000000000000000000000000000000000000000000000000000000000000000000000006921023cee1aa6158ee640c8f48f9a9fa9735c8ed5426f2c353b0ed65e123033d820e646304402203c376fd0121fce6228516c011126a8526c5bc543afb7e4272c0de708a55d834f02204ebcd942e019b77bbec37f7e2b77b591ba4ce0fbc5fe9335ab91ae925ded6bed",
"hash" : "5a91b75e6a6d1f415638375627933b42ce7179b4c6390ca0dcc5a0c2c74bd34a"
}
}
# 1.16 Clear text private key digest signature
# Cmd: /api/account/priKey/sign
- Clear text private key summary signature #####HttpMethod: POST
#####Form JSON data
{
"txHex" : null,
"address" : null,
"priKey" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
form | prikeysignform | Clear Text Private Key Summary Signature Form | Yes |
txHex | string | Transaction Serialization Hex String | Yes |
address | string | Account Address | Yes |
priKey | string | Account Clear Text Private Key | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Signed transaction hex string |
# Example request data:
request path: [TBD]
request form data:
{
"txHex" : "02003fac2d5d00008c0117020001efa328e600912da9872390a675486ab9e8ec211402000100e0c8100000000000000000000000000000000000000000000000000000000000080000000000000000000117020001f7ec6473df12e751d64cf20a8baa7edd50810f810200010040420f0000000000000000000000000000000000000000000000000000000000000000000000000000",
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"priKey" : "c55c80b0afcbebea36bc2cc1f07a1946935fe578c0c8c35190180f99619d5f48"
}
#####Example response data:
{
"success" : true,
"data" : {
"txHex" : "02003fac2d5d00008c0117020001efa328e600912da9872390a675486ab9e8ec211402000100e0c8100000000000000000000000000000000000000000000000000000000000080000000000000000000117020001f7ec6473df12e751d64cf20a8baa7edd50810f810200010040420f000000000000000000000000000000000000000000000000000000000000000000000000006921023cee1aa6158ee640c8f48f9a9fa9735c8ed5426f2c353b0ed65e123033d820e646304402203c376fd0121fce6228516c011126a8526c5bc543afb7e4272c0de708a55d834f02204ebcd942e019b77bbec37f7e2b77b591ba4ce0fbc5fe9335ab91ae925ded6bed",
"hash" : "5a91b75e6a6d1f415638375627933b42ce7179b4c6390ca0dcc5a0c2c74bd34a"
}
}
# 1.17 ciphertext private key digest signature
# Cmd: /api/account/encryptedPriKey/sign
- ciphertext private key digest signature #####HttpMethod: POST
#####Form JSON data
{
"txHex" : null,
"address" : null,
"encryptedPriKey" : null,
"password" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
form | encryptedprikeysignform | ciphertext private key summary signature form | Yes |
txHex | string | Transaction Serialization Hex String | Yes |
address | string | Account Address | Yes |
encryptedPriKey | string | Account Ciphertext Private Key | Yes |
password | string | Account Password | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Signed transaction hex string |
# Example request data:
request path: [TBD]
request form data:
{
"txHex" : "02003fac2d5d00008c0117020001efa328e600912da9872390a675486ab9e8ec211402000100e0c8100000000000000000000000000000000000000000000000000000000000080000000000000000000117020001f7ec6473df12e751d64cf20a8baa7edd50810f810200010040420f0000000000000000000000000000000000000000000000000000000000000000000000000000",
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"encryptedPriKey" : "54793157409d0414248ef290eac96270c1a0115d712e845f0eb372bb977cbc0cafe39d598175473fa1bd5329dd1fae95",
"password" : "abcd1234"
}
#####Example response data:
{
"success" : true,
"data" : {
"txHex" : "02003fac2d5d00008c0117020001efa328e600912da9872390a675486ab9e8ec211402000100e0c8100000000000000000000000000000000000000000000000000000000000080000000000000000000117020001f7ec6473df12e751d64cf20a8baa7edd50810f810200010040420f000000000000000000000000000000000000000000000000000000000000000000000000006921023cee1aa6158ee640c8f48f9a9fa9735c8ed5426f2c353b0ed65e123033d820e646304402203c376fd0121fce6228516c011126a8526c5bc543afb7e4272c0de708a55d834f02204ebcd942e019b77bbec37f7e2b77b591ba4ce0fbc5fe9335ab91ae925ded6bed",
"hash" : "5a91b75e6a6d1f415638375627933b42ce7179b4c6390ca0dcc5a0c2c74bd34a"
}
}
# 1.18 Creating a multi-signed account
# Cmd: /api/account/multiSign/create
- Create a multi-sign account based on the public key of multiple accounts, minSigns the minimum number of signatures required to create a transaction for a multi-signed account #####HttpMethod: POST
#####Form JSON data
{
"pubKeys" : [ ],
"minSigns" : 0
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
form | multisignaccountcreateform | Create a multi-sign account form | Yes |
pubKeys | list<string> | Account Public Key Collection | Yes |
minSigns | int | Minimum Signatures | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | Account address |
# 1.19 Creating an alias transaction offline
# Cmd: /api/account/aliasTx/create
- Create a multi-sign account based on the public key of multiple accounts, minSigns the minimum number of signatures required to create a transaction for a multi-signed account #####HttpMethod: POST
#####Form JSON data
{
"address" : null,
"alias" : null,
"nonce" : null,
"remark" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
dto | aliasdto | Create a multi-signed account form | Yes |
address | string | Account Address | Yes |
alias | string | alias | yes |
nonce | string | Asset nonce value | Yes |
remark | string | Transaction Notes | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization hex string |
# 1.20 Multi-signed account offline creation set alias transaction
# Cmd: /api/account/multiSign/aliasTx/create
- Multi-signed account offline creation set alias transaction #####HttpMethod: POST
#####Form JSON data
{
"address" : null,
"alias" : null,
"nonce" : null,
"remark" : null,
"pubKeys" : [ ],
"minSigns" : 0
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
dto | multisignaliasdto | Create an Alias Transaction Form | Yes |
address | string | Account Address | Yes |
alias | string | alias | yes |
nonce | string | Asset nonce value | Yes |
remark | string | Transaction Notes | No |
pubKeys | list<string> | Public Key Collection | Yes |
minSigns | int | Minimum Signatures | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization hex string |
# 1.21 Get the account address format based on the private key
# Cmd: /api/account/address/priKey
- Get account address format based on private key #####HttpMethod: POST
#####Form JSON data
{
"priKey" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
form | prikeyform | private key form | yes |
priKey | string | Account Clear Text Private Key | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | Account Address |
-->
# 2.1 Query block header according to block height
# Cmd: /api/block/header/height/{height}
- Query block header according to block height
# HttpMethod: GET
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
height | long | block height | yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | hash value of the block |
preHash | string | hash value of the previous block |
merkleHash | string | Merkel hash |
time | string | Block generation time |
height | long | block height |
txCount | int | Number of Block Packaged Transactions |
blockSignature | string | Signature Hex.encode(byte[]) |
size | int | Size |
packingAddress | string | Packing address |
roundIndex | long | Consensus Round |
consensusMemberCount | int | Number of Consensus Members |
roundStartTime | string | Current Consensus Round Start Time |
packingIndexOfRound | int | The current round of packaging out the block rankings |
mainVersion | short | Current version of the main network |
blockVersion | short | The version of the block, which can be understood as the version of the local wallet |
stateRoot | string | Smart Contract World State Root |
txHashList | list<string> | Block packed transaction hash collection |
# Example request data:
request path: http://localhost:18004/api/block/header/height/1
request form data: no
#####Example response data:
{
"success" : true,
"data" : {
"hash" : "0b21cc1e77865f3e414e69ccb63d65c2bdedd98f2aa3d6e414d4791ee897190f",
"preHash" : "d8880f913c984e4dece5cfb3f5f1d96d6ee923ffb0b47be0079fe84472ddda83",
"merkleHash" : "bace93bafd0834437019ad402bbcdc274b6c29c806d72135adbed9e46c7a4450",
"time" : "1970-01-19 10:14:32.032",
"height" : 1,
"txCount" : 1,
"blockSignature" : "473045022100a6a41777c78a3faafb7735d3b28a8bdb2501601bb4953fbbdcd48e892415fb3f02204c72100178b85d9ae4486808d0fa404e63f54912eea27bfd931da558fc3b8599",
"size" : 247,
"packingAddress" : "tNULSeBaMkrt4z9FYEkkR9D6choPVvQr94oYZp",
"roundIndex" : 156327293,
"consensusMemberCount" : 1,
"roundStartTime" : "1970-01-19 10:14:32.032",
"packingIndexOfRound" : 1,
"mainVersion" : 1,
"blockVersion" : 1,
"stateRoot" : "56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
}
}
# 2.2 Query block header based on block hash
# Cmd: /api/block/header/hash/{hash}
- Query block header according to block hash
# HttpMethod: GET
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
hash | string | block hash | yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | hash value of the block |
preHash | string | hash value of the previous block |
merkleHash | string | Merkel hash |
time | string | Block generation time |
height | long | block height |
txCount | int | Number of Block Packaged Transactions |
blockSignature | string | Signature Hex.encode(byte[]) |
size | int | Size |
packingAddress | string | Packing address |
roundIndex | long | Consensus Round |
consensusMemberCount | int | Number of Consensus Members |
roundStartTime | string | Current Consensus Round Start Time |
packingIndexOfRound | int | The current round of packaging out the block rankings |
mainVersion | short | Current version of the main network |
blockVersion | short | The version of the block, which can be understood as the version of the local wallet |
stateRoot | string | Smart Contract World State Root |
txHashList | list<string> | Block packed transaction hash collection |
# Example request data:
request path: http://localhost:18004/api/block/header/hash/0b21cc1e77865f3e414e69ccb63d65c2bdedd98f2aa3d6e414d4791ee897190f
request form data: no
#####Example response data:
{
"success" : true,
"data" : {
"hash" : "0b21cc1e77865f3e414e69ccb63d65c2bdedd98f2aa3d6e414d4791ee897190f",
"preHash" : "d8880f913c984e4dece5cfb3f5f1d96d6ee923ffb0b47be0079fe84472ddda83",
"merkleHash" : "bace93bafd0834437019ad402bbcdc274b6c29c806d72135adbed9e46c7a4450",
"time" : "1970-01-19 10:14:32.032",
"height" : 1,
"txCount" : 1,
"blockSignature" : "473045022100a6a41777c78a3faafb7735d3b28a8bdb2501601bb4953fbbdcd48e892415fb3f02204c72100178b85d9ae4486808d0fa404e63f54912eea27bfd931da558fc3b8599",
"size" : 247,
"packingAddress" : "tNULSeBaMkrt4z9FYEkkR9D6choPVvQr94oYZp",
"roundIndex" : 156327293,
"consensusMemberCount" : 1,
"roundStartTime" : "1970-01-19 10:14:32.032",
"packingIndexOfRound" : 1,
"mainVersion" : 1,
"blockVersion" : 1,
"stateRoot" : "56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
}
}
# 2.3 Querying the latest block header information
# Cmd: /api/block/header/newest
- Query the latest block header information
# HttpMethod: GET
#####Parameter list No parameters
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | hash value of the block |
preHash | string | hash value of the previous block |
merkleHash | string | Merkel hash |
time | string | Block generation time |
height | long | block height |
txCount | int | Number of Block Packaged Transactions |
blockSignature | string | Signature Hex.encode(byte[]) |
size | int | Size |
packingAddress | string | Packing address |
roundIndex | long | Consensus Round |
consensusMemberCount | int | Number of Consensus Members |
roundStartTime | string | Current Consensus Round Start Time |
packingIndexOfRound | int | The current round of packaging out the block rankings |
mainVersion | short | Current version of the main network |
blockVersion | short | The version of the block, which can be understood as the version of the local wallet |
stateRoot | string | Smart Contract World State Root |
txHashList | list<string> | Block packed transaction hash collection |
# Example request data:
request path: [TBD]
request form data: no
#####Example response data:
{
"success" : true,
"data" : {
"hash" : "0b21cc1e77865f3e414e69ccb63d65c2bdedd98f2aa3d6e414d4791ee897190f",
"preHash" : "d8880f913c984e4dece5cfb3f5f1d96d6ee923ffb0b47be0079fe84472ddda83",
"merkleHash" : "bace93bafd0834437019ad402bbcdc274b6c29c806d72135adbed9e46c7a4450",
"time" : "1970-01-19 10:14:32.032",
"height" : 1,
"txCount" : 1,
"blockSignature" : "473045022100a6a41777c78a3faafb7735d3b28a8bdb2501601bb4953fbbdcd48e892415fb3f02204c72100178b85d9ae4486808d0fa404e63f54912eea27bfd931da558fc3b8599",
"size" : 247,
"packingAddress" : "tNULSeBaMkrt4z9FYEkkR9D6choPVvQr94oYZp",
"roundIndex" : 156327293,
"consensusMemberCount" : 1,
"roundStartTime" : "1970-01-19 10:14:32.032",
"packingIndexOfRound" : 1,
"mainVersion" : 1,
"blockVersion" : 1,
"stateRoot" : "56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
}
}
# 2.4 Querying the latest block
# Cmd: /api/block/newest
- Contains all transaction information packaged by the block. This interface returns more data and is cautiously called
# HttpMethod: GET
#####Parameter list No parameters
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
header | object | block header information, only return the corresponding partial data |
hash | string | hash value of block |
preHash | string | hash value of the previous block |
merkleHash | string | Merkel hash |
time | string | Block generation time |
height | long | Block Height |
txCount | int | Block Packing Transactions |
blockSignature | string | Signature Hex.encode(byte[]) |
size | int | Size |
packingAddress | string | Package Address |
roundIndex | long | Consensus Rounds |
consensusMemberCount | int | Number of Consensus Members |
roundStartTime | string | Current Consensus Round Start Time |
packingIndexOfRound | int | Current rounds of packaged blocks |
mainVersion | short | Current version of the main network |
blockVersion | short | The version of the block, which can be understood as the version of the local wallet |
stateRoot | string | Smart Contract World Status Root |
txHashList | list<string> | Block packed transaction hash collection |
txs | list<object> | Trading List |
hash | string | trading hash value |
type | int | Transaction Type |
time | string | Trading Hours |
blockHeight | long | Block Height |
remark | string | Trade Notes |
transactionSignature | string | Transaction Signature |
txDataHex | string | Transaction Business Data Serialization String |
status | int | Transaction Status 0: unConfirm (to be confirmed), 1: confirm (confirmed) |
size | int | Transactions Size |
inBlockIndex | int | The order in the block, stored in rocksDB is unordered, assigned when saving the block, sorted according to this value after taking out |
from | list<object> | Input |
address | string | Account Address |
assetsChainId | int | id of asset distribution chain |
assetsId | int | Asset id |
amount | string | Quantity |
nonce | string | Hex string for account nonce value, preventing double-flower trading, Take the last 8 bytes of a transaction hash |
locked | byte | 0 normal trade, -1 unlocked trade (exit consensus, Exit commission) |
to | list<object> | Output |
address | string | Account Address |
assetsChainId | int | id of asset distribution chain |
assetsId | int | Asset id |
amount | string | Quantity |
lockTime | long | unlock time, -1 is permanent lock |
# Example request data:
request path: [TBD]
request form data: no
#####Example response data:
{
"success" : true,
"data" : {
"header" : {
"hash" : "92285f81a649a7c65b1fe9e52738bb95c4aac6a7f4ab4b0b971c09662a9433ad",
"preHash" : "c9d0d84c47455e8dc0ccc328133c1e2bbb31d74b9f6ac99c14cc4f2d7663d4cc",
"merkleHash" : "646a2bea27384ca31c45acd9980c7adec2ba8cfa95477c74cbca93db9f966caa",
"time" : "1970-01-19 10:14:33.033",
"height" : 9,
"txCount" : 2,
"blockSignature" : "463044022024e463c5dcb039f40e3ff2f733c294f5e705e38aa4caebbea6c14a100f39dbe30220222c673b226fc6c6c9cb535ff4440728ecf00968114798be40499e16b12b1709",
"size" : 234,
"packingAddress" : "tNULSeBaMkrt4z9FYEkkR9D6choPVvQr94oYZp",
"roundIndex" : 156327301,
"consensusMemberCount" : 1,
"roundStartTime" : "1970-01-19 10:14:33.033",
"packingIndexOfRound" : 1,
"mainVersion" : 1,
"blockVersion" : 1,
"stateRoot" : "56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
},
"txs" : [ {
"hash" : "c418229126d1c2246828f99752bbffcb5d5a6fef552d64275482f80f79690fe6",
"type" : 1,
"time" : "2019-07-16 18:30:11.011",
"blockHeight" : 9,
"remark" : null,
"transactionSignature" : null,
"status" : 0,
"size" : 80,
"inBlockIndex" : 0,
"form" : [ ],
"to" : [ {
"address" : "tNULSeBaMkrt4z9FYEkkR9D6choPVvQr94oYZp",
"assetsChainId" : 2,
"assetsId" : 1,
"amount" : "100000",
"lockTime" : 0
} ]
}, {
"hash" : "247a026d48f6be0c358423898e38a50ac0c2c1a851419b1ec843a667bab90df9",
"type" : 2,
"time" : "2019-07-16 18:30:03.003",
"blockHeight" : 9,
"remark" : "remark",
"transactionSignature" : "2103958b790c331954ed367d37bac901de5c2f06ac8368b37d7bd6cd5ae143c1d7e34630440220084da59fca5edc6ed047c1360bb45d3e7ec297c367b8c2810421b2a43d1eabba02201f9e499fe63ad2dbbd83c1dafcb8437f5aba1c61fd0e5c9075a80b50820ca3ac",
"status" : 0,
"size" : 261,
"inBlockIndex" : 0,
"form" : [ {
"address" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"assetsChainId" : 2,
"assetsId" : 1,
"amount" : "100000100000",
"nonce" : "0000000000000000",
"locked" : 0
} ],
"to" : [ {
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"assetsChainId" : 2,
"assetsId" : 1,
"amount" : "100000000000",
"lockTime" : 0
} ]
} ]
}
}
# 2.5 Query block based on block height
# Cmd: /api/block/height/{height}
- Contains all transaction information packaged by the block. This interface returns more data and is cautiously called
# HttpMethod: GET
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
height | long | block height | yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
header | object | block header information, only return the corresponding partial data |
hash | string | hash value of block |
preHash | string | hash value of the previous block |
merkleHash | string | Merkel hash |
time | string | Block generation time |
height | long | Block Height |
txCount | int | Block Packing Transactions |
blockSignature | string | Signature Hex.encode(byte[]) |
size | int | Size |
packingAddress | string | Package Address |
roundIndex | long | Consensus Rounds |
consensusMemberCount | int | Number of Consensus Members |
roundStartTime | string | Current Consensus Round Start Time |
packingIndexOfRound | int | Current rounds of packaged blocks |
mainVersion | short | Current version of the main network |
blockVersion | short | The version of the block, which can be understood as the version of the local wallet |
stateRoot | string | Smart Contract World Status Root |
txHashList | list<string> | Block packed transaction hash collection |
txs | list<object> | Trading List |
hash | string | trading hash value |
type | int | Transaction Type |
time | string | Trading Hours |
blockHeight | long | Block Height |
remark | string | Trade Notes |
transactionSignature | string | Transaction Signature |
txDataHex | string | Transaction Business Data Serialization String |
status | int | Transaction Status 0: unConfirm (to be confirmed), 1: confirm (confirmed) |
size | int | Transactions Size |
inBlockIndex | int | The order in the block, stored in rocksDB is unordered, assigned when saving the block, sorted according to this value after taking out |
from | list<object> | Input |
address | string | Account Address |
assetsChainId | int | id of asset distribution chain |
assetsId | int | Asset id |
amount | string | Quantity |
nonce | string | Hex string for account nonce value, preventing double-flower trading, Take the last 8 bytes of a transaction hash |
locked | byte | 0 normal trade, -1 unlocked trade (exit consensus, Exit commission) |
to | list<object> | Output |
address | string | Account Address |
assetsChainId | int | id of asset distribution chain |
assetsId | int | Asset id |
amount | string | Quantity |
lockTime | long | unlock time, -1 is permanent lock |
# Example request data:
request path: http://localhost:18004/api/block/height/9
request form data: no
#####Example response data:
{
"success" : true,
"data" : {
"header" : {
"hash" : "92285f81a649a7c65b1fe9e52738bb95c4aac6a7f4ab4b0b971c09662a9433ad",
"preHash" : "c9d0d84c47455e8dc0ccc328133c1e2bbb31d74b9f6ac99c14cc4f2d7663d4cc",
"merkleHash" : "646a2bea27384ca31c45acd9980c7adec2ba8cfa95477c74cbca93db9f966caa",
"time" : "1970-01-19 10:14:33.033",
"height" : 9,
"txCount" : 2,
"blockSignature" : "463044022024e463c5dcb039f40e3ff2f733c294f5e705e38aa4caebbea6c14a100f39dbe30220222c673b226fc6c6c9cb535ff4440728ecf00968114798be40499e16b12b1709",
"size" : 234,
"packingAddress" : "tNULSeBaMkrt4z9FYEkkR9D6choPVvQr94oYZp",
"roundIndex" : 156327301,
"consensusMemberCount" : 1,
"roundStartTime" : "1970-01-19 10:14:33.033",
"packingIndexOfRound" : 1,
"mainVersion" : 1,
"blockVersion" : 1,
"stateRoot" : "56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
},
"txs" : [ {
"hash" : "c418229126d1c2246828f99752bbffcb5d5a6fef552d64275482f80f79690fe6",
"type" : 1,
"time" : "2019-07-16 18:30:11.011",
"blockHeight" : 9,
"remark" : null,
"transactionSignature" : null,
"status" : 0,
"size" : 80,
"inBlockIndex" : 0,
"form" : [ ],
"to" : [ {
"address" : "tNULSeBaMkrt4z9FYEkkR9D6choPVvQr94oYZp",
"assetsChainId" : 2,
"assetsId" : 1,
"amount" : "100000",
"lockTime" : 0
} ]
}, {
"hash" : "247a026d48f6be0c358423898e38a50ac0c2c1a851419b1ec843a667bab90df9",
"type" : 2,
"time" : "2019-07-16 18:30:03.003",
"blockHeight" : 9,
"remark" : "remark",
"transactionSignature" : "2103958b790c331954ed367d37bac901de5c2f06ac8368b37d7bd6cd5ae143c1d7e34630440220084da59fca5edc6ed047c1360bb45d3e7ec297c367b8c2810421b2a43d1eabba02201f9e499fe63ad2dbbd83c1dafcb8437f5aba1c61fd0e5c9075a80b50820ca3ac",
"status" : 0,
"size" : 261,
"inBlockIndex" : 0,
"form" : [ {
"address" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"assetsChainId" : 2,
"assetsId" : 1,
"amount" : "100000100000",
"nonce" : "0000000000000000",
"locked" : 0
} ],
"to" : [ {
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"assetsChainId" : 2,
"assetsId" : 1,
"amount" : "100000000000",
"lockTime" : 0
} ]
} ]
}
}
# 2.6 Query block based on block hash
# Cmd: /api/block/hash/{hash}
- Contains all transaction information packaged by the block. This interface returns more data and is cautiously called
# HttpMethod: GET
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
hash | string | block hash | yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
header | object | block header information, only return the corresponding partial data |
hash | string | hash value of block |
preHash | string | hash value of the previous block |
merkleHash | string | Merkel hash |
time | string | Block generation time |
height | long | Block Height |
txCount | int | Block Packing Transactions |
blockSignature | string | Signature Hex.encode(byte[]) |
size | int | Size |
packingAddress | string | Package Address |
roundIndex | long | Consensus Rounds |
consensusMemberCount | int | Number of Consensus Members |
roundStartTime | string | Current Consensus Round Start Time |
packingIndexOfRound | int | Current rounds of packaged blocks |
mainVersion | short | Current version of the main network |
blockVersion | short | The version of the block, which can be understood as the version of the local wallet |
stateRoot | string | Smart Contract World Status Root |
txHashList | list<string> | Block packed transaction hash collection |
txs | list<object> | Trading List |
hash | string | trading hash value |
type | int | Transaction Type |
time | string | Trading Hours |
blockHeight | long | Block Height |
remark | string | Trade Notes |
transactionSignature | string | Transaction Signature |
txDataHex | string | Transaction Business Data Serialization String |
status | int | Transaction Status 0: unConfirm (to be confirmed), 1: confirm (confirmed) |
size | int | Transactions Size |
inBlockIndex | int | The order in the block, stored in rocksDB is unordered, assigned when saving the block, sorted according to this value after taking out |
from | list<object> | Input |
address | string | Account Address |
assetsChainId | int | id of asset distribution chain |
assetsId | int | Asset id |
amount | string | Quantity |
nonce | string | Hex string for account nonce value, preventing double-flower trading, Take the last 8 bytes of a transaction hash |
locked | byte | 0 normal trade, -1 unlocked trade (exit consensus, Exit commission) |
to | list<object> | Output |
address | string | Account Address |
assetsChainId | int | id of asset distribution chain |
assetsId | int | Asset id |
amount | string | Quantity |
lockTime | long | unlock time, -1 is permanent lock |
# Example request data:
request path: http://localhost:18004/api/block/hash/92285f81a649a7c65b1fe9e52738bb95c4aac6a7f4ab4b0b971c09662a9433ad
request form data: no
#####Example response data:
{
"success" : true,
"data" : {
"header" : {
"hash" : "92285f81a649a7c65b1fe9e52738bb95c4aac6a7f4ab4b0b971c09662a9433ad",
"preHash" : "c9d0d84c47455e8dc0ccc328133c1e2bbb31d74b9f6ac99c14cc4f2d7663d4cc",
"merkleHash" : "646a2bea27384ca31c45acd9980c7adec2ba8cfa95477c74cbca93db9f966caa",
"time" : "1970-01-19 10:14:33.033",
"height" : 9,
"txCount" : 2,
"blockSignature" : "463044022024e463c5dcb039f40e3ff2f733c294f5e705e38aa4caebbea6c14a100f39dbe30220222c673b226fc6c6c9cb535ff4440728ecf00968114798be40499e16b12b1709",
"size" : 234,
"packingAddress" : "tNULSeBaMkrt4z9FYEkkR9D6choPVvQr94oYZp",
"roundIndex" : 156327301,
"consensusMemberCount" : 1,
"roundStartTime" : "1970-01-19 10:14:33.033",
"packingIndexOfRound" : 1,
"mainVersion" : 1,
"blockVersion" : 1,
"stateRoot" : "56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
},
"txs" : [ {
"hash" : "c418229126d1c2246828f99752bbffcb5d5a6fef552d64275482f80f79690fe6",
"type" : 1,
"time" : "2019-07-16 18:30:11.011",
"blockHeight" : 9,
"remark" : null,
"transactionSignature" : null,
"status" : 0,
"size" : 80,
"inBlockIndex" : 0,
"form" : [ ],
"to" : [ {
"address" : "tNULSeBaMkrt4z9FYEkkR9D6choPVvQr94oYZp",
"assetsChainId" : 2,
"assetsId" : 1,
"amount" : "100000",
"lockTime" : 0
} ]
}, {
"hash" : "247a026d48f6be0c358423898e38a50ac0c2c1a851419b1ec843a667bab90df9",
"type" : 2,
"time" : "2019-07-16 18:30:03.003",
"blockHeight" : 9,
"remark" : "remark",
"transactionSignature" : "2103958b790c331954ed367d37bac901de5c2f06ac8368b37d7bd6cd5ae143c1d7e34630440220084da59fca5edc6ed047c1360bb45d3e7ec297c367b8c2810421b2a43d1eabba02201f9e499fe63ad2dbbd83c1dafcb8437f5aba1c61fd0e5c9075a80b50820ca3ac",
"status" : 0,
"size" : 261,
"inBlockIndex" : 0,
"form" : [ {
"address" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"assetsChainId" : 2,
"assetsId" : 1,
"amount" : "100000100000",
"nonce" : "0000000000000000",
"locked" : 0
} ],
"to" : [ {
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"assetsChainId" : 2,
"assetsId" : 1,
"amount" : "100000000000",
"lockTime" : 0
} ]
} ]
}
}
# 2.7 Querying block serialization strings based on block height
# Cmd: /api/block/serialization/height/{height}
- Contains all transaction information packaged by the block. This interface returns more data and is cautiously called
# HttpMethod: GET
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
height | long | block height | yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
Return value | string | Returns the HEX string after the serialization of the block |
# Example request data:
request path: http://localhost:18004/api/block/serialization/height/1
request form data: no
#####Example response data:
{
"success" : true,
"data" : "772f158614cefd4f4e0a7ef1cd442f4de7439c10b5642afe582ed09b585d9b1e37d371e184142ebb1d46f4160a18a1e27d51c23dd66c0ccc607044821ae7fff24ddc4c5d01000000010000005c6e7c5409010043dc4c5d0100010001005064002056e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b42100000000000000000000000000000000000000000000000000000000000000000f2517abe887d67e21037fae74d15153c3b55857ca0abd5c34c865dfa1c0d0232997c545bae5541a0863473045022100c6515c296a80ae8ef48713cae87b693003fb57cc41ce2af4dcc93d32e3cb382502201b84db49946fee5fd57edb350fe0f4c78cac3a503cfb11cbb3a4f6082ffe26cb01004ddc4c5d000002000000"
}
# 2.8 Serializing strings based on block hash query block
# Cmd: /api/block/serialization/hash/{hash}
- Contains all transaction information packaged by the block. This interface returns more data and is cautiously called
# HttpMethod: GET
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
hash | string | block hash | yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
Return value | string | Returns the HEX string after the serialization of the block |
# Example request data:
request path: http://localhost:18004/api/block/serialization/hash/5ce81f9a470459276b633465f2572862aa7156a42220d29d724ced9bf9d723f9
request form data: no
#####Example response data:
{
"success" : true,
"data" : "772f158614cefd4f4e0a7ef1cd442f4de7439c10b5642afe582ed09b585d9b1e37d371e184142ebb1d46f4160a18a1e27d51c23dd66c0ccc607044821ae7fff24ddc4c5d01000000010000005c6e7c5409010043dc4c5d0100010001005064002056e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b42100000000000000000000000000000000000000000000000000000000000000000f2517abe887d67e21037fae74d15153c3b55857ca0abd5c34c865dfa1c0d0232997c545bae5541a0863473045022100c6515c296a80ae8ef48713cae87b693003fb57cc41ce2af4dcc93d32e3cb382502201b84db49946fee5fd57edb350fe0f4c78cac3a503cfb11cbb3a4f6082ffe26cb01004ddc4c5d000002000000"
}
# 3.1 Get trading based on hash
# Cmd: /api/tx/{hash}
- Get transaction based on hash
# HttpMethod: GET
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
hash | string | transaction hash | yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | hash value of the transaction |
type | int | Transaction Type |
time | string | Trading Hours |
blockHeight | long | Block Height |
remark | string | Trading Notes |
transactionSignature | string | Transaction Signature |
txDataHex | string | Transaction Business Data Serialization String |
status | int | Transaction Status 0: unConfirm (to be confirmed), 1: confirm (confirmed) |
size | int | Transactions Size |
inBlockIndex | int | The order in the block, stored in rocksDB is unordered, assigned when saving the block, sorted according to this value after taking out |
from | list<object> | Input |
address | string | Account Address |
assetsChainId | int | id of asset distribution chain |
assetsId | int | Asset id |
amount | string | Quantity |
nonce | string | The Hex string for the account's nonce value, preventing double-flower trading, taking the last 8 bytes of a transaction hash |
locked | byte | 0 ordinary trade, -1 unlocked amount trade (exit consensus, exit commission) |
to | list<object> | Output |
address | string | Account Address |
assetsChainId | int | id of asset distribution chain |
assetsId | int | Asset id |
amount | string | Quantity |
lockTime | long | unlock time, -1 is permanent lock |
# Example request data:
request path: http://localhost:18004/api/tx/247a026d48f6be0c358423898e38a50ac0c2c1a851419b1ec843a667bab90df9
request form data: no
#####Example response data:
{
"success" : true,
"data" : {
"hash" : "247a026d48f6be0c358423898e38a50ac0c2c1a851419b1ec843a667bab90df9",
"type" : 2,
"time" : "2019-07-16 18:30:03.003",
"blockHeight" : 9,
"remark" : "remark",
"transactionSignature" : "2103958b790c331954ed367d37bac901de5c2f06ac8368b37d7bd6cd5ae143c1d7e34630440220084da59fca5edc6ed047c1360bb45d3e7ec297c367b8c2810421b2a43d1eabba02201f9e499fe63ad2dbbd83c1dafcb8437f5aba1c61fd0e5c9075a80b50820ca3ac",
"status" : 1,
"size" : 261,
"inBlockIndex" : 0,
"form" : [ {
"address" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"assetsChainId" : 2,
"assetsId" : 1,
"amount" : "100000100000",
"nonce" : "0000000000000000",
"locked" : 0
} ],
"to" : [ {
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"assetsChainId" : 2,
"assetsId" : 1,
"amount" : "100000000000",
"lockTime" : 0
} ]
}
}
# 3.2 Verifying the transaction
# Cmd: /api/accountledger/transaction/validate
- Verify offline assembled transaction, verify successful return of transaction hash value, failure returns error message #####HttpMethod: POST
#####Form JSON data
{
"txHex" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Verify that the transaction is correct | txform | Verify that the transaction is correct Form | Yes |
txHex | string | Transaction Serialization hex string | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | transaction hash |
# Example request data:
request path: [TBD]
request form data:
{
"txHex" : "02003fac2d5d00008c0117020001efa328e600912da9872390a675486ab9e8ec211402000100e0c8100000000000000000000000000000000000000000000000000000000000080000000000000000000117020001f7ec6473df12e751d64cf20a8baa7edd50810f810200010040420f000000000000000000000000000000000000000000000000000000000000000000000000006921023cee1aa6158ee640c8f48f9a9fa9735c8ed5426f2c353b0ed65e123033d820e646304402203c376fd0121fce6228516c011126a8526c5bc543afb7e4272c0de708a55d834f02204ebcd942e019b77bbec37f7e2b77b591ba4ce0fbc5fe9335ab91ae925ded6bed"
}
#####Example response data:
{
"success" : true,
"data" : {
"value" : "5a91b75e6a6d1f415638375627933b42ce7179b4c6390ca0dcc5a0c2c74bd34a"
}
}
# 3.3 Broadcast Trading
# Cmd: /api/accountledger/transaction/broadcast
- Broadcast offline assembly transaction, successfully returns true, failure returns error message #####HttpMethod: POST
#####Form JSON data
{
"txHex" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Broadcast Trading | txform | Broadcast Trading Form | Yes |
txHex | string | Transaction Serialization hex string | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | boolean | success |
hash | string | transaction hash |
# Example request data:
request path: [TBD]
request form data:
{
"txHex" : "02003fac2d5d00008c0117020001efa328e600912da9872390a675486ab9e8ec211402000100e0c8100000000000000000000000000000000000000000000000000000000000080000000000000000000117020001f7ec6473df12e751d64cf20a8baa7edd50810f810200010040420f000000000000000000000000000000000000000000000000000000000000000000000000006921023cee1aa6158ee640c8f48f9a9fa9735c8ed5426f2c353b0ed65e123033d820e646304402203c376fd0121fce6228516c011126a8526c5bc543afb7e4272c0de708a55d834f02204ebcd942e019b77bbec37f7e2b77b591ba4ce0fbc5fe9335ab91ae925ded6bed"
}
#####Example response data:
{
"success" : true,
"data" : {
"value" : true,
"hash" : "5a91b75e6a6d1f415638375627933b42ce7179b4c6390ca0dcc5a0c2c74bd34a"
}
}
# 3.4 Single transfer
# Cmd: /api/accountledger/transfer
_**Detailed Description: Initiate a single account single asset transfer transaction #####HttpMethod: POST
#####Form JSON data
{
"address" : null,
"toAddress" : null,
"password" : null,
"amount" : null,
"remark" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Single Transfer | transferform | Single Transfer Form | Yes |
address | string | Account Address | Yes |
toAddress | string | Account Address | Yes |
password | string | Account Password | Yes |
amount | biginteger | Amount | Yes |
remark | string | Notes | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | transaction hash |
# Example request data:
request path: [TBD]
request form data:
{
"address" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"toAddress" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"password" : "nuls123456",
"amount" : 10000000000,
"remark" : "remark"
}
#####Example response data:
{
"success" : true,
"data" : {
"value" : "89368623898cde34fe81b5ede6fe5bed75ffb61021ec6caa01a9a5dcd9262d69"
}
}
# 3.5 Offline assembly transfer transaction
# Cmd: /api/accountledger/createTransferTxOffline
_**Detailed Description: Offline transfer transactions based on inputs and outputs for single or multiple account transfer transactions.The transaction fee is the sum of the main assets of the chain in the inputs, minus the sum of the main assets of the chain in the output #####HttpMethod: POST
#####Form JSON data
{
"inputs" : [ {
"address" : null,
"assetChainId" : 0,
"assetId" : 0,
"amount" : null,
"nonce" : null
} ],
"outputs" : [ {
"address" : null,
"assetChainId" : 0,
"assetId" : 0,
"amount" : null,
"lockTime" : 0
} ],
"remark" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
TransferDto | transferdto | Transfer Transaction Form | Yes |
inputs | list<object> | Transfer Transaction Input List | Yes |
address | string | Account Address | Yes |
assetChainId | int | Asset Chain id | Yes |
assetId | int | Asset id | Yes |
amount | biginteger | Asset Amount | Yes |
nonce | string | Asset nonce value | Yes |
outputs | list<object> | Transfer Transaction Output List | Yes |
address | string | Account Address | Yes |
assetChainId | int | Asset Chain id | Yes |
assetId | int | Asset id | Yes |
amount | biginteger | Asset Amount | Yes |
lockTime | long | Lock Time | Yes |
remark | string | Transaction Notes | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization hex string |
# Example request data:
request path: [TBD]
request form data:
{
"inputs" : [ {
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"assetChainId" : 2,
"assetId" : 1,
"amount" : 1100000,
"nonce" : "0000000000000000"
} ],
"outputs" : [ {
"address" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"assetChainId" : 2,
"assetId" : 1,
"amount" : "1000000",
"lockTime" : 0
} ],
"remark" : null
}
#####Example response data:
{
"success" : true,
"data" : {
"txHex" : "02003fac2d5d00008c0117020001efa328e600912da9872390a675486ab9e8ec211402000100e0c8100000000000000000000000000000000000000000000000000000000000080000000000000000000117020001f7ec6473df12e751d64cf20a8baa7edd50810f810200010040420f0000000000000000000000000000000000000000000000000000000000000000000000000000",
"hash" : "5a91b75e6a6d1f415638375627933b42ce7179b4c6390ca0dcc5a0c2c74bd34a"
}
}
# 3.6 Calculate the commission fee for creating a transfer transaction offline
# Cmd: /api/accountledger/calcTransferTxFee
- Calculate the commission fee required to create a transfer transaction offline #####HttpMethod: POST
#####Form JSON data
{
"addressCount" : 0,
"fromLength" : 0,
"toLength" : 0,
"remark" : null,
"price" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
TransferTxFeeDto | transfertxfeedto | Transfer transaction fee | Yes |
addressCount | int | Transfer Address Quantity | Yes |
fromLength | int | Transfer Entry Length | Yes |
toLength | int | Transfer output length | Yes |
remark | string | Transaction Notes | Yes |
price | biginteger | Fee Price | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | transaction fee |
# Example request data:
request path: [TBD]
request form data:
{
"addressCount" : 6,
"fromLength" : 6,
"toLength" : 2,
"remark" : "remark",
"price" : "100000"
}
#####Example response data:
{
"success" : true,
"data" : {
"value" : 200000
}
}
# 3.7 Multi-signed account offline assembly transfer transaction
# Cmd: /api/accountledger/createMultiSignTransferTxOffline
_**Detailed Description: Offline transfer transactions based on inputs and outputs for single or multiple account transfer transactions.The transaction fee is the sum of the main assets of the chain in the inputs, minus the sum of the main assets of the chain in the output #####HttpMethod: POST
#####Form JSON data
{
"pubKeys" : [ ],
"minSigns" : 0,
"inputs" : [ {
"address" : null,
"assetChainId" : 0,
"assetId" : 0,
"amount" : null,
"nonce" : null
} ],
"outputs" : [ {
"address" : null,
"assetChainId" : 0,
"assetId" : 0,
"amount" : null,
"lockTime" : 0
} ],
"remark" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
TransferDto | multisigntransferdto | Multi-Sign Account Transfer Transaction Form | Yes |
pubKeys | list<string> | Public Key Collection | Yes |
minSigns | int | Minimum Signatures | Yes |
inputs | list<object> | Transfer Transaction Input List | Yes |
address | string | Account Address | Yes |
assetChainId | int | Asset Chain id | Yes |
assetId | int | Asset id | Yes |
amount | biginteger | Asset Amount | Yes |
nonce | string | Asset nonce value | Yes |
outputs | list<object> | Transfer Transaction Output List | Yes |
address | string | Account Address | Yes |
assetChainId | int | Asset Chain id | Yes |
assetId | int | Asset id | Yes |
amount | biginteger | Asset Amount | Yes |
lockTime | long | Lock Time | Yes |
remark | string | Transaction Notes | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization hex string |
# 3.8 Calculate the commission required to create a multi-sign account transfer transaction offline
# Cmd: /api/accountledger/calcMultiSignTransferTxFee
- Calculate the commission fee for offline multi-sign account transfer transactions #####HttpMethod: POST
#####Form JSON data
{
"pubKeyCount" : 0,
"fromLength" : 0,
"toLength" : 0,
"remark" : null,
"price" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
MultiSignTransferTxFeeDto | multisigntransfertxfeedto | Multi-Sign Account Transfer Transaction Fee Form | Yes |
pubKeyCount | int | Multi-signal address corresponding to the number of public keys | Yes |
fromLength | int | Transfer Entry Length | Yes |
toLength | int | Transfer output length | Yes |
remark | string | Transaction Notes | Yes |
price | biginteger | Fee Price | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | transaction fee |
# 4.1 Publishing contract
# Cmd: /api/contract/create
- Release contract #####HttpMethod: POST
#####Form JSON data
{
"sender" : null,
"gasLimit" : 0,
"price" : 0,
"password" : null,
"remark" : null,
"contractCode" : null,
"alias" : null,
"args" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Release Contract | contractcreate | Release Contract Form | Yes |
sender | string | Transaction Creator | Yes |
gasLimit | long | Maximum gas consumption | Yes |
price | long | Execution contract price | Yes |
password | string | Transaction Creator Account Password | Yes |
remark | string | Notes | No |
contractCode | string | Smart Contract Code (Hex encoded string of bytecode) | Yes |
alias | string | Contract Alias | Yes |
args | object[] | Parameter List | No |
# Return values
Field Name | Field Type | Parameter Description |
---|---|---|
txHash | string | publish contract trading hash |
contractAddress | string | generated contract address |
# Example request data:
request path: [TBD]
request form data:
{
"sender" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"gasLimit" : 20000,
"price" : 25,
"password" : "nuls123456",
"remark" : "restful-nrc20-remark",
"contractCode" : "504b03040a0000080000aa7b564e00000000000000000000000003000400696f2ffeca0000504b03040a0000080000aa7b564e00000000000000000000000008000000696f2f6e756c732f504b03040a0000080000aa7b564e00000000000000000000000011000000696f2f6e756c732f636f6e74726163742f504b03040a0000080000aa7b564e00000000000000000000000017000000696f2f6e756c732f636f6e74726163742f746f6b656e2f504b0304140008080800aa7b564e00000000000000000000000028000000696f2f6e756c732f636f6e74726163742f746f6b656e2f53696d706c65546f6b656e2e636c617373b558f97754e5197eeecc90990c972d9090059209a498cc9291a58a8152020d35ca5602b1605bbd99b9492ecc12670922b46ead4babd56aeb5ad1565bd4aa2c020169d59ed353cfe93fd17f84d3d3e7fdee9d3b37612639d5d31ff2ddf77ecbfb3eeff67c77f2afff7cf639804df87b23a23825c323329c96e14c1831fcb411cdf859108f86119497281e93e171997e22cce149197e1ec62ff0d462acc2d3413c13c672fc2a8ce7f0bcccfc3a8817827831cc53bf91e125195e96e5df8af4bb205e09a3430e44f19a0cafcbf086a87d5386df87f096cc9c9597b7457a27843fc8f38f21bc2b7ade0be24f41fc39887341bcaf219033b2a686a6bdc78d692399317213c99152c1ca4d6cd3d0503c951dcb673484d266caca1a99a2066d58c3e252be646446ca535399531a5aeca359a33499dc654d0ce74ae68459e0f1d098417d2993a796d97bca252b93dc674c71b171c49ac819a57281c68766af6edf6be593b972a6984ce573a582912a258be913c9c174ba60168bdb6a9bdb419d412393c99f34d31a4a5f43e337342f0056f5f6d58a6360773e6d4a10ac9cb9bf9c1d330b878db18c8a7a3e6564468d8225efce64a0346931643db7c228e54f98b9e488959de26691a9bbed503957b2b2e6a855b4787c3097636e4a563e47151b6a7b62b87b92a39679924afcbd7d4c6b6b05fdada96cd86ee5acd20e0d3b7a6f75b0decc5c35c37da31a968822cbc80c66f304ae61dd6cfc078d02ebb164166639125dd09143e64365ab60a6a5b2541548e16938dcbb4032e75dad1b8e45f99339b3a0a173fef3acc8e294994bcb565d1d19ac14e8a269235336a5796655c0a9a94a152c192919a9132c47f56eb302b5d048ae386e16f614f2590d47be917bb5bdeb3bc6121c57ea7da53cc3e974f181710d772c60af6ec0828e129242c5030d772e84be2ebea0313555c84f53dd722b972a9846d11c543306c92a6ca4d3667ad48eef7232d79cf565c5f29832e66e0ae53315510ebb49fabf84973d1032ec2d1babe2260f2ed77eb868565f96550e559739b3ab12d7af19cc5109a6bdc583c0d5ba283569a64e90657aeb9f4fd659ab7fa24115ffc68a40df63f3eaf0528b9cf7678b131a06ff27bbb5358547f2e542cadc6349cb2df7306bbf6cd7d18fa48edb65d8884d3a36638b8e217ca0e3436cd1b0a27a6fdc6d1427d9ac3abe8d3b74dc25c35f64f347f858c727381fc4051d177149c7a7b84c42abc3edca76cf61a74586a64da1c82573def5e11ca96477c62816cda2e0213d5cd17115333aaee13a0fccbacf782dd58a888e49983a72c8e83821c367b8a1c382b910ba4a2755d0cd7ad79116adf7e05e1d79301e7fc5df747c8ef31a3a8673c5f2f8b895b2b82fe274703aa254cbe6691d5fe0bc8ea36087270e4f9a11551d916cb9588a8c999109f6312f864869d2c845f2850819dfc8f078e4f67e394e289db32c389413c98fdb36fac5c52f79e32c7cafb216aae57260ecb899a2f6b535fb6bb7f3a261cd7c5153772c0b2e706ce8d001be1c1edacf712a7f527a6bb82e6f86b2e54cc9529f59fdf55ab0ded9d69a78f749eb34149d5b29c22b7f812bcc3f55a6735bbdf7be1d916db7cef4dd3aa5a1bda68123ac4e524ec0cc5a54df5587bd544dd93d3f6172df861a306a1a0d16ec0f025ae83d26e71b53f9ec9451607ee761337e04f9c9868c7b85097943f71eabc51de8e637750c3ec49140039a842af8e3a049d8423d49187cfa8433d493c400d2b492b7f2ef2ecffb003fd699616ca3bc9d3349be697c2e8a5e8676416df90ec70635b9163b38eaf6067c173bf91c745677f1a911422d45beb98ad62fa8682376d750e4ff688ea2be05156dc6f76a280acc45945c50d110f6388afecd1d8bf834a3335476090d571088de40f0e80c4257d05815c3d1d81568d1f815f8a2cd812bf0471397b0b8397015fa552c915397d1780d4b05d0752cf3e3be1b587e54736666b0e21a9a2eba40fbb158fd060c30658bb11a2d6865296cc606a639c6246f645a0799d6434c729a491687b6d8401d8744ea57711049cac5a7a4ef739f5f491b95febb29b705b86d58797eeb4892e50189c51754212692441c8e5dc74a1fbec4aafd89af1064602e24e2ce54f340a02df015429c1449c21f505e75f2f72a887529313611650bc3bd8ec9bf8d798b33e4552f92ae1749ecc53e276dfb29f978ba1b07e8bf9f6797e0204f04f00327a1f6da56ae1de2cc52f86ea22588919b680ee2f0ac248bdf4b7c737c3d825127ef670823c0674f34c6142566d0128d715c1d8d736c95d4c54492ac05aa85daa2c0df8b46825e46b0cd84bc8e80c4b1a8adcf75ac07f7398ef5e087ca31910eaaf408b895fe9ae9e0bde5a4e3491e914cf6c4fe8960e01c02fe6b68932aaba4a6795fdc4ecdbeb8e4c0ef817884d11a453b2174d2f83aea1488115b9f07a21dfb7684713f81f9545417c31fdaa9dd446bad90063517e98ff0632798166d8ae6ae2863199728c6e24e143921f29c3836a9583d80101e64120d92d1980760970bb04b454e53d24105b0665a7fe22279d041d21e750cb7df404705c49ad92096aa9d134ce624bbcff200687701b4ab9ad494340f80075c00136c0151d15d01b0b602404d5c45671d1c59e2c8d1cdbc0747b78ba3dbc5d14d1febe2305c1c978943623c142586ae8aedfdf1c45544ce62859a60e53040e7a057b0b6cc83d5efe9f022a35c22ee32ab6d9a55f4302faf47d8e7a73d8d30e4621f72b10f31cd5b5487df89946a04a9b746e9e21e165ba896533ef914a42c4e3de1907584f545740381685b40bc4bc8108bb705e85d375daaf2acdd0d8fb2d01ea3d5c7b1923abad85955268ab83823187770469846bb61234ec3865821f72826f2c907af83e78c83a7d38327d1b46e06eb2b687a66a1b1cbfe296a7b1a2bf00ccbfe590f924e1749a78ba4d345d2e922697191582e927f7045740cd8b1f0f2b74dd66dce453610508b6dce1dd51688276c49507a59fc39ea7b5efe958836bc40067991fcfc126fa2973d88075cc4032ee20117f1808378156fb5e3e4f32a8bdb335b3923f90f816493248bf3147f42381e9de6aa448ba1bc8a6fed8fc69b36cce0b68a7b8db10423de5d85ee4df72b64ac577975bcc680bf4ee86f78ca72bd0b793d5b6e9ff30563b776031372bf82ec931f340e90a203a4cb01928837f54a862b207ae682b0b3fc16d59d65cdbdcd78bee301e025b7ec1c726b60ac2b00f8b3c701708c6f12cfd5bc075648d3b285dfacde0817dde60cab6def320aef29832df631d7e06a654653415f045fd34e4dd979c8b133e5dc371dd19804597843cabab62ddbc973d4f33eed7e407afcd0435c1daecd0e14944d918aee1543eb2d8ef59263dd74acb7d6f0327e0d7d73ddfc98ee7ce231d9ea9a6c75dc14a9acbe8be6383ced96984f79b1a68ec38959666d8f2f52d12542f894fe5cf6a4758d6b7e8debf11ac7639104887fb6ef2755c53c8c5f2ae53e2c278b3e4b36ece0f35534fe17504b0708ec308779cb09000028180000504b0304140008080800aa7b564e00000000000000000000000022000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e2e636c617373a552d14e1341143d03b5cb16aa28a8a0284a08697970131ff481a76a24694282a19507dfa6bb431d989da933b325fc9a0f7e801f65bc534ba5b6a5896eb23b3be79e7bcebd33f7c7cf6fdf01bcc64e84e711b623bc60a8367a3d6bfa5c7de80bed19569a5a0bfb5e71e7848bf092186dcbb53b1376c828699e0b86f55afde89cf779a2b8ee262d6fa5ee1e306c9e14dacb5c9c4a273b4a34b4369e7b69b463d83b9226d18572496ab4b73cf589cb2e123ee224a7525c9248d95de51da318963291ca9c2b4a5eacd59b0ccb9ea8aa55f47aea8a61e3ba869cfb2fc93bd96d6a2fbac29244dce154582a8ecf18ded4a61b37b2cc0ae70e668aec8c37f3915b6add0b3bd6d5fedcae4ec4d7425a9191e2921f1e26c3db39554d2faafe99eee85ae4d09a9ce1d33ca17fb489f86034e8ae63ae94b90cc7c9d0fe2fb799475d6999c2a6e2502af2a8b4cd85d0af0295616b42d0876832e030acfe19c2e3ceb9486942f76fcbd8fd6be06f278fcd7e99816101e1894b749788695fa15d99d66580b0952958157727b07b589dc0eee301a9dfc0b0466f144cd70784877844ff01ac2efc0647a1c7d81886d6166f864684cdd9b94ff0748aef388d085b83ef33dca135141a7c4ad46e488a10ff02504b070868fe421cca0100005e040000504b0304140008080800aa7b564e00000000000000000000000030000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e24417070726f76616c4576656e742e636c6173738d565b6f1b4514fec6bbde75b69bbb49d224b46929e05b6a2ee19a4b73218140d2943835b4406163af926d9cdd74771d90a0129540ea033c801020242e2f252f790089b80824c45390f82ffc03049c995dbb89e3243cf8ccd93367e67cdf7c6746fef39f5f7e03f018ae6988e34213148c7333c1cd248f4da998d63083e735bcc0cd0c66b937abe2450d2770218697f838c7cd7c0c176358e0ee256e5e56b1a822c71075deb64d97e1d49ce564ed72c9cb161cdb778d829ff58a6bd98962d1353d6f9841f5364cbbc853a39b46a96c3274cd5d37368decbae1af6627ad9559db37574c97529511cbb6fc3186cb89a3773d66b6e1f6c93c833ce5140940eb9c659b17cbebcba6bb642c9728d231e7148c52de702dfe1d06657fd5f2189a2736365c87b04f6f9ab6cfa0cfdac47caa64789e49d39983607c67cdb4b34bdc9edbb798389e5d2cdbbeb56ee62dcfa22a970cd758377dd39db06dc7377ccbb169cf546382462d27bb68de285bae59a41d632ba6bf10883190481e2747ccab659f39e694f98969b479ae2aa0e6edf9e065f381a03d54f6104979b930eb64e2706114a2639488f97d6152c9b057b20bcbd7cd823f9cbccac01c2ed28129219241a234e77ca3b0366f6c08eda8c1a9f4aae1ad06824b89e42c152156e5122533fa88f94ece772d7b85215e852f760ea2b4b39673ca6ec19cb1782f6842cdf33c4d471f967474a15b470f3727d1abe332f22a5e21e9fe7f37a87855c7237854c5151d4fe16986ee7a189365ab244e3bbe6fe5bbe2f28deab88ad7b8799d006606c28b364ae43203e2ae898c37740c6384a1adfef4187a1bea1ff6391d5a3e9059f43a43e7be7312413aa6fea308379aded362c4ab514b9054c60627c330983828cd41b5c2631aaecbaff6cf11f9fd89a9c3a771869ecc38a82b2121c215a78735c2451723e94ea346f37de8a7effbe9ab44a34c633c75172c95de412495d981941adc81fca358758a6c17a2646f50a68b267868818f4e94719aa2a9603d06f000203c5e97098f578e088fd796708efc4e89261f2467bf7d080f93e590b234f2e5d1d44f88fc50c3a088e03ba2a61e248435191248868bc7289b575404977b0c34117d8fd6dc143b74055935d44a889a2e444320523d90f71b0249370622d503f980d67c7808909e104806830d80c8f5406e3704725e2c3a0044ae07f211adf9f810205c335e98ae7cb8d75f9423d1782b95fe1e51793bbd8b965405d134fdee202a6da77f8732cf75dba58ea22143bf0ad4afd0ba45375ec4298b9f679020514cda9b205513e45db4f381627205b12db472ef0fa8f21664699b404882462f01053e818a4fe9e43e23989f13e52ff026be14b40602c0355ab7e89fc6e3824e1143148be009d1a0badac2fe46bf8a2715d6adb0b836cea9d32b1752ff393cc6e9805d734a306be26046da4ef7ad069c78580ac36f55e37210271a5a10efbb07bf43dc9eafe9367d43cdf32da6f0dd1e35a643d89d04fa193c4b5038d84128ede3ec5fbae511824b30c947e84718cbefffa445f49c862caed1b6bc51867ec5892b77a1773457484141a5b5a32df025eeb7073e616e6dbb594147059df58d77674fe30d8540231815760c67c3a746c173f42c35fd07504b0708ea7bbc798f040000e6090000504b0304140008080800aa7b564e00000000000000000000000030000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e245472616e736665724576656e742e636c6173738d56df531b5514fe6e76b31bb60be19740015b5aab8624b06ad156c36f84160da5051a0bd5da25d9c296b08bbb1b5e1c1ffa6ff8aebcf0a033923a3ae3f88433fe2ffe078e7aeedd854212c0879c7bf6dc73eef9cef9cebd933ffff9e53700efe189864e4c3441c12417535c4c73db8c8a590d73b8a3e12e177398e7dabc8a4f345cc244029ff235cfc54202f71258e4ea7d2e1ea85852b1cc203ff3dc6d862b79db359c4ad9378aae1378663130fcd29631552a7996efe7186281cb10df35cb158ba12bffdcdc358d6d33d834a6ed8d7927b0362c8fbc9451dbb183718687a9f30fbc60b7e1f18305823be3960840326f3bd6bdcaf6bae5ad98eb65b2b4e7dda2592e989ecdbf23a31c6cda3e43f38a673afe33cb9bddb59c80419f771ccb9b299bbe6fd176b61e4ce06e598eb1c2e58d53c154e3f5a58a13d8db56c1f66dca72dff4cc6d2bb0bc29c7710333b05d87ce4c372ed03cf63196acaf2ab66795e84475c30ae6040d03a9c18b8850fd23e76b17f498f72b4e47af70e6fc704dd0772124b187729d4163c23ff6ba9c3a9b0c854a30cb54ed6b9153d974368cc5f5e75631c80dae3130971353b72588318988e6e5c02c6e2d983b822f1a674abd69fa9b21c9526a709e92502d95323933fa4804ee72e0d9ce0643e7117c717268a593b565b7e215ad399bf3af090687b99b8e3eace8e842b78e1e2e2ea357c74314547c4674fdff0950f148c73b7857c5aa8e5bb8cdd05d0b63ba62974b96c7d0712af26b7ed5c674ace131179f132bd981c01da3b2b203e26689cd2f74e430cad05adb3786de867c47534ded2a84048bc9a6eca73a248cd4a0fef34a6db47d62a4a8eb8d8681483277762ca7c43094aa27a59ea7a841b91affa3c939c7bf3f3573f636aed1d3d8099a47488871aee9018d71bac54a8cd3aad17e1ffae9fb75fa2ad32ad3da997e0996ce1c2096ce1e404a0f1d40fe51445d21d98538c92c790ea109c36881810e1a82ab644d87f118c01b80d0785e26349e3926349e5bc20dd293120986374fc8b7f036490ec7a09587c6d33f21f6c3717e45186f8a7c7ae810e5634861300a1e276f9e4d1175bc42af09eb2d8ab92d4ee80abd8e112b1162ba060d8148b540720d81641a03916a814c50cce419407a2220596a743d10b916c84c4320c322a80e885c0be40ec5dc3d0308e78b27a68b1e9df517f970ea5ea433df232eef670ed192ae229ea1df77884bfb99dfa12c70de0e699a68c9d2af0af55b24f7a065859dbc783f4307896cd24907e9c8413e441b5fc8265791d843926b7f4095f7204bfb04421265f41250200f150bd4b94582f9804a5ec2975816650d84808fcb7a41ff266e8a724a18215b0cef8be1d4d516f637fa557ca0b06e85756a93bc747adba2d27f8eda381b56d79c1695357130a3ad57fb36c39ab8598acc4f8fec7268a732b4d0def70a7ebbb8398fe826add2f0ac119b8f4fb0311bc1ee20d01fe22382c2c10e41699b64ffd20d8f115c82493a223dc658e1f42705d1531a55f1848ee58332f22b2eadbe84dede5c25064529c9f6d65097b8de16ea8439d9fa4d15ed5574d40eded313833712018d614cc8715c8f9e19051fd393d4f41f504b0708826261e37e040000ca090000504b01020a000a0000080000aa7b564e000000000000000000000000030004000000000000000000000000000000696f2ffeca0000504b01020a000a0000080000aa7b564e000000000000000000000000080000000000000000000000000025000000696f2f6e756c732f504b01020a000a0000080000aa7b564e00000000000000000000000011000000000000000000000000004b000000696f2f6e756c732f636f6e74726163742f504b01020a000a0000080000aa7b564e00000000000000000000000017000000000000000000000000007a000000696f2f6e756c732f636f6e74726163742f746f6b656e2f504b01021400140008080800aa7b564eec308779cb090000281800002800000000000000000000000000af000000696f2f6e756c732f636f6e74726163742f746f6b656e2f53696d706c65546f6b656e2e636c617373504b01021400140008080800aa7b564e68fe421cca0100005e0400002200000000000000000000000000d00a0000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e2e636c617373504b01021400140008080800aa7b564eea7bbc798f040000e60900003000000000000000000000000000ea0c0000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e24417070726f76616c4576656e742e636c617373504b01021400140008080800aa7b564e826261e37e040000ca0900003000000000000000000000000000d7110000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e245472616e736665724576656e742e636c617373504b0506000000000800080051020000b31600000000",
"alias" : "restful_nrc20",
"args" : [ "io", "IO", 80000, 1 ]
}
# Example response data:
{
"success" : true,
"data" : {
"txHash" : "98dad7871ef9c02f19ba15929e2620e9465a410904ed8960b5893c9f3c4eb8fe",
"contractAddress" : "tNULSeBaMx7J2im9edmmyZofHoTWW6nCTbvy3K"
}
}
# 4.2 Calling the contract
# Cmd: /api/contract/call
- Call contract
# HttpMethod: POST
# Form JSON data
{
"sender" : null,
"gasLimit" : 0,
"price" : 0,
"password" : null,
"remark" : null,
"contractAddress" : null,
"value" : null,
"methodName" : null,
"methodDesc" : null,
"args" : null
}
# Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Call Contract | contractcall | Call Contract Form | Yes |
sender | string | Transaction Creator | Yes |
gasLimit | long | Maximum gas consumption | Yes |
price | long | Execution contract price | Yes |
password | string | Transaction Creator Account Password | Yes |
remark | string | Notes | No |
contractAddress | string | Smart Contract Address | Yes |
value | biginteger | The amount of the primary network asset that the caller transferred to the contract address. If there is no such service, fill in 0 | Yes |
methodName | string | method name | yes |
methodDesc | string | Method Description, if the method in the contract is not overloaded, this parameter can be empty | No |
args | object[] | Parameter List | No |
# Return values
Field Name | Field Type | Parameter Description |
---|---|---|
txHash | string | Call contract trading hash |
# Example request data:
request path: [TBD]
request form data:
{
"sender" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"gasLimit" : 20000,
"price" : 25,
"password" : "nuls123456",
"remark" : null,
"contractAddress" : "tNULSeBaMx7J2im9edmmyZofHoTWW6nCTbvy3K",
"value" : 0,
"methodName" : "transfer",
"methodDesc" : null,
"args" : [ "tNULSeBaMnrs6JKrCy6TQdzYJZkMZJDng7QAsD", 990 ]
}
# Example response data:
{
"success" : true,
"data" : {
"txHash" : "f7b04c3d0863d79b08d6bd2758899fce8b5a4f09d2142a12bf2545ff978e0250"
}
}
# 4.3 Deleting a contract
# Cmd: /api/contract/delete
- Delete contract #####HttpMethod: POST
#####Form JSON data
{
"sender" : null,
"contractAddress" : null,
"password" : null,
"remark" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Delete Contract | contractdelete | Delete Contract Form | Yes |
sender | string | Transaction Creator | Yes |
contractAddress | string | Smart Contract Address | Yes |
password | string | Transaction Creator Account Password | Yes |
remark | string | Notes | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
txHash | string | delete contract transaction hash |
# Example request data:
request path: [TBD]
request form data:
{
"sender" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"contractAddress" : "tNULSeBaMx7J2im9edmmyZofHoTWW6nCTbvy3K",
"password" : "nuls123456",
"remark" : "delete-remark"
}
#####Example response data:
{
"success" : true,
"data" : {
"txHash" : "c1ddf2254adf571ea441406bd0593d5fbc809e1e8aa8e5064fb3885fd7536f87"
}
}
# 4.4 Contract Token Transfer
# Cmd: /api/contract/tokentransfer
- Contract token transfer #####HttpMethod: POST
#####Form JSON data
{
"fromAddress" : null,
"password" : null,
"toAddress" : null,
"contractAddress" : null,
"amount" : null,
"remark" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
token transfer | contracttokentransfer | token transfer form | yes |
fromAddress | string | Transferr Account Address | Yes |
password | string | Transferr Account Address Password | Yes |
toAddress | string | Transferr Account Address | Yes |
contractAddress | string | Contract Address | Yes |
amount | biginteger | Amount of transferred token assets | Yes |
remark | string | Notes | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
txHash | string | Trading hash |
# Example request data:
request path: [TBD]
request form data:
{
"fromAddress" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"password" : "nuls123456",
"toAddress" : "tNULSeBaMnrs6JKrCy6TQdzYJZkMZJDng7QAsD",
"contractAddress" : "tNULSeBaNAKfKnLMR5XG5qtwXt5JS1b3QosZxg",
"amount" : 8000,
"remark" : "800"
}
#####Example response data:
{
"success" : true,
"data" : {
"txHash" : "a53fd2bff66a8e7ea243691afb95832d95cb2206c34684e233042ee3f399db5d"
}
}
# 4.5 Contract transaction from account address to contract address transfer (main chain asset)
# Cmd: /api/contract/transfer2contract
- Contract transaction from account address to contract address transfer (main chain asset) #####HttpMethod: POST
#####Form JSON data
{
"fromAddress" : null,
"password" : null,
"toAddress" : null,
"amount" : null,
"remark" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Transfer to Contract Address | contracttransfer | Transfer to Contract Address Form | Yes |
fromAddress | string | Transferr Account Address | Yes |
password | string | Transferr Account Address Password | Yes |
toAddress | string | Transferred contract address | Yes |
amount | biginteger | Transferred main chain asset amount | Yes |
remark | string | Notes | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
txHash | string | Trading hash |
# Example request data:
request path: [TBD]
request form data:
{
"fromAddress" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"password" : "nuls123456",
"toAddress" : "tNULSeBaMxyMyafiQjq1wCW7cQouyEhRL8njtu",
"amount" : "400000000",
"remark" : "Transfer to contract"
}
#####Example response data:
{
"success" : true,
"data" : {
"txHash" : "e04fcdbfd571754dac48d7c3cd8f3b6e9830e9ce00292fad0ec601ad50bb8d5e"
}
}
# 4.6 Get the token balance of the specified contract of the account address
# Cmd: /api/contract/balance/token/{contractAddress}/{address}
- Get the token balance of the specified contract of the account address
# HttpMethod: GET
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
contractAddress | string | contract address | yes |
address | string | account address | yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
contractAddress | string | contract address |
name | string | token name |
symbol | string | token symbol |
amount | string | token quantity |
decimals | long | Number of decimal places supported by token |
blockHeight | long | Block Height at Contract Creation |
status | int | Contract Status (0-None, 1-Normal, 2-End) |
# Example request data:
request path: http://localhost:18004/api/contract/balance/token/tNULSeBaNAKfKnLMR5XG5qtwXt5JS1b3QosZxg/tNULSeBaMnrs6JKrCy6TQdzYJZkMZJDng7QAsD
request form data: no
#####Example response data:
{
"success" : true,
"data" : {
"contractAddress" : "tNULSeBaNAKfKnLMR5XG5qtwXt5JS1b3QosZxg",
"name" : "io",
"symbol" : "IO",
"amount" : "8000",
"decimals" : 1,
"blockHeight" : 719,
"status" : 1
}
}
# 4.7 Getting Smart Contract Details
# Cmd: /api/contract/info/{address}
- Get smart contract details
# HttpMethod: GET
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
address | string | contract address | yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
createTxHash | string | publish contract trading hash |
address | string | contract address |
creater | string | contract creator address |
alias | string | contract alias |
createTime | long | contract creation time (unit: second) |
blockHeight | long | Block Height at Contract Creation |
isDirectPayable | boolean | Whether to accept direct transfer |
tokenType | int | token type, 0 - non-token, 1 - NRC20, 2 - NRC721 |
isNrc20 | boolean | Is it a NRC20 contract |
nrc20TokenName | string | NRC20-token name |
nrc20TokenSymbol | string | NRC20-token symbol |
decimals | long | Number of decimal places supported by NRC20-token |
totalSupply | string | NRC20-token Distribution Total |
status | string | contract status (not_found, normal, stop) |
method | list<object> | Contract Method List |
name | string | method name |
desc | string | Method Description |
args | list<object> | Method parameter list |
type | string | Parameter Type |
name | string | Parameter Name |
required | boolean | Required |
returnArg | string | Return value type |
view | boolean | Whether view method (calling this method data is not on the chain) |
event | boolean | Whether it is an event |
payable | boolean | Is it acceptable to transfer the main chain asset |
jsonSerializable | boolean | Method Returns whether JSON is serialized |
# Example request data:
request path: http://localhost:18004/api/contract/info/tNULSeBaMxyMyafiQjq1wCW7cQouyEhRL8njtu
request form data: no
#####Example response data:
{
"success" : true,
"data" : {
"createTxHash" : "de8825c942f50896f65c3c7c9ab18e388218568c7da64e09420a106b02edd81f",
"address" : "tNULSeBaMxyMyafiQjq1wCW7cQouyEhRL8njtu",
"creater" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"alias" : "rf_innercall_offline",
"createTime" : 1563285762,
"blockHeight" : 743,
"directPayable" : true,
"nrc20" : false,
"nrc20TokenName" : null,
"nrc20TokenSymbol" : null,
"decimals" : 0,
"totalSupply" : null,
"status" : "normal",
"method" : [ {
"name" : "_payable",
"desc" : "() return void",
"args" : [ ],
"returnArg" : "void",
"view" : false,
"event" : false,
"payable" : true
}, {
"name" : "<init>",
"desc" : "() return void",
"args" : [ ],
"returnArg" : "void",
"view" : false,
"event" : false,
"payable" : false
}, {
"name" : "getName",
"desc" : "() return String",
"args" : [ ],
"returnArg" : "String",
"view" : false,
"event" : false,
"payable" : false
}, {
"name" : "getSymbol",
"desc" : "() return String",
"args" : [ ],
"returnArg" : "String",
"view" : false,
"event" : false,
"payable" : false
}, {
"name" : "getDecimals",
"desc" : "() return int",
"args" : [ ],
"returnArg" : "int",
"view" : false,
"event" : false,
"payable" : false
}, {
"name" : "balance",
"desc" : "() return String",
"args" : [ ],
"returnArg" : "String",
"view" : false,
"event" : false,
"payable" : false
}, {
"name" : "single",
"desc" : "() return String",
"args" : [ ],
"returnArg" : "String",
"view" : false,
"event" : false,
"payable" : false
}, {
"name" : "multy",
"desc" : "() return String",
"args" : [ ],
"returnArg" : "String",
"view" : false,
"event" : false,
"payable" : true
}, {
"name" : "multyForAddress",
"desc" : "(Address add1, BigInteger add1_na, Address add2, BigInteger add2_na, String add3ForString, BigInteger add3_na) return String",
"args" : [ {
"type" : "Address",
"name" : "add1",
"required" : false
}, {
"type" : "BigInteger",
"name" : "add1_na",
"required" : false
}, {
"type" : "Address",
"name" : "add2",
"required" : false
}, {
"type" : "BigInteger",
"name" : "add2_na",
"required" : false
}, {
"type" : "String",
"name" : "add3ForString",
"required" : false
}, {
"type" : "BigInteger",
"name" : "add3_na",
"required" : false
} ],
"returnArg" : "String",
"view" : false,
"event" : false,
"payable" : true
}, {
"name" : "allInfo",
"desc" : "() return String",
"args" : [ ],
"returnArg" : "String",
"view" : false,
"event" : false,
"payable" : false
} ]
}
}
# 4.8 Getting Smart Contract Execution Results
# Cmd: /api/contract/result/{hash}
- Get smart contract execution results
# HttpMethod: GET
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
hash | string | transaction hash | yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
success | boolean | Successful contract execution |
errorMessage | string | Execution failure information |
contractAddress | string | contract address |
result | string | Contract execution result |
gasLimit | long | GAS Limit |
gasUsed | long | GAS has been used |
price | long | GAS unit price |
totalFee | string | Total transaction fee |
txSizeFee | string | Transaction Size Fee |
actualContractFee | string | Actual execution contract fee |
refundFee | string | Contract return fee |
value | string | The amount of the primary network asset that the caller transferred to the contract address. If there is no such service, it is 0 |
stackTrace | string | Exception Stack Trace |
transfers | list<object> | Contract Transfer List (from contract) |
txHash | string | Contract Generation Transaction: Contract Transfer Transaction hash |
from | string | Transferred contract address |
value | string | Transfer amount |
outputs | list<object> | Transferred Address List |
to | string | |
value | string | |
orginTxHash | string | Call contract transaction hash (source transaction hash, contract transaction derived from calling contract transaction) |
events | list<string> | Contract Event List |
tokenTransfers | list<object> | Contract Token Transfer List |
contractAddress | string | Contract Address |
from | string | Payment Party |
to | string | Payee |
value | string | Transfer amount |
name | string | token name |
symbol | string | token symbol |
decimals | long | Number of decimal places supported by token |
invokeRegisterCmds | list<object> | Contract Call List of Calls to External Commands |
cmdName | string | command name |
args | map | Command parameters, parameters are not fixed, according to different commands, so not described here, the structure is {parameter name=parameter value} |
cmdRegisterMode | string | Registered Command Mode (QUERY_DATA or NEW_TX) |
newTxHash | string | generated transaction hash (when the command mode called is NEW_TX, the transaction is generated) |
contractTxList | list<string> | List of serialized strings for contract generation transactions |
remark | string | Notes |
# Example request data:
request path: http://localhost:18004/api/contract/result/f0a5fc5d20c39355e35f1fe8011b1a28e7c65d8566ae8d76b297a22d1110851d
request form data: no
#####Example response data:
{
"success" : true,
"data" : {
"flag" : true,
"data" : {
"success" : true,
"errorMessage" : null,
"contractAddress" : "tNULSeBaN1rhd9k9eqNkvwC9HXBWLQ79dRuy81",
"result" : "multyForAddress: 888634777633",
"gasLimit" : 200000,
"gasUsed" : 20038,
"price" : 25,
"totalFee" : "5100000",
"txSizeFee" : "100000",
"actualContractFee" : "500950",
"refundFee" : "4499050",
"value" : 10000000000,
"stackTrace" : null,
"transfers" : [ {
"txHash" : "4877f6a865dea5b4ac82a8370d73e62da15bc7acb2145a03822dddfdab329d2b",
"from" : "tNULSeBaN1rhd9k9eqNkvwC9HXBWLQ79dRuy81",
"value" : "200000000",
"outputs" : [ {
"to" : "tNULSeBaMp9wC9PcWEcfesY7YmWrPfeQzkN1xL",
"value" : "100000000"
}, {
"to" : "tNULSeBaMshNPEnuqiDhMdSA4iNs6LMgjY6tcL",
"value" : "100000000"
} ],
"orginTxHash" : "b5473eefecd1c70ac4276f70062a92bdbfe8f779cbe48de2d0315686cc7e6789"
} ],
"events" : [ "{\"contractAddress\":\"TTb1LZLo6izPGmXa9dGPmb5D2vpLpNqA\",\"blockNumber\":1343847,\"event\":\"TransferEvent\",\"payload\":{\"from\":\"TTasNs8MGGGaFT9hd9DLmkammYYv69vs\",\"to\":\"TTau7kAxyhc4yMomVJ2QkMVECKKZK1uG\",\"value\":\"1000\"}}" ],
"tokenTransfers" : [ {
"contractAddress" : "TTb1LZLo6izPGmXa9dGPmb5D2vpLpNqA",
"from" : "TTasNs8MGGGaFT9hd9DLmkammYYv69vs",
"to" : "TTau7kAxyhc4yMomVJ2QkMVECKKZK1uG",
"value" : "1000",
"name" : "a",
"symbol" : "a",
"decimals" : 8
} ],
"invokeRegisterCmds" : [ {
"cmdName" : "cs_createContractAgent",
"args" : {
"contractBalance" : "2030000000000",
"commissionRate" : "100",
"chainId" : 2,
"deposit" : "2000000000000",
"contractAddress" : "tNULSeBaMzZedU4D3xym1JcyNa5sqtuFku8AKm",
"contractNonce" : "0000000000000000",
"blockTime" : 1562564381,
"packingAddress" : "tNULSeBaMtEPLXxUgyfnBt9bpb5Xv84dyJV98p",
"contractSender" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG"
},
"cmdRegisterMode" : "NEW_TX",
"newTxHash" : "a8eae11b52990e39c9d3233ba1d2c8827336d261c0f14aca43dd4f06435dfaba"
} ],
"contractTxList" : [ "12002fbb225d0037b5473eefecd1c70ac4276f70062a92bdbfe8f779cbe48de2d0315686cc7e678902000253472f4702eb83b71871a4c4e0c71526bb86b8afd0011702000253472f4702eb83b71871a4c4e0c71526bb86b8af0200010000c2eb0b0000000000000000000000000000000000000000000000000000000008000000000000000000021702000194f6239c075d184e265eaea97a67eeced51725160200010000e1f50500000000000000000000000000000000000000000000000000000000000000000000000017020001ce8ffa95606f0bfd2778cff2eff8fe8999e20c440200010000e1f50500000000000000000000000000000000000000000000000000000000000000000000000000", "1400bf6b285d006600204aa9d1010000000000000000000000000000000000000000000000000000020002f246b18e8c697f00ed9bd22696998e469d3f824b020001d7424d91c83566eb94233b5416f2aa77709c03e1020002f246b18e8c697f00ed9bd22696998e469d3f824b648c0117020002f246b18e8c697f00ed9bd22696998e469d3f824b0200010000204aa9d1010000000000000000000000000000000000000000000000000000080000000000000000000117020002f246b18e8c697f00ed9bd22696998e469d3f824b0200010000204aa9d1010000000000000000000000000000000000000000000000000000ffffffffffffffff00" ],
"remark" : "call"
}
}
}
# 4.9 Get the list of smart contract execution results
# Cmd: /api/contract/result/list
- Get smart contract execution result list #####HttpMethod: POST
#####Form JSON data
{
"hashList" : [ ]
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Get the list of smart contract execution results | contractresultlistform | Get smart contract execution result list form | Yes |
hashList | list<string> | Trading hash list | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash1 or hash2 or hash3... | object | Use the hash value in the transaction hash list as the key, where the key name is dynamic |
success | boolean | Successful contract execution |
errorMessage | string | Execution Failure Information |
contractAddress | string | Contract Address |
result | string | Contract execution results |
gasLimit | long | GAS Limit |
gasUsed | long | GAS has been used |
price | long | GAS unit price |
totalFee | string | Total Transaction Fees |
txSizeFee | string | Transaction Size Fees |
actualContractFee | string | Actual Execution Contract Fee |
refundFee | string | Fees returned by the contract |
value | string | The amount of the primary network asset that the caller transferred to the contract address, or 0 if there is no such service |
stackTrace | string | Exception Stack Trace |
transfers | list<object> | Contract Transfer List (from contract) |
txHash | string | Contract Generation Transaction: Contract Transfer Transaction hash |
from | string | Transferred contract address |
value | string | Transfer amount |
outputs | list<object> | Transferred Address List |
to | string | transfer address |
value | string | Transfer amount |
orginTxHash | string | Call contract transaction hash (source transaction hash, contract transaction is called Contract trading is derived) |
events | list<string> | Contract Event List |
tokenTransfers | list<object> | Contract Token Transfer List |
contractAddress | string | contract address |
from | string | payment |
to | string | Payee |
value | string | Transfer amount |
name | string | token name |
symbol | string | token symbol |
decimals | long | Number of decimal places supported by token |
invokeRegisterCmds | list<object> | Contract Call List of Calls for External Commands |
cmdName | string | command name |
args | map | command parameters, parameters are not fixed, depending on different commands Therefore, it is not described here, and the structure is {parameter name=parameter value} |
cmdRegisterMode | string | Registered Command Mode (QUERY_DATA or NEW_TX) |
newTxHash | string | generated transaction hash (when the command mode is called NEW\ When _TX, a transaction will be generated) |
contractTxList | list<string> | Serialized String List for Contract Generation Transactions |
remark | string | Notes |
# Example request data:
request path: [TBD]
request form data:
{
"hashList" : [ "c2460b94430074dd98e497ed9d48afb8f44d1323b73ca2086f5abaa0684b760d", "48b2f348f201f9d10848f4031a746919470b679f621327b0e0edf50a339f2e87", "2e99610b7d295790b636fcdb8acf72d70fcae61c873df0984ef248bbbaa6daa2" ]
}
#####Example response data:
{
"success" : true,
"data" : {
"c2460b94430074dd98e497ed9d48afb8f44d1323b73ca2086f5abaa0684b760d" : {
"success" : true,
"errorMessage" : null,
"contractAddress" : "tNULSeBaN5Y2gRias1NMNVmsmXqJbu5Bcp3ZPL",
"result" : null,
"gasLimit" : 20000,
"gasUsed" : 13429,
"price" : 30,
"totalFee" : "1300000",
"txSizeFee" : "700000",
"actualContractFee" : "402870",
"refundFee" : "197130",
"value" : "0",
"stackTrace" : null,
"transfers" : [ ],
"events" : [ "{\"contractAddress\":\"tNULSeBaN5Y2gRias1NMNVmsmXqJbu5Bcp3ZPL\",\"blockNumber\":68,\"event\":\"TransferEvent\",\"payload\":{\"from\":null,\"to\":\"tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG\",\"value\":\"800000\"}}" ],
"tokenTransfers" : [ {
"contractAddress" : "tNULSeBaN5Y2gRias1NMNVmsmXqJbu5Bcp3ZPL",
"from" : null,
"to" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"value" : "800000",
"name" : "io",
"symbol" : "IO",
"decimals" : 1
} ],
"invokeRegisterCmds" : [ ],
"contractTxList" : [ ],
"remark" : "create"
},
"48b2f348f201f9d10848f4031a746919470b679f621327b0e0edf50a339f2e87" : {
"success" : true,
"errorMessage" : null,
"contractAddress" : "tNULSeBaN5Y2gRias1NMNVmsmXqJbu5Bcp3ZPL",
"result" : "true",
"gasLimit" : 200000,
"gasUsed" : 9444,
"price" : 30,
"totalFee" : "6100000",
"txSizeFee" : "100000",
"actualContractFee" : "283320",
"refundFee" : "5716680",
"value" : "0",
"stackTrace" : null,
"transfers" : [ ],
"events" : [ "{\"contractAddress\":\"tNULSeBaN5Y2gRias1NMNVmsmXqJbu5Bcp3ZPL\",\"blockNumber\":71,\"event\":\"TransferEvent\",\"payload\":{\"from\":\"tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG\",\"to\":\"tNULSeBaMtkzQ1tH8JWBGZDCmRHCmySevE4frM\",\"value\":\"4000\"}}" ],
"tokenTransfers" : [ {
"contractAddress" : "tNULSeBaN5Y2gRias1NMNVmsmXqJbu5Bcp3ZPL",
"from" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"to" : "tNULSeBaMtkzQ1tH8JWBGZDCmRHCmySevE4frM",
"value" : "4000",
"name" : "io",
"symbol" : "IO",
"decimals" : 1
} ],
"invokeRegisterCmds" : [ ],
"contractTxList" : [ ],
"remark" : "call"
},
"2e99610b7d295790b636fcdb8acf72d70fcae61c873df0984ef248bbbaa6daa2" : {
"success" : true,
"errorMessage" : null,
"contractAddress" : "tNULSeBaN5Y2gRias1NMNVmsmXqJbu5Bcp3ZPL",
"result" : "true",
"gasLimit" : 200000,
"gasUsed" : 5836,
"price" : 30,
"totalFee" : "6100000",
"txSizeFee" : "100000",
"actualContractFee" : "175080",
"refundFee" : "5824920",
"value" : "0",
"stackTrace" : null,
"transfers" : [ ],
"events" : [ "{\"contractAddress\":\"tNULSeBaN5Y2gRias1NMNVmsmXqJbu5Bcp3ZPL\",\"blockNumber\":72,\"event\":\"ApprovalEvent\",\"payload\":{\"owner\":\"tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG\",\"spender\":\"tNULSeBaMtkzQ1tH8JWBGZDCmRHCmySevE4frM\",\"value\":\"4000\"}}" ],
"tokenTransfers" : [ ],
"invokeRegisterCmds" : [ ],
"contractTxList" : [ ],
"remark" : "call"
}
}
}
# 4.10 Get Contract Code Constructor
# Cmd: /api/contract/constructor
- Get contract code constructor #####HttpMethod: POST
#####Form JSON data
{
"contractCode" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Get Contract Code Constructor | contractcode | Get Contract Code Constructor Form | Yes |
contractCode | string | Smart Contract Code (Hex encoded string of bytecode) | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
Constructor | object | contract constructor details |
name | string | method name |
desc | string | Method Description |
args | list<object> | Method parameter list |
type | string | Parameter Type |
name | string | Parameter Name |
required | boolean | Required |
returnArg | string | Return value type |
view | boolean | Whether view method (calling this method data is not on the chain) |
event | boolean | Whether it is an event |
payable | boolean | Is it acceptable to transfer the main chain asset |
jsonSerializable | boolean | Method Returns whether JSON is serialized |
isNrc20 | boolean | Is it a NRC20 contract |
# Example request data:
request path: [TBD]
request form data:
{
"contractCode" : "504b03040a0000080000aa7b564e00000000000000000000000003000400696f2ffeca0000504b03040a0000080000aa7b564e00000000000000000000000008000000696f2f6e756c732f504b03040a0000080000aa7b564e00000000000000000000000011000000696f2f6e756c732f636f6e74726163742f504b03040a0000080000aa7b564e00000000000000000000000017000000696f2f6e756c732f636f6e74726163742f746f6b656e2f504b0304140008080800aa7b564e00000000000000000000000028000000696f2f6e756c732f636f6e74726163742f746f6b656e2f53696d706c65546f6b656e2e636c617373b558f97754e5197eeecc90990c972d9090059209a498cc9291a58a8152020d35ca5602b1605bbd99b9492ecc12670922b46ead4babd56aeb5ad1565bd4aa2c020169d59ed353cfe93fd17f84d3d3e7fdee9d3b37612639d5d31ff2ddf77ecbfb3eeff67c77f2afff7cf639804df87b23a23825c323329c96e14c1831fcb411cdf859108f86119497281e93e171997e22cce149197e1ec62ff0d462acc2d3413c13c672fc2a8ce7f0bcccfc3a8817827831cc53bf91e125195e96e5df8af4bb205e09a3430e44f19a0cafcbf086a87d5386df87f096cc9c9597b7457a27843fc8f38f21bc2b7ade0be24f41fc39887341bcaf219033b2a686a6bdc78d692399317213c99152c1ca4d6cd3d0503c951dcb673484d266caca1a99a2066d58c3e252be646446ca535399531a5aeca359a33499dc654d0ce74ae68459e0f1d098417d2993a796d97bca252b93dc674c71b171c49ac819a57281c68766af6edf6be593b972a6984ce573a582912a258be913c9c174ba60168bdb6a9bdb419d412393c99f34d31a4a5f43e337342f0056f5f6d58a6360773e6d4a10ac9cb9bf9c1d330b878db18c8a7a3e6564468d8225efce64a0346931643db7c228e54f98b9e488959de26691a9bbed503957b2b2e6a855b4787c3097636e4a563e47151b6a7b62b87b92a39679924afcbd7d4c6b6b05fdada96cd86ee5acd20e0d3b7a6f75b0decc5c35c37da31a968822cbc80c66f304ae61dd6cfc078d02ebb164166639125dd09143e64365ab60a6a5b2541548e16938dcbb4032e75dad1b8e45f99339b3a0a173fef3acc8e294994bcb565d1d19ac14e8a269235336a5796655c0a9a94a152c192919a9132c47f56eb302b5d048ae386e16f614f2590d47be917bb5bdeb3bc6121c57ea7da53cc3e974f181710d772c60af6ec0828e129242c5030d772e84be2ebea0313555c84f53dd722b972a9846d11c543306c92a6ca4d3667ad48eef7232d79cf565c5f29832e66e0ae53315510ebb49fabf84973d1032ec2d1babe2260f2ed77eb868565f96550e559739b3ab12d7af19cc5109a6bdc583c0d5ba283569a64e90657aeb9f4fd659ab7fa24115ffc68a40df63f3eaf0528b9cf7678b131a06ff27bbb5358547f2e542cadc6349cb2df7306bbf6cd7d18fa48edb65d8884d3a36638b8e217ca0e3436cd1b0a27a6fdc6d1427d9ac3abe8d3b74dc25c35f64f347f858c727381fc4051d177149c7a7b84c42abc3edca76cf61a74586a64da1c82573def5e11ca96477c62816cda2e0213d5cd17115333aaee13a0fccbacf782dd58a888e49983a72c8e83821c367b8a1c382b910ba4a2755d0cd7ad79116adf7e05e1d79301e7fc5df747c8ef31a3a8673c5f2f8b895b2b82fe274703aa254cbe6691d5fe0bc8ea36087270e4f9a11551d916cb9588a8c999109f6312f864869d2c845f2850819dfc8f078e4f67e394e289db32c389413c98fdb36fac5c52f79e32c7cafb216aae57260ecb899a2f6b535fb6bb7f3a261cd7c5153772c0b2e706ce8d001be1c1edacf712a7f527a6bb82e6f86b2e54cc9529f59fdf55ab0ded9d69a78f749eb34149d5b29c22b7f812bcc3f55a6735bbdf7be1d916db7cef4dd3aa5a1bda68123ac4e524ec0cc5a54df5587bd544dd93d3f6172df861a306a1a0d16ec0f025ae83d26e71b53f9ec9451607ee761337e04f9c9868c7b85097943f71eabc51de8e637750c3ec49140039a842af8e3a049d8423d49187cfa8433d493c400d2b492b7f2ef2ecffb003fd699616ca3bc9d3349be697c2e8a5e8676416df90ec70635b9163b38eaf6067c173bf91c745677f1a911422d45beb98ad62fa8682376d750e4ff688ea2be05156dc6f76a280acc45945c50d110f6388afecd1d8bf834a3335476090d571088de40f0e80c4257d05815c3d1d81568d1f815f8a2cd812bf0471397b0b8397015fa552c915397d1780d4b05d0752cf3e3be1b587e54736666b0e21a9a2eba40fbb158fd060c30658bb11a2d6865296cc606a639c6246f645a0799d6434c729a491687b6d8401d8744ea57711049cac5a7a4ef739f5f491b95febb29b705b86d58797eeb4892e50189c51754212692441c8e5dc74a1fbec4aafd89af1064602e24e2ce54f340a02df015429c1449c21f505e75f2f72a887529313611650bc3bd8ec9bf8d798b33e4552f92ae1749ecc53e276dfb29f978ba1b07e8bf9f6797e0204f04f00327a1f6da56ae1de2cc52f86ea22588919b680ee2f0ac248bdf4b7c737c3d825127ef670823c0674f34c6142566d0128d715c1d8d736c95d4c54492ac05aa85daa2c0df8b46825e46b0cd84bc8e80c4b1a8adcf75ac07f7398ef5e087ca31910eaaf408b895fe9ae9e0bde5a4e3491e914cf6c4fe8960e01c02fe6b68932aaba4a6795fdc4ecdbeb8e4c0ef817884d11a453b2174d2f83aea1488115b9f07a21dfb7684713f81f9545417c31fdaa9dd446bad90063517e98ff0632798166d8ae6ae2863199728c6e24e143921f29c3836a9583d80101e64120d92d1980760970bb04b454e53d24105b0665a7fe22279d041d21e750cb7df404705c49ad92096aa9d134ce624bbcff200687701b4ab9ad494340f80075c00136c0151d15d01b0b602404d5c45671d1c59e2c8d1cdbc0747b78ba3dbc5d14d1febe2305c1c978943623c142586ae8aedfdf1c45544ce62859a60e53040e7a057b0b6cc83d5efe9f022a35c22ee32ab6d9a55f4302faf47d8e7a73d8d30e4621f72b10f31cd5b5487df89946a04a9b746e9e21e165ba896533ef914a42c4e3de1907584f545740381685b40bc4bc8108bb705e85d375daaf2acdd0d8fb2d01ea3d5c7b1923abad85955268ab83823187770469846bb61234ec3865821f72826f2c907af83e78c83a7d38327d1b46e06eb2b687a66a1b1cbfe296a7b1a2bf00ccbfe590f924e1749a78ba4d345d2e922697191582e927f7045740cd8b1f0f2b74dd66dce453610508b6dce1dd51688276c49507a59fc39ea7b5efe958836bc40067991fcfc126fa2973d88075cc4032ee20117f1808378156fb5e3e4f32a8bdb335b3923f90f816493248bf3147f42381e9de6aa448ba1bc8a6fed8fc69b36cce0b68a7b8db10423de5d85ee4df72b64ac577975bcc680bf4ee86f78ca72bd0b793d5b6e9ff30563b776031372bf82ec931f340e90a203a4cb01928837f54a862b207ae682b0b3fc16d59d65cdbdcd78bee301e025b7ec1c726b60ac2b00f8b3c701708c6f12cfd5bc075648d3b285dfacde0817dde60cab6def320aef29832df631d7e06a654653415f045fd34e4dd979c8b133e5dc371dd19804597843cabab62ddbc973d4f33eed7e407afcd0435c1daecd0e14944d918aee1543eb2d8ef59263dd74acb7d6f0327e0d7d73ddfc98ee7ce231d9ea9a6c75dc14a9acbe8be6383ced96984f79b1a68ec38959666d8f2f52d12542f894fe5cf6a4758d6b7e8debf11ac7639104887fb6ef2755c53c8c5f2ae53e2c278b3e4b36ece0f35534fe17504b0708ec308779cb09000028180000504b0304140008080800aa7b564e00000000000000000000000022000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e2e636c617373a552d14e1341143d03b5cb16aa28a8a0284a08697970131ff481a76a24694282a19507dfa6bb431d989da933b325fc9a0f7e801f65bc534ba5b6a5896eb23b3be79e7bcebd33f7c7cf6fdf01bcc64e84e711b623bc60a8367a3d6bfa5c7de80bed19569a5a0bfb5e71e7848bf092186dcbb53b1376c828699e0b86f55afde89cf779a2b8ee262d6fa5ee1e306c9e14dacb5c9c4a273b4a34b4369e7b69b463d83b9226d18572496ab4b73cf589cb2e123ee224a7525c9248d95de51da318963291ca9c2b4a5eacd59b0ccb9ea8aa55f47aea8a61e3ba869cfb2fc93bd96d6a2fbac29244dce154582a8ecf18ded4a61b37b2cc0ae70e668aec8c37f3915b6add0b3bd6d5fedcae4ec4d7425a9191e2921f1e26c3db39554d2faafe99eee85ae4d09a9ce1d33ca17fb489f86034e8ae63ae94b90cc7c9d0fe2fb799475d6999c2a6e2502af2a8b4cd85d0af0295616b42d0876832e030acfe19c2e3ceb9486942f76fcbd8fd6be06f278fcd7e99816101e1894b749788695fa15d99d66580b0952958157727b07b589dc0eee301a9dfc0b0466f144cd70784877844ff01ac2efc0647a1c7d81886d6166f864684cdd9b94ff0748aef388d085b83ef33dca135141a7c4ad46e488a10ff02504b070868fe421cca0100005e040000504b0304140008080800aa7b564e00000000000000000000000030000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e24417070726f76616c4576656e742e636c6173738d565b6f1b4514fec6bbde75b69bbb49d224b46929e05b6a2ee19a4b73218140d2943835b4406163af926d9cdd74771d90a0129540ea033c801020242e2f252f790089b80824c45390f82ffc03049c995dbb89e3243cf8ccd93367e67cdf7c6746fef39f5f7e03f018ae6988e34213148c7333c1cd248f4da998d63083e735bcc0cd0c66b937abe2450d2770218697f838c7cd7c0c176358e0ee256e5e56b1a822c71075deb64d97e1d49ce564ed72c9cb161cdb778d829ff58a6bd98962d1353d6f9841f5364cbbc853a39b46a96c3274cd5d37368decbae1af6627ad9559db37574c97529511cbb6fc3186cb89a3773d66b6e1f6c93c833ce5140940eb9c659b17cbebcba6bb642c9728d231e7148c52de702dfe1d06657fd5f2189a2736365c87b04f6f9ab6cfa0cfdac47caa64789e49d39983607c67cdb4b34bdc9edbb798389e5d2cdbbeb56ee62dcfa22a970cd758377dd39db06dc7377ccbb169cf546382462d27bb68de285bae59a41d632ba6bf10883190481e2747ccab659f39e694f98969b479ae2aa0e6edf9e065f381a03d54f6104979b930eb64e2706114a2639488f97d6152c9b057b20bcbd7cd823f9cbccac01c2ed28129219241a234e77ca3b0366f6c08eda8c1a9f4aae1ad06824b89e42c152156e5122533fa88f94ece772d7b85215e852f760ea2b4b39673ca6ec19cb1782f6842cdf33c4d471f967474a15b470f3727d1abe332f22a5e21e9fe7f37a87855c7237854c5151d4fe16986ee7a189365ab244e3bbe6fe5bbe2f28deab88ad7b8799d006606c28b364ae43203e2ae898c37740c6384a1adfef4187a1bea1ff6391d5a3e9059f43a43e7be7312413aa6fea308379aded362c4ab514b9054c60627c330983828cd41b5c2631aaecbaff6cf11f9fd89a9c3a771869ecc38a82b2121c215a78735c2451723e94ea346f37de8a7effbe9ab44a34c633c75172c95de412495d981941adc81fca358758a6c17a2646f50a68b267868818f4e94719aa2a9603d06f000203c5e97098f578e088fd796708efc4e89261f2467bf7d080f93e590b234f2e5d1d44f88fc50c3a088e03ba2a61e248435191248868bc7289b575404977b0c34117d8fd6dc143b74055935d44a889a2e444320523d90f71b0249370622d503f980d67c7808909e104806830d80c8f5406e3704725e2c3a0044ae07f211adf9f810205c335e98ae7cb8d75f9423d1782b95fe1e51793bbd8b965405d134fdee202a6da77f8732cf75dba58ea22143bf0ad4afd0ba45375ec4298b9f679020514cda9b205513e45db4f381627205b12db472ef0fa8f21664699b404882462f01053e818a4fe9e43e23989f13e52ff026be14b40602c0355ab7e89fc6e3824e1143148be009d1a0badac2fe46bf8a2715d6adb0b836cea9d32b1752ff393cc6e9805d734a306be26046da4ef7ad069c78580ac36f55e37210271a5a10efbb07bf43dc9eafe9367d43cdf32da6f0dd1e35a643d89d04fa193c4b5038d84128ede3ec5fbae511824b30c947e84718cbefffa445f49c862caed1b6bc51867ec5892b77a1773457484141a5b5a32df025eeb7073e616e6dbb594147059df58d77674fe30d8540231815760c67c3a746c173f42c35fd07504b0708ea7bbc798f040000e6090000504b0304140008080800aa7b564e00000000000000000000000030000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e245472616e736665724576656e742e636c6173738d56df531b5514fe6e76b31bb60be19740015b5aab8624b06ad156c36f84160da5051a0bd5da25d9c296b08bbb1b5e1c1ffa6ff8aebcf0a033923a3ae3f88433fe2ffe078e7aeedd854212c0879c7bf6dc73eef9cef9cebd933ffff9e53700efe189864e4c3441c12417535c4c73db8c8a590d73b8a3e12e177398e7dabc8a4f345cc244029ff235cfc54202f71258e4ea7d2e1ea85852b1cc203ff3dc6d862b79db359c4ad9378aae1378663130fcd29631552a7996efe7186281cb10df35cb158ba12bffdcdc358d6d33d834a6ed8d7927b0362c8fbc9451dbb183718687a9f30fbc60b7e1f18305823be3960840326f3bd6bdcaf6bae5ad98eb65b2b4e7dda2592e989ecdbf23a31c6cda3e43f38a673afe33cb9bddb59c80419f771ccb9b299bbe6fd176b61e4ce06e598eb1c2e58d53c154e3f5a58a13d8db56c1f66dca72dff4cc6d2bb0bc29c7710333b05d87ce4c372ed03cf63196acaf2ab66795e84475c30ae6040d03a9c18b8850fd23e76b17f498f72b4e47af70e6fc704dd0772124b187729d4163c23ff6ba9c3a9b0c854a30cb54ed6b9153d974368cc5f5e75631c80dae3130971353b72588318988e6e5c02c6e2d983b822f1a674abd69fa9b21c9526a709e92502d95323933fa4804ee72e0d9ce0643e7117c717268a593b565b7e215ad399bf3af090687b99b8e3eace8e842b78e1e2e2ea357c74314547c4674fdff0950f148c73b7857c5aa8e5bb8cdd05d0b63ba62974b96c7d0712af26b7ed5c674ace131179f132bd981c01da3b2b203e26689cd2f74e430cad05adb3786de867c47534ded2a84048bc9a6eca73a248cd4a0fef34a6db47d62a4a8eb8d8681483277762ca7c43094aa27a59ea7a841b91affa3c939c7bf3f3573f636aed1d3d8099a47488871aee9018d71bac54a8cd3aad17e1ffae9fb75fa2ad32ad3da997e0996ce1c2096ce1e404a0f1d40fe51445d21d98538c92c790ea109c36881810e1a82ab644d87f118c01b80d0785e26349e3926349e5bc20dd293120986374fc8b7f036490ec7a09587c6d33f21f6c3717e45186f8a7c7ae810e5634861300a1e276f9e4d1175bc42af09eb2d8ab92d4ee80abd8e112b1162ba060d8148b540720d81641a03916a814c50cce419407a2220596a743d10b916c84c4320c322a80e885c0be40ec5dc3d0308e78b27a68b1e9df517f970ea5ea433df232eef670ed192ae229ea1df77884bfb99dfa12c70de0e699a68c9d2af0af55b24f7a065859dbc783f4307896cd24907e9c8413e441b5fc8265791d843926b7f4095f7204bfb04421265f41250200f150bd4b94582f9804a5ec2975816650d84808fcb7a41ff266e8a724a18215b0cef8be1d4d516f637fa557ca0b06e85756a93bc747adba2d27f8eda381b56d79c1695357130a3ad57fb36c39ab8598acc4f8fec7268a732b4d0def70a7ebbb8398fe826add2f0ac119b8f4fb0311bc1ee20d01fe22382c2c10e41699b64ffd20d8f115c82493a223dc658e1f42705d1531a55f1848ee58332f22b2eadbe84dede5c25064529c9f6d65097b8de16ea8439d9fa4d15ed5574d40eded313833712018d614cc8715c8f9e19051fd393d4f41f504b0708826261e37e040000ca090000504b01020a000a0000080000aa7b564e000000000000000000000000030004000000000000000000000000000000696f2ffeca0000504b01020a000a0000080000aa7b564e000000000000000000000000080000000000000000000000000025000000696f2f6e756c732f504b01020a000a0000080000aa7b564e00000000000000000000000011000000000000000000000000004b000000696f2f6e756c732f636f6e74726163742f504b01020a000a0000080000aa7b564e00000000000000000000000017000000000000000000000000007a000000696f2f6e756c732f636f6e74726163742f746f6b656e2f504b01021400140008080800aa7b564eec308779cb090000281800002800000000000000000000000000af000000696f2f6e756c732f636f6e74726163742f746f6b656e2f53696d706c65546f6b656e2e636c617373504b01021400140008080800aa7b564e68fe421cca0100005e0400002200000000000000000000000000d00a0000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e2e636c617373504b01021400140008080800aa7b564eea7bbc798f040000e60900003000000000000000000000000000ea0c0000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e24417070726f76616c4576656e742e636c617373504b01021400140008080800aa7b564e826261e37e040000ca0900003000000000000000000000000000d7110000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e245472616e736665724576656e742e636c617373504b0506000000000800080051020000b31600000000"
}
#####Example response data:
{
"success" : true,
"data" : {
"constructor" : {
"name" : "<init>",
"desc" : "(String name, String symbol, BigInteger initialAmount, int decimals) return void",
"args" : [ {
"type" : "String",
"name" : "name",
"required" : true
}, {
"type" : "String",
"name" : "symbol",
"required" : true
}, {
"type" : "BigInteger",
"name" : "initialAmount",
"required" : true
}, {
"type" : "int",
"name" : "decimals",
"required" : true
} ],
"returnArg" : "void",
"view" : false,
"event" : false,
"payable" : false
},
"nrc20" : true
}
}
# 4.11 Get information about the specified function of the published contract
# Cmd: /api/contract/method
- Get information about the specified function of the published contract #####HttpMethod: POST
#####Form JSON data
{
"contractAddress" : null,
"methodName" : null,
"methodDesc" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Get information about the specified function of the published contract | contractmethodform | Get the information form of the specified function of the published contract | Yes |
contractAddress | string | Smart Contract Address | Yes |
methodName | string | method name | yes |
methodDesc | string | Method Description, if the method in the contract is not overloaded, this parameter can be empty | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
name | string | method name |
desc | string | Method Description |
args | list<object> | Method parameter list |
type | string | Parameter Type |
name | string | Parameter Name |
required | boolean | Required? |
returnArg | string | return value type |
view | boolean | whether the view method (calling this method data is not on the chain) |
event | boolean | Whether it is an event |
payable | boolean | Is it a method of accepting main chain asset transfers |
jsonSerializable | boolean | Method Returns whether JSON is serialized |
# Example request data:
request path: [TBD]
request form data:
{
"contractAddress" : "tNULSeBaMxyMyafiQjq1wCW7cQouyEhRL8njtu",
"methodName" : "multyForAddress",
"methodDesc" : null
}
#####Example response data:
{
"success" : true,
"data" : {
"name" : "multyForAddress",
"desc" : "(Address add1, BigInteger add1_na, Address add2, BigInteger add2_na, String add3ForString, BigInteger add3_na) return String",
"args" : [ {
"type" : "Address",
"name" : "add1",
"required" : false
}, {
"type" : "BigInteger",
"name" : "add1_na",
"required" : false
}, {
"type" : "Address",
"name" : "add2",
"required" : false
}, {
"type" : "BigInteger",
"name" : "add2_na",
"required" : false
}, {
"type" : "String",
"name" : "add3ForString",
"required" : false
}, {
"type" : "BigInteger",
"name" : "add3_na",
"required" : false
} ],
"returnArg" : "String",
"view" : false,
"event" : false,
"payable" : true
}
}
# 4.12 Get the list of parameter types for the specified function of the published contract
# Cmd: /api/contract/method/argstypes
- Get a list of parameter types for the specified function of the published contract #####HttpMethod: POST
#####Form JSON data
{
"contractAddress" : null,
"methodName" : null,
"methodDesc" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Get the list of parameter types for the specified function of the published contract | contractmethodform | Get the parameter type form of the specified function of the published contract | Yes |
contractAddress | string | Smart Contract Address | Yes |
methodName | string | method name | yes |
methodDesc | string | Method Description, if the method in the contract is not overloaded, this parameter can be empty | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
Return value | list<string> |
# Example request data:
request path: [TBD]
request form data:
{
"contractAddress" : "tNULSeBaMxyMyafiQjq1wCW7cQouyEhRL8njtu",
"methodName" : "multyForAddress",
"methodDesc" : null
}
#####Example response data:
{
"success" : true,
"data" : [ "Address", "BigInteger", "Address", "BigInteger", "String", "BigInteger" ]
}
# 4.13 Verifying the release contract
# Cmd: /api/contract/validate/create
- Verify the release contract #####HttpMethod: POST
#####Form JSON data
{
"sender" : null,
"gasLimit" : 0,
"price" : 0,
"contractCode" : null,
"args" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Verify Release Contract | contractvalidatecreate | Verify Release Contract Form | Yes |
sender | string | Transaction Creator | Yes |
gasLimit | long | Maximum gas consumption | Yes |
price | long | Execution contract price | Yes |
contractCode | string | Smart Contract Code (Hex encoded string of bytecode) | Yes |
args | object[] | Parameter List | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
success | boolean | Verify success or not |
code | string | Error code for verification failure |
msg | string | Verify failed error message |
# Example request data:
request path: [TBD]
request form data:
{
"sender" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"gasLimit" : 20000,
"price" : 25,
"contractCode" : "504b03040a0000080000aa7b564e00000000000000000000000003000400696f2ffeca0000504b03040a0000080000aa7b564e00000000000000000000000008000000696f2f6e756c732f504b03040a0000080000aa7b564e00000000000000000000000011000000696f2f6e756c732f636f6e74726163742f504b03040a0000080000aa7b564e00000000000000000000000017000000696f2f6e756c732f636f6e74726163742f746f6b656e2f504b0304140008080800aa7b564e00000000000000000000000028000000696f2f6e756c732f636f6e74726163742f746f6b656e2f53696d706c65546f6b656e2e636c617373b558f97754e5197eeecc90990c972d9090059209a498cc9291a58a8152020d35ca5602b1605bbd99b9492ecc12670922b46ead4babd56aeb5ad1565bd4aa2c020169d59ed353cfe93fd17f84d3d3e7fdee9d3b37612639d5d31ff2ddf77ecbfb3eeff67c77f2afff7cf639804df87b23a23825c323329c96e14c1831fcb411cdf859108f86119497281e93e171997e22cce149197e1ec62ff0d462acc2d3413c13c672fc2a8ce7f0bcccfc3a8817827831cc53bf91e125195e96e5df8af4bb205e09a3430e44f19a0cafcbf086a87d5386df87f096cc9c9597b7457a27843fc8f38f21bc2b7ade0be24f41fc39887341bcaf219033b2a686a6bdc78d692399317213c99152c1ca4d6cd3d0503c951dcb673484d266caca1a99a2066d58c3e252be646446ca535399531a5aeca359a33499dc654d0ce74ae68459e0f1d098417d2993a796d97bca252b93dc674c71b171c49ac819a57281c68766af6edf6be593b972a6984ce573a582912a258be913c9c174ba60168bdb6a9bdb419d412393c99f34d31a4a5f43e337342f0056f5f6d58a6360773e6d4a10ac9cb9bf9c1d330b878db18c8a7a3e6564468d8225efce64a0346931643db7c228e54f98b9e488959de26691a9bbed503957b2b2e6a855b4787c3097636e4a563e47151b6a7b62b87b92a39679924afcbd7d4c6b6b05fdada96cd86ee5acd20e0d3b7a6f75b0decc5c35c37da31a968822cbc80c66f304ae61dd6cfc078d02ebb164166639125dd09143e64365ab60a6a5b2541548e16938dcbb4032e75dad1b8e45f99339b3a0a173fef3acc8e294994bcb565d1d19ac14e8a269235336a5796655c0a9a94a152c192919a9132c47f56eb302b5d048ae386e16f614f2590d47be917bb5bdeb3bc6121c57ea7da53cc3e974f181710d772c60af6ec0828e129242c5030d772e84be2ebea0313555c84f53dd722b972a9846d11c543306c92a6ca4d3667ad48eef7232d79cf565c5f29832e66e0ae53315510ebb49fabf84973d1032ec2d1babe2260f2ed77eb868565f96550e559739b3ab12d7af19cc5109a6bdc583c0d5ba283569a64e90657aeb9f4fd659ab7fa24115ffc68a40df63f3eaf0528b9cf7678b131a06ff27bbb5358547f2e542cadc6349cb2df7306bbf6cd7d18fa48edb65d8884d3a36638b8e217ca0e3436cd1b0a27a6fdc6d1427d9ac3abe8d3b74dc25c35f64f347f858c727381fc4051d177149c7a7b84c42abc3edca76cf61a74586a64da1c82573def5e11ca96477c62816cda2e0213d5cd17115333aaee13a0fccbacf782dd58a888e49983a72c8e83821c367b8a1c382b910ba4a2755d0cd7ad79116adf7e05e1d79301e7fc5df747c8ef31a3a8673c5f2f8b895b2b82fe274703aa254cbe6691d5fe0bc8ea36087270e4f9a11551d916cb9588a8c999109f6312f864869d2c845f2850819dfc8f078e4f67e394e289db32c389413c98fdb36fac5c52f79e32c7cafb216aae57260ecb899a2f6b535fb6bb7f3a261cd7c5153772c0b2e706ce8d001be1c1edacf712a7f527a6bb82e6f86b2e54cc9529f59fdf55ab0ded9d69a78f749eb34149d5b29c22b7f812bcc3f55a6735bbdf7be1d916db7cef4dd3aa5a1bda68123ac4e524ec0cc5a54df5587bd544dd93d3f6172df861a306a1a0d16ec0f025ae83d26e71b53f9ec9451607ee761337e04f9c9868c7b85097943f71eabc51de8e637750c3ec49140039a842af8e3a049d8423d49187cfa8433d493c400d2b492b7f2ef2ecffb003fd699616ca3bc9d3349be697c2e8a5e8676416df90ec70635b9163b38eaf6067c173bf91c745677f1a911422d45beb98ad62fa8682376d750e4ff688ea2be05156dc6f76a280acc45945c50d110f6388afecd1d8bf834a3335476090d571088de40f0e80c4257d05815c3d1d81568d1f815f8a2cd812bf0471397b0b8397015fa552c915397d1780d4b05d0752cf3e3be1b587e54736666b0e21a9a2eba40fbb158fd060c30658bb11a2d6865296cc606a639c6246f645a0799d6434c729a491687b6d8401d8744ea57711049cac5a7a4ef739f5f491b95febb29b705b86d58797eeb4892e50189c51754212692441c8e5dc74a1fbec4aafd89af1064602e24e2ce54f340a02df015429c1449c21f505e75f2f72a887529313611650bc3bd8ec9bf8d798b33e4552f92ae1749ecc53e276dfb29f978ba1b07e8bf9f6797e0204f04f00327a1f6da56ae1de2cc52f86ea22588919b680ee2f0ac248bdf4b7c737c3d825127ef670823c0674f34c6142566d0128d715c1d8d736c95d4c54492ac05aa85daa2c0df8b46825e46b0cd84bc8e80c4b1a8adcf75ac07f7398ef5e087ca31910eaaf408b895fe9ae9e0bde5a4e3491e914cf6c4fe8960e01c02fe6b68932aaba4a6795fdc4ecdbeb8e4c0ef817884d11a453b2174d2f83aea1488115b9f07a21dfb7684713f81f9545417c31fdaa9dd446bad90063517e98ff0632798166d8ae6ae2863199728c6e24e143921f29c3836a9583d80101e64120d92d1980760970bb04b454e53d24105b0665a7fe22279d041d21e750cb7df404705c49ad92096aa9d134ce624bbcff200687701b4ab9ad494340f80075c00136c0151d15d01b0b602404d5c45671d1c59e2c8d1cdbc0747b78ba3dbc5d14d1febe2305c1c978943623c142586ae8aedfdf1c45544ce62859a60e53040e7a057b0b6cc83d5efe9f022a35c22ee32ab6d9a55f4302faf47d8e7a73d8d30e4621f72b10f31cd5b5487df89946a04a9b746e9e21e165ba896533ef914a42c4e3de1907584f545740381685b40bc4bc8108bb705e85d375daaf2acdd0d8fb2d01ea3d5c7b1923abad85955268ab83823187770469846bb61234ec3865821f72826f2c907af83e78c83a7d38327d1b46e06eb2b687a66a1b1cbfe296a7b1a2bf00ccbfe590f924e1749a78ba4d345d2e922697191582e927f7045740cd8b1f0f2b74dd66dce453610508b6dce1dd51688276c49507a59fc39ea7b5efe958836bc40067991fcfc126fa2973d88075cc4032ee20117f1808378156fb5e3e4f32a8bdb335b3923f90f816493248bf3147f42381e9de6aa448ba1bc8a6fed8fc69b36cce0b68a7b8db10423de5d85ee4df72b64ac577975bcc680bf4ee86f78ca72bd0b793d5b6e9ff30563b776031372bf82ec931f340e90a203a4cb01928837f54a862b207ae682b0b3fc16d59d65cdbdcd78bee301e025b7ec1c726b60ac2b00f8b3c701708c6f12cfd5bc075648d3b285dfacde0817dde60cab6def320aef29832df631d7e06a654653415f045fd34e4dd979c8b133e5dc371dd19804597843cabab62ddbc973d4f33eed7e407afcd0435c1daecd0e14944d918aee1543eb2d8ef59263dd74acb7d6f0327e0d7d73ddfc98ee7ce231d9ea9a6c75dc14a9acbe8be6383ced96984f79b1a68ec38959666d8f2f52d12542f894fe5cf6a4758d6b7e8debf11ac7639104887fb6ef2755c53c8c5f2ae53e2c278b3e4b36ece0f35534fe17504b0708ec308779cb09000028180000504b0304140008080800aa7b564e00000000000000000000000022000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e2e636c617373a552d14e1341143d03b5cb16aa28a8a0284a08697970131ff481a76a24694282a19507dfa6bb431d989da933b325fc9a0f7e801f65bc534ba5b6a5896eb23b3be79e7bcebd33f7c7cf6fdf01bcc64e84e711b623bc60a8367a3d6bfa5c7de80bed19569a5a0bfb5e71e7848bf092186dcbb53b1376c828699e0b86f55afde89cf779a2b8ee262d6fa5ee1e306c9e14dacb5c9c4a273b4a34b4369e7b69b463d83b9226d18572496ab4b73cf589cb2e123ee224a7525c9248d95de51da318963291ca9c2b4a5eacd59b0ccb9ea8aa55f47aea8a61e3ba869cfb2fc93bd96d6a2fbac29244dce154582a8ecf18ded4a61b37b2cc0ae70e668aec8c37f3915b6add0b3bd6d5fedcae4ec4d7425a9191e2921f1e26c3db39554d2faafe99eee85ae4d09a9ce1d33ca17fb489f86034e8ae63ae94b90cc7c9d0fe2fb799475d6999c2a6e2502af2a8b4cd85d0af0295616b42d0876832e030acfe19c2e3ceb9486942f76fcbd8fd6be06f278fcd7e99816101e1894b749788695fa15d99d66580b0952958157727b07b589dc0eee301a9dfc0b0466f144cd70784877844ff01ac2efc0647a1c7d81886d6166f864684cdd9b94ff0748aef388d085b83ef33dca135141a7c4ad46e488a10ff02504b070868fe421cca0100005e040000504b0304140008080800aa7b564e00000000000000000000000030000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e24417070726f76616c4576656e742e636c6173738d565b6f1b4514fec6bbde75b69bbb49d224b46929e05b6a2ee19a4b73218140d2943835b4406163af926d9cdd74771d90a0129540ea033c801020242e2f252f790089b80824c45390f82ffc03049c995dbb89e3243cf8ccd93367e67cdf7c6746fef39f5f7e03f018ae6988e34213148c7333c1cd248f4da998d63083e735bcc0cd0c66b937abe2450d2770218697f838c7cd7c0c176358e0ee256e5e56b1a822c71075deb64d97e1d49ce564ed72c9cb161cdb778d829ff58a6bd98962d1353d6f9841f5364cbbc853a39b46a96c3274cd5d37368decbae1af6627ad9559db37574c97529511cbb6fc3186cb89a3773d66b6e1f6c93c833ce5140940eb9c659b17cbebcba6bb642c9728d231e7148c52de702dfe1d06657fd5f2189a2736365c87b04f6f9ab6cfa0cfdac47caa64789e49d39983607c67cdb4b34bdc9edbb798389e5d2cdbbeb56ee62dcfa22a970cd758377dd39db06dc7377ccbb169cf546382462d27bb68de285bae59a41d632ba6bf10883190481e2747ccab659f39e694f98969b479ae2aa0e6edf9e065f381a03d54f6104979b930eb64e2706114a2639488f97d6152c9b057b20bcbd7cd823f9cbccac01c2ed28129219241a234e77ca3b0366f6c08eda8c1a9f4aae1ad06824b89e42c152156e5122533fa88f94ece772d7b85215e852f760ea2b4b39673ca6ec19cb1782f6842cdf33c4d471f967474a15b470f3727d1abe332f22a5e21e9fe7f37a87855c7237854c5151d4fe16986ee7a189365ab244e3bbe6fe5bbe2f28deab88ad7b8799d006606c28b364ae43203e2ae898c37740c6384a1adfef4187a1bea1ff6391d5a3e9059f43a43e7be7312413aa6fea308379aded362c4ab514b9054c60627c330983828cd41b5c2631aaecbaff6cf11f9fd89a9c3a771869ecc38a82b2121c215a78735c2451723e94ea346f37de8a7effbe9ab44a34c633c75172c95de412495d981941adc81fca358758a6c17a2646f50a68b267868818f4e94719aa2a9603d06f000203c5e97098f578e088fd796708efc4e89261f2467bf7d080f93e590b234f2e5d1d44f88fc50c3a088e03ba2a61e248435191248868bc7289b575404977b0c34117d8fd6dc143b74055935d44a889a2e444320523d90f71b0249370622d503f980d67c7808909e104806830d80c8f5406e3704725e2c3a0044ae07f211adf9f810205c335e98ae7cb8d75f9423d1782b95fe1e51793bbd8b965405d134fdee202a6da77f8732cf75dba58ea22143bf0ad4afd0ba45375ec4298b9f679020514cda9b205513e45db4f381627205b12db472ef0fa8f21664699b404882462f01053e818a4fe9e43e23989f13e52ff026be14b40602c0355ab7e89fc6e3824e1143148be009d1a0badac2fe46bf8a2715d6adb0b836cea9d32b1752ff393cc6e9805d734a306be26046da4ef7ad069c78580ac36f55e37210271a5a10efbb07bf43dc9eafe9367d43cdf32da6f0dd1e35a643d89d04fa193c4b5038d84128ede3ec5fbae511824b30c947e84718cbefffa445f49c862caed1b6bc51867ec5892b77a1773457484141a5b5a32df025eeb7073e616e6dbb594147059df58d77674fe30d8540231815760c67c3a746c173f42c35fd07504b0708ea7bbc798f040000e6090000504b0304140008080800aa7b564e00000000000000000000000030000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e245472616e736665724576656e742e636c6173738d56df531b5514fe6e76b31bb60be19740015b5aab8624b06ad156c36f84160da5051a0bd5da25d9c296b08bbb1b5e1c1ffa6ff8aebcf0a033923a3ae3f88433fe2ffe078e7aeedd854212c0879c7bf6dc73eef9cef9cebd933ffff9e53700efe189864e4c3441c12417535c4c73db8c8a590d73b8a3e12e177398e7dabc8a4f345cc244029ff235cfc54202f71258e4ea7d2e1ea85852b1cc203ff3dc6d862b79db359c4ad9378aae1378663130fcd29631552a7996efe7186281cb10df35cb158ba12bffdcdc358d6d33d834a6ed8d7927b0362c8fbc9451dbb183718687a9f30fbc60b7e1f18305823be3960840326f3bd6bdcaf6bae5ad98eb65b2b4e7dda2592e989ecdbf23a31c6cda3e43f38a673afe33cb9bddb59c80419f771ccb9b299bbe6fd176b61e4ce06e598eb1c2e58d53c154e3f5a58a13d8db56c1f66dca72dff4cc6d2bb0bc29c7710333b05d87ce4c372ed03cf63196acaf2ab66795e84475c30ae6040d03a9c18b8850fd23e76b17f498f72b4e47af70e6fc704dd0772124b187729d4163c23ff6ba9c3a9b0c854a30cb54ed6b9153d974368cc5f5e75631c80dae3130971353b72588318988e6e5c02c6e2d983b822f1a674abd69fa9b21c9526a709e92502d95323933fa4804ee72e0d9ce0643e7117c717268a593b565b7e215ad399bf3af090687b99b8e3eace8e842b78e1e2e2ea357c74314547c4674fdff0950f148c73b7857c5aa8e5bb8cdd05d0b63ba62974b96c7d0712af26b7ed5c674ace131179f132bd981c01da3b2b203e26689cd2f74e430cad05adb3786de867c47534ded2a84048bc9a6eca73a248cd4a0fef34a6db47d62a4a8eb8d8681483277762ca7c43094aa27a59ea7a841b91affa3c939c7bf3f3573f636aed1d3d8099a47488871aee9018d71bac54a8cd3aad17e1ffae9fb75fa2ad32ad3da997e0996ce1c2096ce1e404a0f1d40fe51445d21d98538c92c790ea109c36881810e1a82ab644d87f118c01b80d0785e26349e3926349e5bc20dd293120986374fc8b7f036490ec7a09587c6d33f21f6c3717e45186f8a7c7ae810e5634861300a1e276f9e4d1175bc42af09eb2d8ab92d4ee80abd8e112b1162ba060d8148b540720d81641a03916a814c50cce419407a2220596a743d10b916c84c4320c322a80e885c0be40ec5dc3d0308e78b27a68b1e9df517f970ea5ea433df232eef670ed192ae229ea1df77884bfb99dfa12c70de0e699a68c9d2af0af55b24f7a065859dbc783f4307896cd24907e9c8413e441b5fc8265791d843926b7f4095f7204bfb04421265f41250200f150bd4b94582f9804a5ec2975816650d84808fcb7a41ff266e8a724a18215b0cef8be1d4d516f637fa557ca0b06e85756a93bc747adba2d27f8eda381b56d79c1695357130a3ad57fb36c39ab8598acc4f8fec7268a732b4d0def70a7ebbb8398fe826add2f0ac119b8f4fb0311bc1ee20d01fe22382c2c10e41699b64ffd20d8f115c82493a223dc658e1f42705d1531a55f1848ee58332f22b2eadbe84dede5c25064529c9f6d65097b8de16ea8439d9fa4d15ed5574d40eded313833712018d614cc8715c8f9e19051fd393d4f41f504b0708826261e37e040000ca090000504b01020a000a0000080000aa7b564e000000000000000000000000030004000000000000000000000000000000696f2ffeca0000504b01020a000a0000080000aa7b564e000000000000000000000000080000000000000000000000000025000000696f2f6e756c732f504b01020a000a0000080000aa7b564e00000000000000000000000011000000000000000000000000004b000000696f2f6e756c732f636f6e74726163742f504b01020a000a0000080000aa7b564e00000000000000000000000017000000000000000000000000007a000000696f2f6e756c732f636f6e74726163742f746f6b656e2f504b01021400140008080800aa7b564eec308779cb090000281800002800000000000000000000000000af000000696f2f6e756c732f636f6e74726163742f746f6b656e2f53696d706c65546f6b656e2e636c617373504b01021400140008080800aa7b564e68fe421cca0100005e0400002200000000000000000000000000d00a0000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e2e636c617373504b01021400140008080800aa7b564eea7bbc798f040000e60900003000000000000000000000000000ea0c0000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e24417070726f76616c4576656e742e636c617373504b01021400140008080800aa7b564e826261e37e040000ca0900003000000000000000000000000000d7110000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e245472616e736665724576656e742e636c617373504b0506000000000800080051020000b31600000000",
"args" : [ "io", "IO", 80000, 1 ]
}
#####Example response data:
[ {
"success" : true,
"data" : {
"success" : true
}
}, "For a verification failure example, please refer to [/api/contract/validate/call] - Verify the call contract" ]
# 4.14 Verifying the call contract
# Cmd: /api/contract/validate/call
- Verify call contract #####HttpMethod: POST
#####Form JSON data
{
"sender" : null,
"value" : 0,
"gasLimit" : 0,
"price" : 0,
"contractAddress" : null,
"methodName" : null,
"methodDesc" : null,
"args" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Verify Call Contract | contractvalidatecall | Verify Call Contract Form | Yes |
sender | string | Transaction Creator | Yes |
value | long | The amount of the primary network asset that the caller transferred to the contract address. If there is no such service, fill in 0 | No |
gasLimit | long | Maximum gas consumption | Yes |
price | long | Execution contract price | Yes |
contractAddress | string | Smart Contract Address | Yes |
methodName | string | method name | yes |
methodDesc | string | Method Description, if the method in the contract is not overloaded, this parameter can be empty | No |
args | object[] | Parameter List | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
success | boolean | Verify success or not |
code | string | Error code for verification failure |
msg | string | Verify failed error message |
# Example request data:
request path: [TBD]
request form data:
{
"sender" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"value" : 0,
"gasLimit" : 20000,
"price" : 25,
"contractAddress" : "tNULSeBaMx7J2im9edmmyZofHoTWW6nCTbvy3K",
"methodName" : "transfer",
"methodDesc" : null,
"args" : [ "tNULSeBaMnrs6JKrCy6TQdzYJZkMZJDng7QAsD", 990 ]
}
#####Example response data:
[ {
"success" : true,
"data" : {
"success" : true
}
}, {
"success" : true,
"data" : {
"msg" : "Data error;contract error - contract[tNULSeBaMx7J2im9edmmyZofHoTWW6nCTbvy3K] has stopped",
"success" : false,
"code" : "err_0014"
}
} ]
# 4.15 Verify the deletion of the contract
# Cmd: /api/contract/validate/delete
- Verify delete contract #####HttpMethod: POST
#####Form JSON data
{
"sender" : null,
"contractAddress" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Verify Delete Contract | contractvalidatedelete | Verify Delete Contract Form | Yes |
sender | string | Transaction Creator | Yes |
contractAddress | string | Smart Contract Address | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
success | boolean | Verify success or not |
code | string | Error code for verification failure |
msg | string | Verify failed error message |
# Example request data:
request path: [TBD]
request form data:
{
"sender" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"contractAddress" : "tNULSeBaNAKfKnLMR5XG5qtwXt5JS1b3QosZxg"
}
#####Example response data:
[ {
"success" : true,
"data" : {
"success" : true
}
}, "For a verification failure example, please refer to [/api/contract/validate/call] - Verify the call contract" ]
# 4.16 Estimating the release of the contract transaction gas
# Cmd: /api/contract/imputedgas/create
- Estimate the release of the contract transaction gas #####HttpMethod: POST
#####Form JSON data
{
"sender" : null,
"contractCode" : null,
"args" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Estimate GAS for publishing contract transactions | imputedgascontractcreate | Estimate GAS form for publishing contract transactions | Yes |
sender | string | Transaction Creator | Yes |
contractCode | string | Smart Contract Code (Hex encoded string of bytecode) | Yes |
args | object[] | Parameter List | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
gasLimit | long | The consumed gas value, the execution failed to return the value 1 |
# Example request data:
request path: [TBD]
request form data:
{
"sender" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"contractCode" : "504b03040a0000080000aa7b564e00000000000000000000000003000400696f2ffeca0000504b03040a0000080000aa7b564e00000000000000000000000008000000696f2f6e756c732f504b03040a0000080000aa7b564e00000000000000000000000011000000696f2f6e756c732f636f6e74726163742f504b03040a0000080000aa7b564e00000000000000000000000017000000696f2f6e756c732f636f6e74726163742f746f6b656e2f504b0304140008080800aa7b564e00000000000000000000000028000000696f2f6e756c732f636f6e74726163742f746f6b656e2f53696d706c65546f6b656e2e636c617373b558f97754e5197eeecc90990c972d9090059209a498cc9291a58a8152020d35ca5602b1605bbd99b9492ecc12670922b46ead4babd56aeb5ad1565bd4aa2c020169d59ed353cfe93fd17f84d3d3e7fdee9d3b37612639d5d31ff2ddf77ecbfb3eeff67c77f2afff7cf639804df87b23a23825c323329c96e14c1831fcb411cdf859108f86119497281e93e171997e22cce149197e1ec62ff0d462acc2d3413c13c672fc2a8ce7f0bcccfc3a8817827831cc53bf91e125195e96e5df8af4bb205e09a3430e44f19a0cafcbf086a87d5386df87f096cc9c9597b7457a27843fc8f38f21bc2b7ade0be24f41fc39887341bcaf219033b2a686a6bdc78d692399317213c99152c1ca4d6cd3d0503c951dcb673484d266caca1a99a2066d58c3e252be646446ca535399531a5aeca359a33499dc654d0ce74ae68459e0f1d098417d2993a796d97bca252b93dc674c71b171c49ac819a57281c68766af6edf6be593b972a6984ce573a582912a258be913c9c174ba60168bdb6a9bdb419d412393c99f34d31a4a5f43e337342f0056f5f6d58a6360773e6d4a10ac9cb9bf9c1d330b878db18c8a7a3e6564468d8225efce64a0346931643db7c228e54f98b9e488959de26691a9bbed503957b2b2e6a855b4787c3097636e4a563e47151b6a7b62b87b92a39679924afcbd7d4c6b6b05fdada96cd86ee5acd20e0d3b7a6f75b0decc5c35c37da31a968822cbc80c66f304ae61dd6cfc078d02ebb164166639125dd09143e64365ab60a6a5b2541548e16938dcbb4032e75dad1b8e45f99339b3a0a173fef3acc8e294994bcb565d1d19ac14e8a269235336a5796655c0a9a94a152c192919a9132c47f56eb302b5d048ae386e16f614f2590d47be917bb5bdeb3bc6121c57ea7da53cc3e974f181710d772c60af6ec0828e129242c5030d772e84be2ebea0313555c84f53dd722b972a9846d11c543306c92a6ca4d3667ad48eef7232d79cf565c5f29832e66e0ae53315510ebb49fabf84973d1032ec2d1babe2260f2ed77eb868565f96550e559739b3ab12d7af19cc5109a6bdc583c0d5ba283569a64e90657aeb9f4fd659ab7fa24115ffc68a40df63f3eaf0528b9cf7678b131a06ff27bbb5358547f2e542cadc6349cb2df7306bbf6cd7d18fa48edb65d8884d3a36638b8e217ca0e3436cd1b0a27a6fdc6d1427d9ac3abe8d3b74dc25c35f64f347f858c727381fc4051d177149c7a7b84c42abc3edca76cf61a74586a64da1c82573def5e11ca96477c62816cda2e0213d5cd17115333aaee13a0fccbacf782dd58a888e49983a72c8e83821c367b8a1c382b910ba4a2755d0cd7ad79116adf7e05e1d79301e7fc5df747c8ef31a3a8673c5f2f8b895b2b82fe274703aa254cbe6691d5fe0bc8ea36087270e4f9a11551d916cb9588a8c999109f6312f864869d2c845f2850819dfc8f078e4f67e394e289db32c389413c98fdb36fac5c52f79e32c7cafb216aae57260ecb899a2f6b535fb6bb7f3a261cd7c5153772c0b2e706ce8d001be1c1edacf712a7f527a6bb82e6f86b2e54cc9529f59fdf55ab0ded9d69a78f749eb34149d5b29c22b7f812bcc3f55a6735bbdf7be1d916db7cef4dd3aa5a1bda68123ac4e524ec0cc5a54df5587bd544dd93d3f6172df861a306a1a0d16ec0f025ae83d26e71b53f9ec9451607ee761337e04f9c9868c7b85097943f71eabc51de8e637750c3ec49140039a842af8e3a049d8423d49187cfa8433d493c400d2b492b7f2ef2ecffb003fd699616ca3bc9d3349be697c2e8a5e8676416df90ec70635b9163b38eaf6067c173bf91c745677f1a911422d45beb98ad62fa8682376d750e4ff688ea2be05156dc6f76a280acc45945c50d110f6388afecd1d8bf834a3335476090d571088de40f0e80c4257d05815c3d1d81568d1f815f8a2cd812bf0471397b0b8397015fa552c915397d1780d4b05d0752cf3e3be1b587e54736666b0e21a9a2eba40fbb158fd060c30658bb11a2d6865296cc606a639c6246f645a0799d6434c729a491687b6d8401d8744ea57711049cac5a7a4ef739f5f491b95febb29b705b86d58797eeb4892e50189c51754212692441c8e5dc74a1fbec4aafd89af1064602e24e2ce54f340a02df015429c1449c21f505e75f2f72a887529313611650bc3bd8ec9bf8d798b33e4552f92ae1749ecc53e276dfb29f978ba1b07e8bf9f6797e0204f04f00327a1f6da56ae1de2cc52f86ea22588919b680ee2f0ac248bdf4b7c737c3d825127ef670823c0674f34c6142566d0128d715c1d8d736c95d4c54492ac05aa85daa2c0df8b46825e46b0cd84bc8e80c4b1a8adcf75ac07f7398ef5e087ca31910eaaf408b895fe9ae9e0bde5a4e3491e914cf6c4fe8960e01c02fe6b68932aaba4a6795fdc4ecdbeb8e4c0ef817884d11a453b2174d2f83aea1488115b9f07a21dfb7684713f81f9545417c31fdaa9dd446bad90063517e98ff0632798166d8ae6ae2863199728c6e24e143921f29c3836a9583d80101e64120d92d1980760970bb04b454e53d24105b0665a7fe22279d041d21e750cb7df404705c49ad92096aa9d134ce624bbcff200687701b4ab9ad494340f80075c00136c0151d15d01b0b602404d5c45671d1c59e2c8d1cdbc0747b78ba3dbc5d14d1febe2305c1c978943623c142586ae8aedfdf1c45544ce62859a60e53040e7a057b0b6cc83d5efe9f022a35c22ee32ab6d9a55f4302faf47d8e7a73d8d30e4621f72b10f31cd5b5487df89946a04a9b746e9e21e165ba896533ef914a42c4e3de1907584f545740381685b40bc4bc8108bb705e85d375daaf2acdd0d8fb2d01ea3d5c7b1923abad85955268ab83823187770469846bb61234ec3865821f72826f2c907af83e78c83a7d38327d1b46e06eb2b687a66a1b1cbfe296a7b1a2bf00ccbfe590f924e1749a78ba4d345d2e922697191582e927f7045740cd8b1f0f2b74dd66dce453610508b6dce1dd51688276c49507a59fc39ea7b5efe958836bc40067991fcfc126fa2973d88075cc4032ee20117f1808378156fb5e3e4f32a8bdb335b3923f90f816493248bf3147f42381e9de6aa448ba1bc8a6fed8fc69b36cce0b68a7b8db10423de5d85ee4df72b64ac577975bcc680bf4ee86f78ca72bd0b793d5b6e9ff30563b776031372bf82ec931f340e90a203a4cb01928837f54a862b207ae682b0b3fc16d59d65cdbdcd78bee301e025b7ec1c726b60ac2b00f8b3c701708c6f12cfd5bc075648d3b285dfacde0817dde60cab6def320aef29832df631d7e06a654653415f045fd34e4dd979c8b133e5dc371dd19804597843cabab62ddbc973d4f33eed7e407afcd0435c1daecd0e14944d918aee1543eb2d8ef59263dd74acb7d6f0327e0d7d73ddfc98ee7ce231d9ea9a6c75dc14a9acbe8be6383ced96984f79b1a68ec38959666d8f2f52d12542f894fe5cf6a4758d6b7e8debf11ac7639104887fb6ef2755c53c8c5f2ae53e2c278b3e4b36ece0f35534fe17504b0708ec308779cb09000028180000504b0304140008080800aa7b564e00000000000000000000000022000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e2e636c617373a552d14e1341143d03b5cb16aa28a8a0284a08697970131ff481a76a24694282a19507dfa6bb431d989da933b325fc9a0f7e801f65bc534ba5b6a5896eb23b3be79e7bcebd33f7c7cf6fdf01bcc64e84e711b623bc60a8367a3d6bfa5c7de80bed19569a5a0bfb5e71e7848bf092186dcbb53b1376c828699e0b86f55afde89cf779a2b8ee262d6fa5ee1e306c9e14dacb5c9c4a273b4a34b4369e7b69b463d83b9226d18572496ab4b73cf589cb2e123ee224a7525c9248d95de51da318963291ca9c2b4a5eacd59b0ccb9ea8aa55f47aea8a61e3ba869cfb2fc93bd96d6a2fbac29244dce154582a8ecf18ded4a61b37b2cc0ae70e668aec8c37f3915b6add0b3bd6d5fedcae4ec4d7425a9191e2921f1e26c3db39554d2faafe99eee85ae4d09a9ce1d33ca17fb489f86034e8ae63ae94b90cc7c9d0fe2fb799475d6999c2a6e2502af2a8b4cd85d0af0295616b42d0876832e030acfe19c2e3ceb9486942f76fcbd8fd6be06f278fcd7e99816101e1894b749788695fa15d99d66580b0952958157727b07b589dc0eee301a9dfc0b0466f144cd70784877844ff01ac2efc0647a1c7d81886d6166f864684cdd9b94ff0748aef388d085b83ef33dca135141a7c4ad46e488a10ff02504b070868fe421cca0100005e040000504b0304140008080800aa7b564e00000000000000000000000030000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e24417070726f76616c4576656e742e636c6173738d565b6f1b4514fec6bbde75b69bbb49d224b46929e05b6a2ee19a4b73218140d2943835b4406163af926d9cdd74771d90a0129540ea033c801020242e2f252f790089b80824c45390f82ffc03049c995dbb89e3243cf8ccd93367e67cdf7c6746fef39f5f7e03f018ae6988e34213148c7333c1cd248f4da998d63083e735bcc0cd0c66b937abe2450d2770218697f838c7cd7c0c176358e0ee256e5e56b1a822c71075deb64d97e1d49ce564ed72c9cb161cdb778d829ff58a6bd98962d1353d6f9841f5364cbbc853a39b46a96c3274cd5d37368decbae1af6627ad9559db37574c97529511cbb6fc3186cb89a3773d66b6e1f6c93c833ce5140940eb9c659b17cbebcba6bb642c9728d231e7148c52de702dfe1d06657fd5f2189a2736365c87b04f6f9ab6cfa0cfdac47caa64789e49d39983607c67cdb4b34bdc9edbb798389e5d2cdbbeb56ee62dcfa22a970cd758377dd39db06dc7377ccbb169cf546382462d27bb68de285bae59a41d632ba6bf10883190481e2747ccab659f39e694f98969b479ae2aa0e6edf9e065f381a03d54f6104979b930eb64e2706114a2639488f97d6152c9b057b20bcbd7cd823f9cbccac01c2ed28129219241a234e77ca3b0366f6c08eda8c1a9f4aae1ad06824b89e42c152156e5122533fa88f94ece772d7b85215e852f760ea2b4b39673ca6ec19cb1782f6842cdf33c4d471f967474a15b470f3727d1abe332f22a5e21e9fe7f37a87855c7237854c5151d4fe16986ee7a189365ab244e3bbe6fe5bbe2f28deab88ad7b8799d006606c28b364ae43203e2ae898c37740c6384a1adfef4187a1bea1ff6391d5a3e9059f43a43e7be7312413aa6fea308379aded362c4ab514b9054c60627c330983828cd41b5c2631aaecbaff6cf11f9fd89a9c3a771869ecc38a82b2121c215a78735c2451723e94ea346f37de8a7effbe9ab44a34c633c75172c95de412495d981941adc81fca358758a6c17a2646f50a68b267868818f4e94719aa2a9603d06f000203c5e97098f578e088fd796708efc4e89261f2467bf7d080f93e590b234f2e5d1d44f88fc50c3a088e03ba2a61e248435191248868bc7289b575404977b0c34117d8fd6dc143b74055935d44a889a2e444320523d90f71b0249370622d503f980d67c7808909e104806830d80c8f5406e3704725e2c3a0044ae07f211adf9f810205c335e98ae7cb8d75f9423d1782b95fe1e51793bbd8b965405d134fdee202a6da77f8732cf75dba58ea22143bf0ad4afd0ba45375ec4298b9f679020514cda9b205513e45db4f381627205b12db472ef0fa8f21664699b404882462f01053e818a4fe9e43e23989f13e52ff026be14b40602c0355ab7e89fc6e3824e1143148be009d1a0badac2fe46bf8a2715d6adb0b836cea9d32b1752ff393cc6e9805d734a306be26046da4ef7ad069c78580ac36f55e37210271a5a10efbb07bf43dc9eafe9367d43cdf32da6f0dd1e35a643d89d04fa193c4b5038d84128ede3ec5fbae511824b30c947e84718cbefffa445f49c862caed1b6bc51867ec5892b77a1773457484141a5b5a32df025eeb7073e616e6dbb594147059df58d77674fe30d8540231815760c67c3a746c173f42c35fd07504b0708ea7bbc798f040000e6090000504b0304140008080800aa7b564e00000000000000000000000030000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e245472616e736665724576656e742e636c6173738d56df531b5514fe6e76b31bb60be19740015b5aab8624b06ad156c36f84160da5051a0bd5da25d9c296b08bbb1b5e1c1ffa6ff8aebcf0a033923a3ae3f88433fe2ffe078e7aeedd854212c0879c7bf6dc73eef9cef9cebd933ffff9e53700efe189864e4c3441c12417535c4c73db8c8a590d73b8a3e12e177398e7dabc8a4f345cc244029ff235cfc54202f71258e4ea7d2e1ea85852b1cc203ff3dc6d862b79db359c4ad9378aae1378663130fcd29631552a7996efe7186281cb10df35cb158ba12bffdcdc358d6d33d834a6ed8d7927b0362c8fbc9451dbb183718687a9f30fbc60b7e1f18305823be3960840326f3bd6bdcaf6bae5ad98eb65b2b4e7dda2592e989ecdbf23a31c6cda3e43f38a673afe33cb9bddb59c80419f771ccb9b299bbe6fd176b61e4ce06e598eb1c2e58d53c154e3f5a58a13d8db56c1f66dca72dff4cc6d2bb0bc29c7710333b05d87ce4c372ed03cf63196acaf2ab66795e84475c30ae6040d03a9c18b8850fd23e76b17f498f72b4e47af70e6fc704dd0772124b187729d4163c23ff6ba9c3a9b0c854a30cb54ed6b9153d974368cc5f5e75631c80dae3130971353b72588318988e6e5c02c6e2d983b822f1a674abd69fa9b21c9526a709e92502d95323933fa4804ee72e0d9ce0643e7117c717268a593b565b7e215ad399bf3af090687b99b8e3eace8e842b78e1e2e2ea357c74314547c4674fdff0950f148c73b7857c5aa8e5bb8cdd05d0b63ba62974b96c7d0712af26b7ed5c674ace131179f132bd981c01da3b2b203e26689cd2f74e430cad05adb3786de867c47534ded2a84048bc9a6eca73a248cd4a0fef34a6db47d62a4a8eb8d8681483277762ca7c43094aa27a59ea7a841b91affa3c939c7bf3f3573f636aed1d3d8099a47488871aee9018d71bac54a8cd3aad17e1ffae9fb75fa2ad32ad3da997e0996ce1c2096ce1e404a0f1d40fe51445d21d98538c92c790ea109c36881810e1a82ab644d87f118c01b80d0785e26349e3926349e5bc20dd293120986374fc8b7f036490ec7a09587c6d33f21f6c3717e45186f8a7c7ae810e5634861300a1e276f9e4d1175bc42af09eb2d8ab92d4ee80abd8e112b1162ba060d8148b540720d81641a03916a814c50cce419407a2220596a743d10b916c84c4320c322a80e885c0be40ec5dc3d0308e78b27a68b1e9df517f970ea5ea433df232eef670ed192ae229ea1df77884bfb99dfa12c70de0e699a68c9d2af0af55b24f7a065859dbc783f4307896cd24907e9c8413e441b5fc8265791d843926b7f4095f7204bfb04421265f41250200f150bd4b94582f9804a5ec2975816650d84808fcb7a41ff266e8a724a18215b0cef8be1d4d516f637fa557ca0b06e85756a93bc747adba2d27f8eda381b56d79c1695357130a3ad57fb36c39ab8598acc4f8fec7268a732b4d0def70a7ebbb8398fe826add2f0ac119b8f4fb0311bc1ee20d01fe22382c2c10e41699b64ffd20d8f115c82493a223dc658e1f42705d1531a55f1848ee58332f22b2eadbe84dede5c25064529c9f6d65097b8de16ea8439d9fa4d15ed5574d40eded313833712018d614cc8715c8f9e19051fd393d4f41f504b0708826261e37e040000ca090000504b01020a000a0000080000aa7b564e000000000000000000000000030004000000000000000000000000000000696f2ffeca0000504b01020a000a0000080000aa7b564e000000000000000000000000080000000000000000000000000025000000696f2f6e756c732f504b01020a000a0000080000aa7b564e00000000000000000000000011000000000000000000000000004b000000696f2f6e756c732f636f6e74726163742f504b01020a000a0000080000aa7b564e00000000000000000000000017000000000000000000000000007a000000696f2f6e756c732f636f6e74726163742f746f6b656e2f504b01021400140008080800aa7b564eec308779cb090000281800002800000000000000000000000000af000000696f2f6e756c732f636f6e74726163742f746f6b656e2f53696d706c65546f6b656e2e636c617373504b01021400140008080800aa7b564e68fe421cca0100005e0400002200000000000000000000000000d00a0000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e2e636c617373504b01021400140008080800aa7b564eea7bbc798f040000e60900003000000000000000000000000000ea0c0000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e24417070726f76616c4576656e742e636c617373504b01021400140008080800aa7b564e826261e37e040000ca0900003000000000000000000000000000d7110000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e245472616e736665724576656e742e636c617373504b0506000000000800080051020000b31600000000",
"args" : [ "io", "IO", 80000, 1 ]
}
#####Example response data:
{
"success" : true,
"data" : {
"gasLimit" : 20143
}
}
# 4.17 Estimating the gas that calls the contract transaction
# Cmd: /api/contract/imputedgas/call
- Estimate the gas** of the contract transaction #####HttpMethod: POST
#####Form JSON data
{
"sender" : null,
"value" : null,
"contractAddress" : null,
"methodName" : null,
"methodDesc" : null,
"args" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Estimate GAS for calling contract transactions | imputedgascontractcall | Estimate GAS form for calling contract transactions | Yes |
sender | string | Transaction Creator | Yes |
value | biginteger | The amount of the primary network asset that the caller transferred to the contract address. If there is no such service, fill in 0 | No |
contractAddress | string | Smart Contract Address | Yes |
methodName | string | method name | yes |
methodDesc | string | Method Description, if the method in the contract is not overloaded, this parameter can be empty | No |
args | object[] | Parameter List | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
gasLimit | long | The consumed gas value, the execution failed to return the value 1 |
# Example request data:
_**request path: [TBD]
request form data:
{
"sender" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"value" : 0,
"contractAddress" : "tNULSeBaNAKfKnLMR5XG5qtwXt5JS1b3QosZxg",
"methodName" : "transfer",
"methodDesc" : null,
"args" : [ "tNULSeBaMnrs6JKrCy6TQdzYJZkMZJDng7QAsD", 990 ]
}
#####Example response data:
{
"success" : true,
"data" : {
"gasLimit" : 17538
}
}
# 4.18 Calling the contract without the chain method
# Cmd: /api/contract/view
- Call contract not chained method #####HttpMethod: POST
#####Form JSON data
{
"contractAddress" : null,
"methodName" : null,
"methodDesc" : null,
"args" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Call contract not linked method | contractviewcall | Call contract not on the chain method form | Yes |
contractAddress | string | Smart Contract Address | Yes |
methodName | string | method name | yes |
methodDesc | string | Method Description, if the method in the contract is not overloaded, this parameter can be empty | No |
args | object[] | Parameter List | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
result | string | Call result of view method |
# Example request data:
request path: [TBD]
request form data:
{
"contractAddress" : "tNULSeBaNAKfKnLMR5XG5qtwXt5JS1b3QosZxg",
"methodName" : "balanceOf",
"methodDesc" : null,
"args" : [ "tNULSeBaMnrs6JKrCy6TQdzYJZkMZJDng7QAsD" ]
}
#####Example response data:
{
"success" : true,
"data" : {
"result" : "8000"
}
}
# 4.19 Offline Assembly - Publish Contract Transactions
# Cmd: /api/contract/create/offline
- Offline assembly - release contract transaction #####HttpMethod: POST
#####Form JSON data
{
"sender" : null,
"senderBalance" : null,
"nonce" : null,
"alias" : null,
"contractCode" : null,
"gasLimit" : 0,
"args" : null,
"argsType" : null,
"remark" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Release Contract Offline Trading | contractcreateoffline | Publish Contract Offline Trading Form | Yes |
sender | string | Transaction Creator | Yes |
senderBalance | biginteger | Account Balance | Yes |
nonce | string | account nonce value | yes |
alias | string | Contract Alias | Yes |
contractCode | string | Smart Contract Code (Hex encoded string of bytecode) | Yes |
gasLimit | long | GAS Limits | Yes |
args | object[] | Parameter List | No |
argsType | string[] | Parameter Type List | No |
remark | string | Notes | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization String |
contractAddress | string | generated contract address |
# Example request data:
request path: [TBD]
request form data:
{
"sender" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"alias" : "rf_nrc20_offline",
"senderBalance" : "999999998523475",
"nonce" : "9c0aea02bed90ddd",
"contractCode" : "504b03040a0000080000aa7b564e00000000000000000000000003000400696f2ffeca0000504b03040a0000080000aa7b564e00000000000000000000000008000000696f2f6e756c732f504b03040a0000080000aa7b564e00000000000000000000000011000000696f2f6e756c732f636f6e74726163742f504b03040a0000080000aa7b564e00000000000000000000000017000000696f2f6e756c732f636f6e74726163742f746f6b656e2f504b0304140008080800aa7b564e00000000000000000000000028000000696f2f6e756c732f636f6e74726163742f746f6b656e2f53696d706c65546f6b656e2e636c617373b558f97754e5197eeecc90990c972d9090059209a498cc9291a58a8152020d35ca5602b1605bbd99b9492ecc12670922b46ead4babd56aeb5ad1565bd4aa2c020169d59ed353cfe93fd17f84d3d3e7fdee9d3b37612639d5d31ff2ddf77ecbfb3eeff67c77f2afff7cf639804df87b23a23825c323329c96e14c1831fcb411cdf859108f86119497281e93e171997e22cce149197e1ec62ff0d462acc2d3413c13c672fc2a8ce7f0bcccfc3a8817827831cc53bf91e125195e96e5df8af4bb205e09a3430e44f19a0cafcbf086a87d5386df87f096cc9c9597b7457a27843fc8f38f21bc2b7ade0be24f41fc39887341bcaf219033b2a686a6bdc78d692399317213c99152c1ca4d6cd3d0503c951dcb673484d266caca1a99a2066d58c3e252be646446ca535399531a5aeca359a33499dc654d0ce74ae68459e0f1d098417d2993a796d97bca252b93dc674c71b171c49ac819a57281c68766af6edf6be593b972a6984ce573a582912a258be913c9c174ba60168bdb6a9bdb419d412393c99f34d31a4a5f43e337342f0056f5f6d58a6360773e6d4a10ac9cb9bf9c1d330b878db18c8a7a3e6564468d8225efce64a0346931643db7c228e54f98b9e488959de26691a9bbed503957b2b2e6a855b4787c3097636e4a563e47151b6a7b62b87b92a39679924afcbd7d4c6b6b05fdada96cd86ee5acd20e0d3b7a6f75b0decc5c35c37da31a968822cbc80c66f304ae61dd6cfc078d02ebb164166639125dd09143e64365ab60a6a5b2541548e16938dcbb4032e75dad1b8e45f99339b3a0a173fef3acc8e294994bcb565d1d19ac14e8a269235336a5796655c0a9a94a152c192919a9132c47f56eb302b5d048ae386e16f614f2590d47be917bb5bdeb3bc6121c57ea7da53cc3e974f181710d772c60af6ec0828e129242c5030d772e84be2ebea0313555c84f53dd722b972a9846d11c543306c92a6ca4d3667ad48eef7232d79cf565c5f29832e66e0ae53315510ebb49fabf84973d1032ec2d1babe2260f2ed77eb868565f96550e559739b3ab12d7af19cc5109a6bdc583c0d5ba283569a64e90657aeb9f4fd659ab7fa24115ffc68a40df63f3eaf0528b9cf7678b131a06ff27bbb5358547f2e542cadc6349cb2df7306bbf6cd7d18fa48edb65d8884d3a36638b8e217ca0e3436cd1b0a27a6fdc6d1427d9ac3abe8d3b74dc25c35f64f347f858c727381fc4051d177149c7a7b84c42abc3edca76cf61a74586a64da1c82573def5e11ca96477c62816cda2e0213d5cd17115333aaee13a0fccbacf782dd58a888e49983a72c8e83821c367b8a1c382b910ba4a2755d0cd7ad79116adf7e05e1d79301e7fc5df747c8ef31a3a8673c5f2f8b895b2b82fe274703aa254cbe6691d5fe0bc8ea36087270e4f9a11551d916cb9588a8c999109f6312f864869d2c845f2850819dfc8f078e4f67e394e289db32c389413c98fdb36fac5c52f79e32c7cafb216aae57260ecb899a2f6b535fb6bb7f3a261cd7c5153772c0b2e706ce8d001be1c1edacf712a7f527a6bb82e6f86b2e54cc9529f59fdf55ab0ded9d69a78f749eb34149d5b29c22b7f812bcc3f55a6735bbdf7be1d916db7cef4dd3aa5a1bda68123ac4e524ec0cc5a54df5587bd544dd93d3f6172df861a306a1a0d16ec0f025ae83d26e71b53f9ec9451607ee761337e04f9c9868c7b85097943f71eabc51de8e637750c3ec49140039a842af8e3a049d8423d49187cfa8433d493c400d2b492b7f2ef2ecffb003fd699616ca3bc9d3349be697c2e8a5e8676416df90ec70635b9163b38eaf6067c173bf91c745677f1a911422d45beb98ad62fa8682376d750e4ff688ea2be05156dc6f76a280acc45945c50d110f6388afecd1d8bf834a3335476090d571088de40f0e80c4257d05815c3d1d81568d1f815f8a2cd812bf0471397b0b8397015fa552c915397d1780d4b05d0752cf3e3be1b587e54736666b0e21a9a2eba40fbb158fd060c30658bb11a2d6865296cc606a639c6246f645a0799d6434c729a491687b6d8401d8744ea57711049cac5a7a4ef739f5f491b95febb29b705b86d58797eeb4892e50189c51754212692441c8e5dc74a1fbec4aafd89af1064602e24e2ce54f340a02df015429c1449c21f505e75f2f72a887529313611650bc3bd8ec9bf8d798b33e4552f92ae1749ecc53e276dfb29f978ba1b07e8bf9f6797e0204f04f00327a1f6da56ae1de2cc52f86ea22588919b680ee2f0ac248bdf4b7c737c3d825127ef670823c0674f34c6142566d0128d715c1d8d736c95d4c54492ac05aa85daa2c0df8b46825e46b0cd84bc8e80c4b1a8adcf75ac07f7398ef5e087ca31910eaaf408b895fe9ae9e0bde5a4e3491e914cf6c4fe8960e01c02fe6b68932aaba4a6795fdc4ecdbeb8e4c0ef817884d11a453b2174d2f83aea1488115b9f07a21dfb7684713f81f9545417c31fdaa9dd446bad90063517e98ff0632798166d8ae6ae2863199728c6e24e143921f29c3836a9583d80101e64120d92d1980760970bb04b454e53d24105b0665a7fe22279d041d21e750cb7df404705c49ad92096aa9d134ce624bbcff200687701b4ab9ad494340f80075c00136c0151d15d01b0b602404d5c45671d1c59e2c8d1cdbc0747b78ba3dbc5d14d1febe2305c1c978943623c142586ae8aedfdf1c45544ce62859a60e53040e7a057b0b6cc83d5efe9f022a35c22ee32ab6d9a55f4302faf47d8e7a73d8d30e4621f72b10f31cd5b5487df89946a04a9b746e9e21e165ba896533ef914a42c4e3de1907584f545740381685b40bc4bc8108bb705e85d375daaf2acdd0d8fb2d01ea3d5c7b1923abad85955268ab83823187770469846bb61234ec3865821f72826f2c907af83e78c83a7d38327d1b46e06eb2b687a66a1b1cbfe296a7b1a2bf00ccbfe590f924e1749a78ba4d345d2e922697191582e927f7045740cd8b1f0f2b74dd66dce453610508b6dce1dd51688276c49507a59fc39ea7b5efe958836bc40067991fcfc126fa2973d88075cc4032ee20117f1808378156fb5e3e4f32a8bdb335b3923f90f816493248bf3147f42381e9de6aa448ba1bc8a6fed8fc69b36cce0b68a7b8db10423de5d85ee4df72b64ac577975bcc680bf4ee86f78ca72bd0b793d5b6e9ff30563b776031372bf82ec931f340e90a203a4cb01928837f54a862b207ae682b0b3fc16d59d65cdbdcd78bee301e025b7ec1c726b60ac2b00f8b3c701708c6f12cfd5bc075648d3b285dfacde0817dde60cab6def320aef29832df631d7e06a654653415f045fd34e4dd979c8b133e5dc371dd19804597843cabab62ddbc973d4f33eed7e407afcd0435c1daecd0e14944d918aee1543eb2d8ef59263dd74acb7d6f0327e0d7d73ddfc98ee7ce231d9ea9a6c75dc14a9acbe8be6383ced96984f79b1a68ec38959666d8f2f52d12542f894fe5cf6a4758d6b7e8debf11ac7639104887fb6ef2755c53c8c5f2ae53e2c278b3e4b36ece0f35534fe17504b0708ec308779cb09000028180000504b0304140008080800aa7b564e00000000000000000000000022000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e2e636c617373a552d14e1341143d03b5cb16aa28a8a0284a08697970131ff481a76a24694282a19507dfa6bb431d989da933b325fc9a0f7e801f65bc534ba5b6a5896eb23b3be79e7bcebd33f7c7cf6fdf01bcc64e84e711b623bc60a8367a3d6bfa5c7de80bed19569a5a0bfb5e71e7848bf092186dcbb53b1376c828699e0b86f55afde89cf779a2b8ee262d6fa5ee1e306c9e14dacb5c9c4a273b4a34b4369e7b69b463d83b9226d18572496ab4b73cf589cb2e123ee224a7525c9248d95de51da318963291ca9c2b4a5eacd59b0ccb9ea8aa55f47aea8a61e3ba869cfb2fc93bd96d6a2fbac29244dce154582a8ecf18ded4a61b37b2cc0ae70e668aec8c37f3915b6add0b3bd6d5fedcae4ec4d7425a9191e2921f1e26c3db39554d2faafe99eee85ae4d09a9ce1d33ca17fb489f86034e8ae63ae94b90cc7c9d0fe2fb799475d6999c2a6e2502af2a8b4cd85d0af0295616b42d0876832e030acfe19c2e3ceb9486942f76fcbd8fd6be06f278fcd7e99816101e1894b749788695fa15d99d66580b0952958157727b07b589dc0eee301a9dfc0b0466f144cd70784877844ff01ac2efc0647a1c7d81886d6166f864684cdd9b94ff0748aef388d085b83ef33dca135141a7c4ad46e488a10ff02504b070868fe421cca0100005e040000504b0304140008080800aa7b564e00000000000000000000000030000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e24417070726f76616c4576656e742e636c6173738d565b6f1b4514fec6bbde75b69bbb49d224b46929e05b6a2ee19a4b73218140d2943835b4406163af926d9cdd74771d90a0129540ea033c801020242e2f252f790089b80824c45390f82ffc03049c995dbb89e3243cf8ccd93367e67cdf7c6746fef39f5f7e03f018ae6988e34213148c7333c1cd248f4da998d63083e735bcc0cd0c66b937abe2450d2770218697f838c7cd7c0c176358e0ee256e5e56b1a822c71075deb64d97e1d49ce564ed72c9cb161cdb778d829ff58a6bd98962d1353d6f9841f5364cbbc853a39b46a96c3274cd5d37368decbae1af6627ad9559db37574c97529511cbb6fc3186cb89a3773d66b6e1f6c93c833ce5140940eb9c659b17cbebcba6bb642c9728d231e7148c52de702dfe1d06657fd5f2189a2736365c87b04f6f9ab6cfa0cfdac47caa64789e49d39983607c67cdb4b34bdc9edbb798389e5d2cdbbeb56ee62dcfa22a970cd758377dd39db06dc7377ccbb169cf546382462d27bb68de285bae59a41d632ba6bf10883190481e2747ccab659f39e694f98969b479ae2aa0e6edf9e065f381a03d54f6104979b930eb64e2706114a2639488f97d6152c9b057b20bcbd7cd823f9cbccac01c2ed28129219241a234e77ca3b0366f6c08eda8c1a9f4aae1ad06824b89e42c152156e5122533fa88f94ece772d7b85215e852f760ea2b4b39673ca6ec19cb1782f6842cdf33c4d471f967474a15b470f3727d1abe332f22a5e21e9fe7f37a87855c7237854c5151d4fe16986ee7a189365ab244e3bbe6fe5bbe2f28deab88ad7b8799d006606c28b364ae43203e2ae898c37740c6384a1adfef4187a1bea1ff6391d5a3e9059f43a43e7be7312413aa6fea308379aded362c4ab514b9054c60627c330983828cd41b5c2631aaecbaff6cf11f9fd89a9c3a771869ecc38a82b2121c215a78735c2451723e94ea346f37de8a7effbe9ab44a34c633c75172c95de412495d981941adc81fca358758a6c17a2646f50a68b267868818f4e94719aa2a9603d06f000203c5e97098f578e088fd796708efc4e89261f2467bf7d080f93e590b234f2e5d1d44f88fc50c3a088e03ba2a61e248435191248868bc7289b575404977b0c34117d8fd6dc143b74055935d44a889a2e444320523d90f71b0249370622d503f980d67c7808909e104806830d80c8f5406e3704725e2c3a0044ae07f211adf9f810205c335e98ae7cb8d75f9423d1782b95fe1e51793bbd8b965405d134fdee202a6da77f8732cf75dba58ea22143bf0ad4afd0ba45375ec4298b9f679020514cda9b205513e45db4f381627205b12db472ef0fa8f21664699b404882462f01053e818a4fe9e43e23989f13e52ff026be14b40602c0355ab7e89fc6e3824e1143148be009d1a0badac2fe46bf8a2715d6adb0b836cea9d32b1752ff393cc6e9805d734a306be26046da4ef7ad069c78580ac36f55e37210271a5a10efbb07bf43dc9eafe9367d43cdf32da6f0dd1e35a643d89d04fa193c4b5038d84128ede3ec5fbae511824b30c947e84718cbefffa445f49c862caed1b6bc51867ec5892b77a1773457484141a5b5a32df025eeb7073e616e6dbb594147059df58d77674fe30d8540231815760c67c3a746c173f42c35fd07504b0708ea7bbc798f040000e6090000504b0304140008080800aa7b564e00000000000000000000000030000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e245472616e736665724576656e742e636c6173738d56df531b5514fe6e76b31bb60be19740015b5aab8624b06ad156c36f84160da5051a0bd5da25d9c296b08bbb1b5e1c1ffa6ff8aebcf0a033923a3ae3f88433fe2ffe078e7aeedd854212c0879c7bf6dc73eef9cef9cebd933ffff9e53700efe189864e4c3441c12417535c4c73db8c8a590d73b8a3e12e177398e7dabc8a4f345cc244029ff235cfc54202f71258e4ea7d2e1ea85852b1cc203ff3dc6d862b79db359c4ad9378aae1378663130fcd29631552a7996efe7186281cb10df35cb158ba12bffdcdc358d6d33d834a6ed8d7927b0362c8fbc9451dbb183718687a9f30fbc60b7e1f18305823be3960840326f3bd6bdcaf6bae5ad98eb65b2b4e7dda2592e989ecdbf23a31c6cda3e43f38a673afe33cb9bddb59c80419f771ccb9b299bbe6fd176b61e4ce06e598eb1c2e58d53c154e3f5a58a13d8db56c1f66dca72dff4cc6d2bb0bc29c7710333b05d87ce4c372ed03cf63196acaf2ab66795e84475c30ae6040d03a9c18b8850fd23e76b17f498f72b4e47af70e6fc704dd0772124b187729d4163c23ff6ba9c3a9b0c854a30cb54ed6b9153d974368cc5f5e75631c80dae3130971353b72588318988e6e5c02c6e2d983b822f1a674abd69fa9b21c9526a709e92502d95323933fa4804ee72e0d9ce0643e7117c717268a593b565b7e215ad399bf3af090687b99b8e3eace8e842b78e1e2e2ea357c74314547c4674fdff0950f148c73b7857c5aa8e5bb8cdd05d0b63ba62974b96c7d0712af26b7ed5c674ace131179f132bd981c01da3b2b203e26689cd2f74e430cad05adb3786de867c47534ded2a84048bc9a6eca73a248cd4a0fef34a6db47d62a4a8eb8d8681483277762ca7c43094aa27a59ea7a841b91affa3c939c7bf3f3573f636aed1d3d8099a47488871aee9018d71bac54a8cd3aad17e1ffae9fb75fa2ad32ad3da997e0996ce1c2096ce1e404a0f1d40fe51445d21d98538c92c790ea109c36881810e1a82ab644d87f118c01b80d0785e26349e3926349e5bc20dd293120986374fc8b7f036490ec7a09587c6d33f21f6c3717e45186f8a7c7ae810e5634861300a1e276f9e4d1175bc42af09eb2d8ab92d4ee80abd8e112b1162ba060d8148b540720d81641a03916a814c50cce419407a2220596a743d10b916c84c4320c322a80e885c0be40ec5dc3d0308e78b27a68b1e9df517f970ea5ea433df232eef670ed192ae229ea1df77884bfb99dfa12c70de0e699a68c9d2af0af55b24f7a065859dbc783f4307896cd24907e9c8413e441b5fc8265791d843926b7f4095f7204bfb04421265f41250200f150bd4b94582f9804a5ec2975816650d84808fcb7a41ff266e8a724a18215b0cef8be1d4d516f637fa557ca0b06e85756a93bc747adba2d27f8eda381b56d79c1695357130a3ad57fb36c39ab8598acc4f8fec7268a732b4d0def70a7ebbb8398fe826add2f0ac119b8f4fb0311bc1ee20d01fe22382c2c10e41699b64ffd20d8f115c82493a223dc658e1f42705d1531a55f1848ee58332f22b2eadbe84dede5c25064529c9f6d65097b8de16ea8439d9fa4d15ed5574d40eded313833712018d614cc8715c8f9e19051fd393d4f41f504b0708826261e37e040000ca090000504b01020a000a0000080000aa7b564e000000000000000000000000030004000000000000000000000000000000696f2ffeca0000504b01020a000a0000080000aa7b564e000000000000000000000000080000000000000000000000000025000000696f2f6e756c732f504b01020a000a0000080000aa7b564e00000000000000000000000011000000000000000000000000004b000000696f2f6e756c732f636f6e74726163742f504b01020a000a0000080000aa7b564e00000000000000000000000017000000000000000000000000007a000000696f2f6e756c732f636f6e74726163742f746f6b656e2f504b01021400140008080800aa7b564eec308779cb090000281800002800000000000000000000000000af000000696f2f6e756c732f636f6e74726163742f746f6b656e2f53696d706c65546f6b656e2e636c617373504b01021400140008080800aa7b564e68fe421cca0100005e0400002200000000000000000000000000d00a0000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e2e636c617373504b01021400140008080800aa7b564eea7bbc798f040000e60900003000000000000000000000000000ea0c0000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e24417070726f76616c4576656e742e636c617373504b01021400140008080800aa7b564e826261e37e040000ca0900003000000000000000000000000000d7110000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e245472616e736665724576656e742e636c617373504b0506000000000800080051020000b31600000000",
"gasLimit" : 20245,
"args" : [ "air", "AIR", 10000, 2 ],
"argsType" : [ "String", "String", "BigInteger", "int" ],
"remark" : "() return void"
}
#####Example response data:
{
"success" : true,
"data" : {
"txHex" : "0f008629375d0e28292072657475726e20766f6964fd8119020001f7ec6473df12e751d64cf20a8baa7edd50810f810200020d2f73cb93099a8cfd0cbdd060155abfe2f50917fd1a19504b03040a0000080000aa7b564e00000000000000000000000003000400696f2ffeca0000504b03040a0000080000aa7b564e00000000000000000000000008000000696f2f6e756c732f504b03040a0000080000aa7b564e00000000000000000000000011000000696f2f6e756c732f636f6e74726163742f504b03040a0000080000aa7b564e00000000000000000000000017000000696f2f6e756c732f636f6e74726163742f746f6b656e2f504b0304140008080800aa7b564e00000000000000000000000028000000696f2f6e756c732f636f6e74726163742f746f6b656e2f53696d706c65546f6b656e2e636c617373b558f97754e5197eeecc90990c972d9090059209a498cc9291a58a8152020d35ca5602b1605bbd99b9492ecc12670922b46ead4babd56aeb5ad1565bd4aa2c020169d59ed353cfe93fd17f84d3d3e7fdee9d3b37612639d5d31ff2ddf77ecbfb3eeff67c77f2afff7cf639804df87b23a23825c323329c96e14c1831fcb411cdf859108f86119497281e93e171997e22cce149197e1ec62ff0d462acc2d3413c13c672fc2a8ce7f0bcccfc3a8817827831cc53bf91e125195e96e5df8af4bb205e09a3430e44f19a0cafcbf086a87d5386df87f096cc9c9597b7457a27843fc8f38f21bc2b7ade0be24f41fc39887341bcaf219033b2a686a6bdc78d692399317213c99152c1ca4d6cd3d0503c951dcb673484d266caca1a99a2066d58c3e252be646446ca535399531a5aeca359a33499dc654d0ce74ae68459e0f1d098417d2993a796d97bca252b93dc674c71b171c49ac819a57281c68766af6edf6be593b972a6984ce573a582912a258be913c9c174ba60168bdb6a9bdb419d412393c99f34d31a4a5f43e337342f0056f5f6d58a6360773e6d4a10ac9cb9bf9c1d330b878db18c8a7a3e6564468d8225efce64a0346931643db7c228e54f98b9e488959de26691a9bbed503957b2b2e6a855b4787c3097636e4a563e47151b6a7b62b87b92a39679924afcbd7d4c6b6b05fdada96cd86ee5acd20e0d3b7a6f75b0decc5c35c37da31a968822cbc80c66f304ae61dd6cfc078d02ebb164166639125dd09143e64365ab60a6a5b2541548e16938dcbb4032e75dad1b8e45f99339b3a0a173fef3acc8e294994bcb565d1d19ac14e8a269235336a5796655c0a9a94a152c192919a9132c47f56eb302b5d048ae386e16f614f2590d47be917bb5bdeb3bc6121c57ea7da53cc3e974f181710d772c60af6ec0828e129242c5030d772e84be2ebea0313555c84f53dd722b972a9846d11c543306c92a6ca4d3667ad48eef7232d79cf565c5f29832e66e0ae53315510ebb49fabf84973d1032ec2d1babe2260f2ed77eb868565f96550e559739b3ab12d7af19cc5109a6bdc583c0d5ba283569a64e90657aeb9f4fd659ab7fa24115ffc68a40df63f3eaf0528b9cf7678b131a06ff27bbb5358547f2e542cadc6349cb2df7306bbf6cd7d18fa48edb65d8884d3a36638b8e217ca0e3436cd1b0a27a6fdc6d1427d9ac3abe8d3b74dc25c35f64f347f858c727381fc4051d177149c7a7b84c42abc3edca76cf61a74586a64da1c82573def5e11ca96477c62816cda2e0213d5cd17115333aaee13a0fccbacf782dd58a888e49983a72c8e83821c367b8a1c382b910ba4a2755d0cd7ad79116adf7e05e1d79301e7fc5df747c8ef31a3a8673c5f2f8b895b2b82fe274703aa254cbe6691d5fe0bc8ea36087270e4f9a11551d916cb9588a8c999109f6312f864869d2c845f2850819dfc8f078e4f67e394e289db32c389413c98fdb36fac5c52f79e32c7cafb216aae57260ecb899a2f6b535fb6bb7f3a261cd7c5153772c0b2e706ce8d001be1c1edacf712a7f527a6bb82e6f86b2e54cc9529f59fdf55ab0ded9d69a78f749eb34149d5b29c22b7f812bcc3f55a6735bbdf7be1d916db7cef4dd3aa5a1bda68123ac4e524ec0cc5a54df5587bd544dd93d3f6172df861a306a1a0d16ec0f025ae83d26e71b53f9ec9451607ee761337e04f9c9868c7b85097943f71eabc51de8e637750c3ec49140039a842af8e3a049d8423d49187cfa8433d493c400d2b492b7f2ef2ecffb003fd699616ca3bc9d3349be697c2e8a5e8676416df90ec70635b9163b38eaf6067c173bf91c745677f1a911422d45beb98ad62fa8682376d750e4ff688ea2be05156dc6f76a280acc45945c50d110f6388afecd1d8bf834a3335476090d571088de40f0e80c4257d05815c3d1d81568d1f815f8a2cd812bf0471397b0b8397015fa552c915397d1780d4b05d0752cf3e3be1b587e54736666b0e21a9a2eba40fbb158fd060c30658bb11a2d6865296cc606a639c6246f645a0799d6434c729a491687b6d8401d8744ea57711049cac5a7a4ef739f5f491b95febb29b705b86d58797eeb4892e50189c51754212692441c8e5dc74a1fbec4aafd89af1064602e24e2ce54f340a02df015429c1449c21f505e75f2f72a887529313611650bc3bd8ec9bf8d798b33e4552f92ae1749ecc53e276dfb29f978ba1b07e8bf9f6797e0204f04f00327a1f6da56ae1de2cc52f86ea22588919b680ee2f0ac248bdf4b7c737c3d825127ef670823c0674f34c6142566d0128d715c1d8d736c95d4c54492ac05aa85daa2c0df8b46825e46b0cd84bc8e80c4b1a8adcf75ac07f7398ef5e087ca31910eaaf408b895fe9ae9e0bde5a4e3491e914cf6c4fe8960e01c02fe6b68932aaba4a6795fdc4ecdbeb8e4c0ef817884d11a453b2174d2f83aea1488115b9f07a21dfb7684713f81f9545417c31fdaa9dd446bad90063517e98ff0632798166d8ae6ae2863199728c6e24e143921f29c3836a9583d80101e64120d92d1980760970bb04b454e53d24105b0665a7fe22279d041d21e750cb7df404705c49ad92096aa9d134ce624bbcff200687701b4ab9ad494340f80075c00136c0151d15d01b0b602404d5c45671d1c59e2c8d1cdbc0747b78ba3dbc5d14d1febe2305c1c978943623c142586ae8aedfdf1c45544ce62859a60e53040e7a057b0b6cc83d5efe9f022a35c22ee32ab6d9a55f4302faf47d8e7a73d8d30e4621f72b10f31cd5b5487df89946a04a9b746e9e21e165ba896533ef914a42c4e3de1907584f545740381685b40bc4bc8108bb705e85d375daaf2acdd0d8fb2d01ea3d5c7b1923abad85955268ab83823187770469846bb61234ec3865821f72826f2c907af83e78c83a7d38327d1b46e06eb2b687a66a1b1cbfe296a7b1a2bf00ccbfe590f924e1749a78ba4d345d2e922697191582e927f7045740cd8b1f0f2b74dd66dce453610508b6dce1dd51688276c49507a59fc39ea7b5efe958836bc40067991fcfc126fa2973d88075cc4032ee20117f1808378156fb5e3e4f32a8bdb335b3923f90f816493248bf3147f42381e9de6aa448ba1bc8a6fed8fc69b36cce0b68a7b8db10423de5d85ee4df72b64ac577975bcc680bf4ee86f78ca72bd0b793d5b6e9ff30563b776031372bf82ec931f340e90a203a4cb01928837f54a862b207ae682b0b3fc16d59d65cdbdcd78bee301e025b7ec1c726b60ac2b00f8b3c701708c6f12cfd5bc075648d3b285dfacde0817dde60cab6def320aef29832df631d7e06a654653415f045fd34e4dd979c8b133e5dc371dd19804597843cabab62ddbc973d4f33eed7e407afcd0435c1daecd0e14944d918aee1543eb2d8ef59263dd74acb7d6f0327e0d7d73ddfc98ee7ce231d9ea9a6c75dc14a9acbe8be6383ced96984f79b1a68ec38959666d8f2f52d12542f894fe5cf6a4758d6b7e8debf11ac7639104887fb6ef2755c53c8c5f2ae53e2c278b3e4b36ece0f35534fe17504b0708ec308779cb09000028180000504b0304140008080800aa7b564e00000000000000000000000022000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e2e636c617373a552d14e1341143d03b5cb16aa28a8a0284a08697970131ff481a76a24694282a19507dfa6bb431d989da933b325fc9a0f7e801f65bc534ba5b6a5896eb23b3be79e7bcebd33f7c7cf6fdf01bcc64e84e711b623bc60a8367a3d6bfa5c7de80bed19569a5a0bfb5e71e7848bf092186dcbb53b1376c828699e0b86f55afde89cf779a2b8ee262d6fa5ee1e306c9e14dacb5c9c4a273b4a34b4369e7b69b463d83b9226d18572496ab4b73cf589cb2e123ee224a7525c9248d95de51da318963291ca9c2b4a5eacd59b0ccb9ea8aa55f47aea8a61e3ba869cfb2fc93bd96d6a2fbac29244dce154582a8ecf18ded4a61b37b2cc0ae70e668aec8c37f3915b6add0b3bd6d5fedcae4ec4d7425a9191e2921f1e26c3db39554d2faafe99eee85ae4d09a9ce1d33ca17fb489f86034e8ae63ae94b90cc7c9d0fe2fb799475d6999c2a6e2502af2a8b4cd85d0af0295616b42d0876832e030acfe19c2e3ceb9486942f76fcbd8fd6be06f278fcd7e99816101e1894b749788695fa15d99d66580b0952958157727b07b589dc0eee301a9dfc0b0466f144cd70784877844ff01ac2efc0647a1c7d81886d6166f864684cdd9b94ff0748aef388d085b83ef33dca135141a7c4ad46e488a10ff02504b070868fe421cca0100005e040000504b0304140008080800aa7b564e00000000000000000000000030000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e24417070726f76616c4576656e742e636c6173738d565b6f1b4514fec6bbde75b69bbb49d224b46929e05b6a2ee19a4b73218140d2943835b4406163af926d9cdd74771d90a0129540ea033c801020242e2f252f790089b80824c45390f82ffc03049c995dbb89e3243cf8ccd93367e67cdf7c6746fef39f5f7e03f018ae6988e34213148c7333c1cd248f4da998d63083e735bcc0cd0c66b937abe2450d2770218697f838c7cd7c0c176358e0ee256e5e56b1a822c71075deb64d97e1d49ce564ed72c9cb161cdb778d829ff58a6bd98962d1353d6f9841f5364cbbc853a39b46a96c3274cd5d37368decbae1af6627ad9559db37574c97529511cbb6fc3186cb89a3773d66b6e1f6c93c833ce5140940eb9c659b17cbebcba6bb642c9728d231e7148c52de702dfe1d06657fd5f2189a2736365c87b04f6f9ab6cfa0cfdac47caa64789e49d39983607c67cdb4b34bdc9edbb798389e5d2cdbbeb56ee62dcfa22a970cd758377dd39db06dc7377ccbb169cf546382462d27bb68de285bae59a41d632ba6bf10883190481e2747ccab659f39e694f98969b479ae2aa0e6edf9e065f381a03d54f6104979b930eb64e2706114a2639488f97d6152c9b057b20bcbd7cd823f9cbccac01c2ed28129219241a234e77ca3b0366f6c08eda8c1a9f4aae1ad06824b89e42c152156e5122533fa88f94ece772d7b85215e852f760ea2b4b39673ca6ec19cb1782f6842cdf33c4d471f967474a15b470f3727d1abe332f22a5e21e9fe7f37a87855c7237854c5151d4fe16986ee7a189365ab244e3bbe6fe5bbe2f28deab88ad7b8799d006606c28b364ae43203e2ae898c37740c6384a1adfef4187a1bea1ff6391d5a3e9059f43a43e7be7312413aa6fea308379aded362c4ab514b9054c60627c330983828cd41b5c2631aaecbaff6cf11f9fd89a9c3a771869ecc38a82b2121c215a78735c2451723e94ea346f37de8a7effbe9ab44a34c633c75172c95de412495d981941adc81fca358758a6c17a2646f50a68b267868818f4e94719aa2a9603d06f000203c5e97098f578e088fd796708efc4e89261f2467bf7d080f93e590b234f2e5d1d44f88fc50c3a088e03ba2a61e248435191248868bc7289b575404977b0c34117d8fd6dc143b74055935d44a889a2e444320523d90f71b0249370622d503f980d67c7808909e104806830d80c8f5406e3704725e2c3a0044ae07f211adf9f810205c335e98ae7cb8d75f9423d1782b95fe1e51793bbd8b965405d134fdee202a6da77f8732cf75dba58ea22143bf0ad4afd0ba45375ec4298b9f679020514cda9b205513e45db4f381627205b12db472ef0fa8f21664699b404882462f01053e818a4fe9e43e23989f13e52ff026be14b40602c0355ab7e89fc6e3824e1143148be009d1a0badac2fe46bf8a2715d6adb0b836cea9d32b1752ff393cc6e9805d734a306be26046da4ef7ad069c78580ac36f55e37210271a5a10efbb07bf43dc9eafe9367d43cdf32da6f0dd1e35a643d89d04fa193c4b5038d84128ede3ec5fbae511824b30c947e84718cbefffa445f49c862caed1b6bc51867ec5892b77a1773457484141a5b5a32df025eeb7073e616e6dbb594147059df58d77674fe30d8540231815760c67c3a746c173f42c35fd07504b0708ea7bbc798f040000e6090000504b0304140008080800aa7b564e00000000000000000000000030000000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e245472616e736665724576656e742e636c6173738d56df531b5514fe6e76b31bb60be19740015b5aab8624b06ad156c36f84160da5051a0bd5da25d9c296b08bbb1b5e1c1ffa6ff8aebcf0a033923a3ae3f88433fe2ffe078e7aeedd854212c0879c7bf6dc73eef9cef9cebd933ffff9e53700efe189864e4c3441c12417535c4c73db8c8a590d73b8a3e12e177398e7dabc8a4f345cc244029ff235cfc54202f71258e4ea7d2e1ea85852b1cc203ff3dc6d862b79db359c4ad9378aae1378663130fcd29631552a7996efe7186281cb10df35cb158ba12bffdcdc358d6d33d834a6ed8d7927b0362c8fbc9451dbb183718687a9f30fbc60b7e1f18305823be3960840326f3bd6bdcaf6bae5ad98eb65b2b4e7dda2592e989ecdbf23a31c6cda3e43f38a673afe33cb9bddb59c80419f771ccb9b299bbe6fd176b61e4ce06e598eb1c2e58d53c154e3f5a58a13d8db56c1f66dca72dff4cc6d2bb0bc29c7710333b05d87ce4c372ed03cf63196acaf2ab66795e84475c30ae6040d03a9c18b8850fd23e76b17f498f72b4e47af70e6fc704dd0772124b187729d4163c23ff6ba9c3a9b0c854a30cb54ed6b9153d974368cc5f5e75631c80dae3130971353b72588318988e6e5c02c6e2d983b822f1a674abd69fa9b21c9526a709e92502d95323933fa4804ee72e0d9ce0643e7117c717268a593b565b7e215ad399bf3af090687b99b8e3eace8e842b78e1e2e2ea357c74314547c4674fdff0950f148c73b7857c5aa8e5bb8cdd05d0b63ba62974b96c7d0712af26b7ed5c674ace131179f132bd981c01da3b2b203e26689cd2f74e430cad05adb3786de867c47534ded2a84048bc9a6eca73a248cd4a0fef34a6db47d62a4a8eb8d8681483277762ca7c43094aa27a59ea7a841b91affa3c939c7bf3f3573f636aed1d3d8099a47488871aee9018d71bac54a8cd3aad17e1ffae9fb75fa2ad32ad3da997e0996ce1c2096ce1e404a0f1d40fe51445d21d98538c92c790ea109c36881810e1a82ab644d87f118c01b80d0785e26349e3926349e5bc20dd293120986374fc8b7f036490ec7a09587c6d33f21f6c3717e45186f8a7c7ae810e5634861300a1e276f9e4d1175bc42af09eb2d8ab92d4ee80abd8e112b1162ba060d8148b540720d81641a03916a814c50cce419407a2220596a743d10b916c84c4320c322a80e885c0be40ec5dc3d0308e78b27a68b1e9df517f970ea5ea433df232eef670ed192ae229ea1df77884bfb99dfa12c70de0e699a68c9d2af0af55b24f7a065859dbc783f4307896cd24907e9c8413e441b5fc8265791d843926b7f4095f7204bfb04421265f41250200f150bd4b94582f9804a5ec2975816650d84808fcb7a41ff266e8a724a18215b0cef8be1d4d516f637fa557ca0b06e85756a93bc747adba2d27f8eda381b56d79c1695357130a3ad57fb36c39ab8598acc4f8fec7268a732b4d0def70a7ebbb8398fe826add2f0ac119b8f4fb0311bc1ee20d01fe22382c2c10e41699b64ffd20d8f115c82493a223dc658e1f42705d1531a55f1848ee58332f22b2eadbe84dede5c25064529c9f6d65097b8de16ea8439d9fa4d15ed5574d40eded313833712018d614cc8715c8f9e19051fd393d4f41f504b0708826261e37e040000ca090000504b01020a000a0000080000aa7b564e000000000000000000000000030004000000000000000000000000000000696f2ffeca0000504b01020a000a0000080000aa7b564e000000000000000000000000080000000000000000000000000025000000696f2f6e756c732f504b01020a000a0000080000aa7b564e00000000000000000000000011000000000000000000000000004b000000696f2f6e756c732f636f6e74726163742f504b01020a000a0000080000aa7b564e00000000000000000000000017000000000000000000000000007a000000696f2f6e756c732f636f6e74726163742f746f6b656e2f504b01021400140008080800aa7b564eec308779cb090000281800002800000000000000000000000000af000000696f2f6e756c732f636f6e74726163742f746f6b656e2f53696d706c65546f6b656e2e636c617373504b01021400140008080800aa7b564e68fe421cca0100005e0400002200000000000000000000000000d00a0000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e2e636c617373504b01021400140008080800aa7b564eea7bbc798f040000e60900003000000000000000000000000000ea0c0000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e24417070726f76616c4576656e742e636c617373504b01021400140008080800aa7b564e826261e37e040000ca0900003000000000000000000000000000d7110000696f2f6e756c732f636f6e74726163742f746f6b656e2f546f6b656e245472616e736665724576656e742e636c617373504b0506000000000800080051020000b316000000001072665f6e726332305f6f66666c696e65154f0000000000001900000000000000040103616972010341495201053130303030010132480117020001f7ec6473df12e751d64cf20a8baa7edd50810f81020001006d67120000000000000000000000000000000000000000000000000000000000089c0aea02bed90ddd000000",
"contractAddress" : "tNULSeBaMwYiR4p1X9xNJPiyJfrXjr4KgkcFjG",
"hash" : "9443656bab59f52441286e1d859855be28cbe155973c712c07385a21b7212152"
}
}
# 4.20 Offline Assembly - Calling a contract transaction
# Cmd: /api/contract/call/offline
- Offline assembly - Calling contract transactions #####HttpMethod: POST
#####Form JSON data
{
"sender" : null,
"senderBalance" : null,
"nonce" : null,
"contractAddress" : null,
"gasLimit" : 0,
"value" : null,
"methodName" : null,
"methodDesc" : null,
"args" : null,
"argsType" : null,
"remark" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Call Contract Offline Trading | contractcalloffline | Call Contract Offline Trading Form | Yes |
sender | string | Transaction Creator | Yes |
senderBalance | biginteger | Account Balance | Yes |
nonce | string | account nonce value | yes |
contractAddress | string | Smart Contract Address | Yes |
gasLimit | long | GAS Limits | Yes |
value | biginteger | The amount of the primary network asset that the caller transferred to the contract address. If there is no such service, fill in 0 | Yes |
methodName | string | method name | yes |
methodDesc | string | Method Description, if the method in the contract is not overloaded, this parameter can be empty | No |
args | object[] | Parameter List | No |
argsType | string[] | Parameter Type List | No |
remark | string | Notes | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization String |
# Example request data:
request path: [TBD]
request form data:
{
"sender" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"senderBalance" : "999999998523475",
"nonce" : "9c0aea02bed90ddd",
"contractAddress" : "tNULSeBaMwYiR4p1X9xNJPiyJfrXjr4KgkcFjG",
"gasLimit" : 14166,
"value" : 0,
"methodName" : "transfer",
"methodDesc" : null,
"args" : [ "tNULSeBaMnrs6JKrCy6TQdzYJZkMZJDng7QAsD", 3800 ],
"argsType" : [ "Address", "BigInteger" ],
"remark" : "remark_call_test"
}
#####Example response data:
{
"success" : true,
"data" : {
"txHex" : "1000be2a375d1072656d61726b5f63616c6c5f7465737497020001f7ec6473df12e751d64cf20a8baa7edd50810f810200020d2f73cb93099a8cfd0cbdd060155abfe2f50917000000000000000000000000000000000000000000000000000000000000000056370000000000001900000000000000087472616e7366657200020126744e554c536542614d6e7273364a4b724379365451647a594a5a6b4d5a4a446e673751417344010433383030480117020001f7ec6473df12e751d64cf20a8baa7edd50810f810200010006ee060000000000000000000000000000000000000000000000000000000000089c0aea02bed90ddd000000",
"hash" : "aa69824582c6a3c1a4d486bbd38377a4c4a0ec4ea75a898fc70d109364a41bbf"
}
}
# 4.21 Offline Assembly - Delete Contract Transactions
# Cmd: /api/contract/delete/offline
- Offline assembly - delete contract transaction #####HttpMethod: POST
#####Form JSON data
{
"sender" : null,
"senderBalance" : null,
"nonce" : null,
"contractAddress" : null,
"remark" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Delete Contract Offline Trading | contractdeleteoffline | Delete Contract Offline Trading Form | Yes |
sender | string | Transaction Creator | Yes |
senderBalance | biginteger | Account Balance | Yes |
nonce | string | account nonce value | yes |
contractAddress | string | Smart Contract Address | Yes |
remark | string | Notes | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization String |
# Example request data:
request path: [TBD]
request form data:
{
"sender" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"senderBalance" : "999999998523475",
"nonce" : "9c0aea02bed90ddd",
"contractAddress" : "tNULSeBaMxyMyafiQjq1wCW7cQouyEhRL8njtu",
"remark" : "delete contract"
}
#####Example response data:
{
"success" : true,
"data" : {
"txHex" : "11004f2c375d0f64656c65746520636f6e74726163742e020001f7ec6473df12e751d64cf20a8baa7edd50810f81020002245bcd36879bc30bfc719a417939b3aa924247ca480117020001f7ec6473df12e751d64cf20a8baa7edd50810f8102000100a086010000000000000000000000000000000000000000000000000000000000089c0aea02bed90ddd000000",
"hash" : "780cd742592e16e9062f5a04f72273b1c92f8f130e2c93bdb25662fa4ad7aa50"
}
}
# 4.22 Offline Assembly - Contract Token Transfer Transaction
# Cmd: /api/contract/tokentransfer/offline
- Offline assembly - contract token transfer transaction #####HttpMethod: POST
#####Form JSON data
{
"fromAddress" : null,
"senderBalance" : null,
"nonce" : null,
"toAddress" : null,
"contractAddress" : null,
"gasLimit" : 0,
"amount" : null,
"remark" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
token transfer offline transaction | contracttokentransferoffline | token transfer offline transaction form | yes |
fromAddress | string | Transferr Account Address | Yes |
senderBalance | biginteger | Transferring Account Balance | Yes |
nonce | string | Transferr account nonce value | Yes |
toAddress | string | Transferr Account Address | Yes |
contractAddress | string | Contract Address | Yes |
gasLimit | long | GAS Limits | Yes |
amount | biginteger | Amount of transferred token assets | Yes |
remark | string | Notes | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization String |
# Example request data:
request path: [TBD]
request form data:
{
"fromAddress" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"senderBalance" : "999999998523475",
"nonce" : "9c0aea02bed90ddd",
"toAddress" : "tNULSeBaMnrs6JKrCy6TQdzYJZkMZJDng7QAsD",
"contractAddress" : "tNULSeBaN3MH7HX8kXzKw4X9tLKQ991X1GiAbK",
"gasLimit" : 14166,
"amount" : 10,
"remark" : "1"
}
#####Example response data:
{
"success" : true,
"data" : {
"txHex" : "1000632b375d0431e4b8aa95020001f7ec6473df12e751d64cf20a8baa7edd50810f810200026b8d9b09ed5c1a692a6109c5ee99ccb6177b13a1000000000000000000000000000000000000000000000000000000000000000056370000000000001900000000000000087472616e7366657200020126744e554c536542614d6e7273364a4b724379365451647a594a5a6b4d5a4a446e67375141734401023130480117020001f7ec6473df12e751d64cf20a8baa7edd50810f810200010006ee060000000000000000000000000000000000000000000000000000000000089c0aea02bed90ddd000000",
"hash" : "4eb36b1fb31b0888895c0cdcab39c80ac986b18f7aef721a390ff1727c77ef10"
}
}
# 4.23 Offline Assembly - Contract transactions from account address to contract address transfer (main chain asset)
# Cmd: /api/contract/transfer2contract/offline
- Offline assembly - contract transaction from account address to contract address (main chain asset) #####HttpMethod: POST
#####Form JSON data
{
"fromAddress" : null,
"senderBalance" : null,
"nonce" : null,
"toAddress" : null,
"gasLimit" : 0,
"amount" : null,
"remark" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Transferring offline transactions to contract addresses | contracttransferoffline | Transferring offline transaction forms to contract addresses | Yes |
fromAddress | string | Transferr Account Address | Yes |
senderBalance | biginteger | Transferring Account Balance | Yes |
nonce | string | Transferr account nonce value | Yes |
toAddress | string | Transferred contract address | Yes |
gasLimit | long | GAS Limits | Yes |
amount | biginteger | Transferred main chain asset amount | Yes |
remark | string | Notes | No |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization String |
# Example request data:
request path: [TBD]
request form data:
{
"fromAddress" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"senderBalance" : "999999998523475",
"nonce" : "9c0aea02bed90ddd",
"toAddress" : "tNULSeBaMxyMyafiQjq1wCW7cQouyEhRL8njtu",
"gasLimit" : 25896,
"amount" : "400000000",
"remark" : "Offline transfer to contract"
}
#####Example response data:
{
"success" : true,
"data" : {
"txHex" : "1000e82b375d15e7a6bbe7babfe59091e59088e7baa6e8bdace8b4a677020001f7ec6473df12e751d64cf20a8baa7edd50810f81020002245bcd36879bc30bfc719a417939b3aa924247ca0084d7170000000000000000000000000000000000000000000000000000000028650000000000001900000000000000085f70617961626c650e28292072657475726e20766f6964008c0117020001f7ec6473df12e751d64cf20a8baa7edd50810f810200010088ebe21700000000000000000000000000000000000000000000000000000000089c0aea02bed90ddd000117020002245bcd36879bc30bfc719a417939b3aa924247ca020001000084d71700000000000000000000000000000000000000000000000000000000000000000000000000",
"hash" : "4ed64d90abf420beba1baf68399c85d290347dc41de2c49384a2f8c895d4addf"
}
}
# 5.1 Creating a consensus node
# Cmd: /api/consensus/agent
- Create consensus node #####HttpMethod: POST
#####Form JSON data
{
"agentAddress" : null,
"packingAddress" : null,
"rewardAddress" : null,
"commissionRate" : 0,
"deposit" : null,
"password" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
CreateAgentForm | createagentform | Create Consensus Node Form | Yes |
agentAddress | string | Node Address | Yes |
packingAddress | string | Node Block Address | Yes |
rewardAddress | string | Reward address, default node address | No |
commissionRate | int | Commission Ratio | Yes |
deposit | string | Mortgage Amount | Yes |
password | string | Password | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | transaction hash |
# Example request data:
request path: [TBD]
request form data:
{
"agentAddress" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"packingAddress" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"rewardAddress" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"commissionRate" : 10,
"deposit" : "2000000000000",
"password" : "abcd1234"
}
#####Example response data:
{
"success" : true,
"data" : {
"value" : "52456e830fa389c72c4a71e4224db5aa869d0fbfd0cb2175096e6e5fb6a5c6ee"
}
}
# 5.2 Logout Consensus Node
# Cmd: /api/consensus/agent/stop
- Logout consensus node #####HttpMethod: POST
#####Form JSON data
{
"address" : null,
"password" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
StopAgentForm | stopagentform | Unregister Consensus Node Form | Yes |
address | string | Consensus Node Address | Yes |
password | string | Password | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | transaction hash |
# Example request data:
request path: [TBD]
request form data:
{
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"password" : "abcd1234"
}
#####Example response data:
{
"success" : true,
"data" : {
"value" : "fcaf8c92a0eafd2ca57744c165e1a955edcbfde98248494937200cc30d524e2e"
}
}
# 5.3 Entrusted to participate in the consensus
# Cmd: /api/consensus/deposit
- Entrusted participation in consensus #####HttpMethod: POST
#####Form JSON data
{
"address" : null,
"agentHash" : null,
"deposit" : null,
"password" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
DepositForm | depositform | Delegate Participation Consensus Form | Yes |
address | string | Participation in Consensus Account Address | Yes |
agentHash | string | consensus node hash | yes |
deposit | string | Amount of consensus | Yes |
password | string | Password | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | transaction hash |
# Example request data:
request path: [TBD]
request form data:
{
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"agentHash" : "52456e830fa389c72c4a71e4224db5aa869d0fbfd0cb2175096e6e5fb6a5c6ee",
"deposit" : "200000000000",
"password" : "abcd1234"
}
#####Example response data:
{
"success" : true,
"data" : {
"value" : "4ae333f8bf821884d0f589f35516c8bdd9661dbd8a7009b063ac862eeefc10f6"
}
}
# 5.4 Exit Consensus
# Cmd: /api/consensus/withdraw
- Exit consensus #####HttpMethod: POST
#####Form JSON data
{
"address" : null,
"txHash" : null,
"password" : null
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
Exit Consensus | withdrawform | Exit Consensus Form | Yes |
address | string | Node Address | Yes |
txHash | string | Trading hash when joining consensus | Yes |
password | string | Password | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
value | string | transaction hash |
# Example request data:
request path: [TBD]
request form data:
{
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"txHash" : "4ae333f8bf821884d0f589f35516c8bdd9661dbd8a7009b063ac862eeefc10f6",
"password" : "abcd1234"
}
#####Example response data:
{
"success" : true,
"data" : {
"value" : "13a0e252bf05ec02f3ae0a84fc3b8183dbfc0e16c562b20b8e28b73b139f2c0e"
}
}
# 5.5 Querying the node's delegate consensus list
# Cmd: /api/consensus/list/deposit/{agentHash}
- Query node's delegate consensus list
# HttpMethod: GET
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
agentHash | string | Create a consensus node transaction hash | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
deposit | string | |
agentHash | string | node hash |
address | string | Account Address |
time | long | delegation time |
txHash | string | Trusted transaction hash |
blockHeight | long | Block height at delegate |
delHeight | long | Exit the block height of the delegate |
# Example request data:
request path: http://localhost:18004/api/consensus/list/deposit/786402b17649b968e4643cb52fa30225645b0dc7b8761b047a1f080d3dd30dcd
request form data: no
#####Example response data:
{
"success" : true,
"data" : [ {
"deposit" : "200000000000",
"agentHash" : "786402b17649b968e4643cb52fa30225645b0dc7b8761b047a1f080d3dd30dcd",
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"time" : 1563277510,
"txHash" : "bd93cf73331c0d9986cb90922d2eec785ea9eda3da85cd9d629b5a4c7f36c452",
"blockHeight" : 462,
"delHeight" : -1
}, {
"deposit" : "200000000000",
"agentHash" : "786402b17649b968e4643cb52fa30225645b0dc7b8761b047a1f080d3dd30dcd",
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"time" : 1563277712,
"txHash" : "be5257bc0814cbda61378ff2afa81e98cae0018cd7d78b8d1ca9812c66d27e84",
"blockHeight" : 482,
"delHeight" : -1
} ]
}
# 5.6 Offline Assembly - Create Consensus Node Transactions
# Cmd: /api/consensus/agent/offline
- The assets required to participate in the consensus can be obtained through the query chain information interface (agentChainId and agentAssetId) #####HttpMethod: POST
#####Form JSON data
{
"agentAddress" : null,
"packingAddress" : null,
"rewardAddress" : null,
"commissionRate" : 0,
"deposit" : null,
"input" : {
"address" : null,
"assetChainId" : 0,
"assetId" : 0,
"amount" : null,
"nonce" : null
}
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
ConsensusDto | consensusdto | Create consensus node form offline | Yes |
agentAddress | string | Node Creation Address | Yes |
packingAddress | string | Node Block Address | Yes |
rewardAddress | string | Get Consensus Reward Address | Yes |
commissionRate | int | Node commission ratio | Yes |
deposit | biginteger | Create Node Margin | Yes |
input | object | Transaction input information | Yes |
address | string | Account Address | Yes |
assetChainId | int | Asset Chain id | Yes |
assetId | int | Asset id | Yes |
amount | biginteger | Asset Amount | Yes |
nonce | string | Asset nonce value | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization String |
# Example request data:
request path: [TBD]
request form data:
{
"agentAddress" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"packingAddress" : "tNULSeBaMvEtDfvZuukDf2mVyfGo3DdiN8KLRG",
"rewardAddress" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"commissionRate" : 10,
"deposit" : "2000000000000",
"input" : {
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"assetChainId" : 2,
"assetId" : 1,
"amount" : "2000001000000",
"nonce" : "63ac862eeefc10f6"
}
}
#####Example response data:
{
"success" : true,
"data" : {
"txHex" : "040019b72d5d006600204aa9d1010000000000000000000000000000000000000000000000000000020001efa328e600912da9872390a675486ab9e8ec2114020001f7ec6473df12e751d64cf20a8baa7edd50810f81020001efa328e600912da9872390a675486ab9e8ec21140a8c0117020001efa328e600912da9872390a675486ab9e8ec211402000100406259a9d10100000000000000000000000000000000000000000000000000000863ac862eeefc10f6000117020001efa328e600912da9872390a675486ab9e8ec21140200010000204aa9d1010000000000000000000000000000000000000000000000000000ffffffffffffffff00",
"hash" : "786402b17649b968e4643cb52fa30225645b0dc7b8761b047a1f080d3dd30dcd"
}
}
# 5.7 Offline Assembly - Unregister Consensus Node Transaction
# Cmd: /api/consensus/agent/stop/offline
- The StopDepositDto information of the assembly transaction can be obtained by querying the node's delegate consensus list, and the input nonce value can be empty #####HttpMethod: POST
#####Form JSON data
{
"agentHash" : null,
"agentAddress" : null,
"deposit" : null,
"price" : null,
"depositList" : [ {
"depositHash" : null,
"input" : {
"address" : null,
"assetChainId" : 0,
"assetId" : 0,
"amount" : null,
"nonce" : null
}
} ]
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
StopConsensusDto | stopconsensusdto | Offline Logout Consensus Node Form | Yes |
agentHash | string | Create node transaction hash | Yes |
agentAddress | string | Node Address | Yes |
deposit | biginteger | Create a node's margin | Yes |
price | biginteger | Fee Price | No |
depositList | list<object> | Stop delegate list | Yes |
depositHash | string | Trusted Consensus Trading hash | Yes |
input | object | Transaction input | Yes |
address | string | Account Address | Yes |
assetChainId | int | Chain id of assets | Yes |
assetId | int | asset id | yes |
amount | biginteger | Asset Amount | Yes |
nonce | string | asset nonce value | yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization String |
# Example request data:
request path: [TBD]
request form data:
{
"agentHash" : "786402b17649b968e4643cb52fa30225645b0dc7b8761b047a1f080d3dd30dcd",
"agentAddress" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"deposit" : "2000000000000",
"price" : "100000",
"depositList" : [ {
"depositHash" : "bd93cf73331c0d9986cb90922d2eec785ea9eda3da85cd9d629b5a4c7f36c452",
"input" : {
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"assetChainId" : 2,
"assetId" : 1,
"amount" : "200000000000",
"nonce" : ""
}
}, {
"depositHash" : "be5257bc0814cbda61378ff2afa81e98cae0018cd7d78b8d1ca9812c66d27e84",
"input" : {
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"assetChainId" : 2,
"assetId" : 1,
"amount" : "200000000000",
"nonce" : ""
}
} ]
}
#####Example response data:
{
"success" : true,
"data" : {
"txHex" : "0900e1bc2d5d0020786402b17649b968e4643cb52fa30225645b0dc7b8761b047a1f080d3dd30dcdfd5c010317020001efa328e600912da9872390a675486ab9e8ec21140200010000204aa9d1010000000000000000000000000000000000000000000000000000087a1f080d3dd30dcdff17020001efa328e600912da9872390a675486ab9e8ec21140200010000d0ed902e00000000000000000000000000000000000000000000000000000008629b5a4c7f36c452ff17020001efa328e600912da9872390a675486ab9e8ec21140200010000d0ed902e000000000000000000000000000000000000000000000000000000081ca9812c66d27e84ff0217020001efa328e600912da9872390a675486ab9e8ec211402000100609948a9d1010000000000000000000000000000000000000000000000000000f1ca2d5d0000000017020001efa328e600912da9872390a675486ab9e8ec21140200010000a0db215d000000000000000000000000000000000000000000000000000000000000000000000000",
"hash" : "c07b40a70858b262a39b55deb08c9d505384c017580f91976979e8984a096eaf"
}
}
# 5.8 Offline Assembly - Entrusted to participate in consensus transactions
# Cmd: /api/consensus/deposit/offline
- The assets required to participate in the consensus can be obtained through the query chain information interface (agentChainId and agentAssetId) #####HttpMethod: POST
#####Form JSON data
{
"address" : null,
"deposit" : null,
"agentHash" : null,
"input" : {
"address" : null,
"assetChainId" : 0,
"assetId" : 0,
"amount" : null,
"nonce" : null
}
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
DepositDto | depositdto | Offline delegate participation consensus form | Yes |
address | string | Account Address | Yes |
deposit | biginteger | Delegate amount | Yes |
agentHash | string | consensus node hash | yes |
input | object | Transaction input information | Yes |
address | string | Account Address | Yes |
assetChainId | int | Asset Chain id | Yes |
assetId | int | Asset id | Yes |
amount | biginteger | Asset Amount | Yes |
nonce | string | Asset nonce value | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization String |
# Example request data:
request path: [TBD]
request form data:
{
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"deposit" : "200000000000",
"agentHash" : "786402b17649b968e4643cb52fa30225645b0dc7b8761b047a1f080d3dd30dcd",
"input" : {
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"assetChainId" : 2,
"assetId" : 1,
"amount" : "200010000000",
"nonce" : "629b5a4c7f36c452"
}
}
#####Example response data:
{
"success" : true,
"data" : {
"txHex" : "050090b92d5d005700d0ed902e000000000000000000000000000000000000000000000000000000020001efa328e600912da9872390a675486ab9e8ec2114786402b17649b968e4643cb52fa30225645b0dc7b8761b047a1f080d3dd30dcd8c0117020001efa328e600912da9872390a675486ab9e8ec211402000100806686912e00000000000000000000000000000000000000000000000000000008629b5a4c7f36c452000117020001efa328e600912da9872390a675486ab9e8ec21140200010000d0ed902e000000000000000000000000000000000000000000000000000000ffffffffffffffff00",
"hash" : "be5257bc0814cbda61378ff2afa81e98cae0018cd7d78b8d1ca9812c66d27e84"
}
}
# 5.9 Offline Assembly - Exit Consensus Trading
# Cmd: /api/consensus/withdraw/offline
- The input data of the interface is the output data of the trusted consensus transaction, and the nonce value can be empty #####HttpMethod: POST
#####Form JSON data
{
"address" : null,
"depositHash" : null,
"price" : null,
"input" : {
"address" : null,
"assetChainId" : 0,
"assetId" : 0,
"amount" : null,
"nonce" : null
}
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
WithDrawDto | withdrawdto | Offline Exit Consensus Form | Yes |
address | string | address | yes |
depositHash | string | Delegation of Consensus Transaction | Yes |
price | biginteger | Fee Price | No |
input | object | Transaction input information | Yes |
address | string | Account Address | Yes |
assetChainId | int | Asset Chain id | Yes |
assetId | int | Asset id | Yes |
amount | biginteger | Asset Amount | Yes |
nonce | string | Asset nonce value | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization String |
# Example request data:
request path: [TBD]
request form data:
{
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"depositHash" : "be5257bc0814cbda61378ff2afa81e98cae0018cd7d78b8d1ca9812c66d27e84",
"price" : "1000000",
"input" : {
"address" : "tNULSeBaMujLBcZWfE2wHKnZo7PGvqvNrt6yWG",
"assetChainId" : 2,
"assetId" : 1,
"amount" : 200000000000,
"nonce" : ""
}
}
#####Example response data:
{
"success" : true,
"data" : {
"txHex" : "060090ba2d5d0020be5257bc0814cbda61378ff2afa81e98cae0018cd7d78b8d1ca9812c66d27e848c0117020001efa328e600912da9872390a675486ab9e8ec21140200010000d0ed902e000000000000000000000000000000000000000000000000000000081ca9812c66d27e84ff0117020001efa328e600912da9872390a675486ab9e8ec211402000100c08dde902e000000000000000000000000000000000000000000000000000000000000000000000000",
"hash" : "d1a054a1bc5d20bab53235993a5a2aee6f3c644e67e0044c60a08c7c49bb0ff2"
}
}
# 5.10 Multi-Sign Account Offline Assembly - Create Consensus Node Transaction
# Cmd: /api/consensus/multiSign/agent/offline
- The assets required to participate in the consensus can be obtained through the query chain information interface (agentChainId and agentAssetId) #####HttpMethod: POST
#####Form JSON data
{
"agentAddress" : null,
"packingAddress" : null,
"rewardAddress" : null,
"commissionRate" : 0,
"deposit" : null,
"input" : null,
"pubKeys" : [ ],
"minSigns" : 0
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
MultiSignConsensusDto | multisignconsensusdto | Multi-Sign Account Offline Create Consensus Node Form | Yes |
agentAddress | string | Node Creation Address | Yes |
packingAddress | string | Node Block Address | Yes |
rewardAddress | string | Get Consensus Reward Address | Yes |
commissionRate | int | Node commission ratio | Yes |
deposit | biginteger | Create Node Margin | Yes |
input | object | Transaction input information | Yes |
address | string | Account Address | Yes |
assetChainId | int | Asset Chain id | Yes |
assetId | int | Asset id | Yes |
amount | biginteger | Asset Amount | Yes |
nonce | string | Asset nonce value | Yes |
pubKeys | list<string> | Public Key Collection | Yes |
minSigns | int | Minimum Signatures | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization String |
# 5.11 Offline Assembly - Multi-Sign Account Entrusted to Participate in Consensus Trading
# Cmd: /api/consensus/multiSign/deposit/offline
- The assets required to participate in the consensus can be obtained through the query chain information interface (agentChainId and agentAssetId) #####HttpMethod: POST
#####Form JSON data
{
"address" : null,
"deposit" : null,
"agentHash" : null,
"input" : null,
"pubKeys" : [ ],
"minSigns" : 0
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
MultiSignDepositDto | multisigndepositdto | Multi-Sign Account Offline Delegate Participation Consensus Form | Yes |
address | string | Account Address | Yes |
deposit | biginteger | Delegate amount | Yes |
agentHash | string | consensus node hash | yes |
input | object | Transaction input information | Yes |
address | string | Account Address | Yes |
assetChainId | int | Asset Chain id | Yes |
assetId | int | Asset id | Yes |
amount | biginteger | Asset Amount | Yes |
nonce | string | Asset nonce value | Yes |
pubKeys | list<string> | Public Key Collection | Yes |
minSigns | int | Minimum Signatures | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization String |
# 5.12 Offline Assembly - Multi-Sign Account Exit Consensus Transaction
# Cmd: /api/consensus/multiSign/withdraw/offline
- The input data of the interface is the output data of the trusted consensus transaction, and the nonce value can be empty #####HttpMethod: POST
#####Form JSON data
{
"address" : null,
"depositHash" : null,
"price" : null,
"input" : null,
"pubKeys" : [ ],
"minSigns" : 0
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
WithDrawDto | multisignwithdrawdto | Multi-Sign Account Offline Exit Consensus Form | Yes |
address | string | address | yes |
depositHash | string | Delegation of Consensus Transaction | Yes |
price | biginteger | Fee Price | No |
input | object | Transaction input information | Yes |
address | string | Account Address | Yes |
assetChainId | int | Asset Chain id | Yes |
assetId | int | Asset id | Yes |
amount | biginteger | Asset Amount | Yes |
nonce | string | Asset nonce value | Yes |
pubKeys | list<string> | Public Key Collection | Yes |
minSigns | int | Minimum Signatures | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization String |
# 5.13 Offline Assembly - Multi-Sign Account Deregistration Consensus Node Transaction
# Cmd: /api/consensus/multiSign/agent/stop/offline
- The StopDepositDto information of the assembly transaction can be obtained by querying the node's delegate consensus list, and the input nonce value can be empty #####HttpMethod: POST
#####Form JSON data
{
"agentHash" : null,
"agentAddress" : null,
"deposit" : null,
"price" : null,
"depositList" : null,
"pubKeys" : [ ],
"minSigns" : 0
}
#####Parameter list
Parameter Name | Parameter Type | Parameter Description | Required |
---|---|---|---|
StopConsensusDto | multisignstopconsensusdto | Multi-Sign Account Offline Logout Consensus Node Form | Yes |
agentHash | string | Create node transaction hash | Yes |
agentAddress | string | Node Address | Yes |
deposit | biginteger | Create a node's margin | Yes |
price | biginteger | Fee Price | No |
depositList | list<object> | Stop delegate list | Yes |
depositHash | string | Trusted Consensus Trading hash | Yes |
input | object | Transaction input | Yes |
address | string | Account Address | Yes |
assetChainId | int | Chain id of assets | Yes |
assetId | int | asset id | yes |
amount | biginteger | Asset Amount | Yes |
nonce | string | asset nonce value | yes |
pubKeys | list<string> | Public Key Collection | Yes |
minSigns | int | Minimum Signatures | Yes |
#####Return values
Field Name | Field Type | Parameter Description |
---|---|---|
hash | string | transaction hash |
txHex | string | Transaction Serialization String |