DBC-Blockchain Mainnet RPC

About 5 min

DBC-Blockchain Mainnet RPC

For the method of sending RPC requests, please refer to the previous article.
Not all data on the chain has an RPC interface. If the data you want to query (including historical data) is not exposed through RPC, you can obtain the corresponding data by querying the storage on the chain.

1. onlineProfile Module

onlineProfile Module records the information of the machine's online rewards

1.1 Query all machines controlled by a certain stash account

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "onlineProfile_getStakerInfo",
  "params": ["5FEio5dgXeXsASdo3Wh5DQ8zfbRfQJTXYmFkCbSCFk2qsTt6"] # (stash account)
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": {
    "bondedMachines": [
      {
        "calcPoint": 51775, # Machine power points
        "gpuNum": 4, # Machine GPU Num
        "machineId": "7a79fd95e89c3db2e8bc052cb307d4130f6750cb715c44639e2c3faa7217ef1f", # Machine ID
        "machineStatus": "online" # The current state of the machine
      },
      {
        "calcPoint": 51775,
        "gpuNum": 4,
        "machineId": "8a79fd95e89c3db2e8bc052cb307d4130f6750cb715c44639e2c3faa7217ef1f",
        "machineStatus": "online"
      },
      {
        "calcPoint": 94143,
        "gpuNum": 4,
        "machineId": "9a79fd95e89c3db2e8bc052cb307d4130f6750cb715c44639e2c3faa7217ef1f",
        "machineStatus": "online"
      }
    ],
    "stashStatistic": {
      "canClaimReward": "664079816723400000", # DBC rewards that can be received
      "onlineMachine": [ # Online machine
        "7a79fd95e89c3db2e8bc052cb307d4130f6750cb715c44639e2c3faa7217ef1f"
      ],
      "totalBurnFee": "0", # The number of rents destroyed after the start of the Galaxy Contest
      "totalCalcPoints": 197930, # Machine total calc Points
      "totalClaimedReward": "0", # Reward already received
      "totalEarnedReward": "2656319266893600000", # Rewards already rewarded
      "totalGpuNum": 12, # GPU bond to stash account
      "totalMachine": [ # Stash account Bound machine
        "7a79fd95e89c3db2e8bc052cb307d4130f6750cb715c44639e2c3faa7217ef1f"
      ],
      "totalRentFee": "0", # Machine obtained rent fee
      "totalRentedGpu": 0 # Number of rented GPUs
    }
  },
  "id": 1
}

1.2 Query machine's total reward of a certain Era

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "onlineProfile_getMachineEraReward",
  "params": [
    "ee0d003006f8ddbccb97dff96bcb4bee1b8c1aeaf7c64e0ca9d0f31752d17875", # Machine ID
    1  # Which Era
  ]
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": "123456", # Era 1 Total rewards obtained by the machine
  "id": 1
}

1.3. Query machine's unlocked reward of a certain Era

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "onlineProfile_getMachineEraReleasedReward",
  "params": [
    "ee0d003006f8ddbccb97dff96bcb4bee1b8c1aeaf7c64e0ca9d0f31752d17875", 1] # Machine ID；Which Era
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": "123456", # Era 1 Rewards for unlocking the machine
  "id": 1
}

1.4 Query stash account total reward of a certain Era

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "onlineProfile_getStashEraReward",
  "params": ["5DhR2dxiPZquPhFjfPzFg5jZENdr375hbX643kr9FBXMVa2z", 1] # Stash account; the number of Era
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": "123456", # Era 1 Reward for this stash account
  "id": 1
}

1.5. Query stash account's unlocked reward of a certain Era

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "onlineProfile_getStashEraReward",
  "params": ["5DhR2dxiPZquPhFjfPzFg5jZENdr375hbX643kr9FBXMVa2z", 1] # Stash account; the number of Era
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": "123456", # The stash's unlocked reward of Era 1
  "id": 1
}

1.6. Query machine details

Example

