openttt 0.2.6 → 0.2.8

package/dist/auto_mint.js

@@ -1,330 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AutoMintEngine = void 0;
-const ethers_1 = require("ethers");
-const time_synthesis_1 = require("./time_synthesis");
-const dynamic_fee_1 = require("./dynamic_fee");
-const evm_connector_1 = require("./evm_connector");
-const protocol_fee_1 = require("./protocol_fee");
-const pot_signer_1 = require("./pot_signer");
-const grg_forward_1 = require("./grg_forward");
-const types_1 = require("./types");
-const logger_1 = require("./logger");
-const errors_1 = require("./errors");
-/** Maximum retry attempts for RPC-dependent operations within a single tick */
-const MINT_TICK_MAX_RETRIES = 3;
-/** Backoff durations in ms for each retry attempt (1s, 2s, 4s) */
-const MINT_TICK_BACKOFF_MS = [1000, 2000, 4000];
-/**
- * AutoMintEngine - Automatic TTT minting engine.
- * Combines time synthesis, dynamic fee calculation, and EVM minting into a single loop.
- */
-class AutoMintEngine {
-    config;
-    timeSynthesis;
-    feeEngine;
-    evmConnector;
-    feeCollector = null;
-    timer = null;
-    isRunning = false;
-    isProcessing = false;
-    onMintCallback;
-    onFailureCallback;
-    onLatencyCallback;
-    cachedSigner = null;
-    consecutiveFailures = 0;
-    maxConsecutiveFailures = 5;
-    potSigner = null;
-    /** Monotonic counter appended to tokenId hash to prevent collision when two mints share the same nanosecond timestamp. */
-    mintNonce = BigInt(Date.now());
-    /** Fire the GRG >50ms performance warning at most once per engine session. */
-    warnedGrgSlow = false;
-    constructor(config) {
-        this.config = config;
-        this.timeSynthesis = new time_synthesis_1.TimeSynthesis({ sources: config.timeSources });
-        this.feeEngine = new dynamic_fee_1.DynamicFeeEngine({
-            cacheDurationMs: 5000,
-            fallbackPriceUsd: config.fallbackPriceUsd || 10000n,
-        });
-        this.evmConnector = new evm_connector_1.EVMConnector();
-        if (config.signer) {
-            this.cachedSigner = config.signer;
-        }
-        // Initialize Ed25519 PoT signer for non-repudiation
-        this.potSigner = config.potSignerKeyPath
-            ? pot_signer_1.PotSigner.createOrLoad(config.potSignerKeyPath)
-            : new pot_signer_1.PotSigner();
-    }
-    getEvmConnector() {
-        return this.evmConnector;
-    }
-    getTimeSynthesis() {
-        return this.timeSynthesis;
-    }
-    setOnMint(callback) {
-        this.onMintCallback = callback;
-    }
-    setOnFailure(callback) {
-        this.onFailureCallback = callback;
-    }
-    setOnLatency(callback) {
-        this.onLatencyCallback = callback;
-    }
-    /**
-     * Initialize the engine (RPC connection and contract setup).
-     */
-    async initialize() {
-        try {
-            const signerOrKey = this.config.signer || this.config.privateKey;
-            if (!signerOrKey)
-                throw new errors_1.TTTConfigError(errors_1.ERROR_CODES.CONFIG_MISSING_SIGNER, "[AutoMint] Signer or Private Key is required", "Missing both 'signer' and 'privateKey' in config", "Provide a valid ethers.Signer or a private key string in your configuration.");
-            await this.evmConnector.connect(this.config.rpcUrl, signerOrKey);
-            await this.feeEngine.connect(this.config.rpcUrl);
-            this.cachedSigner = this.evmConnector.getSigner();
-            const tttAbi = [
-                "function mint(address to, uint256 amount, bytes32 grgHash) external returns (bool)",
-                "function burn(uint256 amount, bytes32 grgHash, uint256 tier) external",
-                "function balanceOf(address account, uint256 id) external view returns (uint256)",
-                "event TTTMinted(address indexed to, uint256 indexed tokenId, uint256 amount)",
-                "event TTTBurned(address indexed from, uint256 indexed tokenId, uint256 amount, uint256 tier)",
-                // CT Log equivalent: every PoT is publicly auditable on-chain
-                evm_connector_1.EVMConnector.POT_ANCHORED_EVENT_ABI
-            ];
-            this.evmConnector.attachContract(this.config.contractAddress, tttAbi);
-            if (this.config.feeCollectorAddress) {
-                this.feeCollector = new protocol_fee_1.ProtocolFeeCollector(this.config.chainId, this.config.feeCollectorAddress, this.evmConnector, this.config.protocolFeeRecipient);
-                await this.feeCollector.validateChainId();
-            }
-        }
-        catch (error) {
-            // State rollback: Ensure connections are closed or reset
-            this.evmConnector = new evm_connector_1.EVMConnector();
-            this.cachedSigner = null;
-            this.feeCollector = null;
-            logger_1.logger.error(`[AutoMint] Initialization failed, state rolled back: ${error instanceof Error ? error.message : error}`);
-            throw error;
-        }
-    }
-    /**
-     * Start the automatic minting loop.
-     */
-    start() {
-        if (this.isRunning)
-            return;
-        // Clear existing timer if any
-        if (this.timer) {
-            clearInterval(this.timer);
-            this.timer = null;
-        }
-        const interval = types_1.TierIntervals[this.config.tier];
-        this.isRunning = true;
-        this.timer = setInterval(async () => {
-            if (this.isProcessing)
-                return;
-            this.isProcessing = true;
-            const tickStart = Date.now();
-            try {
-                await this.mintTick();
-                this.consecutiveFailures = 0;
-                // H2: Report latency to TTTClient
-                if (this.onLatencyCallback) {
-                    this.onLatencyCallback(Date.now() - tickStart);
-                }
-            }
-            catch (error) {
-                this.consecutiveFailures++;
-                // H2: Report failure to TTTClient
-                if (this.onFailureCallback) {
-                    this.onFailureCallback(error instanceof Error ? error : new Error(String(error)));
-                }
-                logger_1.logger.error(`[AutoMint] Tick execution failed (${this.consecutiveFailures}/${this.maxConsecutiveFailures}): ${error instanceof Error ? error.message : error}`);
-                if (this.consecutiveFailures >= this.maxConsecutiveFailures) {
-                    logger_1.logger.error(`[AutoMint] Circuit breaker triggered: ${this.consecutiveFailures} consecutive failures. Stopping engine to prevent DoS.`);
-                    this.stop();
-                }
-            }
-            finally {
-                this.isProcessing = false;
-            }
-        }, interval);
-        logger_1.logger.info(`[AutoMint] Loop started for tier ${this.config.tier} (${interval}ms)`);
-    }
-    /**
-     * Stop the automatic minting loop.
-     */
-    stop() {
-        if (this.timer) {
-            clearInterval(this.timer);
-            this.timer = null;
-        }
-        this.isRunning = false;
-        logger_1.logger.info(`[AutoMint] Loop stopped`);
-    }
-    /**
-     * Resume the minting loop after a circuit breaker trip.
-     * Resets the consecutive failure counter and restarts the loop.
-     */
-    resume() {
-        this.consecutiveFailures = 0;
-        logger_1.logger.info(`[AutoMint] Consecutive failures reset, resuming...`);
-        this.start();
-    }
-    /**
-     * Sleep helper for retry backoff.
-     */
-    sleep(ms) {
-        return new Promise(resolve => setTimeout(resolve, ms));
-    }
-    /**
-     * Execute a single mint tick.
-     * Time synthesis -> tokenId generation -> EVM mint call -> fee calculation/deduction.
-     */
-    async mintTick() {
-        // 1. Time Synthesis
-        const synthesized = await this.timeSynthesis.synthesize();
-        if (!synthesized) {
-            logger_1.logger.warn(`[AutoMint] Time synthesis returned null/undefined, skipping tick`);
-            return;
-        }
-        // Fix-12: Integrity check
-        if (synthesized.confidence === 0 || synthesized.stratum >= 16) {
-            throw new errors_1.TTTTimeSynthesisError(errors_1.ERROR_CODES.TIME_SYNTHESIS_INTEGRITY_FAILED, `[AutoMint] Synthesis integrity check failed`, `confidence=${synthesized.confidence}, stratum=${synthesized.stratum}`, `Check NTP sources or network connectivity.`);
-        }
-        // 1-1. PoT Generation & Validation (W1-1)
-        const pot = await this.timeSynthesis.generateProofOfTime();
-        if (pot.confidence < 0.5) {
-            throw new errors_1.TTTTimeSynthesisError(errors_1.ERROR_CODES.TIME_SYNTHESIS_INSUFFICIENT_CONFIDENCE, `[PoT] Insufficient confidence`, `Calculated confidence ${pot.confidence} is below required 0.5`, `Ensure more NTP sources are reachable or decrease uncertainty.`);
-        }
-        // Deterministic potHash via ABI.encode — field order is fixed,
-        // independent of JS engine key ordering. External verifiers can
-        // reproduce this hash from the same PoT fields.
-        const nonceHash = ethers_1.ethers.keccak256(ethers_1.ethers.toUtf8Bytes(pot.nonce));
-        const potHash = ethers_1.ethers.keccak256(ethers_1.ethers.AbiCoder.defaultAbiCoder().encode(["uint64", "uint64", "uint8", "uint8", "uint32", "bytes32"], [
-            pot.timestamp,
-            pot.expiresAt,
-            pot.sources,
-            pot.stratum,
-            Math.round(pot.confidence * 1_000_000),
-            nonceHash
-        ]));
-        // 1-2. Ed25519 issuer signature for non-repudiation
-        if (this.potSigner) {
-            pot.issuerSignature = this.potSigner.signPot(potHash);
-            logger_1.logger.info(`[AutoMint] PoT signed by issuer ${this.potSigner.getPubKeyHex().substring(0, 16)}...`);
-        }
-        // 2. Generate tokenId (keccak256)
-        // Unique ID based on chainId, poolAddress, timestamp, and a monotonic nonce
-        // to prevent collision if two mints occur at the same nanosecond timestamp.
-        const nonceSuffix = this.mintNonce;
-        this.mintNonce++;
-        const tokenId = ethers_1.ethers.keccak256(ethers_1.ethers.AbiCoder.defaultAbiCoder().encode(["uint256", "address", "uint64", "uint256"], [BigInt(this.config.chainId), this.config.poolAddress, synthesized.timestamp, nonceSuffix]));
-        // 3. Fee calculation
-        const feeCalculation = await this.feeEngine.calculateMintFee(this.config.tier);
-        // 4. EVM mint call — run GRG integrity pipeline
-        const grgPayload = ethers_1.ethers.AbiCoder.defaultAbiCoder().encode(["bytes32", "bytes32", "uint64", "uint8"], [tokenId, potHash, synthesized.timestamp, pot.sources]);
-        const grgStart = Date.now();
-        const grgShards = grg_forward_1.GrgForward.encode(ethers_1.ethers.getBytes(grgPayload), this.config.chainId, this.config.poolAddress);
-        const grgElapsed = Date.now() - grgStart;
-        logger_1.logger.info(`[AutoMint] GRG pipeline completed in ${grgElapsed}ms`);
-        if (grgElapsed > 50 && !this.warnedGrgSlow) {
-            this.warnedGrgSlow = true;
-            logger_1.logger.warn(`[AutoMint] GRG pipeline took ${grgElapsed}ms (>50ms threshold). Consider offloading to a Worker Thread for T3_micro tiers.`);
-        }
-        // On-chain hash = keccak256 of concatenated GRG-encoded shards
-        const grgHash = ethers_1.ethers.keccak256(ethers_1.ethers.concat(grgShards));
-        // Recipient address (defaults to signer address)
-        if (!this.cachedSigner) {
-            throw new errors_1.TTTSignerError(errors_1.ERROR_CODES.SIGNER_NOT_INITIALIZED, "[AutoMint] Signer not initialized", "cachedSigner is null", "Initialize the engine before calling mintTick().");
-        }
-        const recipient = await this.cachedSigner.getAddress();
-        logger_1.logger.info(`[AutoMint] Executing mint: tokenId=${tokenId.substring(0, 10)}... amount=${feeCalculation.tttAmount}`);
-        // Retry loop for RPC-dependent mint operation (max 3 attempts, backoff 1s/2s/4s)
-        let receipt;
-        let lastError = null;
-        for (let attempt = 0; attempt < MINT_TICK_MAX_RETRIES; attempt++) {
-            try {
-                receipt = await this.evmConnector.mintTTT(recipient, feeCalculation.tttAmount, grgHash, potHash);
-                lastError = null;
-                break;
-            }
-            catch (err) {
-                lastError = err instanceof Error ? err : new Error(String(err));
-                if (attempt < MINT_TICK_MAX_RETRIES - 1) {
-                    const backoff = MINT_TICK_BACKOFF_MS[attempt];
-                    logger_1.logger.warn(`[AutoMint] Mint attempt ${attempt + 1}/${MINT_TICK_MAX_RETRIES} failed, retrying in ${backoff}ms: ${lastError.message}`);
-                    await this.sleep(backoff);
-                }
-            }
-        }
-        if (lastError || !receipt) {
-            throw lastError || new Error("[AutoMint] Mint failed after all retries");
-        }
-        // 5. Fee deduction/recording (handled by contract or tracked at SDK level)
-        // W2-3: Actual ProtocolFeeCollector call
-        let actualFeePaid = feeCalculation.protocolFeeUsd;
-        if (this.feeCollector && this.config.feeCollectorAddress) {
-            try {
-                // NOTE: Single-threaded JS guarantees atomicity between nonce generation,
-                // signing, and collection below. If running multiple AutoMintEngine instances
-                // (e.g., worker_threads or cluster), a separate nonce manager with locking is required.
-                // Sequential nonce: query contract for current nonce, matching ProtocolFee.sol's require(nonces[msg.sender] == nonce)
-                const feeContract = new ethers_1.ethers.Contract(this.config.feeCollectorAddress, ["function getNonce(address) external view returns (uint256)"], this.evmConnector.getProvider());
-                const nonce = BigInt(await feeContract.getNonce(recipient));
-                const deadline = Math.floor(Date.now() / 1000) + 3600; // 1 hour validity
-                const signature = await this.signFeeMessage(feeCalculation, nonce, deadline);
-                const user = recipient;
-                await this.feeCollector.collectMintFee(feeCalculation, signature, user, nonce, deadline);
-            }
-            catch (feeError) {
-                logger_1.logger.error(`[AutoMint] Fee collection failed but mint was successful: ${feeError instanceof Error ? feeError.message : feeError}`);
-                // Reset to 0 so downstream (onMint callback, ledger) does not record a fee that was never collected
-                actualFeePaid = 0n;
-            }
-        }
-        // CT Log equivalent: log PoT anchor info for subgraph indexers
-        logger_1.logger.info(`[AutoMint] PoTAnchored: timestamp=${synthesized.timestamp}, grgHash=${grgHash}, stratum=${synthesized.stratum}, potHash=${potHash}`);
-        logger_1.logger.info(`[AutoMint] Mint success: tx=${receipt.hash}, feePaid=${actualFeePaid} (USDC eq)`);
-        if (this.onMintCallback) {
-            this.onMintCallback({
-                tokenId: tokenId,
-                grgHash: grgHash,
-                timestamp: synthesized.timestamp,
-                txHash: receipt.hash,
-                protocolFeePaid: actualFeePaid,
-                proofOfTime: pot
-            });
-        }
-    }
-    async signFeeMessage(feeCalc, nonce, deadline) {
-        if (!this.cachedSigner) {
-            throw new errors_1.TTTSignerError(errors_1.ERROR_CODES.SIGNER_NOT_INITIALIZED, "[AutoMint] Signer not initialized", "cachedSigner is null", "Ensure initialize() was called successfully.");
-        }
-        // Type casting to handle signTypedData if available on the signer (Wallet supports it)
-        const signer = this.cachedSigner;
-        if (typeof signer.signTypedData !== 'function') {
-            throw new errors_1.TTTSignerError(errors_1.ERROR_CODES.SIGNER_NO_EIP712, "[AutoMint] Provided signer does not support signTypedData (EIP-712)", `Signer type ${signer.constructor.name} missing signTypedData`, "Use a Wallet or a signer that implements EIP-712 signTypedData.");
-        }
-        const domain = {
-            name: "OpenTTT_ProtocolFee",
-            version: "1",
-            chainId: this.config.chainId,
-            verifyingContract: this.config.feeCollectorAddress
-        };
-        const types = {
-            CollectFee: [
-                { name: "token", type: "address" },
-                { name: "amount", type: "uint256" },
-                { name: "nonce", type: "uint256" },
-                { name: "deadline", type: "uint256" }
-            ]
-        };
-        const value = {
-            token: ethers_1.ethers.getAddress(feeCalc.feeTokenAddress),
-            amount: feeCalc.protocolFeeUsd,
-            nonce: nonce,
-            deadline: deadline
-        };
-        return await signer.signTypedData(domain, types, value);
-    }
-}
-exports.AutoMintEngine = AutoMintEngine;

