Wallet API Reference

The wallet exposes a JSON-RPC API over Websocket by default at the URL 127.0.0.1:11212. It can be set in the Witnet configuration file as follows:
1
  [wallet]
2
  server_addr = "127.0.0.1:11212"
Copied!
Summary
Method Name
Request Params
Response
​close_session​
session_id
success
​create_data_request​
session_id, wallet_id, request, fee, (fee_type)
bytes, transaction, transaction_id
​create_mnemonics​
length
mnemonics
​create_vtt​
session_id, wallet_id, fee, (fee_type), [address, value, (time_lock)], (utxo_strategy), (selected_utxos)
bytes, metadata, transaction, transaction_id
​create_wallet​
(name), (description), seed_source, seed_data, password, (overwrite), (backup_password), (birth_date)
wallet_id
​delete_wallet​
session_id, wallet_id
success
​export_master_key​
session_id, wallet_id, password
private_key
​generate_address​
session_id, wallet_id, (external)
address, path
​get​
session_id, wallet_id, key
value
​get_addresses​
session_id, wallet_id, (offset), (limit), (external)
address[], total
​get_balance​
session_id, wallet_id
confirmed, local, unconfirmed
​get_transactions​
session_id, wallet_id, (offset), (limit)
transactions[], total
​get_utxo_info​
session_id, wallet_id
output_info[]
​get_wallet_infos​
(none)
wallet_info[]
​lock_wallet​
session_id, wallet_id
success
​refresh_session​
session_id
success
​resync_wallet​
session_id, wallet_id
success
​rpc.off​
(subscription_id[])
(none)
​rpc.on​
session_id
(subscription_id)
​run_rad_request​
request
result
Wallet API Endpoints
create_data_request
The method create_data_request creates a data request transaction object. It contains all required cryptographic information in order to be later sent to a Witnet node (e.g. by using the method send_transaction).
Request with parameters:
session_id: number, generated identifier obtained from unlocking the wallet. See Unlock Wallet.
wallet_id: String, the ID associated to the wallet. See get_wallet_infos.
fee: number, amount in nanoWitswill be earned by the miner that publishes the request.
fee_type: (optional) String, fee type chosen between weighted or absolute. Defaults to weighted if not inserted.
request: DataRequestOutput, a struct with required data request fields.
data_request: RADRequest, data request with CBOR codification.
witness_reward: number, reward in nanoWits to the witnesses of the data request.
witnesses: number, minimum number of witnet nodes that must perform the request.
commit_and_reveal_fee: number, amount in nanoWits that will be earned by the miner for each each valid commitment and reveal transaction.
min_consensus_percentage: number, , minimum of consensus required to consider the request as valid.
collateral: number, collateral amount in nanoWits.
More information about the parameters can be found in the tutorial of data request parameters fine-tuning.
As an example, this data request created a data request that retrives the last Bitcoin blockhash from two different sources using three witnesses:
1
{
2
  "jsonrpc": "2.0",
3
  "method": "create_data_request",
4
  "id": "1",
5
  "params": {
6
    "session_id": "678f4320d8f8ff1a9f86f56f20f0c6a76fba92db0e8e5b1fd2f21092de985f3e",
7
    "wallet_id": "8f5b85981addad621a86f01a1ddb646ccd90620c95247948ce8d99feefd0496c",
8
    "request": {
9
      "data_request": {
10
        "time_lock": 0,
11
        "retrieve": [
12
          {
13
            "kind": "HTTP-GET",
14
            "url": "https://blockchain.info/q/latesthash",
15
            "script": [
16
              128
17
            ]
18
          },
19
          {
20
            "kind": "HTTP-GET",
21
            "url": "https://api-r.bitcoinchain.com/v1/status",
22
            "script": [130, 24, 119, 130, 24, 103, 100, 104, 97, 115, 104]
23
          }
24
        ],
25
        "aggregate": {
26
          "filters": [],
27
          "reducer": 2
28
        },
29
        "tally": {
30
          "filters": [
31
            {
32
              "op": 8,
33
              "args": []
34
            }
35
          ],
36
          "reducer": 2
37
        }
38
      },
39
      "witness_reward": 1000,
40
      "witnesses": 3,
41
      "commit_and_reveal_fee": 10,
42
      "min_consensus_percentage": 51,
43
      "collateral": 1000000000
44
    },
45
    "fee": 0
46
  }
47
}
Copied!
The create_data_request response will include the following data:
bytes: String, data request bytes represented in hexadecimal format.
transaction: DataRequest, all transactional information regarding the created data request.
body: Includes the data request output, inputs and outputs of the transaction.
signatures: The signature of the transaction and the public key
transaction_id: String, unique transaction identifier.
Example of a create_data_request response:
1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "bytes": "1297030aa0020a280a260a220a201a79a8689f9ede624043993b620e6042d2b7e80573c19f6752328db4a25c6fc41001121f0a160a14e6635e52a21ab22eaf27bdd036dd104b25d712c310eeabd2d4d1031ad2010abc011229122468747470733a2f2f626c6f636b636861696e2e696e666f2f712f6c6174657374686173681a01801237122868747470733a2f2f6170692d722e626974636f696e636861696e2e636f6d2f76312f7374617475731a0b8218778218676468617368124a122868747470733a2f2f6170692e626c6f636b63686169722e636f6d2f626974636f696e2f73746174731a1e83187782186664646174618218676f626573745f626c6f636b5f686173681a02100222060a020808100210e8071803200a280a301e3833408094ebdc0312720a4b0a490a473045022100dc671fb90cab42baa3a8e26bcd91da954b05299840539288624518ecc3b85140022033d6d65405ada2a72a1a55bb33577a76ef9ab320b58df96a4ce0ab498042620212230a2103f0acd97ec011b875376888b3538f70644e2ad537f61169e95b7c703176925d00",
5
    "transaction": {
6
      "DataRequest": {
7
        "body": {
8
          "dr_output": {
9
            "collateral": 1000000000,
10
            "commit_and_reveal_fee": 10,
11
            "data_request": {
12
              "aggregate": {
13
                "filters": [],
14
                "reducer": 2
15
              },
16
              "retrieve": [
17
                {
18
                  "kind": "HTTP-GET",
19
                  "script": [
20
                    128
21
                  ],
22
                  "url": "https:\/\/blockchain.info\/q\/latesthash"
23
                },
24
                {
25
                  "kind": "HTTP-GET",
26
                  "script": [130,24,119,130,24,103,100,104,97,115,104],
27
                  "url": "https:\/\/api-r.bitcoinchain.com\/v1\/status"
28
                }
29
              ],
30
              "tally": {
31
                "filters": [
32
                  {
33
                    "args": [],
34
                    "op": 8
35
                  }
36
                ],
37
                "reducer": 2
38
              },
39
              "time_lock": 0
40
            },
41
            "min_consensus_percentage": 51,
42
            "witness_reward": 1000,
43
            "witnesses": 3
44
          },
45
          "inputs": [
46
            {
47
              "output_pointer": "1a79a8689f9ede624043993b620e6042d2b7e80573c19f6752328db4a25c6fc4:1"
48
            }
49
          ],
50
          "outputs": [
51
            {
52
              "address": "twit1ue34u54zr2ezate8hhgrdhgsfvjawykr9kxtqq",
53
              "time_lock": 0,
54
              "value": 124999996910
55
            }
56
          ]
57
        },
58
        "signatures": [
59
          {
60
            "public_key": {
61
              "bytes": [240,172,217,126,192,17,184,117,55,104,136,179,83,143,112,100,78,42,213,55,246,17,105,233,91,124,112,49,118,146,93,0],
62
              "compressed": 3
63
            },
64
            "signature": {
65
              "Secp256k1": {
66
                "der": [48,69,2,33,0,220,103,31,185,12,171,66,186,163,168,226,107,205,145,218,149,75,5,41,152,64,83,146,136,98,69,24,236,195,184,81,64,2,32,51,214,214,84,5,173,162,167,42,26,85,187,51,87,122,118,239,154,179,32,181,141,249,106,76,224,171,73,128,66,98,2]
67
              }
68
            }
69
          }
70
        ]
71
      }
72
    },
