DotOne Smart Chain

https://docs.dotone.online
Admin
DotOne Smart Chain is a scalable, EVM-compatible Layer-1 blockchain designed for decentralized...
Tokens:23,202
Snippets:218
Trust Score:5.3
Update:1 week ago
Show doc for...
Tokens:
Raw
### Get Wallet Balance - Response

Source: https://docs.dotone.online/developers/api-reference

Example JSON-RPC response for eth_getBalance, returning the balance in Wei. Divide by 10^18 to convert to DOTO.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x56BC75E2D63100000"
}
```

--------------------------------

### Example enode URL output

Source: https://docs.dotone.online/validator/secure-validator

Example output from the admin.nodeInfo.enode command. The [::] represents localhost (127.0.0.1); replace it with the correct IP address (public or local) before adding to the validator's config.toml.

```text
enode://f2da64f49c30a0038bba3391f40805d531510c473ec2bcc7c201631ba003c6f1
6fa09e03308e48f87d21c0fed1e4e0bc53428047f6dcf34da344d3f5bb69373b@[::]:30306?discport=0
```

--------------------------------

### Start Validator Node

Source: https://docs.dotone.online/validator/run-validator

Starts the validator node with the required flags. Warning: never expose RPC endpoints to the public network.

```bash
geth --config ./config.toml \
  --datadir ./node \
  -unlock {your-consensus-account-address} \
  --miner.etherbase {your-consensus-account-address} \
  --password password.txt \
  --blspassword blspassword.txt \
  --mine \
  --vote \
  --allow-insecure-unlock \
  --cache 18000 \
  --history.transactions 0 \
  --history.logs.disable
```

--------------------------------

### GET /api?module=contract&action=getabi&address={contract_address}

Source: https://docs.dotone.online/developers/api-reference

Returns the ABI for a given contract address on the DotOne Explorer.

```APIDOC
## [GET] /api?module=contract&action=getabi&address={contract_address}

### Description
Returns the ABI for a given contract address on the DotOne Explorer.

### Method
GET

### Endpoint
https://dotscan.one/api/?module=contract&action=getabi&address={contract_address}

### Parameters
#### Query Parameters
- **module** (string) - Required - Must be "contract".
- **action** (string) - Required - Must be "getabi".
- **address** (string) - Required - The contract address to query.
```

--------------------------------

### GET /api?module=account&action=tokentx&address={wallet_address}

Source: https://docs.dotone.online/developers/api-reference

Returns token transfers for a given wallet address on the DotOne Explorer.

```APIDOC
## [GET] /api?module=account&action=tokentx&address={wallet_address}

### Description
Returns token transfers for a given wallet address on the DotOne Explorer.

### Method
GET

### Endpoint
https://dotscan.one/api/?module=account&action=tokentx&address={wallet_address}

### Parameters
#### Query Parameters
- **module** (string) - Required - Must be "account".
- **action** (string) - Required - Must be "tokentx".
- **address** (string) - Required - The wallet address to query.
```

--------------------------------

### GET /api?module=block&action=getblockreward&blockno={block_number}

Source: https://docs.dotone.online/developers/api-reference

Returns details for a specific block on the DotOne Explorer.

```APIDOC
## [GET] /api?module=block&action=getblockreward&blockno={block_number}

### Description
Returns details for a specific block on the DotOne Explorer.

### Method
GET

### Endpoint
https://dotscan.one/api/?module=block&action=getblockreward&blockno={block_number}

### Parameters
#### Query Parameters
- **module** (string) - Required - Must be "block".
- **action** (string) - Required - Must be "getblockreward".
- **blockno** (number) - Required - The block number to query.
```

--------------------------------

### GET /api?module=account&action=txlist&address={wallet_address}&page=1&offset=20

Source: https://docs.dotone.online/developers/api-reference

Returns the transaction history for a given wallet address on the DotOne Explorer.

```APIDOC
## [GET] /api?module=account&action=txlist&address={wallet_address}&page=1&offset=20

