Proxima 🧠⚡

Open-source AI Agent Registry & Autonomous Payment Gateway on Stellar.

Live Link: https://nullius-taupe.vercel.app/

Contract Address-

Registry: CDTHE5SNO7UTBTSSVWAYN5TXYNJXZYOUTRMETMHVB4IHGTNRJ6PKE54R

Policy: CA4ZN5RGGKBXWYAB36HXTLBB73ROHQKH527GX4GONRWRNVNWFLIHAKKDJ

The Problem

The AI agent economy is arriving — and Stellar is the natural home for it. With sub-5-second finality, near-zero fees, and USDC as a native first-class asset, Stellar is technically perfect for autonomous agent-to-agent payments.

But two critical pieces of infrastructure are missing:

There is no open, on-chain registry where AI agents can be discovered, verified, and evaluated on Stellar. Every platform that hosts agents is a walled garden. There is no portable, trustless reputation.
There is no programmable spending-policy layer that allows agents to pay other agents autonomously within defined budgets — without requiring a human to sign every transaction. This is the #1 unsolved problem blocking real-world agentic commerce on x402 and every similar protocol.

Proxima solves both.

What Proxima Is

Proxima is a 3-layer open-source infrastructure project built natively on Stellar:

┌─────────────────────────────────────────────────────────┐
│                   Proxima STACK                      │
├─────────────────────────────────────────────────────────┤
│  Layer 3: Dashboard UI       React explorer & mgmt app  │
│  Layer 2: TypeScript SDK     Drop-in developer toolkit  │
│  Layer 1: Soroban Contracts  On-chain registry + policy │
└─────────────────────────────────────────────────────────┘

Layer 1 — Agent Registry Contract (`/contracts`)

A Soroban smart contract that stores a verifiable, on-chain registry of AI agents:

Agent metadata: name, description, capabilities, pricing, owner wallet
Reputation scores updated after every completed interaction
Query by capability, price range, or reputation threshold
Fully permissionless — any developer can register an agent

Layer 2 — Spending Policy Contract (`/contracts`)

A programmable authorization contract that enables agents to pay autonomously:

Owner defines a spending budget (e.g. 10 USDC/day max)
Agent executes payments within the policy without per-transaction human approval
Policy is enforced on-chain — no trust required
Directly solves the delegation gap blocking x402 autonomous flows

Layer 3 — TypeScript SDK (`/sdk`)

A clean, well-documented SDK developers drop into any JS/TS project:

import { Proxima } from '@Proxima/sdk'

const mind = new Proxima({ network: 'mainnet' })

// Register an agent
await mind.registry.register({ name: 'DataFetcher', capabilities: ['web-search'], pricePerCall: '0.01' })

// Find agents by capability
const agents = await mind.registry.find({ capability: 'image-generation', maxPrice: '0.05' })

// Create a spending policy
const policy = await mind.policy.create({ agent: agentAddress, dailyLimit: '10', asset: 'USDC' })

// Agent pays autonomously
await mind.policy.pay({ policyId, recipient, amount: '0.01', memo: 'API call #4821' })

Layer 4 — Explorer Dashboard (`/dashboard`)

A beautiful React web app for:

Browsing and searching registered agents
Viewing agent reputation and transaction history
Creating and managing spending policies
Real-time activity feed from Stellar network

Why Stellar

Proxima is built exclusively and deeply on Stellar — not shoehorned in:

Stellar Feature	How Proxima Uses It
Soroban smart contracts	Registry + spending policy contracts (Rust/WASM)
USDC as native asset	All agent payments settle in USDC, no bridging
Sub-5s finality	Real-time agent-to-agent micropayments
~0.00001 XLM fees	Sub-cent payments are economically viable
x402 compatibility	Spending policy integrates with x402 payment flows
Stellar RPC	SDK queries on-chain registry state in real time
Horizon API	Dashboard pulls live transaction and account data

Architecture

                     ┌──────────────┐
                     │   AI Agent   │
                     └──────┬───────┘
                            │ calls SDK
                     ┌──────▼───────┐
                     │  Proxima │
                     │     SDK      │
                     └──────┬───────┘
              ┌─────────────┼─────────────┐
              │             │             │
    ┌─────────▼──┐  ┌───────▼────┐  ┌────▼──────────┐
    │  Registry  │  │  Spending  │  │  Stellar RPC  │
    │  Contract  │  │   Policy   │  │  / Horizon    │
    │ (Soroban)  │  │ (Soroban)  │  │     API       │
    └────────────┘  └────────────┘  └───────────────┘
              │             │
              └──────┬──────┘
                     │
              ┌──────▼───────┐
              │   Stellar    │
              │   Network    │
              │  (Mainnet)   │
              └──────────────┘

Project Structure

