Getting started with the nodela API

Introduction

Nodela has a Restful API with URL endpoints corresponding to actions that users can perform with their channels. The endpoints accept and return JSON encoded objects. The API URL path always contains the API version in order to differentiate queries to different API versions. All queries start with: /api/<version>/ where <version> is an integer representing the current API version.

Centralized Service API

using the following api ,we can easyly get a glimps of what is going on in the blockchain.

get transaction by transaction id

check out a transaction

GET /api/1/tx/(string:`txid`)

Example request:

GET /api/1/tx/62637968e72b06e4fa1de91542a3b71bd2462ba1d29e9c14c2ecfd042d1937ab HTTP/1.1
Host: localhost

Example response:

HTTP/1.1 200 OK
Content-Type: application/json

{
      "result":{
          "vsize":346,
          "locktime":0,
          "txid":"62637968e72b06e4fa1de91542a3b71bd2462ba1d29e9c14c2ecfd042d1937ab",
          "confirmations":6756,
          "type":8,
          "version":0,
          "vout":[
              {
                  "outputlock":0,
                  "address":"XQd1DCi6H62NQdWZQhJCRnrPn7sF9CTjaU",
                  "assetid":"a3d0eaa466df74983b5d7c543de6904f4c9418ead5ffd6d25814234a96db37b0",
                  "value":"0.10010000",
                  "n":0
              },
              {
                  "outputlock":0,
                  "address":"EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA",
                  "assetid":"a3d0eaa466df74983b5d7c543de6904f4c9418ead5ffd6d25814234a96db37b0",
                  "value":"0.50249300",
                  "n":1
              }
          ],
          "blockhash":"4021e5c0ace86221016d3aa2b114adbd84bb03692bb6ddc6034794260834c570",
          "size":346,
          "blocktime":1538279155,
          "payload":{
              "CrossChainAddresses":[
                  "EHLhCEbwViWBPwh1VhpECzYEA7jQHZ4zLv"
              ],
              "OutputIndexes":[
                  0
              ],
              "CrossChainAmounts":[
                  10000000
              ]
          },
          "vin":[
              {
                  "sequence":0,
                  "txid":"ba7bd41aae0a1371d9689ad04508f0754bb4a5333386411bccbdec718ce61625",
                  "vout":1
              }
          ],
          "payloadversion":0,
          "attributes":[
              {
                  "data":"32323432343239353130383035363838303230",
                  "usage":0
              }
          ],
          "time":1538279155,
          "programs":[
              {
                  "code":"21021421976fdbe518ca4e8b91a37f1831ee31e7b4ba62a32dfe2f6562efd57806adac",
                  "parameter":"40cf6b8a18c861fcad1c23816221cc40a0d2e7d43065c070e66905ff7d6c634068542dd2a9b0bbb24de6a5a547b57767f908fc384cd6dc06298de11ebc3338aa79"
              }
          ],
          "hash":"62637968e72b06e4fa1de91542a3b71bd2462ba1d29e9c14c2ecfd042d1937ab"
      },
      "status":200
  }
Status Codes:

Check the current network block height

tells you the current block height of the network

GET /api/1/currHeight

Example request:

GET /api/1/currHeight HTTP/1.1
Host: localhost

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "result": 128797,
  "status": 200
}
Status Codes:

get the balance of address

get the balance of the provided public address

GET /api/1/balance/(string:`public_address`)

Example request:

GET /api/1/balance/EbunxcqXie6UExs5SXDbFZxr788iGGvAs9 HTTP/1.1
Host: localhost

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
    "result":"2.11059400",
    "status":200
}
Status Codes:

Get the transactions of specific height

using height to get block contained transactions

GET /api/1/txs/(int:`block_height`)

get the transactions that the user (block_height) wrote.

Example request:

GET /api/1/txs/10 HTTP/1.1
Host: localhost

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "result": {
      "Transactions": [
          "53b06e08da9362abf50003e26f8b99b38bd32b6a7dfad83203ef5bb9da2f4a05"
      ],
      "Height": 10,
      "Hash": "1166ae059fd6914a44edde9aa8a2765138da0ab868ddaeb51d20d21908c488da"
  },
  "status": 200
}

create offline transaction

create a offline transaction utxo json data , you should sign it using private key

POST /api/1/createTx