73
    "transaction_id": "b7dbb6fdbf5f07ab6d0b037a9e2119d102172f372ffcdf4630122d1b2914ae02"
74
  },
75
  "id": "1"
76
}
Copied!
create_mnemonics
The JsonRPC method create_mnemonics is used to generate a BIP39 mnemonic sentence that can be used to generate a new HD wallet.
Request with parameters:
length: number, indicating how many words the mnemonic sentence should have. Must be one of these: 12, 15, 18, 21 or 24.
1
{
2
  "jsonrpc": "2.0",
3
  "method": "create_mnemonics",
4
  "params": {
5
    "length": 12
6
  },
7
  "id": 1
8
}
Copied!
Response:
mnemonics: String, list of words of the mnemonic sentences.
1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "mnemonics": "day voice lake monkey suit bread occur own cattle visit object ordinary"
5
  },
6
  "id": 1
7
}
Copied!
create_vtt
The method create_vtt is used to generate a Value Transfer Transaction (VTT) object. It will contain all required cryptographic information in order to be later broadcasted to a Witnet node (e.g. by using the method send_transaction).
Request with parameters:
session_id: String, session ID assigned when unlocking the wallet. See unlock_wallet.
wallet_id: String, ID associated to the wallet. See get_wallet_infos.
fee: number, miner fee in nanoWits.
fee_type (optional): String, fee type chosen between weighted or absolute. Defaults to weighted if not inserted.
label (optional): String, label to refer the vtt.
outputs: Array, list of transaction outputs.
address: String, the recipient address.
amount: number, value to transfer in nanoWits.
time_lock: number, indicates the epoch from which the data request could run before, before this epoch the request is ignored.
utxo_strategy (optional): random | big_first | small_first, enum that allows to choose 3 different strategies for selecting which unspent transaction outputs are used as input of the VTT transaction.
selected_utxos (optional): Array, array of selected output pointers to be spent.
Example:
1
{
2
  "jsonrpc": "2.0",
3
  "method": "create_vtt",
4
  "params": {
5
    "session_id": "7bbb8d1bec5419451fa57ae686de93d26e8d265b9328f5dc2f1e6e28acac4201",
6
    "wallet_id": "8f5b85981addad621a86f01a1ddb646ccd90620c95247948ce8d99feefd0496c",
7
    "fee": 1,
8
    "label": "",
9
    "outputs": [
10
      {
11
        "address": "twit1nfkythqds4r2hz3le2zaauxtl7yum76jd0ut9c",
12
        "amount": 1000,
13
        "time_lock": 0
14
      }
15
    ],
16
    "utxo_strategy": "random",
17
    "selected_utxos": [
18
      "3a1ff5de49142d21280dc62dbdc02810a9665e9c23bb27b9094d6dbd6f4e527f:0",
19
      "3cebaae8cc942056c475d7f9866a5de1be41aea0a1bcdb63edd533b9caef4043:0"
20
    ]
21
  },
22
  "id": 1
23
}
Copied!
The create_vtt response will include all the information about the transaction:
bytes: String, data request bytes represented in hexadecimal format.
metadata: description of the outcome of the transaction, includes
fee: number, miner fee in nanoWits.
time_lock: number, indicates the epoch from which the funds will be available, before this epoch the funds are blocked.
to: String, the address of the reciever.
value: number, value that has been transferd in nanoWits.
transaction: ValueTransfer, all transactional information regarding the created value transfer.
body: Includes the inputs and outputs of the transaction.
signatures: The signature of the transaction and the public key
transaction_id: String, unique transaction identifier.
Example of a create_vtt response:
1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "bytes": "0add010a670a280a260a220a204c4cc66b8bf7828797596ded89db7ddb1cd5b44dc18007738ef3d40e089a6add1001121a0a160a149a6c45dc0d8546ab8a3fca85def0cbff89cdfb521001121f0a160a1425e15594103fde1d9864807d091923ab648d6d1f10fec3d2d4d10312720a4b0a490a4730450221008e0c49acdcc92f63c6c71aa1ce7bb4d0524775c8e0af9d597d1b8bdfd8d2741e02201edd0d276786f7fcf319c4157501dca9c74457cac3b385a7475e6de85e1d826712230a2103f0acd97ec011b875376888b3538f70644e2ad537f61169e95b7c703176925d00",
5
    "metadata": {
6
      "fee": 1,
7
      "time_lock": 0,
8
      "to": "wit1nfkythqds4r2hz3le2zaauxtl7yum76jr6409f",
9
      "value": 1
10
    },
