{ "openrpc": "1.2.6", "info": { "title": "Celestia Node API", "description": "The Celestia Node API is the collection of RPC methods that can be used to interact with the services provided by Celestia Data Availability Nodes.", "version": "v0.34.2-mocha" }, "externalDocs": { "description": "Celestia Node GitHub", "url": "https://github.com/celestiaorg/celestia-node" }, "methods": [ { "name": "blob.Get", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Get retrieves the blob by commitment under the given namespace and height.\n", "paramStructure": "by-position", "params": [ { "name": "height", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, { "name": "namespace", "description": "libshare.Namespace", "summary": "", "schema": { "examples": [ "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdE=" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "commitment", "description": "blob.Commitment", "summary": "", "schema": { "examples": [ "aHlbp+J9yub6hw/uhK6dP8hBLR2mFy78XNRRdLf2794=" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "*blob.Blob", "description": "*blob.Blob", "summary": "", "schema": { "examples": [ { "namespace": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdE=", "data": "z8QyNztvogN7NYU27gI+nJgg1vMJtkK3vbduSDz7/8mhmos37I7duH51kkgouxrsdhdOBJ1431OmipNfVedbtwe6zQ06EbJBl/jk4QwwU3S29YBTUZcUfTzXpEJIuMrYzU6YPxN8Zce/KNdsEIy4zxdfxekXpvsgZMBhf83iYgfHvsFAoJmmCp/ORAUoAFf7tJ7cF8RZyA20ftqRa1uhAmktxIb58abpGTG+TNgq3mjyvswECVykJYqGjqNtInyIx2EQOnVp2q69YHkegdoBvoOKzEFigQTdrL2TZBex4MhkrYt7Zf0DQyNMRkCPL/zKYE3bhvXNWMThWCmhD5TOApzirORXKOTB0nxhjDF/aFYkrS+IKBw1KfJ5isldWvmasJBWwRgDuli6Cty67vMMk7fUUTUf0St6rvQeftSoEVlC1xEw46+h5kIXaWiM0g/EzGIAdZHycUFWCSdnt3p7BS5ttEpSf1d6ZbVYYL2y0XguH41k54JqufEMAw9ukmaF0IbN9Jk6fNefV1dsWTdCP6Mz6e+RTCd9DQGqb2VrsvMzx5uVidLD8ND79pvXgL1VzyhJaMTcjSfZK15jOxLwGh1arZc2gyTNiq2pu6wNz0tdJp+fFU+peG8rHN8=", "share_version": 0, "commitment": "aHlbp+J9yub6hw/uhK6dP8hBLR2mFy78XNRRdLf2794=", "index": -1 } ], "additionalProperties": false, "properties": { "blob": {}, "commitment": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/blob/blob.go#L110" } }, { "name": "blob.GetAll", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "GetAll returns all blobs under the given namespaces at the given height.\nIf all blobs were found without any errors, the user will receive a list of blobs.\nIf the BlobService couldn't find any blobs under the requested namespaces,\nthe user will receive an empty list of blobs along with an empty error.\nIf some of the requested namespaces were not found, the user will receive all the found blobs\nand an empty error. If there were internal errors during some of the requests,\nthe user will receive all found blobs along with a combined error message.\n\nAll blobs will preserve the order of the namespaces that were requested.\n", "paramStructure": "by-position", "params": [ { "name": "height", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, { "name": "namespaces", "description": "[]libshare.Namespace", "summary": "", "schema": { "examples": [ [ "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdE=" ] ], "items": [ { "additionalProperties": false, "type": [ "object" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false } ], "result": { "name": "[]*blob.Blob", "description": "[]*blob.Blob", "summary": "", "schema": { "examples": [ [ { "namespace": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdE=", "data": "z8QyNztvogN7NYU27gI+nJgg1vMJtkK3vbduSDz7/8mhmos37I7duH51kkgouxrsdhdOBJ1431OmipNfVedbtwe6zQ06EbJBl/jk4QwwU3S29YBTUZcUfTzXpEJIuMrYzU6YPxN8Zce/KNdsEIy4zxdfxekXpvsgZMBhf83iYgfHvsFAoJmmCp/ORAUoAFf7tJ7cF8RZyA20ftqRa1uhAmktxIb58abpGTG+TNgq3mjyvswECVykJYqGjqNtInyIx2EQOnVp2q69YHkegdoBvoOKzEFigQTdrL2TZBex4MhkrYt7Zf0DQyNMRkCPL/zKYE3bhvXNWMThWCmhD5TOApzirORXKOTB0nxhjDF/aFYkrS+IKBw1KfJ5isldWvmasJBWwRgDuli6Cty67vMMk7fUUTUf0St6rvQeftSoEVlC1xEw46+h5kIXaWiM0g/EzGIAdZHycUFWCSdnt3p7BS5ttEpSf1d6ZbVYYL2y0XguH41k54JqufEMAw9ukmaF0IbN9Jk6fNefV1dsWTdCP6Mz6e+RTCd9DQGqb2VrsvMzx5uVidLD8ND79pvXgL1VzyhJaMTcjSfZK15jOxLwGh1arZc2gyTNiq2pu6wNz0tdJp+fFU+peG8rHN8=", "share_version": 0, "commitment": "aHlbp+J9yub6hw/uhK6dP8hBLR2mFy78XNRRdLf2794=", "index": -1 } ] ], "items": [ { "additionalProperties": false, "properties": { "blob": {}, "commitment": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": [ "object" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/blob/blob.go#L119" } }, { "name": "blob.GetCommitmentProof", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "GetCommitmentProof generates a commitment proof for a share commitment.\n", "paramStructure": "by-position", "params": [ { "name": "height", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, { "name": "namespace", "description": "libshare.Namespace", "summary": "", "schema": { "examples": [ "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdE=" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "shareCommitment", "description": "[]byte", "summary": "", "schema": { "examples": [ "Ynl0ZSBhcnJheQ==" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "*blob.CommitmentProof", "description": "*blob.CommitmentProof", "summary": "", "schema": { "examples": [ { "subtree_roots": [ "Ynl0ZSBhcnJheQ==" ], "subtree_root_proofs": [ {} ], "namespace_id": "Bw==", "row_proof": { "row_roots": [ "Ynl0ZSBhcnJheQ==" ], "proofs": [ { "total": "42", "index": "42", "leaf_hash": "Ynl0ZSBhcnJheQ==", "aunts": [ "Ynl0ZSBhcnJheQ==" ] } ], "root": "Ynl0ZSBhcnJheQ==", "start_row": 42, "end_row": 42 }, "namespace_version": 7 } ], "additionalProperties": false, "properties": { "namespace_id": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "namespace_version": { "type": "integer" }, "row_proof": { "additionalProperties": false, "properties": { "end_row": { "type": "integer" }, "proofs": { "items": { "additionalProperties": false, "type": "object" }, "type": "array" }, "root": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "row_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" }, "start_row": { "type": "integer" } }, "type": "object" }, "subtree_root_proofs": { "items": { "additionalProperties": false, "type": "object" }, "type": "array" }, "subtree_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/blob/blob.go#L132" } }, { "name": "blob.GetProof", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "GetProof retrieves proofs in the given namespaces at the given height by commitment.\n", "paramStructure": "by-position", "params": [ { "name": "height", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, { "name": "namespace", "description": "libshare.Namespace", "summary": "", "schema": { "examples": [ "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdE=" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "commitment", "description": "blob.Commitment", "summary": "", "schema": { "examples": [ "aHlbp+J9yub6hw/uhK6dP8hBLR2mFy78XNRRdLf2794=" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "*blob.Proof", "description": "*blob.Proof", "summary": "", "schema": { "examples": [ [ { "end": 8, "nodes": [ "/////////////////////////////////////////////////////////////////////////////wuxStDHcZ7+b5byNQMVLJbzBT3wmObsThoQ0sCTjTCP" ], "is_max_namespace_ignored": true }, { "end": 8, "nodes": [ "//////////////////////////////////////////////////////////////////////////////n1NeJxPU2bZUAccKZZ+LAu2Wj5ajbVYURV9ojhSKwp" ], "is_max_namespace_ignored": true }, { "end": 8, "nodes": [ "/////////////////////////////////////////////////////////////////////////////0xK8BKnzDmwK0HR4ZJvyB4kh3jPPXGxaGPFoga8vPxF" ], "is_max_namespace_ignored": true }, { "end": 7, "nodes": [ "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwn/EaU0x0UTO9HUGKjyjcv5U2gHeSjJ8S1rftqv6k8kxlVWW8e/7", "/////////////////////////////////////////////////////////////////////////////wexh4khLQ9HQ2X6nh9wU5B+m6r+LWwPTEDTa5/CosDF" ], "is_max_namespace_ignored": true } ] ], "items": [ { "additionalProperties": false, "type": [ "object" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/blob/blob.go#L123" } }, { "name": "blob.Included", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Included checks whether a blob's given commitment(Merkle subtree root) is included at\ngiven height and under the namespace.\n", "paramStructure": "by-position", "params": [ { "name": "height", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, { "name": "namespace", "description": "libshare.Namespace", "summary": "", "schema": { "examples": [ "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdE=" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "proof", "description": "*blob.Proof", "summary": "", "schema": { "examples": [ [ { "end": 8, "nodes": [ "/////////////////////////////////////////////////////////////////////////////wuxStDHcZ7+b5byNQMVLJbzBT3wmObsThoQ0sCTjTCP" ], "is_max_namespace_ignored": true }, { "end": 8, "nodes": [ "//////////////////////////////////////////////////////////////////////////////n1NeJxPU2bZUAccKZZ+LAu2Wj5ajbVYURV9ojhSKwp" ], "is_max_namespace_ignored": true }, { "end": 8, "nodes": [ "/////////////////////////////////////////////////////////////////////////////0xK8BKnzDmwK0HR4ZJvyB4kh3jPPXGxaGPFoga8vPxF" ], "is_max_namespace_ignored": true }, { "end": 7, "nodes": [ "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAwn/EaU0x0UTO9HUGKjyjcv5U2gHeSjJ8S1rftqv6k8kxlVWW8e/7", "/////////////////////////////////////////////////////////////////////////////wexh4khLQ9HQ2X6nh9wU5B+m6r+LWwPTEDTa5/CosDF" ], "is_max_namespace_ignored": true } ] ], "items": [ { "additionalProperties": false, "type": [ "object" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false }, { "name": "commitment", "description": "blob.Commitment", "summary": "", "schema": { "examples": [ "aHlbp+J9yub6hw/uhK6dP8hBLR2mFy78XNRRdLf2794=" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "bool", "description": "bool", "summary": "", "schema": { "examples": [ true ], "type": [ "boolean" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/blob/blob.go#L141" } }, { "name": "blob.Submit", "description": "Auth level: write. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Submit sends Blobs and reports the height in which they were included.\nAllows sending multiple Blobs atomically synchronously.\nUses default wallet registered on the Node.\n", "paramStructure": "by-position", "params": [ { "name": "blobs", "description": "[]*blob.Blob", "summary": "", "schema": { "examples": [ [ { "namespace": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdE=", "data": "z8QyNztvogN7NYU27gI+nJgg1vMJtkK3vbduSDz7/8mhmos37I7duH51kkgouxrsdhdOBJ1431OmipNfVedbtwe6zQ06EbJBl/jk4QwwU3S29YBTUZcUfTzXpEJIuMrYzU6YPxN8Zce/KNdsEIy4zxdfxekXpvsgZMBhf83iYgfHvsFAoJmmCp/ORAUoAFf7tJ7cF8RZyA20ftqRa1uhAmktxIb58abpGTG+TNgq3mjyvswECVykJYqGjqNtInyIx2EQOnVp2q69YHkegdoBvoOKzEFigQTdrL2TZBex4MhkrYt7Zf0DQyNMRkCPL/zKYE3bhvXNWMThWCmhD5TOApzirORXKOTB0nxhjDF/aFYkrS+IKBw1KfJ5isldWvmasJBWwRgDuli6Cty67vMMk7fUUTUf0St6rvQeftSoEVlC1xEw46+h5kIXaWiM0g/EzGIAdZHycUFWCSdnt3p7BS5ttEpSf1d6ZbVYYL2y0XguH41k54JqufEMAw9ukmaF0IbN9Jk6fNefV1dsWTdCP6Mz6e+RTCd9DQGqb2VrsvMzx5uVidLD8ND79pvXgL1VzyhJaMTcjSfZK15jOxLwGh1arZc2gyTNiq2pu6wNz0tdJp+fFU+peG8rHN8=", "share_version": 0, "commitment": "aHlbp+J9yub6hw/uhK6dP8hBLR2mFy78XNRRdLf2794=", "index": -1 } ] ], "items": [ { "additionalProperties": false, "properties": { "blob": {}, "commitment": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": [ "object" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false }, { "name": "options", "description": "*blob.SubmitOptions", "summary": "", "schema": { "examples": [ { "gas_price": 0.002, "is_gas_price_set": true, "max_gas_price": 0.4, "gas": 142225, "tx_priority": 1, "key_name": "my_celes_key", "signer_address": "celestia1pjcmwj8w6hyr2c4wehakc5g8cfs36aysgucx66", "fee_granter_address": "celestia1hakc56ax66ypjcmwj8w6hyr2c4g8cfs3wesguc" } ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "uint64", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/blob/blob.go#L106" } }, { "name": "blob.Subscribe", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Subscribe to published blobs from the given namespace as they are included.\n", "paramStructure": "by-position", "params": [ { "name": "namespace", "description": "libshare.Namespace", "summary": "", "schema": { "examples": [ "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdE=" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "\u003c-chan *blob.SubscriptionResponse", "description": "\u003c-chan *blob.SubscriptionResponse", "summary": "", "schema": { "title": "typeUnsupportedByJSONSchema", "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/blob/blob.go#L151" } }, { "name": "blob.SubscribeFromStartHeight", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "SubscribeFromStartHeight subscribes to published blobs from the given namespace,\nstarting from the given startHeight. It first replays historical blobs from startHeight\nto the current head, then streams new blobs as they arrive.\n", "paramStructure": "by-position", "params": [ { "name": "namespace", "description": "libshare.Namespace", "summary": "", "schema": { "examples": [ "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdE=" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "startHeight", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false } ], "result": { "name": "\u003c-chan *blob.SubscriptionResponse", "description": "\u003c-chan *blob.SubscriptionResponse", "summary": "", "schema": { "title": "typeUnsupportedByJSONSchema", "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/blob/blob.go#L158" } }, { "name": "blobstream.GetDataRootTupleInclusionProof", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "GetDataRootTupleInclusionProof creates an inclusion proof, for the data root tuple of block\nheight `height`, in the set of blocks defined by `start` and `end`. The range\nis end exclusive.\nIt's in the header module because it only needs access to the headers to generate the proof.\n", "paramStructure": "by-position", "params": [ { "name": "height", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, { "name": "start", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, { "name": "end", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false } ], "result": { "name": "*DataRootTupleInclusionProof", "description": "*DataRootTupleInclusionProof", "summary": "", "schema": { "examples": [ { "total": 42, "index": 42, "leaf_hash": "Ynl0ZSBhcnJheQ==", "aunts": [ "Ynl0ZSBhcnJheQ==" ] } ], "additionalProperties": false, "properties": { "aunts": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" }, "index": { "type": "integer" }, "leaf_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/blobstream/blobstream.go#L43" } }, { "name": "blobstream.GetDataRootTupleRoot", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "GetDataRootTupleRoot collects the data roots over a provided ordered range of blocks,\nand then creates a new Merkle root of those data roots. The range is end exclusive.\nIt's in the header module because it only needs access to the headers to generate the proof.\n", "paramStructure": "by-position", "params": [ { "name": "start", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, { "name": "end", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false } ], "result": { "name": "DataRootTupleRoot", "description": "DataRootTupleRoot", "summary": "", "schema": { "examples": [ "453D0BC3CB88A2ED6F2E06021383B22C72D25D7741AE51B4CAE1AD34D72A3F07" ], "type": [ "string" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/blobstream/blobstream.go#L39" } }, { "name": "das.SamplingStats", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "SamplingStats returns the current statistics over the DA sampling process.\n", "paramStructure": "by-position", "params": [], "result": { "name": "das.SamplingStats", "description": "das.SamplingStats", "summary": "", "schema": { "examples": [ { "head_of_sampled_chain": 1092, "head_of_catchup": 34101, "network_head_height": 470292, "workers": [ { "job_type": "catchup", "current": 1093, "from": 1002, "to": 1101 }, { "job_type": "catchup", "current": 33343, "from": 33302, "to": 33401 }, { "job_type": "catchup", "current": 34047, "from": 34002, "to": 34101 }, { "job_type": "catchup", "current": 1327, "from": 1302, "to": 1401 }, { "job_type": "catchup", "current": 1197, "from": 1102, "to": 1201 }, { "job_type": "catchup", "current": 1408, "from": 1402, "to": 1501 } ], "concurrency": 6, "catch_up_done": false, "is_running": true } ], "additionalProperties": false, "properties": { "catch_up_done": { "type": "boolean" }, "concurrency": { "type": "integer" }, "failed": { "patternProperties": { ".*": { "type": "integer" } }, "type": "object" }, "head_of_catchup": { "type": "integer" }, "head_of_sampled_chain": { "type": "integer" }, "is_running": { "type": "boolean" }, "network_head_height": { "type": "integer" }, "workers": { "items": { "additionalProperties": false, "properties": { "current": { "type": "integer" }, "error": { "type": "string" }, "from": { "type": "integer" }, "job_type": { "type": "string" }, "to": { "type": "integer" } }, "type": "object" }, "type": "array" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/das/das.go#L27" } }, { "name": "das.WaitCatchUp", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "WaitCatchUp blocks until DASer finishes catching up to the network head.\n", "paramStructure": "by-position", "params": [], "result": { "name": "Null", "description": "Null", "schema": { "type": [ "null" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/das/das.go#L31" } }, { "name": "fibre.Deposit", "description": "Auth level: write. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Deposit adds funds to the node's escrow account.\n", "paramStructure": "by-position", "params": [ { "name": "amount", "description": "sdktypes.Coin", "summary": "", "schema": { "examples": [ { "denom": "utia", "amount": "42" } ], "additionalProperties": false, "properties": { "amount": { "additionalProperties": false, "type": "object" }, "denom": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "cfg", "description": "*txclient.TxConfig", "summary": "", "schema": { "examples": [ { "gas_price": 0.002, "is_gas_price_set": true, "max_gas_price": 0.4, "gas": 142225, "tx_priority": 1, "key_name": "my_celes_key", "signer_address": "celestia1pjcmwj8w6hyr2c4wehakc5g8cfs36aysgucx66", "fee_granter_address": "celestia1hakc56ax66ypjcmwj8w6hyr2c4g8cfs3wesguc" } ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "Null", "description": "Null", "schema": { "type": [ "null" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/fibre/fibre.go#L109" } }, { "name": "fibre.Download", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Download reconstructs a blob from FSPs by blobID.\n", "paramStructure": "by-position", "params": [ { "name": "blobID", "description": "appfibre.BlobID", "summary": "", "schema": { "examples": [ "Amh5W6fifcrm+ocP7oSunT/IQS0dphcu/FzUUXS39u/e" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "*GetBlobResult", "description": "*GetBlobResult", "summary": "", "schema": { "examples": [ { "data": "ZmlicmUgYmxvYiBkYXRh" } ], "additionalProperties": false, "properties": { "data": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/fibre/fibre.go#L101" } }, { "name": "fibre.PendingWithdrawals", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "PendingWithdrawals returns not-yet-claimable withdrawals for the signer.\n", "paramStructure": "by-position", "params": [ { "name": "signer", "description": "string", "summary": "", "schema": { "examples": [ "string value" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "[]fibre.PendingWithdrawal", "description": "[]fibre.PendingWithdrawal", "summary": "", "schema": { "examples": [ [ { "signer": "string value", "amount": { "denom": "utia", "amount": "42" }, "requested_timestamp": "0001-01-01T00:00:00Z", "available_timestamp": "0001-01-01T00:00:00Z" } ] ], "items": [ { "additionalProperties": false, "properties": { "amount": { "additionalProperties": false, "properties": { "amount": { "additionalProperties": false, "type": "object" }, "denom": { "type": "string" } }, "type": "object" }, "available_timestamp": { "format": "date-time", "type": "string" }, "requested_timestamp": { "format": "date-time", "type": "string" }, "signer": { "type": "string" } }, "type": [ "object" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/fibre/fibre.go#L117" } }, { "name": "fibre.QueryEscrowAccount", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "QueryEscrowAccount returns the escrow account for the given signer.\n", "paramStructure": "by-position", "params": [ { "name": "signer", "description": "string", "summary": "", "schema": { "examples": [ "string value" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "*fibre.EscrowAccount", "description": "*fibre.EscrowAccount", "summary": "", "schema": { "examples": [ { "signer": "celestia1377k5an3f94v6wyaceu0cf4nq6gk2jtpc46g7h", "balance": { "denom": "utia", "amount": "1000000" }, "available_balance": { "denom": "utia", "amount": "900000" } } ], "additionalProperties": false, "properties": { "available_balance": { "additionalProperties": false, "properties": { "amount": { "additionalProperties": false, "type": "object" }, "denom": { "type": "string" } }, "type": "object" }, "balance": { "additionalProperties": false, "properties": { "amount": { "additionalProperties": false, "type": "object" }, "denom": { "type": "string" } }, "type": "object" }, "signer": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/fibre/fibre.go#L105" } }, { "name": "fibre.Submit", "description": "Auth level: write. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Submit runs the full flow: upload to FSPs, aggregate validator signatures,\nand settle MsgPayForFibre on-chain. Requires a Fibre-capable core endpoint.\n", "paramStructure": "by-position", "params": [ { "name": "ns", "description": "libshare.Namespace", "summary": "", "schema": { "examples": [ "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdE=" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "data", "description": "[]byte", "summary": "", "schema": { "examples": [ "Ynl0ZSBhcnJheQ==" ], "type": [ "string" ] }, "required": true, "deprecated": false }, { "name": "options", "description": "*txclient.TxConfig", "summary": "", "schema": { "examples": [ { "gas_price": 0.002, "is_gas_price_set": true, "max_gas_price": 0.4, "gas": 142225, "tx_priority": 1, "key_name": "my_celes_key", "signer_address": "celestia1pjcmwj8w6hyr2c4wehakc5g8cfs36aysgucx66", "fee_granter_address": "celestia1hakc56ax66ypjcmwj8w6hyr2c4g8cfs3wesguc" } ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "*SubmitResult", "description": "*SubmitResult", "summary": "", "schema": { "examples": [ { "blob_id": "Amh5W6fifcrm+ocP7oSunT/IQS0dphcu/FzUUXS39u/e", "validator_signatures": [ "dmFsaWRhdG9yX3NpZ25hdHVyZV9ieXRlcw==" ], "payment_promise": { "chain_id": "celestia", "namespace": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdE=", "blob_size": 1024, "commitment": "68795ba7e27dcae6fa870fee84ae9d3fc8412d1da6172efc5cd45174b7f6efde", "row_version": 2, "valset_height": 100, "creation_timestamp": "2025-01-01T00:00:00Z", "signature": "cHJvbWlzZV9zaWduYXR1cmVfYnl0ZXM=" }, "height": 42, "tx_hash": "A5CF62609391B17E0340A6E07BD15860AFA4BE7F5DAF28F2E22A1C3B0CE85E64" } ], "additionalProperties": false, "properties": { "blob_id": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "height": { "type": "integer" }, "payment_promise": { "additionalProperties": false, "properties": { "blob_size": { "type": "integer" }, "chain_id": { "type": "string" }, "commitment": { "items": { "type": "integer" }, "maxItems": 32, "minItems": 32, "type": "array" }, "creation_timestamp": { "format": "date-time", "type": "string" }, "namespace": { "additionalProperties": false, "type": "object" }, "row_version": { "type": "integer" }, "signature": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "valset_height": { "type": "integer" } }, "type": "object" }, "tx_hash": { "type": "string" }, "validator_signatures": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/fibre/fibre.go#L83" } }, { "name": "fibre.Upload", "description": "Auth level: write. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Upload does the off-chain half (encode, promise, upload, aggregate\nsignatures) and then sumbits MsgPayForFibre on-chain\nasynchronously in the background. Use Submit for the full flow.\n", "paramStructure": "by-position", "params": [ { "name": "ns", "description": "libshare.Namespace", "summary": "", "schema": { "examples": [ "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdE=" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "data", "description": "[]byte", "summary": "", "schema": { "examples": [ "Ynl0ZSBhcnJheQ==" ], "type": [ "string" ] }, "required": true, "deprecated": false }, { "name": "options", "description": "*txclient.TxConfig", "summary": "", "schema": { "examples": [ { "gas_price": 0.002, "is_gas_price_set": true, "max_gas_price": 0.4, "gas": 142225, "tx_priority": 1, "key_name": "my_celes_key", "signer_address": "celestia1pjcmwj8w6hyr2c4wehakc5g8cfs36aysgucx66", "fee_granter_address": "celestia1hakc56ax66ypjcmwj8w6hyr2c4g8cfs3wesguc" } ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "*UploadResult", "description": "*UploadResult", "summary": "", "schema": { "examples": [ { "blob_id": "Amh5W6fifcrm+ocP7oSunT/IQS0dphcu/FzUUXS39u/e", "validator_signatures": [ "dmFsaWRhdG9yX3NpZ25hdHVyZV9ieXRlcw==" ], "payment_promise": { "chain_id": "celestia", "namespace": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdE=", "blob_size": 1024, "commitment": "68795ba7e27dcae6fa870fee84ae9d3fc8412d1da6172efc5cd45174b7f6efde", "row_version": 2, "valset_height": 100, "creation_timestamp": "2025-01-01T00:00:00Z", "signature": "cHJvbWlzZV9zaWduYXR1cmVfYnl0ZXM=" } } ], "additionalProperties": false, "properties": { "blob_id": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "payment_promise": { "additionalProperties": false, "properties": { "blob_size": { "type": "integer" }, "chain_id": { "type": "string" }, "commitment": { "items": { "type": "integer" }, "maxItems": 32, "minItems": 32, "type": "array" }, "creation_timestamp": { "format": "date-time", "type": "string" }, "namespace": { "additionalProperties": false, "type": "object" }, "row_version": { "type": "integer" }, "signature": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "valset_height": { "type": "integer" } }, "type": "object" }, "validator_signatures": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/fibre/fibre.go#L92" } }, { "name": "fibre.Withdraw", "description": "Auth level: write. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Withdraw requests a withdrawal; funds unbond before becoming claimable.\n", "paramStructure": "by-position", "params": [ { "name": "amount", "description": "sdktypes.Coin", "summary": "", "schema": { "examples": [ { "denom": "utia", "amount": "42" } ], "additionalProperties": false, "properties": { "amount": { "additionalProperties": false, "type": "object" }, "denom": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "cfg", "description": "*txclient.TxConfig", "summary": "", "schema": { "examples": [ { "gas_price": 0.002, "is_gas_price_set": true, "max_gas_price": 0.4, "gas": 142225, "tx_priority": 1, "key_name": "my_celes_key", "signer_address": "celestia1pjcmwj8w6hyr2c4wehakc5g8cfs36aysgucx66", "fee_granter_address": "celestia1hakc56ax66ypjcmwj8w6hyr2c4g8cfs3wesguc" } ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "Null", "description": "Null", "schema": { "type": [ "null" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/fibre/fibre.go#L113" } }, { "name": "header.GetByHash", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "GetByHash returns the header of the given hash from the node's header store.\n", "paramStructure": "by-position", "params": [ { "name": "hash", "description": "libhead.Hash", "summary": "", "schema": { "examples": [ "453D0BC3CB88A2ED6F2E06021383B22C72D25D7741AE51B4CAE1AD34D72A3F07" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "*header.ExtendedHeader", "description": "*header.ExtendedHeader", "summary": "", "schema": { "examples": [ { "header": { "version": { "block": "11" }, "chain_id": "mocha-5", "height": "67374", "time": "2023-02-25T12:10:28.067566292Z", "last_block_id": { "hash": "47A2C7758760988500B2F043D3903BBBF1C8B383CA33CF7056AA45E22055663E", "parts": { "total": 1, "hash": "33B012F244E27672169DD3D62CDBC92DA9486E410A5530F41FE6A890D8E2EE42" } }, "last_commit_hash": "888D47F5E9473501C99F2B6136B6B9FFBC9D1CD2F54002BCD5DF002FFEF0A83D", "data_hash": "257760461993F8F197B421EC7435F3C36C3734923E3DA9A42DC73B05F07B3D08", "validators_hash": "883A0C92B8D976312B249C1397E73CF2981A9EB715717CBEE3800B8380C22C1D", "next_validators_hash": "883A0C92B8D976312B249C1397E73CF2981A9EB715717CBEE3800B8380C22C1D", "consensus_hash": "048091BC7DDC283F77BFBF91D73C44DA58C3DF8A9CBC867405D8B7F3DAADA22F", "app_hash": "1FC70854A185737C7FD720FCCE9167876EE4B9ABE23DB1EBB8C552D3E3978435", "last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855", "evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855", "proposer_address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA" }, "commit": { "height": "67374", "round": 0, "block_id": { "hash": "A7F6B1CF33313121539206754A73FDC22ADA48C4AA8C4BB4F707ED2E089E59D3", "parts": { "total": 1, "hash": "6634FE1E1DDDCB9914ACE81F146013986F5FDA03A8F1C16DC5ECA0D9B0E08FBC" } }, "signatures": [ { "block_id_flag": 2, "validator_address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "timestamp": "2023-02-25T12:10:38.130121476Z", "signature": "HyR/uRIUNc5GNqQteZyrVjJM47SI9sRAgrLsNqJDls3AzbvHUfN4zzWyw0afyEvNm98Bm2GIoJoZC5D8oQvdBA==" } ] }, "validator_set": { "validators": [ { "address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "aoB4xU9//HAqOP9ciyp0+PTdZxt/UGKgZOabU6JxW8o=" }, "voting_power": "5000000000", "proposer_priority": "0" } ], "proposer": { "address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "aoB4xU9//HAqOP9ciyp0+PTdZxt/UGKgZOabU6JxW8o=" }, "voting_power": "5000000000", "proposer_priority": "0" } }, "dah": { "row_roots": [ "//////////7//////////ql+/VFmJ8PWE9BcjrTDLrY/hzVeGdzFCpfEhiXDXZmt", "/////////////////////zHeGnUtPJn8QyPpePSYl4qRVrcUvG2fwptyoA85Myik" ], "column_roots": [ "//////////7//////////ql+/VFmJ8PWE9BcjrTDLrY/hzVeGdzFCpfEhiXDXZmt", "/////////////////////zHeGnUtPJn8QyPpePSYl4qRVrcUvG2fwptyoA85Myik" ] } } ], "additionalProperties": false, "properties": { "commit": { "additionalProperties": false, "properties": { "block_id": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "parts": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "height": { "type": "integer" }, "round": { "type": "integer" }, "signatures": { "items": { "additionalProperties": false, "properties": { "block_id_flag": { "type": "integer" }, "signature": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "timestamp": { "format": "date-time", "type": "string" }, "validator_address": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "dah": { "additionalProperties": false, "properties": { "column_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" }, "row_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" } }, "type": "object" }, "header": { "additionalProperties": false, "properties": { "app_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "chain_id": { "type": "string" }, "consensus_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "data_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "evidence_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "height": { "type": "integer" }, "last_block_id": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "parts": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "last_commit_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "last_results_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "next_validators_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "time": { "format": "date-time", "type": "string" }, "validators_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "version": { "additionalProperties": false, "properties": { "app": { "type": "integer" }, "block": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "validator_set": { "additionalProperties": false, "properties": { "proposer": { "additionalProperties": false, "properties": { "address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_priority": { "type": "integer" }, "pub_key": { "additionalProperties": true }, "voting_power": { "type": "integer" } }, "type": "object" }, "validators": { "items": { "additionalProperties": false, "properties": { "address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_priority": { "type": "integer" }, "pub_key": { "additionalProperties": true }, "voting_power": { "type": "integer" } }, "type": "object" }, "type": "array" } }, "type": "object" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/header/header.go#L79" } }, { "name": "header.GetByHeight", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "GetByHeight returns the ExtendedHeader at the given height if it is\ncurrently available.\n", "paramStructure": "by-position", "params": [ { "name": "u", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false } ], "result": { "name": "*header.ExtendedHeader", "description": "*header.ExtendedHeader", "summary": "", "schema": { "examples": [ { "header": { "version": { "block": "11" }, "chain_id": "mocha-5", "height": "67374", "time": "2023-02-25T12:10:28.067566292Z", "last_block_id": { "hash": "47A2C7758760988500B2F043D3903BBBF1C8B383CA33CF7056AA45E22055663E", "parts": { "total": 1, "hash": "33B012F244E27672169DD3D62CDBC92DA9486E410A5530F41FE6A890D8E2EE42" } }, "last_commit_hash": "888D47F5E9473501C99F2B6136B6B9FFBC9D1CD2F54002BCD5DF002FFEF0A83D", "data_hash": "257760461993F8F197B421EC7435F3C36C3734923E3DA9A42DC73B05F07B3D08", "validators_hash": "883A0C92B8D976312B249C1397E73CF2981A9EB715717CBEE3800B8380C22C1D", "next_validators_hash": "883A0C92B8D976312B249C1397E73CF2981A9EB715717CBEE3800B8380C22C1D", "consensus_hash": "048091BC7DDC283F77BFBF91D73C44DA58C3DF8A9CBC867405D8B7F3DAADA22F", "app_hash": "1FC70854A185737C7FD720FCCE9167876EE4B9ABE23DB1EBB8C552D3E3978435", "last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855", "evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855", "proposer_address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA" }, "commit": { "height": "67374", "round": 0, "block_id": { "hash": "A7F6B1CF33313121539206754A73FDC22ADA48C4AA8C4BB4F707ED2E089E59D3", "parts": { "total": 1, "hash": "6634FE1E1DDDCB9914ACE81F146013986F5FDA03A8F1C16DC5ECA0D9B0E08FBC" } }, "signatures": [ { "block_id_flag": 2, "validator_address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "timestamp": "2023-02-25T12:10:38.130121476Z", "signature": "HyR/uRIUNc5GNqQteZyrVjJM47SI9sRAgrLsNqJDls3AzbvHUfN4zzWyw0afyEvNm98Bm2GIoJoZC5D8oQvdBA==" } ] }, "validator_set": { "validators": [ { "address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "aoB4xU9//HAqOP9ciyp0+PTdZxt/UGKgZOabU6JxW8o=" }, "voting_power": "5000000000", "proposer_priority": "0" } ], "proposer": { "address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "aoB4xU9//HAqOP9ciyp0+PTdZxt/UGKgZOabU6JxW8o=" }, "voting_power": "5000000000", "proposer_priority": "0" } }, "dah": { "row_roots": [ "//////////7//////////ql+/VFmJ8PWE9BcjrTDLrY/hzVeGdzFCpfEhiXDXZmt", "/////////////////////zHeGnUtPJn8QyPpePSYl4qRVrcUvG2fwptyoA85Myik" ], "column_roots": [ "//////////7//////////ql+/VFmJ8PWE9BcjrTDLrY/hzVeGdzFCpfEhiXDXZmt", "/////////////////////zHeGnUtPJn8QyPpePSYl4qRVrcUvG2fwptyoA85Myik" ] } } ], "additionalProperties": false, "properties": { "commit": { "additionalProperties": false, "properties": { "block_id": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "parts": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "height": { "type": "integer" }, "round": { "type": "integer" }, "signatures": { "items": { "additionalProperties": false, "properties": { "block_id_flag": { "type": "integer" }, "signature": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "timestamp": { "format": "date-time", "type": "string" }, "validator_address": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "dah": { "additionalProperties": false, "properties": { "column_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" }, "row_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" } }, "type": "object" }, "header": { "additionalProperties": false, "properties": { "app_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "chain_id": { "type": "string" }, "consensus_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "data_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "evidence_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "height": { "type": "integer" }, "last_block_id": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "parts": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "last_commit_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "last_results_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "next_validators_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "time": { "format": "date-time", "type": "string" }, "validators_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "version": { "additionalProperties": false, "properties": { "app": { "type": "integer" }, "block": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "validator_set": { "additionalProperties": false, "properties": { "proposer": { "additionalProperties": false, "properties": { "address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_priority": { "type": "integer" }, "pub_key": { "additionalProperties": true }, "voting_power": { "type": "integer" } }, "type": "object" }, "validators": { "items": { "additionalProperties": false, "properties": { "address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_priority": { "type": "integer" }, "pub_key": { "additionalProperties": true }, "voting_power": { "type": "integer" } }, "type": "object" }, "type": "array" } }, "type": "object" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/header/header.go#L91" } }, { "name": "header.GetRangeByHeight", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "GetRangeByHeight returns the given range (from:to) of ExtendedHeaders\nfrom the node's header store and verifies that the returned headers are\nadjacent to each other.\n", "paramStructure": "by-position", "params": [ { "name": "from", "description": "*header.ExtendedHeader", "summary": "", "schema": { "examples": [ { "header": { "version": { "block": "11" }, "chain_id": "mocha-5", "height": "67374", "time": "2023-02-25T12:10:28.067566292Z", "last_block_id": { "hash": "47A2C7758760988500B2F043D3903BBBF1C8B383CA33CF7056AA45E22055663E", "parts": { "total": 1, "hash": "33B012F244E27672169DD3D62CDBC92DA9486E410A5530F41FE6A890D8E2EE42" } }, "last_commit_hash": "888D47F5E9473501C99F2B6136B6B9FFBC9D1CD2F54002BCD5DF002FFEF0A83D", "data_hash": "257760461993F8F197B421EC7435F3C36C3734923E3DA9A42DC73B05F07B3D08", "validators_hash": "883A0C92B8D976312B249C1397E73CF2981A9EB715717CBEE3800B8380C22C1D", "next_validators_hash": "883A0C92B8D976312B249C1397E73CF2981A9EB715717CBEE3800B8380C22C1D", "consensus_hash": "048091BC7DDC283F77BFBF91D73C44DA58C3DF8A9CBC867405D8B7F3DAADA22F", "app_hash": "1FC70854A185737C7FD720FCCE9167876EE4B9ABE23DB1EBB8C552D3E3978435", "last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855", "evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855", "proposer_address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA" }, "commit": { "height": "67374", "round": 0, "block_id": { "hash": "A7F6B1CF33313121539206754A73FDC22ADA48C4AA8C4BB4F707ED2E089E59D3", "parts": { "total": 1, "hash": "6634FE1E1DDDCB9914ACE81F146013986F5FDA03A8F1C16DC5ECA0D9B0E08FBC" } }, "signatures": [ { "block_id_flag": 2, "validator_address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "timestamp": "2023-02-25T12:10:38.130121476Z", "signature": "HyR/uRIUNc5GNqQteZyrVjJM47SI9sRAgrLsNqJDls3AzbvHUfN4zzWyw0afyEvNm98Bm2GIoJoZC5D8oQvdBA==" } ] }, "validator_set": { "validators": [ { "address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "aoB4xU9//HAqOP9ciyp0+PTdZxt/UGKgZOabU6JxW8o=" }, "voting_power": "5000000000", "proposer_priority": "0" } ], "proposer": { "address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "aoB4xU9//HAqOP9ciyp0+PTdZxt/UGKgZOabU6JxW8o=" }, "voting_power": "5000000000", "proposer_priority": "0" } }, "dah": { "row_roots": [ "//////////7//////////ql+/VFmJ8PWE9BcjrTDLrY/hzVeGdzFCpfEhiXDXZmt", "/////////////////////zHeGnUtPJn8QyPpePSYl4qRVrcUvG2fwptyoA85Myik" ], "column_roots": [ "//////////7//////////ql+/VFmJ8PWE9BcjrTDLrY/hzVeGdzFCpfEhiXDXZmt", "/////////////////////zHeGnUtPJn8QyPpePSYl4qRVrcUvG2fwptyoA85Myik" ] } } ], "additionalProperties": false, "properties": { "commit": { "additionalProperties": false, "properties": { "block_id": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "parts": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "height": { "type": "integer" }, "round": { "type": "integer" }, "signatures": { "items": { "additionalProperties": false, "properties": { "block_id_flag": { "type": "integer" }, "signature": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "timestamp": { "format": "date-time", "type": "string" }, "validator_address": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "dah": { "additionalProperties": false, "properties": { "column_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" }, "row_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" } }, "type": "object" }, "header": { "additionalProperties": false, "properties": { "app_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "chain_id": { "type": "string" }, "consensus_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "data_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "evidence_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "height": { "type": "integer" }, "last_block_id": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "parts": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "last_commit_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "last_results_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "next_validators_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "time": { "format": "date-time", "type": "string" }, "validators_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "version": { "additionalProperties": false, "properties": { "app": { "type": "integer" }, "block": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "validator_set": { "additionalProperties": false, "properties": { "proposer": { "additionalProperties": false, "properties": { "address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_priority": { "type": "integer" }, "pub_key": { "additionalProperties": true }, "voting_power": { "type": "integer" } }, "type": "object" }, "validators": { "items": { "additionalProperties": false, "properties": { "address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_priority": { "type": "integer" }, "pub_key": { "additionalProperties": true }, "voting_power": { "type": "integer" } }, "type": "object" }, "type": "array" } }, "type": "object" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "to", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false } ], "result": { "name": "[]*header.ExtendedHeader", "description": "[]*header.ExtendedHeader", "summary": "", "schema": { "examples": [ [ { "header": { "version": { "block": "11" }, "chain_id": "mocha-5", "height": "67374", "time": "2023-02-25T12:10:28.067566292Z", "last_block_id": { "hash": "47A2C7758760988500B2F043D3903BBBF1C8B383CA33CF7056AA45E22055663E", "parts": { "total": 1, "hash": "33B012F244E27672169DD3D62CDBC92DA9486E410A5530F41FE6A890D8E2EE42" } }, "last_commit_hash": "888D47F5E9473501C99F2B6136B6B9FFBC9D1CD2F54002BCD5DF002FFEF0A83D", "data_hash": "257760461993F8F197B421EC7435F3C36C3734923E3DA9A42DC73B05F07B3D08", "validators_hash": "883A0C92B8D976312B249C1397E73CF2981A9EB715717CBEE3800B8380C22C1D", "next_validators_hash": "883A0C92B8D976312B249C1397E73CF2981A9EB715717CBEE3800B8380C22C1D", "consensus_hash": "048091BC7DDC283F77BFBF91D73C44DA58C3DF8A9CBC867405D8B7F3DAADA22F", "app_hash": "1FC70854A185737C7FD720FCCE9167876EE4B9ABE23DB1EBB8C552D3E3978435", "last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855", "evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855", "proposer_address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA" }, "commit": { "height": "67374", "round": 0, "block_id": { "hash": "A7F6B1CF33313121539206754A73FDC22ADA48C4AA8C4BB4F707ED2E089E59D3", "parts": { "total": 1, "hash": "6634FE1E1DDDCB9914ACE81F146013986F5FDA03A8F1C16DC5ECA0D9B0E08FBC" } }, "signatures": [ { "block_id_flag": 2, "validator_address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "timestamp": "2023-02-25T12:10:38.130121476Z", "signature": "HyR/uRIUNc5GNqQteZyrVjJM47SI9sRAgrLsNqJDls3AzbvHUfN4zzWyw0afyEvNm98Bm2GIoJoZC5D8oQvdBA==" } ] }, "validator_set": { "validators": [ { "address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "aoB4xU9//HAqOP9ciyp0+PTdZxt/UGKgZOabU6JxW8o=" }, "voting_power": "5000000000", "proposer_priority": "0" } ], "proposer": { "address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "aoB4xU9//HAqOP9ciyp0+PTdZxt/UGKgZOabU6JxW8o=" }, "voting_power": "5000000000", "proposer_priority": "0" } }, "dah": { "row_roots": [ "//////////7//////////ql+/VFmJ8PWE9BcjrTDLrY/hzVeGdzFCpfEhiXDXZmt", "/////////////////////zHeGnUtPJn8QyPpePSYl4qRVrcUvG2fwptyoA85Myik" ], "column_roots": [ "//////////7//////////ql+/VFmJ8PWE9BcjrTDLrY/hzVeGdzFCpfEhiXDXZmt", "/////////////////////zHeGnUtPJn8QyPpePSYl4qRVrcUvG2fwptyoA85Myik" ] } } ] ], "items": [ { "additionalProperties": false, "properties": { "commit": { "additionalProperties": false, "properties": { "block_id": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "parts": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "height": { "type": "integer" }, "round": { "type": "integer" }, "signatures": { "items": { "additionalProperties": false, "properties": { "block_id_flag": { "type": "integer" }, "signature": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "timestamp": { "format": "date-time", "type": "string" }, "validator_address": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "dah": { "additionalProperties": false, "properties": { "column_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" }, "row_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" } }, "type": "object" }, "header": { "additionalProperties": false, "properties": { "app_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "chain_id": { "type": "string" }, "consensus_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "data_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "evidence_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "height": { "type": "integer" }, "last_block_id": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "parts": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "last_commit_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "last_results_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "next_validators_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "time": { "format": "date-time", "type": "string" }, "validators_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "version": { "additionalProperties": false, "properties": { "app": { "type": "integer" }, "block": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "validator_set": { "additionalProperties": false, "properties": { "proposer": { "additionalProperties": false, "properties": { "address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_priority": { "type": "integer" }, "pub_key": { "additionalProperties": true }, "voting_power": { "type": "integer" } }, "type": "object" }, "validators": { "items": { "additionalProperties": false, "properties": { "address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_priority": { "type": "integer" }, "pub_key": { "additionalProperties": true }, "voting_power": { "type": "integer" } }, "type": "object" }, "type": "array" } }, "type": "object" } }, "type": [ "object" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/header/header.go#L83" } }, { "name": "header.LocalHead", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "LocalHead returns the ExtendedHeader of the chain head.\n", "paramStructure": "by-position", "params": [], "result": { "name": "*header.ExtendedHeader", "description": "*header.ExtendedHeader", "summary": "", "schema": { "examples": [ { "header": { "version": { "block": "11" }, "chain_id": "mocha-5", "height": "67374", "time": "2023-02-25T12:10:28.067566292Z", "last_block_id": { "hash": "47A2C7758760988500B2F043D3903BBBF1C8B383CA33CF7056AA45E22055663E", "parts": { "total": 1, "hash": "33B012F244E27672169DD3D62CDBC92DA9486E410A5530F41FE6A890D8E2EE42" } }, "last_commit_hash": "888D47F5E9473501C99F2B6136B6B9FFBC9D1CD2F54002BCD5DF002FFEF0A83D", "data_hash": "257760461993F8F197B421EC7435F3C36C3734923E3DA9A42DC73B05F07B3D08", "validators_hash": "883A0C92B8D976312B249C1397E73CF2981A9EB715717CBEE3800B8380C22C1D", "next_validators_hash": "883A0C92B8D976312B249C1397E73CF2981A9EB715717CBEE3800B8380C22C1D", "consensus_hash": "048091BC7DDC283F77BFBF91D73C44DA58C3DF8A9CBC867405D8B7F3DAADA22F", "app_hash": "1FC70854A185737C7FD720FCCE9167876EE4B9ABE23DB1EBB8C552D3E3978435", "last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855", "evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855", "proposer_address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA" }, "commit": { "height": "67374", "round": 0, "block_id": { "hash": "A7F6B1CF33313121539206754A73FDC22ADA48C4AA8C4BB4F707ED2E089E59D3", "parts": { "total": 1, "hash": "6634FE1E1DDDCB9914ACE81F146013986F5FDA03A8F1C16DC5ECA0D9B0E08FBC" } }, "signatures": [ { "block_id_flag": 2, "validator_address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "timestamp": "2023-02-25T12:10:38.130121476Z", "signature": "HyR/uRIUNc5GNqQteZyrVjJM47SI9sRAgrLsNqJDls3AzbvHUfN4zzWyw0afyEvNm98Bm2GIoJoZC5D8oQvdBA==" } ] }, "validator_set": { "validators": [ { "address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "aoB4xU9//HAqOP9ciyp0+PTdZxt/UGKgZOabU6JxW8o=" }, "voting_power": "5000000000", "proposer_priority": "0" } ], "proposer": { "address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "aoB4xU9//HAqOP9ciyp0+PTdZxt/UGKgZOabU6JxW8o=" }, "voting_power": "5000000000", "proposer_priority": "0" } }, "dah": { "row_roots": [ "//////////7//////////ql+/VFmJ8PWE9BcjrTDLrY/hzVeGdzFCpfEhiXDXZmt", "/////////////////////zHeGnUtPJn8QyPpePSYl4qRVrcUvG2fwptyoA85Myik" ], "column_roots": [ "//////////7//////////ql+/VFmJ8PWE9BcjrTDLrY/hzVeGdzFCpfEhiXDXZmt", "/////////////////////zHeGnUtPJn8QyPpePSYl4qRVrcUvG2fwptyoA85Myik" ] } } ], "additionalProperties": false, "properties": { "commit": { "additionalProperties": false, "properties": { "block_id": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "parts": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "height": { "type": "integer" }, "round": { "type": "integer" }, "signatures": { "items": { "additionalProperties": false, "properties": { "block_id_flag": { "type": "integer" }, "signature": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "timestamp": { "format": "date-time", "type": "string" }, "validator_address": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "dah": { "additionalProperties": false, "properties": { "column_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" }, "row_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" } }, "type": "object" }, "header": { "additionalProperties": false, "properties": { "app_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "chain_id": { "type": "string" }, "consensus_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "data_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "evidence_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "height": { "type": "integer" }, "last_block_id": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "parts": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "last_commit_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "last_results_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "next_validators_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "time": { "format": "date-time", "type": "string" }, "validators_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "version": { "additionalProperties": false, "properties": { "app": { "type": "integer" }, "block": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "validator_set": { "additionalProperties": false, "properties": { "proposer": { "additionalProperties": false, "properties": { "address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_priority": { "type": "integer" }, "pub_key": { "additionalProperties": true }, "voting_power": { "type": "integer" } }, "type": "object" }, "validators": { "items": { "additionalProperties": false, "properties": { "address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_priority": { "type": "integer" }, "pub_key": { "additionalProperties": true }, "voting_power": { "type": "integer" } }, "type": "object" }, "type": "array" } }, "type": "object" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/header/header.go#L99" } }, { "name": "header.NetworkHead", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "NetworkHead provides the Syncer's view of the current network head.\n", "paramStructure": "by-position", "params": [], "result": { "name": "*header.ExtendedHeader", "description": "*header.ExtendedHeader", "summary": "", "schema": { "examples": [ { "header": { "version": { "block": "11" }, "chain_id": "mocha-5", "height": "67374", "time": "2023-02-25T12:10:28.067566292Z", "last_block_id": { "hash": "47A2C7758760988500B2F043D3903BBBF1C8B383CA33CF7056AA45E22055663E", "parts": { "total": 1, "hash": "33B012F244E27672169DD3D62CDBC92DA9486E410A5530F41FE6A890D8E2EE42" } }, "last_commit_hash": "888D47F5E9473501C99F2B6136B6B9FFBC9D1CD2F54002BCD5DF002FFEF0A83D", "data_hash": "257760461993F8F197B421EC7435F3C36C3734923E3DA9A42DC73B05F07B3D08", "validators_hash": "883A0C92B8D976312B249C1397E73CF2981A9EB715717CBEE3800B8380C22C1D", "next_validators_hash": "883A0C92B8D976312B249C1397E73CF2981A9EB715717CBEE3800B8380C22C1D", "consensus_hash": "048091BC7DDC283F77BFBF91D73C44DA58C3DF8A9CBC867405D8B7F3DAADA22F", "app_hash": "1FC70854A185737C7FD720FCCE9167876EE4B9ABE23DB1EBB8C552D3E3978435", "last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855", "evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855", "proposer_address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA" }, "commit": { "height": "67374", "round": 0, "block_id": { "hash": "A7F6B1CF33313121539206754A73FDC22ADA48C4AA8C4BB4F707ED2E089E59D3", "parts": { "total": 1, "hash": "6634FE1E1DDDCB9914ACE81F146013986F5FDA03A8F1C16DC5ECA0D9B0E08FBC" } }, "signatures": [ { "block_id_flag": 2, "validator_address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "timestamp": "2023-02-25T12:10:38.130121476Z", "signature": "HyR/uRIUNc5GNqQteZyrVjJM47SI9sRAgrLsNqJDls3AzbvHUfN4zzWyw0afyEvNm98Bm2GIoJoZC5D8oQvdBA==" } ] }, "validator_set": { "validators": [ { "address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "aoB4xU9//HAqOP9ciyp0+PTdZxt/UGKgZOabU6JxW8o=" }, "voting_power": "5000000000", "proposer_priority": "0" } ], "proposer": { "address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "aoB4xU9//HAqOP9ciyp0+PTdZxt/UGKgZOabU6JxW8o=" }, "voting_power": "5000000000", "proposer_priority": "0" } }, "dah": { "row_roots": [ "//////////7//////////ql+/VFmJ8PWE9BcjrTDLrY/hzVeGdzFCpfEhiXDXZmt", "/////////////////////zHeGnUtPJn8QyPpePSYl4qRVrcUvG2fwptyoA85Myik" ], "column_roots": [ "//////////7//////////ql+/VFmJ8PWE9BcjrTDLrY/hzVeGdzFCpfEhiXDXZmt", "/////////////////////zHeGnUtPJn8QyPpePSYl4qRVrcUvG2fwptyoA85Myik" ] } } ], "additionalProperties": false, "properties": { "commit": { "additionalProperties": false, "properties": { "block_id": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "parts": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "height": { "type": "integer" }, "round": { "type": "integer" }, "signatures": { "items": { "additionalProperties": false, "properties": { "block_id_flag": { "type": "integer" }, "signature": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "timestamp": { "format": "date-time", "type": "string" }, "validator_address": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "dah": { "additionalProperties": false, "properties": { "column_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" }, "row_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" } }, "type": "object" }, "header": { "additionalProperties": false, "properties": { "app_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "chain_id": { "type": "string" }, "consensus_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "data_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "evidence_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "height": { "type": "integer" }, "last_block_id": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "parts": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "last_commit_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "last_results_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "next_validators_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "time": { "format": "date-time", "type": "string" }, "validators_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "version": { "additionalProperties": false, "properties": { "app": { "type": "integer" }, "block": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "validator_set": { "additionalProperties": false, "properties": { "proposer": { "additionalProperties": false, "properties": { "address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_priority": { "type": "integer" }, "pub_key": { "additionalProperties": true }, "voting_power": { "type": "integer" } }, "type": "object" }, "validators": { "items": { "additionalProperties": false, "properties": { "address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_priority": { "type": "integer" }, "pub_key": { "additionalProperties": true }, "voting_power": { "type": "integer" } }, "type": "object" }, "type": "array" } }, "type": "object" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/header/header.go#L111" } }, { "name": "header.Subscribe", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Subscribe to recent ExtendedHeaders from the network.\n", "paramStructure": "by-position", "params": [], "result": { "name": "\u003c-chan *header.ExtendedHeader", "description": "\u003c-chan *header.ExtendedHeader", "summary": "", "schema": { "title": "typeUnsupportedByJSONSchema", "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/header/header.go#L119" } }, { "name": "header.SyncState", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "SyncState returns the current state of the header Syncer.\n", "paramStructure": "by-position", "params": [], "result": { "name": "sync.State", "description": "sync.State", "summary": "", "schema": { "examples": [ { "id": 42, "height": 42, "from_height": 42, "to_height": 42, "from_hash": "453D0BC3CB88A2ED6F2E06021383B22C72D25D7741AE51B4CAE1AD34D72A3F07", "to_hash": "453D0BC3CB88A2ED6F2E06021383B22C72D25D7741AE51B4CAE1AD34D72A3F07", "start": "0001-01-01T00:00:00Z", "end": "0001-01-01T00:00:00Z", "error": "string value" } ], "additionalProperties": false, "properties": { "end": { "format": "date-time", "type": "string" }, "error": { "type": "string" }, "from_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "from_height": { "type": "integer" }, "height": { "type": "integer" }, "id": { "type": "integer" }, "start": { "format": "date-time", "type": "string" }, "to_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "to_height": { "type": "integer" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/header/header.go#L103" } }, { "name": "header.SyncWait", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "SyncWait blocks until the header Syncer is synced to network head.\n", "paramStructure": "by-position", "params": [], "result": { "name": "Null", "description": "Null", "schema": { "type": [ "null" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/header/header.go#L107" } }, { "name": "header.Tail", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Tail reports current tail header of the node.\n\nTail header is the lowest height header known by the running node.\nHeaders with height below Tail are not available to be requested.\nSubsequently, Shwap data requests for this height are not available as well.\n\nNOTE: In future, requests for headers below Tail will be supported by lazily fetching them\nfrom the network.\n", "paramStructure": "by-position", "params": [], "result": { "name": "*header.ExtendedHeader", "description": "*header.ExtendedHeader", "summary": "", "schema": { "examples": [ { "header": { "version": { "block": "11" }, "chain_id": "mocha-5", "height": "67374", "time": "2023-02-25T12:10:28.067566292Z", "last_block_id": { "hash": "47A2C7758760988500B2F043D3903BBBF1C8B383CA33CF7056AA45E22055663E", "parts": { "total": 1, "hash": "33B012F244E27672169DD3D62CDBC92DA9486E410A5530F41FE6A890D8E2EE42" } }, "last_commit_hash": "888D47F5E9473501C99F2B6136B6B9FFBC9D1CD2F54002BCD5DF002FFEF0A83D", "data_hash": "257760461993F8F197B421EC7435F3C36C3734923E3DA9A42DC73B05F07B3D08", "validators_hash": "883A0C92B8D976312B249C1397E73CF2981A9EB715717CBEE3800B8380C22C1D", "next_validators_hash": "883A0C92B8D976312B249C1397E73CF2981A9EB715717CBEE3800B8380C22C1D", "consensus_hash": "048091BC7DDC283F77BFBF91D73C44DA58C3DF8A9CBC867405D8B7F3DAADA22F", "app_hash": "1FC70854A185737C7FD720FCCE9167876EE4B9ABE23DB1EBB8C552D3E3978435", "last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855", "evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855", "proposer_address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA" }, "commit": { "height": "67374", "round": 0, "block_id": { "hash": "A7F6B1CF33313121539206754A73FDC22ADA48C4AA8C4BB4F707ED2E089E59D3", "parts": { "total": 1, "hash": "6634FE1E1DDDCB9914ACE81F146013986F5FDA03A8F1C16DC5ECA0D9B0E08FBC" } }, "signatures": [ { "block_id_flag": 2, "validator_address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "timestamp": "2023-02-25T12:10:38.130121476Z", "signature": "HyR/uRIUNc5GNqQteZyrVjJM47SI9sRAgrLsNqJDls3AzbvHUfN4zzWyw0afyEvNm98Bm2GIoJoZC5D8oQvdBA==" } ] }, "validator_set": { "validators": [ { "address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "aoB4xU9//HAqOP9ciyp0+PTdZxt/UGKgZOabU6JxW8o=" }, "voting_power": "5000000000", "proposer_priority": "0" } ], "proposer": { "address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "aoB4xU9//HAqOP9ciyp0+PTdZxt/UGKgZOabU6JxW8o=" }, "voting_power": "5000000000", "proposer_priority": "0" } }, "dah": { "row_roots": [ "//////////7//////////ql+/VFmJ8PWE9BcjrTDLrY/hzVeGdzFCpfEhiXDXZmt", "/////////////////////zHeGnUtPJn8QyPpePSYl4qRVrcUvG2fwptyoA85Myik" ], "column_roots": [ "//////////7//////////ql+/VFmJ8PWE9BcjrTDLrY/hzVeGdzFCpfEhiXDXZmt", "/////////////////////zHeGnUtPJn8QyPpePSYl4qRVrcUvG2fwptyoA85Myik" ] } } ], "additionalProperties": false, "properties": { "commit": { "additionalProperties": false, "properties": { "block_id": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "parts": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "height": { "type": "integer" }, "round": { "type": "integer" }, "signatures": { "items": { "additionalProperties": false, "properties": { "block_id_flag": { "type": "integer" }, "signature": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "timestamp": { "format": "date-time", "type": "string" }, "validator_address": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "dah": { "additionalProperties": false, "properties": { "column_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" }, "row_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" } }, "type": "object" }, "header": { "additionalProperties": false, "properties": { "app_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "chain_id": { "type": "string" }, "consensus_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "data_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "evidence_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "height": { "type": "integer" }, "last_block_id": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "parts": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "last_commit_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "last_results_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "next_validators_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "time": { "format": "date-time", "type": "string" }, "validators_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "version": { "additionalProperties": false, "properties": { "app": { "type": "integer" }, "block": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "validator_set": { "additionalProperties": false, "properties": { "proposer": { "additionalProperties": false, "properties": { "address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_priority": { "type": "integer" }, "pub_key": { "additionalProperties": true }, "voting_power": { "type": "integer" } }, "type": "object" }, "validators": { "items": { "additionalProperties": false, "properties": { "address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_priority": { "type": "integer" }, "pub_key": { "additionalProperties": true }, "voting_power": { "type": "integer" } }, "type": "object" }, "type": "array" } }, "type": "object" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/header/header.go#L115" } }, { "name": "header.WaitForHeight", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "WaitForHeight blocks until the header at the given height has been processed\nby the store or context deadline is exceeded.\n", "paramStructure": "by-position", "params": [ { "name": "u", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false } ], "result": { "name": "*header.ExtendedHeader", "description": "*header.ExtendedHeader", "summary": "", "schema": { "examples": [ { "header": { "version": { "block": "11" }, "chain_id": "mocha-5", "height": "67374", "time": "2023-02-25T12:10:28.067566292Z", "last_block_id": { "hash": "47A2C7758760988500B2F043D3903BBBF1C8B383CA33CF7056AA45E22055663E", "parts": { "total": 1, "hash": "33B012F244E27672169DD3D62CDBC92DA9486E410A5530F41FE6A890D8E2EE42" } }, "last_commit_hash": "888D47F5E9473501C99F2B6136B6B9FFBC9D1CD2F54002BCD5DF002FFEF0A83D", "data_hash": "257760461993F8F197B421EC7435F3C36C3734923E3DA9A42DC73B05F07B3D08", "validators_hash": "883A0C92B8D976312B249C1397E73CF2981A9EB715717CBEE3800B8380C22C1D", "next_validators_hash": "883A0C92B8D976312B249C1397E73CF2981A9EB715717CBEE3800B8380C22C1D", "consensus_hash": "048091BC7DDC283F77BFBF91D73C44DA58C3DF8A9CBC867405D8B7F3DAADA22F", "app_hash": "1FC70854A185737C7FD720FCCE9167876EE4B9ABE23DB1EBB8C552D3E3978435", "last_results_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855", "evidence_hash": "E3B0C44298FC1C149AFBF4C8996FB92427AE41E4649B934CA495991B7852B855", "proposer_address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA" }, "commit": { "height": "67374", "round": 0, "block_id": { "hash": "A7F6B1CF33313121539206754A73FDC22ADA48C4AA8C4BB4F707ED2E089E59D3", "parts": { "total": 1, "hash": "6634FE1E1DDDCB9914ACE81F146013986F5FDA03A8F1C16DC5ECA0D9B0E08FBC" } }, "signatures": [ { "block_id_flag": 2, "validator_address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "timestamp": "2023-02-25T12:10:38.130121476Z", "signature": "HyR/uRIUNc5GNqQteZyrVjJM47SI9sRAgrLsNqJDls3AzbvHUfN4zzWyw0afyEvNm98Bm2GIoJoZC5D8oQvdBA==" } ] }, "validator_set": { "validators": [ { "address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "aoB4xU9//HAqOP9ciyp0+PTdZxt/UGKgZOabU6JxW8o=" }, "voting_power": "5000000000", "proposer_priority": "0" } ], "proposer": { "address": "57DC09D28388DBF977CFC30EF50BE8B644CCC1FA", "pub_key": { "type": "tendermint/PubKeyEd25519", "value": "aoB4xU9//HAqOP9ciyp0+PTdZxt/UGKgZOabU6JxW8o=" }, "voting_power": "5000000000", "proposer_priority": "0" } }, "dah": { "row_roots": [ "//////////7//////////ql+/VFmJ8PWE9BcjrTDLrY/hzVeGdzFCpfEhiXDXZmt", "/////////////////////zHeGnUtPJn8QyPpePSYl4qRVrcUvG2fwptyoA85Myik" ], "column_roots": [ "//////////7//////////ql+/VFmJ8PWE9BcjrTDLrY/hzVeGdzFCpfEhiXDXZmt", "/////////////////////zHeGnUtPJn8QyPpePSYl4qRVrcUvG2fwptyoA85Myik" ] } } ], "additionalProperties": false, "properties": { "commit": { "additionalProperties": false, "properties": { "block_id": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "parts": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "height": { "type": "integer" }, "round": { "type": "integer" }, "signatures": { "items": { "additionalProperties": false, "properties": { "block_id_flag": { "type": "integer" }, "signature": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "timestamp": { "format": "date-time", "type": "string" }, "validator_address": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "dah": { "additionalProperties": false, "properties": { "column_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" }, "row_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" } }, "type": "object" }, "header": { "additionalProperties": false, "properties": { "app_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "chain_id": { "type": "string" }, "consensus_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "data_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "evidence_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "height": { "type": "integer" }, "last_block_id": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "parts": { "additionalProperties": false, "properties": { "hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "last_commit_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "last_results_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "next_validators_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "time": { "format": "date-time", "type": "string" }, "validators_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "version": { "additionalProperties": false, "properties": { "app": { "type": "integer" }, "block": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "validator_set": { "additionalProperties": false, "properties": { "proposer": { "additionalProperties": false, "properties": { "address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_priority": { "type": "integer" }, "pub_key": { "additionalProperties": true }, "voting_power": { "type": "integer" } }, "type": "object" }, "validators": { "items": { "additionalProperties": false, "properties": { "address": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "proposer_priority": { "type": "integer" }, "pub_key": { "additionalProperties": true }, "voting_power": { "type": "integer" } }, "type": "object" }, "type": "array" } }, "type": "object" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/header/header.go#L95" } }, { "name": "node.AuthNew", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "AuthNew signs and returns a new token with the given permissions.\n", "paramStructure": "by-position", "params": [ { "name": "perms", "description": "[]auth.Permission", "summary": "", "schema": { "examples": [ [ "admin" ] ], "items": [ { "type": [ "string" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false } ], "result": { "name": "string", "description": "string", "summary": "", "schema": { "examples": [ "string value" ], "type": [ "string" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/node/node.go#L61" } }, { "name": "node.AuthNewWithExpiry", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "AuthNewWithExpiry signs and returns a new token with the given permissions and TTL.\n", "paramStructure": "by-position", "params": [ { "name": "perms", "description": "[]auth.Permission", "summary": "", "schema": { "examples": [ [ "admin" ] ], "items": [ { "type": [ "string" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false }, { "name": "ttl", "description": "time.Duration", "summary": "", "schema": { "examples": [ 1000000000 ], "type": [ "integer" ] }, "required": true, "deprecated": false } ], "result": { "name": "string", "description": "string", "summary": "", "schema": { "examples": [ "string value" ], "type": [ "string" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/node/node.go#L65" } }, { "name": "node.AuthVerify", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "AuthVerify returns the permissions assigned to the given token.\n", "paramStructure": "by-position", "params": [ { "name": "token", "description": "string", "summary": "", "schema": { "examples": [ "string value" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "[]auth.Permission", "description": "[]auth.Permission", "summary": "", "schema": { "examples": [ [ "admin" ] ], "items": [ { "type": [ "string" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/node/node.go#L57" } }, { "name": "node.Info", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Info returns administrative information about the node.\n", "paramStructure": "by-position", "params": [], "result": { "name": "Info", "description": "Info", "summary": "", "schema": { "examples": [ { "type": "Bridge", "api_version": "string value" } ], "additionalProperties": false, "properties": { "api_version": { "type": "string" }, "type": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/node/node.go#L45" } }, { "name": "node.LogLevelSet", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "LogLevelSet sets the given component log level to the given level.\n", "paramStructure": "by-position", "params": [ { "name": "name", "description": "string", "summary": "", "schema": { "examples": [ "string value" ], "type": [ "string" ] }, "required": true, "deprecated": false }, { "name": "level", "description": "string", "summary": "", "schema": { "examples": [ "string value" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "Null", "description": "Null", "schema": { "type": [ "null" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/node/node.go#L53" } }, { "name": "node.Ready", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Ready returns true once the node's RPC is ready to accept requests.\n", "paramStructure": "by-position", "params": [], "result": { "name": "bool", "description": "bool", "summary": "", "schema": { "examples": [ true ], "type": [ "boolean" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/node/node.go#L49" } }, { "name": "p2p.BandwidthForPeer", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "BandwidthForPeer returns a Stats struct with bandwidth metrics associated with the given peer.ID.\nThe metrics returned include all traffic sent / received for the peer, regardless of protocol.\n", "paramStructure": "by-position", "params": [ { "name": "id", "description": "peer.ID", "summary": "", "schema": { "examples": [ "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "metrics.Stats", "description": "metrics.Stats", "summary": "", "schema": { "examples": [ { "TotalIn": 42, "TotalOut": 42, "RateIn": 42, "RateOut": 42 } ], "additionalProperties": false, "properties": { "RateIn": { "type": "number" }, "RateOut": { "type": "number" }, "TotalIn": { "type": "integer" }, "TotalOut": { "type": "integer" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L353" } }, { "name": "p2p.BandwidthForProtocol", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "BandwidthForProtocol returns a Stats struct with bandwidth metrics associated with the given\nprotocol.ID.\n", "paramStructure": "by-position", "params": [ { "name": "proto", "description": "protocol.ID", "summary": "", "schema": { "examples": [ "/celestia/mocha-5/ipfs/bitswap" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "metrics.Stats", "description": "metrics.Stats", "summary": "", "schema": { "examples": [ { "TotalIn": 42, "TotalOut": 42, "RateIn": 42, "RateOut": 42 } ], "additionalProperties": false, "properties": { "RateIn": { "type": "number" }, "RateOut": { "type": "number" }, "TotalIn": { "type": "integer" }, "TotalOut": { "type": "integer" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L357" } }, { "name": "p2p.BandwidthStats", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "BandwidthStats returns a Stats struct with bandwidth metrics for all\ndata sent/received by the local peer, regardless of protocol or remote\npeer IDs.\n", "paramStructure": "by-position", "params": [], "result": { "name": "metrics.Stats", "description": "metrics.Stats", "summary": "", "schema": { "examples": [ { "TotalIn": 42, "TotalOut": 42, "RateIn": 42, "RateOut": 42 } ], "additionalProperties": false, "properties": { "RateIn": { "type": "number" }, "RateOut": { "type": "number" }, "TotalIn": { "type": "integer" }, "TotalOut": { "type": "integer" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L349" } }, { "name": "p2p.BlockPeer", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "BlockPeer adds a peer to the set of blocked peers and\ncloses any existing connection to that peer.\n", "paramStructure": "by-position", "params": [ { "name": "p", "description": "peer.ID", "summary": "", "schema": { "examples": [ "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "Null", "description": "Null", "schema": { "type": [ "null" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L325" } }, { "name": "p2p.ClosePeer", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "ClosePeer closes the connection to a given peer.\n", "paramStructure": "by-position", "params": [ { "name": "id", "description": "peer.ID", "summary": "", "schema": { "examples": [ "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "Null", "description": "Null", "schema": { "type": [ "null" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L313" } }, { "name": "p2p.Connect", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Connect ensures there is a connection between this host and the peer with\ngiven peer.\n", "paramStructure": "by-position", "params": [ { "name": "pi", "description": "peer.AddrInfo", "summary": "", "schema": { "examples": [ { "ID": "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo", "Addrs": [ "/ip6/::1/udp/2121/quic-v1" ] } ], "additionalProperties": false, "properties": { "Addrs": { "items": { "items": { "additionalProperties": false, "type": "object" }, "type": "array" }, "type": "array" }, "ID": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "Null", "description": "Null", "schema": { "type": [ "null" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L309" } }, { "name": "p2p.Connectedness", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Connectedness returns a state signaling connection capabilities.\n", "paramStructure": "by-position", "params": [ { "name": "id", "description": "peer.ID", "summary": "", "schema": { "examples": [ "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "network.Connectedness", "description": "network.Connectedness", "summary": "", "schema": { "examples": [ 1 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L317" } }, { "name": "p2p.ConnectionState", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "ConnectionState returns information about each *active* connection to the peer.\nNOTE: At most cases there should be only a single connection.\n", "paramStructure": "by-position", "params": [ { "name": "peer", "description": "peer.ID", "summary": "", "schema": { "examples": [ "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "[]ConnectionState", "description": "[]ConnectionState", "summary": "", "schema": { "examples": [ [ { "Info": { "StreamMultiplexer": "/celestia/mocha-5/ipfs/bitswap", "Security": "/celestia/mocha-5/ipfs/bitswap", "Transport": "string value", "UsedEarlyMuxerNegotiation": true }, "NumStreams": 42, "Direction": 0, "Opened": "0001-01-01T00:00:00Z", "Limited": true } ] ], "items": [ { "additionalProperties": false, "properties": { "Direction": { "type": "integer" }, "Info": {}, "Limited": { "type": "boolean" }, "NumStreams": { "type": "integer" }, "Opened": { "format": "date-time", "type": "string" } }, "type": [ "object" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L377" } }, { "name": "p2p.Info", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Info returns address information about the host.\n", "paramStructure": "by-position", "params": [], "result": { "name": "peer.AddrInfo", "description": "peer.AddrInfo", "summary": "", "schema": { "examples": [ { "ID": "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo", "Addrs": [ "/ip6/::1/udp/2121/quic-v1" ] } ], "additionalProperties": false, "properties": { "Addrs": { "items": { "items": { "additionalProperties": false, "type": "object" }, "type": "array" }, "type": "array" }, "ID": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L293" } }, { "name": "p2p.IsProtected", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "IsProtected returns whether the given peer is protected.\n", "paramStructure": "by-position", "params": [ { "name": "id", "description": "peer.ID", "summary": "", "schema": { "examples": [ "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo" ], "type": [ "string" ] }, "required": true, "deprecated": false }, { "name": "tag", "description": "string", "summary": "", "schema": { "examples": [ "string value" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "bool", "description": "bool", "summary": "", "schema": { "examples": [ true ], "type": [ "boolean" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L345" } }, { "name": "p2p.ListBlockedPeers", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "ListBlockedPeers returns a list of blocked peers.\n", "paramStructure": "by-position", "params": [], "result": { "name": "[]peer.ID", "description": "[]peer.ID", "summary": "", "schema": { "examples": [ [ "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo" ] ], "items": [ { "type": [ "string" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L333" } }, { "name": "p2p.NATStatus", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "NATStatus returns the current NAT status.\n", "paramStructure": "by-position", "params": [], "result": { "name": "network.Reachability", "description": "network.Reachability", "summary": "", "schema": { "examples": [ 2 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L321" } }, { "name": "p2p.Network", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Network returns the host's network/chain ID.\n", "paramStructure": "by-position", "params": [], "result": { "name": "Network", "description": "Network", "summary": "", "schema": { "examples": [ "celestia" ], "type": [ "string" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L297" } }, { "name": "p2p.PeerInfo", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "PeerInfo returns a small slice of information Peerstore has on the\ngiven peer.\n", "paramStructure": "by-position", "params": [ { "name": "id", "description": "peer.ID", "summary": "", "schema": { "examples": [ "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "peer.AddrInfo", "description": "peer.AddrInfo", "summary": "", "schema": { "examples": [ { "ID": "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo", "Addrs": [ "/ip6/::1/udp/2121/quic-v1" ] } ], "additionalProperties": false, "properties": { "Addrs": { "items": { "items": { "additionalProperties": false, "type": "object" }, "type": "array" }, "type": "array" }, "ID": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L305" } }, { "name": "p2p.Peers", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Peers returns connected peers.\n", "paramStructure": "by-position", "params": [], "result": { "name": "[]peer.ID", "description": "[]peer.ID", "summary": "", "schema": { "examples": [ [ "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo" ] ], "items": [ { "type": [ "string" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L301" } }, { "name": "p2p.Ping", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Ping pings the selected peer and returns time it took or error.\n", "paramStructure": "by-position", "params": [ { "name": "peer", "description": "peer.ID", "summary": "", "schema": { "examples": [ "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "time.Duration", "description": "time.Duration", "summary": "", "schema": { "examples": [ 1000000000 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L373" } }, { "name": "p2p.Protect", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Protect adds a peer to the list of peers who have a bidirectional\npeering agreement that they are protected from being trimmed, dropped\nor negatively scored.\n", "paramStructure": "by-position", "params": [ { "name": "id", "description": "peer.ID", "summary": "", "schema": { "examples": [ "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo" ], "type": [ "string" ] }, "required": true, "deprecated": false }, { "name": "tag", "description": "string", "summary": "", "schema": { "examples": [ "string value" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "Null", "description": "Null", "schema": { "type": [ "null" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L337" } }, { "name": "p2p.PubSubPeers", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "PubSubPeers returns the peer IDs of the peers joined on\nthe given topic.\n", "paramStructure": "by-position", "params": [ { "name": "topic", "description": "string", "summary": "", "schema": { "examples": [ "string value" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "[]peer.ID", "description": "[]peer.ID", "summary": "", "schema": { "examples": [ [ "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo" ] ], "items": [ { "type": [ "string" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L365" } }, { "name": "p2p.PubSubTopics", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "PubSubTopics reports current PubSubTopics the node participates in.\n", "paramStructure": "by-position", "params": [], "result": { "name": "[]string", "description": "[]string", "summary": "", "schema": { "examples": [ [ "string value" ] ], "items": [ { "type": [ "string" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L369" } }, { "name": "p2p.ResourceState", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "ResourceState returns the state of the resource manager.\n", "paramStructure": "by-position", "params": [], "result": { "name": "rcmgr.ResourceManagerStat", "description": "rcmgr.ResourceManagerStat", "summary": "", "schema": { "examples": [ { "System": { "NumStreamsInbound": 4, "NumStreamsOutbound": 13, "NumConnsInbound": 0, "NumConnsOutbound": 13, "NumFD": 7, "Memory": 4456448 }, "Transient": { "NumStreamsInbound": 0, "NumStreamsOutbound": 0, "NumConnsInbound": 0, "NumConnsOutbound": 0, "NumFD": 0, "Memory": 0 }, "Services": { "libp2p.autonat": { "NumStreamsInbound": 0, "NumStreamsOutbound": 0, "NumConnsInbound": 0, "NumConnsOutbound": 0, "NumFD": 0, "Memory": 0 }, "libp2p.identify": { "NumStreamsInbound": 0, "NumStreamsOutbound": 0, "NumConnsInbound": 0, "NumConnsOutbound": 0, "NumFD": 0, "Memory": 0 } }, "Protocols": { "/celestia/mocha-5/ipfs/bitswap/1.2.0": { "NumStreamsInbound": 0, "NumStreamsOutbound": 4, "NumConnsInbound": 0, "NumConnsOutbound": 0, "NumFD": 0, "Memory": 0 }, "/celestia/mocha-5/kad/1.0.0": { "NumStreamsInbound": 0, "NumStreamsOutbound": 4, "NumConnsInbound": 0, "NumConnsOutbound": 0, "NumFD": 0, "Memory": 0 }, "/floodsub/1.0.0": { "NumStreamsInbound": 2, "NumStreamsOutbound": 0, "NumConnsInbound": 0, "NumConnsOutbound": 0, "NumFD": 0, "Memory": 0 }, "/ipfs/id/1.0.0": { "NumStreamsInbound": 0, "NumStreamsOutbound": 1, "NumConnsInbound": 0, "NumConnsOutbound": 0, "NumFD": 0, "Memory": 0 }, "/meshsub/1.1.0": { "NumStreamsInbound": 2, "NumStreamsOutbound": 4, "NumConnsInbound": 0, "NumConnsOutbound": 0, "NumFD": 0, "Memory": 0 } }, "Peers": { "\u0000$\b\u0001\u0012 \ufffd-\ufffd\ufffd\u0026\ufffd\ufffdY\ufffdk\ufffd\u000e\u0011\ufffdS\ufffdRM\u0013\ufffd\u0015\ufffd\ufffd$\ufffd\ufffd\ufffd\ufffd*\ufffd\u0002W": { "NumStreamsInbound": 1, "NumStreamsOutbound": 3, "NumConnsInbound": 0, "NumConnsOutbound": 3, "NumFD": 3, "Memory": 1048576 } } } ], "additionalProperties": false, "properties": { "Peers": { "patternProperties": { ".*": { "additionalProperties": false, "properties": { "Memory": { "type": "integer" }, "NumConnsInbound": { "type": "integer" }, "NumConnsOutbound": { "type": "integer" }, "NumFD": { "type": "integer" }, "NumStreamsInbound": { "type": "integer" }, "NumStreamsOutbound": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "Protocols": { "patternProperties": { ".*": { "additionalProperties": false, "properties": { "Memory": { "type": "integer" }, "NumConnsInbound": { "type": "integer" }, "NumConnsOutbound": { "type": "integer" }, "NumFD": { "type": "integer" }, "NumStreamsInbound": { "type": "integer" }, "NumStreamsOutbound": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "Services": { "patternProperties": { ".*": { "additionalProperties": false, "properties": { "Memory": { "type": "integer" }, "NumConnsInbound": { "type": "integer" }, "NumConnsOutbound": { "type": "integer" }, "NumFD": { "type": "integer" }, "NumStreamsInbound": { "type": "integer" }, "NumStreamsOutbound": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "System": { "additionalProperties": false, "properties": { "Memory": { "type": "integer" }, "NumConnsInbound": { "type": "integer" }, "NumConnsOutbound": { "type": "integer" }, "NumFD": { "type": "integer" }, "NumStreamsInbound": { "type": "integer" }, "NumStreamsOutbound": { "type": "integer" } }, "type": "object" }, "Transient": { "additionalProperties": false, "properties": { "Memory": { "type": "integer" }, "NumConnsInbound": { "type": "integer" }, "NumConnsOutbound": { "type": "integer" }, "NumFD": { "type": "integer" }, "NumStreamsInbound": { "type": "integer" }, "NumStreamsOutbound": { "type": "integer" } }, "type": "object" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L361" } }, { "name": "p2p.UnblockPeer", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "UnblockPeer removes a peer from the set of blocked peers.\n", "paramStructure": "by-position", "params": [ { "name": "p", "description": "peer.ID", "summary": "", "schema": { "examples": [ "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "Null", "description": "Null", "schema": { "type": [ "null" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L329" } }, { "name": "p2p.Unprotect", "description": "Auth level: admin. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Unprotect removes a peer from the list of peers who have a bidirectional\npeering agreement that they are protected from being trimmed, dropped\nor negatively scored, returning a bool representing whether the given\npeer is protected or not.\n", "paramStructure": "by-position", "params": [ { "name": "id", "description": "peer.ID", "summary": "", "schema": { "examples": [ "CovLVG4fQcqUS6DmoMxAwVJGNW6PMzfwTG6BHW9NH9TLGHcbRfvPVc3JVhnufK3HTzStoTo" ], "type": [ "string" ] }, "required": true, "deprecated": false }, { "name": "tag", "description": "string", "summary": "", "schema": { "examples": [ "string value" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "bool", "description": "bool", "summary": "", "schema": { "examples": [ true ], "type": [ "boolean" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/p2p/p2p.go#L341" } }, { "name": "share.GetEDS", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "GetEDS retrieves the complete Extended Data Square (EDS) for the specified height.\nThe EDS contains all shares organized in a 2D matrix format with erasure coding.\nReturns the full EDS or an error if retrieval fails.\n", "paramStructure": "by-position", "params": [ { "name": "height", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false } ], "result": { "name": "*rsmt2d.ExtendedDataSquare", "description": "*rsmt2d.ExtendedDataSquare", "summary": "", "schema": { "examples": [ { "data_square": [ "//////////////////////////////////////4BAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=", "//////////////////////////////////////4BAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=", "//////////////////////////////////////4BAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=", "//////////////////////////////////////4BAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA=" ], "codec": "Leopard" } ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/share/share.go#L127" } }, { "name": "share.GetNamespaceData", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "GetNamespaceData retrieves all shares that belong to the specified namespace within\nthe Extended Data Square (EDS) at the given height. The shares are returned in a\nrow-by-row order, maintaining the original layout if the namespace spans multiple rows.\nReturns the namespace data or an error if retrieval fails.\n", "paramStructure": "by-position", "params": [ { "name": "height", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, { "name": "namespace", "description": "libshare.Namespace", "summary": "", "schema": { "examples": [ "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAMJ/xGlNMdE=" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "shwap.NamespaceData", "description": "shwap.NamespaceData", "summary": "", "schema": { "examples": [ [ { "shares": [ null ], "proof": {} } ] ], "items": [ { "additionalProperties": false, "properties": { "proof": { "additionalProperties": false, "type": "object" }, "shares": { "items": { "additionalProperties": false, "type": "object" }, "type": "array" } }, "type": [ "object" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/share/share.go#L140" } }, { "name": "share.GetRange", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "GetRange retrieves a range of the *original* shares and their corresponding proofs within a specific\nnamespace in the Extended Data Square (EDS) at the given height. The range is defined\nby start and end indexes. Returns the range data with proof to the data root or an error if retrieval fails.\n", "paramStructure": "by-position", "params": [ { "name": "height", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, { "name": "from", "description": "int", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, { "name": "to", "description": "int", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false } ], "result": { "name": "*GetRangeResult", "description": "*GetRangeResult", "summary": "", "schema": { "examples": [ { "Shares": [ null ], "Proof": { "data": [ "Ynl0ZSBhcnJheQ==" ], "share_proofs": [ { "start": 42, "end": 42, "nodes": [ "Ynl0ZSBhcnJheQ==" ], "leaf_hash": "Ynl0ZSBhcnJheQ==" } ], "namespace_id": "Ynl0ZSBhcnJheQ==", "row_proof": { "row_roots": [ "453D0BC3CB88A2ED6F2E06021383B22C72D25D7741AE51B4CAE1AD34D72A3F07" ], "proofs": [ { "total": "42", "index": "42", "leaf_hash": "Ynl0ZSBhcnJheQ==", "aunts": [ "Ynl0ZSBhcnJheQ==" ] } ], "start_row": 42, "end_row": 42 }, "namespace_version": 42 } } ], "additionalProperties": false, "properties": { "Proof": { "additionalProperties": false, "properties": { "data": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" }, "namespace_id": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "namespace_version": { "type": "integer" }, "row_proof": { "additionalProperties": false, "properties": { "end_row": { "type": "integer" }, "proofs": { "items": { "additionalProperties": false, "properties": { "aunts": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" }, "index": { "type": "integer" }, "leaf_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" }, "type": "array" }, "row_roots": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" }, "start_row": { "type": "integer" } }, "type": "object" }, "share_proofs": { "items": { "additionalProperties": false, "properties": { "end": { "type": "integer" }, "leaf_hash": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "nodes": { "items": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "type": "array" }, "start": { "type": "integer" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "Shares": { "items": { "additionalProperties": false, "type": "object" }, "type": "array" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/share/share.go#L135" } }, { "name": "share.GetRow", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "GetRow retrieves all shares from a specific row in the Extended Data Square (EDS)\nat the given height. Returns the complete row of shares or an error if retrieval fails.\n", "paramStructure": "by-position", "params": [ { "name": "height", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, { "name": "rowIdx", "description": "int", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false } ], "result": { "name": "shwap.Row", "description": "shwap.Row", "summary": "", "schema": { "examples": [ { "shares": null, "side": "LEFT" } ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/share/share.go#L131" } }, { "name": "share.GetSamples", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "GetSamples retrieves multiple shares from the Extended Data Square (EDS) specified by the header\nat the given sample coordinates. Returns an array of samples containing the requested shares\nor an error if retrieval fails.\n", "paramStructure": "by-position", "params": [ { "name": "height", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, { "name": "indices", "description": "[]shwap.SampleCoords", "summary": "", "schema": { "examples": [ [ { "row": 42, "col": 42 } ] ], "items": [ { "additionalProperties": false, "properties": { "col": { "type": "integer" }, "row": { "type": "integer" } }, "type": [ "object" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false } ], "result": { "name": "[]shwap.Sample", "description": "[]shwap.Sample", "summary": "", "schema": { "examples": [ [ { "share": null, "proof": {}, "proof_type": 0 } ] ], "items": [ { "additionalProperties": false, "properties": { "Proof": { "additionalProperties": false, "type": "object" }, "ProofType": { "type": "integer" } }, "type": [ "object" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/share/share.go#L121" } }, { "name": "share.GetShare", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "GetShare retrieves a specific share from the Extended Data Square (EDS) at the given height\nusing its row and column coordinates. Returns the share data or an error if retrieval fails.\n", "paramStructure": "by-position", "params": [ { "name": "height", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, { "name": "row", "description": "int", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false }, { "name": "col", "description": "int", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false } ], "result": { "name": "libshare.Share", "description": "libshare.Share", "summary": "", "schema": { "examples": [ null ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/share/share.go#L117" } }, { "name": "share.SharesAvailable", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "SharesAvailable performs a subjective validation to check if the shares committed to\nthe ExtendedHeader at the specified height are available and retrievable from the network.\nReturns an error if the shares are not available or if validation fails.\n", "paramStructure": "by-position", "params": [ { "name": "height", "description": "uint64", "summary": "", "schema": { "examples": [ 42 ], "type": [ "integer" ] }, "required": true, "deprecated": false } ], "result": { "name": "Null", "description": "Null", "schema": { "type": [ "null" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/share/share.go#L113" } }, { "name": "state.AccountAddress", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "AccountAddress retrieves the address of the node's account/signer\n", "paramStructure": "by-position", "params": [], "result": { "name": "state.Address", "description": "state.Address", "summary": "", "schema": { "examples": [ "celestia1377k5an3f94v6wyaceu0cf4nq6gk2jtpc46g7h" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/state/state.go#L193" } }, { "name": "state.Balance", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Balance retrieves the Celestia coin balance for the node's account/signer\nand verifies it against the corresponding block's AppHash.\n", "paramStructure": "by-position", "params": [], "result": { "name": "*state.Balance", "description": "*state.Balance", "summary": "", "schema": { "examples": [ { "denom": "string value", "amount": "42" } ], "additionalProperties": false, "properties": { "amount": { "additionalProperties": false, "type": "object" }, "denom": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/state/state.go#L287" } }, { "name": "state.BalanceForAddress", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "BalanceForAddress retrieves the Celestia coin balance for the given address and verifies\nthe returned balance against the corresponding block's AppHash.\n\nNOTE: the balance returned is the balance reported by the block right before\nthe node's current head (head-1). This is due to the fact that for block N, the block's\n`AppHash` is the result of applying the previous block's transaction list.\n", "paramStructure": "by-position", "params": [ { "name": "addr", "description": "state.Address", "summary": "", "schema": { "examples": [ "celestia1377k5an3f94v6wyaceu0cf4nq6gk2jtpc46g7h" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "*state.Balance", "description": "*state.Balance", "summary": "", "schema": { "examples": [ { "denom": "string value", "amount": "42" } ], "additionalProperties": false, "properties": { "amount": { "additionalProperties": false, "type": "object" }, "denom": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/state/state.go#L197" } }, { "name": "state.BeginRedelegate", "description": "Auth level: write. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "BeginRedelegate sends a user's delegated tokens to a new validator for redelegation.\n", "paramStructure": "by-position", "params": [ { "name": "srcValAddr", "description": "state.ValAddress", "summary": "", "schema": { "examples": [ "celestiavaloper1q3v5cugc8cdpud87u4zwy0a74uxkk6u4q4gx4p" ], "type": [ "string" ] }, "required": true, "deprecated": false }, { "name": "dstValAddr", "description": "state.ValAddress", "summary": "", "schema": { "examples": [ "celestiavaloper1q3v5cugc8cdpud87u4zwy0a74uxkk6u4q4gx4p" ], "type": [ "string" ] }, "required": true, "deprecated": false }, { "name": "amount", "description": "state.Int", "summary": "", "schema": { "examples": [ "42" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "config", "description": "*state.TxConfig", "summary": "", "schema": { "examples": [ { "gas_price": 0.002, "is_gas_price_set": true, "max_gas_price": 0.4, "gas": 142225, "tx_priority": 1, "key_name": "my_celes_key", "signer_address": "celestia1pjcmwj8w6hyr2c4wehakc5g8cfs36aysgucx66", "fee_granter_address": "celestia1hakc56ax66ypjcmwj8w6hyr2c4g8cfs3wesguc" } ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "*state.TxResponse", "description": "*state.TxResponse", "summary": "", "schema": { "examples": [ { "height": 30497, "txhash": "05D9016060072AA71B007A6CFB1B895623192D6616D513017964C3BFCD047282", "logs": null, "events": null } ], "additionalProperties": false, "properties": { "code": { "type": "integer" }, "codespace": { "type": "string" }, "data": { "type": "string" }, "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "index": { "type": "boolean" }, "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "gas_used": { "type": "integer" }, "gas_wanted": { "type": "integer" }, "height": { "type": "integer" }, "info": { "type": "string" }, "logs": { "items": { "additionalProperties": false, "properties": { "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "log": { "type": "string" }, "msg_index": { "type": "integer" } }, "type": "object" }, "type": "array" }, "raw_log": { "type": "string" }, "signers": { "items": { "type": "string" }, "type": "array" }, "timestamp": { "type": "string" }, "tx": { "additionalProperties": false, "properties": { "type_url": { "type": "string" }, "value": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "txhash": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/state/state.go#L227" } }, { "name": "state.CancelUnbondingDelegation", "description": "Auth level: write. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "CancelUnbondingDelegation cancels a user's pending undelegation from a validator.\n", "paramStructure": "by-position", "params": [ { "name": "valAddr", "description": "state.ValAddress", "summary": "", "schema": { "examples": [ "celestiavaloper1q3v5cugc8cdpud87u4zwy0a74uxkk6u4q4gx4p" ], "type": [ "string" ] }, "required": true, "deprecated": false }, { "name": "amount", "description": "state.Int", "summary": "", "schema": { "examples": [ "42" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "height", "description": "state.Int", "summary": "", "schema": { "examples": [ "42" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "config", "description": "*state.TxConfig", "summary": "", "schema": { "examples": [ { "gas_price": 0.002, "is_gas_price_set": true, "max_gas_price": 0.4, "gas": 142225, "tx_priority": 1, "key_name": "my_celes_key", "signer_address": "celestia1pjcmwj8w6hyr2c4wehakc5g8cfs36aysgucx66", "fee_granter_address": "celestia1hakc56ax66ypjcmwj8w6hyr2c4g8cfs3wesguc" } ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "*state.TxResponse", "description": "*state.TxResponse", "summary": "", "schema": { "examples": [ { "height": 30497, "txhash": "05D9016060072AA71B007A6CFB1B895623192D6616D513017964C3BFCD047282", "logs": null, "events": null } ], "additionalProperties": false, "properties": { "code": { "type": "integer" }, "codespace": { "type": "string" }, "data": { "type": "string" }, "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "index": { "type": "boolean" }, "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "gas_used": { "type": "integer" }, "gas_wanted": { "type": "integer" }, "height": { "type": "integer" }, "info": { "type": "string" }, "logs": { "items": { "additionalProperties": false, "properties": { "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "log": { "type": "string" }, "msg_index": { "type": "integer" } }, "type": "object" }, "type": "array" }, "raw_log": { "type": "string" }, "signers": { "items": { "type": "string" }, "type": "array" }, "timestamp": { "type": "string" }, "tx": { "additionalProperties": false, "properties": { "type_url": { "type": "string" }, "value": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "txhash": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/state/state.go#L218" } }, { "name": "state.Delegate", "description": "Auth level: write. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Delegate sends a user's liquid tokens to a validator for delegation.\n", "paramStructure": "by-position", "params": [ { "name": "delAddr", "description": "state.ValAddress", "summary": "", "schema": { "examples": [ "celestiavaloper1q3v5cugc8cdpud87u4zwy0a74uxkk6u4q4gx4p" ], "type": [ "string" ] }, "required": true, "deprecated": false }, { "name": "amount", "description": "state.Int", "summary": "", "schema": { "examples": [ "42" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "config", "description": "*state.TxConfig", "summary": "", "schema": { "examples": [ { "gas_price": 0.002, "is_gas_price_set": true, "max_gas_price": 0.4, "gas": 142225, "tx_priority": 1, "key_name": "my_celes_key", "signer_address": "celestia1pjcmwj8w6hyr2c4wehakc5g8cfs36aysgucx66", "fee_granter_address": "celestia1hakc56ax66ypjcmwj8w6hyr2c4g8cfs3wesguc" } ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "*state.TxResponse", "description": "*state.TxResponse", "summary": "", "schema": { "examples": [ { "height": 30497, "txhash": "05D9016060072AA71B007A6CFB1B895623192D6616D513017964C3BFCD047282", "logs": null, "events": null } ], "additionalProperties": false, "properties": { "code": { "type": "integer" }, "codespace": { "type": "string" }, "data": { "type": "string" }, "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "index": { "type": "boolean" }, "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "gas_used": { "type": "integer" }, "gas_wanted": { "type": "integer" }, "height": { "type": "integer" }, "info": { "type": "string" }, "logs": { "items": { "additionalProperties": false, "properties": { "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "log": { "type": "string" }, "msg_index": { "type": "integer" } }, "type": "object" }, "type": "array" }, "raw_log": { "type": "string" }, "signers": { "items": { "type": "string" }, "type": "array" }, "timestamp": { "type": "string" }, "tx": { "additionalProperties": false, "properties": { "type_url": { "type": "string" }, "value": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "txhash": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/state/state.go#L245" } }, { "name": "state.GrantFee", "description": "Auth level: write. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "No comment exists yet for this method.", "paramStructure": "by-position", "params": [ { "name": "grantee", "description": "state.AccAddress", "summary": "", "schema": { "examples": [ "celestia1377k5an3f94v6wyaceu0cf4nq6gk2jtpc46g7h" ], "type": [ "string" ] }, "required": true, "deprecated": false }, { "name": "amount", "description": "state.Int", "summary": "", "schema": { "examples": [ "42" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "config", "description": "*state.TxConfig", "summary": "", "schema": { "examples": [ { "gas_price": 0.002, "is_gas_price_set": true, "max_gas_price": 0.4, "gas": 142225, "tx_priority": 1, "key_name": "my_celes_key", "signer_address": "celestia1pjcmwj8w6hyr2c4wehakc5g8cfs36aysgucx66", "fee_granter_address": "celestia1hakc56ax66ypjcmwj8w6hyr2c4g8cfs3wesguc" } ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "*state.TxResponse", "description": "*state.TxResponse", "summary": "", "schema": { "examples": [ { "height": 30497, "txhash": "05D9016060072AA71B007A6CFB1B895623192D6616D513017964C3BFCD047282", "logs": null, "events": null } ], "additionalProperties": false, "properties": { "code": { "type": "integer" }, "codespace": { "type": "string" }, "data": { "type": "string" }, "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "index": { "type": "boolean" }, "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "gas_used": { "type": "integer" }, "gas_wanted": { "type": "integer" }, "height": { "type": "integer" }, "info": { "type": "string" }, "logs": { "items": { "additionalProperties": false, "properties": { "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "log": { "type": "string" }, "msg_index": { "type": "integer" } }, "type": "object" }, "type": "array" }, "raw_log": { "type": "string" }, "signers": { "items": { "type": "string" }, "type": "array" }, "timestamp": { "type": "string" }, "tx": { "additionalProperties": false, "properties": { "type_url": { "type": "string" }, "value": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "txhash": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/state/state.go#L291" } }, { "name": "state.QueryDelegation", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "QueryDelegation retrieves the delegation information between a delegator and a validator.\n", "paramStructure": "by-position", "params": [ { "name": "valAddr", "description": "state.ValAddress", "summary": "", "schema": { "examples": [ "celestiavaloper1q3v5cugc8cdpud87u4zwy0a74uxkk6u4q4gx4p" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "*types.QueryDelegationResponse", "description": "*types.QueryDelegationResponse", "summary": "", "schema": { "examples": [ { "delegation_response": { "delegation": { "delegator_address": "string value", "validator_address": "string value", "shares": "0" }, "balance": { "denom": "utia", "amount": "42" } } } ], "additionalProperties": false, "properties": { "delegation_response": { "additionalProperties": false, "properties": { "balance": { "additionalProperties": false, "properties": { "amount": { "additionalProperties": false, "type": "object" }, "denom": { "type": "string" } }, "type": "object" }, "delegation": { "additionalProperties": false, "properties": { "delegator_address": { "type": "string" }, "shares": { "additionalProperties": false, "type": "object" }, "validator_address": { "type": "string" } }, "type": "object" } }, "type": "object" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/state/state.go#L269" } }, { "name": "state.QueryDelegationRewards", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "QueryDelegationRewards retrieves the pending rewards for a delegation to a given validator.\n", "paramStructure": "by-position", "params": [ { "name": "valAddr", "description": "state.ValAddress", "summary": "", "schema": { "examples": [ "celestiavaloper1q3v5cugc8cdpud87u4zwy0a74uxkk6u4q4gx4p" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "*distributiontypes.QueryDelegationRewardsResponse", "description": "*distributiontypes.QueryDelegationRewardsResponse", "summary": "", "schema": { "examples": [ { "rewards": [ { "denom": "string value", "amount": "0" } ] } ], "additionalProperties": false, "properties": { "rewards": { "items": { "additionalProperties": false, "properties": { "amount": { "additionalProperties": false, "type": "object" }, "denom": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/state/state.go#L262" } }, { "name": "state.QueryRedelegations", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "QueryRedelegations retrieves the status of the redelegations between a delegator and a validator.\n", "paramStructure": "by-position", "params": [ { "name": "srcValAddr", "description": "state.ValAddress", "summary": "", "schema": { "examples": [ "celestiavaloper1q3v5cugc8cdpud87u4zwy0a74uxkk6u4q4gx4p" ], "type": [ "string" ] }, "required": true, "deprecated": false }, { "name": "dstValAddr", "description": "state.ValAddress", "summary": "", "schema": { "examples": [ "celestiavaloper1q3v5cugc8cdpud87u4zwy0a74uxkk6u4q4gx4p" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "*types.QueryRedelegationsResponse", "description": "*types.QueryRedelegationsResponse", "summary": "", "schema": { "examples": [ { "redelegation_responses": [ { "redelegation": { "delegator_address": "string value", "validator_src_address": "string value", "validator_dst_address": "string value", "entries": [ { "creation_height": 42, "completion_time": "0001-01-01T00:00:00Z", "initial_balance": "42", "shares_dst": "0", "unbonding_id": 42, "unbonding_on_hold_ref_count": 42 } ] }, "entries": [ { "redelegation_entry": { "creation_height": 42, "completion_time": "0001-01-01T00:00:00Z", "initial_balance": "42", "shares_dst": "0", "unbonding_id": 42, "unbonding_on_hold_ref_count": 42 }, "balance": "42" } ] } ], "pagination": { "next_key": "Ynl0ZSBhcnJheQ==", "total": 42 } } ], "additionalProperties": false, "properties": { "pagination": { "additionalProperties": false, "properties": { "next_key": { "media": { "binaryEncoding": "base64" }, "type": "string" }, "total": { "type": "integer" } }, "type": "object" }, "redelegation_responses": { "items": { "additionalProperties": false, "properties": { "entries": { "items": { "additionalProperties": false, "properties": { "balance": { "additionalProperties": false, "type": "object" }, "redelegation_entry": { "additionalProperties": false, "properties": { "completion_time": { "format": "date-time", "type": "string" }, "creation_height": { "type": "integer" }, "initial_balance": { "additionalProperties": false, "type": "object" }, "shares_dst": { "additionalProperties": false, "type": "object" }, "unbonding_id": { "type": "integer" }, "unbonding_on_hold_ref_count": { "type": "integer" } }, "type": "object" } }, "type": "object" }, "type": "array" }, "redelegation": { "additionalProperties": false, "properties": { "delegator_address": { "type": "string" }, "entries": { "items": { "additionalProperties": false, "properties": { "completion_time": { "format": "date-time", "type": "string" }, "creation_height": { "type": "integer" }, "initial_balance": { "additionalProperties": false, "type": "object" }, "shares_dst": { "additionalProperties": false, "type": "object" }, "unbonding_id": { "type": "integer" }, "unbonding_on_hold_ref_count": { "type": "integer" } }, "type": "object" }, "type": "array" }, "validator_dst_address": { "type": "string" }, "validator_src_address": { "type": "string" } }, "type": "object" } }, "type": "object" }, "type": "array" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/state/state.go#L280" } }, { "name": "state.QueryUnbonding", "description": "Auth level: read. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "QueryUnbonding retrieves the unbonding status between a delegator and a validator.\n", "paramStructure": "by-position", "params": [ { "name": "valAddr", "description": "state.ValAddress", "summary": "", "schema": { "examples": [ "celestiavaloper1q3v5cugc8cdpud87u4zwy0a74uxkk6u4q4gx4p" ], "type": [ "string" ] }, "required": true, "deprecated": false } ], "result": { "name": "*types.QueryUnbondingDelegationResponse", "description": "*types.QueryUnbondingDelegationResponse", "summary": "", "schema": { "examples": [ { "unbond": { "delegator_address": "string value", "validator_address": "string value", "entries": [ { "creation_height": 42, "completion_time": "0001-01-01T00:00:00Z", "initial_balance": "42", "balance": "42", "unbonding_id": 42, "unbonding_on_hold_ref_count": 42 } ] } } ], "additionalProperties": false, "properties": { "unbond": { "additionalProperties": false, "properties": { "delegator_address": { "type": "string" }, "entries": { "items": { "additionalProperties": false, "properties": { "balance": { "additionalProperties": false, "type": "object" }, "completion_time": { "format": "date-time", "type": "string" }, "creation_height": { "type": "integer" }, "initial_balance": { "additionalProperties": false, "type": "object" }, "unbonding_id": { "type": "integer" }, "unbonding_on_hold_ref_count": { "type": "integer" } }, "type": "object" }, "type": "array" }, "validator_address": { "type": "string" } }, "type": "object" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/state/state.go#L273" } }, { "name": "state.RevokeGrantFee", "description": "Auth level: write. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "No comment exists yet for this method.", "paramStructure": "by-position", "params": [ { "name": "grantee", "description": "state.AccAddress", "summary": "", "schema": { "examples": [ "celestia1377k5an3f94v6wyaceu0cf4nq6gk2jtpc46g7h" ], "type": [ "string" ] }, "required": true, "deprecated": false }, { "name": "config", "description": "*state.TxConfig", "summary": "", "schema": { "examples": [ { "gas_price": 0.002, "is_gas_price_set": true, "max_gas_price": 0.4, "gas": 142225, "tx_priority": 1, "key_name": "my_celes_key", "signer_address": "celestia1pjcmwj8w6hyr2c4wehakc5g8cfs36aysgucx66", "fee_granter_address": "celestia1hakc56ax66ypjcmwj8w6hyr2c4g8cfs3wesguc" } ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "*state.TxResponse", "description": "*state.TxResponse", "summary": "", "schema": { "examples": [ { "height": 30497, "txhash": "05D9016060072AA71B007A6CFB1B895623192D6616D513017964C3BFCD047282", "logs": null, "events": null } ], "additionalProperties": false, "properties": { "code": { "type": "integer" }, "codespace": { "type": "string" }, "data": { "type": "string" }, "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "index": { "type": "boolean" }, "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "gas_used": { "type": "integer" }, "gas_wanted": { "type": "integer" }, "height": { "type": "integer" }, "info": { "type": "string" }, "logs": { "items": { "additionalProperties": false, "properties": { "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "log": { "type": "string" }, "msg_index": { "type": "integer" } }, "type": "object" }, "type": "array" }, "raw_log": { "type": "string" }, "signers": { "items": { "type": "string" }, "type": "array" }, "timestamp": { "type": "string" }, "tx": { "additionalProperties": false, "properties": { "type_url": { "type": "string" }, "value": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "txhash": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/state/state.go#L300" } }, { "name": "state.SubmitPayForBlob", "description": "Auth level: write. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "SubmitPayForBlob builds, signs and submits a PayForBlob transaction.\n", "paramStructure": "by-position", "params": [ { "name": "blobs", "description": "[]*libshare.Blob", "summary": "", "schema": { "examples": [ [ { "namespace_id": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAwn/EaU0x0Q==", "data": "z8QyNztvogN7NYU27gI+nJgg1vMJtkK3vbduSDz7/8mhmos37I7duH51kkgouxrsdhdOBJ1431OmipNfVedbtwe6zQ06EbJBl/jk4QwwU3S29YBTUZcUfTzXpEJIuMrYzU6YPxN8Zce/KNdsEIy4zxdfxekXpvsgZMBhf83iYgfHvsFAoJmmCp/ORAUoAFf7tJ7cF8RZyA20ftqRa1uhAmktxIb58abpGTG+TNgq3mjyvswECVykJYqGjqNtInyIx2EQOnVp2q69YHkegdoBvoOKzEFigQTdrL2TZBex4MhkrYt7Zf0DQyNMRkCPL/zKYE3bhvXNWMThWCmhD5TOApzirORXKOTB0nxhjDF/aFYkrS+IKBw1KfJ5isldWvmasJBWwRgDuli6Cty67vMMk7fUUTUf0St6rvQeftSoEVlC1xEw46+h5kIXaWiM0g/EzGIAdZHycUFWCSdnt3p7BS5ttEpSf1d6ZbVYYL2y0XguH41k54JqufEMAw9ukmaF0IbN9Jk6fNefV1dsWTdCP6Mz6e+RTCd9DQGqb2VrsvMzx5uVidLD8ND79pvXgL1VzyhJaMTcjSfZK15jOxLwGh1arZc2gyTNiq2pu6wNz0tdJp+fFU+peG8rHN8=" } ] ], "items": [ { "additionalProperties": false, "type": [ "object" ] } ], "type": [ "array" ] }, "required": true, "deprecated": false }, { "name": "config", "description": "*state.TxConfig", "summary": "", "schema": { "examples": [ { "gas_price": 0.002, "is_gas_price_set": true, "max_gas_price": 0.4, "gas": 142225, "tx_priority": 1, "key_name": "my_celes_key", "signer_address": "celestia1pjcmwj8w6hyr2c4wehakc5g8cfs36aysgucx66", "fee_granter_address": "celestia1hakc56ax66ypjcmwj8w6hyr2c4g8cfs3wesguc" } ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "*state.TxResponse", "description": "*state.TxResponse", "summary": "", "schema": { "examples": [ { "height": 30497, "txhash": "05D9016060072AA71B007A6CFB1B895623192D6616D513017964C3BFCD047282", "logs": null, "events": null } ], "additionalProperties": false, "properties": { "code": { "type": "integer" }, "codespace": { "type": "string" }, "data": { "type": "string" }, "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "index": { "type": "boolean" }, "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "gas_used": { "type": "integer" }, "gas_wanted": { "type": "integer" }, "height": { "type": "integer" }, "info": { "type": "string" }, "logs": { "items": { "additionalProperties": false, "properties": { "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "log": { "type": "string" }, "msg_index": { "type": "integer" } }, "type": "object" }, "type": "array" }, "raw_log": { "type": "string" }, "signers": { "items": { "type": "string" }, "type": "array" }, "timestamp": { "type": "string" }, "tx": { "additionalProperties": false, "properties": { "type_url": { "type": "string" }, "value": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "txhash": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/state/state.go#L210" } }, { "name": "state.Transfer", "description": "Auth level: write. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Transfer sends the given amount of coins from default wallet of the node to the given account\naddress.\n", "paramStructure": "by-position", "params": [ { "name": "to", "description": "state.AccAddress", "summary": "", "schema": { "examples": [ "celestia1377k5an3f94v6wyaceu0cf4nq6gk2jtpc46g7h" ], "type": [ "string" ] }, "required": true, "deprecated": false }, { "name": "amount", "description": "state.Int", "summary": "", "schema": { "examples": [ "42" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "config", "description": "*state.TxConfig", "summary": "", "schema": { "examples": [ { "gas_price": 0.002, "is_gas_price_set": true, "max_gas_price": 0.4, "gas": 142225, "tx_priority": 1, "key_name": "my_celes_key", "signer_address": "celestia1pjcmwj8w6hyr2c4wehakc5g8cfs36aysgucx66", "fee_granter_address": "celestia1hakc56ax66ypjcmwj8w6hyr2c4g8cfs3wesguc" } ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "*state.TxResponse", "description": "*state.TxResponse", "summary": "", "schema": { "examples": [ { "height": 30497, "txhash": "05D9016060072AA71B007A6CFB1B895623192D6616D513017964C3BFCD047282", "logs": null, "events": null } ], "additionalProperties": false, "properties": { "code": { "type": "integer" }, "codespace": { "type": "string" }, "data": { "type": "string" }, "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "index": { "type": "boolean" }, "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "gas_used": { "type": "integer" }, "gas_wanted": { "type": "integer" }, "height": { "type": "integer" }, "info": { "type": "string" }, "logs": { "items": { "additionalProperties": false, "properties": { "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "log": { "type": "string" }, "msg_index": { "type": "integer" } }, "type": "object" }, "type": "array" }, "raw_log": { "type": "string" }, "signers": { "items": { "type": "string" }, "type": "array" }, "timestamp": { "type": "string" }, "tx": { "additionalProperties": false, "properties": { "type_url": { "type": "string" }, "value": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "txhash": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/state/state.go#L201" } }, { "name": "state.Undelegate", "description": "Auth level: write. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "Undelegate undelegates a user's delegated tokens, unbonding them from the current validator.\n", "paramStructure": "by-position", "params": [ { "name": "delAddr", "description": "state.ValAddress", "summary": "", "schema": { "examples": [ "celestiavaloper1q3v5cugc8cdpud87u4zwy0a74uxkk6u4q4gx4p" ], "type": [ "string" ] }, "required": true, "deprecated": false }, { "name": "amount", "description": "state.Int", "summary": "", "schema": { "examples": [ "42" ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false }, { "name": "config", "description": "*state.TxConfig", "summary": "", "schema": { "examples": [ { "gas_price": 0.002, "is_gas_price_set": true, "max_gas_price": 0.4, "gas": 142225, "tx_priority": 1, "key_name": "my_celes_key", "signer_address": "celestia1pjcmwj8w6hyr2c4wehakc5g8cfs36aysgucx66", "fee_granter_address": "celestia1hakc56ax66ypjcmwj8w6hyr2c4g8cfs3wesguc" } ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "*state.TxResponse", "description": "*state.TxResponse", "summary": "", "schema": { "examples": [ { "height": 30497, "txhash": "05D9016060072AA71B007A6CFB1B895623192D6616D513017964C3BFCD047282", "logs": null, "events": null } ], "additionalProperties": false, "properties": { "code": { "type": "integer" }, "codespace": { "type": "string" }, "data": { "type": "string" }, "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "index": { "type": "boolean" }, "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "gas_used": { "type": "integer" }, "gas_wanted": { "type": "integer" }, "height": { "type": "integer" }, "info": { "type": "string" }, "logs": { "items": { "additionalProperties": false, "properties": { "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "log": { "type": "string" }, "msg_index": { "type": "integer" } }, "type": "object" }, "type": "array" }, "raw_log": { "type": "string" }, "signers": { "items": { "type": "string" }, "type": "array" }, "timestamp": { "type": "string" }, "tx": { "additionalProperties": false, "properties": { "type_url": { "type": "string" }, "value": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "txhash": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/state/state.go#L236" } }, { "name": "state.WithdrawDelegatorReward", "description": "Auth level: write. Requests must include the HTTP header: Authorization: Bearer \u003ctoken\u003e.", "summary": "WithdrawDelegatorReward withdraws a delegator's rewards from a validator.\n", "paramStructure": "by-position", "params": [ { "name": "valAddr", "description": "state.ValAddress", "summary": "", "schema": { "examples": [ "celestiavaloper1q3v5cugc8cdpud87u4zwy0a74uxkk6u4q4gx4p" ], "type": [ "string" ] }, "required": true, "deprecated": false }, { "name": "config", "description": "*state.TxConfig", "summary": "", "schema": { "examples": [ { "gas_price": 0.002, "is_gas_price_set": true, "max_gas_price": 0.4, "gas": 142225, "tx_priority": 1, "key_name": "my_celes_key", "signer_address": "celestia1pjcmwj8w6hyr2c4wehakc5g8cfs36aysgucx66", "fee_granter_address": "celestia1hakc56ax66ypjcmwj8w6hyr2c4g8cfs3wesguc" } ], "additionalProperties": false, "type": [ "object" ] }, "required": true, "deprecated": false } ], "result": { "name": "*state.TxResponse", "description": "*state.TxResponse", "summary": "", "schema": { "examples": [ { "height": 30497, "txhash": "05D9016060072AA71B007A6CFB1B895623192D6616D513017964C3BFCD047282", "logs": null, "events": null } ], "additionalProperties": false, "properties": { "code": { "type": "integer" }, "codespace": { "type": "string" }, "data": { "type": "string" }, "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "index": { "type": "boolean" }, "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "gas_used": { "type": "integer" }, "gas_wanted": { "type": "integer" }, "height": { "type": "integer" }, "info": { "type": "string" }, "logs": { "items": { "additionalProperties": false, "properties": { "events": { "items": { "additionalProperties": false, "properties": { "attributes": { "items": { "additionalProperties": false, "properties": { "key": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" }, "type": { "type": "string" } }, "type": "object" }, "type": "array" }, "log": { "type": "string" }, "msg_index": { "type": "integer" } }, "type": "object" }, "type": "array" }, "raw_log": { "type": "string" }, "signers": { "items": { "type": "string" }, "type": "array" }, "timestamp": { "type": "string" }, "tx": { "additionalProperties": false, "properties": { "type_url": { "type": "string" }, "value": { "media": { "binaryEncoding": "base64" }, "type": "string" } }, "type": "object" }, "txhash": { "type": "string" } }, "type": [ "object" ] }, "required": true, "deprecated": false }, "deprecated": false, "externalDocs": { "description": "Source of the default service's implementation of this method.", "url": "https://github.com/celestiaorg/celestia-node/blob/main/nodebuilder/state/state.go#L254" } } ] }