proxmox/docs/archive/completion/BLOCKSCOUT_PARAMETERS_COMPLETE_GUIDE.md

Blockscout Parameters - Complete Guide

Date: December 23, 2025
Domain: https://explorer.d-bis.org
Status: ✅ API Working | ⚠️ Web Interface Initializing

---

✅ Current Status

What's Working

• ✅ API Endpoints: Fully functional with proper parameters
• ✅ Network Stats: Available at /api/v2/stats
• ✅ Block Data: Accessible via API
• ✅ Indexing: 115,998+ blocks indexed and growing

What's Not Working

• ⚠️ Web Interface Routes: Return 404 (root path, /blocks, /transactions)
• Reason: Web interface may need more initialization time or specific data

---

📋 Required Parameters for Blockscout API

API Endpoint Structure

All Blockscout API calls require at minimum:

?module=<MODULE>&action=<ACTION>

1. Block Module Parameters

Get Latest Block Number

GET /api?module=block&action=eth_block_number

Required Parameters:

• module=block
• action=eth_block_number

Example:

curl "https://explorer.d-bis.org/api?module=block&action=eth_block_number"

Response:

{"jsonrpc":"2.0","result":"0x1c520","id":1}

---

Get Block by Number

GET /api?module=block&action=eth_get_block_by_number&tag=<BLOCK_NUMBER>&boolean=true

Required Parameters:

• module=block
• action=eth_get_block_by_number
• tag=<BLOCK_NUMBER> - Block number in hex (e.g., 0x1 for block 1, 0x64 for block 100)

Optional Parameters:

• boolean=true - Include full transaction objects (default: false)

Example:

# Get block 1
curl "https://explorer.d-bis.org/api?module=block&action=eth_get_block_by_number&tag=0x1&boolean=true"

# Get latest block (current: 115,984 = 0x1c520 in hex)
curl "https://explorer.d-bis.org/api?module=block&action=eth_get_block_by_number&tag=latest&boolean=true"

---

2. Transaction Module Parameters

Get Transaction by Hash

GET /api?module=transaction&action=eth_getTransactionByHash&txhash=<TRANSACTION_HASH>

Required Parameters:

• module=transaction
• action=eth_getTransactionByHash
• txhash=<HASH> - Transaction hash (0x-prefixed, 66 characters)

Example:

curl "https://explorer.d-bis.org/api?module=transaction&action=eth_getTransactionByHash&txhash=0x..."

---

3. Account Module Parameters

Get Address Balance

GET /api?module=account&action=eth_get_balance&address=<ADDRESS>&tag=latest

Required Parameters:

• module=account
• action=eth_get_balance
• address=<ADDRESS> - Ethereum address (0x-prefixed, 42 characters)
• tag=latest - Block tag (latest, earliest, pending, or hex block number)

Example:

curl "https://explorer.d-bis.org/api?module=account&action=eth_get_balance&address=0x0000000000000000000000000000000000000000&tag=latest"

---

Get Address Transactions

GET /api?module=account&action=txlist&address=<ADDRESS>&startblock=0&endblock=99999999&page=1&offset=10

Required Parameters:

• module=account
• action=txlist
• address=<ADDRESS> - Ethereum address

Optional Parameters:

• startblock=0 - Start block number (default: 0)
• endblock=99999999 - End block number (default: 99999999)
• page=1 - Page number (default: 1)
• offset=10 - Results per page (default: 10)

Example:

curl "https://explorer.d-bis.org/api?module=account&action=txlist&address=0x...&startblock=0&endblock=99999999&page=1&offset=10"

---

4. Stats Endpoint (v2 API)

Get Network Statistics

GET /api/v2/stats

Parameters: None required

Example:

curl "https://explorer.d-bis.org/api/v2/stats"

Response:

{
  "total_blocks": "115998",
  "total_transactions": "46",
  "total_addresses": "32",
  "average_block_time": 2000.0,
  "coin_price": "2920.55",
  "gas_prices": {
    "slow": 0.01,
    "average": 0.01,
    "fast": 0.01
  },
  ...
}

---

🌐 Why "Page Not Found" on Root Path?

