diff --git a/_api_docs/core_add_transaction.md b/_api_docs/core_add_transaction.md index 4118a16..d04fce7 100644 --- a/_api_docs/core_add_transaction.md +++ b/_api_docs/core_add_transaction.md @@ -23,6 +23,7 @@ Note: If using the `primaryAddress` parameter, the chosen address (public key) m | primaryAddress | String | No | Specify if the node is using a wallet with multiple keypairs in order to select the keypair (public key) which will be used to sign the transaction. The chosen primary address must be a valid signer for all addresses listed in the `from` field. | | fee | Number | No | Transaction fee, specified in IxiCash per kB. If no fee parameter is specified, the default (which is also the minimum) 0.00005 IxiCash per kB will be used. | | autofee | Boolean | No | If specified, the system will automatically deduct the required fee from the first address given in `from`. This parameter is not required if you have included the appropriate fees somewhere in the `from` list, or are not specifying the `from` list at all. | +| wallet | String | No | Base58 Primary Wallet address in case multiple wallets are being used. | ### Output: - success: transaction details are returned as a JSON object and the error field is set to null: @@ -36,35 +37,36 @@ Note: If using the `primaryAddress` parameter, the chosen address (public key) m | RPC_INVALID_PARAMS | Invalid `from` amounts, or invalid `to` amounts were specified. | | RPC_VERIFY_ERROR | The transaction does not pass verification - this usually means that no usable `"from"` addresses were present, or there was something wrong with the signing key. | | RPC_WALLET_INSUFFICIENT_FUNDS | Address or addresses specified have insufficient balance to be used for the transaction. | -| RPC_INTERNAL_ERROR | An unexpected error occured within the node. Please see the node log for details. | +| RPC_INTERNAL_ERROR | An unexpected error occurred within the node. Please see the node log for details. | ### Example: GET http://localhost:8081/addtransaction?from=1JKZFqQs4yiH6Dq4bfom7xcpL6zG53DrjcY6HD9QJ6cRWmXdq_10000-1PC5kubyLvTmsf16CugqHpBG8B8PK4YjcfSjjLMqbUi8YvkQ_5000&to=153xXfVi1sznPcRqJur8tutgrZecNVYGSzetp47bQvRfNuDix_15000&autofee=true ``` { - "result": { - "id": "15-CoxywacZbqiK1sf84R6nuYyW32u5sDbTqD4VZgpeGChw", - "version": 2, - "blockHeight": "15", - "nonce": "47961", - "signature": "537b1..0c2ce2d7c2", - "pubKey": "1FUryQwQL5bs83yxnf5ywkkBDZjV6XezBz5BmMX5ioCRsRVmj", - "timeStamp": "1547587273", - "type": "0", - "amount": "1000.00000000", - "applied": "0", - "checksum": "0765a87d5393ad8742de1f8a9ce39f2ae1f1a5a6e7bafc066e454c1856661326", - "from": { - "1":"10000.00005000", - "2":"5000.00000000" - }, - "to": { - "153xXfVi1sznPcRqJur8tutgrZecNVYGSzetp47bQvRfNuDix": "15000.00000000" - }, - "fee": "0.00005000" - }, - "error": null, - "id": null + "result": { + "id": "11-284bKK4GvGV9stfEGqu1CP4A9T3tTzrbkUsUd2JestPVE3KDPM5Um7sn3Dfv4", + "version": 7, + "blockHeight": "11", + "nonce": "313950", + "signature": "54b6315260a94dfec4...a166a16472040dae03", + "pubKey": "JHgSS7hbUNnYWsqz8m...wi5i2EPPWjtyTRYRN", + "timestamp": "1711936575", + "type": "0", + "amount": "515000.00000000", + "applied": "0", + "checksum": "c81b2017498e7c838d1d2d960c80e2c18a102959680414dd37ef143bcc777d7796b171d873683f93425a91fd", + "from": { + "1": "515000.01000000" + }, + "to": { + "153xXfVi1sznPcRqJur8tutgrZecNVYGSzetp47bQvRfNuDix": "15000.00000000", + "4L5vswa8yS9VKsZzDJ2ry9gWY7KQon5bkvhG1CUuepkwvcy1xQmLsHA9DPmCDbufr": "500000.00000000" + }, + "fee": "0.01000000", + "totalAmount": "515000.01000000" + } + "error": null, + "id": null } ``` \ No newline at end of file diff --git a/_api_docs/core_blacklist_peer.md b/_api_docs/core_blacklist_peer.md new file mode 100644 index 0000000..348bfb4 --- /dev/null +++ b/_api_docs/core_blacklist_peer.md @@ -0,0 +1,34 @@ +--- +title: Blacklist Peer +type: core +--- +## Blacklist Peer +Blacklists peer. + +### Method: `blacklistPeer` +### Input parameters: + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| host | String | No | Host address to blacklist. | +| wallet | String | No | Base58 Wallet address of host to blacklist. | + + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- a JSON object with "OK" in result field on success. + +### Example: +GET http://localhost:8081/blacklistPeer +``` +{ + "result": "OK", + "error": null, + "id": null +} +``` diff --git a/_api_docs/core_block_height.md b/_api_docs/core_block_height.md index 7d4ed42..97968db 100644 --- a/_api_docs/core_block_height.md +++ b/_api_docs/core_block_height.md @@ -13,7 +13,7 @@ None | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - success: number of Ixian blocks since the Genesis block diff --git a/_api_docs/core_calculate_transaction_fee.md b/_api_docs/core_calculate_transaction_fee.md index 4b39d13..57629f2 100644 --- a/_api_docs/core_calculate_transaction_fee.md +++ b/_api_docs/core_calculate_transaction_fee.md @@ -19,6 +19,7 @@ Note: If using the `primaryAddress` parameter, the chosen address (public key) m | from | String | No | List of Base58 encoded sending addresses with their amounts. Amounts are separated by '_' character. Addresses are separated by '-' character (i.e. address1_amount1-address2_amount2). All addresses must belong to the same private key. If no from parameter is specified, it will be automatically generated, where the addresses with least IxiCash will be spent first. | | primaryAddress | String | No | Specify if the node is using a wallet with multiple keypairs in order to select the keypair (public key) which will be used to sign the transaction. The chosen primary address must be a valid signer for all addresses listed in the `from` field. | | fee | Number | No | Transaction fee, specified in IxiCash per kB. If no fee parameter is specified, the default (which is also the minimum) 0.00005 IxiCash per kB will be used. | +| wallet | String | No | Base58 Primary Wallet address in case multiple wallets are being used. | ### Output: - success: required total transaction fee is calculated and returned as a number in result. @@ -32,8 +33,8 @@ Note: If using the `primaryAddress` parameter, the chosen address (public key) m | RPC_INVALID_PARAMS | Invalid `from` amounts, or invalid `to` amounts were specified. | | RPC_VERIFY_ERROR | The transaction does not pass verification - this usually means that no usable `from` addresses were present, or there was something wrong with the signing key. | | RPC_WALLET_INSUFFICIENT_FUNDS | Address or addresses specified have insufficient balance to be used for the transaction. | -| RPC_TRANSACTION_ERROR | An error occured while adding the transaction, check the message and log file for details. | -| RPC_INTERNAL_ERROR | An unexpected error occured within the node. Please see the node log for details. | +| RPC_TRANSACTION_ERROR | An error occurred while adding the transaction, check the message and log file for details. | +| RPC_INTERNAL_ERROR | An unexpected error occurred within the node. Please see the node log for details. | ### Example: GET http://localhost:8081/calculatetransactionfee?from=1JKZFqQs4yiH6Dq4bfom7xcpL6zG53DrjcY6HD9QJ6cRWmXdq_10000-1PC5kubyLvTmsf16CugqHpBG8B8PK4YjcfSjjLMqbUi8YvkQ_5000&to=153xXfVi1sznPcRqJur8tutgrZecNVYGSzetp47bQvRfNuDix_15000 diff --git a/_api_docs/core_clear_peer_blacklist.md b/_api_docs/core_clear_peer_blacklist.md new file mode 100644 index 0000000..5db0a14 --- /dev/null +++ b/_api_docs/core_clear_peer_blacklist.md @@ -0,0 +1,29 @@ +--- +title: Clear Peer Blacklist +type: core +--- +## Clear Peer Blacklist +Clears peer blacklist. + +### Method: `clearPeerBlacklist` +### Input parameters: +None. + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- a JSON object with "OK" in result field on success. + +### Example: +GET http://localhost:8081/clearPeerBlacklist +``` +{ + "result": "OK", + "error": null, + "id": null +} +``` diff --git a/_api_docs/core_clients.md b/_api_docs/core_clients.md index acb29bd..6cd643c 100644 --- a/_api_docs/core_clients.md +++ b/_api_docs/core_clients.md @@ -12,7 +12,7 @@ None | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - success: list of clients JSON-encoded in the result field with the error field set to null diff --git a/_api_docs/core_connect.md b/_api_docs/core_connect.md index e2a5ac4..f245ced 100644 --- a/_api_docs/core_connect.md +++ b/_api_docs/core_connect.md @@ -19,7 +19,7 @@ Note: The `to` parameter must include both a host address and a port. The host a | Error | Description | | --- | --- | | RPC_INVALID_PARAMS | The required parameter `"to"` was not supplied. | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - a JSON object containinly only the string "Connecting to node `to`" as the result. diff --git a/_api_docs/core_create_raw_transaction.md b/_api_docs/core_create_raw_transaction.md index 1846e49..133c764 100644 --- a/_api_docs/core_create_raw_transaction.md +++ b/_api_docs/core_create_raw_transaction.md @@ -22,6 +22,7 @@ Note: If using the `primaryAddress` parameter, the chosen address (public key) m | primaryAddress | String | No | Specify if the node is using a wallet with multiple keypairs in order to select the keypair (public key) which will be used to sign the transaction. The chosen primary address must be a valid signer for all addresses listed in the `from` field. | | fee | Number | No | Transaction fee, specified in IxiCash per kB. If no fee parameter is specified, the default (which is also the minimum) 0.00005 IxiCash per kB will be used. | | autofee | Boolean | No | If specified, the system will automatically deduct the required fee from the first address given in `from`. This parameter is not required if you have included the appropriate fees somewhere in the `from` list, or are not specifying the `from` list at all. | +| wallet | String | No | Base58 Primary Wallet address in case multiple wallets are being used. | | json | Boolean | No | If specified, the transaction will be returned as a JSON transaction object and not encoded as a hexstring. | ### Output: @@ -36,8 +37,8 @@ Note: If using the `primaryAddress` parameter, the chosen address (public key) m | RPC_INVALID_PARAMS | Invalid `from` amounts, or invalid `to` amounts were specified. | | RPC_VERIFY_ERROR | The transaction does not pass verification - this usually means that no usable `from` addresses were present, or there was something wrong with the signing key. | | RPC_WALLET_INSUFFICIENT_FUNDS | Address or addresses specified have insufficient balance to be used for the transaction. | -| RPC_TRANSACTION_ERROR | An error occured while adding the transaction, check the message and log file for details. | -| RPC_INTERNAL_ERROR | An unexpected error occured within the node. Please see the node log for details. | +| RPC_TRANSACTION_ERROR | An error occurred while adding the transaction, check the message and log file for details. | +| RPC_INTERNAL_ERROR | An unexpected error occurred within the node. Please see the node log for details. | ### Example: GET http://localhost:8081/createrawtransaction?from=1JKZFqQs4yiH6Dq4bfom7xcpL6zG53DrjcY6HD9QJ6cRWmXdq_10000-1PC5kubyLvTmsf16CugqHpBG8B8PK4YjcfSjjLMqbUi8YvkQ_5000&to=153xXfVi1sznPcRqJur8tutgrZecNVYGSzetp47bQvRfNuDix_15000 diff --git a/_api_docs/core_extend_name.md b/_api_docs/core_extend_name.md new file mode 100644 index 0000000..fd27392 --- /dev/null +++ b/_api_docs/core_extend_name.md @@ -0,0 +1,53 @@ +--- +title: Extend Name Registration +type: core +--- +## Extend Name Registration +Extend name registration for a specified amount of time. +### Method: `extendName` +### Input parameters: + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| name | String | Yes | Name to be registered. | +| extensionTime | Number | Yes | Time in block to extend the name for. | + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- a JSON object with the transaction in result field, which extends a name. + +### Example: +GET http://localhost:8081/extendname?name=test&extensionTime=864000 +``` +{ + "result": { + "id": "446-iSQxh1KZf5bHADpfg9rFnBQWJksF8jtNbQEGMkvR92rskETRK46cvov29Rko", + "version": 7, + "blockHeight": "446", + "nonce": "93785", + "signature": "5155031ee73...13e3f077009811", + "pubKey": "JHgSS7hbUN...Ywi5i2EPPWjtyTRYRN", + "data": "0341409...02f0d00", + "timestamp": "1711931901", + "type": "4", + "amount": "50000.00000000", + "applied": "0", + "checksum": "7f72ba1ae8b47b3efb5283fbef7256d861d9e8c2fbdf436faedb4042769991500f41ab8b066dd159a4fcaabc", + "from": { + "1": "50000.01000000" + }, + "to": { + "125D6XDzTZzQUWsyQZmQZmQZmQZmQZmQZmQZmQZmQZmQb8t25": "50000.00000000" + }, + "fee": "0.01000000", + "totalAmount": "50000.01000000" + }, + "error": null, + "id": null +} +``` diff --git a/_api_docs/core_generate_new_address.md b/_api_docs/core_generate_new_address.md index 5646769..1536e47 100644 --- a/_api_docs/core_generate_new_address.md +++ b/_api_docs/core_generate_new_address.md @@ -13,13 +13,14 @@ Note: The required 'nonce' value used to generate a new address is determined au | Parameter | Type | Required | Description | | --- | --- | --- | --- | | address | String | No | Primary address (key pair) which will be used to generate a new address. | +| wallet | String | No | Base58 Primary Wallet address in case multiple wallets are being used. | ### Errors: | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - success: new address in the result field with the error field set to null diff --git a/_api_docs/core_get_activity.md b/_api_docs/core_get_activity.md index f21b45f..32cdfd5 100644 --- a/_api_docs/core_get_activity.md +++ b/_api_docs/core_get_activity.md @@ -15,6 +15,7 @@ Retrieves the activity for the currently loaded wallet with optional filtering o | type | Number | No | Type of the activity to fetch as a number. See below. | | orderBy | String | No | Ordering method of requested data. Can be "insertedTimestamp", "timestamp" or "blockheight". Default is "insertedTimestamp". | | descending | Boolean | No | Ordering direction of requested data, set to "true" for descending order. Default is ascending order. | +| wallet | String | No | Base58 Primary Wallet address in case multiple wallets are being used. | ### Activity Types @@ -34,7 +35,7 @@ Retrieves the activity for the currently loaded wallet with optional filtering o | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Example: @@ -42,23 +43,24 @@ GET http://localhost:8081/activity ``` { - "result": [ - { - "seedHash": "Ac2g5Zh...TMg3p6v", - "wallet": "4qX7Uo...y5V4mHg", - "from": "1ixianinfinimine234234234234234234234234234242HP", - "toList": "||4ixR19HcrGcB...ECc=", - "type": 201, - "data": "c3RrLTIwLTI1...N3Q=", - "value": "0.09990100", - "timestamp": 1562596905, - "status": 2, - "blockHeight": 26, - "txid": "stk-20-25-2EAa...bysa7t", - "id": "Voaz...ftiPk" - } - ] - "error": null, - "id": null + "result": [ + { + "seedHash": "Ab7Bkj6gj6Bm5WukZVeptezz2oLEhLcBDXehZQ583aEuTdb+n78AQzGqRqZFYZkO", + "wallet": "4iMKArchGjmLsZFsj2tYrBgPjjypvEwquB2pnbEvYAyihSeEi1FN5XBsWru2iKDXK", + "from": "1ixianinfinimine234234234234234234234234234242HP", + "toList": "||4iMKArchGjmLsZFsj2tYrBgPjjypvEwquB2pnbEvYAyihSeEi1FN5XBsWru2iKDXK:/tkU||5DY8ZF2Y1xbB2n7V7c3z8pcAoLAsScAVAiZdcnqBPbLuGHiq9RWamn83hautJvEoy:ZEwj||4C62hPSVNHTXe4aMtgoFYZ3KVCNXmkCr7MmJRprWukvtUSWTsMsm6UaPLqmiVtnh1:7tI/||4L5vswa8yS9VKsZzDJ2ry9gWY7KQon5bkvhG1CUuepkwvcy1xQmLsHA9DPmCDbufr:mDW5AA==", + "type": 201, + "data": "APyudjHAmnhQfZitq5BY8vgA1PboOXgm10RmMaeGWaHiltRiQdXyrWoA4pE9OKTq", + "value": "0.01366526", + "timestamp": 1709254781, + "status": 2, + "blockHeight": 30383, + "txid": "stk-30377-30382-HBEF6nRAb4qudWecJQnopZCfseUGYXp2KKVvpcbCNYZSAmqCTw4cpcqN7aN5", + "id": "EvniSJUZje4PU46HAqybNoQpZ8mKrpUULcY6oniijR3XehRovo9TSw2fBBMG" + }, + ... + ], + "error": null, + "id": null } ``` diff --git a/_api_docs/core_get_presence.md b/_api_docs/core_get_presence.md new file mode 100644 index 0000000..81388fb --- /dev/null +++ b/_api_docs/core_get_presence.md @@ -0,0 +1,62 @@ +--- +title: Get Presence +type: core +--- +## Get Presence +Returns presence information of the specified wallet. +### Method: `getPresence` +### Input parameters: + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| wallet | String | No | Base58 Primary Wallet address. | + + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- a JSON object with the wallet bytes encoded as a hexadecimal string. + +### Example: +GET http://localhost:8081/getPresence?wallet=4iMKArchGjmLsZFsj2tYrBgPjjypvEwquB2pnbEvYAyihSeEi1FN5XBsWru2iKDXK +``` +{ + "result": { + "version": 1, + "wallet": { + "version": 1, + "addressWithChecksum": "Ab7Bkj6gj6Bm5WukZVeptezz2oLEhLcBDXehZQ583aEuTdb+n78AQzGqRqZFYZkO", + "addressNoChecksum": "Ab7Bkj6gj6Bm5WukZVeptezz2oLEhLcBDXehZQ583aEuTdb+n78AQzGqRqZF", + "nonce": null, + "pubKey": null + }, + "pubkey": "AQAAAAAAAgAA7Gd0ZN...Wdu7w/us52kDAAAAAQAB", + "metadata": null, + "addresses": [ + { + "version": 2, + "device": "aSKhScV0tkOaIq0IjNZyWw==", + "address": "10.23.11.2:10000", + "type": "M", + "nodeVersion": "xdc-0.9.2a", + "lastSeenTime": 1711928565, + "signature": "ynRhobTOXAMys...M5YmAZxzeNF30vLQudLCY=" + } + ], + "powSolution": { + "blockNum": 271, + "solution": "z6qt1qRGHMwi2w+dX+gWnPHtIJhM4rmDlBqjQ7VjNuiRUzD2OxcHRs6oVzSjSSbEg2LuQghDGUfAPrZ08M8/DA==", + "signingPubKey": "AgAAAAAAAQAAlpmt...AqfHk5HQMAAAABAAE=", + "checksum": "4eNPs8p1lda/BsCCfCeUy9EVs1bZrP9RgH+zWAWSZuF02obk/XhhSHGQRNJVmqs0/mGkqyucT19gIRXCJAAAAA==", + "difficulty": "116843993.98621778", + "bits": 3901456573219758000 + } + }, + "error": null, + "id": null +} +``` diff --git a/_api_docs/core_get_total_balance.md b/_api_docs/core_get_total_balance.md index 35ba8b8..5209b87 100644 --- a/_api_docs/core_get_total_balance.md +++ b/_api_docs/core_get_total_balance.md @@ -6,13 +6,17 @@ type: core Gets the total balance of IXIcoins in all currently loaded wallets on this Ixian client. Essentially, this retrieves all your Ixian assets available to you on the chosen node or client. ### Method: `gettotalbalance` ### Input parameters: -None + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| wallet | String | No | Base58 Primary Wallet address in case multiple wallets are being used. | + ### Errors: | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - a JSON object containinly the number of total IxiCoins in local wallets diff --git a/_api_docs/core_get_viewing_wallet.md b/_api_docs/core_get_viewing_wallet.md new file mode 100644 index 0000000..65e6547 --- /dev/null +++ b/_api_docs/core_get_viewing_wallet.md @@ -0,0 +1,32 @@ +--- +title: Get Viewing Wallet +type: core +--- +## Get Viewing Wallet +Retrieves the currently loaded wallet as a viewing wallet in hexadecimal string. The wallet is encrypted with the user's password and the value is prefixed with the string `IXIHEX`. +### Method: `getViewingWallet` +### Input parameters: + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| wallet | String | No | Base58 Primary Wallet address in case multiple wallets are being used. | + + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- a JSON object with the viewing wallet bytes encoded as a hexadecimal string. + +### Example: +GET http://localhost:8081/getViewingWallet +``` +{ + "result": "IXIHEX0200000050090...cab76cfb758a14", + "error": null, + "id": null +} +``` diff --git a/_api_docs/core_get_wallet_backup.md b/_api_docs/core_get_wallet_backup.md index d1a5355..d229ced 100644 --- a/_api_docs/core_get_wallet_backup.md +++ b/_api_docs/core_get_wallet_backup.md @@ -6,13 +6,17 @@ type: core Retrieves the currently loaded wallet as a hexadecimal string. The wallet is encrypted with the user's password and the value is prefixed with the string `IXIHEX`. ### Method: `getwalletbackup` ### Input parameters: -None + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| wallet | String | No | Base58 Primary Wallet address in case multiple wallets are being used. | + ### Errors: | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - a JSON object with the wallet bytes encoded as a hexadecimal string. @@ -21,8 +25,8 @@ None GET http://localhost:8081/getwalletbackup ``` { -"result": "IXIHEX0200000050090...cab76cfb758a14", -"error": null, -"id": null + "result": "IXIHEX05000000013844...cab76cfb758a14", + "error": null, + "id": null } ``` diff --git a/_api_docs/core_list_wallets.md b/_api_docs/core_list_wallets.md new file mode 100644 index 0000000..6af93d5 --- /dev/null +++ b/_api_docs/core_list_wallets.md @@ -0,0 +1,31 @@ +--- +title: List Wallets +type: core +--- +## List Wallets +Lists all loaded wallets. + +### Method: `listWallets` +### Input parameters: +None. + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- a JSON object with list of loaded wallets in result field on success. + +### Example: +GET http://localhost:8081/listWallets +``` +{ + "result": [ + "3WFuwLRowdZBTUUGqmUvSfx14U1tT1c2bcpSV3vai7ghi4fQ4jy4Jjf9xq3Gg" + ], + "error": null, + "id": null +} +``` diff --git a/_api_docs/core_load_wallet.md b/_api_docs/core_load_wallet.md new file mode 100644 index 0000000..159d6a5 --- /dev/null +++ b/_api_docs/core_load_wallet.md @@ -0,0 +1,34 @@ +--- +title: Load Wallet +type: core +--- +## Load Wallet +Loads another wallet from file. If wallet is already loaded, it won't reload it but just return it's primary address. +### Method: `loadWallet` +### Input parameters: + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| file | String | Yes | Filename of the wallet file. | +| password | String | Yes | Password of the provided wallet. | + + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_WALLET_ERROR | An error occurred. File doesn't exist, is incorrect or incorrect password is used. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- a JSON object with the wallet bytes encoded as a hexadecimal string. + +### Example: +GET http://localhost:8081/loadWallet +``` +{ + "result": "4iMKArchGjmLsZFsj2tYrBgPjjypvEwquB2pnbEvYAyihSeEi1FN5XBsWru2iKDXK", + "error": null, + "id": null +} +``` diff --git a/_api_docs/core_my_public_key.md b/_api_docs/core_my_public_key.md index 4bfa468..4101f2f 100644 --- a/_api_docs/core_my_public_key.md +++ b/_api_docs/core_my_public_key.md @@ -6,13 +6,17 @@ type: core Returns the primary public key of this node. ### Method: `mypubkey` ### Input parameters: -None + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| wallet | String | No | Base58 Primary Wallet address in case multiple wallets are being used. | + ### Errors: | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - success: public key in the result field with the error field set to null diff --git a/_api_docs/core_my_wallet.md b/_api_docs/core_my_wallet.md index 8f72c93..f2333eb 100644 --- a/_api_docs/core_my_wallet.md +++ b/_api_docs/core_my_wallet.md @@ -6,13 +6,17 @@ type: core Returns all the loaded (unlocked) wallets in the node's wallet file and their balances. ### Method: `mywallet` ### Input parameters: -None + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| wallet | String | No | Base58 Primary Wallet address in case multiple wallets are being used. | + ### Errors: | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: diff --git a/_api_docs/core_pause_client.md b/_api_docs/core_pause_client.md new file mode 100644 index 0000000..467e864 --- /dev/null +++ b/_api_docs/core_pause_client.md @@ -0,0 +1,28 @@ +--- +title: Pause Network Client +type: core +--- +## Pause Network Client +Disconnects from all servers. +### Method: `pauseClient` +### Input parameters: +None. + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- a JSON object with the string "Network Client paused." in result field. + +### Example: +GET http://localhost:8081/pauseClient +``` +{ + "result": "Network Client paused.", + "error": null, + "id": null +} +``` diff --git a/_api_docs/core_recover_name.md b/_api_docs/core_recover_name.md new file mode 100644 index 0000000..b3783b4 --- /dev/null +++ b/_api_docs/core_recover_name.md @@ -0,0 +1,57 @@ +--- +title: Recover Registered Name +type: core +--- +## Recover Registered Name +Recover a registered name, by using a recovery key. +### Method: `recoverName` +### Input parameters: + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| name | String | Yes | Name to be registered. | +| nextRecoveryHash | String | No | Next Recovery hash in HEX. | +| nextPkHash | String | No | Next Public Key hash in HEX. | +| sigPk | String | No | Signature Public Key hash in HEX. | +| sig | String | No | Signature in HEX. | + + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- a JSON object with the transaction in result field, which recovers a name. + +### Example: +GET http://localhost:8081/recoverName?name=test +``` +{ + "result": { + "id": "416-GmLELpqteeTLv551uUtyLADHGw2SxgfPH5EBQn8YVe2PjMZFJqaFYW1GQbCa", + "version": 7, + "blockHeight": "416", + "nonce": "501522", + "signature": "b58cc4abea30a...ba2a6a0ab227b63e2a9b9439259d7453fc38d", + "pubKey": "JHgSS7hbUNnYWs...U2j3NFmiMazymoYwi5i2EPPWjtyTRYRN", + "data": "0541409be670f...a1c2d7f598025146472a435e47b48edb5b23f5bd", + "timestamp": "1711930988", + "type": "4", + "amount": "0.00000000", + "applied": "0", + "checksum": "307c3363308fee26da1464b54d4235e101bf2c4c31488d8c7d285f6d4385219c8ad99ad22e6c521abbdd29af", + "from": { + "1": "0.01500000" + }, + "to": { + "125D6XDzTZzQUWsyQZmQZmQZmQZmQZmQZmQZmQZmQZmQb8t25": "0.00000000" + }, + "fee": "0.01500000", + "totalAmount": "0.01500000" + }, + "error": null, + "id": null +} +``` diff --git a/_api_docs/core_register_name.md b/_api_docs/core_register_name.md new file mode 100644 index 0000000..b2f80bc --- /dev/null +++ b/_api_docs/core_register_name.md @@ -0,0 +1,57 @@ +--- +title: Register Name +type: core +--- +## Register Name +Register an Ixian Name. +### Method: `registerName` +### Input parameters: + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| name | String | Yes | Name to be registered. | +| registrationTime | Number | Yes | Registration time in blocks. | +| capacity | Number | Yes | Capacity in kB. | +| recoveryHash | String | No | Recovery hash in HEX. | +| pkHash | String | No | PublicKey hash in HEX. | + + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- a JSON object with the transaction in result field, which registers a name. + +### Example: +GET http://localhost:8081/registerName?name=test®istrationTime=864000&capacity=10 +``` +{ + "result": { + "id": "403-yjSY9heSFDLcrvu7yXu3jfKkw4xJoe6YpCULZw3zC4FS89YCEseFByShUANt", + "version": 7, + "blockHeight": "403", + "nonce": "40792", + "signature": "a3861219705...863b3d2ccd178097981c95b", + "pubKey": "JHgSS7hbUN...3NFmiMazymoYwi5i2EPPWjtyTRYRN", + "data": "0141409b...7cdda12e4dd6fe9fbf004331aa46a645", + "timestamp": "1711930571", + "type": "4", + "amount": "50000.00000000", + "applied": "0", + "checksum": "ae7c44383cb5a488088abc188f06eb3bf652d4e90922019da84e34e0f2c37b80aff6b83761f8d260b0c93b91", + "from": { + "1": "50000.01000000" + }, + "to": { + "125D6XDzTZzQUWsyQZmQZmQZmQZmQZmQZmQZmQZmQZmQb8t25": "50000.00000000" + }, + "fee": "0.01000000", + "totalAmount": "50000.01000000" + }, + "error": null, + "id": null +} +``` diff --git a/_api_docs/core_resume_client.md b/_api_docs/core_resume_client.md new file mode 100644 index 0000000..41cf74c --- /dev/null +++ b/_api_docs/core_resume_client.md @@ -0,0 +1,28 @@ +--- +title: Resume Network Client +type: core +--- +## Resume Network Client +Starts connecting to servers again. +### Method: `resumeClient` +### Input parameters: +None. + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- a JSON object with the string "Network Client resumed." in result field. + +### Example: +GET http://localhost:8081/resumeClient +``` +{ + "result": "Network Client resumed.", + "error": null, + "id": null +} +``` diff --git a/_api_docs/core_send_raw_transaction.md b/_api_docs/core_send_raw_transaction.md index aeb3358..fac850d 100644 --- a/_api_docs/core_send_raw_transaction.md +++ b/_api_docs/core_send_raw_transaction.md @@ -22,8 +22,8 @@ Takes a hexadecimal representation of a valid, signed transaction and sends it t | Error | Description | | --- | --- | | RPC_INVALID_PARAMETER | The `transaction` parameter is missing or does not represent a valid transaction object. | -| RPC_VERIFY_ERROR | The transaction was not valid, or an unexpected error has occured in the node. Please see the node's log for details. | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_VERIFY_ERROR | The transaction was not valid, or an unexpected error has occurred in the node. Please see the node's log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Example: GET http://localhost:8081/sendrawtransaction?transaction=03000000000000000e313...cd149493f0d973b7d7bb9b6 diff --git a/_api_docs/core_servers.md b/_api_docs/core_servers.md index 9afd718..d9cad6f 100644 --- a/_api_docs/core_servers.md +++ b/_api_docs/core_servers.md @@ -12,7 +12,7 @@ None | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - success: list of servers JSON-encoded in the result field with the error field set to null diff --git a/_api_docs/core_shutdown.md b/_api_docs/core_shutdown.md index da04be3..59812de 100644 --- a/_api_docs/core_shutdown.md +++ b/_api_docs/core_shutdown.md @@ -13,7 +13,7 @@ None | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - a JSON object containinly only the string "Node shutdown" as the result. diff --git a/_api_docs/core_sign.md b/_api_docs/core_sign.md new file mode 100644 index 0000000..b5c6925 --- /dev/null +++ b/_api_docs/core_sign.md @@ -0,0 +1,33 @@ +--- +title: Sign +type: core +--- +## Sign +Signs a specified string. +### Method: `sign` +### Input parameters: + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| message or hash | String | Yes | Message or hash to be signed. | +| wallet | String | No | Base58 Primary Wallet address in case multiple wallets are being used. | + + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- a JSON object with the wallet bytes encoded as a hexadecimal string. + +### Example: +GET http://localhost:8081/sign?message=test +``` +{ + "result": "5237481874cdf80...e3a3b89fce20f735b749eda9fb2cc6", + "error": null, + "id": null +} +``` diff --git a/_api_docs/core_sign_raw_transaction.md b/_api_docs/core_sign_raw_transaction.md index 9ff7f2b..46afaf5 100644 --- a/_api_docs/core_sign_raw_transaction.md +++ b/_api_docs/core_sign_raw_transaction.md @@ -30,10 +30,8 @@ GET http://localhost:8081/signrawtransaction?transaction=0300000...0ad2a25212b00 ``` { -{ - "result": "03000000000000000e313...cd149493f0d973b7d7bb9b6", - "error": null, - "id": null -} + "result": "03000000000000000e313...cd149493f0d973b7d7bb9b6", + "error": null, + "id": null } ``` \ No newline at end of file diff --git a/_api_docs/core_status.md b/_api_docs/core_status.md index 0ebca2c..63b6902 100644 --- a/_api_docs/core_status.md +++ b/_api_docs/core_status.md @@ -17,7 +17,7 @@ Returns the status of the node. | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - success: status JSON-encoded in the result field with the error field set to null @@ -27,21 +27,44 @@ Returns the status of the node. GET http://localhost:8081/status ``` { - "result": { - "Core Version": "xcore-0.5.0-dev", - "Node Version": "xdc-0.6.6-dev", - "Network type": "testnet", - "My time": 1562605579, - "Network time difference": 0, - "My External IP": "10.10.103.66", - "Queues": "Rcv: 0, RcvTx: 0, SendClients: 0, SendServers: 0, Storage: 0, Logging: 0, Pending Transactions: 0", - "Block Height": 13, - "Block Version": 4, - "Network Block Height": 13, - "Node Type": "M", - "Connectable": true + "result":{ + "Core Version":"xcore-0.9.2a", + "Node Version":"xsbc-0.8.0", + "Network type":"main", + "My time":1711921632, + "Network time difference":0, + "Real network time difference":0, + "My External IP":"10.11.12.13", + "My Listening Port":15235, + "Core Status":1, + "Block Height":4094011, + "Block Version":10, + "Network Block Height":4094011, + "Node Type":"C", + "Connectable":true, + "Queues":{ + "RcvLow":0, + "RcvMedium":0, + "RcvHigh":0, + "SendClients":0, + "SendServers":0, + "Logging":0, + "Pending Transactions":0 + }, + "Presences":1, + "Masters":0, + "Relays":0, + "Clients":1, + "Network Clients":[ + "10.10.1.3:1212", + "10.10.1.4:1312" + ], + "Network Servers":[ + "10.10.1.1:1012", + "10.10.1.2:1012" + ] }, - "error": null, - "id": null + "error":null, + "id":null } ``` diff --git a/_api_docs/core_unload_wallet.md b/_api_docs/core_unload_wallet.md new file mode 100644 index 0000000..b5870ca --- /dev/null +++ b/_api_docs/core_unload_wallet.md @@ -0,0 +1,33 @@ +--- +title: Unload Wallet +type: core +--- +## Unload Wallet +Unloads specified wallet. +### Method: `unloadWallet` +### Input parameters: + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| wallet | String | No | Base58 Primary Wallet address in case multiple wallets are being used. | + + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- a JSON object with "OK" string, if wallet was unloaded in result field. +- a JSON object with "FAIL" string in result field, if wallet can't be unloaded. + +### Example: +GET http://localhost:8081/unloadWallet +``` +{ + "result": "OK", + "error": null, + "id": null +} +``` diff --git a/_api_docs/core_update_name_capacity.md b/_api_docs/core_update_name_capacity.md new file mode 100644 index 0000000..3b351c4 --- /dev/null +++ b/_api_docs/core_update_name_capacity.md @@ -0,0 +1,56 @@ +--- +title: Update Name Capacity +type: core +--- +## Update Name Capacity +Update Name Capacity for a specified amount. +### Method: `extendName` +### Input parameters: + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| name | String | Yes | Name to be registered. | +| newCapacity | Number | Yes | New capacity in kB. | +| nextPkHash | String | No | Next Public Key hash in HEX. | +| sigPk | String | No | Signature Public Key hash in HEX. | +| sig | String | No | Signature in HEX. | + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- a JSON object with the transaction in result field, which updates the capacity. + +### Example: +GET http://localhost:8081/updateNameCapacity?name=test&newCapacity=200 +``` +{ + "result": { + "id": "12-YgoasugxF3umGU4592jJisYRX2iU4xguC5QWa44UvCg4jZt1PT6MAeTQCVgL", + "version": 7, + "blockHeight": "12", + "nonce": "890022", + "signature": "a36e4270f8f48020e5b7add97f852...88a750a4ab9238d1528a610658da", + "pubKey": "JHgSS7hbUNnYWsXgTbs2qz8mDm...U2U2j3NFmiMazymoYwi5i2EPPWjtyTRYRN", + "data": "0441409be670f26e...5a7b27e5cb8c69d376b9190c8d9b56dbfea1614", + "timestamp": "1711934655", + "type": "4", + "amount": "1000000.00000000", + "applied": "0", + "checksum": "61747aba78eb1febfeb542789f35f66733d8ef5bc692a84d56fec4264f0723f708b5dca8d9c40b1672f6ab01", + "from": { + "1": "1000000.01500000" + }, + "to": { + "125D6XDzTZzQUWsyQZmQZmQZmQZmQZmQZmQZmQZmQZmQb8t25": "1000000.00000000" + }, + "fee": "0.01500000", + "totalAmount": "1000000.01500000" + }, + "error": null, + "id": null +} +``` diff --git a/_api_docs/core_update_name_record.md b/_api_docs/core_update_name_record.md new file mode 100644 index 0000000..6a4e5ef --- /dev/null +++ b/_api_docs/core_update_name_record.md @@ -0,0 +1,56 @@ +--- +title: Update Name Records +type: core +--- +## Update Name Records +Update Name Records. +### Method: `updateNameRecord` +### Input parameters: + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| name | String | Yes | Name to be registered. | +| records[] | Array | Yes | Array of records [ "key,TTL,data" ]. | +| nextPkHash | String | No | Next Public Key hash in HEX. | +| sigPk | String | No | Signature Public Key hash in HEX. | +| sig | String | No | Signature in HEX. | + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- a JSON object with the transaction in result field, which updates the name records. + +### Example: +GET http://localhost:8081/updateNameRecord?name=test&records[]=abc,2,testData1&records[]=def,3,testData2&records[]=ghi,3,testData3 +``` +{ + "result": { + "id": "12-uFz12W98ebdbtMg9egjP5p9f1zWgF3tkQ9YAbCB13LNE6WJmPUM59rDctZ1r", + "version": 7, + "blockHeight": "12", + "nonce": "953806", + "signature": "3b3faa9a726f0818fa1795be...865d7ff8701b28b059b39c4112cd2", + "pubKey": "JHgSS7hbUNnYWsXgTbs2qz8mD...FmiMazymoYwi5i2EPPWjtyTRYRN", + "data": "0241409be670f26e3a9d0fa3e...f34df22cd7fbb324", + "timestamp": "1711936613", + "type": "4", + "amount": "0.00000000", + "applied": "0", + "checksum": "a0ba16873ebe68f2f1f319d9f199dbb453a53275aae5f4aad2fcbe0ae533e524cc1c2507498df1448af53599", + "from": { + "1": "0.01500000" + }, + "to": { + "125D6XDzTZzQUWsyQZmQZmQZmQZmQZmQZmQZmQZmQZmQb8t25": "0.00000000" + }, + "fee": "0.01500000", + "totalAmount": "0.01500000" + }, + "error": null, + "id": null +} +``` diff --git a/_api_docs/core_validate_address.md b/_api_docs/core_validate_address.md index 492b6b1..e751468 100644 --- a/_api_docs/core_validate_address.md +++ b/_api_docs/core_validate_address.md @@ -16,7 +16,7 @@ Ensures that the given address is in the correct format. | Error | Description | | --- | --- | | RPC_INVALID_ADDRESS_OR_KEY | The provided vaue does not represent a valid Ixian address, or there was no value provided. | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: diff --git a/_api_docs/core_verify.md b/_api_docs/core_verify.md new file mode 100644 index 0000000..91be8b4 --- /dev/null +++ b/_api_docs/core_verify.md @@ -0,0 +1,35 @@ +--- +title: Verify +type: core +--- +## Verify +Verifies a specified string. +### Method: `verify` +### Input parameters: + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| message or hash | String | Yes | Message or hash to be verified. | +| publicKey | String | Yes | Public Key as Hex String. | +| signature | String | Yes | Signature as Hex String. | + + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_INVALID_PARAMS | Invalid Parameters are used. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- a JSON object with "OK" or "FAIL" string in result field. + +### Example: +GET http://localhost:8081/verify?message=test&publicKey=010000000000020000ec677464d9091f151bbd5d7ac9bc65e37925e3265a89e0e0e211cda42ca1c9ae0271ac114bd4776c6e5924923f17e81583c090893f64a631df03249319d475e27093352b574cd645309d31ccebc1ed1118ca5443e8f8c96fff07e4832490e1790c6d66a630636c79e2a14b45c0ca202692203d4ee3dcfce74cd5adae413e4db52f02b71ea254697295ec03440e5b312f0e2ab3dce1f3317078837912e505729c86db8f9c6629e8037dfe96570087d536e875d8c44b01e808690383e8ae34e70df20aa97b277158ff0b013e453bdb5f591dad1c9442980067d2769fe801486a48a17c87b30fab828aa4ae9af495d0a436df8da8ad786bfac4e20ad98e36b06814cc4c45f806c5ebcfacd686bd9b2614be7420204202ef22bd05410a45fd130b7ce9cf1bf8d7aecf6efdbefe4135161fc00330be211a4b36c550dd633f52fb93acc0b5a805cfc9508a9a22b7aa562747260bfbe05df40d68e7eebc59b9b706e75d83dca9ff18c59756f3d6c304e6e4e861db546fcad35c8856b82614fe90e9ab4a66309ac7086528a0eb808e41bf487c714ad5637f4ab99ad667619d7871dc6e16a1340c07e01f11b80b16b6faed7d028922c69453e5c7d767b2932279aa126edc06b7c79cc1b7bbe913812b02eeea384511a94faef637a4f97e841f324b84d73929ccea9f7051970a9efd93150b5f9080be13b7285809e2bd59dbbbc3fbace76903000000010001&signature=5237481874cdf80b43ae5bee7a3e5003b1919c1991f8de841d2f309e4f42b9a36aa290dc452b20702d3f96e30575007299b7ae89773bd924af0f18b31ffa13be0b13d0a1c7c078b72a9ca0319c0c6c7a441c420d9945feb9ec60a437152c9406ac592d1cc3723933f5ff5a65dbf7d58bd53173508b3207ee7305b7157a39c6b3af25122236acf81a94c4446ef8fa1a46ac16b6d0bb2ac86c15571a21da32c6f0b4b362142d68bf9ad17934061a2e601d574a126f48ae7109f27c42af6a22645c47e590b99b86f7925ae2911232307530eb33280671acadfd64494ba783a9ff1374895f85896e9ba60b7f2039782e82c5752ec01dc89640702644ec938bbcea00ea5217cf2c60d7fe23e7744b68a5fb7a3eccdd26304a24a8d7e1bf9ab7d0a52aab9639fa5895e18819a57733176c4a3d08bdeb3c8c0b9347428cb79e9f36fe285973d709d98819de3d0514d77717aef22dd1e413e8938bbe7ce30b60688e93c0f7a48bf4dcc901bf6a20188c0031322452b8c3c005d50baef1b78e8b75068e8034e0553f773d66a9a7ee99d3e80f4541476ae1564d392682d259e4229eb76a1dbd2221d2e044909693c9b41658d3b531d322062a3679f86fbe6dc74b0f4c0d9a95ce8cb3bfae65efa5a726098c8242998789d09cc7d63227105e5931fa5b248bc17f6063da02d9e27a7f9e49752dbfef99e3a3b89fce20f735b749eda9fb2cc6 +``` +{ + "result": "OK", + "error": null, + "id": null +} +``` diff --git a/_api_docs/core_add_multisig_key.md b/_api_docs/deprecated/core_add_multisig_key.md similarity index 94% rename from _api_docs/core_add_multisig_key.md rename to _api_docs/deprecated/core_add_multisig_key.md index de60d82..65944ab 100644 --- a/_api_docs/core_add_multisig_key.md +++ b/_api_docs/deprecated/core_add_multisig_key.md @@ -20,7 +20,7 @@ In the event where the wallet is newly converted into a multisig wallet, the req | Error | Description | | --- | --- | | RPC_INVALID_PARAMS | One or more of the required parameters are missing or invalid. | -| RPC_INTERNAL_ERROR | An unknown error occured while creating the transaction - please check the node's log file. | +| RPC_INTERNAL_ERROR | An unknown error occurred while creating the transaction - please check the node's log file. | ### Output: - success: the transaction is added to the Transaction Pool and broadcast to the network and the Transaction object is returned. diff --git a/_api_docs/core_add_multisig_transaction.md b/_api_docs/deprecated/core_add_multisig_transaction.md similarity index 89% rename from _api_docs/core_add_multisig_transaction.md rename to _api_docs/deprecated/core_add_multisig_transaction.md index 592a7d6..e3faf65 100644 --- a/_api_docs/core_add_multisig_transaction.md +++ b/_api_docs/deprecated/core_add_multisig_transaction.md @@ -20,8 +20,8 @@ Creates an initial transaction for a Multi-Signature wallet. The transaction is | --- | --- | | RPC_WALLET_ERROR | The specified wallet is not a multisig wallet. | | RPC_WALLET_INSUFFICIENT_FUNDS | The balance on the `from` wallet is too low for this transaction. | -| RPC_WALLET_INSUFFICIENT_FUNDS | An unknown error occured while creating the transaction - please check the node's log file. | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_WALLET_INSUFFICIENT_FUNDS | An unknown error occurred while creating the transaction - please check the node's log file. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - success: the transaction is added to the Transaction Pool and broadcast to the network and the Transaction object is returned. diff --git a/_api_docs/core_add_multisig_tx_signature.md b/_api_docs/deprecated/core_add_multisig_tx_signature.md similarity index 94% rename from _api_docs/core_add_multisig_tx_signature.md rename to _api_docs/deprecated/core_add_multisig_tx_signature.md index ad3c4c8..29093d5 100644 --- a/_api_docs/core_add_multisig_tx_signature.md +++ b/_api_docs/deprecated/core_add_multisig_tx_signature.md @@ -20,7 +20,7 @@ Note: If there are more allowed signers than the required signatures value, any | --- | --- | | RPC_INVALID_PARAMETER | One or more of the required parameters are missing or invalid. | | RPC_TRANSACTION_ERROR | The transaction specified by `origtx` does not exist. | -| RPC_INTERNAL_ERROR | An unknown error occured while creating the transaction - please check the node's log file. | +| RPC_INTERNAL_ERROR | An unknown error occurred while creating the transaction - please check the node's log file. | ### Output: - success: the transaction is added to the Transaction Pool and broadcast to the network and the Transaction object is returned. diff --git a/_api_docs/core_change_multisig_required_signatures.md b/_api_docs/deprecated/core_change_multisig_required_signatures.md similarity index 94% rename from _api_docs/core_change_multisig_required_signatures.md rename to _api_docs/deprecated/core_change_multisig_required_signatures.md index 9b3fdfa..4833a41 100644 --- a/_api_docs/core_change_multisig_required_signatures.md +++ b/_api_docs/deprecated/core_change_multisig_required_signatures.md @@ -21,7 +21,7 @@ Note: Any combination of allowed signatures will enable the transaction, as long | --- | --- | | RPC_INVALID_PARAMS | One or more of the required parameters are missing or invalid. | | RPC_INVALID_PARAMETER | The `sigs` parameter was not a number or was out of range. | -| RPC_INTERNAL_ERROR | An unknown error occured while creating the transaction - please check the node's log file. | +| RPC_INTERNAL_ERROR | An unknown error occurred while creating the transaction - please check the node's log file. | ### Output: - success: the transaction is added to the Transaction Pool and broadcast to the network and the Transaction object is returned. diff --git a/_api_docs/core_delete_multisig_key.md b/_api_docs/deprecated/core_delete_multisig_key.md similarity index 94% rename from _api_docs/core_delete_multisig_key.md rename to _api_docs/deprecated/core_delete_multisig_key.md index 2a16dfd..88e75b2 100644 --- a/_api_docs/core_delete_multisig_key.md +++ b/_api_docs/deprecated/core_delete_multisig_key.md @@ -19,7 +19,7 @@ Note: You cannot use this to remove the original owner of the wallet. You cannot | Error | Description | | --- | --- | | RPC_INVALID_PARAMS | One or more of the required parameters are missing or invalid. | -| RPC_INTERNAL_ERROR | An unknown error occured while creating the transaction - please check the node's log file. | +| RPC_INTERNAL_ERROR | An unknown error occurred while creating the transaction - please check the node's log file. | ### Output: - success: the transaction is added to the Transaction Pool and broadcast to the network and the Transaction object is returned. diff --git a/_api_docs/dlt_applied_transaction_list.md b/_api_docs/dlt_applied_transaction_list.md index 0f9b2c3..056af87 100644 --- a/_api_docs/dlt_applied_transaction_list.md +++ b/_api_docs/dlt_applied_transaction_list.md @@ -17,7 +17,7 @@ Returns the list of applied transactions in the memory pool. | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - success: applied transaction list JSON-encoded in the result field with the error field set to null @@ -27,31 +27,31 @@ Returns the list of applied transactions in the memory pool. GET http://localhost:8081/txa ``` { - "result": { - "125-Eau8yftyoMnt316Hb8YJvzc9jZvSLUwdq2UxhppWFpng": { - "id": "125-Eau8yftyoMnt316Hb8YJvzc9jZvSLUwdq2UxhppWFpng", - "version": 2, - "blockHeight": "125", - "nonce": "6178", - "signature": "0b8afc5d9e1..4eb9e9126b612ee730cb686f657434bbc55cc", - "pubKey": "1JKZFqQs4yiH6Dq4bfom7xcpL6zG53DrjcY6HD9QJ6cRWmXdq", - "timeStamp": "1548942726", - "type": "0", - "amount": "20000.00000000", - "applied":"126", - "checksum": "f1cf2631009697fd8724091391e5990a281724393fc37ab6d5091c49d63236fe", - "from": { - "1": "20000.00005000" - }, - "to": { - "15iYQBgVhq4JeY3TUfNaMBNFkz27UCQWFjjay14C4b3EuHofG": "20000.00000000" - }, - "fee": "0.00005000" - "totalAmount": "20000.00005000" - }, - ... - }, - "error": null, - "id": null + "result": { + "11-284bKK4GvGV9stfEGqu1CP4A9T3tTzrbkUsUd2JestPVE3KDPM5Um7sn3Dfv4": { + "id": "11-284bKK4GvGV9stfEGqu1CP4A9T3tTzrbkUsUd2JestPVE3KDPM5Um7sn3Dfv4", + "version": 7, + "blockHeight": "11", + "nonce": "313950", + "signature": "54b6315260a94dfec40...a166a16472040dae03", + "pubKey": "JHgSS7hbUNnYWsXgTbs2...5i2EPPWjtyTRYRN", + "timestamp": "1711936575", + "type": "0", + "amount": "500000.00000000", + "applied": "12", + "checksum": "c81b2017498e7c838d1d2d960c80e2c18a102959680414dd37ef143bcc777d7796b171d873683f93425a91fd", + "from": { + "1": "500000.01000000" + }, + "to": { + "4L5vswa8yS9VKsZzDJ2ry9gWY7KQon5bkvhG1CUuepkwvcy1xQmLsHA9DPmCDbufr": "500000.00000000" + }, + "fee": "0.01000000", + "totalAmount": "500000.01000000" + }, + ... + }, + "error": null, + "id": null } ``` \ No newline at end of file diff --git a/_api_docs/dlt_count_node_versions.md b/_api_docs/dlt_count_node_versions.md index 5ec49fe..d77a936 100644 --- a/_api_docs/dlt_count_node_versions.md +++ b/_api_docs/dlt_count_node_versions.md @@ -12,7 +12,7 @@ None | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: @@ -22,11 +22,12 @@ None GET http://localhost:8081/countnodeversions ``` { - "result": { - "xdc-0.6.6-dev": 35, - "xdc-0.6.5-dev": 21 - }, - "error": null, - "id": null + "result": { + "xdc-0.9.2a": 35, + "xdc-0.9.2": 21, + "xdc-0.9.2b": 5 + }, + "error": null, + "id": null } ``` diff --git a/_api_docs/dlt_get_balance.md b/_api_docs/dlt_get_balance.md index a48667a..ae69a56 100644 --- a/_api_docs/dlt_get_balance.md +++ b/_api_docs/dlt_get_balance.md @@ -19,7 +19,7 @@ Returns balance of the specified address. | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unexpected error occured within the node. Please see the node log for details. | +| RPC_INTERNAL_ERROR | An unexpected error occurred within the node. Please see the node log for details. | Note: No error is returned if attempting to read the balance for a nonexistant wallet. In this case, a balance of "0.00000000" is returned. diff --git a/_api_docs/dlt_get_best_block_hash.md b/_api_docs/dlt_get_best_block_hash.md index cb51d85..79f496f 100644 --- a/_api_docs/dlt_get_best_block_hash.md +++ b/_api_docs/dlt_get_best_block_hash.md @@ -17,7 +17,7 @@ None | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: diff --git a/_api_docs/dlt_get_block.md b/_api_docs/dlt_get_block.md index 5da40a7..b20c0ce 100644 --- a/_api_docs/dlt_get_block.md +++ b/_api_docs/dlt_get_block.md @@ -17,7 +17,7 @@ Returns specified block data, either as a JSON object or as a binary object conv | Error | Description | | --- | --- | | RPC_INVALID_PARAMETER | The specified block number was invalid. | -| RPC_INTERNAL_ERROR | An unexpected error occured within the node. Please see the node log for details. | +| RPC_INTERNAL_ERROR | An unexpected error occurred within the node. Please see the node log for details. | ### Output: - success: block details are returned as a JSON object and the error field is set to null @@ -28,29 +28,36 @@ GET http://localhost:8081/getblock?num=50 ``` { - "result": { - "Block Number": "50", - "Version": "2", - "Block Checksum": "92efa8dc14175cddfbd31f41fad14a3e73cdc78298f74c322df1725a6aa189c1", - "Last Block Checksum": "453848a354570441ceded657f229a9df07f653120636e80f5b18dba1fb288c6b", - "Wallet State Checksum": "8906b11174faacc776930de40b41f230ad702212d900a04448702cdf10c5b2d0", - "Sig freeze Checksum": "464c6a6e88db2aac2eb534312213adb528334a0e8eb98db8ab92196d0ec86811", - "PoW field": "null", - "Timestamp": "1548940147", - "Difficulty": "11730489520294945089", - "Signature count": "3", - "Transaction count": "1", - "Transaction amount": "0.20002000", - "Signatures": "[ - [\"H7tj...4kvmX9QqHUy2qMriDVOlUQcttNPmRBLRw=\",\"AC9ELmKQl8QNkA0XjWUiqPU7MjbKxfcQi3MxGpuJKgwIPoaD\"], - [\"tME0...aiWgNf2Jcu+8chlE0tUodf0x+j/NiCsWg=\",\"AFUKPO4W+0rVPp8LJcHdL+HaY8N8IoPgv7jaAO3UeAdPqDAc\"], - [\"zT8h...PJmQwJ8JXESIFWJhbiDSuQfv6xZm/XQHQ=\",\"AK2U1C1+vRWrFdIzeFixcGl29ytd/QH142eb9s8pkzx3AMmA\"] - ]", - "TX IDs": "[ - \"stk-44-49-4Eywy3ngSxpvVbXTKopcuXe1xetoR4ALAsmfCBFiMtvd\" - ]" - }, - "error": null, - "id": null + "result": { + "Block Number": "50", + "Version": "11", + "Block Checksum": "aa01845dbc3ab57cede02078499f3dc0c6525bfe2fc10cd120748bca849d7d963db89f3f6d2d98eeeb920fd06289afd785cdc3a63cb3a232c5bee4c48b683404", + "Last Block Checksum": "2694d770ee01b7fb6b20d51219c98ff29add7e062b66185a9e51c3969652a3c282bb3235ad1f2c452b1efbb18f4151a3cce05dd0e3f5f0379a157b18e84c1471", + "Wallet State Checksum": "086d138f4dbfc4b451e1ab6cf668920616293b50139151d23a74ef82673e73d6a9e14a001f52c87c5e44070e04123604543f6ee2e5ffa916a0fb9560b20dbb63", + "RegName State Checksum": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "Sig freeze Checksum": "72d8a439230e2884b5c8ab3672057cde7fd1860d5493519ba69040242657b3a075a18d87cf5e1ca93e9a0727f0a78f05fda46a6c408f428701e0b9f15004965a", + "PoW field": "null", + "Timestamp": "1711937760", + "Difficulty": "11730489520294945089", + "Hashrate": "2999", + "Compacted Sigs": "False", + "Signature count": "3", + "Required Signature count": "2", + "Total Signer Difficulty": "1013836307.33581639", + "Required Signer Difficulty": "5100000.00000000", + "Transaction count": "0", + "Transaction amount": "0.00000000", + "Total fees": "0.05787037", + "Signatures": "[{\"blockNum\":0,\"blockHash\":null,\"signature\":\"Yf9ba36eXRqwZ7crU4DCbeAexLfjgHo6CNEQ+vIO8EyV+7TQYlfdQmJs1yGXS7fA7WiTev1so7GizwdSH3cZ8aMUf3DncP1xfJnbV93YUnKV+Ky7zH+RlpQCcrvyrwOAD7yZcXMREKdO7k2JieHIFJoyqjCqqic0/xfYNwGC1s2+IilBBRXqpHMi9sicsgfppkVVrzp3OnOy3qHiXYRwvUWzuZA3qUF/t5AlThNFETDfVEz2YI7mMVTpe9cVu0n0cgJpeYcieHZ8JwA9NjHSMJCTNB+LBXWVOMRnsAyoFc7taaukvIDq5295i4DBn07iWNAnySnpynGElC70s3f7Mg==\",\"recipientPubKeyOrAddress\":{\"version\":1,\"addressWithChecksum\":\"AZCQzUzcufMr3dRSxxy9lb+U9DNbgieu6Nk/CRAwn+if2d0zz/SSo/zwRhBhBrIN\",\"addressNoChecksum\":\"AZCQzUzcufMr3dRSxxy9lb+U9DNbgieu6Nk/CRAwn+if2d0zz/SSo/zwRhBh\",\"nonce\":null,\"pubKey\":null},\"powSolution\":{\"blockNum\":10,\"solution\":\"+Jr2wf9M7m/4EYefb5A0EUZclf2dPZrk9DZuzWcweSYYaf9ehfSVGGaJ+ll3GcrdTJfuaooRSr+r9lXEZUAIPA==\",\"signingPubKey\":\"AgAAAAAAAQAA3zltTaIk+mrWW3ZHcogfs3hKQ0HnhdI5o9jv87I3fdGknkMrt0IkR4rCnQ75u+oIKtgYYQK2EvHdYWuc/Xs0cOxzcDlKmuDnDvvpwoLRRoAeyiLfiru6beM3pGyCwsRbnFq8n0GIbN7ffwUDe/h97a0dov50bPFD1u1lsvPpVa21YUDkf6w4jIFubJWTrgREveqt7Q8JILD95uTpymj1nQrLlUJ77HHy2anWlaww7S08PN6V93+Ogq29ViO28UsvYGfVK8O55ILxXSjyiIGNNXObCUTF7ZrENqj82rZmJZOs+yrv6PEr6Rm2lRjLVJLX7dkEy2pGgPpKsau48uC1zQMAAAABAAE=\",\"checksum\":\"tB1TJAdVNjhJBWZ5f92FWJu9v3PBYYy72nh1URtJB2ictNjtMnkGshOcER5z5HoENQmySNIT7y0B5UGQEAAAAA==\",\"difficulty\":\"259303038.44875730\",\"bits\":3895772290364812783}},{\"blockNum\":0,\"blockHash\":null,\"signature\":\"ZE8zgV9Lfz65APa+R8eoLRUcmbvjTSMg9meO4PeEeZ7Fwf0lFKpmjH5No8asadtc5vQXPWMQPMHSLO/1RNQawZWNJockhbgY4K4OP5MrgQoxDtnbHk13W+NcPjz3VVNX3HZDvJYraCbWYqDrYVMulA3+berwL615g9JMjAxyj/T9jX7APNC8KIoMHhaq0HtjlGyPa4M6OuwLRgsz5bnVcaiiey9ietxjCYt0Z1qBGco2syg9OzJnXVTV1DvQD2pf29dPdNk4UJsuuJxrOxJTGhRhOXKjuIxPw0/Dr2YQYMlJcU8U/0CwFM3DoiHCTYqJL9MCaFyyFHXcUMTa6Dxrmg==\",\"recipientPubKeyOrAddress\":{\"version\":1,\"addressWithChecksum\":\"Ab7Bkj6gj6Bm5WukZVeptezz2oLEhLcBDXehZQ583aEuTdb+n78AQzGqRqZFYZkO\",\"addressNoChecksum\":\"Ab7Bkj6gj6Bm5WukZVeptezz2oLEhLcBDXehZQ583aEuTdb+n78AQzGqRqZF\",\"nonce\":null,\"pubKey\":null},\"powSolution\":{\"blockNum\":1,\"solution\":\"tMfC+E0J5FblvH5C7Yz89mN9mX7fGwR0Cr4gj8qOdMuN1Qf7MPR+eobmG5wCiJLEktmEDaO4J1FuYSYMhYaCjg==\",\"signingPubKey\":\"AgAAAAAAAQAA3OJn6RNStxxcmU3kfub1YTPLwSKvLZw1foEYjniQuqWvvLCyKgfGcziaUmuj9sGfGiPKX2Qk2GtTWnTlVr7gRe6lX44kJZ+8jK+DlFV/mVChVWKmUz5NLFPNvK1897QZY2ObB5/vekUUWDzyi9rH53wWHXKHrlGGzHM60uE1jAKznPCQzAMZ3tUhC8VPYon7FORLIH101CdzlrUuMmhLb9tlNYhr894HFjOlDNMkneYpnshdbEIyI6YYojOvQpkKKv0eklRN4nzVPPytuR9+DExQvszf0SGCAf3XxPx8wzI0g13DEoA8mBBCjcTfcBpe+FmILIIIMNrZxjuDkGT7+QMAAAABAAE=\",\"checksum\":\"y+kFXtFnU/tEdWOdvuTNs5GDkGVbXVpB/MlZ+VonxzBUYUs5ezWzBMWCyeb16b2mSt0wFankgRS02rUGDQAAAA==\",\"difficulty\":\"329717278.65639821\",\"bits\":3894776630873429121}},{\"blockNum\":0,\"blockHash\":null,\"signature\":\"e3Ij2Y3RkuA16pbhfbTWmwloMff11IuVzGEsRAcsVkT6wHCgRAZLhQ7w5gXEtsRUsdgBgQowOmJcLKHeOuxVX47RTfCGsSv9CScNXtsrLRysIBhZUjY4W9326U+Qcqa4XDwuu0+kwMInA0++fYqwBBzmH//filvZQge3N85j34hK9BSEXVp91y3b8zxMp8KBuJ+C4buUIQR3XzQ6C7hoc1PERknnYd+FXdU2DONCkkcFRtmiUUxLRj0mXMBvqUj2vu/zkj4lWgp+DLuVI1wc00Q9Q/rVXAH+6w+7qe2DuXfnuNfkd7ojxR47XJjyexdtp9/hqykwpnQCNq7/LReS3w==\",\"recipientPubKeyOrAddress\":{\"version\":1,\"addressWithChecksum\":\"AX/5B43yaFLWKrgwFEvbKh8GK2nm/OHd/WxYoYLncQSWuHo1Ta5Lzw+o57XoCFi8\",\"addressNoChecksum\":\"AX/5B43yaFLWKrgwFEvbKh8GK2nm/OHd/WxYoYLncQSWuHo1Ta5Lzw+o57Xo\",\"nonce\":null,\"pubKey\":null},\"powSolution\":{\"blockNum\":1,\"solution\":\"/r2nTNsRX9+RYQKSeQUbouALPEvkGGU6DDdhQDVT390LpisQ8daqkPgP81bdyLb0t+Sh7LNf/jFlz7EKz4wdBA==\",\"signingPubKey\":\"AgAAAAAAAQAAs0gqEw13NegI7OOguIOpqdRFqvqrnaRCiqs7KGUHzYtKE/HfisoGj17KDduSxYTLwz0+0g8ZuR6shQshmmo5obbiQuDTHi78vbM3PmPkx/yPhYzi0j/vPZgANnd5R2/EYG29RhOdJDxWIPL2jCgwNc+UsGa8tZF5VVB3fb1frHDHIVV2CYWZoofOOdK9w00mcFUyvZmCQ0BC8elONMd2i2zZZuoKH5mKb9as/pT8juU9PBxcRzrOSL4agWz9Ni70cUF0TccNhFbTdouGmq3HUpv1ux44Tc+sP89Kr3elInP1eeMGM2943LMO3yVh69Ry9FJ8MLwXlDLzOfyK2BEFCQMAAAABAAE=\",\"checksum\":\"i3Bkfyxl78asZk0E+/1YbhPVrAFpat8a7BFbBZuBgRhGaorG93d8XAv11ciqcUUhUT7EQpBcmkDI7zQcCgAAAA==\",\"difficulty\":\"424815990.23066088\",\"bits\":3893955841501970586}}]", + "Frozen Signatures": "[{\"blockNum\":0,\"blockHash\":null,\"signature\":\"Yf9ba36eXRqwZ7crU4DCbeAexLfjgHo6CNEQ+vIO8EyV+7TQYlfdQmJs1yGXS7fA7WiTev1so7GizwdSH3cZ8aMUf3DncP1xfJnbV93YUnKV+Ky7zH+RlpQCcrvyrwOAD7yZcXMREKdO7k2JieHIFJoyqjCqqic0/xfYNwGC1s2+IilBBRXqpHMi9sicsgfppkVVrzp3OnOy3qHiXYRwvUWzuZA3qUF/t5AlThNFETDfVEz2YI7mMVTpe9cVu0n0cgJpeYcieHZ8JwA9NjHSMJCTNB+LBXWVOMRnsAyoFc7taaukvIDq5295i4DBn07iWNAnySnpynGElC70s3f7Mg==\",\"recipientPubKeyOrAddress\":{\"version\":1,\"addressWithChecksum\":\"AZCQzUzcufMr3dRSxxy9lb+U9DNbgieu6Nk/CRAwn+if2d0zz/SSo/zwRhBhBrIN\",\"addressNoChecksum\":\"AZCQzUzcufMr3dRSxxy9lb+U9DNbgieu6Nk/CRAwn+if2d0zz/SSo/zwRhBh\",\"nonce\":null,\"pubKey\":null},\"powSolution\":{\"blockNum\":10,\"solution\":\"+Jr2wf9M7m/4EYefb5A0EUZclf2dPZrk9DZuzWcweSYYaf9ehfSVGGaJ+ll3GcrdTJfuaooRSr+r9lXEZUAIPA==\",\"signingPubKey\":\"AgAAAAAAAQAA3zltTaIk+mrWW3ZHcogfs3hKQ0HnhdI5o9jv87I3fdGknkMrt0IkR4rCnQ75u+oIKtgYYQK2EvHdYWuc/Xs0cOxzcDlKmuDnDvvpwoLRRoAeyiLfiru6beM3pGyCwsRbnFq8n0GIbN7ffwUDe/h97a0dov50bPFD1u1lsvPpVa21YUDkf6w4jIFubJWTrgREveqt7Q8JILD95uTpymj1nQrLlUJ77HHy2anWlaww7S08PN6V93+Ogq29ViO28UsvYGfVK8O55ILxXSjyiIGNNXObCUTF7ZrENqj82rZmJZOs+yrv6PEr6Rm2lRjLVJLX7dkEy2pGgPpKsau48uC1zQMAAAABAAE=\",\"checksum\":\"tB1TJAdVNjhJBWZ5f92FWJu9v3PBYYy72nh1URtJB2ictNjtMnkGshOcER5z5HoENQmySNIT7y0B5UGQEAAAAA==\",\"difficulty\":\"259303038.44875730\",\"bits\":3895772290364812783}},{\"blockNum\":0,\"blockHash\":null,\"signature\":\"ZE8zgV9Lfz65APa+R8eoLRUcmbvjTSMg9meO4PeEeZ7Fwf0lFKpmjH5No8asadtc5vQXPWMQPMHSLO/1RNQawZWNJockhbgY4K4OP5MrgQoxDtnbHk13W+NcPjz3VVNX3HZDvJYraCbWYqDrYVMulA3+berwL615g9JMjAxyj/T9jX7APNC8KIoMHhaq0HtjlGyPa4M6OuwLRgsz5bnVcaiiey9ietxjCYt0Z1qBGco2syg9OzJnXVTV1DvQD2pf29dPdNk4UJsuuJxrOxJTGhRhOXKjuIxPw0/Dr2YQYMlJcU8U/0CwFM3DoiHCTYqJL9MCaFyyFHXcUMTa6Dxrmg==\",\"recipientPubKeyOrAddress\":{\"version\":1,\"addressWithChecksum\":\"Ab7Bkj6gj6Bm5WukZVeptezz2oLEhLcBDXehZQ583aEuTdb+n78AQzGqRqZFYZkO\",\"addressNoChecksum\":\"Ab7Bkj6gj6Bm5WukZVeptezz2oLEhLcBDXehZQ583aEuTdb+n78AQzGqRqZF\",\"nonce\":null,\"pubKey\":null},\"powSolution\":{\"blockNum\":1,\"solution\":\"tMfC+E0J5FblvH5C7Yz89mN9mX7fGwR0Cr4gj8qOdMuN1Qf7MPR+eobmG5wCiJLEktmEDaO4J1FuYSYMhYaCjg==\",\"signingPubKey\":\"AgAAAAAAAQAA3OJn6RNStxxcmU3kfub1YTPLwSKvLZw1foEYjniQuqWvvLCyKgfGcziaUmuj9sGfGiPKX2Qk2GtTWnTlVr7gRe6lX44kJZ+8jK+DlFV/mVChVWKmUz5NLFPNvK1897QZY2ObB5/vekUUWDzyi9rH53wWHXKHrlGGzHM60uE1jAKznPCQzAMZ3tUhC8VPYon7FORLIH101CdzlrUuMmhLb9tlNYhr894HFjOlDNMkneYpnshdbEIyI6YYojOvQpkKKv0eklRN4nzVPPytuR9+DExQvszf0SGCAf3XxPx8wzI0g13DEoA8mBBCjcTfcBpe+FmILIIIMNrZxjuDkGT7+QMAAAABAAE=\",\"checksum\":\"y+kFXtFnU/tEdWOdvuTNs5GDkGVbXVpB/MlZ+VonxzBUYUs5ezWzBMWCyeb16b2mSt0wFankgRS02rUGDQAAAA==\",\"difficulty\":\"329717278.65639821\",\"bits\":3894776630873429121}},{\"blockNum\":0,\"blockHash\":null,\"signature\":\"e3Ij2Y3RkuA16pbhfbTWmwloMff11IuVzGEsRAcsVkT6wHCgRAZLhQ7w5gXEtsRUsdgBgQowOmJcLKHeOuxVX47RTfCGsSv9CScNXtsrLRysIBhZUjY4W9326U+Qcqa4XDwuu0+kwMInA0++fYqwBBzmH//filvZQge3N85j34hK9BSEXVp91y3b8zxMp8KBuJ+C4buUIQR3XzQ6C7hoc1PERknnYd+FXdU2DONCkkcFRtmiUUxLRj0mXMBvqUj2vu/zkj4lWgp+DLuVI1wc00Q9Q/rVXAH+6w+7qe2DuXfnuNfkd7ojxR47XJjyexdtp9/hqykwpnQCNq7/LReS3w==\",\"recipientPubKeyOrAddress\":{\"version\":1,\"addressWithChecksum\":\"AX/5B43yaFLWKrgwFEvbKh8GK2nm/OHd/WxYoYLncQSWuHo1Ta5Lzw+o57XoCFi8\",\"addressNoChecksum\":\"AX/5B43yaFLWKrgwFEvbKh8GK2nm/OHd/WxYoYLncQSWuHo1Ta5Lzw+o57Xo\",\"nonce\":null,\"pubKey\":null},\"powSolution\":{\"blockNum\":1,\"solution\":\"/r2nTNsRX9+RYQKSeQUbouALPEvkGGU6DDdhQDVT390LpisQ8daqkPgP81bdyLb0t+Sh7LNf/jFlz7EKz4wdBA==\",\"signingPubKey\":\"AgAAAAAAAQAAs0gqEw13NegI7OOguIOpqdRFqvqrnaRCiqs7KGUHzYtKE/HfisoGj17KDduSxYTLwz0+0g8ZuR6shQshmmo5obbiQuDTHi78vbM3PmPkx/yPhYzi0j/vPZgANnd5R2/EYG29RhOdJDxWIPL2jCgwNc+UsGa8tZF5VVB3fb1frHDHIVV2CYWZoofOOdK9w00mcFUyvZmCQ0BC8elONMd2i2zZZuoKH5mKb9as/pT8juU9PBxcRzrOSL4agWz9Ni70cUF0TccNhFbTdouGmq3HUpv1ux44Tc+sP89Kr3elInP1eeMGM2943LMO3yVh69Ry9FJ8MLwXlDLzOfyK2BEFCQMAAAABAAE=\",\"checksum\":\"i3Bkfyxl78asZk0E+/1YbhPVrAFpat8a7BFbBZuBgRhGaorG93d8XAv11ciqcUUhUT7EQpBcmkDI7zQcCgAAAA==\",\"difficulty\":\"424815990.23066088\",\"bits\":3893955841501970586}}]", + "Frozen Signature count": "3", + "Sig Checksum": "2b5052b73871467441cba99f42214f4ea2507695f281070bc267abb3deef6d9117e6022451e707918991ea3418d3c9c3893a342ddaa1973c8fbc44268966bec4", + "Signer Bits": "0000000000000000", + "TX IDs": "[]", + "Last Superblock": "0", + "Last Superblock checksum": "null" + }, + "error": null, + "id": null } ``` \ No newline at end of file diff --git a/_api_docs/dlt_get_block_count.md b/_api_docs/dlt_get_block_count.md index f22760f..3f9236f 100644 --- a/_api_docs/dlt_get_block_count.md +++ b/_api_docs/dlt_get_block_count.md @@ -13,7 +13,7 @@ None | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: diff --git a/_api_docs/dlt_get_full_block.md b/_api_docs/dlt_get_full_block.md index d94715a..bbe24f2 100644 --- a/_api_docs/dlt_get_full_block.md +++ b/_api_docs/dlt_get_full_block.md @@ -16,7 +16,7 @@ Returns specified block data with full transactions and superblock data included | Error | Description | | --- | --- | | RPC_INVALID_PARAMETER | The specified block number was invalid. | -| RPC_INTERNAL_ERROR | An unknown error occured while fetching the block. | +| RPC_INTERNAL_ERROR | An unknown error occurred while fetching the block. | ### Output: @@ -24,59 +24,44 @@ Returns specified block data with full transactions and superblock data included - fail: JSON encoded details with a non-null error and a null result: ### Example: -GET http://localhost:8081/getfullblock?num=50 +GET http://localhost:8081/getfullblock?num=12 ``` { - "result": { - "Block Number": "50", - "Version": "2", - "Block Checksum": "92efa8dc14175cddfbd31f41fad14a3e73cdc78298f74c322df1725a6aa189c1", - "Last Block Checksum": "453848a354570441ceded657f229a9df07f653120636e80f5b18dba1fb288c6b", - "Wallet State Checksum": "8906b11174faacc776930de40b41f230ad702212d900a04448702cdf10c5b2d0", - "Sig freeze Checksum": "464c6a6e88db2aac2eb534312213adb528334a0e8eb98db8ab92196d0ec86811", - "PoW field": "null", - "Timestamp": "1548940147", - "Difficulty": "11730489520294945089", - "Signature count": "3", - "Transaction count": "1", - "Transaction amount": "0.20002000", - "Signatures": "[ - [\"H7tj...4kvmX9QqHUy2qMriDVOlUQcttNPmRBLRw=\",\"AC9ELmKQl8QNkA0XjWUiqPU7MjbKxfcQi3MxGpuJKgwIPoaD\"], - [\"tME0...aiWgNf2Jcu+8chlE0tUodf0x+j/NiCsWg=\",\"AFUKPO4W+0rVPp8LJcHdL+HaY8N8IoPgv7jaAO3UeAdPqDAc\"], - [\"zT8h...PJmQwJ8JXESIFWJhbiDSuQfv6xZm/XQHQ=\",\"AK2U1C1+vRWrFdIzeFixcGl29ytd/QH142eb9s8pkzx3AMmA\"] - ]", - "TX IDs": "[ - \"stk-44-49-4Eywy3ngSxpvVbXTKopcuXe1xetoR4ALAsmfCBFiMtvd\" - ]", - "Transactions": "[ - { - \"id\": \"stk-44-49-4Eywy3ngSxpvVbXTKopcuXe1xetoR4ALAsmfCBFiMtvd\", - \"version\": 1, - \"blockHeight\": \"49\", - \"nonce\": \"0\", - \"signature\": \"5374616b65\", - \"pubKey\": \"1ixianinfinimine234234234234234234234234234242HP\", - \"data\": \"2c00000000000000\", - \"timeStamp\": \"1548940147\", - \"type\": \"2\", - \"amount\": \"0.20002000\", - \"applied\": \"0\", - \"checksum\": \"36781655c23b509f85e46513608ba359b849795580344c5340c778c51e466fd1\", - \"from\": { - \"1\": \"0.20002000\" - }, - \"to\": { - \"15iYQBgVhq4JeY3TUfNaMBNFkz27UCQWFjjay14C4b3EuHofG\": \"0.10003000\", - \"19V9VYuGfqoGjRbGZgcF8XNrAeb5REF8gCZKhp7ZsNX3rG8VZ\":\"0.00010001\", - \"1JKZFqQs4yiH6Dq4bfom7xcpL6zG53DrjcY6HD9QJ6cRWmXdq\":\"0.09988999\"}, - \"fee\":\"0.00000000\" - } - ] - }, - "error": null, - "id": null + "result": { + "Block Number": "12", + "Version": "11", + "Block Checksum": "fd6885d31d98d6ece1af2625e62f3b0518de6fb0c3ca5398c8a3d9af1d558b0c02bda7603b3ffc615d69f7eef24c766ddd6b27b2504d1fe7fe4113595d19a92a", + "Last Block Checksum": "83a701bebaee8733ffe4a8e1871a0e2e813f3ac3acaef4c889f00b80a106319a8e045b3fc5810605cafaee270b8572852e6d63ceefd451f90ae61c95863df03b", + "Wallet State Checksum": "2600672b98467ef7125aeaecbf34b3bab13a3ff56f6ff8d30341acabe1c2e1576f4a1fe0b8c618cf4673397bdec62d84b924d1efca83890cd69a16b4ea37ed75", + "RegName State Checksum": "ef0dd1be8dcc9fb9fec8991857ca70d1426e915c3662147e22d58af1001af8f28400832c662788eb2ec1e7347b61a356d275897c13239c727dc50fa92379adcc", + "Sig freeze Checksum": "ae5f2adb4c253a075606685f0db901d5ecdf4013411d44fd8a260e4b9724079bd0734988080dababe0551bd20ede307ac2bca5cd868c3d9a2bc3f85b7d529243", + "PoW field": "null", + "Timestamp": "1711936599", + "Difficulty": "11730489520294945089", + "Hashrate": "2999", + "Compacted Sigs": "False", + "Signature count": "2", + "Required Signature count": "2", + "Total Signer Difficulty": "754533268.88705909", + "Required Signer Difficulty": "5100000.00000000", + "Transaction count": "2", + "Transaction amount": "550000.00000000", + "Total fees": "0.02000000", + "Signatures": "[{\"blockNum\":0,\"blockHash\":null,\"signature\":\"RuEvTDOeQWJLSnDS2t8yUB1wY7X10Mjd00F2ommDXHs+hTWgBy9UQkYonLSLDkspLgEK/NWew4Tu9NvmocmfY5Ofg0q6rbZ9XFhsDU8f/YG6dCq0qsE6FurWdFANRdjm1CZ2scpUCqRgOGaqIlAn3VwgWiR0agLzlunNf5wZyU+Cf6Nr9xa7+6uKmGi2cVR6VADAY8o4UlMnRdU8HpAR2IpAcR7gj82MjAVwiqQA8qO5TMvvT4AkDI2PygbeZBYElZBQad3Mwm5nYn/QugHXJav9s6VcD42CgawpRpgh07UJACEPbdxQIvAFBGk2r+foP3TTdBZxYhGLrlF7IzXkGQ==\",\"recipientPubKeyOrAddress\":{\"version\":1,\"addressWithChecksum\":\"Ab7Bkj6gj6Bm5WukZVeptezz2oLEhLcBDXehZQ583aEuTdb+n78AQzGqRqZFYZkO\",\"addressNoChecksum\":\"Ab7Bkj6gj6Bm5WukZVeptezz2oLEhLcBDXehZQ583aEuTdb+n78AQzGqRqZF\",\"nonce\":null,\"pubKey\":null},\"powSolution\":{\"blockNum\":1,\"solution\":\"tMfC+E0J5FblvH5C7Yz89mN9mX7fGwR0Cr4gj8qOdMuN1Qf7MPR+eobmG5wCiJLEktmEDaO4J1FuYSYMhYaCjg==\",\"signingPubKey\":\"AgAAAAAAAQAA3OJn6RNStxxcmU3kfub1YTPLwSKvLZw1foEYjniQuqWvvLCyKgfGcziaUmuj9sGfGiPKX2Qk2GtTWnTlVr7gRe6lX44kJZ+8jK+DlFV/mVChVWKmUz5NLFPNvK1897QZY2ObB5/vekUUWDzyi9rH53wWHXKHrlGGzHM60uE1jAKznPCQzAMZ3tUhC8VPYon7FORLIH101CdzlrUuMmhLb9tlNYhr894HFjOlDNMkneYpnshdbEIyI6YYojOvQpkKKv0eklRN4nzVPPytuR9+DExQvszf0SGCAf3XxPx8wzI0g13DEoA8mBBCjcTfcBpe+FmILIIIMNrZxjuDkGT7+QMAAAABAAE=\",\"checksum\":\"y+kFXtFnU/tEdWOdvuTNs5GDkGVbXVpB/MlZ+VonxzBUYUs5ezWzBMWCyeb16b2mSt0wFankgRS02rUGDQAAAA==\",\"difficulty\":\"329717278.65639821\",\"bits\":3894776630873429121}},{\"blockNum\":0,\"blockHash\":null,\"signature\":\"aQzJdOPvHswoh/5oBdsLQjy99sX1uuwAEb/DiLIbFjChnJ4QbEbVXKw/VtavR4Ii61sN5y+py4WQ4fGxPejzX8r5Psl9cMLlK2vpUKhriqjJlfcvztsADPfw37ZzJAURZH1l5YUiiZan8u1269RPzKUFTwYAZtC47y1UVf49NLnh5zczv86gatpNJKNeWFuG+eJGUK+4j3DbA+PeyPbkXVYsuUzSyH24bCMFVRArdPE0hIHSQ3ojX0MMwoRtNZGK8iMSGsYZ1+Vg1gmJuDqi0vBMbYYFktn5Novpy9x1oKyh6TLwfxafe0aN6TZT08uF/Gs5YOMaY1L7Mm6/Wfefaw==\",\"recipientPubKeyOrAddress\":{\"version\":1,\"addressWithChecksum\":\"AX/5B43yaFLWKrgwFEvbKh8GK2nm/OHd/WxYoYLncQSWuHo1Ta5Lzw+o57XoCFi8\",\"addressNoChecksum\":\"AX/5B43yaFLWKrgwFEvbKh8GK2nm/OHd/WxYoYLncQSWuHo1Ta5Lzw+o57Xo\",\"nonce\":null,\"pubKey\":null},\"powSolution\":{\"blockNum\":1,\"solution\":\"/r2nTNsRX9+RYQKSeQUbouALPEvkGGU6DDdhQDVT390LpisQ8daqkPgP81bdyLb0t+Sh7LNf/jFlz7EKz4wdBA==\",\"signingPubKey\":\"AgAAAAAAAQAAs0gqEw13NegI7OOguIOpqdRFqvqrnaRCiqs7KGUHzYtKE/HfisoGj17KDduSxYTLwz0+0g8ZuR6shQshmmo5obbiQuDTHi78vbM3PmPkx/yPhYzi0j/vPZgANnd5R2/EYG29RhOdJDxWIPL2jCgwNc+UsGa8tZF5VVB3fb1frHDHIVV2CYWZoofOOdK9w00mcFUyvZmCQ0BC8elONMd2i2zZZuoKH5mKb9as/pT8juU9PBxcRzrOSL4agWz9Ni70cUF0TccNhFbTdouGmq3HUpv1ux44Tc+sP89Kr3elInP1eeMGM2943LMO3yVh69Ry9FJ8MLwXlDLzOfyK2BEFCQMAAAABAAE=\",\"checksum\":\"i3Bkfyxl78asZk0E+/1YbhPVrAFpat8a7BFbBZuBgRhGaorG93d8XAv11ciqcUUhUT7EQpBcmkDI7zQcCgAAAA==\",\"difficulty\":\"424815990.23066088\",\"bits\":3893955841501970586}}]", + "Frozen Signatures": "[{\"blockNum\":0,\"blockHash\":null,\"signature\":\"RuEvTDOeQWJLSnDS2t8yUB1wY7X10Mjd00F2ommDXHs+hTWgBy9UQkYonLSLDkspLgEK/NWew4Tu9NvmocmfY5Ofg0q6rbZ9XFhsDU8f/YG6dCq0qsE6FurWdFANRdjm1CZ2scpUCqRgOGaqIlAn3VwgWiR0agLzlunNf5wZyU+Cf6Nr9xa7+6uKmGi2cVR6VADAY8o4UlMnRdU8HpAR2IpAcR7gj82MjAVwiqQA8qO5TMvvT4AkDI2PygbeZBYElZBQad3Mwm5nYn/QugHXJav9s6VcD42CgawpRpgh07UJACEPbdxQIvAFBGk2r+foP3TTdBZxYhGLrlF7IzXkGQ==\",\"recipientPubKeyOrAddress\":{\"version\":1,\"addressWithChecksum\":\"Ab7Bkj6gj6Bm5WukZVeptezz2oLEhLcBDXehZQ583aEuTdb+n78AQzGqRqZFYZkO\",\"addressNoChecksum\":\"Ab7Bkj6gj6Bm5WukZVeptezz2oLEhLcBDXehZQ583aEuTdb+n78AQzGqRqZF\",\"nonce\":null,\"pubKey\":null},\"powSolution\":{\"blockNum\":1,\"solution\":\"tMfC+E0J5FblvH5C7Yz89mN9mX7fGwR0Cr4gj8qOdMuN1Qf7MPR+eobmG5wCiJLEktmEDaO4J1FuYSYMhYaCjg==\",\"signingPubKey\":\"AgAAAAAAAQAA3OJn6RNStxxcmU3kfub1YTPLwSKvLZw1foEYjniQuqWvvLCyKgfGcziaUmuj9sGfGiPKX2Qk2GtTWnTlVr7gRe6lX44kJZ+8jK+DlFV/mVChVWKmUz5NLFPNvK1897QZY2ObB5/vekUUWDzyi9rH53wWHXKHrlGGzHM60uE1jAKznPCQzAMZ3tUhC8VPYon7FORLIH101CdzlrUuMmhLb9tlNYhr894HFjOlDNMkneYpnshdbEIyI6YYojOvQpkKKv0eklRN4nzVPPytuR9+DExQvszf0SGCAf3XxPx8wzI0g13DEoA8mBBCjcTfcBpe+FmILIIIMNrZxjuDkGT7+QMAAAABAAE=\",\"checksum\":\"y+kFXtFnU/tEdWOdvuTNs5GDkGVbXVpB/MlZ+VonxzBUYUs5ezWzBMWCyeb16b2mSt0wFankgRS02rUGDQAAAA==\",\"difficulty\":\"329717278.65639821\",\"bits\":3894776630873429121}},{\"blockNum\":0,\"blockHash\":null,\"signature\":\"aQzJdOPvHswoh/5oBdsLQjy99sX1uuwAEb/DiLIbFjChnJ4QbEbVXKw/VtavR4Ii61sN5y+py4WQ4fGxPejzX8r5Psl9cMLlK2vpUKhriqjJlfcvztsADPfw37ZzJAURZH1l5YUiiZan8u1269RPzKUFTwYAZtC47y1UVf49NLnh5zczv86gatpNJKNeWFuG+eJGUK+4j3DbA+PeyPbkXVYsuUzSyH24bCMFVRArdPE0hIHSQ3ojX0MMwoRtNZGK8iMSGsYZ1+Vg1gmJuDqi0vBMbYYFktn5Novpy9x1oKyh6TLwfxafe0aN6TZT08uF/Gs5YOMaY1L7Mm6/Wfefaw==\",\"recipientPubKeyOrAddress\":{\"version\":1,\"addressWithChecksum\":\"AX/5B43yaFLWKrgwFEvbKh8GK2nm/OHd/WxYoYLncQSWuHo1Ta5Lzw+o57XoCFi8\",\"addressNoChecksum\":\"AX/5B43yaFLWKrgwFEvbKh8GK2nm/OHd/WxYoYLncQSWuHo1Ta5Lzw+o57Xo\",\"nonce\":null,\"pubKey\":null},\"powSolution\":{\"blockNum\":1,\"solution\":\"/r2nTNsRX9+RYQKSeQUbouALPEvkGGU6DDdhQDVT390LpisQ8daqkPgP81bdyLb0t+Sh7LNf/jFlz7EKz4wdBA==\",\"signingPubKey\":\"AgAAAAAAAQAAs0gqEw13NegI7OOguIOpqdRFqvqrnaRCiqs7KGUHzYtKE/HfisoGj17KDduSxYTLwz0+0g8ZuR6shQshmmo5obbiQuDTHi78vbM3PmPkx/yPhYzi0j/vPZgANnd5R2/EYG29RhOdJDxWIPL2jCgwNc+UsGa8tZF5VVB3fb1frHDHIVV2CYWZoofOOdK9w00mcFUyvZmCQ0BC8elONMd2i2zZZuoKH5mKb9as/pT8juU9PBxcRzrOSL4agWz9Ni70cUF0TccNhFbTdouGmq3HUpv1ux44Tc+sP89Kr3elInP1eeMGM2943LMO3yVh69Ry9FJ8MLwXlDLzOfyK2BEFCQMAAAABAAE=\",\"checksum\":\"i3Bkfyxl78asZk0E+/1YbhPVrAFpat8a7BFbBZuBgRhGaorG93d8XAv11ciqcUUhUT7EQpBcmkDI7zQcCgAAAA==\",\"difficulty\":\"424815990.23066088\",\"bits\":3893955841501970586}}]", + "Frozen Signature count": "2", + "Sig Checksum": "4b5c92cbf7be019353dc2ab9d59435f631b88f5de4fb08008e7a6aaee743b2566da7120d0e9600cff00857261318e3c78060ce2a129ea35b75a9f6babe6a6456", + "Signer Bits": "0000000000000000", + "TX IDs": "[\"11-284bKK4GvGV9stfEGqu1CP4A9T3tTzrbkUsUd2JestPVE3KDPM5Um7sn3Dfv4\",\"11-2HJD6X8nJoe1sDNHkPspSLBK3Qsi5wp9HBCViYe3VCTFPrcH9zLFPZG43VgsE\"]", + "Last Superblock": "0", + "Last Superblock checksum": "null", + "Transactions": "[{\"id\":\"11-284bKK4GvGV9stfEGqu1CP4A9T3tTzrbkUsUd2JestPVE3KDPM5Um7sn3Dfv4\",\"version\":7,\"blockHeight\":\"11\",\"nonce\":\"313950\",\"signature\":\"54b6315260a94dfec40ef12dc63d506f7a464744f5b30c142d0999a0ab04b059e7a56e651e3c86be45e0f86d33cdec8a3add2e03104dee23358853ab3f0280954507fe1981e0692f4f93eb019311a11cfe1275517b6cf854be21b255a31c434f33437be06231d92165bb17e2aee9dc88ad8581b528ce246ab98a83fc6c266bb5ab80afcacec51c24091eda469c50612ae0bfad8be9deb6d42a9bbebdedccbd9504d7adc8df5d85ffd51877163f6ec3feb86f0be54e3d60b7ae11ad72007f1c4c280caaaeb9cf009fec22218be663d43a822c8156a9024f5e6091e9be2309f1e779fd1b35a7c6b93bd15e7099db9254a4bb265cad80a38016f32d97e6c2b6bb30c20eef49c35631e67cf0a3345fb05477ab8586e3a74dc7962f1246a676d6eeeaaf9406fb3267f72fab670caa3633f4c862b032e74c9bf80a1f035e7813468b991736c74f81007a15f48fde931d450b6e4aec19f2a1e1ef79e0b7d5e209b219883d7fa5d47c757e9c9dd2f5ca443e551eb18184c72e77461bc066dc1ff535d74b86c01fc33bcfc06af5eb0a104e05726bf1d75d34ceba9a66f2e4592974a4df5a17232acc73467783abc17e147921fccd14fd2fd9e058b5275ad723777864264f601350328758576cfc74c6dc997523d29664b39026e8ee417b85fff52f0ef42ffa6af94b8ea4327140a1e88dd9c0434d0fb0c125f6b11ba166a16472040dae03\",\"pubKey\":\"JHgSS7hbUNnYWsXgTbs2qz8mDmgPK8PnzXCTz7TZY81Sv14nRiRMrYyfbTPXWEjVRudMRo67MCyuis4wF7L6AcJUonnr6CRW5cLtCYXXxZbEpe6fvTyfJKYACxyXhVqtSNC7dxeoHN7hFPxX9MCjrupv9setJp4LswHbUmpuzqavg24F5mE3EMHts2njt3UVjX3gkmU5JQiXvQR52KdYBK6rQ3Q82d2Y4hvLcatkBhFJGwt87hUY2UM9aSyn3oCEtFE9d3vSXHYU4HcCJG8oWfcdStMgf2s9ewSB1peuRqjaAzyT6Eft7SBgMLkyQTRWgU6vh2Dd54FeMTKMkMCCX3JqrUZXmiJqijNGduttk9a4dSP4vMYyoi7DFS3dGmMiZ8x7EjygnUQrd4CJUY2B7kzaMun3XkaYwFARY2YrQH3phEsW9rYKuKxec6zR3R4yhTEtRQybLg4ZqD4MvHTW629VvSeQFgLyunf9s9isG7eX1MQqyAyxtz8qJw4uz4AKAr3dgrTi37j7qbPQqSXzaApxE3MXtB91WjYybDPwsXzKvEGYRSJsf6LHfVHKbTpfQ3HQ5aMCYBQJwo4FNf8x9dg1fgcNTpSosiUWhEi75JUDu6DMCzGWBBiR6DNT6PwGrjNnAyU3WAg9mCxLHoiiZjx6pc2EgPircSd1AgpNvgMohdU2U2j3NFmiMazymoYwi5i2EPPWjtyTRYRN\",\"timestamp\":\"1711936575\",\"type\":\"0\",\"amount\":\"500000.00000000\",\"applied\":\"12\",\"checksum\":\"c81b2017498e7c838d1d2d960c80e2c18a102959680414dd37ef143bcc777d7796b171d873683f93425a91fd\",\"from\":{\"1\":\"500000.01000000\"},\"to\":{\"4L5vswa8yS9VKsZzDJ2ry9gWY7KQon5bkvhG1CUuepkwvcy1xQmLsHA9DPmCDbufr\":\"500000.00000000\"},\"fee\":\"0.01000000\",\"totalAmount\":\"500000.01000000\"},{\"id\":\"11-2HJD6X8nJoe1sDNHkPspSLBK3Qsi5wp9HBCViYe3VCTFPrcH9zLFPZG43VgsE\",\"version\":7,\"blockHeight\":\"11\",\"nonce\":\"586146\",\"signature\":\"961868522d63d355ef24512a41eef70f6f92a2d43c2177a0174702e870d02604863adfc3e127291384fe57982103d52470015e5fc967ddf2da6cf50ab2005d732b65cea75ae0dde9b402172a4b122ba52dad1e1886fe228e80f572646839aa253b5e2b4224ea925cad02bfbac87042182df8b4449e6fb118d978eb59201e89bcc3940a03e7b81b4b222a6e6a03821d6b3bd5505135d1fb85a9ad69d4fae023caec218a7ca0bb9b387c386bb28df37d90ffb17831b77868b8f837fb14b7bdd6e7f923ec4bd363cb6c65f23e19946ae8f9fa150332fb01209b75c7d5ebc57749868318d67671578f8ec2827c5247bad48f7fd34d71494c2b02f46c614da69ea585cea8fabcf11a147e7b1ea7d7d6869bdaeec225fb58b1026e2e88c1b6d27e63045268f3e897f289ebd780af20f661a5ca609537ad1ac51f5e2f2b261be1c1b818dfe6c42b9aff3891fabd531e2137a018e73042461a60cec92761cc197fea2dd413500b78f2b39d0ffc9b313ba9aaeefdaa5f9917f2093d45afa69fc2bcd12342085f0d7122323d2783d459ba97a0be94424bb8d414e7f951cead56a4c5803a7be5d6a66e684fc5ec2bb733bf6b0c6cf2a14f91128ae045e6cedfbcbb15f9002541e4204f3d5f83df7ac9625099461164a6005323f714684f62a1c2bccb3fc5b3e082663342746fc234e5f75ab0ba4a04ef2e84af91b6664f9ad8dd00ac501406\",\"pubKey\":\"JHgSS7hbUNnYWsXgTbs2qz8mDmgPK8PnzXCTz7TZY81Sv14nRiRMrYyfbTPXWEjVRudMRo67MCyuis4wF7L6AcJUonnr6CRW5cLtCYXXxZbEpe6fvTyfJKYACxyXhVqtSNC7dxeoHN7hFPxX9MCjrupv9setJp4LswHbUmpuzqavg24F5mE3EMHts2njt3UVjX3gkmU5JQiXvQR52KdYBK6rQ3Q82d2Y4hvLcatkBhFJGwt87hUY2UM9aSyn3oCEtFE9d3vSXHYU4HcCJG8oWfcdStMgf2s9ewSB1peuRqjaAzyT6Eft7SBgMLkyQTRWgU6vh2Dd54FeMTKMkMCCX3JqrUZXmiJqijNGduttk9a4dSP4vMYyoi7DFS3dGmMiZ8x7EjygnUQrd4CJUY2B7kzaMun3XkaYwFARY2YrQH3phEsW9rYKuKxec6zR3R4yhTEtRQybLg4ZqD4MvHTW629VvSeQFgLyunf9s9isG7eX1MQqyAyxtz8qJw4uz4AKAr3dgrTi37j7qbPQqSXzaApxE3MXtB91WjYybDPwsXzKvEGYRSJsf6LHfVHKbTpfQ3HQ5aMCYBQJwo4FNf8x9dg1fgcNTpSosiUWhEi75JUDu6DMCzGWBBiR6DNT6PwGrjNnAyU3WAg9mCxLHoiiZjx6pc2EgPircSd1AgpNvgMohdU2U2j3NFmiMazymoYwi5i2EPPWjtyTRYRN\",\"data\":\"0141409be670f26e3a9d0fa3e4da555e334e7b5db53d6fd88e9e2e13d5b6a0f5e3ed2166b39cf6dce8e8282a30ae5e11bab9d92676d134fe5edff4c73235e2aec6b7c5fd002f0d000a2d01bec1923ea08fa066e56ba46557a9b5ecf3da82c484b7010d77a1650e7cdda12e4dd6fe9fbf004331aa46a6452d01bec1923ea08fa066e56ba46557a9b5ecf3da82c484b7010d77a1650e7cdda12e4dd6fe9fbf004331aa46a645\",\"timestamp\":\"1711936582\",\"type\":\"4\",\"amount\":\"50000.00000000\",\"applied\":\"12\",\"checksum\":\"e4823660dd8a05e6fdcba47b0ee8811ab28aa76ee386df3622e2450faa174bca797fbb65b73ac44da97546fd\",\"from\":{\"1\":\"50000.01000000\"},\"to\":{\"125D6XDzTZzQUWsyQZmQZmQZmQZmQZmQZmQZmQZmQZmQb8t25\":\"50000.00000000\"},\"fee\":\"0.01000000\",\"totalAmount\":\"50000.01000000\"}]", + "Superblock segments": "{}" + }, + "error": null, + "id": null } ``` -Note: The block format is essentially the same as for the method `getlastblock` and the transaction details are the same as for the method `gettransaction`. \ No newline at end of file +Note: The block format is essentially the same as for the method `getlastblocks` and the transaction details are the same as for the method `gettransaction`. \ No newline at end of file diff --git a/_api_docs/dlt_get_last_blocks.md b/_api_docs/dlt_get_last_blocks.md index 3de311a..df81c29 100644 --- a/_api_docs/dlt_get_last_blocks.md +++ b/_api_docs/dlt_get_last_blocks.md @@ -12,7 +12,7 @@ None | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured while fetching one or more of the blocks. | +| RPC_INTERNAL_ERROR | An unknown error occurred while fetching one or more of the blocks. | ### Output: - success: list of blocks in the result field with the error field set to null @@ -22,27 +22,38 @@ None GET http://localhost:8081/getlastblocks ``` { - "result": [ - { - "Block Number": "71", - "Version": "2", - "Block Checksum": "90330a25935159c8048aad049578216379e6bfaa7c85a0e29799c648fc673653", - "Last Block Checksum": "999ae1525a69e1e076b21c411aae20e1d2ffaae4660abfa9321b488010ae4250", - "Wallet State Checksum": "2c50b13f2d34fe6bb88cf4401ccbf11381823b78a330a1bd32ed00142297394a", - "Sig freeze Checksum": "5e16b955a50957271f36af1cab5dffde430559580f10e458366812b99d47a8df", - "PoW field": "null", - "Timestamp": "1548940839", - "Difficulty": "11730489520294945089", - "Signature count": "3", - "Transaction count": "1", - "Transaction amount": "0.20002001", - "Signatures":"...", - "TX IDs":"..." - }, - ... - ], - "error": null, - "id": null + "result": [ + { + "Block Number": "141", + "Version": "11", + "Block Checksum": "5ac6e40110fed2f51247e9e4c4d88aaed40210930b8107c2613e3c23f11d670ec6308aa596737d3b875e8d36f5ac4c27bcc89108160f01f6766c50a87b40e8ff", + "Last Block Checksum": "992e330ab42a476f5d2bbd040a68f97fad85f5dde467918813ba8a91f6fe4cdbfcc9380a62cb716df21ac49438842efa1c63377dd709b13302a9cab0e909b186", + "Wallet State Checksum": "086d138f4dbfc4b451e1ab6cf668920616293b50139151d23a74ef82673e73d6a9e14a001f52c87c5e44070e04123604543f6ee2e5ffa916a0fb9560b20dbb63", + "RegName State Checksum": "00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "Sig freeze Checksum": "86f20b9fb5f2c3bb251da877718cdfa3a5f56e0cf14f5793ae5ee9177e3b57acd9db7b6b65ecae303eb7bab745405773a5045964b734e6fe45a7208bde1ad95a", + "PoW field": "null", + "Timestamp": "1711940528", + "Difficulty": "11730489520294945089", + "Hashrate": "2999", + "Compacted Sigs": "False", + "Signature count": "3", + "Required Signature count": "2", + "Total Signer Difficulty": "497037650.71164806", + "Required Signer Difficulty": "5100000.00000000", + "Transaction count": "0", + "Transaction amount": "0.00000000", + "Total fees": "0.05787037", + "Signatures": "[{\"blockNum\":141,\"blockHash\":\"WsbkARD+0vUSR+nkxNiKrtQCEJMLgQfCYT48I/EdZw7GMIqllnN9O4dejTb1rEwnvMiRCBYPAfZ2bFCoe0Do/w==\",\"signature\":\"W4IrIKPr0sjDslfZE/JQrIw8KBg5TFKlwrPt3KmZUNPtOO0Fk4s/zUdvuP5cOyFhk0B5HzxB2zNVJ2k/hyZjClmT0KcxjxfjEBpWgchzK/pFQ/Vjia3LmRnacoaZeqh6MHxU5dc+4ZgM2e7cLxuAZFtCgzWHL9Oq8n+rees87nuT/ikWjhp2s/sxRsg2dipsQ9kbfK+wEbSiuVAYWb33qO5oic9ckZLxQGTUaEZrzZaFQc+A8OXr3a8M75mmYyQd3tg6+YL8HMufEB7gU659gXYJjv/QMfKP5M33IGP26gdhv67HdjXjPSQWUzN8/7ELU7/CMO7YBYhuDUgDF0oKsw==\",\"recipientPubKeyOrAddress\":{\"version\":1,\"addressWithChecksum\":\"AZCQzUzcufMr3dRSxxy9lb+U9DNbgieu6Nk/CRAwn+if2d0zz/SSo/zwRhBhBrIN\",\"addressNoChecksum\":\"AZCQzUzcufMr3dRSxxy9lb+U9DNbgieu6Nk/CRAwn+if2d0zz/SSo/zwRhBh\",\"nonce\":null,\"pubKey\":null},\"powSolution\":{\"blockNum\":63,\"solution\":\"+Jr2wf9M7m/4EYefb5A0EUZclf2dPZrk9DZuzWcweSYYaf9ehfSVGGaJ+ll3GcrdTJfuaooRSr+r9lXEawFJUw==\",\"signingPubKey\":\"AgAAAAAAAQAAwxG9K0FsStvIr81nN+lqw8QazZseS2nDcpxjgJDFz8nLTgCbM5PmmGUpGqIOwLd9ZMrCnztPGRwtq60ZxmTuF/aIP7CZbxX2i7AFGwaGcp0G2SOLqRYlkwQpNdtNcBVQjnRCu/k0IPebxZZZzPbwAqkLH1YaeCzfAobEdWHSwvJF4uXIWHlsh/rUHX5/pqd8iM1f+1ZLCzjFpH4o86oQNWv5BHYaqFw9espkcYpm76jsLExYHztSWuw8kJOeJPcSNWCHsZzVEwxanQYRz8dn7XUb17dsO9Yn28R2OYzfIePiyucJYNsYhTyrwRrj1aimi8b1zlK7m34T7ISjRu9gDQMAAAABAAE=\",\"checksum\":\"ZItPJoBgarW5wC25NojMkPM2nRhQJAUVOcI6GwSHQlj31eu48ixaYeln7d+ap5sQUvhoO+hsOUDPqflTEgAAAA==\",\"difficulty\":\"234338752.83116645\",\"bits\":3896268959389794361}},{\"blockNum\":141,\"blockHash\":\"WsbkARD+0vUSR+nkxNiKrtQCEJMLgQfCYT48I/EdZw7GMIqllnN9O4dejTb1rEwnvMiRCBYPAfZ2bFCoe0Do/w==\",\"signature\":\"RMwZE9XpcMkrO7uo4wecVXkWSN5k8WfQERGv/tWZnK8Tv/3IgsBp34ghcHq3eq2bDN8MwFtRs1xztsy9n5oTb01SG038QZc8Z+H9g2eHPJpU/1LBB2euIil0TjWxLgX4u5mmmiGXMmkS6fYebYniskN9C7pbOiAdf+rN6Ea2QYatlTTGRPtra4QeBMidrjVpjOnwVuqAuQIIKIuBENu4jSptd6UNV8y/eGFVoo7/iBUqrJ6704lnLeaxWM0oFyjXBiYFVCHFpXObnfQCp2gJjaY1568OIxmqK8kluzyisGHqhHmgfsEKtXmweJhC6HOByen2lAYXpA2hvnOErBWSOA==\",\"recipientPubKeyOrAddress\":{\"version\":1,\"addressWithChecksum\":\"Ab7Bkj6gj6Bm5WukZVeptezz2oLEhLcBDXehZQ583aEuTdb+n78AQzGqRqZFYZkO\",\"addressNoChecksum\":\"Ab7Bkj6gj6Bm5WukZVeptezz2oLEhLcBDXehZQ583aEuTdb+n78AQzGqRqZF\",\"nonce\":null,\"pubKey\":null},\"powSolution\":{\"blockNum\":54,\"solution\":\"tMfC+E0J5FblvH5C7Yz89mN9mX7fGwR0Cr4gj8qOdMuN1Qf7MPR+eobmG5wCiJLEktmEDaO4J1FuYSYMimsDig==\",\"signingPubKey\":\"AgAAAAAAAQAA4UuqtJql9hKoLWp/ZSHtFhG9NZKWRghWuaPvOkNn6tSjqcv5PtAh8OYdPtCIfdblgbtVyIohBjuwhAP9PL6uDFUnfVgle0z1xjDPLG/kapfXduZNRPbMB4STj/2h4yq71ar62lxNsc/9q8k/ZoDb9dIb62ZJ9zmWXW/+cIMmdd/hK8nzp28BDGKUSkRGkp4SWHw1FuRDXNmKrp5QwnFbxQL4Qiorrm7JF8O3TOLGoCk8ctALDwzAhHeLdvpBL+I1Np6fiuWfAlN1fnfJXnbJfZNWoj6AGdYkDGtA4lmgtBT2C88uWzja8G3yReOOcHlu87wglSEKSGn+3a+5mzeWwQMAAAABAAE=\",\"checksum\":\"rNNM7/zYFywZPH/NwhLEWv3qwBc+sf2H7knEwbHDakAT5wp/ltRUE2E4EwtXQk+eaxH9iefLPt2Bbci7QgAAAA==\",\"difficulty\":\"64359962.47808522\",\"bits\":3909893896016092478}},{\"blockNum\":141,\"blockHash\":\"WsbkARD+0vUSR+nkxNiKrtQCEJMLgQfCYT48I/EdZw7GMIqllnN9O4dejTb1rEwnvMiRCBYPAfZ2bFCoe0Do/w==\",\"signature\":\"2ftD6+81Fvxj2MaN5nzFUkG+hD8UqE0+jqOOyh0SSbpQm5d1X6K4AZpyAj3a/AcOWeVVpBV3EgsSrB7+haIriXW7AKMs4e1UGugt2ddErSwpVMbZELdov3OEekJoXQGu7vvAmsaarWlJxUyi+CfOVeydkhjr1UMM/qGjITjL65KDzoH/SL73jY+qEwyGBI87EEJ0IFdhYLHVsUOWd6aIAL4kD7gPxUNUoYz3m+s8GDiwm3kP7MLJja9E1rZ7m4ccgl1X83HLJS0kE1GVwdGdNYxWrVzUi7PxLFYu68RvBQ0ahPdGGEKn/rLDH9834qdiZfZaFjNPPu/uk3WJtoZQOw==\",\"recipientPubKeyOrAddress\":{\"version\":1,\"addressWithChecksum\":\"AX/5B43yaFLWKrgwFEvbKh8GK2nm/OHd/WxYoYLncQSWuHo1Ta5Lzw+o57XoCFi8\",\"addressNoChecksum\":\"AX/5B43yaFLWKrgwFEvbKh8GK2nm/OHd/WxYoYLncQSWuHo1Ta5Lzw+o57Xo\",\"nonce\":null,\"pubKey\":null},\"powSolution\":{\"blockNum\":109,\"solution\":\"/r2nTNsRX9+RYQKSeQUbouALPEvkGGU6DDdhQDVT390LpisQ8daqkPgP81bdyLb0t+Sh7LNf/jFlz7EK276yZA==\",\"signingPubKey\":\"AgAAAAAAAQAA5asTegwBLItZTX70IZVtEDKAmrrJ93AXV/NVIkbF7/hMPkUn6rDfIaCkSRrOydxADtwexhGkzw6Mvizi1kfQVxHnZQwohGSUGHVgxZB5C6Y9rMawrwpkVlaMD+gliaPGroiOrgoYXBPgC44Jhucq6BWHCvDmP1os7UmiT/cz2qUE2RFrQk/K0enlZUT3vEezqgoqa+FekL6320D+kIS3KPCjRPpHYDBHygASKfAHiuA59p/N+MHj4nViG3RddSSY4/7b02l7WVcSEZnFWz42uvf9g+zRf/fZHc4dOiADUyuz7SLTrHuQVI3GeCMnJQZTUJS/RhwaE+YvhnI+FYq/WQMAAAABAAE=\",\"checksum\":\"c573X/+P3d6tR82LkmTUME8crPONQWBxZuyVlStXmKGXN+h5goMYRCFEnoPXROwYE8+uf/pcBTleepmnFQAAAA==\",\"difficulty\":\"198338935.40239639\",\"bits\":3897205330183862533}}]", + "Sig Checksum": "7be56a933c134a92d5dee43d92b102110313208d24342df4588c03e9f34f0e63dff0a462d091494e9fdeec79c96aecc4b4ebf9aad61a2b422e3df23ed7660357", + "Signer Bits": "0000000000000000", + "TX IDs": "[]", + "Last Superblock": "0", + "Last Superblock checksum": "null" + }, + ... + ], + "error": null, + "id": null } ``` diff --git a/_api_docs/dlt_get_mining_block.md b/_api_docs/dlt_get_mining_block.md index 78d9c17..ad59ecf 100644 --- a/_api_docs/dlt_get_mining_block.md +++ b/_api_docs/dlt_get_mining_block.md @@ -31,7 +31,7 @@ Note: In a cooperative pool mining, the solution should incorporate the pool con | Error | Description | | --- | --- | | RPC_INVALID_PARAMETER | The required parameter is missing. | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: diff --git a/_api_docs/dlt_get_transaction.md b/_api_docs/dlt_get_transaction.md index 755305a..765be35 100644 --- a/_api_docs/dlt_get_transaction.md +++ b/_api_docs/dlt_get_transaction.md @@ -16,40 +16,38 @@ Returns the information about a specified transaction. | Error | Description | | --- | --- | | RPC_INVALID_PARAMETER | The specified transaction id was invalid. | -| RPC_INTERNAL_ERROR | An unknown error occured while fetching the transaction details. | +| RPC_INTERNAL_ERROR | An unknown error occurred while fetching the transaction details. | ### Output: - success: transaction information JSON encoded in the result field with the error field set to null - fail: JSON encoded details with a non-null error and a null result ### Example: -GET http://localhost:8081/gettransaction?id=1-7on93B4WDRguRpaB22osfJV9EPs24pyJWgTkKpNrLV5p +GET http://localhost:8081/gettransaction?id=11-284bKK4GvGV9stfEGqu1CP4A9T3tTzrbkUsUd2JestPVE3KDPM5Um7sn3Dfv4 ``` { - "result": { - "id": "stk-44-49-4Eywy3ngSxpvVbXTKopcuXe1xetoR4ALAsmfCBFiMtvd", - "version": 1, - "blockHeight": "49", - "nonce": "0", - "signature": "5374616b65", - "pubKey": "1ixianinfinimine234234234234234234234234234242HP", - "data": "2c00000000000000", - "timeStamp": "1548940147", - "type": "2", - "amount": "0.20002000", - "applied": "0", - "checksum": "36781655c23b509f85e46513608ba359b849795580344c5340c778c51e466fd1", - "from": { - "1": "0.20002000" - }, - "to": { - "15iYQBgVhq4JeY3TUfNaMBNFkz27UCQWFjjay14C4b3EuHofG": "0.10003000", - "19V9VYuGfqoGjRbGZgcF8XNrAeb5REF8gCZKhp7ZsNX3rG8VZ": "0.00010001", - "1JKZFqQs4yiH6Dq4bfom7xcpL6zG53DrjcY6HD9QJ6cRWmXdq": "0.09988999" - }, - "fee": "0.00000000" - }, - "error": null, - "id": null + "result": { + "id": "11-284bKK4GvGV9stfEGqu1CP4A9T3tTzrbkUsUd2JestPVE3KDPM5Um7sn3Dfv4", + "version": 7, + "blockHeight": "11", + "nonce": "313950", + "signature": "54b6315260a94d...6b11ba166a16472040dae03", + "pubKey": "JHgSS7hbUNnYWsXgT...ohdU2U2j3NFmiMazymoYwi5i2EPPWjtyTRYRN", + "timestamp": "1711936575", + "type": "0", + "amount": "500000.00000000", + "applied": "12", + "checksum": "c81b2017498e7c838d1d2d960c80e2c18a102959680414dd37ef143bcc777d7796b171d873683f93425a91fd", + "from": { + "1": "500000.01000000" + }, + "to": { + "4L5vswa8yS9VKsZzDJ2ry9gWY7KQon5bkvhG1CUuepkwvcy1xQmLsHA9DPmCDbufr": "500000.00000000" + }, + "fee": "0.01000000", + "totalAmount": "500000.01000000" + }, + "error": null, + "id": null } ``` diff --git a/_api_docs/dlt_get_tx_outset_info.md b/_api_docs/dlt_get_tx_outset_info.md index 6e6fb47..8c6855f 100644 --- a/_api_docs/dlt_get_tx_outset_info.md +++ b/_api_docs/dlt_get_tx_outset_info.md @@ -16,7 +16,7 @@ None | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: diff --git a/_api_docs/dlt_get_wallet.md b/_api_docs/dlt_get_wallet.md index 7981473..9523e27 100644 --- a/_api_docs/dlt_get_wallet.md +++ b/_api_docs/dlt_get_wallet.md @@ -16,7 +16,7 @@ Returns the information about a specified address/wallet. | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | Note: Attempting to get the details of an invalid value will return empty data (no public key, balance = 0) diff --git a/_api_docs/dlt_get_wallet_list.md b/_api_docs/dlt_get_wallet_list.md index d9cfb03..30df05b 100644 --- a/_api_docs/dlt_get_wallet_list.md +++ b/_api_docs/dlt_get_wallet_list.md @@ -16,7 +16,7 @@ None | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - success: wallet information as a JSON-encoded list in the result field with the error field set to null diff --git a/_api_docs/dlt_miner_stats.md b/_api_docs/dlt_miner_stats.md index 3bb55c7..245ef24 100644 --- a/_api_docs/dlt_miner_stats.md +++ b/_api_docs/dlt_miner_stats.md @@ -12,7 +12,7 @@ None | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - success: miner stats JSON-encoded in the result field with the error field set to null diff --git a/_api_docs/dlt_presence_list.md b/_api_docs/dlt_presence_list.md index 7030000..bbf570a 100644 --- a/_api_docs/dlt_presence_list.md +++ b/_api_docs/dlt_presence_list.md @@ -12,7 +12,7 @@ None | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - success: presence list JSON-encoded in the result field with the error field set to null @@ -22,28 +22,41 @@ None GET http://localhost:8081/pl ``` { - "result":[ - { - "version": 0, - "wallet": "AK2U1C1+vRWrFdIzeFixcGl29ytd/QH142eb9s8pkzx3AMmA", - "pubkey": "AAIAANl...zOr6aTXAs71VAwAAAAEAAQ==", - "metadata": null, - "addresses": [ - { - "version": 0, - "device": "57e6814f-fc0f-4b12-ba28-674c18304f5d", - "address":"172.20.207.81:10000", - "type": "M", - "nodeVersion": "xdc-0.6.1a-dev", - "lastSeenTime": 1548942000, - "signature": "lQQe7...D85YgNao=" - } - ], - "owner": " " - }, - ... - ], - "error": null, - "id": null + "result": [ + { + "version": 1, + "wallet": { + "version": 1, + "addressWithChecksum": "Ab7Bkj6gj6Bm5WukZVeptezz2oLEhLcBDXehZQ583aEuTdb+n78AQzGqRqZFYZkO", + "addressNoChecksum": "Ab7Bkj6gj6Bm5WukZVeptezz2oLEhLcBDXehZQ583aEuTdb+n78AQzGqRqZF", + "nonce": null, + "pubKey": null + }, + "pubkey": "AQAAAAAAAgAA7...u7w/us52kDAAAAAQAB", + "metadata": null, + "addresses": [ + { + "version": 2, + "device": "izLPtZb0b0qi3AWT061Ihw==", + "address": "10.23.11.2:10000", + "type": "M", + "nodeVersion": "xdc-0.9.2a", + "lastSeenTime": 1711940304, + "signature": "Rxcejj...mrezzoITgxAN9rS5eBg9Y=" + } + ], + "powSolution": { + "blockNum": 54, + "solution": "tMfC+E0J5FblvH5C7Yz89mN9mX7fGwR0Cr4gj8qOdMuN1Qf7MPR+eobmG5wCiJLEktmEDaO4J1FuYSYMimsDig==", + "signingPubKey": "AgAAAAAAAQAA4...AAAABAAE=", + "checksum": "rNNM7/zYFywZPH/NwhLEWv3qwBc+sf2H7knEwbHDakAT5wp/ltRUE2E4EwtXQk+eaxH9iefLPt2Bbci7QgAAAA==", + "difficulty": "64359962.47808522", + "bits": 3909893896016092700 + } + }, + ... + ], + "error": null, + "id": null } ``` \ No newline at end of file diff --git a/_api_docs/dlt_regname_list.md b/_api_docs/dlt_regname_list.md new file mode 100644 index 0000000..fb3d7d3 --- /dev/null +++ b/_api_docs/dlt_regname_list.md @@ -0,0 +1,49 @@ +--- +title: Get Registered Names List +type: dlt +--- + +## **Debug only** + +## Get Registered Names List +Returns registered names, capped to the first 50 entries. This function is primarily used when debugging or testing and has very little value in production use. + +### Method: `regNameList` +### Input parameters: +None + +### Errors: + +| Error | Description | +| --- | --- | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | + +### Output: +- success: Registered Names as a JSON-encoded list in the result field with the error field set to null +- fail: JSON encoded details with a non-null error and a null result + +### Example: +GET http://localhost:8081/regNameList +``` +{ + "result": [ + { + "name": "409be670f26e3a9d0fa3e4da555e334e7b5db53d6fd88e9e2e13d5b6a0f5e3ed2166b39cf6dce8e8282a30ae5e11bab9d92676d134fe5edff4c73235e2aec6b7c5", + "capacity": "10", + "expirationBlockHeight": "1728404", + "updatedBlockHeight": "447", + "allowSubnames": "False", + "subnamePrice": "0.00000000", + "subnameFeeRecipient": "null", + "dataRecords": {}, + "dataMerkleRoot": "null", + "recoveryHash": "01bec1923ea08fa066e56ba46557a9b5ecf3da82c484b7010d77a1650e7cdda12e4dd6fe9fbf004331aa46a645", + "nextPkHash": "01bec1923ea08fa066e56ba46557a9b5ecf3da82c484b7010d77a1650e7cdda12e4dd6fe9fbf004331aa46a645", + "signaturePk": "010000000000020000ec...fb682dabdcce76903000000010001", + "signature": "10a7c0de5fb682d2838a...25146472a435e47b48edb5b23f5bd" + } + ], + "error": null, + "id": null +} +``` diff --git a/_api_docs/dlt_set_block_selection_algorithm.md b/_api_docs/dlt_set_block_selection_algorithm.md index ff13758..7a3de92 100644 --- a/_api_docs/dlt_set_block_selection_algorithm.md +++ b/_api_docs/dlt_set_block_selection_algorithm.md @@ -28,7 +28,7 @@ Modifies the running DLT Node or Miner software and changes the way blocks are s | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - success: JSON result with all null values diff --git a/_api_docs/dlt_status.md b/_api_docs/dlt_status.md index e5a669d..96a38c2 100644 --- a/_api_docs/dlt_status.md +++ b/_api_docs/dlt_status.md @@ -13,13 +13,14 @@ Note: This function overrides the `status` method of the IXICore implementation | Parameter | Type | Required | Description | | --- | --- | --- | --- | | verbose | Boolean | No | Additional details are returned. | +| vv | Boolean | No | Additional details are returned. | ### Errors: | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - success: status JSON-encoded in the result field with the error field set to null @@ -29,37 +30,80 @@ Note: This function overrides the `status` method of the IXICore implementation GET http://localhost:8081/status ``` { - "result": { - "Node Version": "xdc-0.6.1a-dev", - "Network type": "testnet", - "My time": 1548942886, - "Network time difference": 0, - "My External IP": "172.20.207.81", - "Queues": "Rcv: 0, RcvTx: 0, SendClients: 0, SendServers: 0, Storage: 0, Logging: 0", - "Node Deprecation Block Limit": 216000, - "DLT Status": "Active", - "Block Processor Status": "Running", - "Block Height":130, "Block Version": 2, - "Required Consensus": 3, - "Wallets": 5, - "Presences": 3, - "Supply": "200020024.00235090", - "Applied TX Count": 126, - "Unapplied TX Count": 0, - "WS Checksum": "6f9e68d6ea27ee59a6f40f6493502c78e639fde149e6a4a9220d197deb21b1cb", - "WS Delta Checksum": "6f9e68d6ea27ee59a6f40f6493502c78e639fde149e6a4a9220d197deb21b1cb", - "Network Clients": [ - "172.20.207.81:55700", - "172.20.207.81:55859" - ], - "Network Servers": [ - ], - "Masters": 3, - "Relays": 0, - "Clients": 0, - "Workers": 0 - }, - "error": null, - "id": null + "result": { + "Core Version": "xcore-0.9.2a", + "Node Version": "xdc-0.9.2a", + "Network type": "test", + "My time": 1711941545, + "Network time difference": 0, + "Real network time difference": 0, + "My External IP": "10.23.11.2", + "My Listening Port": 10000, + "Node Deprecation Block Limit": 4600023, + "Update": "", + "DLT Status": "Active", + "Core Status": 1, + "Block Processor Status": "Running", + "Block Height": 174, + "Block Version": 11, + "Block Signature Count": 3, + "Block Total Signer Difficulty": "353523619.92054555", + "Block generated seconds ago": 15, + "Network Block Height": 174, + "Node Type": "M", + "Connectable": true, + "Required Consensus": 2, + "Signer Difficulty": "10000000.00000001", + "Signer Bits": "f4caab297fad0137", + "Signer Hashrate": 159935, + "Signer Last PoW Solution": { + "blockNum": 161, + "solution": "tMfC+E0J5FblvH5C7Yz89mN9mX7fGwR0Cr4gj8qOdMuN1Qf7MPR+eobmG5wCiJLEktmEDaO4J1FuYSYMlibShw==", + "checksum": "F4N1XA+JRPVsgs7GUlh9XSoi4BYRCf+Z+8rDc92p9cGVonc7eutKslw2dSQz9C8z79luWCQkSSL3SXTwpwAAAA==", + "difficulty": "25574525.73630105", + "bits": "4922f74974f0a736" + }, + "Signer Active PoW Solution": { + "blockNum": 108, + "solution": "tMfC+E0J5FblvH5C7Yz89mN9mX7fGwR0Cr4gj8qOdMuN1Qf7MPR+eobmG5wCiJLEktmEDaO4J1FuYSYMlCO4Qg==", + "checksum": "AJ5oD5hdeL6gj0J+DXpsE/DDvLPumoHASAE4Hqulo4PDgyNh7MssFSFinZHAGImFhN5tiHJLaP/43arFZAAAAA==", + "difficulty": "42620583.04018759", + "bits": "68fff8ddaac56436" + }, + "Wallets": 3, + "Presences": 3, + "Supply": "199949999.95000000", + "Applied TX Count": 6, + "Unapplied TX Count": 0, + "Names": 1, + "Names Reward Pool": "49990.56712969", + "Masters": 3, + "Relays": 0, + "Clients": 0, + "Queues": { + "RcvLow": 0, + "RcvMedium": 0, + "RcvHigh": 0, + "SendClients": 0, + "SendServers": 0, + "Logging": 1, + "Pending Transactions": 0, + "Storage": 0, + "Inventory": 660, + "Inventory Processed": 660, + "Activity": 0 + }, + "WS Checksum": "4080272478b10685b210220ac65434db2b4d481adc2da3b0bebf2491768efd8327685d672c3e772a5358db700d34456075142f1e7547bfe81f643c3cb8bae1d6", + "RN Checksum": "5679fbdcdf5694527dd5f2e36983ca2d6860d32d153b485a1f0529bbb788cecfbf2e5298c1b22bcb020d52de809406db8d54087a708483d3d7435178034aaaa0", + "Blockchain Scanning Active": false, + "Activity Scanner Last Block": 0, + "Network Clients": [ + "10.23.11.2:52752", + "10.23.11.2:52811" + ], + "Network Servers": [] + }, + "error": null, + "id": null } ``` diff --git a/_api_docs/dlt_submit_mining_solution.md b/_api_docs/dlt_submit_mining_solution.md index 9323bb7..60b518a 100644 --- a/_api_docs/dlt_submit_mining_solution.md +++ b/_api_docs/dlt_submit_mining_solution.md @@ -18,7 +18,7 @@ Submits the given solution to the PoW mining problem for the specified block. | Error | Description | | --- | --- | | RPC_INVALID_PARAMETER | One or more of the required parameters are missing. | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: diff --git a/_api_docs/dlt_supply.md b/_api_docs/dlt_supply.md index c9c2311..0678901 100644 --- a/_api_docs/dlt_supply.md +++ b/_api_docs/dlt_supply.md @@ -12,7 +12,7 @@ None | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - success: IXI supply as a decimal number in the result field with the error field set to null diff --git a/_api_docs/dlt_transaction_list.md b/_api_docs/dlt_transaction_list.md index 506deda..0d40995 100644 --- a/_api_docs/dlt_transaction_list.md +++ b/_api_docs/dlt_transaction_list.md @@ -16,7 +16,7 @@ Returns the list of all transactions in the redacted window. | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - success: transaction list JSON-encoded in the result field with the error field set to null @@ -26,34 +26,31 @@ Returns the list of all transactions in the redacted window. GET http://localhost:8081/tx ``` { - "result": { - "stk-91-96-GEBR49QVbNoc4q8HirWTa9oAixWiNQ9TNJnBnU49VsbU": { - "id": "stk-91-96-GEBR49QVbNoc4q8HirWTa9oAixWiNQ9TNJnBnU49VsbU", - "version": 1, - "blockHeight": "96", - "nonce": "0", - "signature": "5374616b65", - "pubKey": "1ixianinfinimine234234234234234234234234234242HP", - "data": "5b00000000000000", - "timeStamp": "1548941727", - "type": "2", - "amount": "0.20002001", - "applied": "97", - "checksum": "bee300c0b2596d66f82e15ac1e431cfce7391d1f0daec41a25326990817ff163", - "from": { - "1":"0.20002001" - }, - "to": { - "15iYQBgVhq4JeY3TUfNaMBNFkz27UCQWFjjay14C4b3EuHofG": "0.10003001", - "19V9VYuGfqoGjRbGZgcF8XNrAeb5REF8gCZKhp7ZsNX3rG8VZ": "0.00010001", - "1JKZFqQs4yiH6Dq4bfom7xcpL6zG53DrjcY6HD9QJ6cRWmXdq": "0.09988999" - }, - "fee": "0.00000000", - "totalAmount": "0.20002001" - }, - ... - }, - "error": null, - "id": null + "result": { + "11-284bKK4GvGV9stfEGqu1CP4A9T3tTzrbkUsUd2JestPVE3KDPM5Um7sn3Dfv4": { + "id": "11-284bKK4GvGV9stfEGqu1CP4A9T3tTzrbkUsUd2JestPVE3KDPM5Um7sn3Dfv4", + "version": 7, + "blockHeight": "11", + "nonce": "313950", + "signature": "54b6315260a9c...ae03i5i2EPPWYRbUN", + "pubKey": "JHgSS7hbUNnYWsX...i5i2EPPWjtyTRYRN", + "timestamp": "1711936575", + "type": "0", + "amount": "500000.00000000", + "applied": "12", + "checksum": "c81b2017498e7c838d1d2d960c80e2c18a102959680414dd37ef143bcc777d7796b171d873683f93425a91fd", + "from": { + "1": "500000.01000000" + }, + "to": { + "4L5vswa8yS9VKsZzDJ2ry9gWY7KQon5bkvhG1CUuepkwvcy1xQmLsHA9DPmCDbufr": "500000.00000000" + }, + "fee": "0.01000000", + "totalAmount": "500000.01000000" + }, + ... + }, + "error": null, + "id": null } ``` \ No newline at end of file diff --git a/_api_docs/dlt_unapplied_transaction_list.md b/_api_docs/dlt_unapplied_transaction_list.md index 44105cd..5b864c1 100644 --- a/_api_docs/dlt_unapplied_transaction_list.md +++ b/_api_docs/dlt_unapplied_transaction_list.md @@ -17,7 +17,7 @@ Returns the list of unapplied transactions in the memory pool. | Error | Description | | --- | --- | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: - success: unapplied transaction list JSON-encoded in the result field with the error field set to null diff --git a/_api_docs/dlt_verify_mining_solution.md b/_api_docs/dlt_verify_mining_solution.md index 2a0063b..85ec443 100644 --- a/_api_docs/dlt_verify_mining_solution.md +++ b/_api_docs/dlt_verify_mining_solution.md @@ -19,7 +19,7 @@ Checks the given solution against the block's difficulty field to determine if i | Error | Description | | --- | --- | | RPC_INVALID_PARAMETER | One or more of the required parameters are missing. | -| RPC_INTERNAL_ERROR | An unknown error occured in the node. Please check the node log for details. | +| RPC_INTERNAL_ERROR | An unknown error occurred in the node. Please check the node log for details. | ### Output: diff --git a/_layouts/default.html b/_layouts/default.html index 1e4fef2..c810547 100644 --- a/_layouts/default.html +++ b/_layouts/default.html @@ -47,9 +47,9 @@
-
+
- +
Ixian Documentation @@ -72,7 +72,7 @@


- © COPYRIGHT IXIAN.IO 2020
+ © COPYRIGHT IXIAN.IO 2024
ALL RIGHTS RESERVED
diff --git a/assets/css/main.css b/assets/css/main.css index e2e4ae4..05891d3 100644 --- a/assets/css/main.css +++ b/assets/css/main.css @@ -125,9 +125,7 @@ header .logoWrapper img header .welcomeText { display: inline-block; - padding: 0px 20px; margin-bottom: 20px; - max-width: 750px; } header nav diff --git a/assets/images/ixianLogo.png b/assets/images/ixianLogo.png new file mode 100644 index 0000000..cd56806 Binary files /dev/null and b/assets/images/ixianLogo.png differ