github.com/Synthesix/Sia@v1.3.3-0.20180413141344-f863baeed3ca/doc/api/Transactionpool.md (about)

     1  Transaction Pool API
     2  =========
     3  
     4  This document contains detailed descriptions of the transaction pool's API
     5  routes. For an overview of the transaction pool's API routes, see
     6  [API.md#transactionpool](/doc/API.md#transactionpool).  For an overview of all
     7  API routes, see [API.md](/doc/API.md)
     8  
     9  There may be functional API calls which are not documented. These are not
    10  guaranteed to be supported beyond the current release, and should not be used
    11  in production.
    12  
    13  Overview
    14  --------
    15  
    16  The transaction pool provides endpoints for getting transactions currently in
    17  the transaction pool and submitting transactions to the transaction pool.
    18  
    19  Index
    20  -----
    21  
    22  | Route                                       | HTTP verb |
    23  | ------------------------------------------- | --------- |
    24  | [/tpool/confirmed/:id](#tpoolconfirmed-get) | GET       |
    25  | [/tpool/fee](#tpoolfee-get)                 | GET       |
    26  | [/tpool/raw/:id](#tpoolraw-get)             | GET       |
    27  | [/tpool/raw](#tpoolraw-post)                | POST      |
    28  
    29  #### /tpool/confirmed/:id [GET]
    30  
    31  returns whether the requested transaction has been seen on the blockchain.
    32  Note, however, that the block containing the transaction may later be
    33  invalidated by a reorg.
    34  
    35  ###### JSON Response
    36  ```javascript
    37  {
    38    "confirmed": true
    39  }
    40  ```
    41  
    42  #### /tpool/fee [GET]
    43  
    44  returns the minimum and maximum estimated fees expected by the transaction pool.
    45  
    46  ###### JSON Response
    47  ```javascript
    48  {
    49    "minimum": "1234", // hastings / byte
    50    "maximum": "5678"  // hastings / byte
    51  }
    52  ```
    53  
    54  #### /tpool/raw/:id [GET]
    55  
    56  returns the ID for the requested transaction and its raw encoded parents and transaction data.
    57  
    58  ###### JSON Response
    59  ```javascript
    60  {
    61  	// id of the transaction
    62  	"id": "124302d30a219d52f368ecd94bae1bfb922a3e45b6c32dd7fb5891b863808788",
    63  
    64  	// raw, base64 encoded transaction data
    65  	"transaction": "AQAAAAAAAADBM1ca/FyURfizmSukoUQ2S0GwXMit1iNSeYgrnhXOPAAAAAAAAAAAAQAAAAAAAABlZDI1NTE5AAAAAAAAAAAAIAAAAAAAAACdfzoaJ1MBY7L0fwm7O+BoQlFkkbcab5YtULa6B9aecgEAAAAAAAAAAQAAAAAAAAAMAAAAAAAAAAM7Ljyf0IA86AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAACgAAAAAAAACe0ZTbGbI4wAAAAAAAAAAAAAABAAAAAAAAAMEzVxr8XJRF+LOZK6ShRDZLQbBcyK3WI1J5iCueFc48AAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAA+z4P1wc98IqKxykTSJxiVT+BVbWezIBnIBO1gRRlLq2x/A+jIc6G7/BA5YNJRbdnqPHrzsZvkCv4TKYd/XzwBA==",
    66  	"parents": "AQAAAAAAAAABAAAAAAAAAJYYmFUdXXfLQ2p6EpF+tcqM9M4Pw5SLSFHdYwjMDFCjAAAAAAAAAAABAAAAAAAAAGVkMjU1MTkAAAAAAAAAAAAgAAAAAAAAAAHONvdzzjHfHBx6psAN8Z1rEVgqKPZ+K6Bsqp3FbrfjAQAAAAAAAAACAAAAAAAAAAwAAAAAAAAAAzvNDjSrme8gwAAA4w8ODnW8DxbOV/JribivvTtjJ4iHVOug0SXJc31BdSINAAAAAAAAAAPGHY4699vggx5AAAC2qBhm5vwPaBsmwAVPho/1Pd8ecce/+BGv4UimnEPzPQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAQAAAAAAAACWGJhVHV13y0NqehKRfrXKjPTOD8OUi0hR3WMIzAxQowAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABAAAAAAAAAABnt64wN1qxym/CfiMgOx5fg/imVIEhY+4IiiM7gwvSx8qtqKniOx50ekrGv8B+gTKDXpmm2iJibWTI9QLZHWAY=",
    67  }
    68  ```
    69  
    70  #### /tpool/raw [POST]
    71  
    72  submits a raw transaction to the transaction pool, broadcasting it to the transaction pool's peers.
    73  
    74  ###### Query String Parameters [(with comments)](/doc/api/Transactionpool.md#query-string-parameters)
    75  
    76  ```
    77  parents     string // raw base64 encoded transaction parents
    78  transaction string // raw base64 encoded transaction
    79  ```
    80  
    81  ###### Response
    82  standard success or error response. See
    83  [#standard-responses](#standard-responses).
    84