Docs

Viction - EVM-Compatible Blockchain Documentation

Complete guide to Viction blockchain integration with Dwellir RPC. Learn how to build on Viction, access JSON-RPC methods, and optimize your dApp performance.

Viction RPC

With Dwellir, you get access to our global Viction network which always routes your API requests to the nearest available location, ensuring low latency and the fastest speeds.

Get your API key

Why Build on Viction?

Viction is a people-centric blockchain designed to make Web3 accessible and secure for all users. Built with an innovative Proof-of-Stake Voting (PoSV) consensus mechanism, Viction offers:

Lightning Fast Performance

  • 2-second block times - Get near-instant transaction confirmations
  • 2000+ TPS capacity - Handle high-volume applications efficiently
  • Zero gas fees - Remove cost barriers for frequent transactions

Enterprise Security

  • 150 Masternode network - Decentralized validation with PoSV consensus
  • Double validation - Enhanced security through dual-node verification
  • Battle-tested - In production since 2018 with proven reliability

Developer-Friendly Ecosystem

  • Full EVM compatibility - Deploy Ethereum smart contracts seamlessly
  • World Wide Chain - Innovative app chain framework for scalability
  • Rich tooling support - Works with Hardhat, Foundry, Remix, and more

Quick Start with Viction

Connect to Viction in seconds with Dwellir's optimized endpoints:

Viction RPC Endpoints
HTTPS
curl -sS -X POST https://api-viction-mainnet.n.dwellir.com/<API_Keys_Are_Not_Made_for_Bots> \  -H 'Content-Type: application/json' \  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'
import { JsonRpcProvider } from 'ethers';const provider = new JsonRpcProvider(  'https://api-viction-mainnet.n.dwellir.com/<API_Keys_Are_Not_Made_for_Bots>');const latest = await provider.getBlockNumber();console.log('block', latest);
import requestsurl = 'https://api-viction-mainnet.n.dwellir.com/<API_Keys_Are_Not_Made_for_Bots>'payload = {  'jsonrpc': '2.0', 'id': 1,  'method': 'eth_blockNumber', 'params': []}resp = requests.post(url, json=payload)print(resp.json())
package mainimport (  "bytes"  "fmt"  "io"  "net/http")func main() {  url := "https://api-viction-mainnet.n.dwellir.com/<API_Keys_Are_Not_Made_for_Bots>"  payload := []byte(`{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}`)  resp, err := http.Post(url, "application/json",    bytes.NewBuffer(payload))  if err != nil { panic(err) }  defer resp.Body.Close()  body, _ := io.ReadAll(resp.Body)  fmt.Println(string(body))}

Installation & Setup

Network Information

ParameterValueDetails
Chain ID88Mainnet
Block Time2 secondsAverage
Gas TokenVICNative token
RPC StandardEthereumJSON-RPC 2.0

API Reference

Viction supports the full Ethereum JSON-RPC API specification with zero gas fees for most transactions.

Common Integration Patterns

Transaction Monitoring

Monitor pending and confirmed transactions efficiently:

JavaScript
// Watch for transaction confirmation
async function waitForTransaction(txHash) {
  const receipt = await provider.waitForTransaction(txHash, 1);

  // Viction transactions typically confirm in 2-4 seconds
  console.log('Transaction confirmed in block:', receipt.blockNumber);

  return receipt;
}

Zero Gas Optimization

Take advantage of Viction's zero gas fee structure:

JavaScript
// Most transactions on Viction have zero gas cost
const gasPrice = await provider.getGasPrice();
console.log('Gas price:', gasPrice.toString()); // Often "0"

// Still estimate gas for contract interactions
const gasLimit = await provider.estimateGas(tx);

const transaction = {
  to: recipient,
  value: amount,
  gasPrice: gasPrice,
  gasLimit: gasLimit
};

Event Filtering

Efficiently query contract events with fast block times:

JavaScript
// Query events with Viction's fast block confirmation
async function getEvents(contract, eventName, fromBlock = 0) {
  const filter = contract.filters[eventName]();
  const events = [];
  const batchSize = 1000; // Viction recommended batch size

  for (let i = fromBlock; i <= currentBlock; i += batchSize) {
    const batch = await contract.queryFilter(
      filter,
      i,
      Math.min(i + batchSize - 1, currentBlock)
    );
    events.push(...batch);
  }

  return events;
}

Performance Best Practices

1. Batch Requests

Combine multiple RPC calls for optimal performance:

JavaScript
const batch = [
  { method: 'eth_blockNumber', params: [] },
  { method: 'eth_gasPrice', params: [] },
  { method: 'eth_getBalance', params: [address, 'latest'] }
];

const results = await provider.send(batch);

2. Connection Pooling

Reuse provider instances to minimize connection overhead:

JavaScript
// Singleton pattern for provider
class VictionProvider {
  static instance = null;

  static getInstance() {
    if (!this.instance) {
      this.instance = new JsonRpcProvider(
        'https://api-viction-mainnet.n.dwellir.com/YOUR_API_KEY'
      );
    }
    return this.instance;
  }
}

3. Smart Caching

Cache immutable data to reduce API calls:

JavaScript
const cache = new Map();

async function getCachedBlockData(blockNumber) {
  const key = `block_${blockNumber}`;

  if (!cache.has(key)) {
    const block = await provider.getBlock(blockNumber);
    cache.set(key, block);
  }

  return cache.get(key);
}

Troubleshooting Common Issues

Error: "Insufficient funds for transaction"

Ensure you have enough VIC for transaction execution:

JavaScript
// Check VIC balance
const balance = await provider.getBalance(address);
const gasLimit = await provider.estimateGas(tx);
const totalRequired = gasLimit + tx.value;

if (balance < totalRequired) {
  throw new Error(`Need ${totalRequired - balance} more VIC`);
}

Error: "Transaction underpriced"

While Viction often has zero gas fees, some operations may require minimal gas:

JavaScript
// Get current fee data
const feeData = await provider.getFeeData();

const tx = {
  to: recipient,
  value: amount,
  gasPrice: feeData.gasPrice || 0,
  gasLimit: 21000n
};

Error: "Rate limit exceeded"

Implement exponential backoff for resilient applications:

JavaScript
async function callWithRetry(fn, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      if (error.code === 429 && i < maxRetries - 1) {
        await new Promise(r => setTimeout(r, 2 ** i * 1000));
      } else {
        throw error;
      }
    }
  }
}

Migration Guide

From Ethereum Mainnet

Moving from Ethereum to Viction requires minimal changes:

JavaScript
// Before (Ethereum)
const provider = new JsonRpcProvider('https://eth-rpc.example.com');

// After (Viction)
const provider = new JsonRpcProvider(
  'https://api-viction-mainnet.n.dwellir.com/YOUR_API_KEY'
);

// Smart contracts work identically
// Same tooling and libraries
// Note: Different chain ID (88)
// Note: Separate block numbers
// Note: Zero gas fees for most transactions

Resources & Tools

Official Resources

Developer Tools

Need Help?


Start building on Viction with Dwellir's enterprise-grade RPC infrastructure. Get your API key