WebChain Documentation

Core Features

Blockchain Architecture

• WebRTC P2P Network: Custom blockchain built with WebRTC enabling direct validator communication
• Hybrid Consensus: PoC+ (Proof-of-Concept+) combining PoS and PoC elements
• On-chain Operations: Supports mining, staking, order broadcasting, and P2P validators/peers
• EVM Compatibility: Fully compatible with MetaMask, Ethereum wallets, and DApps
• Validator Mining: Validators can mine ETK every 60 minutes after staking 370 ETK and maintaining 0.0000001 ETK balance
• Instant Confirmations: Transactions deposited into off-chain wallet from the user mining on-chain wallet in milliseconds
• WooCommerce Integration: Broadcasts all WooCommerce completed orders to the blockchain

Technical Integration

• JSON-RPC Endpoint: Full Ethereum-compatible endpoint for MetaMask integration at https://rpc.webchain.e-talk.xyz/
• Custom REST API: Includes /rpc, /supply, /verify-validator, /process-order, /mining-events, and /validator endpoints
• Peer System: Complete validator registration and peer management system
• Transaction Viewer: Real-time transaction display with verification status indicators
• E-Talk Plugin: Allows vendors to broadcast trade history to WebChain

Recent Enhancements

• On-chain Mining: Validator mining functionality now fully operational
• Multi-chain Support: ETK Scan verifies transactions on Ethereum, BSC, Polygon, and WebChain
• Auto-broadcasting: WooCommerce sites using sync plugins automatically broadcast completed orders

Technical Specifications

{
    "from": "0x...",
    "to": "0x...",
    "amount": 1.23,
    "nonce": 5,
    "note": "Payment",
    "timestamp": 1234567890,
    "hash": "0x..."
}

const { ethers } = require("ethers");
const fetch = require("node-fetch");

const RPC_URL = "https://rpc.webchain.e-talk.xyz";
const privateKey = "0x...";
const toAddress = "0x...";
const amountToSend = "20";

async function sendRawTx() {
  const provider = new ethers.providers.JsonRpcProvider(RPC_URL);
  const wallet = new ethers.Wallet(privateKey, provider);
  const nonce = await provider.getTransactionCount(wallet.address);
  const tx = {
    nonce,
    to: toAddress,
    value: ethers.utils.parseEther(amountToSend),
    gasLimit: ethers.utils.hexlify(21000),
    gasPrice: ethers.utils.hexlify(0),
    chainId: 1000001
  };
  const signedTx = await wallet.signTransaction(tx);
  const payload = {
    jsonrpc: "2.0",
    id: 1,
    method: "eth_sendRawTransaction",
    params: [signedTx]
  };
  const response = await fetch(RPC_URL, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(payload)
  });
  const json = await response.json();
  console.log("Transaction Hash:", json.result);
}
sendRawTx();
    

{
  "index": 43,
  "timestamp": 1698863000,
  "transactions": [...],
  "previous_hash": "a4f...",
  "hash": "c8e...",
  "merkle_root": "e9c...",
  "nonce": 102,
  "validator": "0xABCD..."
}

WebChain Decentralized Exchange (DEX) API

WebChain DEX provides endpoints for real-time market data, trading, liquidity management, and analytics, enabling seamless integration with platforms and tools.

Method: GET
URL: https://rpc.webchain.e-talk.xyz/price/etk
Description: Returns the current price of ETK.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/dex/pools
Description: Returns a list of all liquidity pools.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/dex/pool/{token_a}/{token_b}
Description: Returns detailed info for a specific liquidity pool. Replace {token_a} and {token_b} with token symbols.
        

Method: POST
URL: https://rpc.webchain.e-talk.xyz/dex/add-liquidity
Body Parameters:
{
    "token_a": "string",
    "token_b": "string",
    "amount_a": "number",
    "amount_b": "number"
}
Description: Adds liquidity to a specified pool.
        

