readme updates

Author: primersystems-dev

README.md

@@ -2,16 +2,32 @@
 
 [![Tests](https://github.com/Primer-Systems/x402/actions/workflows/test.yml/badge.svg)](https://github.com/Primer-Systems/x402/actions/workflows/test.yml)
 
-Implementation of the [x402 payment protocol](https://x402.org) for HTTP 402 payments.
+Implementation of the [x402 payment protocol](https://x402.org) for HTTP 402 payments. **OpenClaw compatible** 🦞
 
 ## Components
 
-- **sdk-typescript/** - TypeScript SDK for payers and payees
-- **sdk-python/** - Python SDK for payers and payees
+- **sdk-typescript/** - TypeScript SDK for payers and payees ([npm](https://www.npmjs.com/package/@primersystems/x402))
+- **sdk-python/** - Python SDK for payers and payees ([pypi](https://pypi.org/project/primer-x402/))
+- **openclaw/** - OpenClaw skill for AI agent payments
 - **tools/** - CLI tools for testing and token approval
 - **Contracts/** - *Prism* smart contract for ERC-20 settlements
 
-## Quick Start
+## Quick Start (CLI)
+
+```bash
+# Node.js
+npx @primersystems/x402 wallet create
+npx @primersystems/x402 probe https://api.example.com/paid
+npx @primersystems/x402 pay https://api.example.com/paid --dry-run
+
+# Python
+pip install primer-x402
+x402 wallet create
+x402 probe https://api.example.com/paid
+x402 pay https://api.example.com/paid --dry-run
+```
+
+## Quick Start (Code)
 
 ### As a Payer (Client)
 
@@ -68,6 +84,28 @@ Key v2 features:
 
 **Facilitator:** `https://x402.primer.systems` (Base networks only)
 
+## OpenClaw Integration
+
+Set up x402 payments for your AI agent with one command:
+
+```bash
+# Node.js
+npx @primersystems/x402 openclaw init
+
+# Python
+x402 openclaw init
+```
+
+This creates a wallet, configures the network, and installs the x402 skill. See [openclaw/SKILL.md](openclaw/SKILL.md) for the full skill documentation.
+
+## Links
+
+- [x402 Protocol Specification](https://x402.org)
+- [Documentation](https://primer.systems/x402)
+- [TypeScript SDK](https://www.npmjs.com/package/@primersystems/x402)
+- [Python SDK](https://pypi.org/project/primer-x402/)
+- [Primer Pay Browser Extension](https://chromewebstore.google.com/detail/primer-pay/bckienhfmjoolgkafljofomegfafanmh)
+
 ## License
 
-MIT - Primer Systems
+MIT - [Primer Systems](https://primer.systems)

sdk-python/README.md

@@ -219,11 +219,38 @@ x402 <command> [options]
 | `wallet balance <address>` | Check USDC/ETH balance |
 | `wallet from-mnemonic` | Restore wallet from mnemonic |
 | `probe <url>` | Check if URL supports x402 |
+| `pay <url>` | Make a payment to a 402 endpoint |
+| `pay <url> --dry-run` | Preview payment without paying |
 | `networks` | List supported networks |
 | `facilitator` | Show facilitator info |
 | `openclaw init` | Set up x402 for OpenClaw |
 | `openclaw status` | Check OpenClaw status |
 
+### Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `X402_PRIVATE_KEY` | Wallet private key |
+| `X402_NETWORK` | Default network (default: base) |
+| `X402_MAX_AMOUNT` | Default max payment amount |
+| `X402_FACILITATOR` | Facilitator URL override |
+
+### Examples
+
+```bash
+# Create wallet and save output
+x402 wallet create --json > wallet.json
+
+# Check balance on Arbitrum
+x402 wallet balance 0x... --network arbitrum
+
+# Preview payment (dry run)
+x402 pay https://api.example.com/data --dry-run
+
+# Pay for an API
+X402_PRIVATE_KEY=0x... x402 pay https://api.example.com/data --max-amount 0.10
+```
+
 ## Wallet Utilities
 
 ```python

sdk-typescript/README.md

@@ -379,6 +379,7 @@ npx @primersystems/x402 <command> [options]
 | `wallet from-mnemonic` | Restore wallet from mnemonic phrase |
 | `probe <url>` | Check if URL supports x402 payments |
 | `pay <url>` | Make a payment to a 402 endpoint |
+| `pay <url> --dry-run` | Preview payment without paying |
 | `networks` | List supported networks |
 | `facilitator` | Show facilitator info |
 | `openclaw init` | Set up x402 for OpenClaw agents |
@@ -402,6 +403,9 @@ npx @primersystems/x402 wallet create --json > wallet.json
 # Check balance on Arbitrum
 npx @primersystems/x402 wallet balance 0x... --network arbitrum
 
+# Preview payment (dry run)
+npx @primersystems/x402 pay https://api.example.com/data --dry-run
+
 # Pay for an API
 X402_PRIVATE_KEY=0x... npx @primersystems/x402 pay https://api.example.com/data --max-amount 0.10
 ```