Mainnet Live · Chain ID 713714

Vordium Documentation

The AI Layer for Crypto

Vordium is a high-performance EVM blockchain designed for autonomous AI agents. Sub-400ms finality, full EVM compatibility, and native agent support — everything you need to deploy autonomous strategies on-chain.

Faucet
Get testnet VORD
SDK
Install Python SDK
Explorer
View on VordScan

Quick Start

Up and running in 60 seconds.

Step 1 — Install the SDK

bash
pip install vordium

Step 2 — Create your agent

python
from vordium import Agent

agent = Agent()
print(agent.address)
# 0x742d35Cc6634C0532925a3b8D4C9D5...
print(agent.balance)
# 100.0 VORD

Step 3 — Get testnet VORD

python
agent.fund()
# Funded with 100 VORD ✅

Step 4 — Run autonomously

python
import asyncio
from vordium import Agent

agent = Agent()

async def strategy(agent):
    print(f"Block: {agent.block}")
    print(f"Balance: {agent.balance} VORD")

asyncio.run(agent.run(strategy=strategy))

Installation

Get the Vordium SDK running locally.

Python (recommended)

bash
pip install vordium

Verify installation

bash
vordium status
# Chain:    Vordium Chain
# Block:    1,400,042
# Status:   🟢 Online

From source

bash
git clone https://github.com/Vordium/vordium-py
cd vordium-py
pip install -e .

Requirements

  • Python 3.8+
  • pip

AI Agents SDK Overview

Build autonomous agents that live on-chain.

The Vordium SDK is a first-class Python library for building AI agents that interact directly with Vordium Chain. It abstracts wallet management, transaction signing, balance tracking, and async execution — so you can focus on strategy logic.

What you can build

  • Trading agents — autonomous market-making, arbitrage, momentum strategies.
  • AI-driven agents — LLMs making decisions on-chain via Claude or GPT-4.
  • Monitoring bots — react to block events, balance changes, contract calls.
  • Protocol automation — keeper bots, liquidators, yield optimizers.

Python SDK

Full reference for vordium-py.

Agent class

python
from vordium import Agent

# Create agent (auto-generates wallet)
agent = Agent()

# Load existing wallet
agent = Agent(private_key="0x...")

# Using .env file
# VORDIUM_PRIVATE_KEY=0x...
agent = Agent()  # auto-loads from env

Properties

python
agent.address      # Wallet address
agent.private_key  # Private key
agent.balance      # VORD balance (float)
agent.block        # Current block number

Methods

python
agent.fund()              # Get testnet VORD
agent.send(to, amount)    # Send VORD
agent.is_healthy()        # Health check
await agent.run()         # Run autonomously

Wallet class

python
from vordium import Wallet

# Create new wallet
wallet = Wallet.create()
print(wallet.address)
print(wallet.private_key)

# Load from private key
wallet = Wallet.from_key("0x...")

# Load from mnemonic
wallet = Wallet.from_mnemonic("word1 word2 ...")

# Check balance
balance = wallet.balance()

# Save to file
wallet.save("wallet.json")

Chain class

python
from vordium import Chain

chain = Chain()

chain.connected              # True/False
chain.block_number           # Latest block
chain.gas_price              # Gas in gwei
chain.get_balance(addr)      # Balance of address
chain.get_transaction(hash)  # Get transaction

JavaScript SDK

Coming soon.

A TypeScript/JavaScript SDK with the same ergonomic API is in development. In the meantime, use ethers.js or viem directly against https://rpc.vordium.com.

javascript
import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider("https://rpc.vordium.com");
const block = await provider.getBlockNumber();
console.log("Block:", block);

CLI Reference

The vordium command.

Initialize agent

bash
vordium init

Check chain status

bash
vordium status

Check balance

bash
vordium balance
vordium balance 0x...

Get testnet VORD

bash
vordium fund

Send VORD

bash
vordium send 0xRecipient 10.0

Run an agent script

bash
vordium run my_agent.py

Interactive mode

bash
vordium

Examples

Real agent patterns you can copy.

Example 1 — Hello Vordium

python
from vordium import Agent, Chain

chain = Chain()
print(f"Block: {chain.block_number:,}")
print(f"Connected: {chain.connected}")

agent = Agent()
print(f"Address: {agent.address}")
print(f"Balance: {agent.balance} VORD")

Example 2 — Autonomous Agent

python
import asyncio
from vordium import Agent

agent = Agent()

async def my_strategy(agent):
    block = agent.block
    balance = agent.balance
    print(f"Block {block:,} | {balance:.4f} VORD")
    # Add your trading logic here

asyncio.run(agent.run(
    strategy=my_strategy,
    interval=1.0  # Run every second
))

Example 3 — Send VORD

python
from vordium import Agent

agent = Agent()
print(f"Balance: {agent.balance} VORD")

tx = agent.send(
    to="0xRecipient...",
    amount=10.0
)
print(f"Sent! TX: {tx}")

Example 4 — Claude AI Agent

Use Claude Opus 4.6 to make live trading decisions.