Method: POST
URL: https://rpc.webchain.e-talk.xyz/dex/remove-liquidity
Body Parameters:
{
    "pool_id": "string",
    "liquidity": "number"
}
Description: Removes a portion of liquidity from a pool.
        

Method: POST
URL: https://rpc.webchain.e-talk.xyz/dex/swap
Body Parameters:
{
    "input_token": "string",
    "output_token": "string",
    "input_amount": "number",
    "min_output": "number (optional)"
}
Description: Swaps tokens in the DEX pool.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/dex/my-liquidity
Description: Returns the logged-in user's liquidity positions.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/dex/history
Query Parameters (optional):
    wallet: string
    limit: number (default: 50)
Description: Returns trade history. Can filter by wallet.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/dex/quote
Query Parameters:
{
    "input_token": "string",
    "output_token": "string",
    "input_amount": "number"
}
Description: Returns estimated output amount for a swap.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/wallet/{wallet}/all-balances
Description: Returns balances for the specified wallet address.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/tokens/all-with-etk
Description: Returns a list of all tokens paired with ETK.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/dex/debug-liquidity
Description: Returns detailed info of user's liquidity for debugging.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/supply
Description: Returns ETK supply info.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/dex/volume-pair/{token_a}/{token_b}
Description: Returns 24h volume for a token pair.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/dex/volume/{token}
Query Parameters (optional):
    days: number (default 7, max 30)
Description: Returns volume for a token over a period of days.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/market/summary
Description: Provides market summary for all trading pairs.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/market/pair/{pair_id}
Description: Returns market data for a specific trading pair.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/market/history/{pair_id}?interval=1
Description: Returns historical data for charts. Interval in hours/days.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/dex/pairs
Description: Returns all available trading pairs.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/cmc/metadata
Description: Returns CoinMarketCap metadata for ETK.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/cmc/listings
Description: Returns CoinMarketCap token listings.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/coingecko/market
Description: Returns market data from CoinGecko for ETK and pairs.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/wusd-reserve
Description: Returns current WUSD reserve in DEX pools.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/dex/fee-earnings
Description: Returns total fees earned from DEX liquidity pools.
        

Method: GET
URL: https://rpc.webchain.e-talk.xyz/fear-greed
Description: Returns a sentiment index (0–100) reflecting market emotions based on DEX data.

WebChain DEX – JSON-RPC Interface

WebChain provides a standard Ethereum-compatible JSON-RPC interface for direct interaction with liquidity pools and tokens. All endpoints use the standard JSON-RPC 2.0 protocol.

https://rpc.webchain.e-talk.xyz

1. Factory Contract

Factory Address: 0x1234567890abcdef1234567890abcdef12345678

Get Pool Address by ID

curl -X POST https://rpc.webchain.e-talk.xyz/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [{
      "to": "0x1234567890abcdef1234567890abcdef12345678",
      "data": "0xfeb6d6c00000000000000000000000000000000000000000000000000000000000000001"
    }, "latest"],
    "id": 1
  }'

Description: Returns pool address for given pool ID (1, 2, 3, etc.)

Example Pools:

• Pool 1: 0x07407ad272decf9f07a65a0ca1d4a01e56b8dba0
• Pool 2: 0x3b0a21b59d9fb4e2872b28b747fac4e9f2d2d466

2. Liquidity Pool Methods

Use any pool address to query pool information

Get Factory Address

curl -X POST https://rpc.webchain.e-talk.xyz/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [{
      "to": "0x07407ad272decf9f07a65a0ca1d4a01e56b8dba0",
      "data": "0xc45a0155"
    }, "latest"],
    "id": 1
  }'

Get Pool Reserves

curl -X POST https://rpc.webchain.e-talk.xyz/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [{
      "to": "0x07407ad272decf9f07a65a0ca1d4a01e56b8dba0",
      "data": "0x0902f1ac"
    }, "latest"],
    "id": 1
  }'

Get Token0 Address