Example request:

POST /api/1/createTx HTTP/1.1
Host: localhost

  {
      "inputs"  : ["EU3e23CtozdSvrtPzk9A1FeC9iGD896DdV"],
       "outputs" : [{
              "addr":"EPzxJrHefvE7TCWmEGQ4rcFgxGeGBZFSHw",
               "amt" :1000
           }]
  }

Example response:

  HTTP/1.1 200 OK
  Content-Type: application/json

  {
    "result": {
        "Transactions": [
            {
                "UTXOInputs": [
                    {
                        "address": "EU3e23CtozdSvrtPzk9A1FeC9iGD896DdV",
                        "txid": "fa9bcb8b2f3a3a1e627284ad8425faf70fa64146b88a3aceac538af8bfeffd91",
                        "index": 1
                    }
                ],
                "Fee": 100,
                "Outputs": [
                    {
                        "amount": 1000,
                        "address": "EPzxJrHefvE7TCWmEGQ4rcFgxGeGBZFSHw"
                    },
                    {
                        "amount": 99997800,
                        "address": "EU3e23CtozdSvrtPzk9A1FeC9iGD896DdV"
                    }
                ]
            }
        ]
    },
    "status": 200
}

create offline cross chain transaction

create a cross chain offline transaction utxo json data , you should sign it using private key

POST /api/1/createCrossTx

Example request:

POST /api/1/createCrossTx HTTP/1.1
Host: localhost

  {
      "inputs":[
          "EZEKtpUwDXyKLvq5JPRfezqA5k5G5rWa3Z",
          "EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA"
      ],
      "outputs":[
          {
              "addr":"ELag7vYvKcUBVKJkWosBQw73HSx8madjcP",
              "amt":120001
          }
      ]
  }

Example response:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "result": {
        "Transactions": [
            {
                "UTXOInputs": [
                    {
                        "address": "EZEKtpUwDXyKLvq5JPRfezqA5k5G5rWa3Z",
                        "txid": "a7f06797be1d354d27173045c63426d20f9085c5a175ea5fcc38a771c7148406",
                        "index": 1
                    },
                    {
                        "address": "EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA",
                        "txid": "9e17bb1448f5b5805c682afff28226193884e84a72d8680a35ce0fcf2ec70d97",
                        "index": 1
                    }
                ],
                "CrossChainAsset": [
                    {
                        "amount": 120001,
                        "address": "0000000000000000000000000000000000"
                    }
                ],
                "Fee": 20000,
                "Outputs": [
                    {
                        "amount": 130001,
                        "address": "XKUh4GLhFJiqAMTF6HyWQrV9pK9HcGUdfJ"
                    },
                    {
                        "amount": 34198299,
                        "address": "EZEKtpUwDXyKLvq5JPRfezqA5k5G5rWa3Z"
                    }
                ]
            }
        ]
    },
    "status": 200
}

send offline transaction

send raw transaction

POST /api/1/sendRawTx

Example request:

POST /api/1/sendRawTx HTTP/1.1
Host: localhost

  {
     "data":"0200010013313637333832373132343538363832353937350191FDEFBFF88A53ACCE3A8AB84641A60FF7FA2584AD8472621E3A3A2F8BCB9BFA01000000000002B037DB964A231458D2D6FFD5EA18944C4F90E63D547C5D3B9874DF66A4EAD0A3E80300000000000000000000214B177C93439E1E31B1CDA7C3B290F977C74CD0BFB037DB964A231458D2D6FFD5EA18944C4F90E63D547C5D3B9874DF66A4EAD0A368D8F5050000000000000000217779F85469B90D2F648D6BA771FB641D1782715E000000000141407009A5DAB9A8730ED424EF50217180D25AB81F0BB6E8257A672F9618F3CF13FD32D114DE171460C23532319A85614C460E83699C833E576B5C4782232299A2DF232103293CD3A3359B65FEA091CB6260675BD03A3C5E29CFFB504136A508E9BBBD5A8BAC"
  }

Example response:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "result": "1f4432635bcf8c347f2bc20b7906c8c6c195f51beb3426e5f8d6a9e4cc073cf3",
    "status": 200
}

get address transaction history

check transaction history of Address

Note

this api provided by Elastos.ORG.API.Misc ,so you need to deploy it if you want to use it.

