Skip to content

Instantly share code, notes, and snippets.

View A-calculus's full-sized avatar
💀
Active

Aderinto Damilola A-calculus

💀
Active
View GitHub Profile

@worldframe/sdk — Agent Layer & Somnia Native Agents Specification

Version: 1.1 — Phase 1 Testnet Edition
Network: Somnia Testnet · Chain ID 50312 · Native Token STT
Status: Single source of truth for the embedded agent layer inside @worldframe/sdk
Phase 1 scope: Testnet only. No mainnet support. Mainnet constants below are reference-only.

Related docs: REVERIE Phase 1.md (deploy, wallets, smoke test) · ProjectIdea.md (product vision)

This is not a standalone @somnia/agentkit npm package. Implementation lives at sdk/src/agentkit/ and is re-exported from sdk/src/index.ts as SomniaAgentKit, calculateDeposit, and related types.

REVERIE Phase 1 — Seven-Agent Architecture

Phase 1 delivers modular Somnia testnet contracts, embedded SomniaAgentKit, seven agents (3 Somnia native + 4 REVERIE), two execution lanes, hybrid Reactivity triggers, and full SDK access to the available methods on each Somnia native agent.

What works now

  • contracts/ deploys the shared infrastructure and lets builders create new testnet worlds.
  • sdk/ contains @worldframe/sdk; it pays STT deposits, submits native-agent requests, waits for callbacks, and returns typed results.
  • All 3 Somnia native agents are usable through the SDK: LLM inference, JSON public API, and LLM website parsing.
  • The native-agent calls support method selection, so builders can ask for text, numbers, booleans, arrays, chat responses, or web-extracted numbers depending on the job.

REVERIE / WorldFrame

REVERIE is an intelligence and infrastructure layer for autonomous on-chain systems on Somnia testnet. It lets builders connect smart contracts to consensus-verified AI, public JSON data, website parsing, and reactive triggers without relying on a centralized server as the source of truth.

The project has two connected deliverables:

  • @worldframe/sdk: the TypeScript infrastructure package for developers. It exposes Somnia native agents, REVERIE world agents, world deployment helpers, triggers, receipts, validation, and typed results.
  • REVERIE: the future no-code builder platform that will sit on top of the SDK and let users create autonomous systems from a browser.

The core idea is simple: instead of running intelligence on private backend servers, REVERIE moves decisions, external data, and world state changes into Somnia's testnet agent and contract flow, where results can be checked through transactions and agent receipts.