Rivellum Portal

Download Wallet (Chrome)

Checking...

testnet

SDK Surface Map

Authoritative map of SDKs currently present in this repository and their intended scope.

SDK Inventory

SDK	Repository Path	Primary Entry Point	Scope
Core TypeScript SDK (`@rivellum/sdk`)	`sdk/ts/`	`RivellumClient`, `LightClientVerifier`	Node RPC, ledger/explorer helpers, light-client mock verification, native-ledger helpers
AI TypeScript SDK (`@rivellum/ai-sdk`)	`sdk/ai/`	`RivellumAgent`	AI-economy flows (`/ai/*`): pay, escrow, market, sessions, streams
Rust SDK (`rivellum-sdk`)	`sdk/rust/`	`RivellumClient`	Async Rust client for node RPC, Mist, envelopes, events, PoUW
Go SDK	`sdk/go/`	`NewClient`	Go client for node RPC, contracts, envelopes, events, NFTs, governance
Python AI SDK (`rivellum-ai`)	`sdk/python/`	`RivellumAgent`, `RivellumClient`	AI-economy client + RPC helper + LangChain/CrewAI integrations
Unity SDK	`sdk/unity/`	`RivellumClient` (C#)	Unity 6.x+ game/mobile integration
Godot SDK	`sdk/godot/`	`RivellumClient` singleton / C# bridge	Godot 4.x game integration

Which SDK For Which Workload

Building backend/service integrations in TypeScript: use @rivellum/sdk.
Building AI-agent payment/escrow/market flows: use @rivellum/ai-sdk.
Building Unity clients: use the Unity SDK (sdk/unity/).
Building Godot clients: use the Godot SDK (sdk/godot/).
Building Rust or Go infrastructure tools: use sdk/rust/ or sdk/go/.
Building Python agent integrations: use rivellum-ai in sdk/python/.

TypeScript Clarification

There are two TypeScript SDK tracks in this repository:

sdk/ts/ (@rivellum/sdk) for general chain/RPC integration.
sdk/ai/ (@rivellum/ai-sdk) for AI-economy application flows.

They are complementary, not duplicates.

Readiness Notes

LightClientVerifier in sdk/ts/ supports mock verification today.
real light-client verification mode is currently stubbed pending WASM verifier integration.
Unity and Godot SDKs are first-class codebases in this repository.

Related References

/docs/dev/sdk-guide
/docs/dev/sdk-workflow-guides
/docs/dev/light-client
/docs/dev/unity-integration
/docs/dev/godot-integration
/docs/dev/mobile-integration