GET /api/1/history/(string:`addr`)

Example request:

GET /api/1/history/EQoascGFzdQ1rLKfNEavJKTm3hMRhBaXBT HTTP/1.1
Host: localhost

Example response:

HTTP/1.1 200 OK
Content-Type: application/json

  {
      "result":{
          "History":[
              {
                  "Txid":"71eedccf5a45acc17036294b7a1e70c5756dd4c72032cc76d5089c522509096b",
                  "Type":"income",
                  "Value":24,
                  "CreateTime":1544101570,
                  "Height":175548,
                  "Fee":100,
                  "Inputs":[
                      "EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA"
                  ],
                  "Outputs":[
                      "EQoascGFzdQ1rLKfNEavJKTm3hMRhBaXBT",
                      "EQoascGFzdQ1rLKfNEavJKTm3hMRhBaXBT",
                      "EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA"
                  ]
              }
          ],
          "TotalNum":1
      },
      "status":200
  }
GET /api/1/history/(string:`addr`)?pageSize=(int:`pageSize`)&pageNum=(int:`pageNum`)

Example request:

GET /api/1/history/EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA?pageSize=4&pageNum=1 HTTP/1.1
Host: localhost

Example response:

HTTP/1.1 200 OK
Content-Type: application/json

  {
      "result":{
          "History":[
              {
                  "Txid":"58e11ffffafad7456835dc3eff8b28ec0d0b2aa39855d79bfb3e5c52b4cc308f",
                  "Type":"income",
                  "Value":8990000,
                  "CreateTime":1538114443,
                  "Height":38666,
                  "Fee":10000,
                  "Inputs":[

                  ],
                  "Outputs":[
                      "EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA"
                  ]
              },
              {
                  "Txid":"b04714ff7076e18efeb9963f99af2f10bd870d39a1774e0821b71640d6b14e52",
                  "Type":"spend",
                  "Value":100,
                  "CreateTime":1538115578,
                  "Height":38667,
                  "Fee":100,
                  "Inputs":[
                      "EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA"
                  ],
                  "Outputs":[
                      "EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA",
                      "EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA"
                  ]
              },
              {
                  "Txid":"49eb7f1335d89a9c43446613850d1b763a5f84cad0d1d039ab5726125d2eab47",
                  "Type":"spend",
                  "Value":100,
                  "CreateTime":1538203592,
                  "Height":39046,
                  "Fee":100,
                  "Inputs":[
                      "EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA",
                      "EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA"
                  ],
                  "Outputs":[
                      "EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA",
                      "EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA"
                  ]
              },
              {
                  "Txid":"d7d8b34944790cf2e1fa47851612ddb4eb7e3f5bd75a4af2227d3786b6f4c122",
                  "Type":"spend",
                  "Value":100,
                  "CreateTime":1539238227,
                  "Height":44755,
                  "Fee":100,
                  "Inputs":[
                      "EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA",
                      "EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA"
                  ],
                  "Outputs":[
                      "EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA",
                      "EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA"
                  ]
              }
          ],
          "TotalNum":55295
      },
      "status":200
  }

get did information

check did key’s value

Note

this api provided by Elastos.ORG.API.Misc ,so you need to deploy it if you want to use it.

GET /api/1/did/(string:`did`)/(string:`key`)

Example request:

GET /api/1/did/iYnguKQcpeVyrpN6edamSkky1brvQvCWr6/clark HTTP/1.1
Host: localhost

Example response:

HTTP/1.1 200 OK
Content-Type: application/json

  {
      "result":{
          "Did":"iYnguKQcpeVyrpN6edamSkky1brvQvCWr6",
          "Did_status":1,
          "Public_key":"0354E3AE040052CD61A38DF72E189EDCBBB8BA81599DED25019E286F2E013A3726",
          "Property_key":"clark",
          "Property_value":"hello,world",
          "Txid":"c39dd1463678146467ea1b43d8905e75ac34e727a4c36824410089a6682b43c8",
          "Block_time":1543902641,
          "Height":66480
      },
      "status":200
  }

Local Service API

If you are running code locally , you can use the following API .

create a ELA wallet

generate a elastos wallet

GET /api/1/createWallet

Example request:

GET /api/1/createWallet HTTP/1.1
Host: localhost

