openttt 0.2.11 → 0.2.12

package/dist/revenue_tiers.js

@@ -1,83 +0,0 @@
-"use strict";
-/**
- * Revenue Tier Configuration
- * Reflects the TTT Labs pricing strategy: Free/Sponsor-backed T0 up to Institutional T3.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.REVENUE_TIERS = exports.RevenueTier = void 0;
-exports.calculateMonthlyCost = calculateMonthlyCost;
-exports.getTierForUseCase = getTierForUseCase;
-var RevenueTier;
-(function (RevenueTier) {
-    RevenueTier["T0_EPOCH"] = "T0_EPOCH";
-    RevenueTier["T1_BLOCK"] = "T1_BLOCK";
-    RevenueTier["T2_SLOT"] = "T2_SLOT";
-    RevenueTier["T3_MICRO"] = "T3_MICRO";
-})(RevenueTier || (exports.RevenueTier = RevenueTier = {}));
-exports.REVENUE_TIERS = {
-    [RevenueTier.T0_EPOCH]: {
-        tier: RevenueTier.T0_EPOCH,
-        name: "Standard Epoch",
-        interval: "6.4 min",
-        pricePerTick: 0,
-        currency: "USDC",
-        model: "sponsor", // Let's Encrypt model: free to user, sponsor-backed
-        target: "Standard L1 Swaps / LP Integration",
-        sponsorEligible: true
-    },
-    [RevenueTier.T1_BLOCK]: {
-        tier: RevenueTier.T1_BLOCK,
-        name: "Fast Block",
-        interval: "2 sec",
-        pricePerTick: 0.01,
-        currency: "USDC",
-        model: "sdk_license",
-        target: "L2 Sequencer / Standard DeFi",
-        sponsorEligible: false
-    },
-    [RevenueTier.T2_SLOT]: {
-        tier: RevenueTier.T2_SLOT,
-        name: "High-Frequency Slot",
-        interval: "12 sec",
-        pricePerTick: 0.05,
-        currency: "USDC",
-        model: "sdk_license",
-        target: "Active Traders / Arbitrage",
-        sponsorEligible: false
-    },
-    [RevenueTier.T3_MICRO]: {
-        tier: RevenueTier.T3_MICRO,
-        name: "Institutional Micro-Tick",
-        interval: "100 ms",
-        pricePerTick: 0.10,
-        currency: "USDC",
-        model: "enterprise",
-        target: "Institutional / HFT Pipelines",
-        sponsorEligible: false
-    }
-};
-/**
- * Calculate projected monthly cost based on tier and throughput.
- */
-function calculateMonthlyCost(tier, ticksPerDay) {
-    const config = exports.REVENUE_TIERS[tier];
-    if (config.pricePerTick === 0)
-        return 0;
-    return config.pricePerTick * ticksPerDay * 30;
-}
-/**
- * Determine the appropriate tier based on a usage description.
- */
-function getTierForUseCase(useCase) {
-    const lowerCase = useCase.toLowerCase();
-    if (lowerCase.includes("institutional") || lowerCase.includes("hft") || lowerCase.includes("micro")) {
-        return RevenueTier.T3_MICRO;
-    }
-    if (lowerCase.includes("arbitrage") || lowerCase.includes("trader") || lowerCase.includes("slot")) {
-        return RevenueTier.T2_SLOT;
-    }
-    if (lowerCase.includes("l2") || lowerCase.includes("block") || lowerCase.includes("sequencer")) {
-        return RevenueTier.T1_BLOCK;
-    }
-    return RevenueTier.T0_EPOCH;
-}

package/dist/x402_enforcer.d.ts

@@ -1,44 +0,0 @@
-import { AdaptiveMode } from "./adaptive_switch";
-import { EVMConnector } from "./evm_connector";
-import { ProtocolFeeCollector } from "./protocol_fee";
-import { DynamicFeeEngine, FeeCalculation } from "./dynamic_fee";
-export interface SwapDetails {
-    user: string;
-    tokenIn: string;
-    tokenOut: string;
-    amount: bigint;
-}
-export declare class X402Enforcer {
-    private static getCost;
-    /**
-     * Deducts TTT ticks from the provided balance and determines Adaptive Mode.
-     *
-     * **Important:** By default, the `balance` parameter is an SDK-local value
-     * (tracked in-memory by the caller). It is NOT verified against the on-chain
-     * TTT token balance. This is sufficient for hot-path tick accounting where
-     * on-chain settlement happens separately via `deductOnChain()`.
-     *
-     * @param feeEngine - Dynamic fee engine for cost calculation
-     * @param swap - Swap details (user, tokens, amount)
-     * @param balance - SDK-local TTT balance (not on-chain unless verifyOnChain=true)
-     * @param tier - Stratum tier (0-3)
-     * @param mode - Current adaptive mode (Turbo/Full)
-     * @param verifyOnChain - If true, checks on-chain TTT balance via EVMConnector
-     *   before deducting. Requires `connector` and `tokenId`. Default: false.
-     * @param connector - EVMConnector instance (required when verifyOnChain=true)
-     * @param tokenId - Token ID for on-chain balance lookup (required when verifyOnChain=true)
-     */
-    static deductTick(feeEngine: DynamicFeeEngine, swap: SwapDetails, balance: bigint, tier: number, mode: AdaptiveMode, verifyOnChain?: boolean, connector?: EVMConnector, tokenId?: bigint): Promise<{
-        success: boolean;
-        remaining: bigint;
-        mode: AdaptiveMode;
-    }>;
-    /**
-     * Executes on-chain TTT burn via EVMConnector.
-     */
-    static deductOnChain(connector: EVMConnector, feeEngine: DynamicFeeEngine, swap: SwapDetails, grgHash: string, tier: number, feeCollector?: ProtocolFeeCollector, burnFeeCalc?: FeeCalculation, signature?: string, nonce?: bigint, deadline?: number): Promise<string>;
-    /**
-     * Static validation rule.
-     */
-    static enforcePool(feeEngine: DynamicFeeEngine, swap: SwapDetails, tttBalance: bigint, tier: number): Promise<boolean>;
-}