curl -X POST https://rpc.webchain.e-talk.xyz/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [{
      "to": "0x07407ad272decf9f07a65a0ca1d4a01e56b8dba0",
      "data": "0x0dfe1681"
    }, "latest"],
    "id": 1
  }'

Get Token1 Address

curl -X POST https://rpc.webchain.e-talk.xyz/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [{
      "to": "0x07407ad272decf9f07a65a0ca1d4a01e56b8dba0",
      "data": "0xd21220a7"
    }, "latest"],
    "id": 1
  }'

Check Pool Contract

curl -X POST https://rpc.webchain.e-talk.xyz/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getCode",
    "params": ["0x07407ad272decf9f07a65a0ca1d4a01e56b8dba0", "latest"],
    "id": 1
  }'

Get Pool Events (Swap History)

curl -X POST https://rpc.webchain.e-talk.xyz/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [{
      "address": "0x07407ad272decf9f07a65a0ca1d4a01e56b8dba0",
      "fromBlock": "0x0",
      "toBlock": "latest"
    }],
    "id": 1
  }'

3. WVM-20 Token Methods (ERC-20 Compatible)

Query token information using standard ERC-20 methods

Get Token Name

curl -X POST https://rpc.webchain.e-talk.xyz/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [{
      "to": "0xf7335eb320a05d263965d5052156863af9e20570",
      "data": "0x06fdde03"
    }, "latest"],
    "id": 1
  }'

Get Token Symbol

curl -X POST https://rpc.webchain.e-talk.xyz/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [{
      "to": "0xf7335eb320a05d263965d5052156863af9e20570",
      "data": "0x95d89b41"
    }, "latest"],
    "id": 1
  }'

Get Token Decimals

curl -X POST https://rpc.webchain.e-talk.xyz/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [{
      "to": "0xf7335eb320a05d263965d5052156863af9e20570",
      "data": "0x313ce567"
    }, "latest"],
    "id": 1
  }'

Get Total Supply

curl -X POST https://rpc.webchain.e-talk.xyz/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [{
      "to": "0xf7335eb320a05d263965d5052156863af9e20570",
      "data": "0x18160ddd"
    }, "latest"],
    "id": 1
  }'

Get Token Balance

curl -X POST https://rpc.webchain.e-talk.xyz/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [{
      "to": "0xf7335eb320a05d263965d5052156863af9e20570",
      "data": "0x70a08231000000000000000000000000f51a1175098f814a751dc339b7d5a47f786fb3a4"
    }, "latest"],
    "id": 1
  }'

Note: Replace the last 40 characters with the wallet address you want to query

📋 Method Reference

Exchange Integration Guide

🌐 WebChain Is a Layer-1 Blockchain

WebChain is a full Layer-1 blockchain (PoC+) powered by the WebChain Virtual Machine (WVM) with its native coin ETK. It provides Ethereum-style JSON-RPC methods for interface compatibility, allowing exchanges to integrate using familiar tools. However, execution and state transitions are governed by WebChain’s validator-based consensus model. For enhanced security, WebChain also provides a REST-based RPC Gateway with OTP verification and validator approval.

🔧 Standard JSON-RPC Integration (Recommended for Exchanges)

Connect to our RPC endpoint similar to Ethereum. Note: JSON-RPC is provided for compatibility — transaction execution is controlled by the WebChain validator consensus layer.

POST https://rpc.webchain.e-talk.xyz
{
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": ["0xYourHotWallet", "latest"],
  "id": 1
}
    

Supported JSON-RPC Methods

• eth_chainId – Returns chain ID [Recommended]
• net_version – Returns network version [Recommended]
• eth_getBalance – Returns account balance [Recommended]
• eth_sendTransaction – Processes signed transactions [Legacy/Optional]
• eth_sendRawTransaction – Submits transaction for validator inclusion [Recommended]
• eth_getTransactionReceipt – Returns transaction details [Recommended]
• eth_blockNumber – Returns latest block number [Recommended]
• eth_getBlockByNumber – Returns block information [Legacy/Optional]
• eth_getTransactionCount – Returns account nonce [Recommended]

