@aifinpay/deployments 1.1.4 → 2.1.0

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

@@ -1,5 +1,5 @@
 {
-  "$schema": "./reference/payment-deployments.schema.json",
+  "$schema": "../../../../src/reference/payment-deployments.schema.json",
   "version": "1.3",
   "description": "B2BSplitter v1.3 — Protocol routes with immutable fee splits",
   "schemaVersion": 1,
@@ -42,8 +42,7 @@
       "chainId": 80002,
       "environment": "dev",
       "testnet": true,
-      "status": "retired",
-      "settlementEnabled": true,
+      "settlementEnabled": false,
       "runtimeCodeHash": "0x4ba01815b55bf6ed2d608bed91f480c179fd644d706680c3e4a91d8181ba5c6b",
       "contracts": {
         "splitter": "0xdB772E64F63854bf31f2366BF27e47D5699fe7fC",
@@ -74,8 +73,7 @@
       "chainId": 80002,
       "environment": "dev",
       "testnet": true,
-      "status": "retired",
-      "settlementEnabled": true,
+      "settlementEnabled": false,
       "runtimeCodeHash": "0x0eb0f8ca7792b13ab70f2aa3e779609cd352d279e925ddcd9e901fd9fd68b1b0",
       "contracts": {
         "splitter": "0xFd1622847A89FB3De240d64DFCbd09C65c77D99d",
@@ -106,7 +104,6 @@
       "chainId": 137,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x4ba01815b55bf6ed2d608bed91f480c179fd644d706680c3e4a91d8181ba5c6b",
       "contracts": {
@@ -138,7 +135,6 @@
       "chainId": 137,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x0eb0f8ca7792b13ab70f2aa3e779609cd352d279e925ddcd9e901fd9fd68b1b0",
       "contracts": {
@@ -170,7 +166,6 @@
       "chainId": 10,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x4ba01815b55bf6ed2d608bed91f480c179fd644d706680c3e4a91d8181ba5c6b",
       "contracts": {
@@ -202,7 +197,6 @@
       "chainId": 10,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x0eb0f8ca7792b13ab70f2aa3e779609cd352d279e925ddcd9e901fd9fd68b1b0",
       "contracts": {
@@ -234,7 +228,6 @@
       "chainId": 56,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x4ba01815b55bf6ed2d608bed91f480c179fd644d706680c3e4a91d8181ba5c6b",
       "contracts": {
@@ -260,7 +253,6 @@
       "chainId": 56,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x0eb0f8ca7792b13ab70f2aa3e779609cd352d279e925ddcd9e901fd9fd68b1b0",
       "contracts": {
@@ -286,7 +278,6 @@
       "chainId": 130,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x4ba01815b55bf6ed2d608bed91f480c179fd644d706680c3e4a91d8181ba5c6b",
       "contracts": {
@@ -318,7 +309,6 @@
       "chainId": 130,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x0eb0f8ca7792b13ab70f2aa3e779609cd352d279e925ddcd9e901fd9fd68b1b0",
       "contracts": {
@@ -350,7 +340,6 @@
       "chainId": 677,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x4ba01815b55bf6ed2d608bed91f480c179fd644d706680c3e4a91d8181ba5c6b",
       "contracts": {
@@ -376,7 +365,6 @@
       "chainId": 677,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x0eb0f8ca7792b13ab70f2aa3e779609cd352d279e925ddcd9e901fd9fd68b1b0",
       "contracts": {
@@ -402,7 +390,6 @@
       "chainId": 8453,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x4ba01815b55bf6ed2d608bed91f480c179fd644d706680c3e4a91d8181ba5c6b",
       "contracts": {
@@ -434,7 +421,6 @@
       "chainId": 8453,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x0eb0f8ca7792b13ab70f2aa3e779609cd352d279e925ddcd9e901fd9fd68b1b0",
       "contracts": {
@@ -466,7 +452,6 @@
       "chainId": 42161,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x4ba01815b55bf6ed2d608bed91f480c179fd644d706680c3e4a91d8181ba5c6b",
       "contracts": {
@@ -498,7 +483,6 @@
       "chainId": 42161,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x0eb0f8ca7792b13ab70f2aa3e779609cd352d279e925ddcd9e901fd9fd68b1b0",
       "contracts": {
@@ -530,7 +514,6 @@
       "chainId": 43114,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x4ba01815b55bf6ed2d608bed91f480c179fd644d706680c3e4a91d8181ba5c6b",
       "contracts": {
@@ -567,7 +550,6 @@
       "chainId": 43114,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x0eb0f8ca7792b13ab70f2aa3e779609cd352d279e925ddcd9e901fd9fd68b1b0",
       "contracts": {
@@ -604,7 +586,6 @@
       "chainId": 1440000,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x4ba01815b55bf6ed2d608bed91f480c179fd644d706680c3e4a91d8181ba5c6b",
       "contracts": {
@@ -630,7 +611,6 @@
       "chainId": 1440000,
       "environment": "prod",
       "testnet": false,
-      "status": "retired",
       "settlementEnabled": false,
       "runtimeCodeHash": "0x0eb0f8ca7792b13ab70f2aa3e779609cd352d279e925ddcd9e901fd9fd68b1b0",
       "contracts": {

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

@@ -1,10 +1,9 @@
-# B2BSplitter v1.4 — Full Contract Suite Deployments
+# B2BSplitter v1.4 — Contract Suite Registry
 
-## Overview
+## Contract roles
 
-v1.4 is a **complete protocol deployment** — not just a splitter contract, but a full suite of contracts working together:
+The v1.4 registry describes a contract suite:
 
-**Contracts:**
 - `splitter` — Payment settlement
 - `tokenList` — Allowed assets
 - `profiles` — Agent/merchant identity profiles
@@ -13,63 +12,34 @@ v1.4 is a **complete protocol deployment** — not just a splitter contract, but
 - `pauser` — Emergency pause control
 - `treasury` — Fee recipient
 
-**Status:** Mostly disabled. Only Amoy (testnet) is enabled. Production deployments await backend v1.4 receipt verification and end-to-end settlement gate completion.
+## Deployment and governance lookup
 
-## Deployments
+Read [deployments.json](deployments.json) for each chain's contract addresses,
+asset list, `runtimeCodeHash`, `settlementEnabled` and Safe metadata. Inspect
+both top-level `governance` and per-deployment `safe` and `contracts` fields
+rather than assuming all chains share a Safe.
 
-| Network | Chain ID | Splitter | Status | Reason |
-|---------|----------|----------|--------|--------|
-| Amoy (testnet) | 80002 | `0xBdC126193FADf38A86Cd509e56018a95d5B6eeFA` | ✅ **enabled** | — |
-| Polygon | 137 | `0x78bed24B8D3A5eB2cf8D9A0D6A9Da6Bc5d7f32eB` | ❌ disabled | Backend verification incomplete |
-| Arbitrum | 42161 | `0x78bed24B8D3A5eB2cf8D9A0D6A9Da6Bc5d7f32eB` | ❌ disabled | Backend verification incomplete |
-| Avalanche | 43114 | `0x78bed24B8D3A5eB2cf8D9A0D6A9Da6Bc5d7f32eB` | ❌ disabled | Backend verification incomplete |
-| BNB | 56 | `0x78bed24B8D3A5eB2cf8D9A0D6A9Da6Bc5d7f32eB` | ❌ disabled | Backend verification incomplete |
-| Base | 8453 | `0xbA98C0797707611787B04680E260036573D9D7a1` | ⚠️ **invalid** | Splitter address equals TokenList; Profiles has no code |
-| Optimism | 10 | `0x78bed24B8D3A5eB2cf8D9A0D6A9Da6Bc5d7f32eB` | ❌ disabled | Backend verification incomplete |
-| Unichain | 130 | `0x78bed24B8D3A5eB2cf8D9A0D6A9Da6Bc5d7f32eB` | ❌ disabled | Backend verification incomplete |
-| XRPL EVM | 1440000 | `0x78bed24B8D3A5eB2cf8D9A0D6A9Da6Bc5d7f32eB` | ❌ disabled | No stablecoin configured |
-| Robinhood | 4663 | `0x78bed24B8D3A5eB2cf8D9A0D6A9Da6Bc5d7f32eB` | ❌ disabled | TokenList empty; USDe/USDG need allowlisting |
+The registry's `source`, `sourceArtifact` and `generatedAt` fields carry recorded
+provenance. Generation is implemented by the [grabber](../../../../src/grabber.ts)
+and [build CLI](../../../../src/build.ts); run `npm run build` followed by
+`npm run registry:build` from `deployments/` only when intentionally refreshing
+these artifacts.
 
-## Key Differences from v1.3
+## Verification
 
-| Feature | v1.3 | v1.4 |
-|---------|------|------|
-| Contracts | Splitter only | Full suite (7 contracts) |
-| Routes | `merchant-aifp1` / `agent-x402` | Single deployment per chain |
-| Governance | Safe (5 owners) | Safe (4 owners, different addresses) |
-| Status | Policy window (`validFrom`/`validUntil`) | `enabled`/`disabled`/`invalid` with reason |
-| Assets | USDC per route | Full asset list per deployment |
+Settlement flags are not fresh runtime/backend evidence. Before settlement,
+check the actual selected record and obtain live evidence for
+contract bytecode, configured signer, governance, treasury, allowed assets and
+backend receipt verification. Do not treat a listed address or ABI as proof of
+availability.
 
-## Governance (v1.4)
+See [SDK preflight and execution checks](../../../../../node/src/settlementV14.ts)
+and the [registry verification checklist](../../INDEX.md). Keep disabled,
+invalid, testnet and policy gates intact; this guide does not authorize
+activation.
 
-Most production chains use the same Safe:
+## Interface
 
-- **Safe:** `0x5AFe07483886DFa0B77C6d60212B6E52D78ac11e`
-- **Version:** 1.5.0
-- **Threshold:** 3 of 4
-- **Owners:**
-  - `0x25A834b6fEC79e9ee6ED04Ef5b97440149C6Cc24`
-  - `0x2118c57dEBD53f614DDfE464Ff2941BE6646cA82`
-  - `0x3C31dd9daCeC5473cC9B660CD69247A20701cF19`
-  - `0x588A80e94a762C670711ff77CC60a2e65E64F53A`
-
-**Amoy (testnet) has a separate Safe:**
-- **Safe:** `0xc9ab36c2af2888414c7ea9160d9e33b773c2b388`
-- **Version:** 1.4.1
-
-## Runtime Code Hashes
-
-| Network | Code Hash |
-|---------|-----------|
-| Amoy | `0xd4990487312c00916aa218bdcd697bbf1a2729335b6a4fda903517b9d3153a27` |
-| Polygon/Arbitrum/Avalanche/BNB/Optimism/Unichain/XRPL | `0x974b871ac79082d92a7e3bba89ba52794f7906f99119dfad7959017e5b0bf038` (varies by chain) |
-| Base | `0xc724e02657817177d1394e8d41189dd7f8299bb5cf2da04946572378c935883c` |
-| Robinhood | `0x96812eb70224f48c095b240bc0e1d739a7fcb878c3237b5f795629c239d7ef72` |
-
-## Source
-
-Data sourced from `../../../evm-splitter-v1.4.json`, generated by `npm run registry:build` from upstream `AiFinPay/evm-contract/deployments/*-v14-*-latest.json`.
-
-**Last generated:** 2026-09-13
-
-**Upstream commit:** `a54a4c107de7bb42f54e411e621d3897938bfc31`
+- [Splitter ABI](../../../abi/evm/B2BSplitterV14/B2BSplitterV14.json)
+- [Timelock ABI](../../../abi/evm/TimelockWrapper/TimelockWrapper.json)
+- [Registry types](../../../../src/types.ts)

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

@@ -1,5 +1,5 @@
 {
-  "$schema": "./reference/payment-deployments.schema.json",
+  "$schema": "../../../../src/reference/payment-deployments.schema.json",
   "version": "1.4",
   "description": "B2BSplitter v1.4 — Full contract suite deployment",
   "schemaVersion": 1,
@@ -42,7 +42,6 @@
       "chainId": 10,
       "environment": "prod",
       "testnet": false,
-      "status": "enabled",
       "settlementEnabled": true,
       "runtimeCodeHash": "0x5a2d0ffb996d5655fa483e41d3e5870c6a032fd00bea71c3107f95a4b405e152",
       "contracts": {
@@ -78,7 +77,6 @@
       "chainId": 56,
       "environment": "prod",
       "testnet": false,
-      "status": "enabled",
       "settlementEnabled": true,
       "runtimeCodeHash": "0x8aa8c5999a1a0ee87198e380188faaa9d6df88819b47d68682096cc33db81638",
       "contracts": {
@@ -119,7 +117,6 @@
       "chainId": 130,
       "environment": "prod",
       "testnet": false,
-      "status": "enabled",
       "settlementEnabled": true,
       "runtimeCodeHash": "0xcb4f1c15a87720c326daa574a7ab52c116c208805167b46dd055f47c9c8695ca",
       "contracts": {
@@ -155,7 +152,6 @@
       "chainId": 137,
       "environment": "prod",
       "testnet": false,
-      "status": "enabled",
       "settlementEnabled": true,
       "runtimeCodeHash": "0x974b871ac79082d92a7e3bba89ba52794f7906f99119dfad7959017e5b0bf038",
       "contracts": {
@@ -201,9 +197,7 @@
       "chainId": 677,
       "environment": "prod",
       "testnet": false,
-      "status": "disabled",
-      "settlementEnabled": false,
-      "disabledReason": "Backend v1.4 receipt verification and end-to-end settlement gate are incomplete",
+      "settlementEnabled": true,
       "runtimeCodeHash": "0x3b8b3833842bf0fefac1b02f9e1d4494f74e9338b15d62725739050b347d3f25",
       "contracts": {
         "splitter": "0x78bed24B8D3A5eB2cf8D9A0D6A9Da6Bc5d7f32eB",
@@ -238,7 +232,6 @@
       "chainId": 4663,
       "environment": "prod",
       "testnet": false,
-      "status": "enabled",
       "settlementEnabled": true,
       "runtimeCodeHash": "0x96812eb70224f48c095b240bc0e1d739a7fcb878c3237b5f795629c239d7ef72",
       "contracts": {
@@ -279,9 +272,7 @@
       "chainId": 5042,
       "environment": "prod",
       "testnet": false,
-      "status": "disabled",
-      "settlementEnabled": false,
-      "disabledReason": "Backend v1.4 receipt verification and end-to-end settlement gate are incomplete",
+      "settlementEnabled": true,
       "runtimeCodeHash": "0x8d5cda7c85169c4ad6e0cf3a08ba51994391de087d5223ab8723cc324d52c423",
       "contracts": {
         "splitter": "0x78bed24B8D3A5eB2cf8D9A0D6A9Da6Bc5d7f32eB",
@@ -321,7 +312,6 @@
       "chainId": 8453,
       "environment": "prod",
       "testnet": false,
-      "status": "enabled",
       "settlementEnabled": true,
       "runtimeCodeHash": "0xf8438af51b0197b13e1f9abe9b5d193d559e1827384db6e3285f65784d693905",
       "contracts": {
@@ -357,7 +347,6 @@
       "chainId": 42161,
       "environment": "prod",
       "testnet": false,
-      "status": "enabled",
       "settlementEnabled": true,
       "runtimeCodeHash": "0xc15837e6f438d0fd2f23e0c5eb7a2f655b2af7dc717bd2861365819de45757f7",
       "contracts": {
@@ -393,7 +382,6 @@
       "chainId": 43114,
       "environment": "prod",
       "testnet": false,
-      "status": "enabled",
       "settlementEnabled": true,
       "runtimeCodeHash": "0x65db1830b1d15400cba35b4ef54dd6c5852d5baa077a732bdc84f7c2218952ef",
       "contracts": {
@@ -434,7 +422,6 @@
       "chainId": 80002,
       "environment": "dev",
       "testnet": true,
-      "status": "enabled",
       "settlementEnabled": true,
       "runtimeCodeHash": "0xd4990487312c00916aa218bdcd697bbf1a2729335b6a4fda903517b9d3153a27",
       "contracts": {
@@ -470,7 +457,6 @@
       "chainId": 1440000,
       "environment": "prod",
       "testnet": false,
-      "status": "enabled",
       "settlementEnabled": true,
       "runtimeCodeHash": "0xd26862dbc501481675f50924ca013acd5c20aca339f2a1aca818becedf7b5aa0",
       "contracts": {
@@ -500,7 +486,6 @@
       "chainId": 5042002,
       "environment": "dev",
       "testnet": true,
-      "status": "enabled",
       "settlementEnabled": true,
       "runtimeCodeHash": "0x2605a351c5595aafabbb9064b2b842fb5db9eb8fdf00a62a66f02b43c46b698b",
       "contracts": {

package/registry/splitter/solana/README.md

@@ -1,49 +1,36 @@
-# Solana Splitter v1.4 — Program Deployments
+# Solana Splitter v1.4 — Program Registry
 
-## Overview
+## Deployment lookup
 
-Solana v1.4.1 splitter program — non-EVM deployment with different architecture (program ID + IDL instead of contract suite).
+Solana deployments use a program ID and IDL rather than an EVM contract suite.
+Read [deployments.json](deployments.json) for cluster, environment, program ID,
+IDL metadata and settlement flag. Inspect the actual registry and obtain live
+program/runtime and backend receipt-verification evidence. Never infer
+activation from the presence of a program ID or IDL.
 
-**Status:** Disabled. Backend Solana receipt verification is not implemented.
+## Verification
 
-## Deployments
+Use the [deployment resolver](../../../../node/src/solanaDeploymentResolver.ts)
+and [settlement checks](../../../../node/src/settlementSolanaV14.ts) to understand
+SDK gating and transaction validation. Before settlement, verify the executable
+program, ProgramData, upgrade authority, configuration, selected asset and
+receipt binding for the selected cluster. Fresh backend and end-to-end evidence
+is also required; source code alone does not prove deployment availability.
 
-| Network | Environment | Program ID | Status | Reason |
-|---------|-------------|------------|--------|--------|
-| Devnet | dev | `8dty5bD738Z9TzEkDu8vLSnhpJNWtEGMUEcYaKCUTY6y` | ❌ disabled | Backend receipt verification not implemented |
-| Mainnet | prod | `724Ut31i43ecY4dJ25z8HuZetu3A43xtNkPdk4JdbsfdD` | ❌ disabled | Receipt verification + upgrade authority not multisig |
+See the [registry verification checklist](../INDEX.md). This guide grants no
+production activation or availability-bypass authority.
 
-## IDL (Interface Definition Language)
+## IDL files
 
-Both deployments use the same IDL:
+- [Devnet IDL](../../idl/solana/splitter-v14/splitter.devnet.json)
+- [Mainnet IDL](../../idl/solana/splitter-v14/splitter.mainnet.json)
 
-```json
-{
-  "name": "splitter",
-  "version": "1.4.1"
-}
-```
+Read each IDL's metadata rather than assuming interface versions are identical.
 
-## Key Differences from EVM v1.4
+## Provenance and refresh
 
-| Feature | EVM v1.4 | Solana v1.4 |
-|---------|----------|-------------|
-| Architecture | 7-contract suite | Single program |
-| Addressing | Contract addresses | Program ID |
-| Interface | ABI | IDL (Anchor-style) |
-| Governance | Safe multisig | Upgrade authority (not multisig on mainnet) |
-| Assets | USDC/USDT per chain | SOL + SPL tokens |
-
-## Source
-
-Data sourced from `deployments/registry/solana-splitter-v1.4.json`, generated by `npm run registry:build` from upstream `AiFinPay/solana-contract/deployments/splitter_v14/`.
-
-**Last generated:** 2026-09-13
-
-**Upstream commit:** `e5df8f5436cf646ab495381eee04e0d1a10b4e2f`
-
-## IDL Files
-
-IDL copies are stored in `registry/idl/solana/splitter-v14/`:
-- `splitter.devnet.json`
-- `splitter.mainnet.json`
+The JSON's `source`, `sourceArtifact` and `generatedAt` fields record upstream
+provenance. The [grabber](../../../src/grabber.ts) and
+[build CLI](../../../src/build.ts) define fetching and output paths.
+From `deployments/`, `npm run build` followed by `npm run registry:build`
+refreshes generated registry outputs; it does not verify live settlement.

package/registry/splitter/solana/deployments.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "./reference/payment-deployments.schema.json",
+  "$schema": "../../../src/reference/payment-deployments.schema.json",
   "version": "1.4",
   "description": "Solana Splitter v1.4 — Program deployment",
   "schemaVersion": 1,
@@ -16,9 +16,7 @@
       "cluster": "devnet",
       "environment": "dev",
       "testnet": true,
-      "status": "disabled",
-      "settlementEnabled": false,
-      "disabledReason": "Backend Solana receipt verification is not implemented",
+      "settlementEnabled": true,
       "programId": "8dty5bD738Z9TzEkDu8vLSnhpJNWtEGMUEcYaKCUTY6y",
       "idl": {
         "name": "splitter",
@@ -30,9 +28,7 @@
       "cluster": "mainnet",
       "environment": "prod",
       "testnet": false,
-      "status": "disabled",
-      "settlementEnabled": false,
-      "disabledReason": "Backend Solana receipt verification is not implemented and upgrade authority is not multisig",
+      "settlementEnabled": true,
       "programId": "724Ut31i4ecY4dJ25z8HuZetu3A43xtNkPdk4JdbsfdD",
       "idl": {
         "name": "splitter",