{
     "jsonrpc":"2.0",
      "id":1,
      "method":"onlineProfile_getMachineInfo",
      "params": ["ee0d003006f8ddbccb97dff96bcb4bee1b8c1aeaf7c64e0ca9d0f31752d17875"] # Machine ID
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": {
    "bondingHeight": 531155, # Machine onchain time
    "controller": "5FTWuKEDhPsRWaeK5Jfn68a6rEFPsW8AAVF5YtfqNrznTWfv", # Machine control account
    "initStakePerGpu": "100000000000000000000", # The number of pledges per card when it is on the chain
    "lastMachineRenter": "5D45i3Ac4fXoimZQETJVMyYu79tAYzt4xQzEwzNLfirhsbg5", # Last machine renter
    "lastMachineRestake": 537808, # Machine pays all staking time
    "lastOnlineHeight": 580412, # The last time the machine was online
    "machineInfoDetail": { # Machine details info
      "committee_upload_info": {
        "calc_point": 60775,
        "cpu_core_num": 64,
        "cpu_rate": 2900,
        "cpu_type": "Intel(R) Xeon(R) Silver 4214R",
        "cuda_core": 8704,
        "data_disk": 1800,
        "gpu_mem": 10,
        "gpu_num": 4,
        "gpu_type": "GeForceRTX2080Ti",
        "is_support": true,
        "machine_id": "7a79fd95e89c3db2e8bc052cb307d4130f6750cb715c44639e2c3faa7217ef1f",
        "mem_num": 471,
        "rand_str": "",
        "sys_disk": 350
      },
      "staker_customize_info": { # Other machine information
        "download_net": 20,
        "latitude": {
          "North": 306667
        },
        "longitude": {
          "East": 1040667
        },
        "server_room": "0x6465f54d26f4b406261e7e5201a4a17551ad4d27448609f2d7cdcb75b413524c",
        "telecom_operators": ["China Unicom"],
        "upload_net": 20
      }
    },
    "machineStash": "5HWSG8FXkCSe4NgwzbnA64nT5bmRFKRKgbSKj2X8Pe7KyYcQ", # Machine stash Account
    "machineStatus": "rented", # The current state of the machine
    "onlineHeight": 537808, # Machine online time
    "rewardCommittee": [ # List of committees that can receive machine online rewards
      "5EfFToHMVc3SEzJCiSisAMMu3zVMsufaxWwNECUM3k2qUEFQ",
      "5G3oJ8cGv4mhzRvtoBtGG9cX3MTNKxNTcMNAVykxA5ZFz8wi",
      "5GGcwSx1xb4tpCfopfk8kSmJNQ6qpH38yjFVLEYYqdnECwcX"
    ],
    "rewardDeadline": 733, # Committee award end time（era）
    "stakeAmount": "400000000000000000000", # Number of machine pledges
    "totalBurnFee": "0", # The number of rents destroyed due to the start of the Galaxy Contest
    "totalRentFee": "60329673396778369975", # Total rent fee
    "totalRentedDuration": 14, # Total rented duration
    "totalRentedTimes": 2 # Total rented time
  },
  "id": 1
}

1.7. Check the number of stash accounts

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "onlineProfile_getStakerNum",
  "params": []
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": 13, # Number of Stash（>=1台机器）
  "id": 1
}

1.8. View all machines in a list

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "onlineProfile_getMachineList",
  "params": []
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": {
    "bondingMachine": [],
    "bookedMachine": [
      "7a79fd95e89c3db2e8bc052cb307d4130f6750cb715c44639e2c3faa7217ef12"
      "9a79fd95e89c3db2e8bc052cb307d4130f6750cb715c44639e2c3faa7217ef1f"
      "aa79fd95e89c3db2e8bc052cb307d4130f6750cb715c44639e2c3faa7217ef1d"
    ],
    "confirmedMachine": [],
    "fulfillingMachine": [],
    "offlineMachine": [],
    "onlineMachine": [],
    "refusedMachine": [],
    "refusedMutHardwareMachine": [],
    "rentedMachine": []
  },
  "id": 1
}

