⚠️ TESTNET — Verdis Chain is currently in testnet phase. Not mainnet. Not investor-ready.
● Documentation v2.0 · Developer Guide

VERDIS CHAIN
Developer Docs

Complete guide to RPC APIs, 16 runtime pallets, DPoS consensus, AMM DEX, VRDX tokenomics, validator operations, and the 51-method JavaScript SDK. Built in Rust + Substrate.

SDK Reference →
Block Height
Live
Total Pallets
16
Runtime
SDK Methods
51
JavaScript
SS58 Prefix
909
Testnet
Designed for efficiency
Rust + Substrate

1. Getting Started

Verdis Chain is a high-throughput, Layer-1 designed for energy efficiency blockchain built using Rust and the Substrate framework. It features native DPoS consensus, built-in AMM DEX, carbon credit tracking, parallel execution, and zero-knowledge compression.

Core Network Endpoints

Developers and node operators can interact with the network using standard HTTPS RPC or high-performance WebSocket subscriptions:

Protocol Public Endpoint URL Port Description
HTTPS JSON-RPC https://verdischain.com/rpc 443 / 9933 HTTP requests for querying state, extrinsics, and block data
WebSocket RPC wss://verdischain.com/ws 443 / 9933 Real-time streaming subscriptions for blocks, events, and transactions
REST API https://api.verdischain.com/v1/ 443 / 4400 High-level REST endpoints for balances, telemetry, and faucet
Direct Node RPC http://91.98.160.145:9933 9933 Direct Substrate JSON-RPC interface

Network Parameters

Token Ticker VRDX
Native currency ticker for fee payment, staking, and DEX trading pairs.
Address Prefix SS58: 909
Custom SS58 address encoding format (Prefix 909) for Verdis accounts.
Token Decimals 9 Decimals
1 VRDX = 1,000,000,000 Plancks (base units).
Block Target 3.0 Seconds
Deterministic 3-second block production time via DPoS slots.

Quick Connection Test (cURL)

Query the latest block header directly from terminal:

Bash Terminal
# Fetch latest block header from Verdis RPC
curl -X POST https://verdischain.com/rpc \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"chain_getHeader","params":[],"id":1}'

2. Blockchain Architecture

Verdis Chain combines a Substrate runtime core with specialized high-performance pallets inspired by modern L1 state-of-the-art designs. The network uses Delegated Proof of Stake (DPoS) integrated with Proof of History (PoH) micro-timestamps and dynamic Eco-scoring.

Complete Runtime Pallets (16 Pallets)

Below is the detailed technical specification for all 16 native pallets implemented in the Verdis Chain runtime:

1. dpos Consensus
Delegated Proof of Stake election engine. Handles validator candidate bonding, delegator stake tracking, epoch rotation, slash enforcement, and block reward calculation.
2. amm-dex DeFi / AMM
Protocol-level Automated Market Maker using constant product ($x \cdot y = k$). Manages liquidity pools, swap execution, LP token issuance, and fee distribution.
3. eco Sustainability
Green scoring calculator & carbon offset registry. Tracks validator renewable energy usage, tree planting proofs, and mints verified carbon credits.
4. tokenomics Economics
Controls the fixed 100B VRDX supply curve, 5B investor allocation tracking, dynamic fee burn rates, and inflation halving schedule.
5. vesting Governance
Enforces linear and milestone-based token vesting schedules for team allocations, advisory reserves, and early contributors with cliff periods.
6. storage Storage
Decentralized storage proof module. Allows users to pin arbitrary payload hashes on-chain with cryptographic proof-of-retrievability.
7. poh Timing
Proof of History micro-timestamping engine. Generates continuous verifiable delay function (VDF) sequences to order transactions prior to block inclusion.
8. gulf-stream Mempool
Mempool-less transaction forwarding mechanism. Pushes upcoming extrinsics directly to expected future block proposers for sub-second latencies.
9. turbine Propagation
Block propagation protocol dividing proposed blocks into erasure-coded data shred packets for tree-structured broadcast across validator nodes.
10. zk-compression ZK / Scaling
Zero-Knowledge state compression pallet. Offloads full state accounts to compressed Merkle trees with ZK-SNARK validity proofs.
11. ibc Interoperability
Inter-Blockchain Communication protocol. Facilitates trustless cross-chain state proof verification and token transfer channels.
12. address-lookup-tables Optimization
Address Lookup Tables (ALT). Enables transactions to compress up to 256 account addresses into 1-byte indices for ultra-compact payloads.
13. sealevel Parallel Exec
Parallel execution scheduler. Analyzes transaction read/write accounts to execute non-overlapping extrinsics across multi-core CPUs concurrently.
14. contracts Smart Contracts
Substrate-native smart contracts via pallet_contracts. Deploy ink! contracts compiled to WebAssembly with gas-metered execution and storage rent.
15. balances / system Core System
Substrate System & Balances pallet. Manages account nonces, raw balance transfers, genesis allocations, block execution hooks, and event storage.

