x402 SDK v0.4.0 - Full v2 upgrade with CAIP-2 networks

Author: jdkp25

.github/workflows/test.yml

@@ -7,12 +7,13 @@ on:
     branches: [main]
 
 jobs:
-  test:
+  typescript:
+    name: TypeScript SDK
     runs-on: ubuntu-latest
 
     defaults:
       run:
-        working-directory: ./sdk
+        working-directory: ./sdk-typescript
 
     steps:
       - name: Checkout repository
@@ -23,10 +24,35 @@ jobs:
         with:
           node-version: '20'
           cache: 'npm'
-          cache-dependency-path: sdk/package-lock.json
+          cache-dependency-path: sdk-typescript/package-lock.json
 
       - name: Install dependencies
         run: npm ci
 
       - name: Run tests
         run: npm test
+
+  python:
+    name: Python SDK
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        working-directory: ./sdk-python
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: 'pip'
+          cache-dependency-path: sdk-python/pyproject.toml
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest

README.md

@@ -1,12 +1,13 @@
 # Primer x402
 
-[![Tests](https://github.com/Primer-Systems/x402/actions/workflows/test.yml/badge.svg)](https://github.com/Primer-Systems/x402-private/actions/workflows/test.yml)
+[![Tests](https://github.com/PrimerSystems/x402/actions/workflows/test.yml/badge.svg)](https://github.com/PrimerSystems/x402/actions/workflows/test.yml)
 
-Implementation of the [x402 payment protocol](https://x402.org) for HTTP 402 payments on Base.
+Implementation of the [x402 payment protocol](https://x402.org) for HTTP 402 payments.
 
 ## Components
 
-- **sdk/** - JavaScript SDK for payers and payees
+- **sdk-typescript/** - JavaScript/TypeScript SDK for payers and payees
+- **sdk-python/** - Python SDK for payers and payees
 - **tools/** - CLI tools for testing and token approval
 - **Contracts/** - *Prism* smart contract for ERC-20 settlements
 
@@ -17,7 +18,8 @@ Implementation of the [x402 payment protocol](https://x402.org) for HTTP 402 pay
 ```javascript
 const { createSigner, x402Fetch } = require('@primersystems/x402');
 
-const signer = await createSigner('base', process.env.PRIVATE_KEY);
+// Use CAIP-2 network format (eip155:chainId)
+const signer = await createSigner('eip155:8453', process.env.PRIVATE_KEY);
 const fetch402 = x402Fetch(fetch, signer, { maxAmount: '1.00' });
 
 const response = await fetch402('https://example.com/api/paywall');
@@ -32,17 +34,23 @@ app.use(x402Express('0xYourAddress', {
   '/api/paywall': {
     amount: '0.01',
     asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // USDC on Base
-    network: 'base'
+    network: 'eip155:8453'  // CAIP-2 format
   }
 }));
 ```
 
 ## Supported Networks
 
-| Network | Chain ID |
-|---------|----------|
-| Base | 8453 |
-| Base Sepolia | 84532 |
+Networks use [CAIP-2](https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-2.md) identifiers.
+
+| Network (CAIP-2) | Chain ID | Name | Default Facilitator |
+|------------------|----------|------|---------------------|
+| eip155:8453 | 8453 | Base | ✓ Primer |
+| eip155:84532 | 84532 | Base Sepolia | ✓ Primer |
+| eip155:1 | 1 | Ethereum | Custom required |
+| eip155:42161 | 42161 | Arbitrum | Custom required |
+| eip155:10 | 10 | Optimism | Custom required |
+| eip155:137 | 137 | Polygon | Custom required |
 
 ## Token Types
 
@@ -51,11 +59,15 @@ app.use(x402Express('0xYourAddress', {
 
 ## Protocol
 
-Uses x402 v1 with the `exact` scheme. Payments are authorized via EIP-712 signatures and settled by a facilitator service.
+Uses **x402 v2** with the `exact` scheme. Payments are authorized via EIP-712 signatures and settled by a facilitator service.
+
+Key v2 features:
+- `x402Version: 2` in all payloads
+- CAIP-2 network identifiers (e.g., `eip155:8453` instead of `base`)
+- Multi-chain support
 
-**Facilitator:** `https://x402.primer.systems`
+**Facilitator:** `https://x402.primer.systems` (Base networks only)
 
 ## License
 
 MIT - Primer Systems
-

sdk-python/.gitignore

@@ -0,0 +1,56 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# mypy
+.mypy_cache/