Proxima/
├── contracts/                    # Soroban smart contracts (Rust)
│   ├── Cargo.toml
│   ├── src/
│   │   ├── registry.rs           # Agent Registry contract
│   │   ├── policy.rs             # Spending Policy contract
│   │   ├── types.rs              # Shared types
│   │   └── lib.rs
│   └── tests/
│       ├── registry_test.rs
│       └── policy_test.rs
│
├── sdk/                          # TypeScript SDK
│   ├── package.json
│   ├── tsconfig.json
│   ├── src/
│   │   ├── index.ts              # Main export
│   │   ├── registry.ts           # Registry client
│   │   ├── policy.ts             # Policy client
│   │   ├── stellar.ts            # Stellar connection helpers
│   │   └── types.ts              # TypeScript types
│   └── examples/
│       ├── register-agent.ts
│       └── autonomous-payment.ts
│
├── dashboard/                    # React explorer app
│   ├── package.json
│   ├── src/
│   │   ├── App.tsx
│   │   ├── components/
│   │   │   ├── AgentCard.tsx
│   │   │   ├── AgentExplorer.tsx
│   │   │   ├── PolicyManager.tsx
│   │   │   ├── ActivityFeed.tsx
│   │   │   └── RegisterAgent.tsx
│   │   ├── hooks/
│   │   │   ├── useRegistry.ts
│   │   │   └── usePolicy.ts
│   │   └── lib/
│   │       └── Proxima.ts
│
├── docs/
│   ├── ARCHITECTURE.md
│   ├── CONTRACT_SPEC.md
│   ├── SDK_GUIDE.md
│   └── DEPLOYMENT.md
│
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.md
│   │   ├── feature_request.md
│   │   └── good-first-issue.md
│   └── workflows/
│       ├── test-contracts.yml
│       └── test-sdk.yml
│
├── CONTRIBUTING.md
├── LICENSE
└── README.md                     ← you are here

Roadmap

Phase 1 — Foundation (Months 1–2)

Project scaffold & architecture
Agent Registry Soroban contract (Rust) + tests
Spending Policy Soroban contract (Rust) + tests
execute_payment contract tests (token transfer path)
Deploy both contracts to Stellar Testnet
TypeScript SDK core (registry + policy clients)
SDK browser-wallet signing (buildRegisterTx, buildCreatePolicyTx, buildRevokePolicyTx, submitSignedTx)
SDK unit tests (39 tests via bun test)

Phase 2 — Explorer (Months 3–4)

React dashboard — Agent Explorer UI (live on-chain data with mock fallback)
React dashboard — Policy Manager UI (create + revoke wired to Freighter)
React dashboard — Register Agent UI (wired to Freighter + SDK, ID availability badge)
Real-time Activity Feed (Stellar event streaming)
Freighter wallet integration
Live on-chain stats bar (agent count + policy count)
SDK usage examples (2 complete examples)

Phase 3 — Integration & Polish (Month 5)

Contributing

Proxima is built for the community, by the community. We have labeled issues for every skill level:

🟢 good-first-issue — great for first-time Stellar contributors
🟡 help-wanted — well-scoped features needing an owner
🔵 soroban — Rust/Soroban contract work
🟣 sdk — TypeScript SDK work
🟠 dashboard — React UI work

See CONTRIBUTING.md for full contributor guide.

Tech Stack

Layer	Technology
Smart Contracts	Rust, Soroban SDK, WebAssembly
SDK	TypeScript, stellar-sdk, Stellar RPC
Dashboard	React, TypeScript, Tailwind CSS
Wallet	Freighter (Stellar wallet)
Network	Stellar Mainnet / Testnet
Payments	USDC (Circle), x402 compatible

License

MIT License — see LICENSE

Links

🌐 Live App: coming soon
📖 Docs: /docs
💬 Discord: coming soon
🐦 Twitter: coming soon

Proxima is a community project. It is not affiliated with or endorsed by the Stellar Development Foundation.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

Proxima 🧠⚡

The Problem

What Proxima Is

Layer 1 — Agent Registry Contract (`/contracts`)

Layer 2 — Spending Policy Contract (`/contracts`)

Layer 3 — TypeScript SDK (`/sdk`)

Layer 4 — Explorer Dashboard (`/dashboard`)

Why Stellar

Architecture

Project Structure

Roadmap

Phase 1 — Foundation (Months 1–2)

Phase 2 — Explorer (Months 3–4)

Phase 3 — Integration & Polish (Month 5)

Contributing

Tech Stack

License

Links

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 87 Commits
.github		.github
.vscode		.vscode
artifacts		artifacts
contracts		contracts
dashboard		dashboard
docs		docs
sdk		sdk
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
CONTRIBUTORS.md		CONTRIBUTORS.md
LICENSE		LICENSE
README.md		README.md
bun.lock		bun.lock
package.json		package.json

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

Proxima 🧠⚡

The Problem

What Proxima Is

Layer 1 — Agent Registry Contract (/contracts)

Layer 2 — Spending Policy Contract (/contracts)

Layer 3 — TypeScript SDK (/sdk)

Layer 4 — Explorer Dashboard (/dashboard)

Why Stellar

Architecture

Project Structure

Roadmap

Phase 1 — Foundation (Months 1–2)

Phase 2 — Explorer (Months 3–4)

Phase 3 — Integration & Polish (Month 5)

Contributing

Tech Stack

License

Links

About

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Layer 1 — Agent Registry Contract (`/contracts`)

Layer 2 — Spending Policy Contract (`/contracts`)

Layer 3 — TypeScript SDK (`/sdk`)

Layer 4 — Explorer Dashboard (`/dashboard`)