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