openttt 0.1.1 → 0.1.2

package/LICENSE

@@ -0,0 +1,48 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:           Helm Protocol Foundation
+Licensed Work:      TikitakaTime SDK v0.1.0 (OpenTTT)
+Additional Use
+Grant:              Non-production evaluation and testing.
+Change Date:        March 14, 2030
+Change License:     Apache License, Version 2.0
+
+1.  Grant of License. Licensor hereby grants you a world-wide, royalty-free,
+    non-exclusive, non-sublicensable, non-transferable license to use the
+    Licensed Work, subject to the conditions set forth in this License.
+
+2.  Conditions. You may use the Licensed Work for any purpose, except for
+    Commercial Use.
+
+3.  Commercial Use. Commercial Use means any use of the Licensed Work that is
+    intended for or directed toward commercial advantage or monetary
+    compensation.
+
+4.  Change. On the Change Date, this License shall terminate and the Licensor
+    hereby grants you a license to the Licensed Work under the Change License.
+
+5.  Intellectual Property. This License does not grant you any rights in the
+    Intellectual Property of the Licensor, except for the license to use the
+    Licensed Work as set forth in Section 1.
+
+6.  Termination. This License shall terminate automatically if you fail to
+    comply with any of its terms and conditions.
+
+7.  Disclaimer of Warranty. THE LICENSED WORK IS PROVIDED "AS IS", WITHOUT
+    WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+    WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+    NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+    LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
+    CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+    LICENSED WORK OR THE USE OR OTHER DEALINGS IN THE LICENSED WORK.
+
+8.  Limitation of Liability. IN NO EVENT SHALL THE LICENSOR BE LIABLE FOR ANY
+    DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+    (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+    SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+    CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+    LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+    OUT OF THE USE OF THE LICENSED WORK, EVEN IF ADVISED OF THE POSSIBILITY OF
+    SUCH DAMAGE.

package/README.md

@@ -1,12 +1,16 @@
 # OpenTTT
 
+> **Reference implementation of [draft-helmprotocol-tttps-00](https://datatracker.ietf.org/doc/draft-helmprotocol-tttps/)**
+
 **OpenSSL for Transaction Ordering** -- TLS-grade Proof of Time for DeFi.
 
 OpenTTT brings cryptographic time verification to blockchain transaction ordering. Where TLS made HTTP trustworthy, OpenTTT makes transaction sequencing verifiable. No trust assumptions. No gentleman's agreements. Physics.
 
 [![npm](https://img.shields.io/npm/v/openttt)](https://www.npmjs.com/package/openttt)
 [![License: BSL-1.1](https://img.shields.io/badge/License-BSL--1.1-blue.svg)](LICENSE)
-[![Tests](https://img.shields.io/badge/tests-104%20passing%20%C2%B7%2018%20suites-brightgreen)]()
+[![CI](https://github.com/Helm-Protocol/OpenTTT/actions/workflows/ci.yml/badge.svg)](https://github.com/Helm-Protocol/OpenTTT/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/Helm-Protocol/OpenTTT/branch/main/graph/badge.svg)](https://codecov.io/gh/Helm-Protocol/OpenTTT)
+[![Tests](https://img.shields.io/badge/tests-273%20passing%20%C2%B7%2029%20suites-brightgreen)]()
 
 ```
 npm install openttt
@@ -41,14 +45,14 @@ Three lines to start minting TimeTokens:
 ```typescript
 import { TTTClient } from "openttt";
 
-const ttt = await TTTClient.forBase({
-  signer: { type: "privateKey", envVar: "OPERATOR_PK" },
-});
+const ttt = await TTTClient.forBase({ privateKey: process.env.OPERATOR_PK! });
 ttt.startAutoMint();
 ```
 
 That is it. The SDK connects to Base Mainnet, synthesizes time from three atomic clock sources, and begins minting Proof-of-Time tokens at your configured tier interval.
 
+> **Shorthand**: Pass `privateKey` directly as a string instead of the full `signer` config object. The verbose form `{ signer: { type: "privateKey", key: "0x..." } }` still works for when you need other signer types (Turnkey, KMS, Privy).
+
 ---
 
 ## Progressive Disclosure
@@ -60,9 +64,7 @@ OpenTTT is designed around progressive disclosure. Start simple, add control as
 ```typescript
 import { TTTClient } from "openttt";
 
-const ttt = await TTTClient.forBase({
-  signer: { type: "privateKey", envVar: "OPERATOR_PK" },
-});
+const ttt = await TTTClient.forBase({ privateKey: process.env.OPERATOR_PK! });
 ttt.startAutoMint();
 ```
 
@@ -70,7 +72,7 @@ ttt.startAutoMint();
 
 ```typescript
 const ttt = await TTTClient.forSepolia({
-  signer: { type: "privateKey", key: process.env.OPERATOR_PK! },
+  privateKey: process.env.OPERATOR_PK!,
   rpcUrl: "https://my-rpc.example.com",
   tier: "T2_slot",
 });
@@ -111,7 +113,7 @@ OpenTTT abstracts away signer complexity. Use a raw private key for development,
 |---|---|---|
 | `privateKey` | Development, small operators | `{ type: "privateKey", key: "0x..." }` or `{ type: "privateKey", envVar: "OPERATOR_PK" }` |
 | `turnkey` | Production, TEE-backed institutional custody | `{ type: "turnkey", apiBaseUrl, organizationId, privateKeyId, apiPublicKey, apiPrivateKey }` |
-| `privy` | Embedded wallets, consumer-facing apps | `{ type: "privy", appId, appSecret }` |
+| `privy` | Embedded wallets, consumer-facing apps (coming soon) | `{ type: "privy", appId, appSecret }` |
 | `kms` | Cloud HSM (AWS KMS or GCP Cloud KMS) | `{ type: "kms", provider: "aws"\|"gcp", keyId, ... }` |
 
 **AWS KMS** requires `@aws-sdk/client-kms`. **GCP KMS** requires `@google-cloud/kms`. Both are optional peer dependencies -- install only what you use.
@@ -312,7 +314,7 @@ OpenTTT queries multiple atomic clock-synchronized NTP sources in parallel and p
 - **KRISS** (time.kriss.re.kr) -- Korean national standard
 - **Google** (time.google.com) -- Leap-smeared public NTP
 
-All readings must fall within 100ms tolerance of the synthesized median, or the Proof of Time is rejected. Single-source operation triggers a degraded-confidence warning.
+All readings must fall within a stratum-dependent tolerance of the synthesized median (10ms for stratum 1, 25ms for stratum 2, 50ms for stratum 3+), or the Proof of Time is rejected. Single-source operation triggers a degraded-confidence warning.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openttt",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "OpenTTT — TLS-grade transaction ordering for DeFi. Time + Logic + Sync.",
   "license": "BSL-1.1",
   "repository": {
@@ -17,6 +17,9 @@
     "base",
     "ethereum"
   ],
+  "engines": {
+    "node": ">=18"
+  },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -28,19 +31,35 @@
   },
   "files": [
     "dist",
+    "vendor",
     "README.md"
   ],
   "scripts": {
     "build": "tsc",
-    "test": "jest"
+    "test": "jest",
+    "test:coverage": "jest --coverage --forceExit",
+    "verify": "cd contracts && npx hardhat verify --network"
   },
   "dependencies": {
-    "@privy-io/server-auth": "^1.32.5",
-    "@turnkey/api-key-stamper": "^0.6.2",
-    "@turnkey/ethers": "^1.3.25",
     "buffer": "^6.0.3",
     "ethers": "^6.10.0"
   },
+  "peerDependencies": {
+    "@privy-io/server-auth": "^1.32.5",
+    "@turnkey/api-key-stamper": "^0.6.2",
+    "@turnkey/ethers": "^1.3.25"
+  },
+  "peerDependenciesMeta": {
+    "@privy-io/server-auth": {
+      "optional": true
+    },
+    "@turnkey/api-key-stamper": {
+      "optional": true
+    },
+    "@turnkey/ethers": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/jest": "^29.5.12",
     "@types/node": "^20.11.19",

package/vendor/helm-crypto/golay.d.ts

@@ -0,0 +1,6 @@
+export declare function golayEncode(data: Uint8Array): Uint8Array;
+export declare function golayDecode(encoded: Uint8Array): {
+    data: Uint8Array;
+    corrected: number;
+    uncorrectable: boolean;
+};

package/vendor/helm-crypto/golay.js

@@ -0,0 +1,167 @@
+"use strict";
+// sdk/src/golay.ts
+// 🔱 Golay(24,12) Extended Binary Golay Code (RE-SURGERY)
+// Corrects up to 3 bit errors, detects 4 bit errors.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.golayEncode = golayEncode;
+exports.golayDecode = golayDecode;
+// Standard Golay Parity Matrix P (12x12) - Systematic Form [I12 | P]
+// Every row has weight 7.
+// Verified: P*P^T = I (mod 2), all rows weight 7.
+// Derived from g(x) = x^11+x^10+x^6+x^5+x^4+x^2+1 with parity extension.
+const P = [
+    0xC75, 0x49F, 0xD4B, 0x6E3, 0x9B3, 0xB66,
+    0xECC, 0x1ED, 0x3DA, 0x7B4, 0xB1D, 0xE3A
+];
+// R7-P0-1: P^T (transpose of P) — required for second syndrome computation.
+// P is NOT symmetric, so s2 = s*P^T must use this separate matrix.
+// Without this, decodeWord fails ~24% of weight-2 and ~50% of weight-3 error patterns.
+const PT = [
+    0xAE3, 0xF25, 0x16F, 0x2DE, 0x5BC, 0xB78,
+    0x9D5, 0xC8F, 0x63B, 0xC76, 0x7C9, 0xF92
+];
+const UNIT_VECTORS = [
+    0x800, 0x400, 0x200, 0x100, 0x080, 0x040,
+    0x020, 0x010, 0x008, 0x004, 0x002, 0x001
+];
+/**
+ * Calculates weight (number of set bits).
+ */
+function weight(n) {
+    let count = 0;
+    let temp = n & 0xFFF;
+    while (temp > 0) {
+        temp &= (temp - 1);
+        count++;
+    }
+    return count;
+}
+/**
+ * Multiplies a 12-bit vector by the parity matrix P.
+ */
+function multiplyP(v) {
+    let res = 0;
+    for (let i = 0; i < 12; i++) {
+        if ((v >> (11 - i)) & 1) {
+            res ^= P[i];
+        }
+    }
+    return res & 0xFFF;
+}
+/**
+ * R7-P0-1: Multiplies a 12-bit vector by P^T (transpose of P).
+ * Required for second syndrome computation in decodeWord steps 3-5.
+ */
+function multiplyPT(v) {
+    let res = 0;
+    for (let i = 0; i < 12; i++) {
+        if ((v >> (11 - i)) & 1) {
+            res ^= PT[i];
+        }
+    }
+    return res & 0xFFF;
+}
+function encodeWord(msg) {
+    const parity = multiplyP(msg & 0xFFF);
+    return ((msg & 0xFFF) << 12) | parity;
+}
+/**
+ * Full Syndrome Decoding for Golay(24,12)
+ */
+function decodeWord(received) {
+    let r_m = (received >> 12) & 0xFFF;
+    const r_p = received & 0xFFF;
+    // Syndrome s = r_m * P + r_p
+    const s = multiplyP(r_m) ^ r_p;
+    if (s === 0)
+        return { msg: r_m, corrected: 0, uncorrectable: false };
+    // 1. wt(s) <= 3 -> Error in parity
+    if (weight(s) <= 3) {
+        return { msg: r_m, corrected: weight(s), uncorrectable: false };
+    }
+    // 2. wt(s + P_i) <= 2 -> Error in msg bit i (+ possible 1-2 errors in parity)
+    for (let i = 0; i < 12; i++) {
+        if (weight(s ^ P[i]) <= 2) {
+            return { msg: r_m ^ UNIT_VECTORS[i], corrected: weight(s ^ P[i]) + 1, uncorrectable: false };
+        }
+    }
+    // 3. R7-P0-1: Second syndrome s2 = s * P^T (NOT s * P — P is not symmetric!)
+    const s2 = multiplyPT(s);
+    // 4. wt(s2) <= 3 -> Error in message
+    if (weight(s2) <= 3) {
+        return { msg: r_m ^ s2, corrected: weight(s2), uncorrectable: false };
+    }
+    // 5. wt(s2 + PT_i) <= 2 -> Error in parity bit i + message errors
+    // R7-P0-1: Must use PT rows (columns of P), not P rows
+    for (let i = 0; i < 12; i++) {
+        if (weight(s2 ^ PT[i]) <= 2) {
+            const error_m = s2 ^ PT[i];
+            return { msg: r_m ^ error_m, corrected: weight(s2 ^ PT[i]) + 1, uncorrectable: false };
+        }
+    }
+    return { msg: r_m, corrected: 0, uncorrectable: true };
+}
+function golayEncode(data) {
+    // B1-6: Correct output size calculation to avoid buffer overflow
+    const out = new Uint8Array(Math.ceil(data.length / 3) * 6);
+    let outIdx = 0;
+    // Process in 3-byte blocks -> two 12-bit words -> two 24-bit (3-byte) codewords
+    for (let i = 0; i < data.length; i += 3) {
+        const b1 = data[i];
+        const b2 = i + 1 < data.length ? data[i + 1] : 0;
+        const b3 = i + 2 < data.length ? data[i + 2] : 0;
+        // Word 1 (12 bits)
+        const w1 = (b1 << 4) | (b2 >> 4);
+        const c1 = encodeWord(w1);
+        out[outIdx++] = (c1 >> 16) & 0xFF;
+        out[outIdx++] = (c1 >> 8) & 0xFF;
+        out[outIdx++] = c1 & 0xFF;
+        if (i + 1 < data.length) {
+            // Word 2 (12 bits)
+            const w2 = ((b2 & 0x0F) << 8) | b3;
+            const c2 = encodeWord(w2);
+            out[outIdx++] = (c2 >> 16) & 0xFF;
+            out[outIdx++] = (c2 >> 8) & 0xFF;
+            out[outIdx++] = c2 & 0xFF;
+        }
+    }
+    return out;
+}
+function golayDecode(encoded) {
+    // B1-6: Throws if length is not a multiple of 6
+    if (encoded.length % 6 !== 0) {
+        throw new Error("Invalid Golay encoded data: length must be multiple of 6");
+    }
+    const outLen = Math.floor(encoded.length / 2);
+    const out = new Uint8Array(outLen);
+    let outIdx = 0;
+    let totalCorrected = 0;
+    let anyUncorrectable = false;
+    for (let i = 0; i < encoded.length; i += 6) {
+        const c1 = (encoded[i] << 16) | (encoded[i + 1] << 8) | encoded[i + 2];
+        const res1 = decodeWord(c1);
+        totalCorrected += res1.corrected;
+        if (res1.uncorrectable)
+            anyUncorrectable = true;
+        if (outIdx < outLen)
+            out[outIdx++] = (res1.msg >> 4) & 0xFF;
+        const b2_high = (res1.msg & 0x0F) << 4;
+        if (i + 3 < encoded.length) {
+            const c2 = (encoded[i + 3] << 16) | (encoded[i + 4] << 8) | encoded[i + 5];
+            const res2 = decodeWord(c2);
+            totalCorrected += res2.corrected;
+            if (res2.uncorrectable)
+                anyUncorrectable = true;
+            if (outIdx < outLen)
+                out[outIdx++] = b2_high | (res2.msg >> 8);
+            if (outIdx < outLen)
+                out[outIdx++] = res2.msg & 0xFF;
+        }
+        else {
+            if (outIdx < outLen)
+                out[outIdx++] = b2_high;
+        }
+    }
+    return { data: out, corrected: totalCorrected, uncorrectable: anyUncorrectable };
+}
+//# sourceMappingURL=golay.js.map

package/vendor/helm-crypto/golay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"golay.js","sourceRoot":"","sources":["../src/golay.ts"],"names":[],"mappings":"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"}

package/vendor/helm-crypto/grg_forward.d.ts

@@ -0,0 +1,22 @@
+export declare class GrgForward {
+    /**
+     * Golomb-Rice encoding.
+     *
+     * Golomb-Rice is optimal for small-value biased distributions (e.g., timestamp deltas).
+     * For uniformly distributed data (random bytes), expect ~50% expansion.
+     * The primary purpose in the GRG pipeline is structured encoding for error correction,
+     * not compression.
+     *
+     * @param data  Raw bytes to encode.
+     * @param m     Golomb divisor (must be a power of 2, default 16).
+     */
+    static golombEncode(data: Uint8Array, m?: number): Uint8Array;
+    static redstuffEncode(data: Uint8Array, shards?: number, parity?: number): Uint8Array[];
+    /**
+     * Derives an HMAC key from GRG payload context (chainId + poolAddress).
+     * Both parameters are required — no default key fallback.
+     */
+    static deriveHmacKey(chainId: number, poolAddress: string): Buffer;
+    static golayEncodeWrapper(data: Uint8Array, hmacKey: Buffer): Uint8Array;
+    static encode(data: Uint8Array, chainId: number, poolAddress: string): Uint8Array[];
+}

package/vendor/helm-crypto/grg_forward.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrgForward = void 0;
+const crypto_1 = require("crypto");
+const ethers_1 = require("ethers");
+const golay_1 = require("./golay");
+const reed_solomon_1 = require("./reed_solomon");
+class GrgForward {
+    /**
+     * Golomb-Rice encoding.
+     *
+     * Golomb-Rice is optimal for small-value biased distributions (e.g., timestamp deltas).
+     * For uniformly distributed data (random bytes), expect ~50% expansion.
+     * The primary purpose in the GRG pipeline is structured encoding for error correction,
+     * not compression.
+     *
+     * @param data  Raw bytes to encode.
+     * @param m     Golomb divisor (must be a power of 2, default 16).
+     */
+    static golombEncode(data, m = 16) {
+        if (m < 2)
+            throw new Error("[GRG] Golomb parameter m must be >= 2");
+        const k = Math.log2(m);
+        if (!Number.isInteger(k))
+            throw new Error("M must be power of 2");
+        const bits = [];
+        for (const byte of data) {
+            const q = Math.floor(byte / m);
+            const r = byte % m;
+            for (let i = 0; i < q; i++)
+                bits.push(1);
+            bits.push(0);
+            for (let i = k - 1; i >= 0; i--)
+                bits.push((r >> i) & 1);
+        }
+        const out = new Uint8Array(Math.ceil(bits.length / 8));
+        for (let i = 0; i < bits.length; i++) {
+            if (bits[i])
+                out[i >> 3] |= (0x80 >> (i & 7));
+        }
+        return out;
+    }
+    // 2. RedStuff Erasure Coding (Reed-Solomon GF(2^8))
+    static redstuffEncode(data, shards = 4, parity = 2) {
+        return reed_solomon_1.ReedSolomon.encode(data, shards, parity);
+    }
+    /**
+     * Derives an HMAC key from GRG payload context (chainId + poolAddress).
+     * Both parameters are required — no default key fallback.
+     */
+    static deriveHmacKey(chainId, poolAddress) {
+        if (chainId === undefined || chainId === null || !poolAddress) {
+            throw new Error("[GRG] chainId and poolAddress are required for HMAC key derivation. No default key is allowed.");
+        }
+        const packed = (0, ethers_1.keccak256)(ethers_1.AbiCoder.defaultAbiCoder().encode(["uint256", "address"], [chainId, poolAddress]));
+        return Buffer.from(packed.slice(2), "hex"); // 32 bytes
+    }
+    // 3. Golay(24,12) Error Correction Encoding
+    static golayEncodeWrapper(data, hmacKey) {
+        const encoded = (0, golay_1.golayEncode)(data);
+        // 🔱 Integrity: Append 8-byte HMAC-SHA256 of the encoded shard (keyed hash)
+        const key = hmacKey;
+        const mac = (0, crypto_1.createHmac)("sha256", key).update(Buffer.from(encoded)).digest();
+        const checksum = mac.subarray(0, 8);
+        const final = new Uint8Array(encoded.length + 8);
+        final.set(encoded);
+        final.set(checksum, encoded.length);
+        return final;
+    }
+    static encode(data, chainId, poolAddress) {
+        // R3-P0-3: Reject empty input — roundtrip breaks ([] → [0])
+        if (data.length === 0) {
+            throw new Error("[GRG] Cannot encode empty input — roundtrip identity violation");
+        }
+        const compressed = this.golombEncode(data);
+        // Prepend original length (4 bytes, big-endian) for exact roundtrip
+        const withLen = new Uint8Array(4 + compressed.length);
+        withLen[0] = (data.length >> 24) & 0xFF;
+        withLen[1] = (data.length >> 16) & 0xFF;
+        withLen[2] = (data.length >> 8) & 0xFF;
+        withLen[3] = data.length & 0xFF;
+        withLen.set(compressed, 4);
+        const shards = this.redstuffEncode(withLen);
+        const hmacKey = this.deriveHmacKey(chainId, poolAddress);
+        return shards.map(s => this.golayEncodeWrapper(s, hmacKey));
+    }
+}
+exports.GrgForward = GrgForward;
+//# sourceMappingURL=grg_forward.js.map

package/vendor/helm-crypto/grg_forward.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grg_forward.js","sourceRoot":"","sources":["../src/grg_forward.ts"],"names":[],"mappings":"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"}

package/vendor/helm-crypto/grg_inverse.d.ts

@@ -0,0 +1,16 @@
+export declare class GrgInverse {
+    static golayDecodeWrapper(data: Uint8Array, hmacKey: Buffer): Uint8Array;
+    static redstuffDecode(shards: (Uint8Array | null)[], dataShardCount?: number, parityShardCount?: number): Uint8Array;
+    private static readonly MAX_GOLOMB_Q;
+    /**
+     * Decode a Golomb-Rice compressed byte stream.
+     *
+     * @param data - Golomb-encoded bit-packed bytes
+     * @param m - Golomb divisor (must be power of 2, default 16)
+     * @param originalLength - If provided, stop decoding once this many values
+     *   have been emitted. This prevents phantom trailing bytes caused by
+     *   zero-padding in the last byte of the encoded stream.
+     */
+    static golombDecode(data: Uint8Array, m?: number, originalLength?: number): Uint8Array;
+    static verify(data: Uint8Array, originalShards: Uint8Array[], chainId: number, poolAddress: string): boolean;
+}

package/vendor/helm-crypto/grg_inverse.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrgInverse = void 0;
+const crypto_1 = require("crypto");
+const golay_1 = require("./golay");
+const grg_forward_1 = require("./grg_forward");
+const logger_1 = require("./logger");
+const reed_solomon_1 = require("./reed_solomon");
+class GrgInverse {
+    // 1. Golay Decoding & Integrity Check
+    static golayDecodeWrapper(data, hmacKey) {
+        if (data.length < 8)
+            throw new Error("GRG shard too short for checksum");
+        // Split data and checksum (last 8 bytes)
+        const encoded = data.subarray(0, data.length - 8);
+        const checksum = data.subarray(data.length - 8);
+        // Verify HMAC-SHA256 Checksum (keyed hash, B1-5: 8 bytes truncated)
+        const key = hmacKey;
+        const mac = (0, crypto_1.createHmac)("sha256", key).update(Buffer.from(encoded)).digest();
+        const expected = mac.subarray(0, 8);
+        if (!Buffer.from(checksum).equals(Buffer.from(expected))) {
+            throw new Error("GRG tamper detected: HMAC-SHA256 checksum mismatch");
+        }
+        // Proceed to Golay decode
+        const res = (0, golay_1.golayDecode)(encoded);
+        if (res.uncorrectable) {
+            throw new Error("GRG tamper detected: uncorrectable bit errors in Golay codeword");
+        }
+        return res.data;
+    }
+    // 2. RedStuff Decoding (Reed-Solomon GF(2^8))
+    static redstuffDecode(shards, dataShardCount = 4, parityShardCount = 2) {
+        return reed_solomon_1.ReedSolomon.decode(shards, dataShardCount, parityShardCount);
+    }
+    /**
+     * Decode a Golomb-Rice compressed byte stream.
+     *
+     * @param data - Golomb-encoded bit-packed bytes
+     * @param m - Golomb divisor (must be power of 2, default 16)
+     * @param originalLength - If provided, stop decoding once this many values
+     *   have been emitted. This prevents phantom trailing bytes caused by
+     *   zero-padding in the last byte of the encoded stream.
+     */
+    static golombDecode(data, m = 16, originalLength) {
+        if (m < 2)
+            throw new Error("[GRG] Golomb parameter m must be >= 2");
+        const k = Math.log2(m);
+        const totalBits = data.length * 8;
+        // Helper to read a single bit from the packed byte array
+        const readBit = (pos) => {
+            return (data[pos >> 3] >> (7 - (pos & 7))) & 1;
+        };
+        const result = [];
+        let i = 0;
+        while (i < totalBits) {
+            // Guard: stop at expected length to avoid processing padding bits
+            if (originalLength !== undefined && result.length >= originalLength)
+                break;
+            // Read unary part: count 1-bits until a 0-bit
+            let q = 0;
+            while (i < totalBits && readBit(i) === 1) {
+                q++;
+                i++;
+                if (q > this.MAX_GOLOMB_Q)
+                    throw new Error(`[GRG] Golomb decode: unary run exceeds ${this.MAX_GOLOMB_Q} — malformed or malicious input`);
+            }
+            if (i < totalBits && readBit(i) === 0)
+                i++; // skip the 0 delimiter
+            // Read k-bit remainder
+            if (i + k > totalBits)
+                break;
+            let r = 0;
+            for (let j = 0; j < k; j++) {
+                r = (r << 1) | readBit(i + j);
+            }
+            result.push(q * m + r);
+            i += k;
+        }
+        return new Uint8Array(result);
+    }
+    static verify(data, originalShards, chainId, poolAddress) {
+        try {
+            const hmacKey = grg_forward_1.GrgForward.deriveHmacKey(chainId, poolAddress);
+            const decodedShards = originalShards.map(s => {
+                try {
+                    return this.golayDecodeWrapper(s, hmacKey);
+                }
+                catch {
+                    return null;
+                }
+            });
+            const withLen = this.redstuffDecode(decodedShards);
+            // Extract original length
+            if (withLen.length < 4)
+                return false;
+            const origLen = (withLen[0] << 24) | (withLen[1] << 16) | (withLen[2] << 8) | withLen[3];
+            const compressed = withLen.subarray(4);
+            const decoded = this.golombDecode(compressed);
+            const final = decoded.subarray(0, origLen);
+            if (final.length !== data.length)
+                return false;
+            for (let i = 0; i < data.length; i++) {
+                if (final[i] !== data[i])
+                    return false;
+            }
+            return true;
+        }
+        catch (e) {
+            logger_1.logger.warn(`[GRG Inverse] Verification failed: ${e}`);
+            return false;
+        }
+    }
+}
+exports.GrgInverse = GrgInverse;
+// 3. Golomb-Rice Decompression
+// R4-P2-3: Max unary run length to prevent amplification DoS
+GrgInverse.MAX_GOLOMB_Q = 1000000;
+//# sourceMappingURL=grg_inverse.js.map

package/vendor/helm-crypto/grg_inverse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grg_inverse.js","sourceRoot":"","sources":["../src/grg_inverse.ts"],"names":[],"mappings":"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"}

package/vendor/helm-crypto/grg_pipeline.d.ts

@@ -0,0 +1,13 @@
+export declare class GrgPipeline {
+    static readonly MAX_INPUT_SIZE: number;
+    /**
+     * Runs the full forward pipeline:
+     * Golomb-Rice -> RedStuff (Erasure) -> Golay(24,12)
+     */
+    static processForward(data: Uint8Array, chainId: number, poolAddress: string): Uint8Array[];
+    /**
+     * Runs the full inverse pipeline:
+     * Golay(24,12) -> RedStuff (Reconstruction) -> Golomb-Rice Decompression
+     */
+    static processInverse(shards: Uint8Array[], originalLength: number, chainId: number, poolAddress: string): Uint8Array;
+}

package/vendor/helm-crypto/grg_pipeline.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrgPipeline = void 0;
+const grg_forward_1 = require("./grg_forward");
+const grg_inverse_1 = require("./grg_inverse");
+const logger_1 = require("./logger");
+class GrgPipeline {
+    /**
+     * Runs the full forward pipeline:
+     * Golomb-Rice -> RedStuff (Erasure) -> Golay(24,12)
+     */
+    static processForward(data, chainId, poolAddress) {
+        if (data.length > this.MAX_INPUT_SIZE) {
+            throw new Error(`[GRG] Input size ${data.length} exceeds MAX_INPUT_SIZE ${this.MAX_INPUT_SIZE}`);
+        }
+        logger_1.logger.info("Starting GRG forward pipeline...");
+        try {
+            const shards = grg_forward_1.GrgForward.encode(data, chainId, poolAddress);
+            logger_1.logger.info(`GRG forward pipeline complete. Generated ${shards.length} shards.`);
+            return shards;
+        }
+        catch (error) {
+            logger_1.logger.error(`GRG forward pipeline failed: ${error}`);
+            throw error;
+        }
+    }
+    /**
+     * Runs the full inverse pipeline:
+     * Golay(24,12) -> RedStuff (Reconstruction) -> Golomb-Rice Decompression
+     */
+    static processInverse(shards, originalLength, chainId, poolAddress) {
+        logger_1.logger.info("Starting GRG inverse pipeline...");
+        try {
+            const hmacKey = grg_forward_1.GrgForward.deriveHmacKey(chainId, poolAddress);
+            const decodedShards = shards.map(s => {
+                try {
+                    return grg_inverse_1.GrgInverse.golayDecodeWrapper(s, hmacKey);
+                }
+                catch (e) {
+                    logger_1.logger.warn(`Golay decode failed for a shard: ${e}`);
+                    return null;
+                }
+            });
+            const withLen = grg_inverse_1.GrgInverse.redstuffDecode(decodedShards);
+            // Extract original length from the first 4 bytes
+            const decodedLength = (withLen[0] << 24) | (withLen[1] << 16) | (withLen[2] << 8) | withLen[3];
+            const compressed = withLen.subarray(4);
+            const decompressed = grg_inverse_1.GrgInverse.golombDecode(compressed);
+            const final = decompressed.subarray(0, decodedLength);
+            // P1-4 FIX: Length mismatch is a corruption signal — throw instead of warn
+            if (final.length !== originalLength) {
+                throw new Error(`[GRG] Length mismatch in inverse: expected ${originalLength}, got ${final.length}`);
+            }
+            logger_1.logger.info("GRG inverse pipeline complete.");
+            return final;
+        }
+        catch (error) {
+            logger_1.logger.error(`GRG inverse pipeline failed: ${error}`);
+            throw error;
+        }
+    }
+}
+exports.GrgPipeline = GrgPipeline;
+// P1-3: Max input size to prevent OOM attacks (100 MB)
+GrgPipeline.MAX_INPUT_SIZE = 100 * 1024 * 1024;
+//# sourceMappingURL=grg_pipeline.js.map

package/vendor/helm-crypto/grg_pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grg_pipeline.js","sourceRoot":"","sources":["../src/grg_pipeline.ts"],"names":[],"mappings":";;;AAAA,+CAA2C;AAC3C,+CAA2C;AAC3C,qCAAkC;AAElC,MAAa,WAAW;IAItB;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,IAAgB,EAAE,OAAe,EAAE,WAAmB;QAC1E,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,MAAM,2BAA2B,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QACnG,CAAC;QACD,eAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,wBAAU,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;YAC7D,eAAM,CAAC,IAAI,CAAC,4CAA4C,MAAM,CAAC,MAAM,UAAU,CAAC,CAAC;YACjF,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAM,CAAC,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;YACtD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,MAAoB,EAAE,cAAsB,EAAE,OAAe,EAAE,WAAmB;QACtG,eAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,wBAAU,CAAC,aAAa,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YAC/D,MAAM,aAAa,GAA0B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;gBAC1D,IAAI,CAAC;oBACH,OAAO,wBAAU,CAAC,kBAAkB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBACnD,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,eAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,EAAE,CAAC,CAAC;oBACrD,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,wBAAU,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;YAEzD,iDAAiD;YACjD,MAAM,aAAa,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC/F,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAEvC,MAAM,YAAY,GAAG,wBAAU,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YACzD,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;YAEtD,2EAA2E;YAC3E,IAAI,KAAK,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,8CAA8C,cAAc,SAAS,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACvG,CAAC;YAED,eAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;YAC9C,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAM,CAAC,KAAK,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;YACtD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;;AA3DH,kCA4DC;AA3DC,uDAAuD;AACvC,0BAAc,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC"}

package/vendor/helm-crypto/index.d.ts

@@ -0,0 +1,5 @@
+export { golayEncode, golayDecode } from "./golay";
+export { ReedSolomon } from "./reed_solomon";
+export { GrgForward } from "./grg_forward";
+export { GrgInverse } from "./grg_inverse";
+export { GrgPipeline } from "./grg_pipeline";

package/vendor/helm-crypto/index.js

@@ -0,0 +1,17 @@
+"use strict";
+// @helm-protocol/helm-crypto — GRG Cryptographic Pipeline (PRIVATE)
+// Golomb-Rice -> Reed-Solomon -> Golay(24,12)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GrgPipeline = exports.GrgInverse = exports.GrgForward = exports.ReedSolomon = exports.golayDecode = exports.golayEncode = void 0;
+var golay_1 = require("./golay");
+Object.defineProperty(exports, "golayEncode", { enumerable: true, get: function () { return golay_1.golayEncode; } });
+Object.defineProperty(exports, "golayDecode", { enumerable: true, get: function () { return golay_1.golayDecode; } });
+var reed_solomon_1 = require("./reed_solomon");
+Object.defineProperty(exports, "ReedSolomon", { enumerable: true, get: function () { return reed_solomon_1.ReedSolomon; } });
+var grg_forward_1 = require("./grg_forward");
+Object.defineProperty(exports, "GrgForward", { enumerable: true, get: function () { return grg_forward_1.GrgForward; } });
+var grg_inverse_1 = require("./grg_inverse");
+Object.defineProperty(exports, "GrgInverse", { enumerable: true, get: function () { return grg_inverse_1.GrgInverse; } });
+var grg_pipeline_1 = require("./grg_pipeline");
+Object.defineProperty(exports, "GrgPipeline", { enumerable: true, get: function () { return grg_pipeline_1.GrgPipeline; } });
+//# sourceMappingURL=index.js.map

package/vendor/helm-crypto/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,oEAAoE;AACpE,8CAA8C;;;AAE9C,iCAAmD;AAA1C,oGAAA,WAAW,OAAA;AAAE,oGAAA,WAAW,OAAA;AACjC,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AACnB,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AACnB,+CAA6C;AAApC,2GAAA,WAAW,OAAA"}

package/vendor/helm-crypto/logger.d.ts

@@ -0,0 +1,6 @@
+export declare const logger: {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    debug: (msg: string) => void;
+};

package/vendor/helm-crypto/logger.js

@@ -0,0 +1,11 @@
+"use strict";
+// Minimal logger for helm-crypto (standalone, no external dependency)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.logger = {
+    info: (msg) => console.log(`[helm-crypto] ${msg}`),
+    warn: (msg) => console.warn(`[helm-crypto] ${msg}`),
+    error: (msg) => console.error(`[helm-crypto] ${msg}`),
+    debug: (msg) => console.debug(`[helm-crypto] ${msg}`),
+};
+//# sourceMappingURL=logger.js.map

package/vendor/helm-crypto/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":";AAAA,sEAAsE;;;AAEzD,QAAA,MAAM,GAAG;IACpB,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,EAAE,CAAC;IAC1D,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC;IAC3D,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,EAAE,CAAC;IAC7D,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,EAAE,CAAC;CAC9D,CAAC"}

package/vendor/helm-crypto/reed_solomon.d.ts

@@ -0,0 +1,37 @@
+export declare class ReedSolomon {
+    private static expTable;
+    private static logTable;
+    private static initialized;
+    /**
+     * Static Vandermonde matrix cache keyed by "${totalShards}-${dataShards}".
+     * Avoids recomputing the GF(2^8) Vandermonde + inverse on every tick,
+     * which is the most expensive part of RS encoding/decoding.
+     */
+    private static vandermondeCache;
+    static init(): void;
+    static mul(a: number, b: number): number;
+    static div(a: number, b: number): number;
+    private static invertMatrix;
+    /**
+     * Build (or retrieve from cache) the normalized Vandermonde encoding matrix.
+     * Cache key: "${rows}-${cols}" — RS parameters rarely change within a session,
+     * so caching eliminates redundant GF(2^8) matrix inversion on every tick.
+     */
+    private static buildVandermonde;
+    static encode(data: Uint8Array, dataShards?: number, parityShards?: number): Uint8Array[];
+    /**
+     * Decode data from a set of Reed-Solomon shards (data + parity).
+     *
+     * Shards should be provided in order of reliability: place higher-quality,
+     * more trustworthy shards first. The decoder selects the first `dataShards`
+     * non-null entries for recovery, so ordering by reliability ensures the
+     * most dependable shards are preferred. The implementation already handles
+     * missing (null) shards transparently via GF(2^8) matrix inversion.
+     *
+     * @param shards - Array of shard buffers (null for missing/corrupted shards)
+     * @param dataShards - Number of data shards (default 4)
+     * @param parityShards - Number of parity shards (default 2)
+     * @returns Reconstructed data as a single Uint8Array
+     */
+    static decode(shards: (Uint8Array | null)[], dataShards?: number, parityShards?: number): Uint8Array;
+}

package/vendor/helm-crypto/reed_solomon.js

@@ -0,0 +1,210 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReedSolomon = void 0;
+class ReedSolomon {
+    static init() {
+        if (this.initialized)
+            return;
+        let x = 1;
+        for (let i = 0; i < 255; i++) {
+            this.expTable[i] = x;
+            this.logTable[x] = i;
+            x <<= 1;
+            if (x & 0x100) {
+                x ^= 0x11D; // x^8 + x^4 + x^3 + x^2 + 1
+            }
+        }
+        this.expTable[255] = this.expTable[0];
+        this.logTable[0] = 0;
+        this.initialized = true;
+    }
+    static mul(a, b) {
+        if (a === 0 || b === 0)
+            return 0;
+        return this.expTable[(this.logTable[a] + this.logTable[b]) % 255];
+    }
+    static div(a, b) {
+        if (b === 0)
+            throw new Error("Division by zero");
+        if (a === 0)
+            return 0;
+        return this.expTable[(this.logTable[a] - this.logTable[b] + 255) % 255];
+    }
+    static invertMatrix(matrix) {
+        const n = matrix.length;
+        const aug = [];
+        for (let i = 0; i < n; i++) {
+            aug[i] = [];
+            for (let j = 0; j < n; j++) {
+                aug[i][j] = matrix[i][j];
+            }
+            for (let j = 0; j < n; j++) {
+                aug[i][j + n] = (i === j) ? 1 : 0;
+            }
+        }
+        for (let i = 0; i < n; i++) {
+            let pivot = i;
+            while (pivot < n && aug[pivot][i] === 0) {
+                pivot++;
+            }
+            if (pivot === n)
+                throw new Error("Singular matrix");
+            if (pivot !== i) {
+                const temp = aug[i];
+                aug[i] = aug[pivot];
+                aug[pivot] = temp;
+            }
+            const pivotVal = aug[i][i];
+            if (pivotVal !== 1) {
+                for (let j = i; j < 2 * n; j++) {
+                    aug[i][j] = this.div(aug[i][j], pivotVal);
+                }
+            }
+            for (let j = 0; j < n; j++) {
+                if (i !== j && aug[j][i] !== 0) {
+                    const factor = aug[j][i];
+                    for (let k = i; k < 2 * n; k++) {
+                        aug[j][k] ^= this.mul(factor, aug[i][k]);
+                    }
+                }
+            }
+        }
+        const inv = [];
+        for (let i = 0; i < n; i++) {
+            inv[i] = [];
+            for (let j = 0; j < n; j++) {
+                inv[i][j] = aug[i][j + n];
+            }
+        }
+        return inv;
+    }
+    /**
+     * Build (or retrieve from cache) the normalized Vandermonde encoding matrix.
+     * Cache key: "${rows}-${cols}" — RS parameters rarely change within a session,
+     * so caching eliminates redundant GF(2^8) matrix inversion on every tick.
+     */
+    static buildVandermonde(rows, cols) {
+        const cacheKey = `${rows}-${cols}`;
+        const cached = this.vandermondeCache.get(cacheKey);
+        if (cached)
+            return cached;
+        const V = [];
+        for (let r = 0; r < rows; r++) {
+            V[r] = [];
+            const x = r + 1;
+            for (let c = 0; c < cols; c++) {
+                if (c === 0) {
+                    V[r][c] = 1;
+                }
+                else {
+                    V[r][c] = this.mul(V[r][c - 1], x);
+                }
+            }
+        }
+        const V_top = [];
+        for (let i = 0; i < cols; i++) {
+            V_top.push([...V[i]]);
+        }
+        const V_top_inv = this.invertMatrix(V_top);
+        const G = [];
+        for (let r = 0; r < rows; r++) {
+            G[r] = [];
+            for (let c = 0; c < cols; c++) {
+                let val = 0;
+                for (let k = 0; k < cols; k++) {
+                    val ^= this.mul(V[r][k], V_top_inv[k][c]);
+                }
+                G[r][c] = val;
+            }
+        }
+        this.vandermondeCache.set(cacheKey, G);
+        return G;
+    }
+    static encode(data, dataShards = 4, parityShards = 2) {
+        this.init();
+        const totalShards = dataShards + parityShards;
+        const rawShardSize = Math.ceil(data.length / dataShards);
+        const shardSize = Math.ceil(rawShardSize / 3) * 3;
+        const matrix = this.buildVandermonde(totalShards, dataShards);
+        const shards = [];
+        for (let i = 0; i < totalShards; i++) {
+            shards.push(new Uint8Array(shardSize));
+        }
+        for (let i = 0; i < dataShards; i++) {
+            shards[i].set(data.subarray(i * shardSize, Math.min((i + 1) * shardSize, data.length)));
+        }
+        for (let c = 0; c < shardSize; c++) {
+            for (let r = dataShards; r < totalShards; r++) {
+                let val = 0;
+                for (let j = 0; j < dataShards; j++) {
+                    val ^= this.mul(matrix[r][j], shards[j][c]);
+                }
+                shards[r][c] = val;
+            }
+        }
+        return shards;
+    }
+    /**
+     * Decode data from a set of Reed-Solomon shards (data + parity).
+     *
+     * Shards should be provided in order of reliability: place higher-quality,
+     * more trustworthy shards first. The decoder selects the first `dataShards`
+     * non-null entries for recovery, so ordering by reliability ensures the
+     * most dependable shards are preferred. The implementation already handles
+     * missing (null) shards transparently via GF(2^8) matrix inversion.
+     *
+     * @param shards - Array of shard buffers (null for missing/corrupted shards)
+     * @param dataShards - Number of data shards (default 4)
+     * @param parityShards - Number of parity shards (default 2)
+     * @returns Reconstructed data as a single Uint8Array
+     */
+    static decode(shards, dataShards = 4, parityShards = 2) {
+        this.init();
+        const totalShards = dataShards + parityShards;
+        if (shards.length !== totalShards) {
+            throw new Error(`[RS] Expected ${totalShards} shards, got ${shards.length}`);
+        }
+        const presentIndices = [];
+        const presentShards = [];
+        for (let i = 0; i < totalShards; i++) {
+            if (shards[i] !== null && shards[i] !== undefined) {
+                presentIndices.push(i);
+                presentShards.push(shards[i]);
+                if (presentIndices.length === dataShards)
+                    break;
+            }
+        }
+        if (presentIndices.length < dataShards) {
+            throw new Error(`[RS] Not enough shards for recovery: need ${dataShards}, got ${presentIndices.length}`);
+        }
+        const shardSize = presentShards[0].length;
+        const origMatrix = this.buildVandermonde(totalShards, dataShards);
+        const subMatrix = [];
+        for (let i = 0; i < dataShards; i++) {
+            subMatrix.push([...origMatrix[presentIndices[i]]]);
+        }
+        const invMatrix = this.invertMatrix(subMatrix);
+        const result = new Uint8Array(shardSize * dataShards);
+        for (let c = 0; c < shardSize; c++) {
+            for (let r = 0; r < dataShards; r++) {
+                let val = 0;
+                for (let j = 0; j < dataShards; j++) {
+                    val ^= this.mul(invMatrix[r][j], presentShards[j][c]);
+                }
+                result[r * shardSize + c] = val;
+            }
+        }
+        return result;
+    }
+}
+exports.ReedSolomon = ReedSolomon;
+ReedSolomon.expTable = new Uint8Array(256);
+ReedSolomon.logTable = new Uint8Array(256);
+ReedSolomon.initialized = false;
+/**
+ * Static Vandermonde matrix cache keyed by "${totalShards}-${dataShards}".
+ * Avoids recomputing the GF(2^8) Vandermonde + inverse on every tick,
+ * which is the most expensive part of RS encoding/decoding.
+ */
+ReedSolomon.vandermondeCache = new Map();
+//# sourceMappingURL=reed_solomon.js.map

package/vendor/helm-crypto/reed_solomon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reed_solomon.js","sourceRoot":"","sources":["../src/reed_solomon.ts"],"names":[],"mappings":"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"}