openttt 0.2.8 → 0.2.10

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,7 +1,7 @@
 {
   "name": "openttt",
-  "version": "0.2.8",
-  "description": "OpenTTT — TLS-grade transaction ordering for DeFi. Time + Logic + Sync.",
+  "version": "0.2.10",
+  "description": "OpenTTT \u2014 TLS-grade transaction ordering for DeFi. Time + Logic + Sync.",
   "license": "BSL-1.1",
   "repository": {
     "type": "git",
@@ -13,7 +13,6 @@
     "ttt",
     "proof-of-time",
     "transaction-ordering",
-    "grg",
     "base",
     "ethereum"
   ],
@@ -64,10 +63,6 @@
     "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",

package/dist/ttt_builder.d.ts

@@ -1,32 +0,0 @@
-import { AdaptiveMode, Block, TTTRecord } from "./adaptive_switch";
-import { EVMConnector } from "./evm_connector";
-export declare class TTTBuilder {
-    private mode;
-    private connector;
-    private tttBalance;
-    private adaptiveSwitch;
-    constructor(connector?: EVMConnector);
-    /**
-     * Purchase TTT from the market using EVMConnector.
-     * P1-5: Router/token addresses configurable. P1-6: 5% slippage protection.
-     */
-    purchaseTTT(poolAddress: string, amount: bigint, tokenInAddress?: string, routerAddress?: string, slippageBps?: bigint): Promise<void>;
-    /**
-     * Apply TTT to a block by burning it.
-     * This signals the intention to use TTT for prioritized processing.
-     */
-    consumeTick(tokenId: string, tier?: string): Promise<void>;
-    /**
-     * Verify block data using the AdaptiveSwitch pipeline.
-     * Updates the current mode based on verification results.
-     */
-    verifyBlock(blockData: Block, tttRecord: TTTRecord, chainId: number, poolAddress: string, tier?: string): Promise<AdaptiveMode>;
-    /**
-     * Return the current TURBO/FULL mode.
-     */
-    getMode(): AdaptiveMode;
-    /**
-     * Helper to get current balance (for testing).
-     */
-    getBalance(): bigint;
-}

package/dist/ttt_builder.js

@@ -1,84 +0,0 @@
-"use strict";
-// sdk/src/ttt_builder.ts — TTT Builder Implementation
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TTTBuilder = void 0;
-const ethers_1 = require("ethers");
-const adaptive_switch_1 = require("./adaptive_switch");
-const evm_connector_1 = require("./evm_connector");
-const dynamic_fee_1 = require("./dynamic_fee");
-const logger_1 = require("./logger");
-class TTTBuilder {
-    mode = adaptive_switch_1.AdaptiveMode.FULL;
-    connector;
-    tttBalance = 0n;
-    adaptiveSwitch;
-    constructor(connector) {
-        this.connector = connector || new evm_connector_1.EVMConnector();
-        this.adaptiveSwitch = new adaptive_switch_1.AdaptiveSwitch();
-    }
-    /**
-     * Purchase TTT from the market using EVMConnector.
-     * P1-5: Router/token addresses configurable. P1-6: 5% slippage protection.
-     */
-    async purchaseTTT(poolAddress, amount, tokenInAddress = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", routerAddress = "0x11C9e42994625A0F52906852A9b91e1B69B79B22", slippageBps = 500n // 5% default slippage protection
-    ) {
-        logger_1.logger.info(`[TTTBuilder] Purchasing ${amount} TTT from pool: ${poolAddress}`);
-        // P1-6: Calculate minimum output with slippage protection
-        const minAmountOut = (amount * (10000n - slippageBps)) / 10000n;
-        const receipt = await this.connector.swap(routerAddress, tokenInAddress, poolAddress, amount, minAmountOut);
-        this.tttBalance += amount;
-        logger_1.logger.info(`[TTTBuilder] Purchase successful. TX: ${receipt.hash}. Current balance: ${this.tttBalance}`);
-    }
-    /**
-     * Apply TTT to a block by burning it.
-     * This signals the intention to use TTT for prioritized processing.
-     */
-    async consumeTick(tokenId, tier = "T1_block") {
-        logger_1.logger.info(`[TTTBuilder] Consuming TTT tick for token: ${tokenId} (Tier: ${tier})`);
-        // Look up tier-based costs from TIER_USD_MICRO
-        // Use BigInt to avoid floating point precision issues (Scale: 1e18)
-        const usdCostFactor = dynamic_fee_1.TIER_USD_MICRO[tier] || 10000n; // default 0.01 USD
-        let costTTT = (usdCostFactor * (10n ** 12n)); // Convert to 18 decimals (1e6 * 1e12 = 1e18)
-        // Apply discount if in TURBO mode (Economic incentive for honest builders)
-        // R2-P2-3: Use integer-only discount map to avoid float→BigInt precision loss
-        const DISCOUNT_PERMILLE = { "TURBO": 200n, "FULL": 0n };
-        const discountPermille = DISCOUNT_PERMILLE[this.adaptiveSwitch.getCurrentMode()] ?? 0n;
-        if (discountPermille > 0n) {
-            costTTT = (costTTT * (1000n - discountPermille)) / 1000n;
-            logger_1.logger.info(`[TTTBuilder] TURBO discount applied: ${Number(discountPermille) / 10}%. Final cost: ${costTTT}`);
-        }
-        if (this.tttBalance < costTTT) {
-            throw new Error(`[TTTBuilder] Insufficient TTT balance to consume tick. Needed: ${costTTT}, Balance: ${this.tttBalance}`);
-        }
-        // Call the actual burn function on the TTT contract via the connector.
-        const grgHash = ethers_1.ethers.keccak256(ethers_1.ethers.toUtf8Bytes(tokenId));
-        const tierLevel = parseInt(tier.substring(1, 2)) || 1;
-        await this.connector.burnTTT(costTTT, grgHash, tierLevel);
-        this.tttBalance -= costTTT;
-        logger_1.logger.info(`[TTTBuilder] Tick consumed. Cost: ${costTTT}. Remaining balance: ${this.tttBalance}`);
-    }
-    /**
-     * Verify block data using the AdaptiveSwitch pipeline.
-     * Updates the current mode based on verification results.
-     */
-    async verifyBlock(blockData, tttRecord, chainId, poolAddress, tier) {
-        logger_1.logger.info(`[TTTBuilder] Verifying block at timestamp: ${blockData.timestamp}`);
-        const result = this.adaptiveSwitch.verifyBlock(blockData, tttRecord, chainId, poolAddress, tier);
-        this.mode = result;
-        logger_1.logger.info(`[TTTBuilder] Verification complete. Mode: ${this.mode}`);
-        return this.mode;
-    }
-    /**
-     * Return the current TURBO/FULL mode.
-     */
-    getMode() {
-        return this.mode;
-    }
-    /**
-     * Helper to get current balance (for testing).
-     */
-    getBalance() {
-        return this.tttBalance;
-    }
-}
-exports.TTTBuilder = TTTBuilder;

package/dist/ttt_client.d.ts

@@ -1,131 +0,0 @@
-import { EventEmitter } from "events";
-import { AutoMintConfig, TTTClientConfig, MintResult, HealthStatus } from "./types";
-import { HttpOnlyClient, HttpOnlyClientOptions } from "./http_client";
-export { HealthStatus } from "./types";
-/**
- * Typed event map for TTTClient EventEmitter.
- */
-export interface TTTClientEvents {
-    mint: [result: MintResult];
-    error: [error: Error];
-    alert: [alert: string];
-    latency: [ms: number];
-    modeSwitch: [mode: string];
-}
-/**
- * TTTClient - SDK entry point for DEX operators.
- * Initializes all internal modules and manages the auto-minting process.
- */
-export declare class TTTClient extends EventEmitter {
-    private config;
-    private autoMintEngine;
-    private poolRegistry;
-    private isInitialized;
-    private mintCount;
-    private mintFailures;
-    private totalFeesPaid;
-    private signer;
-    private lastTokenId;
-    private mintLatencies;
-    private maxLatencyHistory;
-    private lastMintAt;
-    private startedAt;
-    private minBalanceWei;
-    constructor(config: AutoMintConfig);
-    /**
-     * Static factory for Base Mainnet
-     */
-    static forBase(config: Omit<TTTClientConfig, 'network'>): Promise<TTTClient>;
-    /**
-     * Static factory for Base Sepolia
-     */
-    static forSepolia(config: Omit<TTTClientConfig, 'network'>): Promise<TTTClient>;
-    /**
-     * Zero-friction sandbox mode — no ETH, no signer, no on-chain interaction.
-     *
-     * Returns an HttpOnlyClient that fetches verified time from NIST, Apple,
-     * Google, and Cloudflare HTTPS endpoints and produces HMAC-signed PoTs.
-     *
-     * @example
-     * // Zero-friction: no wallet, no RPC, no gas
-     * const client = TTTClient.httpOnly();
-     * const pot = await client.generatePoT();
-     * console.log(pot.timestamp, pot.confidence);
-     *
-     * // Verify locally (no on-chain check needed)
-     * const result = client.verifyPoT(pot);
-     * console.log(result.valid); // true
-     */
-    static httpOnly(options?: HttpOnlyClientOptions): HttpOnlyClient;
-    /**
-     * Universal factory to create and initialize a client
-     */
-    static create(config: TTTClientConfig): Promise<TTTClient>;
-    /**
-     * Gracefully shuts down the SDK, stopping all background processes and listeners.
-     */
-    destroy(): Promise<void>;
-    /**
-     * Initialize the SDK: RPC connection, time sources, fee engine wiring.
-     */
-    initialize(): Promise<void>;
-    /**
-     * Start the auto-minting process.
-     */
-    startAutoMint(): void;
-    /**
-     * Stop the auto-minting process.
-     */
-    stopAutoMint(): void;
-    /**
-     * Resume auto-minting after a circuit breaker trip.
-     * Resets consecutive failure count and restarts the engine.
-     */
-    resume(): void;
-    /**
-     * List registered pools.
-     */
-    listPools(): string[];
-    /**
-     * Get stats for a specific pool.
-     */
-    getPoolStats(poolAddress: string): {
-        minted: bigint;
-        burned: bigint;
-    } | null;
-    /**
-     * Set minimum ETH balance threshold for health alerts.
-     */
-    setMinBalance(weiAmount: bigint): void;
-    /**
-     * Register alert callback for real-time notifications.
-     * Backward compatible: delegates to EventEmitter 'alert' event.
-     */
-    onAlert(callback: (alert: string) => void): void;
-    private emitAlert;
-    /**
-     * Record a mint failure (called internally or externally).
-     */
-    recordMintFailure(): void;
-    /**
-     * Record mint latency in ms (called from auto-mint wrapper).
-     */
-    recordMintLatency(ms: number): void;
-    /**
-     * Production health check — liveness + readiness + metrics.
-     * No exceptions: always returns a HealthStatus object.
-     */
-    getHealth(): Promise<HealthStatus>;
-    /**
-     * Return current SDK status and statistics (balance, mint count, fees, etc.)
-     */
-    getStatus(): Promise<{
-        isInitialized: boolean;
-        tier: string;
-        mintCount: number;
-        totalFeesPaid: string;
-        balance: string;
-        tttBalance: string;
-        lastTokenId: string | null;
-    }>;
-}

package/dist/ttt_client.js

@@ -1,441 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TTTClient = void 0;
-const ethers_1 = require("ethers");
-const events_1 = require("events");
-const auto_mint_1 = require("./auto_mint");
-const types_1 = require("./types");
-const logger_1 = require("./logger");
-const pool_registry_1 = require("./pool_registry");
-const networks_1 = require("./networks");
-const signer_1 = require("./signer");
-const http_client_1 = require("./http_client");
-/**
- * TTTClient - SDK entry point for DEX operators.
- * Initializes all internal modules and manages the auto-minting process.
- */
-class TTTClient extends events_1.EventEmitter {
-    config;
-    autoMintEngine;
-    poolRegistry;
-    isInitialized = false;
-    mintCount = 0;
-    mintFailures = 0;
-    totalFeesPaid = 0n;
-    signer = null;
-    lastTokenId = null;
-    mintLatencies = [];
-    maxLatencyHistory;
-    lastMintAt = null;
-    startedAt = new Date();
-    minBalanceWei = ethers_1.ethers.parseEther("0.01"); // 0.01 ETH alert threshold
-    constructor(config) {
-        super();
-        this.config = config;
-        this.maxLatencyHistory = config.maxLatencyHistory ?? 100;
-        this.autoMintEngine = new auto_mint_1.AutoMintEngine(config);
-        this.poolRegistry = new pool_registry_1.PoolRegistry();
-        // Wire callbacks to update stats + emit events
-        this.autoMintEngine.setOnMint((result) => {
-            this.mintCount++;
-            this.totalFeesPaid += result.protocolFeePaid;
-            this.lastTokenId = result.tokenId;
-            this.lastMintAt = new Date();
-            // Record in registry
-            this.poolRegistry.recordMint(this.config.poolAddress, 1n);
-            // Emit typed 'mint' event
-            this.emit('mint', result);
-        });
-        // Wire failure/latency metrics from AutoMint loop to TTTClient
-        this.autoMintEngine.setOnFailure((error) => {
-            this.mintFailures++;
-            this.emit('error', error);
-        });
-        this.autoMintEngine.setOnLatency((ms) => {
-            this.mintLatencies.push(ms);
-            if (this.mintLatencies.length > this.maxLatencyHistory) {
-                this.mintLatencies.shift();
-            }
-            this.emit('latency', ms);
-        });
-    }
-    /**
-     * Static factory for Base Mainnet
-     */
-    static async forBase(config) {
-        return this.create({ ...config, network: 'base' });
-    }
-    /**
-     * Static factory for Base Sepolia
-     */
-    static async forSepolia(config) {
-        return this.create({ ...config, network: 'sepolia' });
-    }
-    /**
-     * Zero-friction sandbox mode — no ETH, no signer, no on-chain interaction.
-     *
-     * Returns an HttpOnlyClient that fetches verified time from NIST, Apple,
-     * Google, and Cloudflare HTTPS endpoints and produces HMAC-signed PoTs.
-     *
-     * @example
-     * // Zero-friction: no wallet, no RPC, no gas
-     * const client = TTTClient.httpOnly();
-     * const pot = await client.generatePoT();
-     * console.log(pot.timestamp, pot.confidence);
-     *
-     * // Verify locally (no on-chain check needed)
-     * const result = client.verifyPoT(pot);
-     * console.log(result.valid); // true
-     */
-    static httpOnly(options) {
-        return new http_client_1.HttpOnlyClient(options);
-    }
-    /**
-     * Universal factory to create and initialize a client
-     */
-    static async create(config) {
-        // 0. Shorthand: privateKey string -> SignerConfig
-        if (config.privateKey && !config.signer) {
-            const key = config.privateKey.startsWith('0x') ? config.privateKey : '0x' + config.privateKey;
-            config = { ...config, signer: { type: 'privateKey', key } };
-        }
-        // 0.5. Validation: require either signer or privateKey
-        if (!config.signer) {
-            throw new Error('TTTClient requires either `signer` or `privateKey`. Simplest: TTTClient.forBase({ privateKey: process.env.OPERATOR_PK! })');
-        }
-        // 0.7. Validate tier — CRITICAL: invalid tier causes setInterval(fn, undefined) = 1ms loop = wallet drain
-        const tier = config.tier || "T1_block";
-        if (!types_1.TierIntervals[tier]) {
-            const validTiers = Object.keys(types_1.TierIntervals).join(', ');
-            throw new Error(`[TTTClient] Invalid tier "${tier}". Valid tiers: ${validTiers}`);
-        }
-        // 0.8. Validate fee rate bounds
-        if (config.protocolFeeRate !== undefined) {
-            if (config.protocolFeeRate < 0 || config.protocolFeeRate > 1) {
-                throw new Error(`[TTTClient] protocolFeeRate must be 0-1 (got ${config.protocolFeeRate}). Example: 0.05 = 5%`);
-            }
-        }
-        // 0.9. Validate network string
-        if (typeof config.network === 'string' && !networks_1.NETWORKS[config.network]) {
-            const validNets = Object.keys(networks_1.NETWORKS).join(', ');
-            throw new Error(`[TTTClient] Unknown network "${config.network}". Valid: ${validNets}. Or pass a custom NetworkConfig object.`);
-        }
-        // 1. Resolve network defaults
-        let net;
-        if (typeof config.network === 'string') {
-            net = networks_1.NETWORKS[config.network];
-        }
-        else if (config.network) {
-            net = config.network;
-        }
-        else {
-            net = networks_1.NETWORKS.base;
-        }
-        // 2. Create signer via abstraction
-        const abstractSigner = await (0, signer_1.createSigner)(config.signer);
-        const signer = abstractSigner.inner;
-        // 2.5. Validate addresses — prevent accidental mainnet zero-address usage
-        const contractAddr = config.contractAddress || net.tttAddress;
-        if (contractAddr === "0x0000000000000000000000000000000000000000") {
-            throw new Error("[TTTClient] TTT contract address is zero address. On Base Mainnet, you must provide contractAddress in config (contracts not yet deployed).");
-        }
-        // 3. Build AutoMintConfig from TTTClientConfig + defaults
-        const autoMintConfig = {
-            chainId: net.chainId,
-            rpcUrl: config.rpcUrl || net.rpcUrl,
-            signer: signer,
-            contractAddress: config.contractAddress || net.tttAddress,
-            feeCollectorAddress: net.protocolFeeAddress,
-            poolAddress: (() => {
-                const addr = config.poolAddress;
-                if (!addr || addr === "0x0000000000000000000000000000000000000000") {
-                    throw new Error("[TTTClient] poolAddress is required. Provide a valid DEX pool address.");
-                }
-                return addr;
-            })(),
-            tier: config.tier || "T1_block",
-            timeSources: config.timeSources || ["nist", "google", "cloudflare", "apple"],
-            protocolFeeRate: config.protocolFeeRate || 0.05,
-            protocolFeeRecipient: (() => {
-                const addr = config.protocolFeeRecipient;
-                if (!addr || addr === "0x0000000000000000000000000000000000000000") {
-                    throw new Error("[TTTClient] protocolFeeRecipient is required. Provide a valid fee recipient address.");
-                }
-                return addr;
-            })(),
-            fallbackPriceUsd: config.fallbackPriceUsd || 10000n,
-            maxLatencyHistory: config.maxLatencyHistory,
-        };
-        // 4. Instantiate and initialize
-        const client = new TTTClient(autoMintConfig);
-        await client.initialize();
-        if (config.enableGracefulShutdown) {
-            process.on('SIGINT', async () => {
-                logger_1.logger.info("[TTTClient] SIGINT received, shutting down gracefully...");
-                await client.destroy();
-                process.exit(0);
-            });
-        }
-        return client;
-    }
-    /**
-     * Gracefully shuts down the SDK, stopping all background processes and listeners.
-     */
-    async destroy() {
-        if (!this.isInitialized)
-            return;
-        logger_1.logger.info("[TTTClient] Destroying client...");
-        // 1. Stop auto-mint engine
-        this.autoMintEngine.stop();
-        // 2. Unsubscribe all event listeners
-        this.autoMintEngine.getEvmConnector().unsubscribeAll();
-        // 3. Clear local state
-        this.isInitialized = false;
-        this.signer = null;
-        logger_1.logger.info("[TTTClient] Client destroyed successfully.");
-    }
-    /**
-     * Initialize the SDK: RPC connection, time sources, fee engine wiring.
-     */
-    async initialize() {
-        if (this.isInitialized)
-            return;
-        try {
-            logger_1.logger.info(`[TTTClient] Initializing for chain ${this.config.chainId}...`);
-            await this.autoMintEngine.initialize();
-            const connector = this.autoMintEngine.getEvmConnector();
-            this.signer = connector.getSigner();
-            // Register initial pool
-            await this.poolRegistry.registerPool(this.config.chainId, this.config.poolAddress);
-            // Validate feeCollectorAddress early before use
-            if (this.config.feeCollectorAddress && !ethers_1.ethers.isAddress(this.config.feeCollectorAddress)) {
-                throw new Error(`[TTTClient] Invalid feeCollectorAddress: ${this.config.feeCollectorAddress}`);
-            }
-            // Attach ProtocolFee contract if address is provided
-            if (this.config.feeCollectorAddress) {
-                const protocolFeeAbi = [
-                    "event FeeCollected(address indexed payer, uint256 amount, uint256 nonce)"
-                ];
-                connector.attachProtocolFeeContract(this.config.feeCollectorAddress, protocolFeeAbi);
-            }
-            // Subscribe to events
-            await connector.subscribeToEvents({
-                onMinted: async (to, tokenId, amount) => {
-                    logger_1.logger.info(`[TTTClient] Event: TTTMinted to ${to}, tokenId: ${tokenId}, amount: ${amount}`);
-                    const myAddr = await this.signer?.getAddress();
-                    if (to.toLowerCase() === myAddr?.toLowerCase()) {
-                        // Logic could go here to update local state
-                    }
-                },
-                onBurned: (from, tokenId, amount, tier) => {
-                    logger_1.logger.info(`[TTTClient] Event: TTTBurned from ${from}, tokenId: ${tokenId}, amount: ${amount}, tier: ${tier}`);
-                    this.poolRegistry.recordBurn(this.config.poolAddress, amount);
-                },
-                onFeeCollected: (payer, amount, nonce) => {
-                    logger_1.logger.info(`[TTTClient] Event: FeeCollected from ${payer}, amount: ${amount}, nonce: ${nonce}`);
-                }
-            });
-            this.isInitialized = true;
-            logger_1.logger.info(`[TTTClient] SDK initialized successfully`);
-        }
-        catch (error) {
-            this.isInitialized = false;
-            this.signer = null;
-            logger_1.logger.error(`[TTTClient] Initialization failed, state rolled back: ${error}`);
-            throw error;
-        }
-    }
-    /**
-     * Start the auto-minting process.
-     */
-    startAutoMint() {
-        if (!this.isInitialized) {
-            throw new Error("SDK must be initialized before starting auto-mint");
-        }
-        this.autoMintEngine.start();
-        logger_1.logger.info(`[TTTClient] Auto-minting started for tier ${this.config.tier}`);
-    }
-    /**
-     * Stop the auto-minting process.
-     */
-    stopAutoMint() {
-        this.autoMintEngine.stop();
-    }
-    /**
-     * Resume auto-minting after a circuit breaker trip.
-     * Resets consecutive failure count and restarts the engine.
-     */
-    resume() {
-        this.autoMintEngine.resume();
-        this.emit('modeSwitch', 'resumed');
-        logger_1.logger.info(`[TTTClient] Auto-minting resumed`);
-    }
-    /**
-     * List registered pools.
-     */
-    listPools() {
-        return this.poolRegistry.listPools();
-    }
-    /**
-     * Get stats for a specific pool.
-     */
-    getPoolStats(poolAddress) {
-        return this.poolRegistry.getPoolStats(poolAddress);
-    }
-    /**
-     * Set minimum ETH balance threshold for health alerts.
-     */
-    setMinBalance(weiAmount) {
-        this.minBalanceWei = weiAmount;
-    }
-    /**
-     * Register alert callback for real-time notifications.
-     * Backward compatible: delegates to EventEmitter 'alert' event.
-     */
-    onAlert(callback) {
-        this.on('alert', callback);
-    }
-    emitAlert(alert) {
-        logger_1.logger.warn(`[TTTClient] ALERT: ${alert}`);
-        this.emit('alert', alert);
-    }
-    /**
-     * Record a mint failure (called internally or externally).
-     */
-    recordMintFailure() {
-        this.mintFailures++;
-    }
-    /**
-     * Record mint latency in ms (called from auto-mint wrapper).
-     */
-    recordMintLatency(ms) {
-        this.mintLatencies.push(ms);
-        if (this.mintLatencies.length > this.maxLatencyHistory) {
-            this.mintLatencies.shift();
-        }
-    }
-    /**
-     * Production health check — liveness + readiness + metrics.
-     * No exceptions: always returns a HealthStatus object.
-     */
-    async getHealth() {
-        const alerts = [];
-        let rpcConnected = false;
-        let balanceSufficient = false;
-        let ntpSourcesOk = false;
-        // 1. RPC connectivity check
-        if (this.isInitialized && this.signer?.provider) {
-            try {
-                const blockNumber = await this.signer.provider.getBlockNumber();
-                rpcConnected = blockNumber > 0;
-            }
-            catch {
-                rpcConnected = false;
-                alerts.push("RPC connection failed");
-            }
-        }
-        // 2. Balance check
-        if (this.isInitialized && this.signer?.provider) {
-            try {
-                const address = await this.signer.getAddress();
-                const balance = await this.signer.provider.getBalance(address);
-                balanceSufficient = balance >= this.minBalanceWei;
-                if (!balanceSufficient) {
-                    alerts.push(`ETH balance low: ${ethers_1.ethers.formatEther(balance)} ETH (min: ${ethers_1.ethers.formatEther(this.minBalanceWei)})`);
-                }
-            }
-            catch {
-                alerts.push("Balance check failed");
-            }
-        }
-        // 3. NTP/time source health check via quick synthesis with timeout
-        try {
-            const synthResult = await Promise.race([
-                this.autoMintEngine.getTimeSynthesis().synthesize(),
-                new Promise((_, reject) => setTimeout(() => reject(new Error("Time synthesis health check timed out")), 3000)),
-            ]);
-            if (synthResult && synthResult.sources >= 2 && synthResult.confidence >= 0.5) {
-                ntpSourcesOk = true;
-            }
-            else {
-                ntpSourcesOk = false;
-                alerts.push(`Time sources degraded: ${synthResult?.sources ?? 0} source(s), confidence ${synthResult?.confidence?.toFixed(2) ?? "N/A"}`);
-            }
-        }
-        catch {
-            ntpSourcesOk = false;
-            alerts.push("Time source health check failed");
-        }
-        // 4. Consecutive failure check
-        const total = this.mintCount + this.mintFailures;
-        const successRate = total > 0 ? this.mintCount / total : 1;
-        if (this.mintFailures > 5 && successRate < 0.8) {
-            alerts.push(`High mint failure rate: ${this.mintFailures} failures, ${(successRate * 100).toFixed(1)}% success`);
-        }
-        // 4. Avg latency
-        const avgLatency = this.mintLatencies.length > 0
-            ? this.mintLatencies.reduce((a, b) => a + b, 0) / this.mintLatencies.length
-            : 0;
-        // 5. Uptime
-        const uptimeMs = Date.now() - this.startedAt.getTime();
-        // Emit alerts
-        for (const alert of alerts) {
-            this.emitAlert(alert);
-        }
-        const healthy = this.isInitialized && rpcConnected && balanceSufficient && alerts.length === 0;
-        return {
-            healthy,
-            checks: {
-                initialized: this.isInitialized,
-                rpcConnected,
-                signerAvailable: this.signer !== null,
-                balanceSufficient,
-                ntpSourcesOk,
-            },
-            metrics: {
-                mintCount: this.mintCount,
-                mintFailures: this.mintFailures,
-                successRate: Math.round(successRate * 1000) / 1000,
-                totalFeesPaid: this.totalFeesPaid.toString(),
-                avgMintLatencyMs: Math.round(avgLatency),
-                lastMintAt: this.lastMintAt?.toISOString() ?? null,
-                uptimeMs,
-            },
-            alerts,
-        };
-    }
-    /**
-     * Return current SDK status and statistics (balance, mint count, fees, etc.)
-     */
-    async getStatus() {
-        if (!this.isInitialized || !this.signer) {
-            throw new Error("SDK must be initialized before getting status");
-        }
-        const provider = this.signer.provider;
-        if (!provider) {
-            throw new Error("Signer provider is not available");
-        }
-        const address = await this.signer.getAddress();
-        const balance = await provider.getBalance(address);
-        const formattedBalance = ethers_1.ethers.formatEther(balance);
-        let tttBalance = 0n;
-        if (this.lastTokenId) {
-            try {
-                tttBalance = await this.autoMintEngine.getEvmConnector().getTTTBalance(address, BigInt(this.lastTokenId));
-            }
-            catch (e) {
-                logger_1.logger.error(`[TTTClient] Failed to fetch TTT balance: ${e}`);
-            }
-        }
-        return {
-            isInitialized: this.isInitialized,
-            tier: this.config.tier,
-            mintCount: this.mintCount,
-            totalFeesPaid: this.totalFeesPaid.toString(),
-            balance: formattedBalance,
-            tttBalance: tttBalance.toString(),
-            lastTokenId: this.lastTokenId
-        };
-    }
-}
-exports.TTTClient = TTTClient;