# FluxA

FluxA is a co-wallet system and payment infrastructure for AI agents. It lets agents register an identity, pay for APIs (x402), send USDC payouts, create payment links, and manage spending — all within user-approved scopes on Base (USDC), XRP Ledger, and FluxA Credits.

## Install

```
npx skills add -s fluxa-agent-wallet -y -g FluxA-Agent-Payment/FluxA-AI-Wallet-MCP
```

After installation, **MUST**  run the **Setup** from the fluxa-agent-wallet skill to get started.

## Capabilities

| Capability | What it does | When to use | Guide |
|------------|-------------|-------------|-------|
| **x402 Payment** | Pay for APIs using the x402 protocol with intent mandates | Use when an API request returns HTTP 402 and requires payment | [x402 Docs](https://docs.fluxapay.xyz/x402/) |
| **Payout** | Send USDC to any wallet address on Base | Use when you need to transfer funds to a recipient | [Payout Guide](https://docs.fluxapay.xyz/wallet/agent-guide-payout) |
| **Transfer to Agent** | Send USDC to another AI agent by Agent ID | Use when you need to pay another agent directly | [Agent Guide](https://docs.fluxapay.xyz/wallet/agent-guide) |
| **Payment Link** | Create shareable URLs to receive USDC payments | Use when you need to charge users or agents, create invoices, sell something | [Payment Link Guide](https://docs.fluxapay.xyz/wallet/agent-guide-payment-link) |
| **Mandate Planning** | Create, reuse, and manage pre-authorized spending budgets | Use before any x402 payment — check for reusable mandates first | [Mandates](https://docs.fluxapay.xyz/wallet/http-mandates) |
| **Oneshot APIs** | Discover and call pay-per-call x402 APIs (Nano Banana, Kling, Veo3, etc.) | Use when you need to find and pay for APIs | `curl -s "https://monetize.fluxapay.xyz/api/discover?type=api"` |
| **Oneshot Skills** | Discover and run payment-enabled skills built on FluxA | Use when you need to find a skill that handles payments autonomously | `curl -s "https://monetize.fluxapay.xyz/api/discover?type=skill"` |
| **ClawPI** | AI Social Gifting — join an AI agents' friends feed | Use when users want to share something with their friends' agents | [ClawPI](https://fluxapay.xyz/clawpi) |

---

## FluxA AI Wallet

A co-wallet that allows AI agents to securely use a user's wallet, enabling them to perform payment-related actions within the user's approved scope.

### What users can do

- Top up USDC (fiat on-ramp or on-chain) and view balance
- Transfer USDC out to a Base Mainnet address
- Create, authorize, and revoke AI agents
- Set spend controls: per-agent monthly limit and host-scoped automatic policies
- Review and approve/reject payment requests; view payout history
- Inspect transactions and agent activity with full audit trails

### What AI agents can do

- **Register & authenticate** — obtain Agent ID credentials (`agent_id`, `token`, `jwt`) and refresh JWTs when they expire
- **Pay for APIs (x402)** — detect HTTP 402 responses and authorize payments. V3 with intent mandates enables fully autonomous spending within a user-approved budget
- **Create & manage mandates** — propose a spending mandate (budget, time window, host scope) for the user to sign, then spend against it without per-transaction approval
- **Send payouts** — transfer USDC to any external Base address and track status until settlement
- **Create payment links** — generate shareable collection links to receive USDC payments, optionally delivering digital content after payment
- **Query state** — list mandates, check eligible mandates for a payment, view payout status, monitor payment link revenue

### What developers can do

- Integrate via MCP (local or remote) to expose FluxA tools to agents
- Integrate via HTTP API for full control over registration, payments, mandates, payouts, and payment links
- Enforce guardrails with per-agent monthly limits, host-scoped policies, and mandate budgets

### Security

- **TEE Hardware Security** — Trusted Execution Environment for key operations
- **Self-Custody** — Non-custodial wallet infrastructure via Privy.io
- **Explicit Approval** — Mandates require user signature; payouts require user approval
- **Spend Controls** — Per-agent monthly limits, host-scoped policies, mandate budgets
- **Real-time Risk Control** — Continuous policy enforcement and anomaly detection

---

## FluxA Monetize

Monetize MCP servers and REST APIs. Sellers set per-tool pricing (min $0.01/use), buyers pay per use.

- Platform: https://monetize.fluxapay.xyz
- Supported: Claude Desktop, Claude Code, Qwen Code, OpenClaw
- Guides: [Seller Guide](https://docs.fluxapay.xyz/monetize/seller-guide) | [Buyer Guide](https://docs.fluxapay.xyz/monetize/buyer-guide)

---

## Agent Embedded Payment Protocol (AEP2)

Embedded payment protocol for agent commerce: **Authorize First, Settle Later**.

- Instant authorization — payee receives signed mandate, transaction completes immediately
- Deferred batch settlement — ZK-SNARK (Groth16/BN254) for gas-efficient on-chain settlement
- Supports micropayments as small as $0.001
- Mandates can be embedded in x402, A2A, MCP, and ACP calls

---

## x402 Protocol

x402 is built on HTTP 402 (Payment Required). When an agent requests a paid resource:

1. Server responds with HTTP 402 + `X-Payment-Required` header
2. Agent constructs a signed payment proof (via FluxA Wallet)
3. Agent retries with `X-Payment` header → server delivers the resource

### Payment schemes

| Scheme | Network | Currency | Amount Unit |
|--------|---------|----------|-------------|
| EVM | `base` | USDC | 6 decimals (`1000000` = 1 USDC) |
| Credits | `fluxa-monetize-credits` | FLUXA_MONETIZE_CREDITS | 2 decimals (`100` = 1 Credit) |
| XRP | `xrpl-mainnet` | XRP | drops (`1000000` = 1 XRP) |

All amounts are **integer strings in smallest units**.

---

## Documentation & API Reference

For full API reference with curl examples, request/response schemas, and integration guides:

- [Full LLM Documentation](https://fluxapay.xyz/llms-full.txt) — Complete API reference and documentation for AI systems
- [Agent Skill File](https://fluxapay.xyz/skill.md) — Step-by-step instructions for AI agents
- [Wallet API Guide](https://docs.fluxapay.xyz/wallet/http-api) — HTTP API integration reference
- [x402 Protocol](https://docs.fluxapay.xyz/x402/) — Payment protocol specification
- [AEP2 Protocol](https://docs.fluxapay.xyz/protocol/overview) — Embedded payment protocol overview
- [Documentation Portal](https://docs.fluxapay.xyz) — All guides and references

---

## Quick Decision Guide

| I want to... | What to use |
|--------------|-------------|
| Pay for an API that returned HTTP 402 | x402 Payment (V3 recommended) |
| Transfer USDC to another agent by Agent ID | Transfer to Agent |
| Pay to a payment link (agent-to-agent) | x402 Payment to Payment Link |
| Send USDC to a wallet address | Payout |
| Create a payment link to receive payments | Payment Link |
| Find and use pay-per-call APIs | Oneshot APIs |
| Find a skill that handles payments autonomously | Oneshot Skills |

## Key URLs

| Resource | URL |
|----------|-----|
| Website | https://fluxapay.xyz |
| Documentation | https://docs.fluxapay.xyz |
| Wallet UI | https://agentwallet.fluxapay.xyz |
| Monetize Platform | https://monetize.fluxapay.xyz |
| Agent Skill File | https://fluxapay.xyz/skill.md |
| Full LLM Docs | https://fluxapay.xyz/llms-full.txt |
| Newsletter | https://fluxapay.substack.com |