openttt 0.2.7 → 0.2.9

package/dist/index.d.ts

@@ -1,12 +1,10 @@
 export * from "./evm_connector";
 export * from "./x402_enforcer";
-export * from "./ttt_builder";
 export * from "./protocol_fee";
 export * from "./pool_registry";
 export * from "./v4_hook";
 export * from "./logger";
 export * from "./types";
-export * from "./ttt_client";
 export * from "./http_client";
 export * from "./time_synthesis";
 export * from "./dynamic_fee";

package/dist/index.js

@@ -21,13 +21,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // 위 모듈은 서버 코드에서 직접 경로로 import할 것.
 __exportStar(require("./evm_connector"), exports);
 __exportStar(require("./x402_enforcer"), exports);
-__exportStar(require("./ttt_builder"), exports);
+// ttt_builder omitted — requires adaptive_switch (server-internal, not in public SDK)
 __exportStar(require("./protocol_fee"), exports);
 __exportStar(require("./pool_registry"), exports);
 __exportStar(require("./v4_hook"), exports);
 __exportStar(require("./logger"), exports);
 __exportStar(require("./types"), exports);
-__exportStar(require("./ttt_client"), exports);
+// ttt_client omitted — requires auto_mint (server-internal, not in public SDK)
 __exportStar(require("./http_client"), exports);
 __exportStar(require("./time_synthesis"), exports);
 __exportStar(require("./dynamic_fee"), exports);

package/dist/integrity_client.d.ts

