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

lightwallet_rest.md: mark types in tables with backticks

Browse source
This commit is contained in:
Chad Perrin 2021-03-25 13:04:28 -07:00
parent 9afcf4328f
commit c83b8122b6
1 changed files with 123 additions and 123 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

218
api/lightwallet_rest.md
View file

@ -58,19 +58,19 @@ A standard Monero public address encoded as a string in JSON.
Information needed to spend an output.
| Field | Type | Description |
|------------------|-------------------|-------------------------------|
| tx_id | uint64 | Index of tx in blockchain |
| amount | uint64-string | XMR value of output |
| index | uint16 | Index within vout vector |
| global_index | uint64-string | Index within amount |
| rct | binary | Bytes of ringct data |
| tx_hash | binary | Bytes of tx hash |
| tx_prefix_hash | binary | Bytes of tx prefix hash |
| public_key | binary | Bytes of output public key |
| tx_pub_key | binary | Bytes of the tx public key |
| spend_key_images | array of binaries | Bytes of key images |
| timestamp | timestamp | Timestamp of containing block |
| height | uint64 | Containing block height |
|------------------|---------------------------|-------------------------------|
| tx_id | `uint64` | Index of tx in blockchain |
| amount | `uint64-string` | XMR value of output |
| index | `uint16` | Index within vout vector |
| global_index | `uint64-string` | Index within amount |
| rct | `binary` | Bytes of ringct data |
| tx_hash | `binary` | Bytes of tx hash |
| tx_prefix_hash | `binary` | Bytes of tx prefix hash |
| public_key | `binary` | Bytes of output public key |
| tx_pub_key | `binary` | Bytes of the tx public key |
| spend_key_images | array of `binary` objects | Bytes of key images |
| timestamp | `timestamp` | Timestamp of containing block |
| height | `uint64` | Containing block height |
> `tx_id` is determined by the monero daemon. It is the offset that a
> transaction appears in the blockchain from the genesis block.
@ -93,28 +93,28 @@ Information needed to spend an output.
**rates** object
| Field | Type | Description |
|-------|---------|-----------------------|
| AUD * | float32 | AUD/XMR exchange rate |
| BRL * | float32 | BRL/XMR exchange rate |
| BTC * | float32 | BTC/XMR exchange rate |
| CAD * | float32 | CAD/XMR exchange rate |
| CHF * | float32 | CHF/XMR exchange rate |
| CNY * | float32 | CNY/XMR exchange rate |
| EUR * | float32 | EUR/XMR exchange rate |
| GBP * | float32 | GBP/XMR exchange rate |
| HKD * | float32 | HKD/XMR exchange rate |
| INR * | float32 | INR/XMR exchange rate |
| JPY * | float32 | JPY/XMR exchange rate |
| KRW * | float32 | KRW/XMR exhcnage rate |
| MXN * | float32 | MXN/XMR exchange rate |
| NOK * | float32 | NOK/XMR exchange rate |
| NZD * | float32 | NZD/XMR exchange rate |
| SEK * | float32 | SEK/XMR exchange rate |
| SGD * | float32 | SGD/XMR exchange rate |
| TRY * | float32 | TRY/XMR exchange rate |
| USD * | float32 | USD/XMR exchange rate |
| RUB * | float32 | RUB/XMR exchange rate |
| ZAR * | float32 | ZAR/XMR exchange rate |
|-------|-----------|-----------------------|
| AUD * | `float32` | AUD/XMR exchange rate |
| BRL * | `float32` | BRL/XMR exchange rate |
| BTC * | `float32` | BTC/XMR exchange rate |
| CAD * | `float32` | CAD/XMR exchange rate |
| CHF * | `float32` | CHF/XMR exchange rate |
| CNY * | `float32` | CNY/XMR exchange rate |
| EUR * | `float32` | EUR/XMR exchange rate |
| GBP * | `float32` | GBP/XMR exchange rate |
| HKD * | `float32` | HKD/XMR exchange rate |
| INR * | `float32` | INR/XMR exchange rate |
| JPY * | `float32` | JPY/XMR exchange rate |
| KRW * | `float32` | KRW/XMR exhcnage rate |
| MXN * | `float32` | MXN/XMR exchange rate |
| NOK * | `float32` | NOK/XMR exchange rate |
| NZD * | `float32` | NZD/XMR exchange rate |
| SEK * | `float32` | SEK/XMR exchange rate |
| SGD * | `float32` | SGD/XMR exchange rate |
| TRY * | `float32` | TRY/XMR exchange rate |
| USD * | `float32` | USD/XMR exchange rate |
| RUB * | `float32` | RUB/XMR exchange rate |
| ZAR * | `float32` | ZAR/XMR exchange rate |
> If an exchange rate is unavailable, the server field shall omit the field
> from the JSON object.
@ -122,12 +122,12 @@ Information needed to spend an output.
**spend** object
| Field | Type | Description |
|------------|---------------|----------------------------|
| amount | uint64-string | XMR possibly being spent |
| key_image | binary | Bytes of the key image |
| tx_pub_key | binary | Bytes of the tx public key |
| out_index | uint16 | Index of source output |
| mixin | uint32 | Mixin of the spend |
|------------|-----------------|----------------------------|
| amount | `uint64-string` | XMR possibly being spent |
| key_image | `binary` | Bytes of the key image |
| tx_pub_key | `binary` | Bytes of the tx public key |
| out_index | `uint16` | Index of source output |
| mixin | `uint32` | Mixin of the spend |
> `out_index` is a zero-based offset from the original received output. The
> variable within the monero codebase is the `vout` array, this is the index
@ -144,18 +144,18 @@ blockchain timestamps do not have sub-seconds.
| Field | Type | Description |
|----------------|-----------------|---------------------------|
| id | uint64 | Index of tx in blockchain |
| hash | binary | Bytes of tx hash |
| timestamp * | timestamp | Timestamp of block |
| total_received | uint64-string | Total XMR received |
| total_sent | uint64-string | XMR possibly being spent |
| unlock_time | uint64 | Tx unlock time field |
| height * | uint64 | Block height |
| id | `uint64` | Index of tx in blockchain |
| hash | `binary` | Bytes of tx hash |
| timestamp * | `timestamp` | Timestamp of block |
| total_received | `uint64-string` | Total XMR received |
| total_sent | `uint64-string` | XMR possibly being spent |
| unlock_time | `uint64` | Tx unlock time field |
| height * | `uint64` | Block height |
| spent_outputs | array of spends | List of possible spends |
| payment_id * | binary | Bytes of tx payment id |
| coinbase | boolean | True if tx is coinbase |
| mempool | boolean | True if tx is in mempool |
| mixin | uint32 | Mixin of the receive |
| payment_id * | `binary` | Bytes of tx payment id |
| coinbase | `boolean` | True if tx is coinbase |
| mempool | `boolean` | True if tx is in mempool |
| mixin | `uint32` | Mixin of the receive |
> `id` is determined by the monero daemon. It is the offset that a
> transaction appears in the blockchain from the genesis block.
@ -187,10 +187,10 @@ exceed 2^53 - all numbers are 64-bit floats in JavaScript.
**random_output** object
| Field | Type | Description |
|--------------|---------------|------------------------------------|
| global_index | uint64-string | Index within amount |
| public_key | bytes | Bytes of output public key |
| rct | bytes | Bytes containing ringct commitment |
|--------------|-----------------|------------------------------------|
| global_index | `uint64-string` | Index within amount |
| public_key | `bytes` | Bytes of output public key |
| rct | `bytes` | Bytes containing ringct commitment |
> `global_index` is determined by the monero daemon. It is the offset from the
> first time the amount appeared in the blockchain. After ringct, this is the
@ -202,7 +202,7 @@ Randomly selected outputs for use in a ring signature.
| Field | Type | Description |
|-----------|-------------------------|-------------------------|
| amount | uint64-string | XMR amount, 0 if ringct |
| amount | `uint64-string` | XMR amount, 0 if ringct |
| outputs * | array of random_outputs | Selected outputs |
> `outputs` is omitted by the server if the `amount` does not have enough
@ -217,9 +217,9 @@ list of candidate spends is returned.
**Request** object
| Field | Type | Description |
|-----------|----------------|---------------------------------------|
| address | base58-address | Address to retrieve |
| view_key | binary | View key bytes for authorization |
|-----------|------------------|---------------------------------------|
| address | `base58-address` | Address to retrieve |
| view_key | `binary` | View key bytes for authorization |
> If `address` is not authorized, the server must return a HTTP 403
> "Forbidden" error.
@ -228,14 +228,14 @@ list of candidate spends is returned.
| Field | Type | Description |
|----------------------|-----------------|---------------------------|
| locked_funds | uint64-string | Sum of unspendable XMR |
| total_received | uint64-string | Sum of received XMR |
| total_sent | uint64-string | Sum of possibly spent XMR |
| scanned_height | uint64 | Current tx scan progress |
| scanned_block_height | uint64 | Current scan progress |
| start_height | uint64 | Start height of response |
| transaction_height | uint64 | Total txes sent in Monero |
| blockchain_height | uint64 | Current blockchain height |
| locked_funds | `uint64-string` | Sum of unspendable XMR |
| total_received | `uint64-string` | Sum of received XMR |
| total_sent | `uint64-string` | Sum of possibly spent XMR |
| scanned_height | `uint64` | Current tx scan progress |
| scanned_block_height | `uint64` | Current scan progress |
| start_height | `uint64` | Start height of response |
| transaction_height | `uint64` | Total txes sent in Monero |
| blockchain_height | `uint64` | Current blockchain height |
| spent_outputs | array of spends | Possible spend info |
| rates * | rates | Current exchange rates |
@ -249,9 +249,9 @@ spends is returned.
**Request** object
| Field | Type | Description |
|----------|----------------|---------------------------------------|
| address | base58-address | Address to retrieve |
| view_key | binary | View key bytes for authorization |
|----------|------------------|---------------------------------------|
| address | `base58-address` | Address to retrieve |
| view_key | `binary` | View key bytes for authorization |
> If `address` is not authorized, the server must return a HTTP 403
> "Forbidden" error.
@ -260,11 +260,11 @@ spends is returned.
| Field | Type | Description |
|----------------------|-----------------------|---------------------------|
| total_received | uint64-string | Sum of received outputs |
| scanned_height | uint64 | Current tx scan progress |
| scanned_block_height | uint64 | Current scan progress |
| start_height | uint64 | Start height of response |
| blockchain_height | uint64 | Current blockchain height |
| total_received | `uint64-string` | Sum of received outputs |
| scanned_height | `uint64` | Current tx scan progress |
| scanned_block_height | `uint64` | Current scan progress |
| start_height | `uint64` | Start height of response |
| blockchain_height | `uint64` | Current blockchain height |
| transactions | array of transactions | Possible spend info |
#### `get_random_outs`
@ -279,9 +279,9 @@ locally select outputs using a triangular distribution
**Request** object
| Field | Type | Description |
|------------|-------------------------|----------------------------------|
| count | uint32 | Mixin (name is historical) |
| amounts | array of uint64-strings | XMR amounts that need mixing |
|------------|---------------------------|----------------------------------|
| count | `uint32` | Mixin (name is historical) |
| amounts | array of `uint64-strings` | XMR amounts that need mixing |
> Clients must use amount `0` when computing a ringct output.
@ -306,13 +306,13 @@ was actually spent.
**Request** object
| Field | Type | Description |
|------------------|----------------|----------------------------------|
| address | base58-address | Address to create/probe |
| view_key | binary | View key bytes |
| amount | uint64-string | XMR send amount |
| mixin | uint32 | Minimum mixin for source output |
| use_dust | boolean | Return all available outputs |
| dust_threshold * | uint64-string | Ignore outputs below this amount |
|------------------|------------------|----------------------------------|
| address | `base58-address` | Address to create/probe |
| view_key | `binary` | View key bytes |
| amount | `uint64-string` | XMR send amount |
| mixin | `uint32` | Minimum mixin for source output |
| use_dust | `boolean` | Return all available outputs |
| dust_threshold * | `uint64-string` | Ignore outputs below this amount |
> If the total received outputs for the address is less than `amount`, the
> server shall return a HTTP 400 "Bad Request" error code.
@ -321,9 +321,9 @@ was actually spent.
| Field | Type | Description |
|--------------|------------------|-----------------------------------------|
| per_byte_fee | uint64-string | Estimated network fee |
| fee_mask | uint64-string | Fee quantization mask |
| amount | uint64-string | The total value in outputs |
| per_byte_fee | `uint64-string` | Estimated network fee |
| fee_mask | `uint64-string` | Fee quantization mask |
| amount | `uint64-string` | The total value in outputs |
| outputs | array of outputs | Outputs possibly available for spending |
#### `import_request`
@ -339,13 +339,13 @@ Request an account scan from the genesis block.
**Response** object
| Field | Type | Description |
|--------------------|----------------|----------------------------------|
| payment_address * | base58-address | Payment location |
| payment_id * | binary | Bytes for payment_id tx field |
| import_fee * | uint64-string | Fee required to complete request |
| new_request | boolean | New or existing request |
| request_fulfilled | boolean | Indicates success |
| status | string | Custom message |
|--------------------|------------------|----------------------------------|
| payment_address * | `base58-address` | Payment location |
| payment_id * | `binary` | Bytes for payment_id tx field |
| import_fee * | `uint64-string` | Fee required to complete request |
| new_request | `boolean` | New or existing request |
| request_fulfilled | `boolean` | Indicates success |
| status | `string` | Custom message |
> `payment_id`, `import_fee`, and `payment_address` may be omitted if the
> client does not need to send XMR to complete the request.
@ -356,11 +356,11 @@ Check for the existence of an account or create a new one.
**Request** object
| Field | Type | Description |
|-------------------|----------------|----------------------------------|
| address | base58-address | Address to create/probe |
| view_key | binary | View key bytes |
| create_account | boolean | Try to create new account |
| generated_locally | boolean | Indicate that the address is new |
|-------------------|------------------|----------------------------------|
| address | `base58-address` | Address to create/probe |
| view_key | `binary` | View key bytes |
| create_account | `boolean` | Try to create new account |
| generated_locally | `boolean` | Indicate that the address is new |
> The view key bytes are required even if an account is not being created, to
> prevent metadata leakage.
@ -375,10 +375,10 @@ Check for the existence of an account or create a new one.
**Response** object
| Field | Type | Description |
|---------------------|---------|------------------------------------|
| new_address | boolean | Whether account was just created |
| generated_locally * | boolean | Flag from initial account creation |
| start_height * | uint64 | Account scanning start block |
|---------------------|-----------|------------------------------------|
| new_address | `boolean` | Whether account was just created |
| generated_locally * | `boolean` | Flag from initial account creation |
| start_height * | `uint64` | Account scanning start block |
#### `submit_raw_tx`
Submit raw transaction to be relayed to monero network.
@ -386,8 +386,8 @@ Submit raw transaction to be relayed to monero network.
**Request** object
| Field | Type | Description |
|------------|----------------|-----------------------------------------------------------|
| tx | binary | Raw transaction bytes, in format used by daemon p2p comms |
|-------|----------|-----------------------------------------------------------|
| tx | `binary` | Raw transaction bytes, in format used by daemon p2p comms |
> This format is tricky unfortunately, it is custom to the monero daemon. The
> internal code of `monerod` must be read to determine this format currently.
@ -395,8 +395,8 @@ Submit raw transaction to be relayed to monero network.
**Response** object
| Field | Type | Description |
|--------|--------|-----------------|
| status | string | Status of relay |
|--------|----------|-----------------|
| status | `string` | Status of relay |
> `status` is typically the response by the monero daemon attempting to relay
> the transaction.