python
import asyncio
from anthropic import Anthropic
from vordium import Agent

claude = Anthropic()
agent = Agent()

async def ai_strategy(agent):
    response = claude.messages.create(
        model="claude-opus-4-6",
        max_tokens=200,
        messages=[{
            "role": "user",
            "content": f"""
You are a trading agent on Vordium Chain.
Block: {agent.block}
Balance: {agent.balance} VORD

What should I do? Reply with one word:
BUY, SELL, or HOLD
"""
        }]
    )
    decision = response.content[0].text.strip()
    print(f"AI Decision: {decision}")

asyncio.run(agent.run(strategy=ai_strategy))

Network Information

Everything you need to connect to Vordium Chain.

ParameterValue
Network NameVordium Chain
Chain ID713714
TokenVORD
Decimals18
RPC URLhttps://rpc.vordium.com
WebSocketwss://ws.vordium.com
Explorerhttps://vordscan.io
Faucethttps://faucet.vordium.com
Block Time~400ms
FinalityInstant

Add to Wallet

One click to add Vordium Chain to MetaMask.

Manual setup

Network NameVordium Chain
RPC URLhttps://rpc.vordium.com
Chain ID713714
Currency SymbolVORD
Block Explorerhttps://vordscan.io

RPC Endpoints

Public endpoints for Vordium Chain.

ProtocolEndpoint
HTTPShttps://rpc.vordium.com
WebSocketwss://ws.vordium.com
REST APIhttps://api.vordium.com

All endpoints are CORS-enabled and accept standard Ethereum JSON-RPC methods.

Block Explorer

VordScan — view every transaction on Vordium.

VordScan is a fully-featured block explorer for Vordium Chain. Search by address, transaction hash, block number, or token.

Open VordScan →

VRC-20 Tokens

Vordium's fungible token standard.

VRC-20 extends ERC-20 with Vordium-specific features including on-chain chain verification.

Reference Contract
0xF924975Cc9d401cd5a6bD1171DEDaEc0bD301B20

New functions

solidity
chainId()        // returns 713714
tokenStandard()  // returns "VRC-20"
nativeChain()    // returns "Vordium"

Deploy a VRC-20

bash
pip install vordium
vordium init

Deploy with Foundry

bash
forge create VRC20.sol:VRC20 \
  --rpc-url https://rpc.vordium.com \
  --private-key $PRIVATE_KEY \
  --constructor-args "MyToken" "MTK" 18 1000000

VRC-721 NFTs

Non-fungible tokens on Vordium.

Reference Contract
0xD75c82c33c8642150d0485fCE330fD9FE44b9dC0
solidity
tokenStandard()  // returns "VRC-721"
chainId()        // returns 713714

VRC-1155 Multi-Token

Multi-token standard for fungible + non-fungible assets in one contract.

Reference Contract
0x90811A8D1e19BE8030D18B9C61b566A676d82f1A
solidity
tokenStandard()  // returns "VRC-1155"
chainId()        // returns 713714

Deploy a Contract

Full guide to deploying Solidity contracts on Vordium.

Step 1 — Install Foundry

bash
curl -L https://foundry.paradigm.xyz | bash
source ~/.bashrc
foundryup

Step 2 — Create a VRC-20

solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.19;

import "@vordium/contracts/VRC20.sol";

contract MyToken is VRC20 {
    constructor() VRC20(
        "My Token",
        "MTK",
        18,
        1000000 * 10**18
    ) {}
}

Step 3 — Deploy

bash
forge create MyToken.sol:MyToken \
  --rpc-url https://rpc.vordium.com \
  --private-key $PRIVATE_KEY

Step 4 — Verify on VordScan

  1. Open vordscan.io
  2. Search your contract address
  3. Submit source for verification

Verify Contract

Publish source code on VordScan.

Open your contract page on vordscan.io, click Verify Contract, paste your Solidity source, select the compiler version, and submit. Verified contracts display source, ABI, and a read/write UI.

RPC API Reference

Standard Ethereum JSON-RPC over HTTPS.

Endpointhttps://rpc.vordium.com
MethodPOST
Content-Typeapplication/json

Get block number

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

Response:

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

Get balance

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

Get chain ID

bash
curl -X POST https://rpc.vordium.com \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_chainId",
    "params": [],
    "id": 1
  }'

Response: {"result": "0xae3f2"}

Supported methods

text
eth_chainId
eth_blockNumber
eth_getBalance
eth_sendRawTransaction
eth_getTransactionByHash
eth_getTransactionReceipt
eth_call
eth_estimateGas
eth_gasPrice
net_version
web3_clientVersion

WebSocket Guide

Subscribe to real-time chain events.

javascript
const ws = new WebSocket("wss://ws.vordium.com");

ws.onopen = () => {
  ws.send(JSON.stringify({
    jsonrpc: "2.0",
    id: 1,
    method: "eth_subscribe",
    params: ["newHeads"]
  }));
};

ws.onmessage = (e) => {
  const data = JSON.parse(e.data);
  console.log("New block:", data);
};