Skip to main content
Glama

Nuluvium

CI

The privacy layer for onchain stocks on Robinhood Chain.

Nuluvium routes stock token orders for people and AI agents through fresh addresses, paid from a shielded USDG balance, so trades do not trace back to the wallet or the strategy behind them.

Testnet only, not audited. Everything here runs on Robinhood Chain testnet with test tokens. Do not use it with real funds.

How it works

  1. Shield. USDG is deposited into a shielded pool, a fork of Privacy Pools v1.3.0 whose contracts and circuits are used unchanged.

  2. Screen. An approved-set provider checks every deposit (sanctions list, the stock token issuer's blocklist, a denylist, deposit caps) and posts the root of the approved set on chain.

  3. Prove. For each piece of an order, the client makes a zero-knowledge proof that it owns an approved deposit, without saying which one.

  4. Route. A relayer sends the proof to the Nuluvium Router, which releases the piece's USDG, swaps it on a public Uniswap v3 pool and sends the stock tokens to a fresh address.

An order is split into pieces of random size at random times within a window. Readers of the chain see the pieces, not that they belong together or to whom.

What Nuluvium does not do: it never matches orders, no contract of it holds stock tokens, and it is private from other readers of the chain, not from Robinhood, which runs the chain and issues the stock tokens. Keys, notes and order schedules stay on the user's device or the agent's machine; no server stores the link between a user and their fresh addresses.

Related MCP server: hoodr MCP Server

Repository

Folder

What it is

contracts/

Foundry project: NuluviumRouter, test USDG, deploy scripts and tests. Privacy Pools and forge-std are git submodules in contracts/lib/.

asp/

Approved-set provider, a Cloudflare Worker (cron screening, approved set, root posting).

relayer/

Relayer, a Cloudflare Worker with a Durable Object queue (GET /quote, POST /piece, POST /sell).

stats/

Public stats, a Cloudflare Worker: every 10 minutes it counts pool and Router events, the approved set and the relayer into totals (GET /stats), shown on /stats.

faucet/

Testnet faucet, a Cloudflare Worker at faucet.nuluvium.com: a little test ETH (only for a wallet with almost none) and 100 test USDG, once a day per wallet.

sdk/

@nuluvium/sdk in TypeScript: keys, notes rebuilt from the chain, proofs, planning, routing, ragequit and sells.

mcp/

MCP server for AI agents (stdio), runs on the agent's machine.

web/

Site, docs and web app: Next.js on Cloudflare Workers (OpenNext).

testnet/

Scripts that drove the testnet runs, with their records in testnet/runs/.

docs/

Technical notes: router.md, sdk.md, mcp.md, testnet.md (addresses, runs, findings).

Getting started

Requirements: Node.js 22.18 or newer (the SDK and MCP server run TypeScript directly), and Foundry for the contracts.

git clone --recurse-submodules https://github.com/nuluviumhq/nuluvium.git
cd nuluvium

Everything at once (lint, every typecheck and test suite; CI runs the same):

npm ci && for p in contracts sdk mcp relayer asp stats faucet web; do (cd $p && npm ci); done
npm run check

Contracts:

cd contracts && npm install && forge test
FORK_TESTS=true forge test   # also the tests that fork Robinhood Chain (needs network access)

SDK and MCP server:

cd sdk && npm install && npm test
cd ../mcp && npm install && npm test

Circuit files for proofs (copied from the Privacy Pools submodule, once):

cd testnet && npm install && node setup-artifacts.mjs

Web app (http://localhost:3000 by default):

cd web && npm install && npm run dev

Use it from an AI agent

The MCP server is on npm as @nuluvium/mcp. Once: npx -y @nuluvium/mcp --prepare (installs it and downloads the circuit files), then add "command": "npx", "args": ["-y", "@nuluvium/mcp"] to your MCP client (setup in mcp/README.md). Give the agent its own testnet mnemonic in its environment, never in a file:

export NULUVIUM_MNEMONIC="twelve words of a new testnet mnemonic"
export NULUVIUM_RPC_URL="https://your-testnet-rpc"   # optional, if your network blocks robinhood.com

From a clone of this repository, the root .mcp.json runs the server from source instead. The server offers get_balance, deposit, route_order, cancel_order, get_orders and get_fills. Details: docs/mcp.md.

Status

Testnet build complete: shielded pool, approved-set provider, Router, relayer, SDK, MCP server and web app, each checked end to end on Robinhood Chain testnet (docs/testnet.md). Before mainnet: an independent audit, a legal opinion, real stock tokens priced from Uniswap quotes, and the Router owned by a multisig. Deposits are capped until the audit is published.

Security

Not audited. Do not use with real funds.

Found a vulnerability? Please report it privately through Report a vulnerability (GitHub Security tab), not in a public issue.

License

Apache-2.0. The Privacy Pools contracts and circuits in contracts/lib/privacy-pools-core are by 0xbow under Apache-2.0 and are used unchanged.

Available Tools

6 tools
cancel_orderCancel an orderA

Cancels the pieces of an order that have not been sent yet. A piece already being sent may still complete.

Inputs: orderId (required).

depositDeposit USDG into the shielded balanceA

Moves USDG from the agent's deposit wallet (see get_balance) into its shielded balance as a new note. The deposit itself is public: anyone can see this wallet deposited this amount; what the note pays for later is not linked to it. Sends two transactions (approve, deposit) and waits for them. The new note can pay for orders once the clean-funds check approves it, usually within a minute. Up to 1,000 USDG per deposit until the audit.

Inputs: usdgAmount (required).

get_balanceShielded balanceA

Shows the agent's shielded USDG balance on Nuluvium, per note, and the deposit wallet that funds new deposits. One order is paid from one note, so the largest note is the largest order you can route right now.

Inputs: no named parameters.

get_fillsExecuted piecesB

Shows executed pieces: USDG spent, tokens received, the fresh address holding them, and the transaction link.

Inputs: orderId.

get_ordersList ordersB

Lists this agent's orders with the status of every piece (scheduled, sending, done, failed, cancelled).

Inputs: onlyOpen.

route_orderRoute a private buy orderA

Buys a stock token with shielded USDG, split into pieces of random size sent at random times inside the window. Each piece goes to its own fresh address, so the trades do not trace back to the agent's wallet. Returns at once; pieces are sent in the background (check with get_orders / get_fills). Privacy is from other readers of the chain, not from Robinhood.

Inputs: token (required), usdgAmount (required), pieces, windowMinutes, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool maps to a clearly distinct action in the private order flow: balance inspection, funding, order routing, cancellation, order status, and fill history. The potential overlap between get_orders and get_fills is well resolved by their descriptions, with one covering all piece statuses and the other covering only executed pieces.

    Naming Consistency4/5

    Most tools follow a clear verb_noun snake_case pattern: get_balance, route_order, cancel_order, get_orders, get_fills. The only minor deviation is deposit, which uses a bare verb, but it remains readable and unambiguous.

    Tool Count5/5

    Six tools is well-scoped for a focused private stock-order workflow. Each tool earns its place by covering a necessary step: funding, routing, cancelling, and inspecting orders and fills.

    Completeness3/5

    The order lifecycle from deposit through routing, cancellation, and fill inspection is covered, but there is no withdrawal tool to move shielded USDG back out or manage received stock tokens. These are notable gaps for a balance-bearing financial workflow, though the core buying flow is coherent.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to interact with Robinhood Chain via USDG payments, offering tools for balance, pricing, trading, and more.
      18
      48
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to trade tokenized stocks (e.g., NVDA, TSLA) on Robinhood Chain via MCP, with non-custodial keys and spending caps.
      21 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to discover tokenized Stock Tokens, read reference prices and wallet balances on Robinhood Chain, create quotes, simulate transactions, and build policy-checked trade plans that return an explainable verdict plus unsigned transactions for a wallet to sign.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables an agent to quote swaps and get unsigned transaction calldata for trading on Robinhood Chain, with best-price routing checked against a spending policy (caps, allowlists, slippage, price impact, pinned contracts, simulation) before anything is returned. Also provides simulation, hook-pool and hook-risk inspection, token price lookups, verified stock-token listing, and rolling spend status, while never holding keys, signing, or sending.
      MIT