# Developer Guide: RPC API Overview

Your App  ──HTTP POST──▶  verusd (localhost:27486)  ──▶  Blockchain
              │
         JSON-RPC body
         + Basic Auth

# Mainnet
cat ~/.komodo/VRSC/VRSC.conf

# Testnet
cat ~/.komodo/vrsctest/vrsctest.conf

rpcuser=your_username
rpcpassword=your_password
rpcport=27486           # mainnet default
rpcallowip=127.0.0.1   # localhost only (secure default)
server=1                # required for RPC

# In VRSC.conf
rpcallowip=192.168.1.0/24    # Allow local network
rpcbind=0.0.0.0               # Bind to all interfaces

{
  "jsonrpc": "1.0",
  "id": "my-request",
  "method": "getinfo",
  "params": []
}

{
  "result": { ... },
  "error": null,
  "id": "my-request"
}

{
  "result": null,
  "error": {
    "code": -5,
    "message": "Invalid address"
  },
  "id": "my-request"
}

curl -s -u rpcuser:rpcpassword \
  http://127.0.0.1:27486 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"1.0","id":"curl","method":"getinfo","params":[]}'

curl -s -u rpcuser:rpcpassword \
  http://127.0.0.1:27486 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"1.0","id":"curl","method":"getidentity","params":["alice@"]}'

curl -s -u rpcuser:rpcpassword \
  http://127.0.0.1:27486 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"1.0",
    "id":"curl",
    "method":"sendcurrency",
    "params":["myid@", [{"address":"recipient@","currency":"VRSC","amount":1.0}]]
  }'

curl -s -u rpcuser:rpcpassword \
  http://127.0.0.1:27486 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"1.0","id":"curl","method":"getinfo","params":[]}' \
  | jq '.result.blocks'

import requests
import json

RPC_URL = "http://127.0.0.1:27486"
RPC_USER = "your_rpcuser"
RPC_PASS = "your_rpcpassword"

def rpc(method, params=None):
    """Make a Verus RPC call."""
    payload = {
        "jsonrpc": "1.0",
        "id": "python",
        "method": method,
        "params": params or []
    }
    resp = requests.post(
        RPC_URL,
        auth=(RPC_USER, RPC_PASS),
        json=payload,
        timeout=30
    )
    resp.raise_for_status()
    data = resp.json()
    if data.get("error"):
        raise Exception(f"RPC error: {data['error']}")
    return data["result"]

# Examples
info = rpc("getinfo")
print(f"Block height: {info['blocks']}")

identity = rpc("getidentity", ["alice@"])
print(f"Identity address: {identity['identity']['identityaddress']}")

balance = rpc("getbalance")
print(f"Balance: {balance} VRSC")

import os

def load_credentials(testnet=False):
    if testnet:
        conf_path = os.path.expanduser("~/.komodo/vrsctest/vrsctest.conf")
        default_port = 18843
    else:
        conf_path = os.path.expanduser("~/.komodo/VRSC/VRSC.conf")
        default_port = 27486

    config = {}
    with open(conf_path) as f:
        for line in f:
            if "=" in line:
                key, val = line.strip().split("=", 1)
                config[key] = val

    return {
        "url": f"http://127.0.0.1:{config.get('rpcport', default_port)}",
        "user": config["rpcuser"],
        "password": config["rpcpassword"]
    }

const axios = require('axios');

const RPC_URL = 'http://127.0.0.1:27486';
const RPC_USER = 'your_rpcuser';
const RPC_PASS = 'your_rpcpassword';

async function rpc(method, params = []) {
  const { data } = await axios.post(RPC_URL, {
    jsonrpc: '1.0',
    id: 'node',
    method,
    params
  }, {
    auth: { username: RPC_USER, password: RPC_PASS },
    timeout: 30000
  });

  if (data.error) {
    throw new Error(`RPC error: ${JSON.stringify(data.error)}`);
  }
  return data.result;
}

// Examples
(async () => {
  const info = await rpc('getinfo');
  console.log(`Block height: ${info.blocks}`);

  const identity = await rpc('getidentity', ['alice@']);
  console.log(`Address: ${identity.identity.identityaddress}`);
})();

import requests

def rpc_safe(method, params=None):
    try:
        return rpc(method, params)
    except requests.ConnectionError:
        print("ERROR: Daemon not running or wrong port")
        return None
    except requests.Timeout:
        print("ERROR: Request timed out (daemon busy?)")
        return None
    except Exception as e:
        if "Insufficient funds" in str(e):
            print("ERROR: Not enough VRSC")
        elif "-28" in str(e):
            print("ERROR: Daemon still syncing, try later")
        else:
            print(f"ERROR: {e}")
        return None

curl -s -u rpcuser:rpcpassword \
  http://127.0.0.1:27486 \
  -H "Content-Type: application/json" \
  -d '[
    {"jsonrpc":"1.0","id":"1","method":"getinfo","params":[]},
    {"jsonrpc":"1.0","id":"2","method":"getbalance","params":[]},
    {"jsonrpc":"1.0","id":"3","method":"getmininginfo","params":[]}
  ]'