Osmium

Mandate-bound payments for AI finance agents.

Osmium is an onchain SpendOps layer for AI finance agents on Robinhood Chain. Agents can request paid APIs, market data, MCP tools, or tokenized-asset services through x402-compatible flows, but funds only move when Osmium verifies the mandate, policy, receipt, context, budget, and replay rules.

Problem

Autonomous finance agents should not hold unrestricted wallets.

A normal agent wallet creates a dangerous path:

LLM → private key → direct transfer

Osmium replaces that with a controlled settlement path:

Agent intent → SettlementRouter → Stylus PolicyEngine → allow / deny → settlement + receipt

What Osmium proves

Osmium proves whether an AI finance agent was allowed to pay before settlement:

• approved merchant

• allowed token

• max transaction amount

• rolling budget

• mandate and context match

• receipt hash present

• replay protection

• settlement result

If any check fails, no funds move.

Live demo

The demo shows a TSLA market-data agent on Robinhood Chain Testnet.

The agent receives a narrow mandate: buy verified TSLA market data from an approved merchant, within a fixed amount and context.

The valid payment clears and settles onchain. Unsafe attempts are denied before settlement:

• replayed payment

• unknown merchant

• missing receipt

• wrong context

• over-limit payment

The Proofs tab exposes the latest judge matrix with a real onchain settlement transaction, honest pre-settlement denials, raw JSON proofs, and explorer links.

Merchant Kit

Osmium is not only a demo app. The Merchant Kit shows how another paid API, dataset, or MCP server can integrate the same clearance flow.

• no clearance → 402 Payment Required

• valid Osmium receipt → data unlocks

• missing receipt or wrong context → no unlock

The kit is a hackathon reference implementation, not a production npm package yet.

Deployed contracts

Robinhood Chain Testnet:

• PolicyEngine: 0x5e30622c7639aa5edc43313830c9a01341585728

• SettlementRouter: 0x1CD04cbD3348D5fa28B30776902464752e878ac7

• TSLA token used in live proof: 0xC9f9c86933092BbbfFF3CCb4b105A4A94bf3Bd4E

Sponsor technology

• Robinhood Chain Testnet

• Arbitrum Stylus

• x402-compatible payment flow

• Solidity SettlementRouter

• Merchant Kit for external paid APIs

What is onchain

• policy authorization

• settlement routing

• ERC20 vault balance movement

• replay protection

• receipts and intent/context checks

• allow/deny settlement decisions

What is offchain

• AI agent runner

• merchant API

• x402-compatible HTTP challenge flow

• frontend UI

• proof artifact generation

Production readiness

Osmium is a production-oriented testnet deployment on Robinhood Chain Testnet.

The current system includes deployed core contracts, a live agent runner, a public Proofs matrix, a real onchain TSLA settlement transaction, pre-settlement denial proofs, and a standalone Merchant Kit integration test.

The system is designed around explicit trust boundaries:

• the LLM can request and explain actions, but cannot bypass policy checks

• the PolicyEngine decides allow / deny

• the SettlementRouter only moves funds after policy approval

• unsafe attempts are denied before settlement

• external merchants unlock data only after a valid Osmium receipt

Mainnet readiness roadmap:

• independent smart contract audit

• expanded invariant and fuzz testing

• multisig-controlled operational roles

• published SDK package

• self-serve merchant onboarding

• production monitoring and incident response

• expanded policy templates for tokenized-asset services