### Description
Returns the transaction history for a given wallet address on the DotOne Explorer.

### Method
GET

### Endpoint
https://dotscan.one/api/?module=account&action=txlist&address={wallet_address}&page=1&offset=20

### Parameters
#### Query Parameters
- **module** (string) - Required - Must be "account".
- **action** (string) - Required - Must be "txlist".
- **address** (string) - Required - The wallet address to query.
- **page** (number) - Optional - Page number for pagination.
- **offset** (number) - Optional - Number of records per page.
```

--------------------------------

### Explorer API - Get Token Transfers for Address

Source: https://docs.dotone.online/developers/api-reference

GET request to the Explorer API to retrieve token transfers for a wallet address.

```http
GET /api?module=account&action=tokentx&address={wallet_address}
```

--------------------------------

### Explorer API - Get Transaction Details

Source: https://docs.dotone.online/developers/api-reference

GET request to the Explorer API to retrieve transaction details by transaction hash.

```http
GET /api?module=transaction&action=gettxinfo&txhash={tx_hash}
```

--------------------------------

### GET /api?module=transaction&action=gettxinfo&txhash={tx_hash}

Source: https://docs.dotone.online/developers/api-reference

Returns details for a specific transaction on the DotOne Explorer.

```APIDOC
## [GET] /api?module=transaction&action=gettxinfo&txhash={tx_hash}

### Description
Returns details for a specific transaction on the DotOne Explorer.

### Method
GET

### Endpoint
https://dotscan.one/api/?module=transaction&action=gettxinfo&txhash={tx_hash}

### Parameters
#### Query Parameters
- **module** (string) - Required - Must be "transaction".
- **action** (string) - Required - Must be "gettxinfo".
- **txhash** (string) - Required - The transaction hash to query.
```

--------------------------------

### Get Wallet Balance - Request

Source: https://docs.dotone.online/developers/api-reference

Curl command to fetch the balance of a wallet address using eth_getBalance. Replace {wallet_address} with the address. The balance is returned in Wei.

```bash
curl -X POST https://rpc.dotone.network \
  -H "Content-Type: application/json" \
  --data '{
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": ["0x{wallet_address}", "latest"],
    "id": 1
  }'
```

--------------------------------

### Explorer API - Get Block Details

Source: https://docs.dotone.online/developers/api-reference

GET request to the Explorer API to retrieve block details by block number.

```http
GET /api?module=block&action=getblockreward&blockno={block_number}
```

--------------------------------

### Retrieve enode information from sentry node console

Source: https://docs.dotone.online/validator/secure-validator

Run this command in each sentry node's console to get its enode URL, which is needed for configuring the validator's static peers. The output is an enode URL in the format shown below.

```javascript
admin.nodeInfo.enode
```

--------------------------------

### Get Transaction by Hash - Request

Source: https://docs.dotone.online/developers/api-reference

Curl command to fetch transaction details by hash using eth_getTransactionByHash. Replace {transaction_hash} with the actual hash.

```bash
curl -X POST https://rpc.dotone.network \
  -H "Content-Type: application/json" \
  --data '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionByHash",
    "params": ["0x{transaction_hash}"],
    "id": 1
  }'
```

--------------------------------

### Attach to local JSON-RPC console with geth

Source: https://docs.dotone.online/developers/json-rpc

Use this command to attach to the JSON-RPC console of your own DotOne node, similar to any Geth-based chain. Requires running your own node first (see Node Operators). Standard eth_, net_, and web3_ namespace calls behave as documented in the API Reference.

```bash
geth attach http://127.0.0.1:8545
```

--------------------------------

### Get Latest Block Number - Response

Source: https://docs.dotone.online/developers/api-reference

Example JSON-RPC response for eth_blockNumber, returning the latest block number in hexadecimal.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1a2b3c"
}
```

--------------------------------

### Explorer API - Get Contract ABI

Source: https://docs.dotone.online/developers/api-reference

GET request to the Explorer API to retrieve the ABI of a contract by address.

