@aifinpay/deployments 1.1.3 → 2.1.0

package/registry/splitter/INDEX.md

@@ -1,163 +1,59 @@
 # 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
+Versioned deployment records and interface artifacts. Registry values are recorded
+inputs to verification, not evidence of current runtime or backend availability.
+
+## Registry lookup
+
+| Registry | Machine-readable records | Guide |
+|----------|--------------------------|-------|
+| EVM v1.1 | [deployments.json](evm/v1.1/deployments.json) | [Legacy interface](evm/v1.1/README.md) |
+| EVM v1.2 | [deployments.json](evm/v1.2/deployments.json) | [Replay guard](evm/v1.2/README.md) |
+| EVM v1.3 | [deployments.json](evm/v1.3/deployments.json) | [Protocol routes](evm/v1.3/README.md) |
+| EVM v1.4 | [deployments.json](evm/v1.4/deployments.json) | [Contract suite](evm/v1.4/README.md) |
+| Solana | [deployments.json](solana/deployments.json) | [Program and IDL](solana/README.md) |
+| Casper | [deployments.json](casper/deployments.json) | [Contract schema](casper/README.md) |
+
+Read the selected record for chain/network identity, addresses or program IDs,
+runtime hashes, governance, assets, policy fields and settlement flags. Read
+`source`, `sourceArtifact` and `generatedAt` where present for provenance;
+do not infer provenance from the age of this guide.
+
+## Querying records
+
+Use [AifinpayRegistry](../../src/registry.ts) and the
+[usage guide](../../USAGE.md) for lookups and generated exports. A registry query
+does not perform live verification. For v1.3, select the raw record by chain
+**and** `_route`; the chain-keyed registry API cannot distinguish multiple routes
+on the same chain.
+
+## Refreshing and testing
+
+The [grabber](../../src/grabber.ts) and [build CLI](../../src/build.ts) define
+upstream selection and generated output locations. From `deployments/`:
+
+```bash
+npm run build
+npm test
+# Explicit maintenance operation: fetches upstream and rewrites registry outputs.
+npm run registry:build
 ```
 
-## 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
+These commands build, test or refresh records; none proves live settlement.
+Review upstream provenance and resulting JSON changes before adopting refreshed
+records. The grabber does not regenerate the v1.3 route snapshot; preserve its
+provenance when maintaining it. See the [package rules](../../AGENTS.md).
 
-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
+For downstream SDK generation, see
+[the generator](../../../node/scripts/generate-splitter-routes.mjs).
+Run `npm run registry:check` from `node/` to check generated files against the
+installed deployment package. This is an offline consistency check, not runtime
+or backend verification.
 
-## Security Notes
+## Interface artifacts
 
-- **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.
+- [Payment deployment JSON Schema](../../src/reference/payment-deployments.schema.json)
+- [EVM ABI bundles](../abi/evm/)
+- [Solana IDL copies](../idl/solana/splitter-v14/)
+- [Casper contract schema](../idl/casper/aifinpay-casper-schema.json)
+- [Artifact loading implementation](../../src/artifacts.ts)

package/registry/splitter/casper/README.md

@@ -1,101 +1,10 @@
-# Casper Splitter v1 — Contract Deployments
+# Casper Splitter — Contract Registry
 
-## Overview
+## Deployment lookup
 
-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.
+Casper deployments use a contract hash and contract schema rather than an EVM contract suite. Read [deployments.json](deployments.json) for network, environment, contract hash, schema metadata and settlement flag.
 
-**Status:** Live on Casper testnet. Mainnet v1 is historical (payment recording only, no atomic transfer).
+## Supports
 