3. RPC API Reference

Verdis Chain provides a full suite of custom and standard Substrate JSON-RPC methods. All RPC endpoints accept standard JSON-RPC 2.0 payloads via HTTP POST or WebSocket messages.

Primary RPC Methods Reference

RPC Method Parameters Return Type Description
chain_getHeader [hash?] Header Object Retrieves block header (number, parentHash, stateRoot, extrinsicsRoot)
system_peers [] Array<Peer> Returns active connected network peers, roles, and latency
dpos_allValidators [] Array<Validator> Lists all active and candidate DPoS validators with stake totals
dpos_validatorStake [address] StakeInfo Returns self-bond amount, delegator stake, and commission rate
amm_dex_getAllPools [] Array<Pool> Retrieves all DEX liquidity pools, reserves, and 24h trading volume
eco_getGreenScore [validator] GreenScoreObj Calculates validator Green Score (0-100), renewable %, and tree credits
chain_getBlock [hash?] BlockDetails Returns full block object including extrinsics list and digest
chain_getFinalizedHead [] BlockHashString Returns the latest finalized block hash
system_health [] HealthObj Returns node status: isSyncing, peers, shouldHavePeers
system_properties [] PropertiesObj Returns ss58Format (909), tokenDecimals (9), tokenSymbol (VRDX)
author_submitExtrinsic [hexBytes] TxHashString Submits a signed SCALE-encoded transaction to the mempool
state_getStorage [key, hash?] StorageDataHex Reads raw runtime storage key-value entry

Example: Querying DPoS Validators (dpos_allValidators)

JavaScript Fetch Request
const response = await fetch('https://verdischain.com/rpc', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'dpos_allValidators',
    params: [],
    id: 1
  })
});

const { result } = await response.json();
        

4. Token Economics (VRDX)

The native currency of Verdis Chain is VRDX. VRDX powers all on-chain operations, including transaction gas fees, DPoS validator staking, AMM pool liquidity pairing, and green governance voting.

Official Ticker Notice: The official symbol for the native token is strictly VRDX. Total hard cap is fixed at 100,000,000,000 VRDX (100 Billion) with zero inflationary minting beyond block rewards.

Token Parameters Summary

Token Ticker VRDX
Native utility & governance token ticker.
Total Supply 100,000,000,000
100 Billion fixed max supply.
Investor Allocation 12,000,000,000
12 Billion VRDX (12%) across IDO Presale Phases.
Decimals & SS58 9 Dec / SS58: 909
9 decimal places with standard SS58 format prefix 909.

Supply Distribution Breakdown

Category Allocation (VRDX) % Supply Vesting & Lockup Terms
Public Sale & Presale (IDO) 12,000,000,000 VRDX 12.0% 15% unlocked TGE, linear monthly unlock over 12 months
Validator Staking & Rewards 35,000,000,000 VRDX 35.0% Emitted continuously over 10 years to DPoS validators
Eco & Carbon Credit Reserve 20,000,000,000 VRDX 20.0% Dedicated to carbon credit purchases & green validator grants
Ecosystem & Treasury 18,000,000,000 VRDX 18.0% DAO governed treasury for grants, liquidity, and expansion
Team & Core Contributors 10,000,000,000 VRDX 10.0% 12-month linear cliff followed by 36-month linear vesting
Initial AMM DEX Liquidity 5,000,000,000 VRDX 5.0% 100% locked in protocol AMM DEX pools at testnet launch