1.9 View onlineProfile module statistics

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "onlineProfile_getOpInfo",
  "params": []
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": {
    "totalBurnFee": "0",
    "totalCalcPoints": 21389044,
    "totalGpuNum": 961,
    "totalRentFee": "15509145941941806044301",
    "totalRentedGpu": 937,
    "totalStake": "96215000000000000000000",
    "totalStaker": 13
  },
  "id": 1
}

1.10 Get the identity on the account chain

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "onlineProfile_getStakerIdentity",
  "params": ["5CqTCD23gTbfmP8s6g1ehbJ66i6wi4Er4AguAw7yggDAKmPu"]
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": "Alice",
  "id": 1
}

1.11 Get stash account statistics

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "onlineProfile_getStakerListInfo",
  "params": [0, 5]
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": [
    {
      "calcPoints": 10045876,
      "index": 0,
      "stakerAccount": "5CsRZJCDiFJbZas6m2NnuYpBqo9gYv2nixHbzGLUVGdgx94w",
      "stakerName": "Alice",
      "totalBurnFee": "0",
      "totalGpuNum": 400,
      "totalReleasedReward": "3058070375932000902000",
      "totalRentFee": "6923734258518997224842",
      "totalRentedGpu": 400,
      "totalReward": "10311175917767854800000"
    },
    {
      "calcPoints": 3153803,
      "index": 2,
      "stakerAccount": "5HJugpuDxQGKLJwmv6K5eWFepDPkhPbwyTDR5vKjCv1MwUcS",
      "stakerName": "Bob",
      "totalBurnFee": "0",
      "totalGpuNum": 132,
      "totalReleasedReward": "1392103944062414253000",
      "totalRentFee": "2669666089085907226556",
      "totalRentedGpu": 132,
      "totalReward": "4458201216316382700000"
    },
    {
      "calcPoints": 617340,
      "index": 4,
      "stakerAccount": "5Gg1z77NCrUNyV4c5rm9tb3x27rYjBVYh74UrVNJh1TJGsx4",
      "stakerName": "Eve",
      "totalBurnFee": "0",
      "totalGpuNum": 28,
      "totalReleasedReward": "279809088882620814000",
      "totalRentFee": "527263236025890876875",
      "totalRentedGpu": 28,
      "totalReward": "893193550619416200000"
    }
  ],
  "id": 1
}

1.12 Get statistics by location

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "onlineProfile_getPosGpuInfo",
  "params": []
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": [
    [
      {
        "East": 1182946
      },
      {
        "North": 340643
      },
      {
        "offlineGpu": 0,
        "onlineGpu": 400,
        "onlineGpuCalcPoints": 7496900,
        "rentedGpu": 400
      }
    ],
    [
      {
        "East": 1399262
      },
      {
        "North": 353817
      },
      {
        "offlineGpu": 0,
        "onlineGpu": 1,
        "onlineGpuCalcPoints": 21029,
        "rentedGpu": 1
      }
    ]
  ],
  "id": 1
}

2. Committee Module

2.1 committee_getCommitteeList

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "committee_getCommitteeList",
  "params": []
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": {
    "chillList": ["5GGcwSx1xb4tpCfopfk8kSmJNQ6qpH38yjFVLEYYqdnECwcX"], # Committees that currently stop taking orders
    "fulfillingList": [],
    "normal": [ # Committees in a normal state
      "5D1vwMoK1DjBF7pfApKjT9Gi5C4DKHvZMztFRhTsMqo71B8r",
      "5DdA3eHdWKuHLjqEquKQzyvhumNBEN32RxRWkuuaFvda474S",
      "5EfFToHMVc3SEzJCiSisAMMu3zVMsufaxWwNECUM3k2qUEFQ",
      "5EhZqXq9objj6Qf7DzCxmjZfUHUbZh9JK5Xb3DgKmpvjyMMV",
      "5FyU86E1arMRNwdxtRJvBs6qX4Y1o1UB2TXHUV3ZJcmQVkQK",
      "5G3oJ8cGv4mhzRvtoBtGG9cX3MTNKxNTcMNAVykxA5ZFz8wi",
      "5GFCgrhHv2jwimWZAgnDzSdvJocDzEadCk78B5AZJc5tYSYp",
      "5Gy6ANnyoWwo6WxuN5Vxz5hogY2JXg51FZbR99gYtQ49qckW",
      "5HDjo1p7DNmfXsjvcAjFogQ8Ue8fNb26Z1RAD9XqmWrKETFk"
    ],
    "waitingBoxPubkey": ["5Gv3FyFA7bFbUqqgXWXwkgCkazMaaBpfbVnwtVVRP5vgUYRs"] # Committees that has not been set up boxPubkey
  },
  "id": 1
}

