Utility

All commands are listed below and detailed on their own section.

Search for transactions, addresses or tokens

post

https://core.pirichain.comhttps://testnet.pirichain.comhttps://custom.networkhttp://custom.network

/search

This endpoint searches for one of the following with the given "value" parameter in the PIRI network:

• Token

• Address

• Transaction

Body

application/x-www-form-urlencoded

valuestringRequired

Search content | Address, Token Name, Transaction ID

Responses

200

OK

application/json; charset=utf-8

typestringRequired

post

/search

HTTPcURLJavaScriptPython

POST /search HTTP/1.1
Host: core.pirichain.com
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 16

"value='text'"

200

OK

[
  {
    "type": "token",
    "data": {
      "_id": "<id>",
      "tokenSymbol": "test",
      "tokenName": "test",
      "logo": "<img_url or base64>",
      "assetID": 10012
    }
  }
]

Get test PIRI tokens

post

https://core.pirichain.comhttps://testnet.pirichain.comhttps://custom.networkhttp://custom.network

/givemePiri

Get test PIRI tokens for development purposes. This endpoint is typically used on testnet environments for testing purposes.

Body

application/x-www-form-urlencoded

addressstringRequired

PIRI address to receive test tokens

Responses

200

Test PIRI sent successfully

application/json; charset=utf-8

errorinteger · int32Optional

Error code, 0 for success

messagestringOptional

Response message indicating the result

txHashstringOptional

Transaction hash of the test PIRI transfer

post

/givemePiri

HTTPcURLJavaScriptPython

POST /givemePiri HTTP/1.1
Host: core.pirichain.com
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 18

"address='text'"

200

Test PIRI sent successfully

{
  "error": 0,
  "message": "Test PIRI sent successfully",
  "txHash": "d357d4..."
}

Reload network configuration settings

post

https://core.pirichain.comhttps://testnet.pirichain.comhttps://custom.networkhttp://custom.network

/reloadSetting

This endpoint allows reloading of network configuration settings on the blockchain network. By providing the hanOwnerSHA3 parameter (which is the SHA3 hash obtained during the blockchain network setup), the network settings can be reloaded and refreshed.

Body

application/x-www-form-urlencoded

hanOwnerSHA3stringOptional

SHA3 hash obtained during blockchain network setup, required for authentication to reload network settings

Responses

200

Response from reload settings operation

application/json; charset=utf-8

errorinteger · enumRequired

Error code: 0 for success, 1 for failure

Possible values:

datastringOptional

Error message when operation fails (only present when error is 1)

post

/reloadSetting

HTTPcURLJavaScriptPython

POST /reloadSetting HTTP/1.1
Host: core.pirichain.com
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 23

"hanOwnerSHA3='text'"

200

Response from reload settings operation

{
  "error": 0
}