package/dist/golay.d.ts

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

package/dist/golay.js

@@ -1,139 +0,0 @@
-"use strict";
-// sdk/src/golay.ts
-// Golay(24,12) Extended Binary Golay Code
-// 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.
-const P = [
-    0xC75, 0x49F, 0xD4B, 0x6E3, 0x9B3, 0xB66,
-    0xECC, 0x1ED, 0x3DA, 0x7B4, 0xB1D, 0xE3A
-];
-// P^T (transpose of P) — required for second syndrome computation.
-// P is NOT symmetric, so s2 = s*P^T must use this separate matrix.
-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
-];
-function weight(n) {
-    let count = 0;
-    let temp = n & 0xFFF;
-    while (temp > 0) {
-        temp &= (temp - 1);
-        count++;
-    }
-    return count;
-}
-function multiplyP(v) {
-    let res = 0;
-    for (let i = 0; i < 12; i++) {
-        if ((v >> (11 - i)) & 1) {
-            res ^= P[i];
-        }
-    }
-    return res & 0xFFF;
-}
-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;
-}
-function decodeWord(received) {
-    let r_m = (received >> 12) & 0xFFF;
-    const r_p = received & 0xFFF;
-    const s = multiplyP(r_m) ^ r_p;
-    if (s === 0)
-        return { msg: r_m, corrected: 0, uncorrectable: false };
-    if (weight(s) <= 3) {
-        return { msg: r_m, corrected: weight(s), uncorrectable: false };
-    }
-    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 };
-        }
-    }
-    const s2 = multiplyPT(s);
-    if (weight(s2) <= 3) {
-        return { msg: r_m ^ s2, corrected: weight(s2), uncorrectable: false };
-    }
-    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) {
-    const out = new Uint8Array(Math.ceil(data.length / 3) * 6);
-    let outIdx = 0;
-    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;
-        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) {
-            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) {
-    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 };
-}

