{"id":582,"date":"2023-07-15T11:39:35","date_gmt":"2023-07-15T03:39:35","guid":{"rendered":"https:\/\/www.paralism.com\/info\/docs\/paralism-node-restapi\/2-getonchainstate-queries-the-processing-status-of-submitted-uplink-requests\/"},"modified":"2023-07-15T13:44:00","modified_gmt":"2023-07-15T05:44:00","slug":"2-getonchainstate-queries-the-processing-status-of-submitted-uplink-requests","status":"publish","type":"docs","link":"https:\/\/www.paralism.com\/info\/docs\/paralism-node-restapi\/2-getonchainstate-queries-the-processing-status-of-submitted-uplink-requests\/","title":{"rendered":"2. GetOnchainState queries the processing status of submitted on-chain requests"},"content":{"rendered":"\n<p>*Parameter: id, the id of the on-chain request to query<\/p>\n\n\n\n<p>*Example:<\/p>\n\n\n\n<p>http:\/\/127.0.0.1:8080\/GetOnchainState?requestid=DexA4KRY9zEMkSmLBrU9XRWWzbUyw<\/p>\n\n\n\n<p>*Four examples:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"chainNumber\": 1,\n  \"hyperBlockId\": 16,\n  \"localBlockId\": 2,\n  \"onChainState\": \"onchained\"\n}<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"chainNumber\": 1,\n  \"hyperBlockId\": 3507,\n  \"localBlockId\": 2,\n  \"onChainState\": \"matured \"\n}\n\n{\n  \"onChainState\": \"onchaining2\"\n}\n\n{\n  \"onChainState\": \"queueing\",\n  \"queuenum\": 3\n}<\/code><\/pre>\n\n\n\n<p>Return value:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>queue, the sequence number of on-chain requests cached locally on the node. Returns when the state is queuing.<\/li>\n\n\n\n<li>onChainState, on-chain state:<\/li>\n\n\n\n<li>queuing, the on-chain request is cached locally on the node and queued in the uplink.<\/li>\n\n\n\n<li>onchaining1, the on-chain data has been added to the local consensus for constructing the sub chain.<\/li>\n\n\n\n<li>onchaining2, the on-chain data has been added to the local consensus along with the business sub chain.<\/li>\n\n\n\n<li>onchained, the on-chain data has been recognized by the global consensus and corresponding hyperblocks have been obtained in the business local chain, in mapSearchOnChain<\/li>\n\n\n\n<li>matured, mature, after 4 global consensus cycles (which can be set by MATURATY_TIME), the obtained hyperblock is not discarded by the network, indicating that the hyperblock and related local chains have successfully solidified consensus across the entire network, and the possibility of being forked and discarded again is extremely low.<\/li>\n\n\n\n<li>nonexistent, the submitted  on-chain request was not found<\/li>\n\n\n\n<li>failed, the  on-chain request submission failed<\/li>\n\n\n\n<li>unknown, an unknown problem has occurred.<\/li>\n<\/ul>\n","protected":false},"featured_media":0,"parent":578,"menu_order":1,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[],"class_list":["post-582","docs","type-docs","status-publish","hentry"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/www.paralism.com\/info\/wp-json\/wp\/v2\/docs\/582","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.paralism.com\/info\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.paralism.com\/info\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/www.paralism.com\/info\/wp-json\/wp\/v2\/comments?post=582"}],"version-history":[{"count":3,"href":"https:\/\/www.paralism.com\/info\/wp-json\/wp\/v2\/docs\/582\/revisions"}],"predecessor-version":[{"id":642,"href":"https:\/\/www.paralism.com\/info\/wp-json\/wp\/v2\/docs\/582\/revisions\/642"}],"up":[{"embeddable":true,"href":"https:\/\/www.paralism.com\/info\/wp-json\/wp\/v2\/docs\/578"}],"next":[{"title":"3. SyncHyperblock retrieves the specified hyperblock from the chain space and downloads it to this node","link":"https:\/\/www.paralism.com\/info\/docs\/paralism-node-restapi\/3-synchyperblock-retrieves-the-specified-hyperblock-from-the-chain-space-and-downloads-it-to-this-node\/","href":"https:\/\/www.paralism.com\/info\/wp-json\/wp\/v2\/docs\/585"}],"prev":[{"title":"1. SubmitRegistration Submit an on-chain request","link":"https:\/\/www.paralism.com\/info\/docs\/paralism-node-restapi\/1-submitregistration-submit-an-uplink-request\/","href":"https:\/\/www.paralism.com\/info\/wp-json\/wp\/v2\/docs\/579"}],"wp:attachment":[{"href":"https:\/\/www.paralism.com\/info\/wp-json\/wp\/v2\/media?parent=582"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.paralism.com\/info\/wp-json\/wp\/v2\/doc_tag?post=582"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}