agentwallet-sdk 5.0.3 → 5.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 up2itnow0822
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,8 @@
 # AgentWallet SDK
 
+> **📦 CANONICAL PACKAGE:** This is the actively maintained source for the `agentwallet-sdk` npm package (v5+). The old `agentwallet-sdk` GitHub repo is deprecated — use this repo.
+
+
 Non-custodial AI agent wallet with ERC-8004 on-chain identity, ERC-6551 token-bound accounts, x402 payments, mutual stake escrow, and programmable spending guardrails.
 
 Agent Wallet gives AI agents autonomous spending power with hard on-chain limits. No more choosing between "agent can drain everything" and "every transaction needs manual approval."
@@ -204,45 +207,24 @@ await escrow.verify(escrowId);
 
 Premium access: [github.com/up2itnow/AgentNexus2](https://github.com/up2itnow/AgentNexus2)
 
-## x402 Protocol: Supported Chains and Payment Rails
-
-x402 (HTTP 402 Payment Required) is the native payment protocol for agent-to-service transactions. The agent encounters a 402 response, signs a payment proof, and re-sends the request. One round trip. No accounts, no API keys, no invoices.
-
-As of March 2026, x402 is live on 3 chains/rails:
-
-| Chain / Rail | Status | Settlement Token | Gas Cost | Notes |
-|---|---|---|---|---|
-| **Base** (Coinbase L2) | Live | USDC | Sub-cent | Primary x402 chain. 15M+ transactions in Jan 2026. |
-| **Etherlink** (Tezos L2) | Live (Mar 2026) | USDC | Sub-cent | EVM-compatible. Same x402 integration, different RPC + chain ID. |
-| **Stripe** (Fiat offramp) | Live (Feb 2026) | USDC -> USD | N/A | Vendors receive USD in Stripe dashboard. Agents pay USDC. |
+## Atomic Settlement — Verified On-Chain
 
-### x402 + Etherlink Quick Start
+Live x402 settlement endpoint on Base Sepolia with on-chain attestation verification:
 
-```typescript
-import { createWallet, agentExecute } from 'agentwallet-sdk';
-
-const wallet = createWallet({
-  accountAddress: '0xYourAgent',
-  chain: 'etherlink',  // new: Tezos L2 support
-  walletClient,
-});
-
-// x402 payment flow is identical across chains
-const response = await fetch('https://api.vendor.com/data');
-if (response.status === 402) {
-  const details = await response.json();
-  const proof = await wallet.createX402Proof(details);
-  const paid = await fetch('https://api.vendor.com/data', {
-    headers: { 'X-Payment': proof }
-  });
-}
 ```
+https://dexter-settlement-test-production.up.railway.app
+```
+
+| Proof | Transaction |
+|---|---|
+| USDC Payment | [`0xbba6c34a...`](https://sepolia.basescan.org/tx/0xbba6c34ad6b11cc4e511317ca38553df903dcbe989ee47e45b5c48f3af7e4334) |
+| Fee Routing (0.77%) | [`0x9a5e450c...`](https://sepolia.basescan.org/tx/0x9a5e450c1080a2478ea22792b6ab034974d8f99072808f83354c98451441733a) |
 
-The SDK handles chain-specific RPC endpoints, gas estimation, and USDC contract addresses automatically. Swap `chain: 'base'` to `chain: 'etherlink'` and the x402 flow works identically.
+See [`examples/settlement-test/`](examples/settlement-test/) for the full settlement server, self-test script, and integration guide.
 
 ## Supported Chains
 
-Mainnet: Ethereum, Base, Arbitrum, Polygon, Optimism, Avalanche, BSC, Celo, Gnosis, Linea, Mantle, Scroll, Etherlink, and more.
+Mainnet: Ethereum, Base, Arbitrum, Polygon, Optimism, Avalanche, BSC, Celo, Gnosis, Linea, Mantle, Scroll, and more.
 
 Testnet: Base Sepolia, Arbitrum Sepolia, and corresponding testnets.
 
@@ -252,6 +234,22 @@ Testnet: Base Sepolia, Arbitrum Sepolia, and corresponding testnets.
 - [GitHub](https://github.com/agentnexus/agent-wallet-sdk)
 - [npm](https://www.npmjs.com/package/agentwallet-sdk)
 
+
+## Why agent-wallet-sdk vs. Polygon Agent CLI
+
+| Feature | agent-wallet-sdk | Polygon Agent CLI |
+|---|---|---|
+| Wallet model | Non-custodial, agent holds keys | CLI-based, operator-managed |
+| x402 support | Native, automatic negotiation | Not supported |
+| Spend limits | Programmable (daily, per-tx, per-agent) | Manual configuration |
+| Multi-chain | Ethereum, Base, Etherlink, Polygon, 10+ chains | Polygon-only |
+| Integration | npm package, works in any JS/TS runtime | CLI tool, requires shell access |
+| Agent frameworks | Any (LangChain, CrewAI, Cursor, NemoClaw) | Polygon ecosystem only |
+| Audit trail | Built-in transaction logging | External tooling required |
+| Use case | Autonomous agent payments at scale | Polygon-specific agent ops |
+
+agent-wallet-sdk is chain-agnostic, framework-agnostic, and built for autonomous agents that need to pay for things without human approval. Polygon Agent CLI is a solid tool if you are all-in on Polygon infrastructure - but if your agents need to operate across chains or use x402 payment headers, agent-wallet-sdk is the better fit.
+
 ## License
 
 MIT