@aifinpay/deployments 1.1.0

package/registry/splitter/INDEX.md

@@ -0,0 +1,163 @@
+# Splitter Deployment Registry — Index
+
+Versioned storage for B2BSplitter contract deployments across all supported chains and ecosystems.
+
+## Structure
+
+```
+deployments/registry/splitter
+├── INDEX.md                 # This file
+├── evm/v1.1/                    # EVM Legacy — Initial version (immutable 1%/0.01% fee)
+│   ├── README.md
+│   └── deployments.json
+├── evm/v1.2/                    # EVM Legacy — Added paymentId replay guard
+│   ├── README.md
+│   └── deployments.json
+├── evm/v1.3/                    # EVM Route table — Protocol routes (merchant-aifp1 / agent-x402)
+│   ├── README.md
+│   └── deployments.json
+├── evm/v1.4/                    # EVM Full contract suite — 7 contracts per chain
+│   ├── README.md
+│   └── deployments.json
+├── solana/                  # Solana v1.4 — Program deployments (non-EVM)
+│   ├── README.md
+│   └── deployments.json
+└── casper/                  # Casper — Placeholder (not yet deployed)
+    ├── README.md
+    └── deployments.json
+```
+
+## Quick Lookup by Version
+
+| Version | Ecosystem | Status | Chains/Networks | Key Feature |
+|---------|-----------|--------|-----------------|-------------|
+| [v1.1](evm/v1.1/README.md) | EVM | Superseded | Base, Unichain | Initial production release |
+| [v1.2](evm/v1.2/README.md) | EVM | Superseded | Polygon, Optimism, BOT Chain, XRPL EVM | `bytes32 paymentId` replay guard |
+| [v1.3](evm/v1.3/README.md) | EVM | Active | 10 chains × 2 routes | Protocol routes with immutable fee splits |
+| [v1.4](evm/v1.4/README.md) | EVM | Mostly disabled | 10 chains | Full contract suite (7 contracts per chain) |
+| [v1.4](./solana/README.md) | Solana | Disabled | Devnet, Mainnet | Program ID + IDL (Anchor-style) |
+| [v1/v2](./casper/README.md) | Casper | Testnet live | Testnet (live), Mainnet (historical v1) | Rust → Wasm contract; `register_agent` / `pay_agent` |
+
+## Quick Lookup by Chain
+
+### EVM Chains
+
+| Chain | Chain ID | v1.1 | v1.2 | v1.3 Routes | v1.4 Status |
+|-------|----------|------|------|-------------|-------------|
+| Amoy | 80002 | — | — | `merchant-aifp1`, `agent-x402` (testnet, settlement enabled) | ✅ enabled |
+| Arbitrum | 42161 | — | — | `merchant-aifp1`, `agent-x402` | ❌ disabled |
+| Avalanche | 43114 | — | — | `merchant-aifp1`, `agent-x402` | ❌ disabled |
+| Base | 8453 | ✓ | — | `merchant-aifp1`, `agent-x402` | ⚠️ invalid (redeploy required) |
+| BNB | 56 | — | — | `merchant-aifp1`, `agent-x402` | ❌ disabled |
+| BOT Chain | 677 | — | ✓ | `merchant-aifp1`, `agent-x402` | — |
+| Optimism | 10 | — | ✓ | `merchant-aifp1`, `agent-x402` | ❌ disabled |
+| Polygon | 137 | — | ✓ | `merchant-aifp1`, `agent-x402` | ❌ disabled |
+| Robinhood | 4663 | — | — | — | ❌ disabled (TokenList empty) |
+| Unichain | 130 | ✓ | — | `merchant-aifp1`, `agent-x402` | ❌ disabled |
+| XRPL EVM | 1440000 | — | ✓ | `merchant-aifp1`, `agent-x402` | ❌ disabled (no stablecoin) |
+
+### Non-EVM Ecosystems
+
+| Ecosystem | Network | Program ID / Contract Hash | Status |
+|-----------|---------|---------------------------|--------|
+| [Solana](./solana/README.md) | Devnet | `8dty5bD738Z9TzEkDu8vLSnhpJNWtEGMUEcYaKCUTY6y` | ❌ disabled (no backend verification) |
+| Solana | Mainnet | `724Ut31i4ecY4dJ25z8HuZetu3A43xtNkPdk4JdbsfdD` | ❌ disabled (no backend verification + upgrade authority not multisig) |
+| [Casper](./casper/README.md) | Testnet | `hash-47df409829ddf0612617460293ba591a19b26fa0c06918878204088d3eb9b78a` | ✅ **live** (v2 verified) |
+| Casper | Mainnet | `hash-7ad34a204952eef63d5dcf5159fb7d009e85dea4f49cbdf73dde190652dfa375` | ⚠️ **historical** (v1 — receipt only, no atomic transfer) |
+
+## Governance
+
+All v1.3 deployments are owned by the same governance Safe:
+
+- **Safe:** `0xFd936f75D9221949f2FEaB54Cd342F7527154eD5`
+- **Threshold:** 3 of 5
+- **Owners:** 5 multisig signers
+
+Legacy v1.1/v1.2 deployments have varying owners (see version-specific READMEs).
+
+## Sources of Truth
+
+### EVM v1.1-v1.3 (Route Table)
+
+- **Source:** `AiFinPay/evm-contract/registry/generated/splitter-table.json`
+- **Local copy:** `deployments/registry/reference/splitter-table.json`
+- **Last updated:** 2026-08-30
+
+### EVM v1.4 (Full Contract Suite)
+
+- **Source:** `AiFinPay/evm-contract/deployments/*-v14-*-latest.json`
+- **Local copy:** `deployments/registry/evm-splitter-v1.4.json`
+- **Last generated:** 2026-09-13
+- **Upstream commit:** `a54a4c107de7bb42f54e411e621d3897938bfc31`
+
+### Solana v1.4 (Program)
+
+- **Source:** `AiFinPay/solana-contract/deployments/splitter_v14/`
+- **Local copy:** `deployments/registry/solana-splitter-v1.4.json`
+- **Last generated:** 2026-09-13
+- **Upstream commit:** `e5df8f5436cf646ab495381eee04e0d1a10b4e2f`
+
+### Casper
+
+- **Testnet (v2):** `hash-47df409829ddf0612617460293ba591a19b26fa0c06918878204088d3eb9b78a` — live, verified
+- **Mainnet (v1):** `hash-7ad34a204952eef63d5dcf5159fb7d009e85dea4f49cbdf73dde190652dfa375` — historical, receipt-only (not valid settlement proof)
+- **Source:** `AiFinPay/casper-contract` — Rust → Wasm contract
+- **IDL:** Not applicable (Casper uses Rust contract schema, not Anchor-style IDL)
+
+**Do not hand-edit** the JSON files in this directory. To update:
+
+1. Change `registry/registry.json` in `AiFinPay/evm-contract`
+2. Run `verify-registry.mjs` to verify against chain
+3. Run `npm run registry:sync -- --from <path-to-evm-contract>` in `node/`
+4. Copy updated `node/registry/splitter-table.json` to `deployments/registry/reference/`
+5. Regenerate versioned files with a script (TODO: add generator)
+
+## Related Artifacts
+
+### EVM
+
+- `registry/reference/splitter-table.json` — Raw upstream route table (v1.2 + v1.3)
+- `registry/reference/splitter-table-source.json` — Provenance metadata
+- `registry/evm-splitter-v1.4.json` — v1.4 full contract suite deployments
+- `registry/abi/` — EVM ABI bundles and Tron ABI artifacts
+
+### Solana
+
+- `registry/solana-splitter-v1.4.json` — v1.4 program deployments
+- `registry/idl/solana/splitter-v14/` — IDL copies (devnet + mainnet)
+
+### Casper
+
+- `registry/idl/casper/` — Casper IDL artifacts (contract schema, not Anchor-style)
+- **Upstream:** `AiFinPay/casper-contract` — https://github.com/AiFinPay/casper-contract
+
+### Combined
+
+- `registry/evm-splitter-v1.4.json` — Generated EVM v1.4 deployments (matches `splitter/v1.4/deployments.json` schema)
+- `registry/solana-splitter-v1.4.json` — Generated Solana v1.4 deployments (matches `splitter/solana/deployments.json` schema)
+
+## Usage
+
+### For SDK consumers
+
+Use the `@aifinpay/agent` SDK's `resolveSplitterRoute(chain, route)` function — it reads from the generated `splitterRoutes.generated.ts` table.
+
+### For auditors
+
+1. Check `evm/v1.2` for superseded addresses
+2. Verify migration guards in `node/tests/splitterV12.test.ts`
+3. Compare runtime code hashes against on-chain `eth_getCode`
+
+### For deployment verification
+
+1. Check `evm/v1.3` for current addresses
+2. Verify `runtimeCodeHash` matches deployed bytecode
+3. Confirm `owner` and `treasury` match expected governance Safe
+4. Check `validFrom`/`validUntil` policy window
+
+## Security Notes
+
+- **Address collisions:** Same address can appear on different chains/routes with different fee splits. Never select by address alone.
+- **Settlement status:** `settlementEnabled: false` means the route is not cleared for mainnet payments.
+- **Policy window:** Routes outside their `validFrom`/`validUntil` window must not settle.
+- **Testnet opt-in:** Amoy routes require explicit `allowTestnet: true` flag in settlement code.