11
    "transaction": {
12
      "ValueTransfer": {
13
        "body": {
14
          "inputs": [
15
            {
16
              "output_pointer": "4c4cc66b8bf7828797596ded89db7ddb1cd5b44dc18007738ef3d40e089a6add:1"
17
            }
18
          ],
19
          "outputs": [
20
            {
21
              "address": "twit1nfkythqds4r2hz3le2zaauxtl7yum76jd0ut9c",
22
              "time_lock": 0,
23
              "value": 1
24
            },
25
            {
26
              "address": "twit1yhs4t9qs8l0pmxrysp7sjxfr4djg6mgldk69zs",
27
              "time_lock": 0,
28
              "value": 124999999998
29
            }
30
          ]
31
        },
32
        "signatures": [
33
          {
34
            "public_key": {
35
              "bytes": [240, 172, 217, 126, 192, 17, 184, 117, 55, 104, 136, 179, 83, 143, 112, 100, 78, 42, 213, 55, 246, 17, 105, 233, 91, 124, 112, 49, 118, 146, 93, 0],
36
              "compressed": 3
37
            },
38
            "signature": {
39
              "Secp256k1": {
40
                "der": [48, 69, 2, 33, 0, 142, 12, 73, 172, 220, 201, 47, 99, 198, 199, 26, 161, 206, 123, 180, 208, 82, 71, 117, 200, 224, 175, 157, 89, 125, 27, 139, 223, 216, 210, 116, 30, 2, 32, 30, 221, 13, 39, 103, 134, 247, 252, 243, 25, 196, 21, 117, 1, 220, 169, 199, 68, 87, 202, 195, 179, 133, 167, 71, 94, 109, 232, 94, 29, 130, 103]
41
              }
42
            }
43
          }
44
        ]
45
      }
46
    },
