Examples

All examples run against a local stack (see Run a node):

export NODE_RPC=http://localhost:9933
export GATEWAY=http://localhost:3000

Responses below were captured from a single-validator test network; your heights, hashes and addresses will differ.

curl

Node health

curl -s "$NODE_RPC/health"

{"status":"ok","height":561,"round":0,"mempool":0,"peers":0,"tps":0,"total_txs":16,
 "validator_count":1,"bft_quorum":1,"bft_ready":false,"finality_ms":12.4}

bft_ready is false below 7 validators. finality_ms is not measured yet; do not rely on it.

Latest block

curl -s "$GATEWAY/api/v1/blocks?limit=1"

{"blocks":[{"height":562,"hash":"0x64555fa2…","parent_hash":"0x29a83fe0…",
  "proposer":"neuro:node-1.node","round":0,"shard":0,"tx_count":0,
  "tx_root":"0x0000…","state_root":"0xae62d247…","timestamp":1791201937625}],
 "total":562,"limit":1,"offset":0,"has_more":true}

Account

curl -s "$GATEWAY/api/v1/accounts/neuro:a231ca549778bdd.human"

{"address":"neuro:a231ca549778bdd.human","type":"human","balance":50000000,"balance_human":"50",
 "nonce":0,"next_nonce":1,"tx_count":1,"shard":0,"is_contract":false,"verified":true,"custom_address":""}

Faucet (test networks)

curl -s -X POST "$NODE_RPC/api/v1/faucet" -H 'Content-Type: application/json' \
  -d '{"address":"neuro:a231ca549778bdd.human","public_key":"<hex>"}'

{"success":true,"status":"pending","address":"neuro:a231ca549778bdd.human",
 "amount":50000000,"amount_human":"50","block":24,"tx_hash":"0xa25f463d…",
 "note":"faucet applied on block commit"}

Gas estimate

curl -s "$NODE_RPC/api/v1/gas/estimate"

{"base_fee":1,"gas_base_transfer":21,"gas_contract_call":50,"estimated_transfer":21,
 "estimated_transfer_human":"0.000021","estimated_contract":50,"estimated_contract_human":"0.00005",
 "nft_transfer_fee":100,"nft_transfer_fee_human":"0.0001","total_burned":0}

Analyze a contract

HEX=$(od -An -tx1 -v my_contract.wasm | tr -d ' \n')
curl -s -X POST "$NODE_RPC/api/v1/contracts/analyze" -H 'Content-Type: application/json' \
  -d "{\"bytecode_hex\":\"$HEX\"}"

{"risk_score":0,"security_score":100,"safe":true,"ml_score":0.439,"model":"heuristic",
 "violations":[],"gas_estimate":34550}

Read a contract without a transaction

curl -s -X POST "$GATEWAY/api/v1/contracts/neuro:6d69004b47.app/call" -H 'Content-Type: application/json' \
  -d '{"function":"balance_of","args":{"address":"neuro:af6673a44550e1d.human"},"dry_run":true}'

{"success":true,"dry_run":true,"contract":"neuro:6d69004b47.app","height":58,"gas_used":16047,
 "return_data":"{\"ok\":true,\"value\":250000000\u0000}","events":[],"error":null}

Other reads

curl -s "$GATEWAY/api/v1/validators"
curl -s "$GATEWAY/api/v1/governance/params"
curl -s "$GATEWAY/api/v1/transactions/<hash>"
curl -s "$GATEWAY/api/v1/cross-shard/queue?limit=20&status=locked"
curl -s "$GATEWAY/api/v1/vault/<vault address>/config"

Write requests need ML-DSA-65 signatures, which curl cannot produce — use JavaScript below or the SDK.

JavaScript: signed transfer

Uses the wallet's crypto WASM (neurochain-web/src/wasm) and the dApp SDK. Tested with Node.js 22.

import fs from 'node:fs'
import * as crypto from './wasm/neuro_wasm_crypto.js'
import { NeuroChain, toRaw } from './sdk/neurochain.js'

crypto.initSync({ module: fs.readFileSync('./wasm/neuro_wasm_crypto_bg.wasm') })

const GATEWAY = 'http://localhost:3000'
const nc = new NeuroChain({ gateway: GATEWAY, crypto })
const wallet = await nc.walletFromMnemonic(process.env.WORDS)   // your 24 words

const to = 'neuro:af6673a44550e1d.human'
const value = Number(toRaw('1.5'))
const nonce = await nc.nextNonce(wallet.address)
const { base_fee } = await nc.gasEstimate()

const res = await fetch(GATEWAY + '/api/v1/transactions', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    from: wallet.address, to, value, nonce,
    gas_price: Math.ceil(base_fee * 1.5),
    ...wallet.sign(to, value, nonce),
  }),
}).then(r => r.json())
console.log(res)

{"tx_hash":"0x3752a548…","status":"pending","estimated_block":26,
 "sender_balance":48500000,"receiver_balance":1500000,
 "sentinel_score":0.6228,"sentinel_category":"elevated",
 "sentinel_warning":"Transaction accepted but flagged as anomalous"}

A moment later GET /api/v1/transactions/0x3752a548… returns "status":"confirmed", "gas":21, "fee":42, "fee_human":"0.000042" (21 gas × gas price 2).

JavaScript: live events

const ws = new WebSocket('ws://localhost:3000/ws')
ws.onopen = () => ws.send(JSON.stringify({ type: 'subscribe_balance', address: 'neuro:a231ca549778bdd.human' }))
ws.onmessage = (e) => {
  const m = JSON.parse(e.data)
  if (m.type === 'new_block') console.log('block', m.data.height)
  if (m.type === 'balance')   console.log('balance', m.balance_human)
}

Python

import requests

NODE = "http://localhost:9933"
GW = "http://localhost:3000"

def balance(address):
    return requests.get(f"{GW}/api/v1/accounts/{address}").json()["balance_human"]

def latest_block():
    return requests.get(f"{GW}/api/v1/blocks", params={"limit": 1}).json()["blocks"][0]

def analyze(path):
    hexcode = open(path, "rb").read().hex()
    return requests.post(f"{NODE}/api/v1/contracts/analyze", json={"bytecode_hex": hexcode}).json()

print(latest_block()["height"], analyze("my_contract.wasm")["security_score"])