package/registry/splitter/casper/README.md

@@ -0,0 +1,101 @@
+# Casper Splitter v1 — Contract Deployments
+
+## Overview
+
+Casper settlement contract (Rust → Wasm) for AI agent payments. Agents self-register on-chain identities, then `pay_agent` atomically records settlement and emits `PaymentSettled` events.
+
+**Status:** Live on Casper testnet. Mainnet v1 is historical (payment recording only, no atomic transfer).
+
+## Deployments
+
+| Network | Contract Package Hash | Status | Notes |
+|---------|----------------------|--------|-------|
+| Casper Testnet | `hash-47df409829ddf0612617460293ba591a19b26fa0c06918878204088d3eb9b78a` | ✅ **live** | v2 — verified deployment |
+| Casper Mainnet | `hash-7ad34a204952eef63d5dcf5159fb7d009e85dea4f49cbdf73dde190652dfa375` | ⚠️ **historical** | v1 — `pay_agent` recorded amount but did NOT transfer; separate transfer required |
+
+## Contract Details
+
+### Entry Points
+
+| Entry Point | Args | Description |
+|-------------|------|-------------|
+| `register_agent` | `agent_id: String, wallet: String` | Self-register caller wallet → `AgentRegistered` event |
+| `pay_agent` | `from_agent: String, to_agent: String, amount: U512, request_id: String` | Record settlement → `PaymentSettled` event (v2); v1 recorded only |
+| `get_payment_count` | — | Total settled payments |
+
+### Events
+
+- `AgentRegistered` — `agent_id`, `wallet`
+- `PaymentSettled` — `from`, `to`, `amount` (motes), `request_id`
+
+## Live Testnet Deployment
+
+**Contract Package Hash:**
+```
+hash-47df409829ddf0612617460293ba591a19b26fa0c06918878204088d3eb9b78a
+```
+
+**Explorer:** [cspr.live testnet](https://testnet.cspr.live/contract/47df409829ddf0612617460293ba591a19b26fa0c06918878204088d3eb9b78a)
+
+**Network:** `casper-test` (Casper 2.0)
+
+**Public RPC:** `https://node.testnet.casper.network/rpc`
+
+### Sample Transactions (Testnet)
+
+| Action | Deploy Hash | Explorer |
+|--------|-------------|----------|
+| Register agent (buyer) | `d4b7d0ad3b59a97a1165eab1dbc36dbee56ccf8a4bc48f3507071682427d23e0` | [view](https://testnet.cspr.live/deploy/d4b7d0ad3b59a97a1165eab1dbc36dbee56ccf8a4bc48f3507071682427d23e0) |
+| Register agent (provider) | `6c41c8858f95af24afaf1267dcb8ced93c654f9a8bddfc722c6638825faac4e8` | [view](https://testnet.cspr.live/deploy/6c41c8858f95af24afaf1267dcb8ced93c654f9a8bddfc722c6638825faac4e8) |
+| **PaymentSettled** (`pay_agent`) | `0b55b516058a3482beef0dac2d6997d84b402f82f71a97b3098e2aadaffb0137` | [view](https://testnet.cspr.live/deploy/0b55b516058a3482beef0dac2d6997d84b402f82f71a97b3098e2aadaffb0137) |
+
+## Historical Mainnet Deployment (v1)
+
+> ⚠️ **Warning:** The mainnet v1 deployment is **not valid settlement proof**. The `pay_agent` call recorded a receipt, but value was moved via a separate native transfer. Do not reproduce this flow.
+
+**Contract Hash:** `contract-9903a5e3948e799196df54b17270bc6769338ac1cc36c9eb47e113f88d23f019`
+
+**Package Hash:** `hash-7ad34a204952eef63d5dcf5159fb7d009e85dea4f49cbdf73dde190652dfa375`
+
+**Explorer:** [cspr.live mainnet](https://cspr.live/contract/9903a5e3948e799196df54b17270bc6769338ac1cc36c9eb47e113f88d23f019)
+
+## Key Differences from EVM/Solana
+
+| Feature | EVM v1.4 | Solana v1.4 | Casper v1/v2 |
+|---------|----------|-------------|--------------|
+| Architecture | 7-contract suite | Single program | Single Wasm contract |
+| Language | Solidity | Rust (Anchor) | Rust (Casper SDK) |
+| Execution | EVM | SVM (Sealevel) | Casper Wasm |
+| Identity | Contract addresses | Program-derived addresses | Account hashes |
+| Settlement | Atomic transfer + receipt | Atomic transfer + receipt | v2: atomic; v1: receipt only |
+
+## Source
+
+Data sourced from upstream `AiFinPay/casper-contract` repository.
+
+**Upstream repo:** https://github.com/AiFinPay/casper-contract
+
+**Submission:** https://github.com/AiFinPay/casper-contract/blob/main/SUBMISSION.md
+
+**Architecture docs:** https://github.com/AiFinPay/casper-contract/blob/main/docs/ARCHITECTURE.md
+
+## Integration
+
+Small, runnable examples live in [`examples/`](https://github.com/AiFinPay/casper-contract/tree/main/examples):
+
+- `register-agent.js` — register an agent
+- `pay-agent.js` — settle a payment
+- `ai-agent-buys-compute.md` — x402 → Casper flow
+- `merchant-integration.md` — gate an endpoint behind settlement
+- `mcp-server.md` — drive settlements from Claude via MCP
+
+## Reproduce Demo
+
+```bash
+git clone https://github.com/AiFinPay/casper-contract.git
+cd casper-contract
+make setup
+make keygen
+# Fund key at https://testnet.cspr.live/tools/faucet
+make agent-demo
+```

package/registry/splitter/casper/deployments.json

@@ -0,0 +1,110 @@
+{
+  "$schema": "",
+  "version": "2.0",
+  "description": "Casper Splitter — Rust → Wasm settlement contract for AI agent payments",
+  "schemaVersion": 2,
+  "generatedAt": "2026-09-14T00:00:00.000Z",
+  "ecosystem": "casper",
+  "protocolVersion": "v1/v2/v3",
+  "idlPath": "../../idl/casper/aifinpay-casper-schema.json",
+  "source": {
+    "repo": "AiFinPay/casper-contract",
+    "url": "https://github.com/AiFinPay/casper-contract",
+    "localPath": "/home/daochild/dev/aifinpay/casper-contract"
+  },
+  "contract": {
+    "language": "Rust",
+    "runtime": "Wasm",
+    "dependencies": {
+      "casper-contract": "5.1.1",
+      "casper-types": "6.1.0"
+    },
+    "entryPoints": [
+      {
+        "name": "register_agent",
+        "args": [
+          { "name": "agent_id", "type": "String" },
+          { "name": "wallet", "type": "String" }
+        ],
+        "description": "Self-register caller wallet → AgentRegistered event"
+      },
+      {
+        "name": "pay_agent",
+        "args": [
+          { "name": "from_agent", "type": "String" },
+          { "name": "to_agent", "type": "String" },
+          { "name": "amount", "type": "U512" },
+          { "name": "request_id", "type": "String" }
+        ],
+        "description": "Record settlement → PaymentSettled event (v2); v1 recorded only"
+      },
+      {
+        "name": "get_payment_count",
+        "args": [],
+        "description": "Total settled payments"
+      }
+    ],
+    "events": [
+      { "name": "AgentRegistered", "fields": ["agent_id", "wallet"] },
+      { "name": "PaymentSettled", "fields": ["from", "to", "amount", "request_id"] }
+    ]
+  },
+  "deployments": [
+    {
+      "network": "casper-test",
+      "environment": "testnet",
+      "testnet": true,
+      "status": "live",
+      "settlementEnabled": true,
+      "contractPackageHash": "hash-47df409829ddf0612617460293ba591a19b26fa0c06918878204088d3eb9b78a",
+      "rpcEndpoint": "https://node.testnet.casper.network/rpc",
+      "explorer": "https://testnet.cspr.live/contract/47df409829ddf0612617460293ba591a19b26fa0c06918878204088d3eb9b78a",
+      "version": "v2",
+      "notes": "Verified deployment — atomic settlement with on-chain receipt",
+      "idlPath": "../../idl/casper/aifinpay-casper-schema.json",
+      "sampleTransactions": [
+        {
+          "action": "register_agent (buyer)",
+          "deployHash": "d4b7d0ad3b59a97a1165eab1dbc36dbee56ccf8a4bc48f3507071682427d23e0",
+          "explorer": "https://testnet.cspr.live/deploy/d4b7d0ad3b59a97a1165eab1dbc36dbee56ccf8a4bc48f3507071682427d23e0"
+        },
+        {
+          "action": "register_agent (provider)",
+          "deployHash": "6c41c8858f95af24afaf1267dcb8ced93c654f9a8bddfc722c6638825faac4e8",
+          "explorer": "https://testnet.cspr.live/deploy/6c41c8858f95af24afaf1267dcb8ced93c654f9a8bddfc722c6638825faac4e8"
+        },
+        {
+          "action": "PaymentSettled (pay_agent)",
+          "deployHash": "0b55b516058a3482beef0dac2d6997d84b402f82f71a97b3098e2aadaffb0137",
+          "explorer": "https://testnet.cspr.live/deploy/0b55b516058a3482beef0dac2d6997d84b402f82f71a97b3098e2aadaffb0137"
+        }
+      ]
+    },
+    {
+      "network": "casper",
+      "environment": "mainnet",
+      "testnet": false,
+      "status": "historical",
+      "settlementEnabled": false,
+      "contractHash": "contract-9903a5e3948e799196df54b17270bc6769338ac1cc36c9eb47e113f88d23f019",
+      "contractPackageHash": "hash-7ad34a204952eef63d5dcf5159fb7d009e85dea4f49cbdf73dde190652dfa375",
+      "rpcEndpoint": "https://node.casper.network/rpc",
+      "explorer": "https://cspr.live/contract/9903a5e3948e799196df54b17270bc6769338ac1cc36c9eb47e113f88d23f019",
+      "version": "v1",
+      "idlPath": "../../idl/casper/aifinpay-casper-schema.json",
+      "disabledReason": "v1: pay_agent recorded receipt but did NOT transfer value; separate native transfer required — not valid settlement proof",
+      "warning": "Do not reproduce this v1 flow. Use v2 testnet deployment for valid atomic settlement."
+    }
+  ],
+  "integration": {
+    "examples": "https://github.com/AiFinPay/casper-contract/tree/main/examples",
+    "demoScript": "https://github.com/AiFinPay/casper-contract/blob/main/demo/agent-compute-demo.js",
+    "x402Bridge": "https://github.com/AiFinPay/casper-contract/blob/main/demo/compute-bridge.js",
+    "mcpsServer": "https://github.com/AiFinPay/casper-contract/blob/main/demo/casper-mcp.mjs"
+  },
+  "sourceArtifact": {
+    "path": null,
+    "retrievedAt": "2026-09-14",
+    "note": "Data extracted from AiFinPay/casper-contract README and SUBMISSION.md"
+  }
+}

package/registry/splitter/evm/v1.1/README.md

@@ -0,0 +1,32 @@
+# B2BSplitter v1.1 — Legacy Deployments
+
+## Overview
+
+v1.1 was the initial production version with immutable 1% protocol fee (100 bps) and 1 bps IP creator fee.
+
+**Status:** Superseded. Settlement disabled. Kept for historical reference and migration audits.
+
+## Chains
+
+| Chain | Splitter Address | Owner/Treasury | Verified |
+|-------|-----------------|----------------|----------|
+| Base | `0x8Ad9830D16b1f10333866a3f38C949CbB19f4BAD` | `0x1D5eF769A024B3157c76884fbd10302d8d83fAB9` | 2026-08-07 |
+| Unichain | `0xeE92807decAa3A02F1e165dd7Efcd92ab9aA83CB` | `0x1D5eF769A024B3157c76884fbd10302d8d83fAB9` | 2026-08-07 |
+
+## Runtime Code Hash
+
+```
+0x545b3a4ba195edc6b728df8cc64f28da528c9e7805c15f1aa61ef58c3c562197
+```
+
+## Fee Structure
+
+- `treasuryBps`: 100 (1%)
+- `ipCreatorBps`: 1
+- Merchant receives: 99% minus IP creator fee
+
+## Source
+
+Data sourced from `deployments/registry/reference/splitter-table.json` routes:
+- `base:legacy`
+- `unichain:legacy`

package/registry/splitter/evm/v1.1/deployments.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "",
+  "version": "1.1",
+  "description": "B2BSplitter v1.1 — Initial production version with immutable fee split",
+  "status": "superseded",
+  "settlementEnabled": false,
+  "build": {
+    "contract": "B2BSplitterV11",
+    "runtimeCodeHash": "0x545b3a4ba195edc6b728df8cc64f28da528c9e7805c15f1aa61ef58c3c562197"
+  },
+  "feeStructure": {
+    "treasuryBps": 100,
+    "ipCreatorBps": 1,
+    "description": "1% protocol fee + 0.01% IP creator fee; merchant receives remainder"
+  },
+  "deployments": [
+    {
+      "chain": "base",
+      "chainId": 8453,
+      "splitter": "0x8Ad9830D16b1f10333866a3f38C949CbB19f4BAD",
+      "owner": "0x1D5eF769A024B3157c76884fbd10302d8d83fAB9",
+      "treasury": "0x1D5eF769A024B3157c76884fbd10302d8d83fAB9",
+      "rpcQuorum": 2,
+      "verifiedAt": "2026-08-07",
+      "validFrom": "2026-08-04T00:00:00.000Z",
+      "validUntil": "2026-09-03T00:00:00.000Z"
+    },
+    {
+      "chain": "unichain",
+      "chainId": 130,
+      "splitter": "0xeE92807decAa3A02F1e165dd7Efcd92ab9aA83CB",
+      "owner": "0x1D5eF769A024B3157c76884fbd10302d8d83fAB9",
+      "treasury": "0x1D5eF769A024B3157c76884fbd10302d8d83fAB9",
+      "rpcQuorum": 2,
+      "verifiedAt": "2026-08-07",
+      "validFrom": "2026-08-04T00:00:00.000Z",
+      "validUntil": "2026-09-03T00:00:00.000Z"
+    }
+  ],
+  "sourceArtifact": {
+    "path": "../../reference/splitter-table.json",
+    "routes": ["base:legacy", "unichain:legacy"],
+    "retrievedAt": "2026-08-30"
+  }
+}

package/registry/splitter/evm/v1.2/README.md

@@ -0,0 +1,47 @@
+# B2BSplitter v1.2 — Legacy Deployments
+
+## Overview
+
+v1.2 added a `bytes32 paymentId` replay guard to prevent double-payment. The entrypoint was renamed from `payMatic` to `payNative` for native settlements.
+
+**Status:** Superseded. Settlement disabled. Kept for historical reference and migration audits.
+
+## Chains
+
+| Chain | Splitter Address | Owner/Treasury | Verified |
+|-------|-----------------|----------------|----------|
+| Polygon | `0xbD1fa5453f212F096c0213788a645eC597FB4DDe` | `0xD31d82c4b35DABaA2ad7023C89A78A052D1f3c8e` | 2026-08-07 |
+| Optimism | `0xF03B3387415D557b6ab709D06E8aF0b4ABD6Eb74` | `0x1D5eF769A024B3157c76884fbd10302d8d83fAB9` | 2026-08-07 |
+| BOT Chain | `0x147d8fF8c027E24303b5B99CbC8843e1D3dF94cC` | `0x1D5eF769A024B3157c76884fbd10302d8d83fAB9` | 2026-08-07 |
+| XRPL EVM | `0x147d8fF8c027E24303b5B99CbC8843e1D3dF94cC` | `0x1D5eF769A024B3157c76884fbd10302d8d83fAB9` | 2026-08-07 |
+
+**Note:** BOT Chain and XRPL EVM share the same address — same CREATE deployment (deployer + nonce) produces identical addresses on both chains.
+
+## Runtime Code Hashes
+
+| Chain | Code Hash |
+|-------|-----------|
+| Polygon | `0x9001fbb7ec70097909415325dc70c5b2102c4312dcd8e01e7495cfcaca2edaff` |
+| Optimism | `0xcdf939fd4f9a189e3dba991c5d538bd77b3d493d2ce4e356b61e5742dbde1899` |
+| BOT Chain | `0xabd084ff64e98bb8ac7db7783d80c6a6bcc69716dfb8f64a4686bed5cf428d96` |
+| XRPL EVM | `0xeb68cf314d335f888726a527dec10d989c26e2c5d6a8df68d117cc7d4dcec239` |
+
+## Fee Structure
+
+- `treasuryBps`: 100 (1%)
+- `ipCreatorBps`: 1
+- Merchant receives: 99% minus IP creator fee
+
+## Key Changes from v1.1
+
+1. Added `bytes32 paymentId` parameter to prevent replay attacks
+2. Renamed native entrypoint to `payNative`
+3. Deterministic paymentId derivation from order id: `keccak256(orderId)`
+
+## Source
+
+Data sourced from `deployments/registry/reference/splitter-table.json` routes:
+- `polygon:legacy`
+- `optimism:legacy`
+- `botchain:legacy`
+- `xrplevm:legacy`

package/registry/splitter/evm/v1.2/deployments.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "",
+  "version": "1.2",
+  "description": "B2BSplitter v1.2 — Added bytes32 paymentId replay guard",
+  "status": "superseded",
+  "settlementEnabled": false,
+  "build": {
+    "contract": "B2BSplitterV12"
+  },
+  "feeStructure": {
+    "treasuryBps": 100,
+    "ipCreatorBps": 1,
+    "description": "1% protocol fee + 0.01% IP creator fee; merchant receives remainder"
+  },
+  "changes": [
+    "Added bytes32 paymentId parameter to prevent replay attacks",
+    "Renamed native entrypoint from payMatic to payNative",
+    "Deterministic paymentId derivation: keccak256(orderId)"
+  ],
+  "deployments": [
+    {
+      "chain": "polygon",
+      "chainId": 137,
+      "splitter": "0xbD1fa5453f212F096c0213788a645eC597FB4DDe",
+      "owner": "0xD31d82c4b35DABaA2ad7023C89A78A052D1f3c8e",
+      "treasury": "0xD31d82c4b35DABaA2ad7023C89A78A052D1f3c8e",
+      "runtimeCodeHash": "0x9001fbb7ec70097909415325dc70c5b2102c4312dcd8e01e7495cfcaca2edaff",
+      "rpcQuorum": 2,
+      "verifiedAt": "2026-08-07",
+      "validFrom": "2026-08-04T00:00:00.000Z",
+      "validUntil": "2026-09-03T00:00:00.000Z"
+    },
+    {
+      "chain": "optimism",
+      "chainId": 10,
+      "splitter": "0xF03B3387415D557b6ab709D06E8aF0b4ABD6Eb74",
+      "owner": "0x1D5eF769A024B3157c76884fbd10302d8d83fAB9",
+      "treasury": "0x1D5eF769A024B3157c76884fbd10302d8d83fAB9",
+      "runtimeCodeHash": "0xcdf939fd4f9a189e3dba991c5d538bd77b3d493d2ce4e356b61e5742dbde1899",
+      "rpcQuorum": 2,
+      "verifiedAt": "2026-08-07",
+      "validFrom": "2026-08-04T00:00:00.000Z",
+      "validUntil": "2026-09-03T00:00:00.000Z"
+    },
+    {
+      "chain": "botchain",
+      "chainId": 677,
+      "splitter": "0x147d8fF8c027E24303b5B99CbC8843e1D3dF94cC",
+      "owner": "0x1D5eF769A024B3157c76884fbd10302d8d83fAB9",
+      "treasury": "0x1D5eF769A024B3157c76884fbd10302d8d83fAB9",
+      "runtimeCodeHash": "0xabd084ff64e98bb8ac7db7783d80c6a6bcc69716dfb8f64a4686bed5cf428d96",
+      "rpcQuorum": 1,
+      "verifiedAt": "2026-08-07",
+      "validFrom": "2026-08-04T00:00:00.000Z",
+      "validUntil": "2026-09-03T00:00:00.000Z"
+    },
+    {
+      "chain": "xrplevm",
+      "chainId": 1440000,
+      "splitter": "0x147d8fF8c027E24303b5B99CbC8843e1D3dF94cC",
+      "owner": "0x1D5eF769A024B3157c76884fbd10302d8d83fAB9",
+      "treasury": "0x1D5eF769A024B3157c76884fbd10302d8d83fAB9",
+      "runtimeCodeHash": "0xeb68cf314d335f888726a527dec10d989c26e2c5d6a8df68d117cc7d4dcec239",
+      "rpcQuorum": 1,
+      "verifiedAt": "2026-08-07",
+      "validFrom": "2026-08-04T00:00:00.000Z",
+      "validUntil": "2026-09-03T00:00:00.000Z",
+      "note": "Same address as BOT Chain (CREATE deployment with identical deployer + nonce)"
+    }
+  ],
+  "sourceArtifact": {
+    "path": "../../reference/splitter-table.json",
+    "routes": ["polygon:legacy", "optimism:legacy", "botchain:legacy", "xrplevm:legacy"],
+    "retrievedAt": "2026-08-30"
+  }
+}

package/registry/splitter/evm/v1.3/README.md

@@ -0,0 +1,78 @@
+# B2BSplitter v1.3 — Active Deployments
+
+## Overview
+
+v1.3 introduced **protocol routes** with immutable fee splits at construction. Two routes per chain:
+
+### Routes
+
+| Route | Treasury Bps | IP Creator Bps | Description |
+|-------|--------------|----------------|-------------|
+| `merchant-aifp1` | 100 (1%) | 0 | AIFP-1 gross-inclusive settlement. Agent pays quoted gross; treasury receives 1%, merchant receives 99%. |
+| `agent-x402` | 0 | 0 | AIFP-2/x402 negotiation. Provider receives 100% of quoted price; AiFinPay fee is 0% (future fee-on-top arrives in later version). |
+
+**Status:** Active. Policy window: 2026-08-27 to 2026-11-25. Settlement enabled only for Amoy testnet.
+
+## Chains and Addresses
+
+### merchant-aifp1 (100/0)
+
+| Chain | Splitter Address | USDC | Verified |
+|-------|-----------------|------|----------|
+| Polygon | `0x27C1C07563c92C1AEa52cC9b4452dF49dC5a7942` | `0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359` | 2026-08-27 |
+| Optimism | `0x1Fe2021336596655Fac72bC7bC40F7FFFA501d55` | `0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85` | 2026-08-27 |
+| BNB | `0x79D481B835Cb050FAb7a045E619A6Fb9Cd73f510` | — | 2026-08-27 |
+| Unichain | `0xF03B3387415D557b6ab709D06E8aF0b4ABD6Eb74` | `0x078D782b760474a361dDA0AF3839290b0EF57AD6` | 2026-08-27 |
+| BOT Chain | `0xe855e491D0950140704DB9Cec6B7b3F725360a56` | — | 2026-08-27 |
+| Base | `0xB385Cc32fe39CF5B5778DF0Df0e8E9978b5F662a` | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` | 2026-08-27 |
+| Arbitrum | `0x80e2B445DFc44B3B2254aa376B31AEdDd3Ff934a` | `0xaf88d065e77c8cC2239327C5EDb3A432268e5831` | 2026-08-27 |
+| Avalanche | `0xE34Fc0E6694821c600Fa0955C0F74720ea6d8440` | `0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E` | 2026-08-27 |
+| XRPL EVM | `0xe855e491D0950140704DB9Cec6B7b3F725360a56` | — | 2026-08-27 |
+| Amoy (testnet) | `0xdB772E64F63854bf31f2366BF27e47D5699fe7fC` | `0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582` | 2026-08-29 |
+
+### agent-x402 (0/0)
+
+| Chain | Splitter Address | USDC | Verified |
+|-------|-----------------|------|----------|
+| Polygon | `0x660Cd915Fc54A7EaE5CEA6854505638bd2A08531` | `0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359` | 2026-08-27 |
+| Optimism | `0x38Ef6173ce0AC540f129680C2Aa4Ef739787bdBf` | `0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85` | 2026-08-27 |
+| BNB | `0x7656fb8B6627311A7d87273913D31b837Bb2b5A4` | — | 2026-08-27 |
+| Unichain | `0xC701F45b3Bae9CA3a58cB33fCBA6291594D17843` | `0x078D782b760474a361dDA0AF3839290b0EF57AD6` | 2026-08-27 |
+| BOT Chain | `0x7E92FbE28aAc3a3942FDf019d29172bd02c96Cf0` | — | 2026-08-27 |
+| Base | `0x1Fe2021336596655Fac72bC7bC40F7FFFA501d55` | `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913` | 2026-08-27 |
+| Arbitrum | `0xE34Fc0E6694821c600Fa0955C0F74720ea6d8440` | `0xaf88d065e77c8cC2239327C5EDb3A432268e5831` | 2026-08-27 |
+| Avalanche | `0xF03B3387415D557b6ab709D06E8aF0b4ABD6Eb74` | `0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E` | 2026-08-27 |
+| XRPL EVM | `0x7E92FbE28aAc3a3942FDf019d29172bd02c96Cf0` | — | 2026-08-27 |
+| Amoy (testnet) | `0xFd1622847A89FB3De240d64DFCbd09C65c77D99d` | `0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582` | 2026-08-30 |
+
+## Address Collisions (Important!)
+
+Same address, different routes/chains — **selection must use chain + route**, never address alone:
+
+| Address | Routes |
+|---------|--------|
+| `0x1Fe2021336596655Fac72bC7bC40F7FFFA501d55` | Optimism `merchant-aifp1`, Base `agent-x402` |
+| `0xF03B3387415D557b6ab709D06E8aF0b4ABD6Eb74` | Unichain `merchant-aifp1`, Avalanche `agent-x402`, Optimism v1.2 legacy |
+| `0xE34Fc0E6694821c600Fa0955C0F74720ea6d8440` | Arbitrum `agent-x402`, Avalanche `merchant-aifp1` |
+| `0xe855e491D0950140704DB9Cec6B7b3F725360a56` | BOT Chain `merchant-aifp1`, XRPL EVM `merchant-aifp1` |
+| `0x7E92FbE28aAc3a3942FDf019d29172bd02c96Cf0` | BOT Chain `agent-x402`, XRPL EVM `agent-x402` |
+
+## Governance
+
+- **Safe:** `0xFd936f75D9221949f2FEaB54Cd342F7527154eD5`
+- **Threshold:** 3 of 5
+- **Owners:**
+  - `0x2118c57dEBD53f614DDfE464Ff2941BE6646cA82`
+  - `0x3C31dd9daCeC5473cC9B660CD69247A20701cF19`
+  - `0x25A834b6fEC79e9ee6ED04Ef5b97440149C6Cc24`
+  - `0x1D5eF769A024B3157c76884fbd10302d8d83fAB9`
+  - `0x849930eB20ED0a697c71BcE565f18702D202C0F8`
+
+## Runtime Code Hashes
+
+- `merchant-aifp1`: `0x4ba01815b55bf6ed2d608bed91f480c179fd644d706680c3e4a91d8181ba5c6b`
+- `agent-x402`: `0x0eb0f8ca7792b13ab70f2aa3e779609cd352d279e925ddcd9e901fd9fd68b1b0`
+
+## Source
+
+Data sourced from `deployments/registry/reference/splitter-table.json` routes (all non-legacy entries).