3. OnlineCommittee Module

3.1 Get the list of committees assigned by the machine

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "onlineCommittee_getMachineCommitteeList",
  "params": ["38f4a824e0dc1fc5a9a7dccff53417b300fc0edad208176d8770597d98f6eb5c"] # Machine ID
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": {
    "bookTime": 533682, # Order Dispatch time
    "bookedCommittee": [ # Order Dispatch committee
      "5D1vwMoK1DjBF7pfApKjT9Gi5C4DKHvZMztFRhTsMqo71B8r",
      "5DdA3eHdWKuHLjqEquKQzyvhumNBEN32RxRWkuuaFvda474S",
      "5Gy6ANnyoWwo6WxuN5Vxz5hogY2JXg51FZbR99gYtQ49qckW"
    ],
    "confirmStartTime": 538002, # Time to submit original machine information
    "confirmedCommittee": [ # The committee that has submitted the original value
      "5D1vwMoK1DjBF7pfApKjT9Gi5C4DKHvZMztFRhTsMqo71B8r",
      "5DdA3eHdWKuHLjqEquKQzyvhumNBEN32RxRWkuuaFvda474S",
      "5Gy6ANnyoWwo6WxuN5Vxz5hogY2JXg51FZbR99gYtQ49qckW"
    ],
    "hashedCommittee": [ # The committee that has submitted the machine information hash
      "5D1vwMoK1DjBF7pfApKjT9Gi5C4DKHvZMztFRhTsMqo71B8r",
      "5DdA3eHdWKuHLjqEquKQzyvhumNBEN32RxRWkuuaFvda474S",
      "5Gy6ANnyoWwo6WxuN5Vxz5hogY2JXg51FZbR99gYtQ49qckW"
    ],
    "onlinedCommittee": [ # The machine is successfully online and committee will be rewarded
      "5D1vwMoK1DjBF7pfApKjT9Gi5C4DKHvZMztFRhTsMqo71B8r",
      "5DdA3eHdWKuHLjqEquKQzyvhumNBEN32RxRWkuuaFvda474S",
      "5Gy6ANnyoWwo6WxuN5Vxz5hogY2JXg51FZbR99gYtQ49qckW"
    ],
    "status": "finished" # Order Dispatch status
  },
  "id": 1
}

3.2 Get the committee's review time for the machine

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "onlineCommittee_getCommitteeOps",
  "params": [
    "5D1vwMoK1DjBF7pfApKjT9Gi5C4DKHvZMztFRhTsMqo71B8r",
    "74339d3413c1386d23d92e55586ccf25090c7eb762928f9bc69799b677f65f51"
  ] # Committee Account ID; Machine ID
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": {
    "bookedTime": 600340, # Order Dispatch time
    "confirmHash": "0x00000000000000000000000000000000", # Submitted machine information Hash
    "confirmTime": 0,
    "hashTime": 0,
    "machineInfo": { # Submitted machine information
      "calc_point": 0,
      "cpu_core_num": 0,
      "cpu_rate": 0,
      "cpu_type": [],
      "cuda_core": 0,
      "data_disk": 0,
      "gpu_mem": 0,
      "gpu_num": 0,
      "gpu_type": "NVIDIA GeForce GTX 3080",
      "is_support": false,
      "machine_id": "74339d3413c1386d23d92e55586ccf25090c7eb762928f9bc69799b677f65f51",
      "mem_num": 0,
      "rand_str": "abc",
      "sys_disk": 0
    },
    "machineStatus": "booked",
    "stakedDbc": "1000000000000000000",
    "verifyTime": [600820, 602260, 603700]
  },
  "id": 1
}

