Rivellum Developer Reference

This page is the capability index for production builders.

Interface Surface Map

Surface	Purpose	Write	Read	Stream
Mist CLI (`mistc`)	compile/check/deploy/call/replay workflows	Yes	Yes	No
Public RPC (`/v1/*`)	network API for submits, queries, diagnostics	Yes	Yes	Yes (`/events/stream`)
TypeScript AI SDK (`@rivellum/ai-sdk`)	AI-economy client (`RivellumAgent`)	Yes	Yes	No

Capability Matrix

Capability	Primary Interface	Canonical Paths / Methods
Intent Submission	RPC	`POST /v1/submit`, `POST /v1/submit_envelope`
Mist Contracts	Mist CLI + RPC	`mistc deploy/call/receipt/replay`, `/v1/mist/*`
Deterministic Replay	Mist CLI + RPC	`mistc replay`, `GET /v1/mist/replay_inputs/:id`
Events & Indexing	RPC	`GET /v1/events/recent`, `GET /v1/events/query`, `/events/stream`
Fee Estimation	RPC + Mist CLI	`GET /v1/fee/quote`, `mistc fees`
Governance Reads	RPC	`GET /governance/params`, `GET /governance/history`
Bridge Reads/Verify	RPC	`GET /v1/bridge/status`, `GET /v1/bridge/chains`, `POST /v1/bridge/verify`, `GET /v1/bridge/messages`
AI Economy	TypeScript SDK (`RivellumAgent`)	`pay`, `purchase`, `escrow`, `intent`, `market`, `agent`

High-Signal Code Blips

1. Submit an intent

curl -X POST https://rpc.rivellum.network/v1/submit \
  -H "Content-Type: application/json" \
  -d '{
    "sender": "0xSENDER...",
    "nonce": 1,
    "max_fee": 1000000,
    "payload": {
      "type": "Transfer",
      "to": "0xRECIPIENT...",
      "amount": "1000000000"
    },
    "signature": "0x..."
  }'

2. Deploy a Mist bundle

mistc check contracts/counter.mist
mistc lint contracts/counter.mist
mistc deploy build/counter.bundle.json --rpc https://rpc.rivellum.network

3. Call deployed contract

mistc call CONTRACT_ID increment '{"delta":1}' --rpc https://rpc.rivellum.network

4. Fetch receipt + deterministic replay input

curl https://rpc.rivellum.network/v1/mist/receipts/RECEIPT_ID
curl https://rpc.rivellum.network/v1/mist/replay_inputs/RECEIPT_ID

5. Query events (indexer backend path)

curl "https://rpc.rivellum.network/v1/events/query?topic=native.transfer&from_batch=100&limit=100"

6. Stream events

const ws = new WebSocket('wss://rpc.rivellum.network/events/stream?topic=native.transfer');
ws.onmessage = (msg) => {
  const event = JSON.parse(msg.data);
  console.log(event.topic, event.data);
};

7. SDK AI-economy operation

import { RivellumAgent } from '@rivellum/ai-sdk';

const agent = new RivellumAgent({ nodeUrl: 'https://rpc.rivellum.network' });
const result = await agent.pay({ to: '0xabc...', amount: 250000 });
console.log(result);

Contract + Frontend Integration Pattern

Emit typed events from Mist state transitions.
Consume events/query and /events/stream in indexer/frontend.
Treat receipts + replay inputs as first-class incident artifacts.
Keep fee envelope checks in write paths.

Reference Navigation

Contract execution lifecycle: /docs/dev/contract-lifecycle
Replay and failure analysis: /docs/dev/debugging-replay
Mist toolchain reference: /docs/dev/mist-toolchain
SDK reference: /docs/dev/sdk-guide
API explorer: /api-explorer