ETK-Specific JSON-RPC Methods

• etk_sendRawTransaction – Broadcast validator-approved ETK transaction with OTP [Recommended]
• etk_getBalance – Get ETK balance (on-chain) [Recommended]
• etk_getTransactionCount – Get nonce for a wallet [Recommended]
• etk_getBlockByNumber – Fetch block info by number [Recommended]
• etk_getBlockByHash – Fetch block info by hash [Recommended]
• etk_getTransactionByHash – Get transaction details by hash [Recommended]
• etk_blockNumber – Latest block number [Recommended]
• etk_syncing – Node syncing status [Recommended]
• etk_chainId – WebChain chain ID [Recommended]
• etk_gasPrice – Returns 0 ETK [Recommended]
• etk_getValidators – List of validators [Recommended]
• etk_getSupply – Total ETK supply [Recommended]

Example Use Cases

• Deposit Processing: Monitor incoming transactions via etk_getTransactionByHash
• Withdrawal Processing: Execute withdrawals through a Super Validator using etk_sendRawTransaction
• Bulk Withdrawals: Submit multiple validator-approved transactions
• OTP Security: Ensure secure execution for off-chain → on-chain operations

🔐 WebChain RPC Gateway (Enhanced Integration)

Exchanges may use the REST-based RPC Gateway for simplified integration with built-in OTP verification, validator approval, and wallet safety checks.

1. Get User Balance

GET /balance?user_id=99999&check_validator=true
    

2. Off-chain to On-chain Transfer (OTP)

POST /transfer
{
  "user_id": 1,
  "amount": 50.0,
  "validator_address": "0x"
}
    

3. On-chain Withdrawal

POST /withdraw
{
  "user_id": 1,
  "amount": 1.0,
  "to": "0xExternalWalletAddressHere",
  "validator_address": "0x"
}
    

4. Confirm Transaction

POST /confirm_tx
{
  "user_id": 1,
  "otp": "dgXq8a"
}
    

📋 Prerequisites

• Super Validator wallet
• Static IP addresses
• RPC endpoint access

📝 Onboarding

Submit Super Validator request including company info, infrastructure details, and expected transaction volume for approval.

🔒 Security Requirements

⚠️ Troubleshooting

WebChain Validator Layer (WVM-20 Tokens)

Core Features

REST API Endpoints

The Validator Layer exposes REST APIs for token operations:

Token Creation Lifecycle

1. User submits token creation request
2. Token enters pending state
3. Validators review and vote
4. Upon consensus, token is finalized
5. Token becomes active on-chain
6. Initial supply is assigned based on protocol rules

MetaMask Integration

Add WebChain to MetaMask with:

WooCommerce Integration

Process WooCommerce orders on WebChain via:

Order Data Structure

{
    "order_id": 123,
    "amount": 10.50,
    "currency": "USD",
    "customer": {
        "id": 456,
        "email": "user@example.com"
    },
    "items": [{
        "product_id": 789,
        "name": "Product Name",
        "quantity": 1,
        "price": 10.50
    }],
    "user_email": "validator@example.com",
    "wallet": "0x..."
}

Non-CMS Platform Integration

If your platform does not use WordPress, you can broadcast orders to WebChain using the HTTP request below. This works on any language or stack that can make HTTP requests.

### 1. Test WebChain Order Broadcast
POST https://rpc.webchain.e-talk.xyz/process-order
Content-Type: application/json

{
  "user_email": "validator@e-talk.xyz",
  "wallet": "0x1234567890abcdef1234567890abcdef12345678",
  "order_data": {
    "order_id": 9999,
    "amount": 10.50,
    "currency": "USD",
    "customer": {
      "id": 1204,
      "email": "test@e-talk.xyz"
    },
    "items": [
      {
        "product_id": 111,
        "name": "Test Product",
        "quantity": 1,
        "price": 10.50
      }
    ]
  }
}