# Utility All commands are listed below and detailed on their own section. ## Search for transactions, addresses or tokens > This endpoint searches for one of the following with the given "value" parameter in the PIRI network:\ > \- Token\ > \- Address\ > \- Transaction ```json {"openapi":"3.0.3","info":{"title":"Pirichain API","version":"1.1.0"},"tags":[{"name":"Utility","description":"All commands are listed below and detailed on their own section."}],"servers":[{"url":"https://core.pirichain.com","description":"Pirichain MainNet","variables":{}},{"url":"https://testnet.pirichain.com","description":"Pirichain TestNet","variables":{}},{"url":"https://{URL}","description":"You can only use https protocol for your custom environment.","variables":{"URL":{"default":"custom.network","description":"You can enter your custom endpoint which belong to Pirichain Network"}}},{"url":"http://{URL}","description":"Custom HTTP endpoint for development environment (not recommended for production).","variables":{"URL":{"default":"custom.network","description":"You can enter your custom endpoint which belong to Pirichain Network"}}}],"paths":{"/search":{"post":{"tags":["Utility"],"summary":"Search for transactions, addresses or tokens","description":"This endpoint searches for one of the following with the given \"value\" parameter in the PIRI network:\n- Token\n- Address\n- Transaction","operationId":"Search","requestBody":{"content":{"application/x-www-form-urlencoded":{"encoding":{},"schema":{"required":["value"],"type":"object","properties":{"value":{"type":"string","description":"Search content | Address, Token Name, Transaction ID"}}}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json; charset=utf-8":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/search"}}}}}},"deprecated":false}}},"components":{"schemas":{"search":{"title":"search","required":["type","data"],"type":"object","properties":{"type":{"type":"string"},"data":{"$ref":"#/components/schemas/TokenInfo"}}},"TokenInfo":{"title":"TokenInfo","required":["_id","tokenSymbol","tokenName","logo","assetID"],"type":"object","properties":{"_id":{"type":"string"},"tokenSymbol":{"type":"string"},"tokenName":{"type":"string"},"logo":{"type":"string"},"assetID":{"type":"integer","format":"int32"}}}}}} ``` ## Get test PIRI tokens > Get test PIRI tokens for development purposes. This endpoint is typically used on testnet environments for testing purposes. ```json {"openapi":"3.0.3","info":{"title":"Pirichain API","version":"1.1.0"},"tags":[{"name":"Utility","description":"All commands are listed below and detailed on their own section."}],"servers":[{"url":"https://core.pirichain.com","description":"Pirichain MainNet","variables":{}},{"url":"https://testnet.pirichain.com","description":"Pirichain TestNet","variables":{}},{"url":"https://{URL}","description":"You can only use https protocol for your custom environment.","variables":{"URL":{"default":"custom.network","description":"You can enter your custom endpoint which belong to Pirichain Network"}}},{"url":"http://{URL}","description":"Custom HTTP endpoint for development environment (not recommended for production).","variables":{"URL":{"default":"custom.network","description":"You can enter your custom endpoint which belong to Pirichain Network"}}}],"paths":{"/givemePiri":{"post":{"tags":["Utility"],"summary":"Get test PIRI tokens","description":"Get test PIRI tokens for development purposes. This endpoint is typically used on testnet environments for testing purposes.","operationId":"givemePiri","requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"PIRI address to receive test tokens"}}}}}},"responses":{"200":{"description":"Test PIRI sent successfully","content":{"application/json; charset=utf-8":{"schema":{"$ref":"#/components/schemas/givemePiri"}}}}},"deprecated":false}}},"components":{"schemas":{"givemePiri":{"title":"givemePiri","type":"object","properties":{"error":{"type":"integer","format":"int32","description":"Error code, 0 for success"},"message":{"type":"string","description":"Response message indicating the result"},"txHash":{"type":"string","description":"Transaction hash of the test PIRI transfer"}}}}}} ``` ## Reload network configuration settings > 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. ```json {"openapi":"3.0.3","info":{"title":"Pirichain API","version":"1.1.0"},"tags":[{"name":"Utility","description":"All commands are listed below and detailed on their own section."}],"servers":[{"url":"https://core.pirichain.com","description":"Pirichain MainNet","variables":{}},{"url":"https://testnet.pirichain.com","description":"Pirichain TestNet","variables":{}},{"url":"https://{URL}","description":"You can only use https protocol for your custom environment.","variables":{"URL":{"default":"custom.network","description":"You can enter your custom endpoint which belong to Pirichain Network"}}},{"url":"http://{URL}","description":"Custom HTTP endpoint for development environment (not recommended for production).","variables":{"URL":{"default":"custom.network","description":"You can enter your custom endpoint which belong to Pirichain Network"}}}],"paths":{"/reloadSetting":{"post":{"tags":["Utility"],"summary":"Reload network configuration settings","description":"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.","operationId":"reloadSetting","requestBody":{"required":false,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","properties":{"hanOwnerSHA3":{"type":"string","description":"SHA3 hash obtained during blockchain network setup, required for authentication to reload network settings"}}}}}},"responses":{"200":{"description":"Response from reload settings operation","content":{"application/json; charset=utf-8":{"schema":{"$ref":"#/components/schemas/reloadSetting"}}}}},"deprecated":false}}},"components":{"schemas":{"reloadSetting":{"title":"reloadSetting","type":"object","required":["error"],"properties":{"error":{"type":"integer","format":"int32","description":"Error code: 0 for success, 1 for failure","enum":[0,1]},"data":{"type":"string","description":"Error message when operation fails (only present when error is 1)"}}}}}} ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://api.pirichain.com/utility.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.