-## 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
-```
+Current network was deprecated and removed from AiFinPay SDK v1.4. The Casper Splitter contract is no longer supported for settlement.
+Deployment records are retained for historical reference and verification of past transactions. Do not attempt to use these records for new settlements.

package/registry/splitter/casper/deployments.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "",
+  "$schema": "../../../src/reference/payment-deployments.schema.json",
   "version": "2.0",
   "description": "Casper Splitter — Rust → Wasm settlement contract for AI agent payments",
   "schemaVersion": 2,
@@ -54,8 +54,7 @@
       "network": "casper-test",
       "environment": "testnet",
       "testnet": true,
-      "status": "live",
-      "settlementEnabled": true,
+      "settlementEnabled": false,
       "contractPackageHash": "hash-47df409829ddf0612617460293ba591a19b26fa0c06918878204088d3eb9b78a",
       "rpcEndpoint": "https://node.testnet.casper.network/rpc",
       "explorer": "https://testnet.cspr.live/contract/47df409829ddf0612617460293ba591a19b26fa0c06918878204088d3eb9b78a",
@@ -84,7 +83,6 @@
       "network": "casper",
       "environment": "mainnet",
       "testnet": false,
-      "status": "historical",
       "settlementEnabled": false,
       "contractHash": "contract-9903a5e3948e799196df54b17270bc6769338ac1cc36c9eb47e113f88d23f019",
       "contractPackageHash": "hash-7ad34a204952eef63d5dcf5159fb7d009e85dea4f49cbdf73dde190652dfa375",
@@ -92,7 +90,6 @@
       "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."
     }
   ],

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

@@ -2,31 +2,26 @@
 
 ## Overview
 
-v1.1 was the initial production version with immutable 1% protocol fee (100 bps) and 1 bps IP creator fee.
+Legacy contract records are retained for reference and migration audits.
+Read [deployments.json](deployments.json) for chain/address, owner/treasury,
+runtime hash, fee and settlement fields. Inspect its provenance metadata instead
+of relying on copied verification dates.
 
-**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
+## Legacy fee structure
 
 - `treasuryBps`: 100 (1%)
 - `ipCreatorBps`: 1
 - Merchant receives: 99% minus IP creator fee
 
-## Source
+These describe the legacy interface, not authorization to use it for a new
+payment or a replacement for the selected record's economics.
+
+## Verification
+
+Compare the selected chain/version record with live runtime code and mutable
+owner/treasury state. Check actual registry gates and backend receipt-verification
+behavior; a historical record does not prove current availability. Disabled
+records must not settle.
 
-Data sourced from `deployments/registry/reference/splitter-table.json` routes:
-- `base:legacy`
-- `unichain:legacy`
+See the [registry verification checklist](../../INDEX.md) and
+[route selection guards](../../../../../node/src/splitterRoutes.ts).

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

@@ -1,5 +1,5 @@
 {
-  "$schema": "./reference/payment-deployments.schema.json",
+  "$schema": "../../../../src/reference/payment-deployments.schema.json",
   "version": "1.1",
   "description": "B2BSplitter v1.1 — Initial production version with immutable fee split",
   "schemaVersion": 1,
@@ -41,7 +41,6 @@
       "chainId": 8453,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x545b3a4ba195edc6b728df8cc64f28da528c9e7805c15f1aa61ef58c3c562197",
       "contracts": {
@@ -65,7 +64,6 @@
       "chainId": 130,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x545b3a4ba195edc6b728df8cc64f28da528c9e7805c15f1aa61ef58c3c562197",
       "contracts": {

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

@@ -1,47 +1,34 @@
 # B2BSplitter v1.2 — Legacy Deployments
 
-## Overview
+## Interface and migration
 
-v1.2 added a `bytes32 paymentId` replay guard to prevent double-payment. The entrypoint was renamed from `payMatic` to `payNative` for native settlements.
+v1.2 added a `bytes32 paymentId` replay guard to prevent double-payment.
+The native-settlement entrypoint was renamed from `payMatic` to `payNative`.
+Payment IDs can be derived deterministically from an order ID using
+`keccak256(orderId)`.
 
-**Status:** Superseded. Settlement disabled. Kept for historical reference and migration audits.
+Use [deployments.json](deployments.json) for historical chain/address,
+owner/treasury, runtime hash, fee and settlement records. Read its provenance
+fields rather than relying on copied verification dates.
 
-## 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
+## Legacy fee structure
 
 - `treasuryBps`: 100 (1%)
 - `ipCreatorBps`: 1
 - Merchant receives: 99% minus IP creator fee
 
-## Key Changes from v1.1
+These describe the legacy interface, not authorization to use it for a new
+payment or a replacement for the selected record's economics.
+
+## Verification
 
-1. Added `bytes32 paymentId` parameter to prevent replay attacks
-2. Renamed native entrypoint to `payNative`
-3. Deterministic paymentId derivation from order id: `keccak256(orderId)`
+Select by chain and version, never address alone; matching addresses on different
+chains do not imply matching runtime code or governance.
 
-## Source
+For migration audits, compare the actual record with live runtime code and
+mutable owner/treasury state. Check settlement fields and the actual backend's
+receipt verification before considering any settlement. A registry entry is
+not proof of activation, and settlement-disabled records must not settle.
 
-Data sourced from `deployments/registry/reference/splitter-table.json` routes:
-- `polygon:legacy`
-- `optimism:legacy`
-- `botchain:legacy`
-- `xrplevm:legacy`
+See the [registry verification checklist](../../INDEX.md) and
+[route selection guards](../../../../../node/src/splitterRoutes.ts).

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

@@ -1,5 +1,5 @@
 {
-  "$schema": "./reference/payment-deployments.schema.json",
+  "$schema": "../../../../src/reference/payment-deployments.schema.json",
   "version": "1.2",
   "description": "B2BSplitter v1.2 — Added bytes32 paymentId replay guard",
   "schemaVersion": 1,
@@ -41,7 +41,6 @@
       "chainId": 137,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x9001fbb7ec70097909415325dc70c5b2102c4312dcd8e01e7495cfcaca2edaff",
       "contracts": {
@@ -65,7 +64,6 @@
       "chainId": 10,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0xcdf939fd4f9a189e3dba991c5d538bd77b3d493d2ce4e356b61e5742dbde1899",
       "contracts": {
@@ -89,7 +87,6 @@
       "chainId": 677,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0xabd084ff64e98bb8ac7db7783d80c6a6bcc69716dfb8f64a4686bed5cf428d96",
       "contracts": {
@@ -113,7 +110,6 @@
       "chainId": 1440000,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0xeb68cf314d335f888726a527dec10d989c26e2c5d6a8df68d117cc7d4dcec239",
       "contracts": {

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

@@ -1,78 +1,40 @@
-# B2BSplitter v1.3 — Active Deployments
+# B2BSplitter v1.3 — Protocol Route Registry
 
-## Overview
+## Routes
 
-v1.3 introduced **protocol routes** with immutable fee splits at construction. Two routes per chain:
-
-### Routes
+v1.3 introduced protocol routes with immutable fee splits at construction.
 
 | 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:
+| `agent-x402` | 0 | 0 | AIFP-2/x402 negotiation. Provider receives 100% of quoted price; AiFinPay fee is 0%. |
 
-| 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` |
+## Deployment lookup
 
