Lightyear v1.0 is live

The Operating System
for Autonomous Agents.

Build AI agents that can pay, earn, and transact. Lightyear OS provides
a self-hosted SDK, smart wallets, and x402 micropayments for machine-to-machine economies.

terminal

❯npm install -g @lightyeardeployer/lightyear

❯lightyear deploy agent

Deploying agent...
Provisioning wallet 0x8a...
Agent live and ready.

Features

The only platform where you define the rules on both sides.

Lightyear gives you a unified control plane for how agents earn, spend, and are governed—all under deterministic, self-hosted financial infrastructure.

Self-Custody by Design

Your agents hold funds in CDP Smart Accounts on Base, while private keys remain in your self-hosted environment. No custodial intermediaries. You retain full control of agent capital at all times.

Native On/Off-Ramps

Lightyear supports fiat ↔ USDC settlement on Base, enabling agents to operate across both traditional financial systems and crypto-native rails without the headache of manual reconciliation.

Agent Registry

Discover, filter, and evaluate agents across protocols using reputation and trust signals from ERC-8004.

Spending Controls

Configure daily, monthly, and per-transaction limits enforced at the wallet level — not in application code.

Auto Top-Up

Automatically replenish agent wallets from the main account to the daily spending limit, without manual intervention.

Real-Time Dashboards

Track spend, earnings, net position, top counterparties, and full transaction history across all agents.

Treasurer Guardrails

Observe every transaction.
Enforce absolute control.

Unprecedented real-time visibility and deterministic policy enforcement across your entire fleet of AI agents.

Total Transactions

900

+5% this period

Approved

700

65.2% approval rate

Blocked

200

8.2% block rate

Revenue (Sell)

$107.28

+10% this period

Buy Side

Control what your agents spend

Define budgets, merchant allowlists, and approval thresholds. Every transaction is evaluated before funds move.

Daily Spend Limit

$450active

Vendor Allowlist

19 approvedactive

Single TX Threshold

>$150review

After-hours Spend

blocked

Sell Side

Control who pays and how much

Set pricing, rate limits, and access rules per endpoint. Inbound payments validated before your service responds.

Price Per Inference

$0.08active

Rate Limit

300 req/minactive

Identity Check

enforced

Minimum Balance

$3.00active

Observability — full visibility across every agent and endpoint

Live

Approved

67.2%

Blocked

8.8%

Revenue

+22%

How it works

Just API calls.
No accounts needed.

Your agent discovers APIs, pays for them, and gets data back. No API keys. Just balance.

Install the SDK

Terminal

$ npm install @lightyeardeployer/lightyear

✓ Added to dependencies

Install the Lightyear SDK into your agent's codebase. Native support for standard TypeScript logic, Next.js, Fastify, LangChain, and MCP protocols.

Initialize the Client

agent.ts

import { X402Client } from "@lightyeardeployer/lightyear";

const client = new X402Client({

wallet: agentWallet,

treasurer: lightyearTreasurer

});

Configure the X402 client using your agent's blockchain wallet. The client securely handles signatures without exposing keys.

Agent automatically pays

execution.ts

// Simply use client.fetch and let the SDK handle 402 redirects

const res = await client.fetch("https://api.scraper.com");

const data = await res.json();

✓ Intercepted 402 Payment Required: $0.01 USDC

✓ Payment signed. Sent retry. Success!

{ "status": "ok", "markdown": "# Example..." }

The SDK naturally intercepts HTTP 402 Payment Required errors, signs a micro-transaction, handles limits autonomously, and transparently retries the request. Zero friction.

Support

Frequently Asked Questions

Everything you need to know about the platform. Can't find the answer you're looking for? Feel free to reach out.

What is Lightyear?

Lightyear is a self-hosted Operating System and SDK for autonomous agent payments. It provides your AI agents with the infrastructure to hold funds, spend on services, and earn revenue, while giving you a centralized dashboard and database for real-time observability, automation, and deterministic financial guardrails.

Who is Lightyear for?

Enterprises: Organizations requiring compliance-ready, auditable infrastructure for their AI deployments.
AI Startups: Teams running fleets of agents that need to pay for decentralized services, APIs, or each other.
Developers: Those building with LangChain, MCP (Model Context Protocol), Google ADK, or any major agent framework.
Power Users: Individuals running open-source models to automate workflows.
Marketplace Participants: Agents offering specialized services that need a reliable, programmatic way to receive payments.

What can I actually do in Lightyear?

Equip Agents: Provide agents with a stablecoin smart wallet to pay x402-enabled vendors securely.
Set Financial Limits: Define hard spend limits (daily, monthly, or per-transaction) for every agent.
Govern Interactions: Configure "Seller Allowlists" to restrict which specific addresses and services your agent can transact with.
Automate Treasury: Set auto top-up rules so agents stay funded, and auto-collection rules to sweep agent earnings back to your main vault.
ENS Identities: Autonomously register and manage .base.eth / .basetest.eth Basenames for your agents.

How does the wallet work? Who holds my funds?

Lightyear is completely self-hosted and self-custodial.

Ownership: Funds live on the Base blockchain inside Coinbase Developer Platform (CDP) Smart Contracts or standard EOAs. You own the private keys, which are stored locally in your own database (payments.db). Neither Lightyear nor Coinbase can move your funds without your keys.
Session Keys: Your agent never gets your master key. Instead, it uses a limited-permission "Session Key". The Lightyear Treasurer middleware strictly intercepts all transactions to ensure they respect the budgets and allowlists you configured.

Can my agent get paid too, not just spend?

Yes. Lightyear handles both sides of the machine economy. If your agent performs tasks—such as data processing or research—you can wrap your endpoints using the Facilitator middleware to accept x402 payments. Lightyear tracks these inbound payments with the same level of transparency as outbound spending.

Does Lightyear process payments itself?

No. Lightyear acts as a treasury management and control layer, not a payment processor. It enforces the rules around how your agents interact with decentralized settlement primitives (USDC on Base).

What protocols does Lightyear support?

Lightyear supports MCP (Model Context Protocol), LangChain, Google A2A, and standard HTTP. For payments, it implements x402, a protocol for instant, HTTP-based stablecoin settlement via headers.

What are x402 and A2A?

x402: An open payment protocol extending HTTP 402 "Payment Required". It allows agents to pay for things natively over HTTP using stablecoins, removing the need for human checkout flows or manual API key billing by baking cryptographic payment signatures directly into the request headers.
A2A: Google's Agent-to-Agent framework that allows agents to communicate, share context, and coordinate tasks. Lightyear bridges these two: when agents talk via A2A and need to settle via x402, Lightyear is the control plane that makes the transaction authorized and auditable.

Do I need crypto to use Lightyear?

While the settlement layer runs on blockchain (Base) using stablecoins (USDC), the integration with the Coinbase Developer Platform allows for direct fiat-to-crypto onramps, enabling developers to fund agent wallets using traditional methods without managing complex crypto infrastructure.

Ready to upgrade your agents?

Join the thousands of developers building the autonomous economy.

The Operating Systemfor Autonomous Agents.