47
    "transaction_id": "66387166eba2d8af0b55bf309b9557ae812bdec0039fc45ece1f744ed309816f"
48
  },
49
  "id": 18
50
}
Copied!
create_wallet
The JsonRPC method create_wallet is used to generate a new Master Key for an empty HD wallet that is stored encrypted in the file system.
Request with parameters:
name (optional): String, human-friendly name for the wallet.
description (optional): String, human-friendly caption for the wallet.
seed_source: "mnemonics"|"xprv", literal to identify if the seed source is of the type mnemonics or xprv and determine how the HD wallet master key will be generated from the data sent in the seedData parameter.
seed_data: String, data used for generating the new HD wallet master key.
password: String, password that will seed the key used to encrypt the wallet in the file system. The password must have at least eight characters.
overwrite (optional): Boolean, in case that seed data was previously used for creating another wallet, this flag will overwrite the previous wallet with the new one.
backup_password (optional): String, in case that seed source is "xprv", seed_data must be decrypted with this parameter.
birth_date (optional): current | imported (number), data used to specify from which block number the wallet should start synchronizing (for importing wallets from a previously used seed phrase).
1
{
2
  "jsonrpc": "2.0",
3
  "method": "create_wallet",
4
  "params": {
5
    "name": "Wallet #1",
6
    "description": "Personal use",
7
    "seed_source": "mnemonics",
8
    "seed_data": "exotic demand way fatigue skull poverty happy divide scrub seed jeans novel",
9
    "password": "12345678",
10
    "overwrite": false,
11
    "backup_password": null,
12
    "birth_date": {"imported": 10000}
13
  },
14
  "id": 1
15
}
Copied!
Response:
wallet_id: String, ID associated with the given wallet.
1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "wallet_id": "6c344625884c2f910065ab170dc18ad3cbbc03c7234507c7c22dbd78e3b26667"
5
  },
6
  "id": 1
7
}
Copied!
close_session
The JsonRPC method close_session is used to close an active session without locking the currently unlocked wallet.
Request with parameters:
session_id: String, session ID assigned when unlocking the wallet. See unlock_wallet.
1
{
2
  "jsonrpc": "2.0",
3
  "method": "close_session",
4
  "params": {
5
    "session_id": "9fa1d779afea88a29768dd05647e37b2f64fc103c1081b0ee9e62fb283f5cd02"
6
  },
7
  "id": "1"
8
}
Copied!
Response:
success: Boolean, reporting if the wallet was successfully closed.
1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "success": true
5
  },
6
  "id": "1"