5. Validator Guide

Validators secure the Verdis Chain network by producing blocks and verifying state transitions under Delegated Proof of Stake (DPoS). Validators with higher Green Scores receive a boosted probability weight during block proposer selection.

Recommended Server Requirements

Hardware Spec Minimum Requirement Recommended Production
CPU 4 CPU Cores (2.5 GHz+) 8+ Cores (3.5 GHz+ AMD EPYC / Intel Xeon)
RAM 16 GB ECC RAM 32 GB+ ECC DDR5 RAM
Disk Storage 250 GB NVMe SSD 1 TB+ NVMe SSD (PCIe Gen4)
Bandwidth 100 Mbps Unlimited 1 Gbps+ Symmetric Dedicated Connection
Energy Source Standard Grid 100% Verified Renewable Energy (Solar / Wind / Hydro)

Step-by-Step Validator Setup

Terminal Commands
# 1. Download & Build Verdis Chain Node
git clone https://github.com/Protremix/Verdischain.git
cd Verdischain
cargo build --release

# 2. Start Syncing Node as Validator
./target/release/verdis \
  --validator \
  --chain verdis-testnet \
  --name "My-Green-Validator" \
  --rpc-port 9933 \
  --ws-port 9944

# 3. Generate Session Keys via RPC
curl -H "Content-Type: application/json" \
  -d '{"id":1, "jsonrpc":"2.0", "method":"author_rotateKeys", "params":[]}' \
  http://localhost:9933

Green Score Calculation Formula

The eco pallet dynamically computes a validator's Green Score ($GS$) between 0 and 100 based on three telemetry parameters:

Green Score Mathematical Formula
Green Score (GS) = (0.50 × Uptime%) + (0.35 × RenewableEnergy%) + (0.15 × CarbonOffsetRatio)

# Where:
# Uptime%: Node online percentage per epoch (target: 99.9%+)
# RenewableEnergy%: Certified clean energy powering server (0-100%)
# CarbonOffsetRatio: On-chain retired carbon credits vs consumed kWh

6. DEX / AMM Guide

Verdis Chain features a native, protocol-level Automated Market Maker (amm-dex) built directly into the runtime. It enables instant, low-gas token swaps without smart contract overhead.

AMM Mechanics & Fee Structure

Formula x · y = k
Constant product liquidity formula ensuring continuous pool liquidity at all price curves.
Swap Fee 0.30% Total
0.25% distributed to LP provider token holders, 0.05% automatically routed to eco carbon burn.
Liquidity Tokens vLP Tokens
Liquidity providers receive pool-specific vLP tokens representing share of pooled assets.

Executing Swaps via SDK

JavaScript Example
import { VerdisSDK } from './verdis-sdk.js';

const sdk = new VerdisSDK('wss://verdischain.com/ws');
await sdk.connect();

// Query available AMM liquidity pools
const pools = await sdk.getPools(10);

// Fetch pool #0 details (VRDX / USDT)
const poolZero = await sdk.getPool(0);
        

7. SDK Reference (51 Methods)

The official Verdis JavaScript SDK (sdk/verdis-sdk.js) is a lightweight, zero-dependency library using native WebSockets to interact with Verdis Chain nodes. It exposes 51 complete methods spanning all chain capabilities.

SDK Path: The SDK file is located at sdk/verdis-sdk.js on the server. Import VerdisSDK in Node.js or browser projects.

Complete List of 51 SDK Methods

1. Connection & Core RPC (5 Methods)

#Method SignatureDescription
1constructor(wsUrl, options)Initialize SDK instance with WS URL and timeout options
2connect()Establish WebSocket connection with auto-reconnect
3disconnect()Close active WebSocket socket connection
4isConnected()Returns boolean connection status
5rpc(method, params)Low-level raw JSON-RPC call wrapper

2. Chain & Block Queries (6 Methods)