@@ -14,8 +14,10 @@ export interface IntegrityVerifyResult {
 export declare class IntegrityClient {
     private baseUrl;
     private timeoutMs;
+    private apiKey;
     constructor(baseUrl?: string, options?: {
         timeoutMs?: number;
+        apiKey?: string;
     });
     /**
      * Forward pass: encode data through integrity pipeline (server-side).

package/dist/integrity_client.js

@@ -12,9 +12,11 @@ exports.setDefaultIntegrityClient = setDefaultIntegrityClient;
 class IntegrityClient {
     baseUrl;
     timeoutMs;
+    apiKey;
     constructor(baseUrl = "https://integrity.helmprotocol.com/api/v1", options) {
         this.baseUrl = baseUrl.replace(/\/$/, "");
         this.timeoutMs = options?.timeoutMs ?? 5000;
+        this.apiKey = options?.apiKey ?? (typeof process !== "undefined" ? process.env["INTEGRITY_API_KEY"] : undefined);
     }
     /**
      * Forward pass: encode data through integrity pipeline (server-side).
@@ -27,7 +29,10 @@ class IntegrityClient {
         try {
             const resp = await fetch(`${this.baseUrl}/encode`, {
                 method: "POST",
-                headers: { "Content-Type": "application/json" },
+                headers: {
+                    "Content-Type": "application/json",
+                    ...(this.apiKey ? { "X-Integrity-Key": this.apiKey } : {}),
+                },
                 body: JSON.stringify({
                     data: Buffer.from(data).toString("hex"),
                     chainId: chainId,
@@ -56,7 +61,10 @@ class IntegrityClient {
         try {
             const resp = await fetch(`${this.baseUrl}/verify`, {
                 method: "POST",
-                headers: { "Content-Type": "application/json" },
+                headers: {
+                    "Content-Type": "application/json",
+                    ...(this.apiKey ? { "X-Integrity-Key": this.apiKey } : {}),
+                },
                 body: JSON.stringify({
                     data: Buffer.from(data).toString("hex"),
                     shards: originalShards.map((s) => Buffer.from(s).toString("hex")),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openttt",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "OpenTTT — TLS-grade transaction ordering for DeFi. Time + Logic + Sync.",
   "license": "BSL-1.1",
   "repository": {
@@ -30,7 +30,50 @@
     }
   },
   "files": [
-    "dist",
+    "dist/ct_log.js",
+    "dist/ct_log.d.ts",
+    "dist/dynamic_fee.js",
+    "dist/dynamic_fee.d.ts",
+    "dist/errors.js",
+    "dist/errors.d.ts",
+    "dist/evm_connector.js",
+    "dist/evm_connector.d.ts",
+    "dist/http_client.js",
+    "dist/http_client.d.ts",
+    "dist/index.js",
+    "dist/index.d.ts",
+    "dist/integrity_client.js",
+    "dist/integrity_client.d.ts",
+    "dist/logger.js",
+    "dist/logger.d.ts",
+    "dist/networks.js",
+    "dist/networks.d.ts",
+    "dist/osnma_source.js",
+    "dist/osnma_source.d.ts",
+    "dist/pool_registry.js",
+    "dist/pool_registry.d.ts",
+    "dist/pot_signer.js",
+    "dist/pot_signer.d.ts",
+    "dist/protocol_fee.js",
+    "dist/protocol_fee.d.ts",
+    "dist/revenue_tiers.js",
+    "dist/revenue_tiers.d.ts",
+    "dist/signer.js",
+    "dist/signer.d.ts",
+    "dist/time_synthesis.js",
+    "dist/time_synthesis.d.ts",
+    "dist/trust_store.js",
+    "dist/trust_store.d.ts",
+    "dist/ttt_builder.js",
+    "dist/ttt_builder.d.ts",
+    "dist/ttt_client.js",
+    "dist/ttt_client.d.ts",
+    "dist/types.js",
+    "dist/types.d.ts",
+    "dist/v4_hook.js",
+    "dist/v4_hook.d.ts",
+    "dist/x402_enforcer.js",
+    "dist/x402_enforcer.d.ts",
     "README.md"
   ],
   "scripts": {

package/dist/adaptive_switch.d.ts

@@ -1,59 +0,0 @@
-export declare enum AdaptiveMode {
-    TURBO = "TURBO",// 50ms — Valid sequence, low latency
-    FULL = "FULL"
-}
-export interface TTTRecord {
-    time: number;
-    txOrder: string[];
-    grgPayload: Uint8Array[];
-}
-export interface Block {
-    timestamp: number;
-    txs: string[];
-    data: Uint8Array;
-}
-/** Tier-based dynamic tolerance (ms) — auditor-requested upgrade */
-export declare const TIER_TOLERANCE_MS: Record<string, number>;
-export declare class AdaptiveSwitch {
-    private windowSize;
-    private threshold;
-    private history;
-    private currentMode;
-    private minBlocks;
-    private penaltyCooldown;
-    private consecutiveFailures;
-    private turboEntryThreshold;
-    private turboMaintainThreshold;
-    private tolerance;
-    constructor(options?: {
-        tolerance?: number;
-    });
-    /**
-     * Core TTT mechanism: switches between Turbo/Full mode based on timestamp ordering match rate.
-     */
-    verifyBlock(block: Block, tttRecord: TTTRecord, chainId: number, poolAddress: string, tier?: string): AdaptiveMode;
-    /**
-     * Return fee discount rate based on current mode.
-     * TURBO: 20% discount (incentivizes profitability).
-     * FULL: No discount.
-     */
-    getFeeDiscount(): number;
-    /**
-     * Get current adaptive mode.
-     */
-    getCurrentMode(): AdaptiveMode;
-    /**
-     * Reset history (for testing).
-     */
-    reset(): void;
-    /**
-     * Serialize internal state to JSON for persistence across restarts.
-     * Allows operators to avoid re-learning over 20 blocks after a restart.
-     */
-    serialize(): string;
-    /**
-     * Reconstruct an AdaptiveSwitch from previously serialized JSON state.
-     */
-    static deserialize(json: string): AdaptiveSwitch;
-    private compareTransactionOrder;
-}

package/dist/adaptive_switch.js

@@ -1,145 +0,0 @@
-"use strict";
-// sdk/src/adaptive_switch.ts — Adaptive Mode Switcher
-// Turbo (50ms) vs Full (127ms)
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AdaptiveSwitch = exports.TIER_TOLERANCE_MS = exports.AdaptiveMode = void 0;
-const grg_inverse_1 = require("./grg_inverse");
-const logger_1 = require("./logger");
-var AdaptiveMode;
-(function (AdaptiveMode) {
-    AdaptiveMode["TURBO"] = "TURBO";
-    AdaptiveMode["FULL"] = "FULL";
-})(AdaptiveMode || (exports.AdaptiveMode = AdaptiveMode = {}));
-// const TOLERANCE = 100; // 100ms tolerance for GEO-sat operator sync (now configurable via constructor)
-/** Tier-based dynamic tolerance (ms) — auditor-requested upgrade */
-exports.TIER_TOLERANCE_MS = {
-    T0_epoch: 2000, // 6.4min tick → 2s tolerance
-    T1_block: 200, // 2s tick → 200ms
-    T2_slot: 500, // 12s tick → 500ms
-    T3_micro: 10, // 100ms tick → 10ms (10%)
-};
-class AdaptiveSwitch {
-    windowSize = 20; // B1-9: Updated from 10 to 20
-    threshold = 0.9; // B1-9: Updated from 0.8 to 0.9
-    history = [];
-    currentMode = AdaptiveMode.FULL;
-    minBlocks = 20; // B1-9: Minimum blocks for TURBO transition
-    penaltyCooldown = 0; // B1-9: Penalty cooldown (P2-1: increased to 20 + exponential backoff)
-    consecutiveFailures = 0; // P2-1: Track consecutive failures for exponential backoff
-    turboEntryThreshold = 0.95; // P2-2: Hysteresis — stricter entry
-    turboMaintainThreshold = 0.85; // P2-2: Hysteresis — relaxed maintenance
-    tolerance;
-    constructor(options) {
-        this.tolerance = options?.tolerance ?? 100;
-    }
-    /**
-     * Core TTT mechanism: switches between Turbo/Full mode based on timestamp ordering match rate.
-     */
-    verifyBlock(block, tttRecord, chainId, poolAddress, tier) {
-        // 1. Check timestamp ordering and time match
-        const orderMatch = this.compareTransactionOrder(block.txs, tttRecord.txOrder);
-        const tolerance = tier ? (exports.TIER_TOLERANCE_MS[tier] ?? this.tolerance) : this.tolerance;
-        const timeMatch = Math.abs(block.timestamp - tttRecord.time) < tolerance;
-        let sequenceOk = orderMatch && timeMatch;
-        // B1-1: Do not skip GrgInverse.verify() in TURBO mode
-        // We check integrity regardless of mode
-        const integrityOk = grg_inverse_1.GrgInverse.verify(block.data, tttRecord.grgPayload, chainId, poolAddress);
-        if (!integrityOk) {
-            logger_1.logger.error(`[AdaptiveSwitch] GRG integrity check FAILED`);
-            sequenceOk = false; // Mark as false if integrity fails
-            if (this.currentMode === AdaptiveMode.TURBO) {
-                logger_1.logger.warn(`[AdaptiveSwitch] TURBO integrity failure: Penalty cooldown applied`);
-                // P2-1: Exponential backoff — 20 * 2^(consecutiveFailures), capped at 320
-                this.consecutiveFailures = Math.min(this.consecutiveFailures + 1, 4);
-                this.penaltyCooldown = 20 * Math.pow(2, this.consecutiveFailures - 1); // 20, 40, 80, 160, 320
-            }
-        }
-        // 2. Update history (Sliding Window)
-        this.history.push(sequenceOk);
-        if (this.history.length > this.windowSize) {
-            this.history.shift();
-        }
-        if (this.penaltyCooldown > 0) {
-            this.penaltyCooldown--;
-        }
-        // 3. Calculate match rate and switch mode
-        const matchCount = this.history.filter(h => h).length;
-        const matchRate = this.history.length > 0 ? matchCount / this.history.length : 0;
-        // P2-2: Hysteresis — different thresholds for entering vs maintaining TURBO
-        const effectiveThreshold = this.currentMode === AdaptiveMode.TURBO
-            ? this.turboMaintainThreshold // 85% to stay in TURBO
-            : this.turboEntryThreshold; // 95% to enter TURBO
-        if (this.history.length >= this.minBlocks && matchRate >= effectiveThreshold && this.penaltyCooldown === 0) {
-            if (this.currentMode === AdaptiveMode.FULL) {
-                logger_1.logger.info(`[AdaptiveSwitch] Switching to TURBO mode (Match rate: ${(matchRate * 100).toFixed(1)}%, Entry threshold: ${(this.turboEntryThreshold * 100).toFixed(0)}%)`);
-            }
-            this.currentMode = AdaptiveMode.TURBO;
-            this.consecutiveFailures = 0; // P2-1: Reset on successful TURBO
-        }
-        else {
-            if (this.currentMode === AdaptiveMode.TURBO) {
-                logger_1.logger.warn(`[AdaptiveSwitch] Switching to FULL mode (Match rate: ${(matchRate * 100).toFixed(1)}%, Maintain threshold: ${(this.turboMaintainThreshold * 100).toFixed(0)}%, Cooldown: ${this.penaltyCooldown})`);
-            }
-            this.currentMode = AdaptiveMode.FULL;
-        }
-        return this.currentMode;
-    }
-    /**
-     * Return fee discount rate based on current mode.
-     * TURBO: 20% discount (incentivizes profitability).
-     * FULL: No discount.
-     */
-    getFeeDiscount() {
-        return this.currentMode === AdaptiveMode.TURBO ? 0.2 : 0.0;
-    }
-    /**
-     * Get current adaptive mode.
-     */
-    getCurrentMode() {
-        return this.currentMode;
-    }
-    /**
-     * Reset history (for testing).
-     */
-    reset() {
-        this.history = [];
-        this.currentMode = AdaptiveMode.FULL;
-        this.penaltyCooldown = 0;
-        this.consecutiveFailures = 0;
-    }
-    /**
-     * Serialize internal state to JSON for persistence across restarts.
-     * Allows operators to avoid re-learning over 20 blocks after a restart.
-     */
-    serialize() {
-        return JSON.stringify({
-            history: this.history,
-            currentMode: this.currentMode,
-            consecutiveFailures: this.consecutiveFailures,
-            penaltyCooldown: this.penaltyCooldown,
-            tolerance: this.tolerance,
-        });
-    }
-    /**
-     * Reconstruct an AdaptiveSwitch from previously serialized JSON state.
-     */
-    static deserialize(json) {
-        const data = JSON.parse(json);
-        const instance = new AdaptiveSwitch({ tolerance: data.tolerance ?? 100 });
-        instance.history = data.history;
-        instance.currentMode = data.currentMode;
-        instance.consecutiveFailures = data.consecutiveFailures;
-        instance.penaltyCooldown = data.penaltyCooldown;
-        return instance;
-    }
-    compareTransactionOrder(blockTxs, expectedOrder) {
-        if (blockTxs.length !== expectedOrder.length)
-            return false;
-        for (let i = 0; i < blockTxs.length; i++) {
-            if (blockTxs[i] !== expectedOrder[i])
-                return false;
-        }
-        return true;
-    }
-}
-exports.AdaptiveSwitch = AdaptiveSwitch;

package/dist/auto_mint.d.ts

@@ -1,61 +0,0 @@
-import { TimeSynthesis } from "./time_synthesis";
-import { EVMConnector } from "./evm_connector";
-import { AutoMintConfig, MintResult } from "./types";
-/**
- * AutoMintEngine - Automatic TTT minting engine.
- * Combines time synthesis, dynamic fee calculation, and EVM minting into a single loop.
- */
-export declare class AutoMintEngine {
-    private config;
-    private timeSynthesis;
-    private feeEngine;
-    private evmConnector;
-    private feeCollector;
-    private timer;
-    private isRunning;
-    private isProcessing;
-    private onMintCallback?;
-    private onFailureCallback?;
-    private onLatencyCallback?;
-    private cachedSigner;
-    private consecutiveFailures;
-    private maxConsecutiveFailures;
-    private potSigner;
-    /** Monotonic counter appended to tokenId hash to prevent collision when two mints share the same nanosecond timestamp. */
-    private mintNonce;
-    /** Fire the GRG >50ms performance warning at most once per engine session. */
-    private warnedGrgSlow;
-    constructor(config: AutoMintConfig);
-    getEvmConnector(): EVMConnector;
-    getTimeSynthesis(): TimeSynthesis;
-    setOnMint(callback: (result: MintResult) => void): void;
-    setOnFailure(callback: (error: Error) => void): void;
-    setOnLatency(callback: (ms: number) => void): void;
-    /**
-     * Initialize the engine (RPC connection and contract setup).
-     */
-    initialize(): Promise<void>;
-    /**
-     * Start the automatic minting loop.
-     */
-    start(): void;
-    /**
-     * Stop the automatic minting loop.
-     */
-    stop(): void;
-    /**
-     * Resume the minting loop after a circuit breaker trip.
-     * Resets the consecutive failure counter and restarts the loop.
-     */
-    resume(): void;
-    /**
-     * Sleep helper for retry backoff.
-     */
-    private sleep;
-    /**
-     * Execute a single mint tick.
-     * Time synthesis -> tokenId generation -> EVM mint call -> fee calculation/deduction.
-     */
-    mintTick(): Promise<void>;
-    private signFeeMessage;
-}