SDK Reference

Choose the SDK for your language and platform. All SDKs connect to the same Rivellum RPC surface.

SDK Inventory

SDK	Language	Package	Use Case
Core TypeScript SDK	TypeScript / Node.js	`@rivellum/sdk`	Chain/RPC integration, web apps, backend services
AI TypeScript SDK	TypeScript / Node.js	`@rivellum/ai-sdk`	AI-economy flows: pay, escrow, market, streams
Go SDK	Go	`github.com/rivellumlabs/rivellum-go-sdk`	Infrastructure, services, backend tooling
Rust SDK	Rust	`rivellum-sdk`	High-performance services, PoUW integrations
Python SDK	Python	`rivellum-ai`	AI agents, LangChain/CrewAI, scripting
Unity SDK	C# / Unity	Source import or DLL	Unity 6.x+ games and mobile
Godot SDK	GDScript / C#	Addon	Godot 4.x games

Core TypeScript SDK {#core-typescript}

@rivellum/sdk — the primary SDK for chain/RPC interaction.

npm install @rivellum/sdk

import { RivellumClient } from '@rivellum/sdk';

const client = new RivellumClient({ nodeUrl: 'https://rpc.rivellum.network' });

const balance = await client.getBalance('0xabc...');
const tip = await client.getLedgerTip();
const result = await client.sendIntent(myIntent);

→ Full Core TS SDK Reference

AI TypeScript SDK {#ai-typescript}

@rivellum/ai-sdk — for AI-economy application flows.

npm install @rivellum/ai-sdk

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

const agent = new RivellumAgent({ nodeUrl: 'https://rpc.rivellum.network' });

await agent.pay({ to: '0xprovider...', amount: 500_000, assetId: '0x...' });
const offers = await agent.searchMarket({ category: 'models', limit: 20 });

→ Full AI SDK Reference

Go SDK {#go}

go get github.com/rivellumlabs/rivellum-go-sdk

import rivellum "github.com/rivellumlabs/rivellum-go-sdk"

client := rivellum.NewClient("https://rpc.rivellum.network")
bal, _ := client.GetBalance("0xabc...")
tip, _ := client.GetLedgerTip()

→ Full Go SDK Reference

Rust SDK {#rust}

[dependencies]
rivellum-sdk = "0.1"

use rivellum_sdk::RivellumClient;

let client = RivellumClient::new("https://rpc.rivellum.network");
let bal = client.get_balance("0xabc...").await?;
let tip = client.get_ledger_tip().await?;

→ Full Rust SDK Reference

Python SDK {#python}

pip install rivellum-ai

from rivellum_ai import RivellumAgent, RivellumClient

# AI-economy flows
agent = RivellumAgent(node_url="https://rpc.rivellum.network")
await agent.pay(to="0xprovider...", amount=500_000)

# Chain RPC
client = RivellumClient(node_url="https://rpc.rivellum.network")
balance = await client.get_balance("0xabc...")

→ Full Python SDK Reference

Unity SDK {#unity}

Copy sdk/unity/src/ into your Unity project's Assets/ directory, or build the DLL from sdk/unity/Rivellum.Unity.csproj.

using Rivellum.Unity;

var client = new RivellumClient("https://rpc.rivellum.network");
var balance = await client.GetBalanceAsync("0xabc...");
await client.SendIntentAsync(myIntent);

→ Unity Integration Guide

Godot SDK {#godot}

Copy sdk/godot/addons/rivellum/ to your project's addons/ directory and enable the plugin.

var config = RivellumClientConfig.new("https://rpc.rivellum.network")
RivellumClient.configure(config)

var balance = await RivellumClient.get_balance("0xabc...")

→ Godot Integration Guide

Which SDK Should I Use?

Web frontend or Node.js backend: use @rivellum/sdk
AI agent payment / escrow / market flows: use @rivellum/ai-sdk (TS) or rivellum-ai (Python)
Go microservice: use the Go SDK
Rust infrastructure / PoUW: use the Rust SDK
Unity game: use the Unity SDK
Godot game: use the Godot SDK

Both TypeScript SDKs are complementary — @rivellum/sdk handles chain RPC, @rivellum/ai-sdk handles the AI economy layer.

Adjacent References

/docs/dev/sdk-surface — full SDK surface map
/api-explorer — interactive endpoint testing
/docs/dev/getting-started — developer quickstart