```http
GET /api?module=contract&action=getabi&address={contract_address}
```

--------------------------------

### Import BLS Key

Source: https://docs.dotone.online/validator/run-validator

Imports an existing BLS key from a key file.

```bash
geth bls account import ${KEY_FILE} --datadir ${DATA_DIR}
```

--------------------------------

### Explorer API - Get Address Transaction History

Source: https://docs.dotone.online/developers/api-reference

GET request to the Explorer API to retrieve transaction history for a wallet address.

```http
GET /api?module=account&action=txlist&address={wallet_address}&page=1&offset=20
```

--------------------------------

### Generate Consensus Address

Source: https://docs.dotone.online/validator/run-validator

Creates a new consensus account and sets a password. DATA_DIR is the path where keystore files will be stored.

```bash
geth account new --datadir ${DATA_DIR}
```

--------------------------------

### Connect with web3.py

Source: https://docs.dotone.online/developers/api-reference

Python code to connect to the DotOne RPC using web3.py and check connection and latest block number.

```python
from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://rpc.dotone.network"))

print("Connected:", w3.is_connected())
print("Latest block:", w3.eth.block_number)
```

--------------------------------

### Resume Block Production

Source: https://docs.dotone.online/validator/run-validator

Resumes producing blocks from the node console.

```js
miner.start()
```

--------------------------------

### Confirm sentry node connections with admin.peers

Source: https://docs.dotone.online/validator/secure-validator

Run in the validator node's geth console to list connected peers. Verify each configured sentry node appears; if missing, check the enode URL, IP address, and port configuration.

```javascript
admin.peers
```

--------------------------------

### Attach to Node Console

Source: https://docs.dotone.online/validator/run-validator

Connects to the node's console via IPC to stop or resume block production.

```bash
geth attach ipc:path/to/geth.ipc
```

--------------------------------

### Get Latest Block Number - Request

Source: https://docs.dotone.online/developers/api-reference

Curl command to fetch the latest block number from the DotOne RPC endpoint using the eth_blockNumber method.

```bash
curl -X POST https://rpc.dotone.network \
  -H "Content-Type: application/json" \
  --data '{
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 1
  }'
```

--------------------------------

### WebSocket Connect

Source: https://docs.dotone.online/developers/api-reference

JavaScript code to establish a WebSocket connection to the DotOne WebSocket endpoint.

```js
const ws = new WebSocket("wss://ws.dotone.network");
```

--------------------------------

### Connect with ethers.js

Source: https://docs.dotone.online/developers/api-reference

JavaScript code to connect to the DotOne RPC using ethers.js and fetch the latest block number.

```js
import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider("https://rpc.dotone.network");

const blockNumber = await provider.getBlockNumber();
console.log("Latest block:", blockNumber);
```

--------------------------------

### Filter Peers by Pattern

Source: https://docs.dotone.online/validator/run-validator

Disconnects peers running a problematic version by updating config.toml. Restart the node after applying the change; this is a temporary measure.

```toml
[Node.P2P]
PeerFilterPatterns = ["Geth/v{problematic-version}.*"]
```

--------------------------------

### Run Metrics Exporter via Docker

Source: https://docs.dotone.online/validator/run-validator

Runs a metrics exporter container to monitor node status. Reference dashboard: Grafana Dashboard #6976.

```bash
docker run -it -d -p 9090:9090 \
  -e "GETH=http://your-node-address:8545" \
  hunterlong/gethexporter
```

--------------------------------

### Subscribe to Contract Logs

Source: https://docs.dotone.online/developers/api-reference

JavaScript code to subscribe to contract logs via WebSocket using eth_subscribe with the logs parameter. Replace {contract_address} with the contract address.

```js
ws.send(JSON.stringify({
  "jsonrpc": "2.0",
  "method": "eth_subscribe",
  "params": [
    "logs",
    {
      "address": "0x{contract_address}",
      "topics": []
    }
  ],
  "id": 3
}));
```
Tokens:
Raw