package/dist/x402_enforcer.js

@@ -1,92 +0,0 @@
-"use strict";
-// sdk/src/x402_enforcer.ts — x402 Micropayment Enforcer (Expanded)
-// Governs TTT tick consumption and on-chain settlement.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.X402Enforcer = void 0;
-const logger_1 = require("./logger");
-const TIER_MAP = {
-    0: "T0_epoch",
-    1: "T1_block",
-    2: "T2_slot",
-    3: "T3_micro"
-};
-class X402Enforcer {
-    static async getCost(feeEngine, tier) {
-        const tierKey = TIER_MAP[tier] || "T0_epoch";
-        const feeCalc = await feeEngine.calculateMintFee(tierKey);
-        return feeCalc.tttAmount;
-    }
-    /**
-     * Deducts TTT ticks from the provided balance and determines Adaptive Mode.
-     *
-     * **Important:** By default, the `balance` parameter is an SDK-local value
-     * (tracked in-memory by the caller). It is NOT verified against the on-chain
-     * TTT token balance. This is sufficient for hot-path tick accounting where
-     * on-chain settlement happens separately via `deductOnChain()`.
-     *
-     * @param feeEngine - Dynamic fee engine for cost calculation
-     * @param swap - Swap details (user, tokens, amount)
-     * @param balance - SDK-local TTT balance (not on-chain unless verifyOnChain=true)
-     * @param tier - Stratum tier (0-3)
-     * @param mode - Current adaptive mode (Turbo/Full)
-     * @param verifyOnChain - If true, checks on-chain TTT balance via EVMConnector
-     *   before deducting. Requires `connector` and `tokenId`. Default: false.
-     * @param connector - EVMConnector instance (required when verifyOnChain=true)
-     * @param tokenId - Token ID for on-chain balance lookup (required when verifyOnChain=true)
-     */
-    static async deductTick(feeEngine, swap, balance, tier, mode, verifyOnChain = false, connector, tokenId) {
-        const cost = await this.getCost(feeEngine, tier);
-        // Optional on-chain balance verification before deducting
-        if (verifyOnChain) {
-            if (!connector || tokenId === undefined) {
-                throw new Error("[x402] verifyOnChain requires both connector and tokenId parameters");
-            }
-            const onChainBalance = await connector.getTTTBalance(swap.user, tokenId);
-            if (onChainBalance < cost) {
-                throw new Error(`[x402] On-chain balance insufficient for user ${swap.user}. Required: ${cost}, On-chain: ${onChainBalance}.`);
-            }
-        }
-        if (balance < cost) {
-            throw new Error(`[x402] Insufficient TTT ticks for user ${swap.user}. Required: ${cost}, Have: ${balance}.`);
-        }
-        const newBalance = balance - cost;
-        logger_1.logger.info(`[x402] Deducted ${cost} ticks for swap. User: ${swap.user}, New Balance: ${newBalance}`);
-        return {
-            success: true,
-            remaining: newBalance,
-            mode
-        };
-    }
-    /**
-     * Executes on-chain TTT burn via EVMConnector.
-     */
-    static async deductOnChain(connector, feeEngine, swap, grgHash, tier, feeCollector, burnFeeCalc, signature, nonce, deadline) {
-        logger_1.logger.info(`[x402] Enforcing on-chain settlement for user ${swap.user}...`);
-        const cost = await this.getCost(feeEngine, tier);
-        try {
-            const receipt = await connector.burnTTT(cost, grgHash, tier);
-            // Collect protocol burn fee if feeCollector and required params are provided
-            if (feeCollector && burnFeeCalc && signature && nonce !== undefined && deadline !== undefined) {
-                try {
-                    await feeCollector.collectBurnFee(burnFeeCalc, signature, swap.user, nonce, deadline);
-                }
-                catch (feeError) {
-                    logger_1.logger.error(`[x402] Burn fee collection failed but burn was successful: ${feeError instanceof Error ? feeError.message : feeError}`);
-                }
-            }
-            return receipt.hash;
-        }
-        catch (error) {
-            logger_1.logger.error(`[x402] On-chain enforcement failed: ${error instanceof Error ? error.message : error}`);
-            throw error;
-        }
-    }
-    /**
-     * Static validation rule.
-     */
-    static async enforcePool(feeEngine, swap, tttBalance, tier) {
-        const cost = await this.getCost(feeEngine, tier);
-        return tttBalance >= cost;
-    }
-}
-exports.X402Enforcer = X402Enforcer;