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