7
}
Copied!
delete_wallet
The JsonRPC method delete_wallet is used to delete the wallet with the specified ID. It also removes the current active session.
Request with parameters:
session_id: String, session ID assigned to you when you unlocked the wallet. See unlock_wallet.
wallet_id: String, ID associated to the wallet. See get_wallet_infos.
1
{
2
  "jsonrpc": "2.0",
3
  "method": "delete_wallet",
4
  "params": {
5
    "session_id": "9fa1d779afea88a29768dd05647e37b2f64fc103c1081b0ee9e62fb283f5cd02",
6
    "wallet_id": "6c344625884c2f910065ab170dc18ad3cbbc03c7234507c7c22dbd78e3b26667"
7
  },
8
  "id": "1"
9
}
Copied!
Response:
success: Boolean, reporting if the wallet was successfully deleted.
1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "success": true
5
  },
6
  "id": "1"
7
}
Copied!
export_master_key
The JsonRPC method export_master_key is used to export the master key of an existing wallet. This key is encrypted with a user-defined password using AES-CBC.
Request with parameters:
session_id: String, session ID assigned when unlocking the wallet. See unlock_wallet.
wallet_id: String, ID associated to the wallet. See get_wallet_infos.
password: String, user-defined password used to encrypt the key.
1
{
2
  "jsonrpc": "2.0",
3
  "method": "create_wallet",
4
  "params": {
5
    "session_id": "9fa1d779afea88a29768dd05647e37b2f64fc103c1081b0ee9e62fb283f5cd02",
6
    "wallet_id": "6c344625884c2f910065ab170dc18ad3cbbc03c7234507c7c22dbd78e3b26667",
7
    "password":
8
    "12345678"
9
  },
10
  "id": 1
11
}
Copied!
Response:
wallet_id: String, ID associated with the given wallet.
1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "wallet_id": "6c344625884c2f910065ab170dc18ad3cbbc03c7234507c7c22dbd78e3b26667"
5
  },
6
  "id": 1
7
}
Copied!
generate_address
The JsonRPC method generate_address is used to derive deterministically a new external address for the given wallet and session ID.
Request with parameters:
session_id: String, session ID assigned when unlocking the wallet. See unlock_wallet.
wallet_id: String, ID associated to the wallet. See get_wallet_infos.
external (optional): Boolean, if set to false it will generate an internal address.
1
{
2
  "jsonrpc": "2.0",
3
  "method": "generate_address",
4
  "params": {
5
    "session_id": "9fa1d779afea88a29768dd05647e37b2f64fc103c1081b0ee9e62fb283f5cd02",
6
    "wallet_id": "6c344625884c2f910065ab170dc18ad3cbbc03c7234507c7c22dbd78e3b26667"
7
  },
8
  "id": "1"
9
}
Copied!
Response:
address: String, address derived deterministically.
path: String, derivation path used to generate the address.
1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "address": "twit1gtvu9a37w9sxaej30grp9rpxkkwwjk3pq0jqf9",
5
    "path": "m/3'/4919'/0'/0/0"
6
  },
7
  "id": "1"
8
}
Copied!
get
The method get allows to retrieve a previous stored key-value data in the wallet database.
Request with parameters:
wallet_id: String, the ID associated to the wallet. See get_wallet_infos.
session_id: String, session ID assigned when unlocking the wallet. See unlock_wallet.
key: String, key under which the value will be stored.
1
{
2
  "jsonrpc": "2.0",
3
  "method": "get",
4
  "params": {
5
    "wallet_id": "d5b53a4c40388a9be87acaf5a4dec9fd5c48f94913734bff88a08b18a618c76b",
6
    "session_id": "5982a279bbd201192f9d3685975c6cebb714ac32dea00cfea80e2013d510e35e",
7
    "key": "templates"
8
  },
9
  "id": 1
10
}
Copied!
Response:
1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "value": {
5
      "name": "object"
6
    }
7
  },
8
  "id": 1