Issue Analysis

Current Behavior:

• ✅ API endpoints work perfectly with parameters
• ✅ Blockscout is indexing (115,998+ blocks)
• ❌ Web interface routes return 404

Possible Causes

1. Static Assets Not Generated

   • Static files directory exists but is empty
   • Blockscout Docker image may serve assets differently
   • Modern Blockscout may serve assets dynamically

2. Web Interface Route Configuration

   • Blockscout may not have a root route handler
   • Web interface may require specific initialization
   • May need minimum data requirements

3. Initialization Status

   • Web interface may still be initializing
   • Phoenix endpoint may need more time
   • Routes may activate after specific conditions

---

✅ Solution: Use Working API Endpoints

Immediate Access - Use These NOW

All of these work right now:

1. Network Statistics:

   https://explorer.d-bis.org/api/v2/stats
   

2. Latest Block:

   https://explorer.d-bis.org/api?module=block&action=eth_block_number
   

3. Block Details:

   https://explorer.d-bis.org/api?module=block&action=eth_get_block_by_number&tag=0x1c520&boolean=true
   

4. Transaction:

   https://explorer.d-bis.org/api?module=transaction&action=eth_getTransactionByHash&txhash=<HASH>
   

5. Address Balance:

   https://explorer.d-bis.org/api?module=account&action=eth_get_balance&address=<ADDRESS>&tag=latest
   

---

🔧 Fixing Web Interface 404

Option 1: Wait for Full Initialization

The web interface may become available after:

• More blocks are indexed
• More transactions are indexed
• Web interface fully initializes

Action: Wait 1-2 hours and check again.

---

Option 2: Check Blockscout Version

Some Blockscout versions may require:

• Specific initialization sequence
• Additional environment variables
• Static asset compilation

Check:

docker exec blockscout /app/bin/blockscout version

---

Option 3: Access via Direct Block/Address URLs

Once you have specific block numbers or addresses, try:

https://explorer.d-bis.org/block/<BLOCK_NUMBER>
https://explorer.d-bis.org/address/<ADDRESS>

These routes may work even if root path doesn't.

---

📊 Current Indexing Status

From API Stats:

• Total Blocks: 115,998
• Total Transactions: 46
• Total Addresses: 32
• Latest Block: 115,984 (0x1c520)

Status: ✅ Indexing is active and progressing

---

🎯 Recommended Actions

For Immediate Use

Use the API endpoints - they're fully functional:

# Get network stats
curl "https://explorer.d-bis.org/api/v2/stats"

# Get latest block
curl "https://explorer.d-bis.org/api?module=block&action=eth_block_number"

# Get specific block
curl "https://explorer.d-bis.org/api?module=block&action=eth_get_block_by_number&tag=0x1c520&boolean=true"

For Web Interface

1. Wait: Give Blockscout more time to fully initialize
2. Monitor: Check logs for web interface messages
3. Test: Try accessing specific routes (e.g., /block/1)

---

📝 Complete Parameter Reference

All Required Parameters

Module	Action	Required Parameters	Optional Parameters
block	eth_block_number	None	None
block	eth_get_block_by_number	tag	boolean
transaction	eth_getTransactionByHash	txhash	None
account	eth_get_balance	address, tag	None
account	txlist	address	startblock, endblock, page, offset
token	tokeninfo	contractaddress	None
token	tokenbalance	contractaddress, address	None
stats	N/A	None (v2 API)	None

---

✅ Summary

What You Need to Know:

1. API Endpoints Work ✅

   • Use /api?module=<MODULE>&action=<ACTION>&<PARAMS>
   • Use /api/v2/stats for statistics
   • All require proper parameters

2. Web Interface Status ⚠️

   • Returns 404 currently
   • May need more initialization time
   • Use API endpoints for now

3. Parameters Required:

   • All API calls: module and action (minimum)
   • Block queries: tag (block number in hex)
   • Transaction queries: txhash
   • Account queries: address and tag

Bottom Line: The API works perfectly - use it with proper parameters. The web interface may become available later, but the API provides all functionality you need right now!

---

Last Updated: December 23, 2025