Skip to content

08_Transaction_Interface.md

Latest commit

 

History

History
299 lines (231 loc) · 9.05 KB

08_Transaction_Interface.md

File metadata and controls

299 lines (231 loc) · 9.05 KB

Transaction Interface

Transfer

POST chain_sendTransaction (Transfer tokens)
Parameters
name type data type description
from required string Sender
to required string Receiver
value required string (hex) Amount
sliceno required string (hex) Metaspace number
Responses
http code content-type response
0 application/json {"txhash":"..."}

Response Fields:

  • txhash - Transaction hash
Example cURL
 {
   "jsonrpc": "3.0",
   "method": "chain_sendTransaction",
   "params": [{
     "from": "0xc3b6472d6370eaf4eb58fff19ce1724c9d61892c",
     "to": "0x6268af5542c4b0ccbb650a0aaccbfcdfbabf6b52",
     "value": "0x2E90EDD00",
     "sliceno": "0x1"
   }, "", "encryp=none"],
   "id": "d2c8fe196f9f8d8ace952e9e"
 }
Response Example
 {
   "jsonrpc": "3.0",
   "id": "d2c8fe196f9f8d8ace952e9e",
   "result": {
     "ret": "0",
     "err": "",
     "content": {
       "txhash": "0x6885997ca51fa08ffded573088b0c5c294652ec842ac7f3182d32e30ce261025"
     }
   }
 }

Distribute Transactions

POST chain_airDrop (Batch transfer)
Parameters
name type data type description
allocate required string Batch transfer content (base64 encoded JSON)
sliceno required int Metaspace number

Content Format (before base64 encoding):

{
  "from": "0x4ace8d71fd08d72b467cabc607d9fe1adfc28a75",
  "total": 100,
  "dest": [{
    "addr": "0x35f4646842fc5Fe208b7D3fab125C8542be88324",
    "nums": 60
  },{
    "addr": "0xc94196d73E8eA564b1c753e07814Ee5635de7045",
    "nums": 40
  }]
}
Responses
http code content-type response
0 application/json {"txhash":"..."}

Response Fields:

  • txhash - Transaction hash
Example cURL
 {
   "jsonrpc": "3.0",
   "method": "chain_airDrop",
   "params": ["opcode=allocate&allocate=&sliceno=1", "encryp=none"],
   "id": "d2c8fe196f9f8d8ace952e9e"
 }
Response Example
 {
   "jsonrpc": "3.0",
   "id": "d2c8fe196f9f8d8ace952e9e",
   "result": {
     "ret": "0",
     "err": "",
     "content": {
       "txhash": "0x6885997ca51fa08ffded573088b0c5c294652ec842ac7f3182d32e30ce261025"
     }
   }
 }

Deploy Contract

POST chain_sendTransaction (Deploy smart contract)

Programming Language: Solidity
Compilation Version: 0.8.1

Parameters
name type data type description
from required string Current logged-in account address
data required string (hex) Contract hex content
sliceno required string (hex) Metaspace number
Responses
http code content-type response
0 application/json {"txhash":"..."}

Response Fields:

  • txhash - Transaction hash
Example cURL
 {
   "jsonrpc": "3.0",
   "method": "chain_sendTransaction",
   "params": [{
     "from": "0x2c8e94bbe17cec95f21dfdb55e334cfd4effcd9d",
     "data": "0x6008......",
     "sliceno": "0x1"
   }, "", "encryp=none"],
   "id": "a3d18f63c99c7660c87c5f3e"
 }
Response Example
 {
   "jsonrpc": "3.0",
   "id": "d2c8fe196f9f8d8ace952e9e",
   "result": {
     "ret": "0",
     "err": "",
     "content": {
       "txhash": "0x6885997ca51fa08ffded573088b0c5c294652ec842ac7f3182d32e30ce261025"
     }
   }
 }

Execute Contract

POST chain_sendTransaction (Execute contract function)
Parameters
name type data type description
from required string Current logged-in account address
to required string Contract address
data required string (hex) Hex content (function code and parameters)
sliceno required string (hex) Metaspace number
Responses
http code content-type response
0 application/json {"txhash":"..."}

Response Fields:

  • txhash - Transaction hash
Example cURL
 {
   "jsonrpc": "3.0",
   "method": "chain_sendTransaction",
   "params": [{
     "from": "0x2c8e94bbe17cec95f21dfdb55e334cfd4effcd9d",
     "to": "0x61b3d1759e4d3bd238a2730cb1621fa542a771fd",
     "data": "0x60086678",
     "sliceno": "0x1"
   }, "", "encryp=none"],
   "id": "a3d18f63c99c7660c87c5f3e"
 }
Response Example
 {
   "jsonrpc": "3.0",
   "id": "d2c8fe196f9f8d8ace952e9e",
   "result": {
     "ret": "0",
     "err": "",
     "content": {
       "txhash": "0x6885997ca51fa08ffded573088b0c5c294652ec842ac7f3182d32e30ce261025"
     }
   }
 }

Contract Function Code Query

POST chain_queryFuntionCode (Query function code)
Parameters
name type data type description
params required string Function name
Responses
http code content-type response
0 application/json {"info":"..."}

Response Fields:

  • info - Function code
Example cURL
 {
   "jsonrpc": "3.0",
   "method": "chain_queryFuntionCode",
   "params": ["getTYpe()"],
   "id": "1"
 }
Response Example
 {
   "jsonrpc": "3.0",
   "id": "1",
   "result": {
     "ret": "0",
     "err": "",
     "content": {
       "info": "0xae591f49"
     }
   }
 }