Request
This is a message type, which gets a reply with a response type message.
Example:
1
const network = require('ocore/network.js');
2
const ws = network.getInboundDeviceWebSocket(device_address);
3
​
4
// function parameters: websocket, command, params, bReroutable, callback
5
var tag = network.sendRequest(ws, 'get_witnesses', null, false, getParentsAndLastBallAndWitnessListUnit);
6
​
7
function getParentsAndLastBallAndWitnessListUnit(ws, req, witnesses) {
8
var params = {
9
witnesses: witnesses
10
};
11
network.sendRequest(ws, 'light/get_parents_and_last_ball_and_witness_list_unit', params, false,
12
function(ws, req, response) {
13
console.log(response);
14
}
15
);
16
}
17
​
18
//you can have your own timeout logic and delete a pending request like this
19
setTimeout(function() {
20
var deleted = network.deletePendingRequest(ws, tag); // true if request was deleted
21
}, 30*1000);
Copied!
Following is a list of
request type JSON messages that are sent over the network:Get node list
This requests returns response with nodes that accept incoming connections.
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'get_peers'
6
}
7
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: [
6
"wss://relay.bytes.cash/bb",
7
"wss://hub.obytechina.org/bb",
8
"wss://hub.obyte.connectory.io/bb",
9
"wss://odex.ooo/bb",
10
...
11
]
12
}
13
}
Copied!
Get a list of witnesses
This requests returns response with list of witnesses.
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'get_witnesses'
6
}
7
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: [
6
"4GDZSXHEFVFMHCUCSHZVXBVF5T2LJHMU",
7
"BVVJ2K7ENPZZ3VYZFWQWK7ISPCATFIW3",
8
"DJMMI5JYA5BWQYSXDPRZJVLW3UGL3GJS",
9
...
10
]
11
}
12
}
Copied!
Get transaction data
This requests returns response with unit data. Example shows a unit, which created a new asset.
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'get_joint',
6
params: '0xXOuaP5e3z38TF5ooNtDhmwNkh1i21rBWDvrrxKt0U='
7
}
8
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: {
6
"joint": {
7
"unit": {
8
"unit": "0xXOuaP5e3z38TF5ooNtDhmwNkh1i21rBWDvrrxKt0U=",
9
"version": "1.0",
10
"alt": "1",
11
"witness_list_unit": "oj8yEksX9Ubq7lLc+p6F2uyHUuynugeVq4+ikT67X6E=",
12
"last_ball_unit": "AV4qvQ5JuI7J3EO5pFD6UmMu+j0crPbH17aJfigozrc=",
13
"last_ball": "Ogq4+uR6LaDspK89MmyydxRchgdN/BYwXvWXwNCMubQ=",
14
"headers_commission": 344,
15
"payload_commission": 607,
16
"main_chain_index": 2336026,
17
"timestamp": 1524844417,
18
"parent_units": [
19
"IFiHjYbzuAUC9TwcTrmpvezjTKBl6nIXjgjoKuVyCz0="
20
],
21
"authors": [
22
{
23
"address": "AM6GTUKENBYA54FYDAKX2VLENFZIMXWG",
24
"authentifiers": {
25
"r": "MBWlL31OkibUXhoxmwIcWB/fAx1uWdNTE8PYTBNeN3w+tev4N1anOXjGtXiGW4whW3PfJeTO9fA5WxwyqK/m2w=="
26
}
27
}
28
],
29
"messages": [
30
{
31
"app": "data",
32
"payload_hash": "MiuMtTSgP0brPQijsRc0igb+dxcrkLjXWRE253AE/S8=",
33
"payload_location": "inline",
34
"payload": {
35
"asset": "IYzTSjJg4I3hvUaRXrihRm9+mSEShenPK8l8uKUOD3o=",
36
"decimals": 0,
37
"name": "WCG Point by Byteball",
38
"shortName": "WCG Point",
39
"issuer": "Byteball",
40
"ticker": "WCG",
41
"description": "WCG Point is a honorific token, a recognition of contributing to World Community Grid projects. The token is not transferable, therefore, it cannot be sold and the balance reflects a lifetime contribution to WCG. Some services might choose to offer a privilege to users with large balance of this token."
42
}
43
},
44
{
45
"app": "payment",
46
"payload_hash": "FaVxPdeRKTgcO/LCDtu/YUZego8xyrnpUMF3V/sujr8=",
47
"payload_location": "inline",
48
"payload": {
49
"inputs": [
50
{
51
"unit": "1p85M8VSRDaAkNoCAdtMrv6cVGpPNNeVJpLzOkzWLk8=",
52
"message_index": 1,
53
"output_index": 0
54
}
55
],
56
"outputs": [
57
{
58
"address": "AM6GTUKENBYA54FYDAKX2VLENFZIMXWG",
59
"amount": 17890
60
}
61
]
62
}
63
}
64
]
65
},
66
"ball": "Ef36OjK5m6lQMII4S9MN3iGtQcsvTzzQFLKQZ44UBCg="
67
}
68
}
69
}
70
}
Copied!
Send transaction data
This requests returns response whether composed unit was accepted or not. Unit object can be composed with
ocore/composer.js.request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'post_joint',
6
params: {Object}
7
}
8
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: 'accepted'
6
}
7
}
Copied!
Send heartbeat that you don't sleep
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'heartbeat'
6
}
7
}
Copied!
1
{
2
type: "response",
3
content: {
4
tag: tag,
5
response: null
6
}
7
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: 'sleep'
6
}
7
}
Copied!
Subscribe to transaction data
request.json
response.json
1
{
2
type: "request",
3
content: {
4
tag: tag,
5
command: "subscribe",
6
params: {
7
subscription_id: crypto.randomBytes(30).toString('base64'),
8
last_mci: 0,
9
library_version: "0.1"
10
}
11
}
12
}
Copied!
1
{
2
type: "response",
3
content: {
4
tag: tag,
5
response: "subscribed"
6
}
7
}
Copied!
1
{
2
type: "response",
3
content: {
4
tag: tag,
5
response: {
6
error: "I'm light, cannot subscribe you to updates",
7
}
8
}
9
}
Copied!
Synchronous transaction data
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'catchup',
6
params: {
7
witnesses: witnesses,
8
last_stable_mci: last_stable_mci,
9
last_known_mci: last_known_mci
10
}
11
}
12
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: {
6
status: 'current'
7
}
8
}
9
}
Copied!
Get the hash tree
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'get_hash_tree',
6
params: {
7
from_ball: from_ball,
8
to_ball: to_bal
9
}
10
}
11
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: {
6
"balls": [
7
{
8
"unit": "c2teVop7xa1BmH1LPvytvOKU8HHTrprGWQw+uHlWPHo=",
9
"ball": "ht1QP48paWg5hpjx+Nbd/DSRFT8WlbQKk9+Uum0/tso=",
10
"parent_balls": [
11
"aEU1WiY9FQ9ihv9cKkX/EHWDxYYVaWYs2AL1yxyYZAQ="
12
]
13
},
14
{
15
"unit": "tPbC6QLeweGuiGYRPsIhfd0TQWXWASYBJJUPGa9AOfw=",
16
"ball": "ba5wFB+gewdRX6nSpxt6+Nt8PaRen4pLIYg3jC6EvIw=",
17
"parent_balls": [
18
"ht1QP48paWg5hpjx+Nbd/DSRFT8WlbQKk9+Uum0/tso="
19
]
20
},
21
{
22
"unit": "J7quEBEZ5ksq+0vK4cku7NtWkZ4Kxb8aHCu66RkN2eU=",
23
"ball": "4B+R+gW91BPmTqxF3G10oWmF4tg5LiHdpMQcL1ezqCo=",
24
"parent_balls": [
25
"ba5wFB+gewdRX6nSpxt6+Nt8PaRen4pLIYg3jC6EvIw="
26
]
27
},
28
...
29
]
30
}
31
}
32
}
Copied!
Get the main chain index
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'get_last_mci'
6
}
7
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: 3795741
6
}
7
}
Copied!
Send message to client that is connected to hub
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'hub/deliver',
6
params: {
7
to: device_address,
8
pubkey: pubkey,
9
signature: signature,
10
encrypted_package: encrypted_message
11
}
12
}
13
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: 'accepted'
6
}
7
}
Copied!
Get temporary public key
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'hub/get_temp_pubkey',
6
params: permanent_pubkey
7
}
8
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: 'TEMP_PUBKEY_PACKAGE'
6
}
7
}
Copied!
Update temporary public key
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'hub/temp_pubkey',
6
params: {
7
temp_pubkey: temp_pubkey,
8
pubkey: permanent_pubkey,
9
signature: signature
10
}
11
}
12
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: 'updated'
6
}
7
}
Copied!
Enable notifications
request.json
request.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'hub/enable_notification',
6
params: registrationId
7
}
8
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: 'ok'
6
}
7
}
Copied!
Disable notifications
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'hub/disable_notification',
6
params: registrationId
7
}
8
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: 'ok'
6
}
7
}
Copied!
Get list of chat bots
This requests returns response with chat bots of connected hub.
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'hub/get_bots'
6
}
7
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: [
6
{
7
"id": 29,
8
"name": "Buy Bytes with Visa or Mastercard",
9
"pairing_code": "A1i/[email protected]/bb#0000",
10
"description": "This bot helps to buy Bytes with Visa or Mastercard. The payments are processed by Indacoin. Part of the fees paid is offset by the reward you receive from the undistributed funds."
11
},
12
{
13
"id": 31,
14
"name": "World Community Grid linking bot",
15
"pairing_code": "A/JWTKvgJQ/[email protected]/bb#0000",
16
"description": "Donate your device’s spare computing power to help scientists solve the world’s biggest problems in health and sustainability, and earn some Bytes in the meantime. This bot allows you to link your Byteball address and WCG account in order to receive daily rewards for your contribution to WCG computations.\n\nWCG is an IBM sponsored project, more info at https://www.worldcommunitygrid.org"
17
},
18
{
19
"id": 36,
20
"name": "Username registration bot",
21
"pairing_code": "[email protected]/bb#0000",
22
"description": "Buy a username and receive money to your @username instead of a less user-friendly cryptocurrency address.\n\nProceeds from the sale of usernames go to Byteball community fund and help fund the development and promotion of the platform."
23
},
24
...
25
]
26
}
27
}
Copied!
Get asset metadata
This requests returns response with asset metadata (unit and registry). Example gets WCG Point asset metadata.
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'hub/get_asset_metadata',
6
params: 'IYzTSjJg4I3hvUaRXrihRm9+mSEShenPK8l8uKUOD3o='
7
}
8
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: {
6
"metadata_unit": "0xXOuaP5e3z38TF5ooNtDhmwNkh1i21rBWDvrrxKt0U=",
7
"registry_address": "AM6GTUKENBYA54FYDAKX2VLENFZIMXWG",
8
"suffix": null
9
}
10
}
11
}
Copied!
Get transaction history
This requests returns response with transaction history of specified addresses.
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'light/get_history',
6
params: {
7
witnesses: witnesses,
8
requested_joints: joints,
9
addresses: addresses
10
}
11
}
12
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: {Object}
6
}
7
}
Copied!
Get chain link proofs
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'light/get_link_proofs',
6
params: units
7
}
8
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: [Array]
6
}
7
}
Copied!
Get the parent unit and the witness unit
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'light/get_parents_and_last_ball_and_witness_list_unit',
6
params: {
7
witnesses: witnesses
8
}
9
}
10
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: {
6
"parent_units": [
7
"QEdpDamxpez8dlOE4nF8TWwHs+efokBXlxQHK27/y4g="
8
],
9
"last_stable_mc_ball": "xF0K/NKO6CGMU6XeBGXzurEcCajomfZMOAU4XmAy+6o=",
10
"last_stable_mc_ball_unit": "R/RosYwuXJ/mXw5TTfWLVLHdtnnzaKn5EgJkDfzagcs=",
11
"last_stable_mc_ball_mci": 3795817,
12
"witness_list_unit": "J8QFgTLI+3EkuAxX+eL6a0q114PJ4h4EOAiHAzxUp24="
13
}
14
}
15
}
Copied!
1
{
2
type: "response",
3
content: {
4
tag: tag,
5
response: {
6
error: "I'm light myself, can't serve you",
7
}
8
}
9
}
Copied!
Get specific attestation unit
This requests returns response with attestation units for specified field and value.
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'light/get_attestation',
6
params: {
7
attestor_address: 'FZP4ZJBMS57LYL76S3J75OJYXGTFAIBL',
8
field: 'name',
9
value: 'tarmo888'
10
}
11
}
12
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: 'jeiBABcZI5fjyIPHkpb2PipLHzjUgafoPd0b6bdsGUI='
6
}
7
}
Copied!
1
{
2
type: "response",
3
content: {
4
tag: tag,
5
response: {
6
error: "I'm light myself, can't serve you",
7
}
8
}
9
}
Copied!
Get all attestation data about address
This requests returns response with all the attestation data about specific address.
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'light/get_attestations',
6
params: {
7
address: 'MNWLVYTQL5OF25DRRCR5DFNYXLSFY43K'
8
}
9
}
10
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: [
6
{
7
"unit": "jeiBABcZI5fjyIPHkpb2PipLHzjUgafoPd0b6bdsGUI=",
8
"attestor_address": "FZP4ZJBMS57LYL76S3J75OJYXGTFAIBL",
9
"profile": {
10
"name": "tarmo888"
11
}
12
}
13
]
14
}
15
}
Copied!
1
{
2
type: "response",
3
content: {
4
tag: tag,
5
response: {
6
error: "I'm light myself, can't serve you",
7
}
8
}
9
}
Copied!
Pick divisible inputs for amount
This requests returns response with spendable inputs for specified asset, amount and addresses.
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'light/pick_divisible_coins_for_amount',
6
params: {
7
asset: '',
8
addresses: addresses,
9
last_ball_mci: last_ball_mci,
10
amount: amount,
11
spend_unconfirmed: 'own'
12
}
13
}
14
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: {Object}
6
}
7
}
Copied!
1
{
2
type: "response",
3
content: {
4
tag: tag,
5
response: {
6
error: "I'm light myself, can't serve you",
7
}
8
}
9
}
Copied!
Get address definition
This requests returns response with address definition (smart-contracts have address smart-contract definition only after somebody has spent from it).
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'light/get_definition',
6
params: 'JEDZYC2HMGDBIDQKG3XSTXUSHMCBK725'
7
}
8
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: [
6
"sig",
7
{
8
"pubkey": "Aiy5z+jM1ySTZl1Qz1YZJouF7tU6BU++SYc/xe0Rj5OZ"
9
}
10
]
11
}
12
}
Copied!
1
{
2
type: "response",
3
content: {
4
tag: tag,
5
response: {
6
error: "I'm light myself, can't serve you",
7
}
8
}
9
}
Copied!
Get balances of addresses
This request returns a response with balances of one or more addresses.
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'light/get_balances',
6
params: [
7
'JEDZYC2HMGDBIDQKG3XSTXUSHMCBK725',
8
'UENJPVZ7HVHM6QGVGT6MWOJGGRTUTJXQ'
9
]
10
}
11
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: {
6
"JEDZYC2HMGDBIDQKG3XSTXUSHMCBK725": {
7
"base": {
8
"stable": 1454617324,
9
"pending": 2417784
10
}
11
},
12
"UENJPVZ7HVHM6QGVGT6MWOJGGRTUTJXQ": {
13
"base": {
14
"stable": 0,
15
"pending": 6
16
}
17
}
18
}
19
}
20
}
Copied!
1
{
2
type: "response",
3
content: {
4
tag: tag,
5
response: {
6
error: "I'm light myself, can't serve you",
7
}
8
}
9
}
Copied!
Get profile unit IDs of addresses
It is possible for users to post a profile information about themselves, this request returns a response with all the profile data units.
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'light/get_profile_units',
6
params: [
7
'MNWLVYTQL5OF25DRRCR5DFNYXLSFY43K'
8
]
9
}
10
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: [
6
"gUrJfmdDeYhTKAHM5ywydHXpvcensbkv8TPQLuPG3b0="
7
]
8
}
9
}
Copied!
1
{
2
type: "response",
3
content: {
4
tag: tag,
5
response: {
6
error: "I'm light myself, can't serve you",
7
}
8
}
9
}
Copied!
Custom Request
request.json
response.json
1
{
2
type: 'request',
3
content: {
4
tag: tag,
5
command: 'custom',
6
params: params
7
}
8
}
Copied!
1
{
2
type: 'response',
3
content: {
4
tag: tag,
5
response: 0 || 'some response' || {Object} || [Array]
6
}
7
}
Copied!
Last modified 7mo ago
Export as PDF
Copy link
Edit on GitHub
Contents
Get node list
Get a list of witnesses
Get transaction data
Send transaction data
Send heartbeat that you don't sleep
Subscribe to transaction data
Synchronous transaction data
Get the hash tree
Get the main chain index
Send message to client that is connected to hub
Get temporary public key
Update temporary public key
Enable notifications
Disable notifications
Get list of chat bots
Get asset metadata
Get transaction history
Get chain link proofs
Get the parent unit and the witness unit
Get specific attestation unit
Get all attestation data about address
Pick divisible inputs for amount
Get address definition
Get balances of addresses
Get profile unit IDs of addresses
Custom Request