-## Governance
+Read [deployments.json](deployments.json) for addresses, assets, runtime hashes,
+governance and settlement metadata. Select records using
+`chainId` and `_route`, never address alone. The same address can occur on
+different chains or routes with different economics.
 
-- **Safe:** `0xFd936f75D9221949f2FEaB54Cd342F7527154eD5`
-- **Threshold:** 3 of 5
-- **Owners:**
-  - `0x2118c57dEBD53f614DDfE464Ff2941BE6646cA82`
-  - `0x3C31dd9daCeC5473cC9B660CD69247A20701cF19`
-  - `0x25A834b6fEC79e9ee6ED04Ef5b97440149C6Cc24`
-  - `0x1D5eF769A024B3157c76884fbd10302d8d83fAB9`
-  - `0x849930eB20ED0a697c71BcE565f18702D202C0F8`
+Do not use a chain-only lookup to select between v1.3 routes:
+[AifinpayRegistry](../../../../src/registry.ts) keys its EVM map by chain ID.
+The SDK's [route resolution code](../../../../../node/src/splitterRoutes.ts)
+defines route-specific lookup and policy checks.
 
-## Runtime Code Hashes
+## Verification and provenance
 
-- `merchant-aifp1`: `0x4ba01815b55bf6ed2d608bed91f480c179fd644d706680c3e4a91d8181ba5c6b`
-- `agent-x402`: `0x0eb0f8ca7792b13ab70f2aa3e779609cd352d279e925ddcd9e901fd9fd68b1b0`
+Inspect the actual selected registry record and the consumed route table's
+`validFrom`/`validUntil` policy before settlement. Compare deployed runtime code,
+mutable owner/treasury and route economics with the expected values, and obtain
+fresh backend receipt-verification and end-to-end settlement evidence.
 
-## Source
+See the [verification checklist](../../INDEX.md). Registry metadata and policy
+dates do not establish current availability; settlement-disabled or
+out-of-window routes must not settle.
 
-Data sourced from `deployments/registry/reference/splitter-table.json` routes (all non-legacy entries).
+Read `source`, `sourceArtifact` and `generatedAt` in the JSON for recorded
+provenance. This route snapshot is not regenerated by the
+[grabber](../../../../src/grabber.ts). Downstream generation is implemented in
+[generate-splitter-routes.mjs](../../../../../node/scripts/generate-splitter-routes.mjs);
+from `node/`, `npm run registry:check` checks consistency with the installed
+deployment package, not live verification.