9
}
Copied!
get_addresses
The JsonRPC method get_addresses is used to query for a list of previously derived addresses given a wallet and session ID.
Request with parameters:
session_id: String, session ID assigned when unlocking the wallet. See unlock_wallet.
wallet_id: String, ID associated to the wallet. See get_wallet_infos.
offset (optional): number, initial position of the address list to be queried (by default is set to 0).
limit (optional): number, size of the address list to be returned (by default is set to 25).
external (optional): Boolean, if set to false it will get internal addresses.
1
{
2
  "jsonrpc": "2.0",
3
  "method": "get_addresses",
4
  "params": {
5
    "session_id": "9bcb54bf7494c21c29ef97256f6741b5b5bd5cb31d09d38e5ce98699010beea7",
6
    "wallet_id": "8f5b85981addad621a86f01a1ddb646ccd90620c95247948ce8d99feefd0496c",
7
    "offset": 0,
8
    "limit": 25
9
  },
10
  "id": "1"
11
}
Copied!
Response with an array of addresses and additional related information:
addresses: Array, list of queried addresses with additional information.
account: number, identifies the current account in the session (the current version only supports the default account 0).
address: String, address serialized in Bech32 format.
index: number, sequential index used to derive address.
info: String, additional information with balance movements and dates.
first_payment_date: number, date of first received movement in UTC format (Coordinated Universal Time).
label: String, user-defined label for this address.
last_payment_date: number, date of last received movement in UTC format (Coordinated Universal Time).
received_amount: number, total amount (in nanoWits) received by this address.
received_payments: Array, list of Unspent Transaction Outputs (UTXOs) proving funds to this address.
keychain: number, change value of the derivation path (See BIP-44).
path: String, derivation path used to generate the address.
1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "addresses": [
5
      {
6
        "account": 0,
7
        "address": "twit1eghyyar76nuvdfu0h70f4gmxruj2rw4g8x2nn8",
8
        "index": 0,
9
        "info": {
10
          "first_payment_date": 1592476860,
11
          "label": null,
12
          "last_payment_date": 1592476860,
13
          "received_amount": 125000000000,
14
          "received_payments": [
15
            "78bd0d8e4ef8ab67d4f18b357545f9dc73f63b7bf97a9a20c69b91b9e17ba985:1"
16
          ]
17
        },
18
        "keychain": 0,
19
        "path": "m/3'/4919'/0'/0/0",
20
      }
21
    ],
22
    "total": 1
23
  },
24
  "id": "1"
25
}
Copied!
get_balance
The JsonRPC method get_balance is used to query the current balance for a given wallet.
Request with parameters:
session_id: String, session ID assigned to you when you unlocked the wallet. See unlock_wallet.
wallet_id: String, ID associated to the wallet. See get_wallet_infos.
1
{
2
  "jsonrpc": "2.0",
3
  "method": "get_balance",
4
  "params": {
5
    "session_id": "9fa1d779afea88a29768dd05647e37b2f64fc103c1081b0ee9e62fb283f5cd02",
6
    "wallet_id": "6c344625884c2f910065ab170dc18ad3cbbc03c7234507c7c22dbd78e3b26667"
7
  },
8
  "id": "1"
9
}
Copied!
Response with different types of balances:
local: number, amount of local pending movements not yet indexed in a block.
unconfirmed: BalanceInfo, total amount of wallet's funds after last block, but not yet confirmed by a superblock.
available: number, unconfirmed expendable funds.
locked: number, unconfirmed time-locked funds.
confirmed: BalanceInfo, total amount of wallet's funds after last confirmed superblock.
available: number, confirmed expendable funds.
locked: number, confirmed time-locked funds.
1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "confirmed": {
5
      "available": 0,
6
      "locked": 0
7
    },
8
    "local": 0,
9
    "unconfirmed": {
10
      "available": 0,
11
      "locked": 0
12
    }
13
  },
14
  "id": "1"
