Skip to main content

Vexidus Testnet Reference

Updated: Mar 30, 2026 | Genesis: Feb 26, 2026 | RPC: https://testnet.vexidus.io

Network​

PropertyValue
Chain ID (Testnet)1618032 (0x18b070)
Block TimeAdaptive (~3s normal, 500ms-12s range)
Native TokenVXS (9 decimals)
RPC Port9933
P2P Port9945 (seed node; default is 9944)
Public IP51.255.80.34

System Accounts​

NameAddress (32-byte hex)VXS Balance%
Public Distribution0x...0001614,840,000 VXS38%
Ecosystem & DeFi0x...0002242,700,000 VXS15%
Foundation Treasury0x...0003161,800,000 VXS10%
Team & Founders0x...0004161,800,000 VXS10%
Marketing & Community0x...0005113,260,000 VXS7%
SAFT Round0x...000648,540,000 VXS3%
Testnet Rewards0x...000748,540,000 VXS3%
Staking & Strategic0x...0008161,800,000 VXS10%
Block Proposers (validators)Rotated via leader selectionEarn time-weighted rewards (85%) + fees (80%)4% over 10yr
System (bridge/token ops)0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0 (protocol-only)—

Genesis Total: 1,553,280,000 VXS (96% of 1.618B total supply). Remaining 4% (64.72M) emitted as block rewards over 10 years.

Genesis Tokens​

The current testnet genesis (Feb 27, 2026) includes VXS plus 40+ tokens pre-registered from genesis:

CategoryExamplesNotes
VXS (native)Vexidus, 9 decimals, 1.618B supplyMint address: all zeros
VSC-8 Stablecoins (18 tokens)USDC, USDT, DAI, EURC, PYUSD, JPYC, NZDS, etc.6 security layers, genesis-registered
Bridge Canonical (13+ tokens)ETH, BTC, SOL, POL, MONAD, etc.Canonical mint addresses from bridge registry

Use vex_listTokens to get the full current list with mint addresses:

curl -s -X POST https://testnet.vexidus.io -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"vex_listTokens","params":[50],"id":1}'

Quick RPC Examples​

# Get VXS balance
curl -s -X POST https://testnet.vexidus.io -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"vex_getBalance","params":["0x0000000000000000000000000000000000000000000000000000000000000001","VXS"],"id":1}'

# Get token balance by symbol
curl -s -X POST https://testnet.vexidus.io -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"vex_getBalance","params":["0x0000000000000000000000000000000000000000000000000000000000000001","USDC"],"id":1}'

# List all tokens
curl -s -X POST https://testnet.vexidus.io -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"vex_listTokens","params":[100],"id":1}'

# Transfer (convenience RPC, unsigned -- use vex_submitBundle for signed sends)
curl -s -X POST https://testnet.vexidus.io -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"vex_transfer","params":["0x...from","0x...to","VXS","1000000000"],"id":1}'

# Node version
curl -s -X POST https://testnet.vexidus.io -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"vex_version","params":[],"id":1}'

# Consensus status
curl -s -X POST https://testnet.vexidus.io -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"vex_consensusStatus","params":[],"id":1}'

Active Pools​

Use vex_listPools to get current pools:

curl -s -X POST https://testnet.vexidus.io -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"vex_listPools","params":{"limit":10},"id":1}'

Token Metadata RPC​

# Update token metadata (creator only, token must be mutable)
curl -s -X POST https://testnet.vexidus.io -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"vex_updateTokenMetadata","params":["0x...mint","0x...sender",null,"https://example.com/logo.png","Token description",null,null,null,null,null],"id":1}'

# Lock token metadata permanently (creator only, one-way)
curl -s -X POST https://testnet.vexidus.io -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"vex_lockTokenMetadata","params":["0x...mint","0x...sender"],"id":1}'

# Get token reputation score
curl -s -X POST https://testnet.vexidus.io -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"vex_getTokenReputation","params":["0x...mint"],"id":1}'

Validators (5-Node Testnet)​

RoleLocationPubkey
Gravelines (seed + validator)EU France782e...babe
Remote 1 (R1)EU Germany2605...cde0
Remote 2 (R2)EU Germany4863...3fc2
SG2Asia Singaporef576...90a2
MumbaiAsia India0b28...7a2e

Leader rotation is active with stake-weighted selection -- all 5 validators take turns proposing blocks across 4 continents. Block rewards are time-weighted (85% to proposer, 15% Foundation) with a density multiplier (0.5x empty to 2.0x heavy). Transaction fees split 80% proposer / 20% Foundation.

Notes​

  • Token mint addresses are deterministic. Genesis tokens (VSC-8, bridge canonical) are stable across restarts. Custom tokens include a timestamp component and change on data wipe.
  • All balances are raw units (multiply by 10^decimals). Divide by 10^decimals for human-readable values. Token decimals vary: VXS (9), USDC/USDT (6), BTC (8), ETH (18). Use vex_listTokens to get each token's decimal count.
  • VXS address is all zeros (0x00...00). This is the native token, not a custom token.
  • Signed transactions: Wallets sign bundles with Ed25519 via vex_submitBundle. First send from a receive-only account requires pubkey revelation (sender_pubkey field). The native wallet VexSpark (wallet.vexspark.com) handles this automatically.
  • Testnet bypass: Empty signatures still accepted with warning log for development convenience. Mainnet will reject unsigned bundles.
  • Block rewards: Time-weighted from 13M VXS/yr (Year 1-2). 85% to proposer (density-weighted), 15% to Foundation Treasury.
  • Gas fees: 10 nanoVXS per gas unit (~0.00021 VXS per transfer, ~$0.0002 at $1/VXS).
  • Faucet: https://vexswap.xyz -- max 100 VXS per address per hour.
  • Transaction pipeline verified: Signed sends, gas deduction, leader rotation, 1.5M txs processed with 0 crashes. 30+ VexVisor upgrades deployed with zero manual intervention.
  • WebSocket subscriptions: Real-time push notifications via vex_subscribe_newHeads, vex_subscribe_newTransactions, and vex_subscribe_logs. See RPC Reference.
  • Leader skip rotation: Offline validators (3+ consecutive misses) are automatically skipped in leader rotation, maintaining ~2s block time even with validator downtime.
  • Genesis timestamp: 1772064000 (Feb 26, 2026 00:00:00 UTC). Block 1 at 1772150033.