github.com/badrootd/celestia-core@v0.0.0-20240305091328-aa4207a4b25d/rpc/openapi/openapi.yaml (about) 1 openapi: 3.0.0 2 info: 3 title: CometBFT RPC 4 contact: 5 name: CometBFT 6 url: https://cometbft.com/ 7 description: | 8 CometBFT supports the following RPC protocols: 9 10 * URI over HTTP 11 * JSONRPC over HTTP 12 * JSONRPC over websockets 13 14 ## Configuration 15 16 RPC can be configured by tuning parameters under `[rpc]` table in the 17 `$CMTHOME/config/config.toml` file or by using the `--rpc.X` command-line 18 flags. 19 20 The default RPC listen address is `tcp://127.0.0.1:26657`. 21 To set another address, set the `laddr` config parameter to desired value. 22 CORS (Cross-Origin Resource Sharing) can be enabled by setting 23 `cors_allowed_origins`, `cors_allowed_methods`, `cors_allowed_headers` 24 config parameters. 25 26 If testing using a local RPC node, under the `[rpc]` 27 section change the `cors_allowed_origins` property, please add the URL of 28 the site where this OpenAPI document is running, for example: 29 30 `cors_allowed_origins = ["http://localhost:8088"]` 31 32 or if testing from the official documentation site: 33 34 `cors_allowed_origins = ["https://docs.cometbft.com"]` 35 36 ## Arguments 37 38 Arguments which expect strings or byte arrays may be passed as quoted 39 strings, like `"abc"` or as `0x`-prefixed strings, like `0x616263`. 40 41 ## URI/HTTP 42 43 A REST like interface. 44 45 curl localhost:26657/block?height=5 46 47 ## JSONRPC/HTTP 48 49 JSONRPC requests can be POST'd to the root RPC endpoint via HTTP. 50 51 curl --header "Content-Type: application/json" --request POST --data '{"method": "block", "params": ["5"], "id": 1}' localhost:26657 52 53 ## JSONRPC/websockets 54 55 JSONRPC requests can be also made via websocket. 56 The websocket endpoint is at `/websocket`, e.g. `localhost:26657/websocket`. 57 Asynchronous RPC functions like event `subscribe` and `unsubscribe` are 58 only available via websockets. 59 60 For example using the [websocat](https://github.com/vi/websocat) tool, you can subscribe for 'NewBlock` events 61 with the following command: 62 63 echo '{ "jsonrpc": "2.0","method": "subscribe","id": 0,"params": {"query": "tm.event='"'NewBlock'"'"} }' | websocat -n -t ws://127.0.0.1:26657/websocket 64 65 version: "v0.34" 66 license: 67 name: Apache 2.0 68 url: https://github.com/cometbft/cometbft/blob/v0.34.x/LICENSE 69 servers: 70 - url: https://rpc.cosmos.directory/cosmoshub 71 description: Interact with the CometBFT RPC from a public node in the Cosmos registry 72 - url: http://localhost:26657 73 description: Interact with CometBFT RPC node running locally 74 tags: 75 - name: Info 76 description: Information about the node APIs 77 - name: Tx 78 description: Transactions broadcast APIs 79 - name: ABCI 80 description: ABCI APIs 81 - name: Evidence 82 description: Evidence APIs 83 - name: Unsafe 84 description: Unsafe APIs 85 paths: 86 /broadcast_tx_sync: 87 get: 88 summary: Returns with the response from CheckTx. Does not wait for DeliverTx result. 89 tags: 90 - Tx 91 operationId: broadcast_tx_sync 92 description: | 93 If you want to be sure that the transaction is included in a block, you can 94 subscribe for the result using JSONRPC via a websocket. See 95 https://docs.cometbft.com/v0.34/core/subscription.html 96 If you haven't received anything after a couple of blocks, resend it. If the 97 same happens again, send it to some other node. A few reasons why it could 98 happen: 99 100 1. malicious node can drop or pretend it had committed your tx 101 2. malicious proposer (not necessary the one you're communicating with) can 102 drop transactions, which might become valid in the future 103 (https://github.com/cometbft/cometbft/issues/3322) 104 105 Please refer to 106 https://docs.cometbft.com/v0.34/core/using-cometbft.html#formatting 107 for formatting/encoding rules. 108 109 parameters: 110 - in: query 111 name: tx 112 required: true 113 schema: 114 type: string 115 example: "456" 116 description: The transaction 117 responses: 118 "200": 119 description: Empty 120 content: 121 application/json: 122 schema: 123 $ref: "#/components/schemas/BroadcastTxResponse" 124 "500": 125 description: Error 126 content: 127 application/json: 128 schema: 129 $ref: "#/components/schemas/ErrorResponse" 130 /broadcast_tx_async: 131 get: 132 summary: Returns right away, with no response. Does not wait for CheckTx nor DeliverTx results. 133 tags: 134 - Tx 135 operationId: broadcast_tx_async 136 description: | 137 If you want to be sure that the transaction is included in a block, you can 138 subscribe for the result using JSONRPC via a websocket. See 139 https://docs.cometbft.com/v0.34/core/subscription.html 140 If you haven't received anything after a couple of blocks, resend it. If the 141 same happens again, send it to some other node. A few reasons why it could 142 happen: 143 144 1. malicious node can drop or pretend it had committed your tx 145 2. malicious proposer (not necessary the one you're communicating with) can 146 drop transactions, which might become valid in the future 147 (https://github.com/cometbft/cometbft/issues/3322) 148 3. node can be offline 149 150 Please refer to 151 https://docs.cometbft.com/v0.34/core/using-cometbft.html#formatting 152 for formatting/encoding rules. 153 154 parameters: 155 - in: query 156 name: tx 157 required: true 158 schema: 159 type: string 160 example: "123" 161 description: The transaction 162 responses: 163 "200": 164 description: empty answer 165 content: 166 application/json: 167 schema: 168 $ref: "#/components/schemas/BroadcastTxResponse" 169 "500": 170 description: empty error 171 content: 172 application/json: 173 schema: 174 $ref: "#/components/schemas/ErrorResponse" 175 /broadcast_tx_commit: 176 get: 177 summary: Returns with the responses from CheckTx and DeliverTx. 178 tags: 179 - Tx 180 operationId: broadcast_tx_commit 181 description: | 182 IMPORTANT: use only for testing and development. In production, use 183 BroadcastTxSync or BroadcastTxAsync. You can subscribe for the transaction 184 result using JSONRPC via a websocket. See 185 https://docs.cometbft.com/v0.34/core/subscription.html 186 187 CONTRACT: only returns error if mempool.CheckTx() errs or if we timeout 188 waiting for tx to commit. 189 190 If CheckTx or DeliverTx fail, no error will be returned, but the returned result 191 will contain a non-OK ABCI code. 192 193 Please refer to 194 https://docs.cometbft.com/v0.34/core/using-cometbft.html#formatting 195 for formatting/encoding rules. 196 197 parameters: 198 - in: query 199 name: tx 200 required: true 201 schema: 202 type: string 203 example: "785" 204 description: The transaction 205 responses: 206 "200": 207 description: empty answer 208 content: 209 application/json: 210 schema: 211 $ref: "#/components/schemas/BroadcastTxCommitResponse" 212 "500": 213 description: empty error 214 content: 215 application/json: 216 schema: 217 $ref: "#/components/schemas/ErrorResponse" 218 /check_tx: 219 get: 220 summary: Checks the transaction without executing it. 221 tags: 222 - Tx 223 operationId: check_tx 224 description: | 225 The transaction won't be added to the mempool. 226 227 Please refer to 228 https://docs.cometbft.com/v0.34/core/using-cometbft.html#formatting 229 for formatting/encoding rules. 230 231 Upon success, the `Cache-Control` header will be set with the default 232 maximum age. 233 parameters: 234 - in: query 235 name: tx 236 required: true 237 schema: 238 type: string 239 example: "785" 240 description: The transaction 241 responses: 242 "200": 243 description: ABCI application's CheckTx response 244 content: 245 application/json: 246 schema: 247 $ref: "#/components/schemas/CheckTxResponse" 248 "500": 249 description: empty error 250 content: 251 application/json: 252 schema: 253 $ref: "#/components/schemas/ErrorResponse" 254 /health: 255 get: 256 summary: Node heartbeat 257 tags: 258 - Info 259 operationId: health 260 description: | 261 Get node health. Returns empty result (200 OK) on success, no response - in case of an error. 262 responses: 263 "200": 264 description: Gets Node Health 265 content: 266 application/json: 267 schema: 268 $ref: "#/components/schemas/EmptyResponse" 269 "500": 270 description: empty error 271 content: 272 application/json: 273 schema: 274 $ref: "#/components/schemas/ErrorResponse" 275 /status: 276 get: 277 summary: Node Status 278 operationId: status 279 tags: 280 - Info 281 description: | 282 Get CometBFT status including node info, pubkey, latest block hash, app hash, block height and time. 283 responses: 284 "200": 285 description: Status of the node 286 content: 287 application/json: 288 schema: 289 $ref: "#/components/schemas/StatusResponse" 290 "500": 291 description: empty error 292 content: 293 application/json: 294 schema: 295 $ref: "#/components/schemas/ErrorResponse" 296 /net_info: 297 get: 298 summary: Network information 299 operationId: net_info 300 tags: 301 - Info 302 description: | 303 Get network info. 304 responses: 305 "200": 306 description: empty answer 307 content: 308 application/json: 309 schema: 310 $ref: "#/components/schemas/NetInfoResponse" 311 "500": 312 description: empty error 313 content: 314 application/json: 315 schema: 316 $ref: "#/components/schemas/ErrorResponse" 317 /dial_seeds: 318 get: 319 summary: Dial Seeds (Unsafe) 320 operationId: dial_seeds 321 tags: 322 - Unsafe 323 description: | 324 Dial a peer, this route in under unsafe, and has to manually enabled to use 325 326 **Example:** curl 'localhost:26657/dial_seeds?seeds=\["f9baeaa15fedf5e1ef7448dd60f46c01f1a9e9c4@1.2.3.4:26656","0491d373a8e0fcf1023aaf18c51d6a1d0d4f31bd@5.6.7.8:26656"\]' 327 parameters: 328 - in: query 329 name: peers 330 description: list of seed nodes to dial 331 schema: 332 type: array 333 items: 334 type: string 335 example: 336 "f9baeaa15fedf5e1ef7448dd60f46c01f1a9e9c4@1.2.3.4:26656" 337 responses: 338 "200": 339 description: Dialing seeds in progress. See /net_info for details 340 content: 341 application/json: 342 schema: 343 $ref: "#/components/schemas/dialResp" 344 "500": 345 description: empty error 346 content: 347 application/json: 348 schema: 349 $ref: "#/components/schemas/ErrorResponse" 350 /dial_peers: 351 get: 352 summary: Add Peers/Persistent Peers (unsafe) 353 operationId: dial_peers 354 tags: 355 - Unsafe 356 description: | 357 Set a persistent peer, this route in under unsafe, and has to manually enabled to use. 358 359 **Example:** curl 'localhost:26657/dial_peers?peers=\["f9baeaa15fedf5e1ef7448dd60f46c01f1a9e9c4@1.2.3.4:26656","0491d373a8e0fcf1023aaf18c51d6a1d0d4f31bd@5.6.7.8:26656"\]&persistent=false' 360 parameters: 361 - in: query 362 name: persistent 363 description: Have the peers you are dialing be persistent 364 schema: 365 type: boolean 366 example: true 367 - in: query 368 name: unconditional 369 description: Have the peers you are dialing be unconditional 370 schema: 371 type: boolean 372 example: true 373 - in: query 374 name: private 375 description: Have the peers you are dialing be private 376 schema: 377 type: boolean 378 example: true 379 - in: query 380 name: peers 381 description: array of peers to dial 382 schema: 383 type: array 384 items: 385 type: string 386 example: 387 "f9baeaa15fedf5e1ef7448dd60f46c01f1a9e9c4@1.2.3.4:26656" 388 example: 389 ["f9baeaa15fedf5e1ef7448dd60f46c01f1a9e9c4@1.2.3.4:26656", "f9baeaa15fedf5e1ef7448dd60f46c01f1a9e9c4@1.2.3.5:26656"] 390 responses: 391 "200": 392 description: Dialing seeds in progress. See /net_info for details 393 content: 394 application/json: 395 schema: 396 $ref: "#/components/schemas/dialResp" 397 "500": 398 description: empty error 399 content: 400 application/json: 401 schema: 402 $ref: "#/components/schemas/ErrorResponse" 403 /blockchain: 404 get: 405 summary: "Get block headers (max: 20) for minHeight <= height <= maxHeight." 406 operationId: blockchain 407 parameters: 408 - in: query 409 name: minHeight 410 description: Minimum block height to return 411 schema: 412 type: integer 413 example: 1 414 - in: query 415 name: maxHeight 416 description: Maximum block height to return 417 schema: 418 type: integer 419 example: 2 420 tags: 421 - Info 422 description: | 423 Get block headers for minHeight <= height <= maxHeight. 424 425 At most 20 items will be returned. 426 427 Upon success, the `Cache-Control` header will be set with the default 428 maximum age. 429 responses: 430 "200": 431 description: Block headers, returned in descending order (highest first). 432 content: 433 application/json: 434 schema: 435 $ref: "#/components/schemas/BlockchainResponse" 436 "500": 437 description: Error 438 content: 439 application/json: 440 schema: 441 $ref: "#/components/schemas/ErrorResponse" 442 /header: 443 get: 444 summary: Get header at a specified height 445 operationId: header 446 parameters: 447 - in: query 448 name: height 449 schema: 450 type: integer 451 default: 0 452 example: 1 453 description: height to return. If no height is provided, it will fetch the latest header. 454 tags: 455 - Info 456 description: | 457 Get Header. 458 responses: 459 "200": 460 description: Header information. 461 content: 462 application/json: 463 schema: 464 $ref: "#/components/schemas/BlockHeader" 465 "500": 466 description: Error 467 content: 468 application/json: 469 schema: 470 $ref: "#/components/schemas/ErrorResponse" 471 /header_by_hash: 472 get: 473 summary: Get header by hash 474 operationId: header_by_hash 475 parameters: 476 - in: query 477 name: hash 478 description: header hash 479 required: true 480 schema: 481 type: string 482 example: "0xD70952032620CC4E2737EB8AC379806359D8E0B17B0488F627997A0B043ABDED" 483 tags: 484 - Info 485 description: | 486 Get Header By Hash. 487 responses: 488 "200": 489 description: Header information. 490 content: 491 application/json: 492 schema: 493 $ref: "#/components/schemas/BlockHeader" 494 "500": 495 description: Error 496 content: 497 application/json: 498 schema: 499 $ref: "#/components/schemas/ErrorResponse" 500 /block: 501 get: 502 summary: Get block at a specified height 503 operationId: block 504 parameters: 505 - in: query 506 name: height 507 schema: 508 type: integer 509 default: 0 510 example: 1 511 description: height to return. If no height is provided, it will fetch the latest block. 512 tags: 513 - Info 514 description: | 515 Get Block. 516 517 If the `height` field is set to a non-default value, upon success, the 518 `Cache-Control` header will be set with the default maximum age. 519 responses: 520 "200": 521 description: Block information. 522 content: 523 application/json: 524 schema: 525 $ref: "#/components/schemas/BlockResponse" 526 "500": 527 description: Error 528 content: 529 application/json: 530 schema: 531 $ref: "#/components/schemas/ErrorResponse" 532 /block_by_hash: 533 get: 534 summary: Get block by hash 535 operationId: block_by_hash 536 parameters: 537 - in: query 538 name: hash 539 description: block hash 540 required: true 541 schema: 542 type: string 543 example: "0xD70952032620CC4E2737EB8AC379806359D8E0B17B0488F627997A0B043ABDED" 544 tags: 545 - Info 546 description: | 547 Get Block By Hash. 548 549 Upon success, the `Cache-Control` header will be set with the default 550 maximum age. 551 responses: 552 "200": 553 description: Block information. 554 content: 555 application/json: 556 schema: 557 $ref: "#/components/schemas/BlockResponse" 558 "500": 559 description: Error 560 content: 561 application/json: 562 schema: 563 $ref: "#/components/schemas/ErrorResponse" 564 /block_results: 565 get: 566 summary: Get block results at a specified height 567 operationId: block_results 568 parameters: 569 - in: query 570 name: height 571 description: height to return. If no height is provided, it will fetch information regarding the latest block. 572 schema: 573 type: integer 574 default: 0 575 example: 1 576 tags: 577 - Info 578 description: | 579 Get block_results. When the `discard_abci_responses` storage flag is 580 enabled, this endpoint will return an error. 581 582 If the `height` field is set to a non-default value, upon success, the 583 `Cache-Control` header will be set with the default maximum age. 584 responses: 585 "200": 586 description: Block results. 587 content: 588 application/json: 589 schema: 590 $ref: "#/components/schemas/BlockResultsResponse" 591 "500": 592 description: Error 593 content: 594 application/json: 595 schema: 596 $ref: "#/components/schemas/ErrorResponse" 597 /commit: 598 get: 599 summary: Get commit results at a specified height 600 operationId: commit 601 parameters: 602 - in: query 603 name: height 604 description: height to return. If no height is provided, it will fetch commit information regarding the latest block. 605 schema: 606 type: integer 607 default: 0 608 example: 1 609 tags: 610 - Info 611 description: | 612 Get Commit. 613 614 If the `height` field is set to a non-default value, upon success, the 615 `Cache-Control` header will be set with the default maximum age. 616 responses: 617 "200": 618 description: | 619 Commit results. 620 621 canonical switches from false to true for block H once block H+1 has been committed. Until then it's subjective and only reflects what this node has seen so far. 622 content: 623 application/json: 624 schema: 625 $ref: "#/components/schemas/CommitResponse" 626 "500": 627 description: Error 628 content: 629 application/json: 630 schema: 631 $ref: "#/components/schemas/ErrorResponse" 632 /validators: 633 get: 634 summary: Get validator set at a specified height 635 operationId: validators 636 parameters: 637 - in: query 638 name: height 639 description: height to return. If no height is provided, it will fetch validator set which corresponds to the latest block. 640 schema: 641 type: integer 642 default: 0 643 example: 1 644 - in: query 645 name: page 646 description: "Page number (1-based)" 647 required: false 648 schema: 649 type: integer 650 default: 1 651 example: 1 652 - in: query 653 name: per_page 654 description: "Number of entries per page (max: 100)" 655 required: false 656 schema: 657 type: integer 658 example: 30 659 default: 30 660 tags: 661 - Info 662 description: | 663 Get Validators. Validators are sorted by voting power. 664 665 If the `height` field is set to a non-default value, upon success, the 666 `Cache-Control` header will be set with the default maximum age. 667 responses: 668 "200": 669 description: Commit results. 670 content: 671 application/json: 672 schema: 673 $ref: "#/components/schemas/ValidatorsResponse" 674 "500": 675 description: Error 676 content: 677 application/json: 678 schema: 679 $ref: "#/components/schemas/ErrorResponse" 680 /genesis: 681 get: 682 summary: Get Genesis 683 operationId: genesis 684 tags: 685 - Info 686 description: | 687 Get genesis. 688 689 Upon success, the `Cache-Control` header will be set with the default 690 maximum age. 691 responses: 692 "200": 693 description: Genesis results. 694 content: 695 application/json: 696 schema: 697 $ref: "#/components/schemas/GenesisResponse" 698 "500": 699 description: Error 700 content: 701 application/json: 702 schema: 703 $ref: "#/components/schemas/ErrorResponse" 704 /genesis_chunked: 705 get: 706 summary: Get Genesis in multiple chunks 707 operationId: genesis_chunked 708 tags: 709 - Info 710 description: | 711 Get genesis document in multiple chunks to make it easier to iterate 712 through larger genesis structures. Each chunk is produced by converting 713 the genesis document to JSON and then splitting the resulting payload 714 into 16MB blocks, and then Base64-encoding each block. 715 716 Upon success, the `Cache-Control` header will be set with the default 717 maximum age. 718 parameters: 719 - in: query 720 name: chunk 721 description: Sequence number of the chunk to download. 722 schema: 723 type: integer 724 default: 0 725 example: 1 726 responses: 727 "200": 728 description: Genesis chunk response. 729 content: 730 application/json: 731 schema: 732 $ref: "#/components/schemas/GenesisChunkedResponse" 733 "500": 734 description: Error 735 content: 736 application/json: 737 schema: 738 $ref: "#/components/schemas/ErrorResponse" 739 /dump_consensus_state: 740 get: 741 summary: Get consensus state 742 operationId: dump_consensus_state 743 tags: 744 - Info 745 description: | 746 Get consensus state. 747 748 Not safe to call from inside the ABCI application during a block execution. 749 responses: 750 "200": 751 description: | 752 Complete consensus state. 753 754 See https://pkg.go.dev/github.com/cometbft/cometbft/types?tab=doc#Vote.String for Vote string description. 755 content: 756 application/json: 757 schema: 758 $ref: "#/components/schemas/DumpConsensusResponse" 759 "500": 760 description: Error 761 content: 762 application/json: 763 schema: 764 $ref: "#/components/schemas/ErrorResponse" 765 /consensus_state: 766 get: 767 summary: Get consensus state 768 operationId: consensus_state 769 tags: 770 - Info 771 description: | 772 Get consensus state. 773 774 Not safe to call from inside the ABCI application during a block execution. 775 responses: 776 "200": 777 description: consensus state results. 778 content: 779 application/json: 780 schema: 781 $ref: "#/components/schemas/ConsensusStateResponse" 782 "500": 783 description: Error 784 content: 785 application/json: 786 schema: 787 $ref: "#/components/schemas/ErrorResponse" 788 /consensus_params: 789 get: 790 summary: Get consensus parameters 791 operationId: consensus_params 792 parameters: 793 - in: query 794 name: height 795 description: height to return. If no height is provided, it will fetch commit information regarding the latest block. 796 schema: 797 type: integer 798 default: 0 799 example: 1 800 tags: 801 - Info 802 description: | 803 Get consensus parameters. 804 805 If the `height` field is set to a non-default value, upon success, the 806 `Cache-Control` header will be set with the default maximum age. 807 responses: 808 "200": 809 description: consensus parameters results. 810 content: 811 application/json: 812 schema: 813 $ref: "#/components/schemas/ConsensusParamsResponse" 814 "500": 815 description: Error 816 content: 817 application/json: 818 schema: 819 $ref: "#/components/schemas/ErrorResponse" 820 /unconfirmed_txs: 821 get: 822 summary: Get the list of unconfirmed transactions 823 operationId: unconfirmed_txs 824 parameters: 825 - in: query 826 name: limit 827 description: Maximum number of unconfirmed transactions to return (max 100) 828 required: false 829 schema: 830 type: integer 831 default: 30 832 example: 1 833 tags: 834 - Info 835 description: | 836 Get list of unconfirmed transactions 837 responses: 838 "200": 839 description: List of unconfirmed transactions 840 content: 841 application/json: 842 schema: 843 $ref: "#/components/schemas/UnconfirmedTransactionsResponse" 844 "500": 845 description: Error 846 content: 847 application/json: 848 schema: 849 $ref: "#/components/schemas/ErrorResponse" 850 /num_unconfirmed_txs: 851 get: 852 summary: Get data about unconfirmed transactions 853 operationId: num_unconfirmed_txs 854 tags: 855 - Info 856 description: | 857 Get data about unconfirmed transactions 858 responses: 859 "200": 860 description: status about unconfirmed transactions 861 content: 862 application/json: 863 schema: 864 $ref: "#/components/schemas/NumUnconfirmedTransactionsResponse" 865 "500": 866 description: Error 867 content: 868 application/json: 869 schema: 870 $ref: "#/components/schemas/ErrorResponse" 871 /tx_search: 872 get: 873 summary: Search for transactions 874 description: | 875 Search for transactions w/ their results. 876 877 See /subscribe for the query syntax. 878 operationId: tx_search 879 parameters: 880 - in: query 881 name: query 882 description: Query 883 required: true 884 schema: 885 type: string 886 example: "tx.height=1000" 887 - in: query 888 name: prove 889 description: Include proofs of the transactions inclusion in the block 890 required: false 891 schema: 892 type: boolean 893 default: false 894 example: true 895 - in: query 896 name: page 897 description: "Page number (1-based)" 898 required: false 899 schema: 900 type: integer 901 default: 1 902 example: 1 903 - in: query 904 name: per_page 905 description: "Number of entries per page (max: 100)" 906 required: false 907 schema: 908 type: integer 909 default: 30 910 example: 30 911 - in: query 912 name: order_by 913 description: Order in which transactions are sorted ("asc" or "desc"), by height & index. If empty, default sorting will be still applied. 914 required: false 915 schema: 916 type: string 917 default: "asc" 918 example: "asc" 919 - in: query 920 name: match_events 921 description: Match attributes in query within events, in addition to the height & txhash 922 required: false 923 schema: 924 type: boolean 925 default: false 926 example: true 927 tags: 928 - Info 929 responses: 930 "200": 931 description: List of unconfirmed transactions 932 content: 933 application/json: 934 schema: 935 $ref: "#/components/schemas/TxSearchResponse" 936 "500": 937 description: Error 938 content: 939 application/json: 940 schema: 941 $ref: "#/components/schemas/ErrorResponse" 942 /block_search: 943 get: 944 summary: Search for blocks by BeginBlock and EndBlock events 945 description: | 946 Search for blocks by BeginBlock and EndBlock events. 947 948 See /subscribe for the query syntax. 949 operationId: block_search 950 parameters: 951 - in: query 952 name: query 953 description: Query 954 required: true 955 schema: 956 type: string 957 example: "block.height > 1000 AND valset.changed > 0" 958 - in: query 959 name: page 960 description: "Page number (1-based)" 961 required: false 962 schema: 963 type: integer 964 default: 1 965 example: 1 966 - in: query 967 name: per_page 968 description: "Number of entries per page (max: 100)" 969 required: false 970 schema: 971 type: integer 972 default: 30 973 example: 30 974 - in: query 975 name: order_by 976 description: Order in which blocks are sorted ("asc" or "desc"), by height. If empty, default sorting will be still applied. 977 required: false 978 schema: 979 type: string 980 default: "desc" 981 example: "asc" 982 - in: query 983 name: match_events 984 description: Match attributes in query within events, in addition to the height 985 required: false 986 schema: 987 type: boolean 988 default: false 989 example: true 990 tags: 991 - Info 992 responses: 993 "200": 994 description: List of paginated blocks matching the search criteria. 995 content: 996 application/json: 997 schema: 998 $ref: "#/components/schemas/BlockSearchResponse" 999 "500": 1000 description: Error 1001 content: 1002 application/json: 1003 schema: 1004 $ref: "#/components/schemas/ErrorResponse" 1005 /data_commitment: 1006 get: 1007 summary: Generates a data commitment for a range of blocks 1008 description: | 1009 Generates a data commitment over an ordered list of blocks matching the provided range. 1010 1011 The provided block range is end exclusive. 1012 operationId: data_commitment 1013 parameters: 1014 - in: query 1015 name: first_block 1016 description: "the first block of the range of blocks" 1017 required: true 1018 schema: 1019 type: integer 1020 default: 1 1021 example: 1 1022 - in: query 1023 name: last_block 1024 description: "the last block of the range of blocks" 1025 required: true 1026 schema: 1027 type: integer 1028 default: 100 1029 example: 100 1030 tags: 1031 - Info 1032 responses: 1033 "200": 1034 description: Hex representation of the data commitment. 1035 content: 1036 application/json: 1037 schema: 1038 $ref: "#/components/schemas/DataCommitmentResponse" 1039 "500": 1040 description: Error 1041 content: 1042 application/json: 1043 schema: 1044 $ref: "#/components/schemas/ErrorResponse" 1045 /data_root_inclusion_proof: 1046 get: 1047 summary: Creates a merkle proof for a data root 1048 description: | 1049 Generates a merkle proof for a data root defined by a height to the range of 1050 blocks defined by first and last block. 1051 1052 The provided block range is end exclusive. 1053 operationId: data_root_inclusion_proof 1054 parameters: 1055 - in: query 1056 name: height 1057 description: "the height of the block to prove" 1058 required: true 1059 schema: 1060 type: integer 1061 default: 5 1062 example: 5 1063 - in: query 1064 name: first_block 1065 description: "the first block of the range of blocks" 1066 required: true 1067 schema: 1068 type: integer 1069 default: 1 1070 example: 1 1071 - in: query 1072 name: last_block 1073 description: "the last block of the range of blocks" 1074 required: true 1075 schema: 1076 type: integer 1077 default: 100 1078 example: 100 1079 tags: 1080 - Info 1081 responses: 1082 "200": 1083 description: merkle proof of the height to the data commitment. 1084 content: 1085 application/json: 1086 schema: 1087 $ref: "#/components/schemas/DataRootInclusionProofResponse" 1088 "500": 1089 description: Error 1090 content: 1091 application/json: 1092 schema: 1093 $ref: "#/components/schemas/ErrorResponse" 1094 /tx: 1095 get: 1096 summary: Get transactions by hash 1097 operationId: tx 1098 parameters: 1099 - in: query 1100 name: hash 1101 description: hash of transaction to retrieve 1102 required: true 1103 schema: 1104 type: string 1105 example: "0xD70952032620CC4E2737EB8AC379806359D8E0B17B0488F627997A0B043ABDED" 1106 - in: query 1107 name: prove 1108 description: Include proofs of the transaction's inclusion in the block 1109 required: false 1110 schema: 1111 type: boolean 1112 example: true 1113 default: false 1114 tags: 1115 - Info 1116 description: | 1117 Get a transaction 1118 1119 Upon success, the `Cache-Control` header will be set with the default 1120 maximum age. 1121 responses: 1122 "200": 1123 description: Get a transaction` 1124 content: 1125 application/json: 1126 schema: 1127 $ref: "#/components/schemas/TxResponse" 1128 "500": 1129 description: Error 1130 content: 1131 application/json: 1132 schema: 1133 $ref: "#/components/schemas/ErrorResponse" 1134 /abci_info: 1135 get: 1136 summary: Get info about the application. 1137 operationId: abci_info 1138 tags: 1139 - ABCI 1140 description: | 1141 Get info about the application. 1142 1143 Upon success, the `Cache-Control` header will be set with the default 1144 maximum age. 1145 responses: 1146 "200": 1147 description: Get some info about the application. 1148 content: 1149 application/json: 1150 schema: 1151 $ref: "#/components/schemas/ABCIInfoResponse" 1152 "500": 1153 description: Error 1154 content: 1155 application/json: 1156 schema: 1157 $ref: "#/components/schemas/ErrorResponse" 1158 /abci_query: 1159 get: 1160 summary: Query the application for some information. 1161 operationId: abci_query 1162 parameters: 1163 - in: query 1164 name: path 1165 description: Path to the data ("/a/b/c") 1166 required: true 1167 schema: 1168 type: string 1169 example: "/a/b/c" 1170 - in: query 1171 name: data 1172 description: Data 1173 required: true 1174 schema: 1175 type: string 1176 example: "IHAVENOIDEA" 1177 - in: query 1178 name: height 1179 description: Height (0 means latest) 1180 required: false 1181 schema: 1182 type: integer 1183 example: 1 1184 default: 0 1185 - in: query 1186 name: prove 1187 description: Include proofs of the transactions inclusion in the block 1188 required: false 1189 schema: 1190 type: boolean 1191 example: true 1192 default: false 1193 tags: 1194 - ABCI 1195 description: | 1196 Query the application for some information. 1197 responses: 1198 "200": 1199 description: Response of the submitted query 1200 content: 1201 application/json: 1202 schema: 1203 $ref: "#/components/schemas/ABCIQueryResponse" 1204 "500": 1205 description: Error 1206 content: 1207 application/json: 1208 schema: 1209 $ref: "#/components/schemas/ErrorResponse" 1210 /broadcast_evidence: 1211 get: 1212 summary: Broadcast evidence of the misbehavior. 1213 operationId: broadcast_evidence 1214 parameters: 1215 - in: query 1216 name: evidence 1217 description: JSON evidence 1218 required: true 1219 schema: 1220 type: string 1221 example: "JSON_EVIDENCE_encoded" 1222 tags: 1223 - Info 1224 description: | 1225 Broadcast evidence of the misbehavior. 1226 responses: 1227 "200": 1228 description: Broadcast evidence of the misbehavior. 1229 content: 1230 application/json: 1231 schema: 1232 $ref: "#/components/schemas/BroadcastEvidenceResponse" 1233 "500": 1234 description: Error 1235 content: 1236 application/json: 1237 schema: 1238 $ref: "#/components/schemas/ErrorResponse" 1239 1240 components: 1241 schemas: 1242 JSONRPC: 1243 type: object 1244 properties: 1245 id: 1246 type: integer 1247 example: 0 1248 jsonrpc: 1249 type: string 1250 example: "2.0" 1251 EmptyResponse: 1252 description: Empty Response 1253 allOf: 1254 - $ref: "#/components/schemas/JSONRPC" 1255 - type: object 1256 properties: 1257 result: 1258 type: object 1259 additionalProperties: {} 1260 ErrorResponse: 1261 description: Error Response 1262 allOf: 1263 - $ref: "#/components/schemas/JSONRPC" 1264 - type: object 1265 properties: 1266 error: 1267 type: string 1268 example: "Description of failure" 1269 ProtocolVersion: 1270 type: object 1271 properties: 1272 p2p: 1273 type: string 1274 example: "7" 1275 block: 1276 type: string 1277 example: "10" 1278 app: 1279 type: string 1280 example: "0" 1281 PubKey: 1282 type: object 1283 properties: 1284 type: 1285 type: string 1286 example: "tendermint/PubKeyEd25519" 1287 value: 1288 type: string 1289 example: "A6DoBUypNtUAyEHWtQ9bFjfNg8Bo9CrnkUGl6k6OHN4=" 1290 NodeInfo: 1291 type: object 1292 properties: 1293 protocol_version: 1294 $ref: "#/components/schemas/ProtocolVersion" 1295 id: 1296 type: string 1297 example: "5576458aef205977e18fd50b274e9b5d9014525a" 1298 listen_addr: 1299 type: string 1300 example: "tcp:0.0.0.0:26656" 1301 network: 1302 type: string 1303 example: "cosmoshub-2" 1304 version: 1305 type: string 1306 example: "0.32.1" 1307 channels: 1308 type: string 1309 example: "4020212223303800" 1310 moniker: 1311 type: string 1312 example: "moniker-node" 1313 other: 1314 type: object 1315 properties: 1316 tx_index: 1317 type: string 1318 example: "on" 1319 rpc_address: 1320 type: string 1321 example: "tcp:0.0.0.0:26657" 1322 SyncInfo: 1323 type: object 1324 properties: 1325 latest_block_hash: 1326 type: string 1327 example: "790BA84C3545FCCC49A5C629CEE6EA58A6E875C3862175BDC11EE7AF54703501" 1328 latest_app_hash: 1329 type: string 1330 example: "C9AEBB441B787D9F1D846DE51F3826F4FD386108B59B08239653ABF59455C3F8" 1331 latest_block_height: 1332 type: string 1333 example: "1262196" 1334 latest_block_time: 1335 type: string 1336 example: "2019-08-01T11:52:22.818762194Z" 1337 earliest_block_hash: 1338 type: string 1339 example: "790BA84C3545FCCC49A5C629CEE6EA58A6E875C3862175BDC11EE7AF54703501" 1340 earliest_app_hash: 1341 type: string 1342 example: "C9AEBB441B787D9F1D846DE51F3826F4FD386108B59B08239653ABF59455C3F8" 1343 earliest_block_height: 1344 type: string 1345 example: "1262196" 1346 earliest_block_time: 1347 type: string 1348 example: "2019-08-01T11:52:22.818762194Z" 1349 catching_up: 1350 type: boolean 1351 example: false 1352 ValidatorInfo: 1353 type: object 1354 properties: 1355 address: 1356 type: string 1357 example: "5D6A51A8E9899C44079C6AF90618BA0369070E6E" 1358 pub_key: 1359 $ref: "#/components/schemas/PubKey" 1360 voting_power: 1361 type: string 1362 example: "0" 1363 Status: 1364 description: Status Response 1365 type: object 1366 properties: 1367 node_info: 1368 $ref: "#/components/schemas/NodeInfo" 1369 sync_info: 1370 $ref: "#/components/schemas/SyncInfo" 1371 validator_info: 1372 $ref: "#/components/schemas/ValidatorInfo" 1373 StatusResponse: 1374 description: Status Response 1375 allOf: 1376 - $ref: "#/components/schemas/JSONRPC" 1377 - type: object 1378 properties: 1379 result: 1380 $ref: "#/components/schemas/Status" 1381 Monitor: 1382 type: object 1383 properties: 1384 Active: 1385 type: boolean 1386 example: true 1387 Start: 1388 type: string 1389 example: "2019-07-31T14:31:28.66Z" 1390 Duration: 1391 type: string 1392 example: "168901060000000" 1393 Idle: 1394 type: string 1395 example: "168901040000000" 1396 Bytes: 1397 type: string 1398 example: "5" 1399 Samples: 1400 type: string 1401 example: "1" 1402 InstRate: 1403 type: string 1404 example: "0" 1405 CurRate: 1406 type: string 1407 example: "0" 1408 AvgRate: 1409 type: string 1410 example: "0" 1411 PeakRate: 1412 type: string 1413 example: "0" 1414 BytesRem: 1415 type: string 1416 example: "0" 1417 TimeRem: 1418 type: string 1419 example: "0" 1420 Progress: 1421 type: integer 1422 example: 0 1423 Channel: 1424 type: object 1425 properties: 1426 ID: 1427 type: integer 1428 example: 48 1429 SendQueueCapacity: 1430 type: string 1431 example: "1" 1432 SendQueueSize: 1433 type: string 1434 example: "0" 1435 Priority: 1436 type: string 1437 example: "5" 1438 RecentlySent: 1439 type: string 1440 example: "0" 1441 ConnectionStatus: 1442 type: object 1443 properties: 1444 Duration: 1445 type: string 1446 example: "168901057956119" 1447 SendMonitor: 1448 $ref: "#/components/schemas/Monitor" 1449 RecvMonitor: 1450 $ref: "#/components/schemas/Monitor" 1451 Channels: 1452 type: array 1453 items: 1454 $ref: "#/components/schemas/Channel" 1455 Peer: 1456 type: object 1457 properties: 1458 node_info: 1459 $ref: "#/components/schemas/NodeInfo" 1460 is_outbound: 1461 type: boolean 1462 example: true 1463 connection_status: 1464 $ref: "#/components/schemas/ConnectionStatus" 1465 remote_ip: 1466 type: string 1467 example: "95.179.155.35" 1468 NetInfo: 1469 type: object 1470 properties: 1471 listening: 1472 type: boolean 1473 example: true 1474 listeners: 1475 type: array 1476 items: 1477 type: string 1478 example: "Listener(@)" 1479 n_peers: 1480 type: string 1481 example: "1" 1482 peers: 1483 type: array 1484 items: 1485 $ref: "#/components/schemas/Peer" 1486 NetInfoResponse: 1487 description: NetInfo Response 1488 allOf: 1489 - $ref: "#/components/schemas/JSONRPC" 1490 - type: object 1491 properties: 1492 result: 1493 $ref: "#/components/schemas/NetInfo" 1494 1495 BlockMeta: 1496 type: object 1497 properties: 1498 block_id: 1499 $ref: "#/components/schemas/BlockID" 1500 block_size: 1501 type: integer 1502 example: 1000000 1503 header: 1504 $ref: "#/components/schemas/BlockHeader" 1505 num_txs: 1506 type: string 1507 example: "54" 1508 1509 Blockchain: 1510 type: object 1511 required: 1512 - "last_height" 1513 - "block_metas" 1514 properties: 1515 last_height: 1516 type: string 1517 example: "1276718" 1518 block_metas: 1519 type: array 1520 items: 1521 $ref: "#/components/schemas/BlockMeta" 1522 1523 BlockchainResponse: 1524 description: Blockchain info 1525 allOf: 1526 - $ref: "#/components/schemas/JSONRPC" 1527 - type: object 1528 properties: 1529 result: 1530 $ref: "#/components/schemas/Blockchain" 1531 1532 Commit: 1533 required: 1534 - "type" 1535 - "height" 1536 - "round" 1537 - "block_id" 1538 - "timestamp" 1539 - "validator_address" 1540 - "validator_index" 1541 - "signature" 1542 properties: 1543 type: 1544 type: integer 1545 example: 2 1546 height: 1547 type: string 1548 example: "1262085" 1549 round: 1550 type: integer 1551 example: 0 1552 block_id: 1553 $ref: "#/components/schemas/BlockID" 1554 timestamp: 1555 type: string 1556 example: "2019-08-01T11:39:38.867269833Z" 1557 validator_address: 1558 type: string 1559 example: "000001E443FD237E4B616E2FA69DF4EE3D49A94F" 1560 validator_index: 1561 type: integer 1562 example: 0 1563 signature: 1564 type: string 1565 example: "DBchvucTzAUEJnGYpNvMdqLhBAHG4Px8BsOBB3J3mAFCLGeuG7uJqy+nVngKzZdPhPi8RhmE/xcw/M9DOJjEDg==" 1566 1567 Block: 1568 type: object 1569 properties: 1570 header: 1571 $ref: "#/components/schemas/BlockHeader" 1572 data: 1573 type: array 1574 items: 1575 type: string 1576 example: "yQHwYl3uCkKoo2GaChRnd+THLQ2RM87nEZrE19910Z28ABIUWW/t8AtIMwcyU0sT32RcMDI9GF0aEAoFdWF0b20SBzEwMDAwMDASEwoNCgV1YXRvbRIEMzEwMRCd8gEaagom61rphyEDoJPxlcjRoNDtZ9xMdvs+lRzFaHe2dl2P5R2yVCWrsHISQKkqX5H1zXAIJuC57yw0Yb03Fwy75VRip0ZBtLiYsUqkOsPUoQZAhDNP+6LY+RUwz/nVzedkF0S29NZ32QXdGv0=" 1577 evidence: 1578 type: array 1579 items: 1580 $ref: "#/components/schemas/Evidence" 1581 last_commit: 1582 type: object 1583 properties: 1584 height: 1585 type: integer 1586 round: 1587 type: integer 1588 block_id: 1589 $ref: "#/components/schemas/BlockID" 1590 signatures: 1591 type: array 1592 items: 1593 $ref: "#/components/schemas/Commit" 1594 1595 Evidence: 1596 type: object 1597 properties: 1598 type: 1599 type: string 1600 height: 1601 type: integer 1602 time: 1603 type: integer 1604 total_voting_power: 1605 type: integer 1606 validator: 1607 $ref: "#/components/schemas/Validator" 1608 1609 BlockComplete: 1610 type: object 1611 properties: 1612 block_id: 1613 $ref: "#/components/schemas/BlockID" 1614 block: 1615 $ref: "#/components/schemas/Block" 1616 BlockResponse: 1617 description: Blockc info 1618 allOf: 1619 - $ref: "#/components/schemas/JSONRPC" 1620 - type: object 1621 properties: 1622 result: 1623 $ref: "#/components/schemas/BlockComplete" 1624 1625 ################## FROM NOW ON NEEDS REFACTOR ################## 1626 BlockResultsResponse: 1627 type: object 1628 required: 1629 - "jsonrpc" 1630 - "id" 1631 - "result" 1632 properties: 1633 jsonrpc: 1634 type: string 1635 example: "2.0" 1636 id: 1637 type: integer 1638 example: 0 1639 result: 1640 type: object 1641 required: 1642 - "height" 1643 properties: 1644 height: 1645 type: string 1646 example: "12" 1647 txs_results: 1648 type: array 1649 nullable: true 1650 items: 1651 type: object 1652 properties: 1653 code: 1654 type: string 1655 example: "0" 1656 data: 1657 type: string 1658 example: "" 1659 log: 1660 type: string 1661 example: "not enough gas" 1662 info: 1663 type: string 1664 example: "" 1665 gas_wanted: 1666 type: string 1667 example: "100" 1668 gas_used: 1669 type: string 1670 example: "100" 1671 events: 1672 type: array 1673 nullable: true 1674 items: 1675 type: object 1676 properties: 1677 type: 1678 type: string 1679 example: "app" 1680 attributes: 1681 type: array 1682 nullable: false 1683 items: 1684 $ref: "#/components/schemas/Event" 1685 codespace: 1686 type: string 1687 example: "ibc" 1688 begin_block_events: 1689 type: array 1690 nullable: true 1691 items: 1692 type: object 1693 properties: 1694 type: 1695 type: string 1696 example: "app" 1697 attributes: 1698 type: array 1699 nullable: false 1700 items: 1701 $ref: "#/components/schemas/Event" 1702 end_block: 1703 type: array 1704 nullable: true 1705 items: 1706 type: object 1707 properties: 1708 type: 1709 type: string 1710 example: "app" 1711 attributes: 1712 type: array 1713 nullable: false 1714 items: 1715 $ref: "#/components/schemas/Event" 1716 validator_updates: 1717 type: array 1718 nullable: true 1719 items: 1720 type: object 1721 properties: 1722 pub_key: 1723 type: object 1724 required: 1725 - "type" 1726 - "value" 1727 properties: 1728 type: 1729 type: string 1730 example: "tendermint/PubKeyEd25519" 1731 value: 1732 type: string 1733 example: "9tK9IT+FPdf2qm+5c2qaxi10sWP+3erWTKgftn2PaQM=" 1734 power: 1735 type: string 1736 example: "300" 1737 consensus_params_updates: 1738 $ref: "#/components/schemas/ConsensusParams" 1739 1740 CommitResponse: 1741 type: object 1742 required: 1743 - "jsonrpc" 1744 - "id" 1745 - "result" 1746 properties: 1747 jsonrpc: 1748 type: string 1749 example: "2.0" 1750 id: 1751 type: integer 1752 example: 0 1753 result: 1754 required: 1755 - "signed_header" 1756 - "canonical" 1757 properties: 1758 signed_header: 1759 required: 1760 - "header" 1761 - "commit" 1762 properties: 1763 header: 1764 $ref: "#/components/schemas/BlockHeader" 1765 commit: 1766 required: 1767 - "height" 1768 - "round" 1769 - "block_id" 1770 - "signatures" 1771 properties: 1772 height: 1773 type: string 1774 example: "1311801" 1775 round: 1776 type: integer 1777 example: 0 1778 block_id: 1779 $ref: "#/components/schemas/BlockID" 1780 signatures: 1781 type: array 1782 items: 1783 type: object 1784 properties: 1785 block_id_flag: 1786 type: integer 1787 example: 2 1788 validator_address: 1789 type: string 1790 example: "000001E443FD237E4B616E2FA69DF4EE3D49A94F" 1791 timestamp: 1792 type: string 1793 example: "2019-04-22T17:01:58.376629719Z" 1794 signature: 1795 type: string 1796 example: "14jaTQXYRt8kbLKEhdHq7AXycrFImiLuZx50uOjs2+Zv+2i7RTG/jnObD07Jo2ubZ8xd7bNBJMqkgtkd0oQHAw==" 1797 type: object 1798 type: object 1799 canonical: 1800 type: boolean 1801 example: true 1802 type: object 1803 ValidatorsResponse: 1804 type: object 1805 required: 1806 - "jsonrpc" 1807 - "id" 1808 - "result" 1809 properties: 1810 jsonrpc: 1811 type: string 1812 example: "2.0" 1813 id: 1814 type: integer 1815 example: 0 1816 result: 1817 required: 1818 - "block_height" 1819 - "validators" 1820 properties: 1821 block_height: 1822 type: string 1823 example: "55" 1824 validators: 1825 type: array 1826 items: 1827 $ref: "#/components/schemas/ValidatorPriority" 1828 count: 1829 type: string 1830 example: "1" 1831 total: 1832 type: string 1833 example: "25" 1834 type: object 1835 GenesisResponse: 1836 type: object 1837 required: 1838 - "jsonrpc" 1839 - "id" 1840 - "result" 1841 properties: 1842 jsonrpc: 1843 type: string 1844 example: "2.0" 1845 id: 1846 type: integer 1847 example: 0 1848 result: 1849 type: object 1850 required: 1851 - "genesis" 1852 properties: 1853 genesis: 1854 type: object 1855 required: 1856 - "genesis_time" 1857 - "chain_id" 1858 - "initial_height" 1859 - "consensus_params" 1860 - "validators" 1861 - "app_hash" 1862 properties: 1863 genesis_time: 1864 type: string 1865 example: "2019-04-22T17:00:00Z" 1866 chain_id: 1867 type: string 1868 example: "cosmoshub-2" 1869 initial_height: 1870 type: string 1871 example: "2" 1872 consensus_params: 1873 $ref: "#/components/schemas/ConsensusParams" 1874 validators: 1875 type: array 1876 items: 1877 type: object 1878 properties: 1879 address: 1880 type: string 1881 example: "B00A6323737F321EB0B8D59C6FD497A14B60938A" 1882 pub_key: 1883 required: 1884 - "type" 1885 - "value" 1886 properties: 1887 type: 1888 type: string 1889 example: "tendermint/PubKeyEd25519" 1890 value: 1891 type: string 1892 example: "cOQZvh/h9ZioSeUMZB/1Vy1Xo5x2sjrVjlE/qHnYifM=" 1893 type: object 1894 power: 1895 type: string 1896 example: "9328525" 1897 name: 1898 type: string 1899 example: "Certus One" 1900 app_hash: 1901 type: string 1902 example: "" 1903 app_state: 1904 properties: {} 1905 type: object 1906 1907 GenesisChunkedResponse: 1908 type: object 1909 required: 1910 - "jsonrpc" 1911 - "id" 1912 - "result" 1913 properties: 1914 jsonrpc: 1915 type: string 1916 example: "2.0" 1917 id: 1918 type: integer 1919 example: 0 1920 result: 1921 required: 1922 - "chunk" 1923 - "total" 1924 - "data" 1925 properties: 1926 chunk: 1927 type: integer 1928 example: 0 1929 total: 1930 type: integer 1931 example: 1 1932 data: 1933 type: string 1934 example: "Z2VuZXNpcwo=" 1935 1936 DumpConsensusResponse: 1937 type: object 1938 required: 1939 - "jsonrpc" 1940 - "id" 1941 - "result" 1942 properties: 1943 jsonrpc: 1944 type: string 1945 example: "2.0" 1946 id: 1947 type: integer 1948 example: 0 1949 result: 1950 required: 1951 - "round_state" 1952 - "peers" 1953 properties: 1954 round_state: 1955 required: 1956 - "height" 1957 - "round" 1958 - "step" 1959 - "start_time" 1960 - "commit_time" 1961 - "validators" 1962 - "proposal" 1963 - "proposal_block" 1964 - "proposal_block_parts" 1965 - "locked_round" 1966 - "locked_block" 1967 - "locked_block_parts" 1968 - "valid_round" 1969 - "valid_block" 1970 - "valid_block_parts" 1971 - "votes" 1972 - "commit_round" 1973 - "last_commit" 1974 - "last_validators" 1975 - "triggered_timeout_precommit" 1976 properties: 1977 height: 1978 type: string 1979 example: "1311801" 1980 round: 1981 type: integer 1982 example: 0 1983 step: 1984 type: integer 1985 example: 3 1986 start_time: 1987 type: string 1988 example: "2019-08-05T11:28:49.064658805Z" 1989 commit_time: 1990 type: string 1991 example: "2019-08-05T11:28:44.064658805Z" 1992 validators: 1993 required: 1994 - "validators" 1995 - "proposer" 1996 properties: 1997 validators: 1998 type: array 1999 items: 2000 $ref: "#/components/schemas/ValidatorPriority" 2001 proposer: 2002 $ref: "#/components/schemas/ValidatorPriority" 2003 type: object 2004 locked_round: 2005 type: integer 2006 example: -1 2007 valid_round: 2008 type: string 2009 example: "-1" 2010 votes: 2011 type: array 2012 items: 2013 type: object 2014 properties: 2015 round: 2016 type: string 2017 example: "0" 2018 prevotes: 2019 type: array 2020 nullable: true 2021 items: 2022 type: string 2023 example: 2024 - "nil-Vote" 2025 - "Vote{19:46A3F8B8393B 1311801/00/1(Prevote) 000000000000 64CE682305CB @ 2019-08-05T11:28:47.374703444Z}" 2026 prevotes_bit_array: 2027 type: string 2028 example: "BA{100:___________________x________________________________________________________________________________} 209706/170220253 = 0.00" 2029 precommits: 2030 type: array 2031 nullable: true 2032 items: 2033 type: string 2034 example: 2035 - "nil-Vote" 2036 precommits_bit_array: 2037 type: string 2038 example: "BA{100:____________________________________________________________________________________________________} 0/170220253 = 0.00" 2039 commit_round: 2040 type: integer 2041 example: -1 2042 last_commit: 2043 nullable: true 2044 required: 2045 - "votes" 2046 - "votes_bit_array" 2047 - "peer_maj_23s" 2048 properties: 2049 votes: 2050 type: array 2051 items: 2052 type: string 2053 example: 2054 - "Vote{0:000001E443FD 1311800/00/2(Precommit) 3071ADB27D1A 77EE1B6B6847 @ 2019-08-05T11:28:43.810128139Z}" 2055 votes_bit_array: 2056 type: string 2057 example: "BA{100:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx} 170220253/170220253 = 1.00" 2058 peer_maj_23s: 2059 properties: {} 2060 type: object 2061 type: object 2062 last_validators: 2063 required: 2064 - "validators" 2065 - "proposer" 2066 properties: 2067 validators: 2068 type: array 2069 items: 2070 $ref: "#/components/schemas/ValidatorPriority" 2071 proposer: 2072 $ref: "#/components/schemas/ValidatorPriority" 2073 type: object 2074 triggered_timeout_precommit: 2075 type: boolean 2076 example: false 2077 type: object 2078 peers: 2079 type: array 2080 items: 2081 type: object 2082 properties: 2083 node_address: 2084 type: string 2085 example: "357f6a6c1d27414579a8185060aa8adf9815c43c@68.183.41.207:26656" 2086 peer_state: 2087 required: 2088 - "round_state" 2089 - "stats" 2090 properties: 2091 round_state: 2092 required: 2093 - "height" 2094 - "round" 2095 - "step" 2096 - "start_time" 2097 - "proposal" 2098 - "proposal_block_parts_header" 2099 - "proposal_block_parts" 2100 - "proposal_pol_round" 2101 - "proposal_pol" 2102 - "prevotes" 2103 - "precommits" 2104 - "last_commit_round" 2105 - "last_commit" 2106 - "catchup_commit_round" 2107 - "catchup_commit" 2108 properties: 2109 height: 2110 type: string 2111 example: "1311801" 2112 round: 2113 type: string 2114 example: "0" 2115 step: 2116 type: integer 2117 example: 3 2118 start_time: 2119 type: string 2120 example: "2019-08-05T11:28:49.21730864Z" 2121 proposal: 2122 type: boolean 2123 example: false 2124 proposal_block_parts_header: 2125 required: 2126 - "total" 2127 - "hash" 2128 properties: 2129 total: 2130 type: integer 2131 example: 0 2132 hash: 2133 type: string 2134 example: "" 2135 type: object 2136 proposal_pol_round: 2137 nullable: true 2138 type: integer 2139 example: -1 2140 proposal_pol: 2141 nullable: true 2142 type: string 2143 example: "____________________________________________________________________________________________________" 2144 prevotes: 2145 nullable: true 2146 type: string 2147 example: "___________________x________________________________________________________________________________" 2148 precommits: 2149 nullable: true 2150 type: string 2151 example: "____________________________________________________________________________________________________" 2152 last_commit_round: 2153 nullable: true 2154 type: integer 2155 example: 0 2156 last_commit: 2157 nullable: true 2158 type: string 2159 example: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" 2160 catchup_commit_round: 2161 type: integer 2162 nullable: true 2163 example: -1 2164 catchup_commit: 2165 nullable: true 2166 type: string 2167 example: "____________________________________________________________________________________________________" 2168 type: object 2169 stats: 2170 required: 2171 - "votes" 2172 - "block_parts" 2173 properties: 2174 votes: 2175 type: string 2176 example: "1159558" 2177 block_parts: 2178 type: string 2179 example: "4786" 2180 type: object 2181 type: object 2182 type: object 2183 2184 ConsensusStateResponse: 2185 type: object 2186 required: 2187 - "jsonrpc" 2188 - "id" 2189 - "result" 2190 properties: 2191 jsonrpc: 2192 type: string 2193 example: "2.0" 2194 id: 2195 type: integer 2196 example: 0 2197 result: 2198 required: 2199 - "round_state" 2200 properties: 2201 round_state: 2202 required: 2203 - "height/round/step" 2204 - "start_time" 2205 - "proposal_block_hash" 2206 - "locked_block_hash" 2207 - "valid_block_hash" 2208 - "height_vote_set" 2209 - "proposer" 2210 properties: 2211 height/round/step: 2212 type: string 2213 example: "1262197/0/8" 2214 start_time: 2215 type: string 2216 example: "2019-08-01T11:52:38.962730289Z" 2217 proposal_block_hash: 2218 type: string 2219 example: "634ADAF1F402663BEC2ABC340ECE8B4B45AA906FA603272ACC5F5EED3097E009" 2220 locked_block_hash: 2221 type: string 2222 example: "634ADAF1F402663BEC2ABC340ECE8B4B45AA906FA603272ACC5F5EED3097E009" 2223 valid_block_hash: 2224 type: string 2225 example: "634ADAF1F402663BEC2ABC340ECE8B4B45AA906FA603272ACC5F5EED3097E009" 2226 height_vote_set: 2227 type: array 2228 items: 2229 type: object 2230 properties: 2231 round: 2232 type: integer 2233 example: 0 2234 prevotes: 2235 type: array 2236 items: 2237 type: string 2238 example: 2239 - "Vote{0:000001E443FD 1262197/00/1(Prevote) 634ADAF1F402 7BB974E1BA40 @ 2019-08-01T11:52:35.513572509Z}" 2240 - "nil-Vote" 2241 prevotes_bit_array: 2242 type: string 2243 example: "BA{100:xxxxxxxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx} 169753436/170151262 = 1.00" 2244 precommits: 2245 type: array 2246 items: 2247 type: string 2248 example: 2249 - "Vote{5:18C78D135C9D 1262197/00/2(Precommit) 634ADAF1F402 8B5EFFFEABCD @ 2019-08-01T11:52:36.25600005Z}" 2250 - "nil-Vote" 2251 precommits_bit_array: 2252 type: string 2253 example: "BA{100:xxxxxx_xxxxx_xxxx_x_xxx_xx_xx_xx__x_x_x__xxxxxxxxxxxxxx_xxxx_xx_xxxxxx_xxxxxxxx_xxxx_xxx_x_xxxx__xxx} 118726247/170151262 = 0.70" 2254 proposer: 2255 type: object 2256 properties: 2257 address: 2258 type: string 2259 example: "D540AB022088612AC74B287D076DBFBC4A377A2E" 2260 index: 2261 type: integer 2262 example: 0 2263 type: object 2264 type: object 2265 2266 ConsensusParamsResponse: 2267 type: object 2268 required: 2269 - "jsonrpc" 2270 - "id" 2271 - "result" 2272 properties: 2273 jsonrpc: 2274 type: string 2275 example: "2.0" 2276 id: 2277 type: integer 2278 example: 0 2279 result: 2280 type: object 2281 required: 2282 - "block_height" 2283 - "consensus_params" 2284 properties: 2285 block_height: 2286 type: string 2287 example: "1" 2288 consensus_params: 2289 $ref: "#/components/schemas/ConsensusParams" 2290 2291 NumUnconfirmedTransactionsResponse: 2292 type: object 2293 required: 2294 - "jsonrpc" 2295 - "id" 2296 - "result" 2297 properties: 2298 jsonrpc: 2299 type: string 2300 example: "2.0" 2301 id: 2302 type: integer 2303 example: 0 2304 result: 2305 required: 2306 - "n_txs" 2307 - "total" 2308 - "total_bytes" 2309 properties: 2310 n_txs: 2311 type: string 2312 example: "31" 2313 total: 2314 type: string 2315 example: "82" 2316 total_bytes: 2317 type: string 2318 example: "19974" 2319 # txs: 2320 # type: array 2321 # nullable: true 2322 # items: 2323 # type: string 2324 # nullable: true 2325 # example: 2326 # - "gAPwYl3uCjCMTXENChSMnIkb5ZpYHBKIZqecFEV2tuZr7xIUA75/FmYq9WymsOBJ0XSJ8yV8zmQKMIxNcQ0KFIyciRvlmlgcEohmp5wURXa25mvvEhQbrvwbvlNiT+Yjr86G+YQNx7kRVgowjE1xDQoUjJyJG+WaWBwSiGannBRFdrbma+8SFK2m+1oxgILuQLO55n8mWfnbIzyPCjCMTXENChSMnIkb5ZpYHBKIZqecFEV2tuZr7xIUQNGfkmhTNMis4j+dyMDIWXdIPiYKMIxNcQ0KFIyciRvlmlgcEohmp5wURXa25mvvEhS8sL0D0wwgGCItQwVowak5YB38KRIUCg4KBXVhdG9tEgUxMDA1NBDoxRgaagom61rphyECn8x7emhhKdRCB2io7aS/6Cpuq5NbVqbODmqOT3jWw6kSQKUresk+d+Gw0BhjiggTsu8+1voW+VlDCQ1GRYnMaFOHXhyFv7BCLhFWxLxHSAYT8a5XqoMayosZf9mANKdXArA=" 2327 type: object 2328 2329 UnconfirmedTransactionsResponse: 2330 type: object 2331 required: 2332 - "jsonrpc" 2333 - "id" 2334 - "result" 2335 properties: 2336 jsonrpc: 2337 type: string 2338 example: "2.0" 2339 id: 2340 type: integer 2341 example: 0 2342 result: 2343 required: 2344 - "n_txs" 2345 - "total" 2346 - "total_bytes" 2347 - "txs" 2348 properties: 2349 n_txs: 2350 type: string 2351 example: "82" 2352 total: 2353 type: string 2354 example: "82" 2355 total_bytes: 2356 type: string 2357 example: "19974" 2358 txs: 2359 type: array 2360 nullable: true 2361 items: 2362 type: string 2363 nullable: true 2364 example: 2365 - "gAPwYl3uCjCMTXENChSMnIkb5ZpYHBKIZqecFEV2tuZr7xIUA75/FmYq9WymsOBJ0XSJ8yV8zmQKMIxNcQ0KFIyciRvlmlgcEohmp5wURXa25mvvEhQbrvwbvlNiT+Yjr86G+YQNx7kRVgowjE1xDQoUjJyJG+WaWBwSiGannBRFdrbma+8SFK2m+1oxgILuQLO55n8mWfnbIzyPCjCMTXENChSMnIkb5ZpYHBKIZqecFEV2tuZr7xIUQNGfkmhTNMis4j+dyMDIWXdIPiYKMIxNcQ0KFIyciRvlmlgcEohmp5wURXa25mvvEhS8sL0D0wwgGCItQwVowak5YB38KRIUCg4KBXVhdG9tEgUxMDA1NBDoxRgaagom61rphyECn8x7emhhKdRCB2io7aS/6Cpuq5NbVqbODmqOT3jWw6kSQKUresk+d+Gw0BhjiggTsu8+1voW+VlDCQ1GRYnMaFOHXhyFv7BCLhFWxLxHSAYT8a5XqoMayosZf9mANKdXArA=" 2366 type: object 2367 2368 TxSearchResponse: 2369 type: object 2370 required: 2371 - "jsonrpc" 2372 - "id" 2373 - "result" 2374 properties: 2375 jsonrpc: 2376 type: string 2377 example: "2.0" 2378 id: 2379 type: integer 2380 example: 0 2381 result: 2382 required: 2383 - "txs" 2384 - "total_count" 2385 properties: 2386 txs: 2387 type: array 2388 items: 2389 type: object 2390 properties: 2391 hash: 2392 type: string 2393 example: "D70952032620CC4E2737EB8AC379806359D8E0B17B0488F627997A0B043ABDED" 2394 height: 2395 type: string 2396 example: "1000" 2397 index: 2398 type: integer 2399 example: 0 2400 tx_result: 2401 required: 2402 - "log" 2403 - "gas_wanted" 2404 - "gas_used" 2405 - "tags" 2406 properties: 2407 log: 2408 type: string 2409 example: '[{"msg_index":"0","success":true,"log":""}]' 2410 gas_wanted: 2411 type: string 2412 example: "200000" 2413 gas_used: 2414 type: string 2415 example: "28596" 2416 tags: 2417 $ref: "#/components/schemas/Event" 2418 type: object 2419 tx: 2420 type: string 2421 example: "5wHwYl3uCkaoo2GaChQmSIu8hxpJxLcCuIi8fiHN4TMwrRIU/Af1cEG7Rcs/6LjTl7YjRSymJfYaFAoFdWF0b20SCzE0OTk5OTk1MDAwEhMKDQoFdWF0b20SBDUwMDAQwJoMGmoKJuta6YchAwswBShaB1wkZBctLIhYqBC3JrAI28XGzxP+rVEticGEEkAc+khTkKL9CDE47aDvjEHvUNt+izJfT4KVF2v2JkC+bmlH9K08q3PqHeMI9Z5up+XMusnTqlP985KF+SI5J3ZOIhhNYWRlIGJ5IENpcmNsZSB3aXRoIGxvdmU=" 2422 proof: 2423 required: 2424 - "RootHash" 2425 - "Data" 2426 - "Proof" 2427 properties: 2428 RootHash: 2429 type: string 2430 example: "72FE6BF6D4109105357AECE0A82E99D0F6288854D16D8767C5E72C57F876A14D" 2431 Data: 2432 type: string 2433 example: "5wHwYl3uCkaoo2GaChQmSIu8hxpJxLcCuIi8fiHN4TMwrRIU/Af1cEG7Rcs/6LjTl7YjRSymJfYaFAoFdWF0b20SCzE0OTk5OTk1MDAwEhMKDQoFdWF0b20SBDUwMDAQwJoMGmoKJuta6YchAwswBShaB1wkZBctLIhYqBC3JrAI28XGzxP+rVEticGEEkAc+khTkKL9CDE47aDvjEHvUNt+izJfT4KVF2v2JkC+bmlH9K08q3PqHeMI9Z5up+XMusnTqlP985KF+SI5J3ZOIhhNYWRlIGJ5IENpcmNsZSB3aXRoIGxvdmU=" 2434 Proof: 2435 required: 2436 - "total" 2437 - "index" 2438 - "leaf_hash" 2439 - "aunts" 2440 properties: 2441 total: 2442 type: string 2443 example: "2" 2444 index: 2445 type: string 2446 example: "0" 2447 leaf_hash: 2448 type: string 2449 example: "eoJxKCzF3m72Xiwb/Q43vJ37/2Sx8sfNS9JKJohlsYI=" 2450 aunts: 2451 type: array 2452 items: 2453 type: string 2454 example: 2455 - "eWb+HG/eMmukrQj4vNGyFYb3nKQncAWacq4HF5eFzDY=" 2456 type: object 2457 type: object 2458 total_count: 2459 type: string 2460 example: "2" 2461 type: object 2462 2463 DataCommitmentResponse: 2464 type: object 2465 required: 2466 - "jsonrpc" 2467 - "id" 2468 - "result" 2469 properties: 2470 jsonrpc: 2471 type: string 2472 example: "2.0" 2473 id: 2474 type: integer 2475 example: 0 2476 result: 2477 required: 2478 - "DataCommitment" 2479 properties: 2480 DataCommitment: 2481 type: string 2482 example: "D70952032620CC4E2737EB8AC379806359D8E0B17B0488F627997A0B043ABDED" 2483 description: the commitment is hex encoded 2484 type: object 2485 2486 DataRootInclusionProofResponse: 2487 type: object 2488 required: 2489 - "jsonrpc" 2490 - "id" 2491 - "result" 2492 properties: 2493 jsonrpc: 2494 type: string 2495 example: "2.0" 2496 id: 2497 type: integer 2498 example: 0 2499 result: 2500 required: 2501 - "Proof" 2502 properties: 2503 Proof: 2504 required: 2505 - "total" 2506 - "index" 2507 - "leaf_hash" 2508 - "aunts" 2509 properties: 2510 total: 2511 type: string 2512 example: "2" 2513 index: 2514 type: string 2515 example: "0" 2516 leaf_hash: 2517 type: string 2518 example: "eoJxKCzF3m72Xiwb/Q43vJ37/2Sx8sfNS9JKJohlsYI=" 2519 description: the leaf hash is base64 encoded 2520 aunts: 2521 type: array 2522 items: 2523 type: string 2524 example: 2525 - "eWb+HG/eMmukrQj4vNGyFYb3nKQncAWacq4HF5eFzDY=" 2526 description: the aunts are base64 encoded 2527 type: object 2528 type: object 2529 2530 TxResponse: 2531 type: object 2532 required: 2533 - "jsonrpc" 2534 - "id" 2535 - "result" 2536 properties: 2537 jsonrpc: 2538 type: string 2539 example: "2.0" 2540 id: 2541 type: integer 2542 example: 0 2543 result: 2544 required: 2545 - "hash" 2546 - "height" 2547 - "index" 2548 - "tx_result" 2549 - "tx" 2550 properties: 2551 hash: 2552 type: string 2553 example: "D70952032620CC4E2737EB8AC379806359D8E0B17B0488F627997A0B043ABDED" 2554 height: 2555 type: string 2556 example: "1000" 2557 index: 2558 type: integer 2559 example: 0 2560 tx_result: 2561 required: 2562 - "log" 2563 - "gas_wanted" 2564 - "gas_used" 2565 - "tags" 2566 properties: 2567 log: 2568 type: string 2569 example: '[{"msg_index":"0","success":true,"log":""}]' 2570 gas_wanted: 2571 type: string 2572 example: "200000" 2573 gas_used: 2574 type: string 2575 example: "28596" 2576 tags: 2577 type: array 2578 items: 2579 $ref: "#/components/schemas/Event" 2580 type: object 2581 tx: 2582 type: string 2583 example: "5wHwYl3uCkaoo2GaChQmSIu8hxpJxLcCuIi8fiHN4TMwrRIU/Af1cEG7Rcs/6LjTl7YjRSymJfYaFAoFdWF0b20SCzE0OTk5OTk1MDAwEhMKDQoFdWF0b20SBDUwMDAQwJoMGmoKJuta6YchAwswBShaB1wkZBctLIhYqBC3JrAI28XGzxP+rVEticGEEkAc+khTkKL9CDE47aDvjEHvUNt+izJfT4KVF2v2JkC+bmlH9K08q3PqHeMI9Z5up+XMusnTqlP985KF+SI5J3ZOIhhNYWRlIGJ5IENpcmNsZSB3aXRoIGxvdmU=" 2584 type: object 2585 2586 ABCIInfoResponse: 2587 type: object 2588 required: 2589 - "jsonrpc" 2590 - "id" 2591 properties: 2592 jsonrpc: 2593 type: string 2594 example: "2.0" 2595 id: 2596 type: integer 2597 example: 0 2598 result: 2599 required: 2600 - "response" 2601 properties: 2602 response: 2603 required: 2604 - "data" 2605 - "app_version" 2606 - "version" 2607 properties: 2608 data: 2609 type: string 2610 example: '{"size":0}' 2611 version: 2612 type: string 2613 example: "0.16.1" 2614 app_version: 2615 type: string 2616 example: "1314126" 2617 type: object 2618 type: object 2619 2620 ABCIQueryResponse: 2621 type: object 2622 required: 2623 - "error" 2624 - "result" 2625 - "id" 2626 - "jsonrpc" 2627 properties: 2628 error: 2629 type: string 2630 example: "" 2631 result: 2632 required: 2633 - "response" 2634 properties: 2635 response: 2636 required: 2637 - "log" 2638 - "height" 2639 - "proof" 2640 - "value" 2641 - "key" 2642 - "index" 2643 - "code" 2644 properties: 2645 log: 2646 type: string 2647 example: "exists" 2648 height: 2649 type: string 2650 example: "0" 2651 proof: 2652 type: string 2653 example: "010114FED0DAD959F36091AD761C922ABA3CBF1D8349990101020103011406AA2262E2F448242DF2C2607C3CDC705313EE3B0001149D16177BC71E445476174622EA559715C293740C" 2654 value: 2655 type: string 2656 example: "61626364" 2657 key: 2658 type: string 2659 example: "61626364" 2660 index: 2661 type: string 2662 example: "-1" 2663 code: 2664 type: string 2665 example: "0" 2666 type: object 2667 type: object 2668 id: 2669 type: integer 2670 example: 0 2671 jsonrpc: 2672 type: string 2673 example: "2.0" 2674 2675 BroadcastEvidenceResponse: 2676 type: object 2677 required: 2678 - "id" 2679 - "jsonrpc" 2680 properties: 2681 error: 2682 type: string 2683 example: "" 2684 result: 2685 type: string 2686 example: "" 2687 id: 2688 type: integer 2689 example: 0 2690 jsonrpc: 2691 type: string 2692 example: "2.0" 2693 2694 BroadcastTxCommitResponse: 2695 type: object 2696 required: 2697 - "error" 2698 - "result" 2699 - "id" 2700 - "jsonrpc" 2701 properties: 2702 error: 2703 type: string 2704 example: "" 2705 result: 2706 required: 2707 - "height" 2708 - "hash" 2709 - "deliver_tx" 2710 - "check_tx" 2711 properties: 2712 height: 2713 type: string 2714 example: "26682" 2715 hash: 2716 type: string 2717 example: "75CA0F856A4DA078FC4911580360E70CEFB2EBEE" 2718 deliver_tx: 2719 required: 2720 - "log" 2721 - "data" 2722 - "code" 2723 properties: 2724 log: 2725 type: string 2726 example: "" 2727 data: 2728 type: string 2729 example: "" 2730 code: 2731 type: string 2732 example: "0" 2733 type: object 2734 check_tx: 2735 required: 2736 - "log" 2737 - "data" 2738 - "code" 2739 properties: 2740 log: 2741 type: string 2742 example: "" 2743 data: 2744 type: string 2745 example: "" 2746 code: 2747 type: string 2748 example: "0" 2749 type: object 2750 type: object 2751 id: 2752 type: integer 2753 example: 0 2754 jsonrpc: 2755 type: string 2756 example: "2.0" 2757 2758 CheckTxResponse: 2759 type: object 2760 required: 2761 - "error" 2762 - "result" 2763 - "id" 2764 - "jsonrpc" 2765 properties: 2766 error: 2767 type: string 2768 example: "" 2769 result: 2770 required: 2771 - "log" 2772 - "data" 2773 - "code" 2774 properties: 2775 code: 2776 type: string 2777 example: "0" 2778 data: 2779 type: string 2780 example: "" 2781 log: 2782 type: string 2783 example: "" 2784 info: 2785 type: string 2786 example: "" 2787 gas_wanted: 2788 type: string 2789 example: "1" 2790 gas_used: 2791 type: string 2792 example: "0" 2793 events: 2794 type: array 2795 nullable: true 2796 items: 2797 type: object 2798 properties: 2799 type: 2800 type: string 2801 example: "app" 2802 attributes: 2803 type: array 2804 nullable: false 2805 items: 2806 $ref: "#/components/schemas/Event" 2807 codespace: 2808 type: string 2809 example: "bank" 2810 type: object 2811 id: 2812 type: integer 2813 example: 0 2814 jsonrpc: 2815 type: string 2816 example: "2.0" 2817 2818 BroadcastTxResponse: 2819 type: object 2820 required: 2821 - "jsonrpc" 2822 - "id" 2823 - "result" 2824 - "error" 2825 properties: 2826 jsonrpc: 2827 type: string 2828 example: "2.0" 2829 id: 2830 type: integer 2831 example: 0 2832 result: 2833 required: 2834 - "code" 2835 - "data" 2836 - "log" 2837 - "hash" 2838 properties: 2839 code: 2840 type: string 2841 example: "0" 2842 data: 2843 type: string 2844 example: "" 2845 log: 2846 type: string 2847 example: "" 2848 codespace: 2849 type: string 2850 example: "ibc" 2851 hash: 2852 type: string 2853 example: "0D33F2F03A5234F38706E43004489E061AC40A2E" 2854 type: object 2855 error: 2856 type: string 2857 example: "" 2858 2859 dialResp: 2860 type: object 2861 properties: 2862 Log: 2863 type: string 2864 example: "Dialing seeds in progress. See /net_info for details" 2865 2866 ###### Reusable types ###### 2867 2868 # Validator type with proposer priority 2869 ValidatorPriority: 2870 type: object 2871 properties: 2872 address: 2873 type: string 2874 example: "000001E443FD237E4B616E2FA69DF4EE3D49A94F" 2875 pub_key: 2876 required: 2877 - "type" 2878 - "value" 2879 properties: 2880 type: 2881 type: string 2882 example: "tendermint/PubKeyEd25519" 2883 value: 2884 type: string 2885 example: "9tK9IT+FPdf2qm+5c2qaxi10sWP+3erWTKgftn2PaQM=" 2886 type: object 2887 voting_power: 2888 type: string 2889 example: "239727" 2890 proposer_priority: 2891 type: string 2892 example: "-11896414" 2893 2894 # Stripped down validator 2895 Validator: 2896 type: object 2897 properties: 2898 pub_key: 2899 $ref: "#/components/schemas/PubKey" 2900 voting_power: 2901 type: integer 2902 address: 2903 type: string 2904 2905 # Consensus Params 2906 ConsensusParams: 2907 type: object 2908 nullable: true 2909 required: 2910 - "block" 2911 - "evidence" 2912 - "validator" 2913 properties: 2914 block: 2915 type: object 2916 required: 2917 - "max_bytes" 2918 - "max_gas" 2919 - "time_iota_ms" 2920 properties: 2921 max_bytes: 2922 type: string 2923 example: "22020096" 2924 max_gas: 2925 type: string 2926 example: "1000" 2927 time_iota_ms: 2928 type: string 2929 example: "1000" 2930 evidence: 2931 type: object 2932 required: 2933 - "max_age" 2934 properties: 2935 max_age: 2936 type: string 2937 example: "100000" 2938 validator: 2939 type: object 2940 required: 2941 - "pub_key_types" 2942 properties: 2943 pub_key_types: 2944 type: array 2945 items: 2946 type: string 2947 example: 2948 - "ed25519" 2949 2950 # Events in CometBFT 2951 Event: 2952 type: object 2953 properties: 2954 key: 2955 type: string 2956 example: "YWN0aW9u" 2957 value: 2958 type: string 2959 example: "c2VuZA==" 2960 index: 2961 type: boolean 2962 example: false 2963 2964 # Block Header 2965 BlockHeader: 2966 required: 2967 - "version" 2968 - "chain_id" 2969 - "height" 2970 - "time" 2971 - "last_block_id" 2972 - "last_commit_hash" 2973 - "data_hash" 2974 - "validators_hash" 2975 - "next_validators_hash" 2976 - "consensus_hash" 2977 - "app_hash" 2978 - "last_results_hash" 2979 - "evidence_hash" 2980 - "proposer_address" 2981 properties: 2982 version: 2983 required: 2984 - "block" 2985 - "app" 2986 properties: 2987 block: 2988 type: string 2989 example: "10" 2990 app: 2991 type: string 2992 example: "0" 2993 type: object 2994 chain_id: 2995 type: string 2996 example: "cosmoshub-2" 2997 height: 2998 type: string 2999 example: "12" 3000 time: 3001 type: string 3002 example: "2019-04-22T17:01:51.701356223Z" 3003 last_block_id: 3004 $ref: "#/components/schemas/BlockID" 3005 last_commit_hash: 3006 type: string 3007 example: "21B9BC845AD2CB2C4193CDD17BFC506F1EBE5A7402E84AD96E64171287A34812" 3008 data_hash: 3009 type: string 3010 example: "970886F99E77ED0D60DA8FCE0447C2676E59F2F77302B0C4AA10E1D02F18EF73" 3011 validators_hash: 3012 type: string 3013 example: "D658BFD100CA8025CFD3BECFE86194322731D387286FBD26E059115FD5F2BCA0" 3014 next_validators_hash: 3015 type: string 3016 example: "D658BFD100CA8025CFD3BECFE86194322731D387286FBD26E059115FD5F2BCA0" 3017 consensus_hash: 3018 type: string 3019 example: "0F2908883A105C793B74495EB7D6DF2EEA479ED7FC9349206A65CB0F9987A0B8" 3020 app_hash: 3021 type: string 3022 example: "223BF64D4A01074DC523A80E76B9BBC786C791FB0A1893AC5B14866356FCFD6C" 3023 last_results_hash: 3024 type: string 3025 example: "" 3026 evidence_hash: 3027 type: string 3028 example: "" 3029 proposer_address: 3030 type: string 3031 example: "D540AB022088612AC74B287D076DBFBC4A377A2E" 3032 type: object 3033 3034 BlockID: 3035 required: 3036 - "hash" 3037 - "parts" 3038 properties: 3039 hash: 3040 type: string 3041 example: "112BC173FD838FB68EB43476816CD7B4C6661B6884A9E357B417EE957E1CF8F7" 3042 parts: 3043 required: 3044 - "total" 3045 - "hash" 3046 properties: 3047 total: 3048 type: integer 3049 example: 1 3050 hash: 3051 type: string 3052 example: "38D4B26B5B725C4F13571EFE022C030390E4C33C8CF6F88EDD142EA769642DBD" 3053 type: object 3054 3055 BlockSearchResponse: 3056 type: object 3057 required: 3058 - "jsonrpc" 3059 - "id" 3060 - "result" 3061 properties: 3062 jsonrpc: 3063 type: string 3064 example: "2.0" 3065 id: 3066 type: integer 3067 example: 0 3068 result: 3069 required: 3070 - "blocks" 3071 - "total_count" 3072 properties: 3073 blocks: 3074 type: array 3075 items: 3076 $ref: "#/components/schemas/BlockComplete" 3077 total_count: 3078 type: integer 3079 example: 2 3080 type: object