15
}
Copied!
get_transactions
The JsonRPC method get_transactions is used to query for a list of transactions given a wallet and session ID.
Request with parameters:
session_id: String, session ID assigned when unlocking the wallet. See unlock_wallet.
wallet_id: String, ID associated to the wallet. See get_wallet_infos.
offset (optional): number, initial position of the transaction list to be queried (by default is set to 0).
limit (optional): number, size of the transaction list to be returned (by default is set to 25).
1
{
2
  "jsonrpc": "2.0",
3
  "method": "get_transactions",
4
  "params": {
5
    "session_id": "9bcb54bf7494c21c29ef97256f6741b5b5bd5cb31d09d38e5ce98699010beea7",
6
    "wallet_id": "8f5b85981addad621a86f01a1ddb646ccd90620c95247948ce8d99feefd0496c",
7
    "offset": 0,
8
    "limit": 25
9
  },
10
  "id": "1"
11
}
Copied!
Response with an array of transactions and additional related information:
total: number, total amount of wallet transactions.
transactions: Array, list of queried transactions with additional information.
amount: number, transaction value.
type: "POSITIVE"|"NEGATIVE", type of balance movement in relation to the wallet.
transaction: Transaction, additional transaction information.
block: Block, information of block in which the transaction was included.
block_hash: String, block hash in hexadecimal format.
epoch: number block epoch.
data: TransactionData, additional type-specific transaction data. The supported transaction types are value_transfer, data_request, tally, mint and commit.
hash: String, transaction hash in hexadecimal format used as identifier.
miner_fee: number, amount of nanoWits for the block miner.
timestamp: number, transaction date in UTC format (Coordinated Universal Time).
1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "total": 2,
5
    "transactions": [
6
      {
7
        "amount": 123,
8
        "transaction": {
9
          "block": {
10
            "block_hash": "161fc079d3d7b8cd13af18bc615aaf24802bc1e64abd387d6d37be68c94fe8ec",
11
            "epoch": 53555
12
          },
13
          "data": {
14
            "value_transfer": {
15
              "inputs": [
16
                {
17
                  "address": "twit1r204scrl8djuljdn3gp8tgauzrl3x3c5dgl5wh",
18
                  "value": 125000000000
19
                }
20
              ],
21
              "outputs": [
22
                {
23
                  "address": "twit1yur5cmrz5vkc35p8fgg5c5la3yrl6yamwq02r6",
24
                  "time_lock": 0,
25
                  "value": 123
26
                },
27
                {
28
                  "address": "twit1r204scrl8djuljdn3gp8tgauzrl3x3c5dgl5wh",
29
                  "time_lock": 0,
30
                  "value": 124999999865
31
                }
32
              ]
33
            }
34
          },
35
          "hash": "c2cf7cfce47f1645a97b199cac532496b5490fd1dd2d7b6da24818d964ff18ab",
36
          "miner_fee": 12,
37
          "timestamp": 1595406375
38
        },
39
        "type": "POSITIVE"
40
      }
41
    ]
42
  },
43
  "id": "1"
44
}
Copied!
get_utxo_info
The JsonRPC method get_utxo_info is used to query the current unspent transaction outputs for a given wallet.
Request with parameters:
session_id: String, session ID assigned to you when you unlocked the wallet. See unlock_wallet.
wallet_id: String, ID associated to the wallet. See get_wallet_infos.
1
{
2
  "jsonrpc": "2.0",
3
  "method": "get_utxo_info",
4
  "params": {
5
    "session_id": "9fa1d779afea88a29768dd05647e37b2f64fc103c1081b0ee9e62fb283f5cd02",
6
    "wallet_id": "6c344625884c2f910065ab170dc18ad3cbbc03c7234507c7c22dbd78e3b26667"
7
  },
8
  "id": "1"
9
}
Copied!
Response with a HashMap with all the information about the unspent transaction outputs of a specified wallet:
output_info[]: HashMap<String, OutputInfo>, information related of all the unspent transaction outputs (amount, pkh and time_lock)
1
{
2
  "jsonrpc": "2.0",
3
  "result": {
4
    "3a1ff5de49142d21280dc62dbdc02810a9665e9c23bb27b9094d6dbd6f4e527f:0": {
5
      "amount": "10000000000",
6
      "pkh": "twit1eghyyar76nuvdfu0h70f4gmxruj2rw4gfnrhnk",
7
      "time_lock": "0"
8
    },
9
    "3cebaae8cc942056c475d7f9866a5de1be41aea0a1bcdb63edd533b9caef4043:0": {
10
      "amount": "10000000000",
11
      "pkh": "twit1eghyyar76nuvdfu0h70f4gmxruj2rw4gfnrhnk",
12
      "time_lock": "0"
13
    }
14
  },
15
  "id": "1"
16
}
Copied!
get_wallet_infos
The JsonRPC method get_wallet_infos displays the information about the wallet.
This method has no parameters, as an example:
1
{
2
  "jsonrpc": "2.0",
3
  "method": "get_wallet_infos",
4
  "id": "1"
5
}