Example response:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "result":{
        "privateKey":"492F67D441F563AA4746497EB77C89906A3D3C06B242030BA966BC5604482EF7",
        "publicKey":"035EBC0D70C9E34006C932D7BB47474159C136A8944C92416A94481212379751CB",
        "address":"EJonBz8U1gYnANjSafRF9EAJW9KTwRKd6x"
    },
    "status":200
}
Status Codes:

generate mnemonic phrases

please copy your mnemonic to somewhere safe

GET /api/1/eng/mnemonic

Example request:

GET /api/1/eng/mnemonic HTTP/1.1
Host: localhost

Example response:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "result":"obtain pill nest sample caution stone candy habit silk husband give net",
    "status":200
}
Status Codes:
GET /api/1/cn/mnemonic

Example request:

GET /api/1/cn/mnemonic HTTP/1.1
Host: localhost

Example response:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "result":"命 氨 静 粘 汤 介 璃 沟 腰 贸 里 莱",
    "status":200
}
Status Codes:

using mnemonic to retrive wallet

Get wallet of index 1

POST /api/1/hd

Example request:

POST /api/1/hd HTTP/1.1
Host: localhost:8090
Content-Type: application/json

  {
      "mnemonic":"obtain pill nest sample caution stone candy habit silk husband give net",
      "index":1
  }

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
    "result": {
        "privateKey": "7A87D1C43FBDF76689A5A66A369B34E92391748F64D2952BCE3E6D5E06A8D8CD",
        "publicKey": "02345363ACEA3A744DC149193171A87B6888F4CD108821CC1F9AD689CCA53489AC",
        "publicAddress": "EXoaGjh6H9afjDX7DUBY1MpsdLz4Vo16Qa"
    },
    "status": 200
}

Get wallet from 1 to 10

POST /api/1/hd

Example request:

POST /api/1/hd HTTP/1.1
Host: localhost:8090
Content-Type: application/json

  {
      "mnemonic":"obtain pill nest sample caution stone candy habit silk husband give net",
      "start":1,
      "end":10
  }

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
    "result": [
        {
            "privateKey": "7A87D1C43FBDF76689A5A66A369B34E92391748F64D2952BCE3E6D5E06A8D8CD",
            "publicKey": "02345363ACEA3A744DC149193171A87B6888F4CD108821CC1F9AD689CCA53489AC",
            "publicAddress": "EXoaGjh6H9afjDX7DUBY1MpsdLz4Vo16Qa",
            "did": "iczhaJiyRj4LFsw4YT6CqtQET8mFWi29Pj"
        },
        {
            "privateKey": "D0E8FB87B32EC69EC8527486AF6780DB06983F395F8394372B88F9F29F738A91",
            "publicKey": "02371040B81C28B3A194826E1F8905687E06E94D5AEB1292C72051BF6ED314888D",
            "publicAddress": "EfPZc1VdGHztzeRag9ayb4MLPZA7psGuGs",
            "did": "iZ91XWKGTABjyXhZR5WrxWUCy7Xn7NvN5G"
        },
        {
            "privateKey": "5892859E60028872E63AEC018217F6A9A38AFC05F4FA4DB2FA2D07455B6C46E1",
            "publicKey": "0371EAD623897AEA29CBFB2ABC9A361E5862DCAEF68A265C6D4F8A506D3353CFC8",
            "publicAddress": "EPc6Mmx78YN8Mwa11qjLgSAgPjAWU7LJZu",
            "did": "idpYiBkpRb6dWxbqXZsUkshoWyJNs76wdR"
        },
        {
            "privateKey": "9F8A564E7CC0E4880006B8029A1FA220A60AF426D2CD90DEB52F4CCD5E89087C",
            "publicKey": "0323671B0FB55471D885300445E25893A1EF304484C73BD6F380959BF90987A0A9",
            "publicAddress": "EPgRBCe4BwNVpWFdNhLhTEebQG35b9MoFz",
            "did": "iXzouXufWtHNvi6y9HyC4iV8eapeW7TtjL"
        },
        {
            "privateKey": "CDA64875FED6B901595C732BD71F925C6CACF5DBC503F7C472D950975A90EF05",
            "publicKey": "027B4AEFD9208E25BD27F0416729E73187CB22B58859D40E756451D3B73079FD54",
            "publicAddress": "EKi96gzJSQj3zQ6LybXwNPmEguj66H8SjN",
            "did": "idRzqGSfQaQRA4LyjJH411DSS1VjHKW395"
        },
        {
            "privateKey": "1F3AE27B2E070E8A95257295FE602113D81A30B7554C3F77378A1CD04AEBBE53",
            "publicKey": "032063D96363FE153F85DCC0550C2753EEC407334DBACCDD933F3DC45CBC7BC1E0",
            "publicAddress": "EVVEw7p4wcfdXPMRzZhcD7TEGR1EXBG291",
            "did": "imcWdJX19HDpnCf6ErAaooEg9s2ibtnD3s"
        },
        {
            "privateKey": "9C6E82523939E11A455E2962EB0DE49211E7F4216D76836D557D9D395C59C4DB",
            "publicKey": "02622D0333371BFF4DB1512F655A22B1D8783B02E703477E35B76974EA2D9C89B9",
            "publicAddress": "EbYdmcS99kCo8D44AphCBjtE4SmGLeGsWw",
            "did": "iddpXhK28cvrLGNsbSzP78SkCz14gC1mHY"
        },
        {
            "privateKey": "8A69ADD6A8534C2E7D52067D8929D65354F8D218EE0FF1FA1C631A334821E85E",
            "publicKey": "024A4751A73AA5E186D83C171449FB8AF699C6EE0BC24DB34B85EEF5FA6EEDBD27",
            "publicAddress": "EcBVvLx31eN69KS3oWNLxxdaGK2UKUxg3g",
            "did": "iqAakUhsWoRALTF1jeMxDTu4MEqLiRGZDt"
        },
        {
            "privateKey": "4E2C9E4C320AF08C943AADA5BC9106E053DFD2AFC8A3F229213DB6BE36DB71D8",
            "publicKey": "0354674BFA392313760DD66936A2BEC9CDD8DA7AB264D920FC4AF0B14704646BA5",
            "publicAddress": "EPbCbYYCwbyxFQgU9XNAWwAFRbcJtDC7Tt",
            "did": "ijVq9RQveWNeTSDFkjMwL5ksCaSuqCNsoJ"
        },
        {
            "privateKey": "31E5DB750E2BAC324A0C7F59B2BAB9C574232B811F7A4650352AAD31A3C2A941",
            "publicKey": "036A2ED5B9F57636460B4CB38A6103E03A08F8A6E5B4F0326CD303B6407E7CC303",
            "publicAddress": "ESzmxv7R4Tkt1SakscXR1yxTYtPwuXtvZP",
            "did": "iopfp7FCQ9123MXHd4jxM4hRiwxmMxyhKj"
        }
    ],
    "status": 200
}

Create DID

create a did with the correspond private key.

GET /api/1/gen/did

Example Request:

GET /api/1/gen/did HTTP/1.1
Host: localhost

Example Response:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "result":{
        "privateKey":"7C6FE5BE1014198AB84FF9F9027C44F38A1E6A0B6F02E3077F538AEB63B1661C",
        "publicKey":"02EB78F1AC5465819AB82898C666C542D811813E5E9F6190E68B601C0D92FF6EE8",
        "publicAddr":"EJewutbVgYHKzfFpMndFZnHNaesLjahgzR",
        "did":"iUcizvgpUDHKcNWDyPohnc3m6gp3ww8NDS"
    },
    "status":200
}

Retrive DID

using private key to retrive did .

GET /api/1/did/(string:`private_key`)

Example Request:

GET /api/1/did/6E228664BE94833BB18DF6C66BE09173A8F42856E27CCF3DDEADE5785C16FDF7 HTTP/1.1
Host: localhost

Example Response:

HTTP/1.1 200 OK
Content-Type: application/json

{
  "result": "iXMBmDBXtqTEyiKEVga9dUNqhJBvE74Ln9",
  "status": 200
}

Set DID information

setting information into did. the first private key is used to pay the miner fee. the second private key is the private key of did ,used to sign the info. and we give the recommended format to write a did property. the first Status is the status of the did , it can be 1 or 0 ,0 stand for discard the DID, 1 stand for DID status normal ,the second Status is the did key status , it also can be 1 or 0 , 0 stand for discard the DID key , 1 stand for Did key status normal