3.3 Get a list of all the machines dispatched by the committee

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "onilneCommittee_getCommitteeMachineList",
  "params": ["5Gv3FyFA7bFbUqqgXWXwkgCkazMaaBpfbVnwtVVRP5vgUYRs"] # Committee Account ID
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": {
    "bookedMachine": [], # Current dispatched order
    "confirmedMachine": [], # List of machines that submitted the original info
    "hashedMachine": [], # The list of machines that submitted the Hash
    "onlineMachine": [] # Machines that are now online
  },
  "id": 1
}

4. RentMachine Modul

4.1 Get rentOrder ID of Machine

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "rentMachine_getMachineRentId",
  "params": ["0edac3b0263dd09538717bb0f5bf3f1bced70d7e017239d6f307b0801220c022"] # MachineID
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": {
    "rentOrder": [889], # Machine rentOrder Id
    "usedGpu": [0, 1, 2, 3] # Used GPU
  },
  "id": 1
}

4.2 View machine rental information

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "rentMachine_getRentOrder",
  "params": [1] # RentOrder ID
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": {
    "confirmRent": 1600590,
    "gpuIndex": [0, 1, 2, 3],
    "gpuNum": 4,
    "machineId": "0edac3b0263dd09538717bb0f5bf3f1bced70d7e017239d6f307b0801220c022",
    "rentEnd": 1635148,
    "rentStart": 1600588,
    "rentStatus": "renting",
    "renter": "5GETYD36iceKpKf1fpKdTwtToh4MskTt5RsuouYTGxmrcouC",
    "stakeAmount": "0"
  },
  "id": 1
}

4.3 View the list of `Rent Order` of an account

Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "rentMachine_getRentList",
  "params": ["5E7123qZExgZaYKnmTcJacu68c2GbLeSHo9qNWmUWcaw4RSR"] # Renter Account
}

Explanation of results

{
  "jsonrpc": "2.0",
  "result": [0, 1], # Rent OrderId
  "id": 1
}

DBC-Blockchain Mainnet RPC

# DBC-Blockchain Mainnet RPC

# 1. onlineProfile Module

# 1.1 Query all machines controlled by a certain stash account

# 1.2 Query machine's total reward of a certain Era

# 1.3. Query machine's unlocked reward of a certain Era

# 1.4 Query stash account total reward of a certain Era

# 1.5. Query stash account's unlocked reward of a certain Era

# 1.6. Query machine details

# 1.7. Check the number of stash accounts

# 1.8. View all machines in a list

# 1.9 View onlineProfile module statistics

# 1.10 Get the identity on the account chain

# 1.11 Get stash account statistics

# 1.12 Get statistics by location

# 2. Committee Module

# 2.1 committee_getCommitteeList

# 3. OnlineCommittee Module

# 3.1 Get the list of committees assigned by the machine

# 3.2 Get the committee's review time for the machine

# 3.3 Get a list of all the machines dispatched by the committee

# 4. RentMachine Modul

# 4.1 Get rentOrder ID of Machine

# 4.2 View machine rental information

# 4.3 View the list of Rent Order of an account

DBC-Blockchain Mainnet RPC

1. onlineProfile Module

1.1 Query all machines controlled by a certain stash account

1.2 Query machine's total reward of a certain Era

1.3. Query machine's unlocked reward of a certain Era

1.4 Query stash account total reward of a certain Era

1.5. Query stash account's unlocked reward of a certain Era

1.6. Query machine details

1.7. Check the number of stash accounts

1.8. View all machines in a list

1.9 View onlineProfile module statistics

1.10 Get the identity on the account chain

1.11 Get stash account statistics

1.12 Get statistics by location

2. Committee Module

2.1 committee_getCommitteeList

3. OnlineCommittee Module

3.1 Get the list of committees assigned by the machine

3.2 Get the committee's review time for the machine

3.3 Get a list of all the machines dispatched by the committee

4. RentMachine Modul

4.1 Get rentOrder ID of Machine

4.2 View machine rental information

4.3 View the list of `Rent Order` of an account