#Method SignatureDescription
6getBlockHeight()Fetch current finalized block height number
7getBlock(hash?)Get full block object for given hash or head
8getBlockHash(blockNum)Get block hash for specific block number
9getFinalizedHead()Fetch latest finalized block hash string
10getChainName()Returns human-readable chain name
11getChainType()Returns chain development type (Development/Live)

3. System & Node Telemetry (5 Methods)

#Method SignatureDescription
12getNodeVersion()Returns Node software semver version
13getNodeName()Returns Substrate node binary name
14getSystemHealth()Returns system health (isSyncing, peers)
15getSystemProperties()Returns SS58 format (909), symbol (VRDX), decimals (9)
16getRuntimeVersion()Returns specName, specVersion, implVersion

4. Accounts & Balances (3 Methods)

#Method SignatureDescription
17getAccountInfo(address)Fetch raw System.Account storage data
18getBalance(address)Returns free, reserved, and frozen VRDX balance
19getNonce(address)Fetch account transaction nonce count

5. DPoS & Staking (5 Methods)

#Method SignatureDescription
20getValidators()Fetch list of active consensus validator addresses
21getValidatorCount()Returns total count of registered validators
22getActiveValidators()Fetch active set for current election era
23getTotalStaked()Returns sum total of VRDX staked across DPoS
24getCurrentEpoch()Returns current era index and block progress

6. AMM DEX & Liquidity (5 Methods)

#Method SignatureDescription
25getPoolCount()Returns total number of created DEX liquidity pools
26getPool(poolId)Fetch pool token pair reserves and total LP supply
27getPools(limit = 10)List multiple pools up to specified limit count
28getTotalVolume()Returns 24-hour aggregate USD trading volume
29getTotalSwaps()Returns cumulative total swap count executed on-chain

7. Eco Metrics & Carbon Offset (5 Methods)

#Method SignatureDescription
30getCarbonCredits()Fetch active certified carbon credit list
31getGreenValidators()Returns top validators sorted by Green Score
32getTotalCo2Offset()Returns total metric tons CO2 offset on-chain
33getTotalTreesPlanted()Returns certified total trees planted count
34getTotalCreditsRetired()Returns total count of permanently retired credits

8. Tokenomics & Vesting (4 Methods)

#Method SignatureDescription
35getTotalSupply()Query VRDX total issued supply on-chain
36getPresalePrice()Fetch active presale IDO stage VRDX token price
37getVestingSchedules()Query vesting unlock milestones for account
38getPinnedData()Retrieve pinned storage commitments

9. Extrinsics & Subscriptions (5 Methods)

#Method SignatureDescription
39submitExtrinsic(extrinsic)Broadcast signed transaction byte payload to cluster
40pendingExtrinsics()Returns transactions currently waiting in mempool
41subscribeNewHeads(callback)Subscribe to real-time new block header events
42subscribeFinalizedHeads(callback)Subscribe to finalized block header events
43unsubscribe(subId)Unsubscribe from active WebSocket subscription ID

10. Low-Level Storage & Codec Utilities (8 Methods)

#Method SignatureDescription
44queryStorage(module, key, blockHash)Query runtime storage item by module name & key
45queryStorageAt(keys, blockHash)Batch query multiple storage keys at specific block
46getKeys(prefix, blockHash)Fetch list of storage keys matching prefix
47getEvents(blockHash)Decode raw system events emitted in block
48getConstant(module, constant)Read runtime metadata constant value
49_storageKey(module, item, ...params)Compute Twox128 + Blake2 storage key hash
50_hashModule(name)Internal helper to compute Twox128 module hash
51_hashItem(name)Internal helper to compute Twox128 item hash

Complete SDK Initialization Code

JavaScript SDK Quickstart
// Import VerdisSDK from local SDK path
import { VerdisSDK } from './verdis-sdk.js';

async function main() {
  // Initialize connection to Verdis Chain WebSocket
  const sdk = new VerdisSDK('wss://verdischain.com/ws');
  await sdk.connect();

  // Fetch node properties and telemetry
  const props = await sdk.getSystemProperties();

  // Subscribe to live block production
  const subId = await sdk.subscribeNewHeads((header) => {
  });
}

main().catch(console.error);