feat(storage): add CHIRP reference implementation

.github/workflows/conformance.yml

@@ -32,7 +32,12 @@ jobs:
       - name: Install deps
         run: pnpm install --frozen-lockfile --ignore-scripts
       - name: Build TS runner dependencies
-        run: pnpm -r --filter '@bsv/wallet-toolbox...' --filter '@bsv/air-gap' run build
+        run: >-
+          pnpm -r
+          --filter '@bsv/wallet-toolbox...'
+          --filter '@bsv/air-gap'
+          --filter '@bsv/chirp...'
+          run build
       - name: Check TS conformance runner quality
         run: |
           pnpm --filter @bsv/conformance-runner-ts format:check

.sonarcloud.properties

@@ -10,7 +10,7 @@ sonar.exclusions=packages/verifast/src/wasm/bdk-core.*,conformance/generated/**,
 # into self-contained Docker/package build contexts and checked byte-for-byte
 # in CI. Analyze the code for issues, but do not report intentional generated
 # copies as source duplication.
-sonar.cpd.exclusions=**/*.test.ts,**/*.test.tsx,**/*.spec.ts,**/*.spec.tsx,**/*.man.test.ts,**/__test__/**,**/__tests__/**,**/test/**,**/tests/**,**/*.vectors.ts,**/eslint.config.js,infra/wab/src/security/rateLimitPolicy.ts,infra/uhrp-server-basic/src/security/rateLimitPolicy.ts,infra/uhrp-server-cloud-bucket/src/security/rateLimitPolicy.ts,infra/message-box-server/src/security/rateLimitPolicy.ts,infra/uhrp-server-basic/src/security/edgePolicy.ts,infra/uhrp-server-cloud-bucket/src/security/edgePolicy.ts,infra/message-box-server/src/security/edgePolicy.ts,infra/chaintracks-server/src/security/edgePolicy.ts,packages/overlays/overlay-express/src/security/edgePolicy.ts,packages/wallet/wallet-toolbox/src/storage/remoting/edgePolicy.ts,infra/uhrp-server-cloud-bucket/src/resourceLimits.ts,infra/uhrp-server-cloud-bucket/src/utils/network.ts,infra/wallet-infra/src/KnexPaymentReplayStore.ts
+sonar.cpd.exclusions=**/*.test.ts,**/*.test.tsx,**/*.spec.ts,**/*.spec.tsx,**/*.man.test.ts,**/__test__/**,**/__tests__/**,**/test/**,**/tests/**,**/*.vectors.ts,**/eslint.config.js,infra/wab/src/security/rateLimitPolicy.ts,infra/uhrp-server-basic/src/security/rateLimitPolicy.ts,infra/uhrp-server-cloud-bucket/src/security/rateLimitPolicy.ts,infra/message-box-server/src/security/rateLimitPolicy.ts,infra/uhrp-server-basic/src/security/edgePolicy.ts,infra/uhrp-server-cloud-bucket/src/security/edgePolicy.ts,infra/message-box-server/src/security/edgePolicy.ts,infra/chaintracks-server/src/security/edgePolicy.ts,packages/overlays/overlay-express/src/security/edgePolicy.ts,packages/wallet/wallet-toolbox/src/storage/remoting/edgePolicy.ts,infra/uhrp-server-cloud-bucket/src/resourceLimits.ts,infra/uhrp-server-cloud-bucket/src/utils/network.ts,infra/wallet-infra/src/KnexPaymentReplayStore.ts,infra/uhrp-server-basic/src/chirp/core/**,infra/uhrp-server-cloud-bucket/src/chirp/core/**,infra/uhrp-server-basic/src/chirp/openapi.ts,infra/uhrp-server-cloud-bucket/src/chirp/openapi.ts,infra/uhrp-server-cloud-bucket/src/chirp/contracts.ts,infra/uhrp-server-cloud-bucket/src/chirp/commitIndex.ts,infra/uhrp-server-cloud-bucket/src/chirp/routes.ts
 # Narrow compatibility exceptions are registered with owner, evidence, review
 # dates, and objective removal conditions in repository-health/exceptions.json.
 sonar.issue.ignore.multicriteria=werrProtocolNames,curveSingletonAlias,curveSingletonReturn,scriptOpcodeDispatch

conformance/META.json

@@ -20,14 +20,22 @@
       "sdk.keys.publickey",
       "sdk.crypto.signature"
     ],
-    "BRC-74": ["sdk.transactions.merklepath", "broadcast.merklepath"],
-    "BRC-77": ["sdk.compat.bsm"],
+    "BRC-74": [
+      "sdk.transactions.merklepath",
+      "broadcast.merklepath"
+    ],
+    "BRC-77": [
+      "sdk.compat.bsm"
+    ],
     "BRC-31": [
       "messaging.brc31.authrite-signature",
       "auth.brc31-handshake",
       "messaging.authsocket"
     ],
-    "BRC-29": ["wallet.brc29.payment-derivation", "payments.brc29-payment-protocol"],
+    "BRC-29": [
+      "wallet.brc29.payment-derivation",
+      "payments.brc29-payment-protocol"
+    ],
     "BRC-100": [
       "wallet.brc100.getpublickey",
       "wallet.brc100.createhmac",
@@ -59,23 +67,52 @@
       "wallet.brc100.getversion",
       "wallet.storage.adapterconformance"
     ],
-    "BRC-121": ["payments.brc121"],
-    "BRC-26": ["storage.uhrp-http"],
-    "BRC-62": ["overlay.submit"],
-    "BRC-22": ["overlay.lookup", "overlay.topicmanagement"],
-    "BRC-20": ["broadcast.arcsubmit", "broadcast.merklepath"],
-    "BRC-21": ["sync.gasprotocol"],
-    "BRC-40": ["sync.brc40"],
-    "BRC-14": ["sdk.scripts.evaluation"],
-    "merkle-service": ["broadcast.merkle-service"],
-    "message-box": ["messaging.messagebox-http"],
-    "chaintracks-v2": ["sync.chaintracks-v2-http"],
-    "BRC-141": ["transport.air-gap-optical"]
+    "BRC-121": [
+      "payments.brc121"
+    ],
+    "BRC-26": [
+      "storage.uhrp-http"
+    ],
+    "BRC-167": [
+      "storage.chirp-v1"
+    ],
+    "BRC-62": [
+      "overlay.submit"
+    ],
+    "BRC-22": [
+      "overlay.lookup",
+      "overlay.topicmanagement"
+    ],
+    "BRC-20": [
+      "broadcast.arcsubmit",
+      "broadcast.merklepath"
+    ],
+    "BRC-21": [
+      "sync.gasprotocol"
+    ],
+    "BRC-40": [
+      "sync.brc40"
+    ],
+    "BRC-14": [
+      "sdk.scripts.evaluation"
+    ],
+    "merkle-service": [
+      "broadcast.merkle-service"
+    ],
+    "message-box": [
+      "messaging.messagebox-http"
+    ],
+    "chaintracks-v2": [
+      "sync.chaintracks-v2-http"
+    ],
+    "BRC-141": [
+      "transport.air-gap-optical"
+    ]
   },
   "stats": {
-    "total_files": 75,
-    "total_vectors": 6681,
-    "last_updated": "2026-07-30"
+    "total_files": 76,
+    "total_vectors": 6690,
+    "last_updated": "2026-08-25"
   },
   "regression_index": {
     "beef-v2-txid-panic": "go-sdk#306",

conformance/PARITY_MATRIX.json

@@ -1,21 +1,21 @@
 {
   "schema_version": "1.0",
-  "generated_at": "2026-07-30",
+  "generated_at": "2026-08-25",
   "source": "ts-stack conformance corpus",
   "description": "Machine-readable parity status for cross-language SDK implementations (Go, Rust, Python). Use this to track and drive conformance.",
   "summary": {
-    "total_files": 75,
-    "total_vectors": 6681,
-    "fully_required_files": 56,
+    "total_files": 76,
+    "total_vectors": 6690,
+    "fully_required_files": 57,
     "files_with_intended": 17,
     "files_with_mixed_status": 15,
     "vectors_by_status": {
-      "required": 6477,
+      "required": 6486,
       "intended": 204,
       "skipped": 7
     },
     "by_reason_category": {
-      "fully_supported": 1265,
+      "fully_supported": 1274,
       "governed_vector_skip": 50,
       "historical_regression": 36,
       "partial_ts_behavioral_difference": 5116,
@@ -507,6 +507,18 @@
       "reason_category": "fully_supported",
       "categories": []
     },
+    {
+      "path": "storage/chirp-v1.json",
+      "id": "storage.chirp-v1",
+      "total_vectors": 9,
+      "file_level_parity": "required",
+      "effective_status": "required",
+      "required_count": 9,
+      "intended_count": 0,
+      "skipped_count": 0,
+      "reason_category": "fully_supported",
+      "categories": []
+    },
     {
       "path": "storage/uhrp-http.json",
       "id": "storage.uhrp-http",

conformance/runner/reports/report.json

@@ -1,7 +1,7 @@
 {
-  "timestamp": "2026-08-06T03:52:21.445Z",
-  "totalVectors": 6681,
-  "totalFiles": 75,
+  "timestamp": "2026-08-25T23:43:06.103Z",
+  "totalVectors": 6690,
+  "totalFiles": 76,
   "parseErrors": 0,
   "suites": [
     {
@@ -28054,6 +28054,56 @@
         }
       ]
     },
+    {
+      "name": "storage/chirp-v1",
+      "cases": [
+        {
+          "name": "storage.chirp-v1.empty",
+          "pass": true,
+          "error": null
+        },
+        {
+          "name": "storage.chirp-v1.hello",
+          "pass": true,
+          "error": null
+        },
+        {
+          "name": "storage.chirp-v1.hello-media-type",
+          "pass": true,
+          "error": null
+        },
+        {
+          "name": "storage.chirp-v1.chunk-size-minus-one",
+          "pass": true,
+          "error": null
+        },
+        {
+          "name": "storage.chirp-v1.chunk-size",
+          "pass": true,
+          "error": null
+        },
+        {
+          "name": "storage.chirp-v1.chunk-size-plus-one",
+          "pass": true,
+          "error": null
+        },
+        {
+          "name": "storage.chirp-v1.tree-256-blobs",
+          "pass": true,
+          "error": null
+        },
+        {
+          "name": "storage.chirp-v1.tree-257-blobs",
+          "pass": true,
+          "error": null
+        },
+        {
+          "name": "storage.chirp-v1.tree-multiple-branch-levels",
+          "pass": true,
+          "error": null
+        }
+      ]
+    },
     {
       "name": "storage/uhrp-http",
       "cases": [
@@ -33785,4 +33835,4 @@
       ]
     }
   ]
-}
+}

conformance/runner/reports/results.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<testsuites name="bsv-conformance" tests="6681" failures="0" errors="0" skipped="0">
+<testsuites name="bsv-conformance" tests="6690" failures="0" errors="0" skipped="0">
   <testsuite name="auth/brc31-handshake" tests="16" failures="0" errors="0" skipped="0">
     <testcase name="auth.brc31-handshake.1" classname="auth/brc31-handshake" time="0"/>
     <testcase name="auth.brc31-handshake.2" classname="auth/brc31-handshake" time="0"/>
@@ -5649,6 +5649,17 @@
     <testcase name="tx-014" classname="sdk/transactions/serialization" time="0"/>
     <testcase name="tx-015" classname="sdk/transactions/serialization" time="0"/>
   </testsuite>
+  <testsuite name="storage/chirp-v1" tests="9" failures="0" errors="0" skipped="0">
+    <testcase name="storage.chirp-v1.empty" classname="storage/chirp-v1" time="0"/>
+    <testcase name="storage.chirp-v1.hello" classname="storage/chirp-v1" time="0"/>
+    <testcase name="storage.chirp-v1.hello-media-type" classname="storage/chirp-v1" time="0"/>
+    <testcase name="storage.chirp-v1.chunk-size-minus-one" classname="storage/chirp-v1" time="0"/>
+    <testcase name="storage.chirp-v1.chunk-size" classname="storage/chirp-v1" time="0"/>
+    <testcase name="storage.chirp-v1.chunk-size-plus-one" classname="storage/chirp-v1" time="0"/>
+    <testcase name="storage.chirp-v1.tree-256-blobs" classname="storage/chirp-v1" time="0"/>
+    <testcase name="storage.chirp-v1.tree-257-blobs" classname="storage/chirp-v1" time="0"/>
+    <testcase name="storage.chirp-v1.tree-multiple-branch-levels" classname="storage/chirp-v1" time="0"/>
+  </testsuite>
   <testsuite name="storage/uhrp-http" tests="15" failures="0" errors="0" skipped="0">
     <testcase name="storage.uhrp-http.1" classname="storage/uhrp-http" time="0"/>
     <testcase name="storage.uhrp-http.2" classname="storage/uhrp-http" time="0"/>