monero-project/meta
monero-project/meta
1
0
Fork 0
mirror of https://github.com/monero-project/meta.git synced 2024-12-22 19:49:23 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Support retrieving newer txs only in lightwallet REST API

Browse source
This commit is contained in:
Nathan Dorfman 2021-08-22 18:41:20 -06:00
parent 37b5fc40ea
commit c69240e0ab
1 changed files with 39 additions and 19 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
api/lightwallet_rest.md
View file

@ -143,7 +143,7 @@ blockchain timestamps do not have sub-seconds.
**transaction** object
| Field | Type | Description |
|----------------|--------------------------|---------------------------|
|----------------|--------------------------|-------------------------------|
| id | `uint64` | Index of tx in blockchain |
| hash | `binary` | Bytes of tx hash |
| timestamp * | `timestamp` | Timestamp of block |
@ -151,6 +151,7 @@ blockchain timestamps do not have sub-seconds.
| total_sent | `uint64-string` | XMR possibly being spent |
| unlock_time | `uint64` | Tx unlock time field |
| height * | `uint64` | Block height |
| block_hash * | `binary` | Bytes of this tx's block hash |
| spent_outputs | array of `spend` objects | List of possible spends |
| payment_id * | `binary` | Bytes of tx payment id |
| coinbase | `boolean` | True if tx is coinbase |
@ -160,7 +161,7 @@ blockchain timestamps do not have sub-seconds.
> `id` is determined by the monero daemon. It is the offset that a
> transaction appears in the blockchain from the genesis block.
> `timestamp` and `height` are not sent when `mempool` is true.
> `timestamp`, `height` and `block_hash` are not sent when `mempool` is true.
> `hash` is determined by how the monero core computes the hash.
@ -249,17 +250,27 @@ spends is returned.
**Request** object
| Field | Type | Description |
|----------|------------------|---------------------------------------|
|-----------------------|------------------|----------------------------------------|
| address | `base58-address` | Address to retrieve |
| view_key | `binary` | View key bytes for authorization |
| since_tx_id * | `uint64` | Most recent tx already known to client |
| since_tx_block_hash * | `binary` | Block hash of most recent tx |
> If `address` is not authorized, the server must return a HTTP 403
> "Forbidden" error.
> `since_tx_id` and `since_tx_block_hash` may be omitted, in which case all
> transactions are returned. If `since_tx_id` is present, `since_tx_block_hash`
> must be, too. The latter is used to handle the case when a blockchain reorg
> has rendered the requested `since_tx_id` invalid. Clients must take care to honor
> the `since_tx_id` returned in the response, which may be different than the
> value that was in the request.
**Response** object
| Field | Type | Description |
|----------------------|--------------------------------|---------------------------|
| since_tx_id * | `uint64` | Most recent omitted tx |
| total_received | `uint64-string` | Sum of received outputs |
| scanned_height | `uint64` | Current tx scan progress |
| scanned_block_height | `uint64` | Current scan progress |
@ -267,6 +278,15 @@ spends is returned.
| blockchain_height | `uint64` | Current blockchain height |
| transactions | array of `transaction` objects | Possible spend info |
> `since_tx_id` may be omitted, and shall be omitted if omitted in the request.
> If present, it indicates that this response includes only transactions with
> an `id` greater than this one. It may be different than the value in the
> `request`: if a blockchain reorg has rendered the requested id/block_hash
> pair invalid, then some or all of the prior transaction history must be
> resent. Clients must remove all newer transactions from their local history
> before appending the ones from this response. If null or omitted, the
> response contains every transaction.
#### `get_random_outs`
Selects random outputs to use in a ring signature of a new transaction. If the
`amount` is `0` then the `monerod` RPC `get_output_distribution` should be used