Read DIDLab directly with JSON-RPC

The public developer API starts with the Ethereum-compatible RPC that already powers the portal. These examples are read-only and safe to run from curl without exposing a wallet key.

Open Explorer Wallet quickstart

1. Confirm the chain ID

Use eth_chainId to verify that your client is talking to DIDLab.

eth_chainId

curl -sS -X POST https://eth.didlab.org \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":1}' | jq

Expected result

The result is 0x3da55, which is decimal chain ID 252501.

2. Read the latest block number

eth_blockNumber returns the current canonical head as a hexadecimal quantity.

eth_blockNumber

curl -sS -X POST https://eth.didlab.org \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":2}' | jq

3. Read a wallet balance

Replace the address with a DIDLab account. The returned native TRUST balance is denominated in wei.

eth_getBalance

ADDRESS=0xYourDidlabAddress
curl -sS -X POST https://eth.didlab.org \
  -H 'Content-Type: application/json' \
  --data "{"jsonrpc":"2.0","method":"eth_getBalance","params":["$ADDRESS","latest"],"id":3}" | jq

4. Inspect a transaction

Use a transaction hash copied from the Faucet & Funding page, Remix, Hardhat, or Blockscout.

eth_getTransactionByHash

TX=0xYourTransactionHash
curl -sS -X POST https://eth.didlab.org \
  -H 'Content-Type: application/json' \
  --data "{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["$TX"],"id":4}" | jq

5. Verify the receipt

The receipt confirms mining status, block inclusion, gas usage, contract creation address when applicable, and emitted logs.

eth_getTransactionReceipt

TX=0xYourTransactionHash
curl -sS -X POST https://eth.didlab.org \
  -H 'Content-Type: application/json' \
  --data "{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["$TX"],"id":5}" | jq

What belongs in the deeper lab?

The public portal covers safe read-only RPC calls. DIDLab Labs can extend this into signed raw transactions, event filtering, contract calls, tracing, validator observations, and evidence collection tied to student activity.

Validation profile

Network

DIDLab Blockchain

Chain ID

252501

Client

Hyperledger Besu

Consensus

QBFT

Native asset

TRUST

Platform token

TT (ERC-20)

Solidity examples

0.8.24

Last validated

August 2026

Go deeper in DIDLab Labs

Public documentation explains the workflow and expected result. Authenticated DIDLab Labs adds managed workspaces, deeper exercises, checkpoints, evidence capture, and instructor assessment.

Open DIDLab Labs