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