x402-proxy 0.1.0 → 0.1.2

package/LICENSE

@@ -48,9 +48,9 @@
       "Contribution" shall mean any work of authorship, including
       the original version of the Work and any modifications or additions
       to that Work or Derivative Works thereof, that is intentionally
-      submitted to the Licensor for inclusion in the Work by the copyright
-      owner or by an individual or Legal Entity authorized to submit on behalf
-      of the copyright owner. For the purposes of this definition, "submitted"
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
       means any form of electronic, verbal, or written communication sent
       to the Licensor or its representatives, including but not limited to
       communication on electronic mailing lists, source code control systems,
@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025 Cascade Protocol
+   Copyright [yyyy] [name of copyright owner]
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -0,0 +1,88 @@
+# x402-proxy
+
+Generic [x402](https://www.x402.org/) payment proxy library for Solana and EVM USDC. Wraps `fetch` with automatic x402 payment handling, tracks transaction history, and provides wallet loading utilities.
+
+## Install
+
+```bash
+npm install x402-proxy
+```
+
+Peer dependencies: `@solana/kit`, `ethers`, `viem`
+
+## Usage
+
+```ts
+import {
+  x402Client,
+  ExactSvmScheme,
+  ExactEvmScheme,
+  createX402ProxyHandler,
+  extractTxSignature,
+  loadSvmWallet,
+  loadEvmWallet,
+} from "x402-proxy";
+
+// 1. Configure the x402 client with payment schemes
+const svmWallet = await loadSvmWallet("/path/to/keypair.json");
+const client = x402Client([ExactSvmScheme(svmWallet)]);
+
+// 2. Create the proxy handler
+const { x402Fetch, shiftPayment } = createX402ProxyHandler({ client });
+
+// 3. Make requests - payments are handled automatically
+const response = await x402Fetch("https://api.example.com/paid-endpoint");
+const payment = shiftPayment(); // { network, payTo, amount, asset }
+const txSig = extractTxSignature(response);
+```
+
+### Transaction history
+
+```ts
+import { appendHistory, readHistory, calcSpend, formatTxLine } from "x402-proxy";
+
+// Append a transaction record
+appendHistory("/path/to/history.jsonl", {
+  t: Date.now(),
+  ok: true,
+  kind: "x402_inference",
+  net: "solana:mainnet",
+  from: "J5UH...",
+  tx: "5abc...",
+  amount: 0.05,
+  token: "USDC",
+  model: "claude-sonnet-4-20250514",
+});
+
+// Read and aggregate
+const records = readHistory("/path/to/history.jsonl");
+const { today, total, count } = calcSpend(records);
+```
+
+## API
+
+### Payment proxy
+
+- `createX402ProxyHandler(opts)` - wraps fetch with automatic x402 payment. Returns `{ x402Fetch, shiftPayment }`
+- `extractTxSignature(response)` - extracts on-chain TX signature from payment response headers
+
+### Wallet loading
+
+- `loadSvmWallet(path)` - load Solana keypair from solana-keygen JSON file
+- `loadEvmWallet(path)` - load EVM wallet from hex private key file
+
+### Transaction history
+
+- `appendHistory(path, record)` - append a `TxRecord` to a JSONL file (auto-truncates at 1000 lines)
+- `readHistory(path)` - read all records from a JSONL history file
+- `calcSpend(records)` - aggregate USDC spend (today/total/count)
+- `explorerUrl(net, tx)` - generate block explorer URL (Solscan, Basescan, Etherscan)
+- `formatTxLine(record)` - format a record as a markdown line with explorer link
+
+### Re-exports
+
+- `x402Client`, `ExactSvmScheme`, `ExactEvmScheme`, `toClientEvmSigner` - from `@x402/fetch`, `@x402/svm`, `@x402/evm`
+
+## License
+
+Apache-2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x402-proxy",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Generic x402 payment proxy library for Solana USDC",
   "type": "module",
   "sideEffects": false,
@@ -16,6 +16,7 @@
   },
   "peerDependencies": {
     "@solana/kit": "^6.0.0",
+    "ethers": "^6.0.0",
     "viem": "^2.0.0"
   },
   "devDependencies": {
@@ -37,12 +38,12 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/cascade-protocol/agentbox.git",
+    "url": "git+https://github.com/cascade-protocol/x402-proxy.git",
     "directory": "packages/x402-proxy"
   },
-  "homepage": "https://github.com/cascade-protocol/agentbox/tree/main/packages/x402-proxy#readme",
+  "homepage": "https://github.com/cascade-protocol/x402-proxy#readme",
   "bugs": {
-    "url": "https://github.com/cascade-protocol/agentbox/issues"
+    "url": "https://github.com/cascade-protocol/x402-proxy/issues"
   },
   "scripts": {
     "build": "rm -rf dist && tsdown --publint",