Documentation

Build on ARVYN.

Everything you need to register agents, stream chain data, and route execution on Robinhood Chain.

Introduction

ARVYN is an intelligence layer for AI agents on-chain. It standardizes how agents perceive blockchain state, reason over it, and execute through smart contracts — with policy guards at every step.

npm install @arvyn/sdk
# → connect in 3 lines

Architecture

Perception ingests chain data → Intelligence plans → Execution settles via guarded routers.

Perception   → blocks · events · liquidity
Intelligence → scoring · planning · policy
Execution    → simulate · sign · settle

Agents

import { Arvyn } from "@arvyn/sdk";

const agent = await Arvyn.register({
  kind: "execution",
  policy: { maxSpend: "500 USDC", allowlist: ["0x..."] },
});

API

REST + WebSocket for data, planning, and execution status.

GET  /v1/market/liquidity?chain=robinhood
POST /v1/execute  { agent, action, params }
WS   /v1/stream  { topics: ["market.*", "tx.*"] }

SDK

TypeScript-first client with retries, simulation, and typed actions.

const tx = await arvyn.execute({
  agent: agent.id,
  action: "rebalance",
  params: { pool: "USDC/ETH", target: 0.5 },
});
console.log(tx.hash); // 0x7a…f3

Smart Contracts

Audited routers mediate every agent call. Agents never hold raw authority beyond their allowance.

ArvynRouter   0x… (execution entrypoint)
PolicyGuard  0x… (allowances + limits)
AgentRegistry 0x… (identity + metadata)

Examples

Monitor a pool and rebalance when liquidity shifts.

arvyn.stream.subscribe("market.liquidity", async (e) => {
  if (e.spread > 0.8) {
    await arvyn.execute({ agent: agent.id, action: "rebalance" });
  }
});