package/dist/grg_forward.d.ts

@@ -1,7 +0,0 @@
-export declare class GrgForward {
-    static golombEncode(data: Uint8Array, m?: number): Uint8Array;
-    static redstuffEncode(data: Uint8Array, shards?: number, parity?: number): Uint8Array[];
-    static deriveHmacKey(chainId: number, poolAddress: string): Buffer;
-    static golayEncodeWrapper(data: Uint8Array, hmacKey: Buffer): Uint8Array;
-    static encode(data: Uint8Array, chainId: number, poolAddress: string): Uint8Array[];
-}

package/dist/grg_forward.js

@@ -1,68 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GrgForward = void 0;
-// sdk/src/grg_forward.ts
-const crypto_1 = require("crypto");
-const ethers_1 = require("ethers");
-const golay_1 = require("./golay");
-const reed_solomon_1 = require("./reed_solomon");
-class GrgForward {
-    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;
-    }
-    static redstuffEncode(data, shards = 4, parity = 2) {
-        return reed_solomon_1.ReedSolomon.encode(data, shards, parity);
-    }
-    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");
-    }
-    static golayEncodeWrapper(data, hmacKey) {
-        const encoded = (0, golay_1.golayEncode)(data);
-        const mac = (0, crypto_1.createHmac)("sha256", hmacKey).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) {
-        if (data.length === 0) {
-            throw new Error("[GRG] Cannot encode empty input — roundtrip identity violation");
-        }
-        const compressed = this.golombEncode(data);
-        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;

package/dist/grg_inverse.d.ts

@@ -1,7 +0,0 @@
-export declare class GrgInverse {
-    private static readonly MAX_GOLOMB_Q;
-    static golayDecodeWrapper(data: Uint8Array, hmacKey: Buffer): Uint8Array;
-    static redstuffDecode(shards: (Uint8Array | null)[], dataShardCount?: number, parityShardCount?: number): Uint8Array;
-    static golombDecode(data: Uint8Array, m?: number, originalLength?: number): Uint8Array;
-    static verify(data: Uint8Array, originalShards: Uint8Array[], chainId: number, poolAddress: string): boolean;
-}

package/dist/grg_inverse.js

@@ -1,93 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GrgInverse = void 0;
-// sdk/src/grg_inverse.ts
-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 {
-    static MAX_GOLOMB_Q = 1000000;
-    static golayDecodeWrapper(data, hmacKey) {
-        if (data.length < 8)
-            throw new Error("GRG shard too short for checksum");
-        const encoded = data.subarray(0, data.length - 8);
-        const checksum = data.subarray(data.length - 8);
-        const mac = (0, crypto_1.createHmac)("sha256", hmacKey).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");
-        }
-        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;
-    }
-    static redstuffDecode(shards, dataShardCount = 4, parityShardCount = 2) {
-        return reed_solomon_1.ReedSolomon.decode(shards, dataShardCount, parityShardCount);
-    }
-    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;
-        const readBit = (pos) => (data[pos >> 3] >> (7 - (pos & 7))) & 1;
-        const result = [];
-        let i = 0;
-        while (i < totalBits) {
-            if (originalLength !== undefined && result.length >= originalLength)
-                break;
-            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++;
-            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);
-            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;

package/dist/grg_pipeline.d.ts

@@ -1,5 +0,0 @@
-export declare class GrgPipeline {
-    private static readonly MAX_INPUT_SIZE;
-    static processForward(data: Uint8Array, chainId: number, poolAddress: string): Uint8Array[];
-    static processInverse(shards: (Uint8Array | null)[], originalLength: number, chainId: number, poolAddress: string): Uint8Array;
-}