POST /api/1/setDidInfo

Example Request:

POST /api/1/setDidInfo HTTP/1.1
Host: localhost

  {
      "privateKey":"C740869D015E674362B1F441E3EDBE1CBCF4FE8B709AA1A77E5CCA2C92BAF99D",
      "settings":{
          "privateKey":"E763239857B390502289CF75FF06EEEDC3252A302C50E1CBB7E5FAC8A703486F",
          "info":{
                      "Tag":"DID Property",
                      "Ver":"1.0",
                      "Status":1,
                      "Properties": [
                          {
                              "Key":"clark",
                              "Value":"hello,world",
                              "Status": 1
                          }
                      ]
          }
      }
  }

Example Response:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "result": "1170c18870d2547207b85bd9859dc97886ca8f570399da0bcfb40a0bdc2a1b20",
    "status": 200
}

transfer DID asset using private key

using private key to send transaction

POST /api/1/did/transfer

Example request:

POST /api/1/did/transfer HTTP/1.1
Host: localhost

  {
    "sender":[
        {
            "address":"EHLhCEbwViWBPwh1VhpECzYEA7jQHZ4zLv",
            "privateKey":"C740869D015E674362B1F441E3EDBE1CBCF4FE8B709AA1A77E5CCA2C92BAF99D"
        },
        {
            "address":"EbunxcqXie6UExs5SXDbFZxr788iGGvAs9",
            "privateKey":"FABB669B7D2FF2BEBBED1C3F1C9A9519C48993D1FC9D89DCB4C7CA14BDB8C99F"
        }
    ],
    "memo":"测试",
    "receiver":[
        {
            "address":"EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA",
            "amount":"2.4"
        }
    ]
}

Example response:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "result": "EB291AA789D542ECE75BCF806A375BD905EDD150046FF52D51DF7D149E37FFF5",
    "status": 200
}

Sidechain to Mainchain transfer

using this api you can transfer money from did sidechain to main chain.

POST /api/1/cross/d2m/transfer

Example Request:

POST /api/1/cross/d2m/transfer HTTP/1.1
Host: localhost

  {
    "sender":[
        {
            "address":"EbxU18T3M9ufnrkRY7NLt6sKyckDW4VAsA",
            "privateKey":"C740869D015E674362B1F441E3EDBE1CBCF4FE8B709AA1A77E5CCA2C92BAF99D"
        }
    ],
    "receiver":[
        {
            "address":"EHLhCEbwViWBPwh1VhpECzYEA7jQHZ4zLv",
            "amount":"0.089698"
        }
    ]
}

Example Response:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "result": "3CDEB61D4CC4541591CDE4B15EB391385715C713D6709FE84381481558C2B69A",
    "status": 200
}

Signing message using private key

POST /api/1/sign

Example request:

POST /api/1/sign HTTP/1.1
Host: localhost:8090
Content-Type: application/json

  {
      "privateKey":"0D5D7566CA36BC05CFF8E3287C43977DCBB492990EA1822643656D85B3CB0226",
      "msg":"你好，世界"
  }

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
    "result": {
        "msg": "E4BDA0E5A5BDEFBC8CE4B896E7958C",
        "pub": "02C3F59F337814C6715BBE684EC525B9A3CFCE55D9DEEC53E1EDDB0B352DBB4A54",
        "sig": "E6BB279CBD4727B41F2AA8B18E99B3F99DECBB8737D284FFDD408B356C912EE21AD478BCC0ABD65246938F17DDE64258FD8A9684C0649B23AE1318F7B9CEEEC7"
    },
    "status": 200
}

verify message signed by a public address’s private key

POST /api/1/verify

Example request:

POST /api/1/verify HTTP/1.1
Host: localhost
Content-Type: application/json

  {
      "msg": "E4BDA0E5A5BDEFBC8CE4B896E7958D",
      "pub": "02C3F59F337814C6715BBE684EC525B9A3CFCE55D9DEEC53E1EDDB0B352DBB4A54",
      "sig": "E6BB279CBD4727B41F2AA8B18E99B3F99DECBB8737D284FFDD408B356C912EE21AD478BCC0ABD65246938F17DDE64258FD8A9684C0649B23AE1318F7B9CEEEC7"
  }

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
    "result": true,
    "status": 200
}