@veridex/agentic-payments 0.1.1-beta.3 → 2.0.0-beta.2

package/README.md

@@ -3,67 +3,67 @@
 [![npm version](https://img.shields.io/npm/v/@veridex/agentic-payments.svg)](https://www.npmjs.com/package/@veridex/agentic-payments)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A comprehensive SDK for autonomous agent payments, built on top of `@veridex/sdk`. This package provides session key management, x402 protocol support, UCP credential provider, MCP server integration, and multi-chain payment routing.
+A comprehensive SDK for autonomous agent payments, built on top of `@veridex/sdk`. This package provides session key management, **universal protocol support (x402, UCP, ACP, AP2)**, MCP server integration, and multi-chain payment routing.
 
-## Features
+## The Universal Payment SDK for AI Agents
 
-- **Session Key Management**: Secure, time-limited signing keys with spending limits
-- **x402 Protocol**: Automatic HTTP 402 payment handling
-- **UCP Integration**: Universal Credential Protocol support for payment tokenization
-- **MCP Server**: Model Context Protocol server for LLM integration
-- **Multi-Chain Support**: EVM, Solana, Aptos, Sui, and Starknet
-- **Real-Time Pricing**: Pyth Network oracle integration
-- **Performance Optimizations**: Client-side nonce tracking, transaction batching, confirmation polling
+**One Wallet. Any Protocol. Global Access.**
 
-## Installation
+The Veridex SDK (`@veridex/agentic-payments`) is the standard financial layer for autonomous agents. It bridges the gap between competing protocols (ACP, UCP, x402, AP2), allowing your agent to pay for anything, anywhere, with a single line of code.
+
+## 🌐 Protocol Support
+
+| Protocol | Creator | Status | Use Case |
+|----------|---------|--------|----------|
+| **x402** | Coinbase/Cloudflare | ✅ Full | Web-native micropayments |
+| **UCP** | Google/Shopify | ✅ Full | Commerce/Search integration |
+| **ACP** | OpenAI/Stripe | 🔜 Q2 2026 | ChatGPT ecosystem |
+| **AP2** | Google | 🔜 Q2 2026 | A2A mandate delegation |
+| **AXTP** | Circuit/Chisel | 🔜 Q3 2026 | MCP monetization |
+
+## 🚀 Features
+
+-   **Universal Protocol Support**: Automatically handles **ACP** (OpenAI), **UCP** (Google), **x402** (Web-Native), and **AP2**.
+-   **Smart Protocol Detection**: The SDK detects the merchant's required payment method and adapts instantly.
+-   **Session Keys (USKS)**: Bank-grade security with strict, human-defined spending limits (e.g., "$10/day").
+-   **Chain Abstraction**: Pay with USDC on Base, even if the merchant wants SOL on Solana. We handle the bridging.
+-   **MCP Server Included**: Give Claude or ChatGPT a wallet in 5 minutes with our pre-built Model Context Protocol server.
+-   **Identity & Trust**: Built-in support for ERC-8004 and Visa TAP verification.
+
+## 📦 Installation
 
 ```bash
 npm install @veridex/agentic-payments
 # or
-yarn add @veridex/agentic-payments
-# or
 pnpm add @veridex/agentic-payments
 ```
 
-## Quick Start
-
-### Basic Agent Setup
+## ⚡ Quick Start
 
+### 1. Initialize the Universal Wallet
 ```typescript
-import { createAgentWallet, AgentWalletConfig } from '@veridex/agentic-payments';
-
-const config: AgentWalletConfig = {
-  masterCredential: {
-    credentialId: 'your-passkey-credential-id',
-    publicKeyX: BigInt('...'),
-    publicKeyY: BigInt('...'),
-    keyHash: '0x...',
-  },
-  session: {
-    dailyLimitUSD: 100,
-    perTransactionLimitUSD: 25,
-    expiryHours: 8,
-    allowedChains: [30], // Base
-  },
-  relayerUrl: 'https://relay.veridex.network',
-};
+import { createAgentWallet } from '@veridex/agentic-payments';
 
-const agent = await createAgentWallet(config);
+const agent = await createAgentWallet({
+  sessionKey: process.env.SESSION_KEY, 
+  // Define limits once, enforce everywhere
+  limits: { daily: 100, currency: 'USD' } 
+});
 ```
 
-### Making Payments
+### 2. Pay for Anything (The "Magic" Method)
+Forget dealing with complex headers or handshake protocols. Just use `fetch`:
 
 ```typescript
-// Direct payment
-const receipt = await agent.pay({
-  amount: '10.00',
-  token: 'USDC',
-  recipient: '0x...',
-  chain: 30,
-});
-
-// Automatic 402 payment handling
-const response = await agent.fetch('https://api.paid-service.com/resource');
+// The SDK automatically:
+// 1. Detects if this is x402, ACP, or UCP
+// 2. Negotiates the price
+// 3. Signs the transaction
+// 4. Settles the payment
+const response = await agent.fetch('https://api.merchant.com/premium-data');
+
+const data = await response.json();
+console.log('Bought data:', data);
 ```
 
 ### Session Management