Skip to content

sovrnlabs/sovrn

Repository files navigation

Sovrn

The self-sovereign wallet for AI agents. Multi-chain (Solana + EVM), x402-native, MIT — local keys, no API key, no custodian, no lock-in.

import { Wallet } from "@sovrn/wallet";

const agent = Wallet.create({
  name: "research-agent.04",
  chains: ["solana", "base"],
  policy: { dailyCapMicros: 500_000_000 }, // $500 / 24h
});

const result = await agent.fetch(
  "https://sovrn.fun/api/x402/demo?resource=arxiv",
);

console.log(await result.response.json());

What this is

A wallet your agent actually owns. The SDK generates ed25519 (Solana) and secp256k1 (EVM) keys locally and signs every transaction in-process. Sovrn Labs never sees your keys.

What this isn't

A custodial backend, a wrapper around someone else's API, or a re-skin of MetaMask.

Why it exists

Autonomous agents execute 24/7 — until they touch money. Existing "agent wallet" SDKs are database accounts with an apiKey. Sovrn ships actual keys.

Repo layout

sovrn/
├── src/                 # Next.js 16 app — landing, docs, playground, /api/x402/demo
├── packages/
│   └── wallet/          # @sovrn/wallet — the SDK
└── ...

What works today

  • ✅ ed25519 keygen + signing (Solana-compatible base58 addresses)
  • ✅ secp256k1 keygen + EIP-191 signing (EVM checksummed addresses)
  • ✅ x402 auto-pay (HTTP 402 → sign → retry → 200) — end-to-end verified
  • ✅ Programmable policies (daily cap, per-call cap, allow/denylist, pause)
  • ✅ Append-only signed ledger with chained signatures
  • ✅ Public x402 demo endpoint at /api/x402/demo
  • ✅ MIT, two trusted runtime deps (@noble/curves + @noble/hashes)

What's coming

  • ZK-shielded transfers (Aztec / Nocturne adapters)
  • On-chain settlement plug-ins (real USDC moves)
  • Service registry on-chain (sovrn/mesh)
  • Virtual VISA bridge (sovrn/pay)

Develop

npm install
npm run build:sdk   # build the SDK once
npm run dev         # Next.js on :3000

License

MIT.

About

The self-sovereign wallet for AI agents — multi-chain, x402-native, MIT

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors