@varity-labs/sdk 2.0.0-alpha.1

package/dist/thirdweb/x402Client.d.ts

@@ -0,0 +1,319 @@
+/**
+ * thirdweb x402 Payment Protocol Client
+ *
+ * Monetize APIs with blockchain micropayments
+ * Implements HTTP 402 (Payment Required) with crypto payments
+ *
+ * Features:
+ * - Pay-per-call API monetization
+ * - Automatic revenue splitting (70/30 model)
+ * - Usage tracking and analytics
+ * - Subscription-based access
+ * - Metered billing
+ * - Multi-chain support
+ */
+import type { ThirdwebClient, Chain } from 'thirdweb';
+/**
+ * x402 configuration
+ */
+export interface x402Config {
+    /**
+     * thirdweb client instance
+     */
+    client: ThirdwebClient;
+    /**
+     * Revenue split recipients (addresses and percentages)
+     */
+    revenueSplit?: {
+        recipient: string;
+        percentage: number;
+    }[];
+    /**
+     * Default chain for payments
+     */
+    defaultChain?: Chain;
+}
+/**
+ * Payment endpoint configuration
+ */
+export interface PaymentEndpointConfig {
+    /**
+     * API endpoint URL to monetize
+     */
+    url: string;
+    /**
+     * Price per API call (in tokens)
+     */
+    pricePerCall: string;
+    /**
+     * Payment token contract address
+     */
+    paymentToken: string;
+    /**
+     * Chain for payments
+     */
+    chain: Chain;
+    /**
+     * Revenue split configuration (overrides default)
+     */
+    revenueSplit?: {
+        recipient: string;
+        percentage: number;
+    }[];
+    /**
+     * Rate limit per user
+     */
+    rateLimit?: {
+        calls: number;
+        periodSeconds: number;
+    };
+    /**
+     * Free tier allowance
+     */
+    freeTier?: {
+        callsPerDay: number;
+    };
+}
+/**
+ * Payment stats for an endpoint
+ */
+export interface PaymentStats {
+    /**
+     * Endpoint URL
+     */
+    url: string;
+    /**
+     * Total calls
+     */
+    totalCalls: number;
+    /**
+     * Total revenue earned (in tokens)
+     */
+    totalRevenue: string;
+    /**
+     * Unique payers
+     */
+    uniquePayers: number;
+    /**
+     * Average revenue per call
+     */
+    averageRevenuePerCall: string;
+    /**
+     * Revenue breakdown by recipient
+     */
+    revenueByRecipient: {
+        recipient: string;
+        amount: string;
+        percentage: number;
+    }[];
+    /**
+     * Time period
+     */
+    period: {
+        start: Date;
+        end: Date;
+    };
+}
+/**
+ * Usage record for tracking API consumption
+ */
+export interface UsageRecord {
+    /**
+     * User/wallet address
+     */
+    user: string;
+    /**
+     * Endpoint URL
+     */
+    endpoint: string;
+    /**
+     * Timestamp
+     */
+    timestamp: Date;
+    /**
+     * Cost for this call
+     */
+    cost: string;
+    /**
+     * Payment transaction hash
+     */
+    txHash: string;
+    /**
+     * Request metadata
+     */
+    metadata?: {
+        method: string;
+        responseTime: number;
+        statusCode: number;
+    };
+}
+/**
+ * Subscription plan
+ */
+export interface SubscriptionPlan {
+    /**
+     * Plan ID
+     */
+    id: string;
+    /**
+     * Plan name
+     */
+    name: string;
+    /**
+     * Price per period
+     */
+    price: string;
+    /**
+     * Payment token
+     */
+    paymentToken: string;
+    /**
+     * Billing period in days
+     */
+    periodDays: number;
+    /**
+     * Included API calls per period
+     */
+    includedCalls: number;
+    /**
+     * Price per additional call (beyond included)
+     */
+    overagePrice?: string;
+    /**
+     * Accessible endpoints
+     */
+    endpoints: string[];
+}
+/**
+ * Active subscription
+ */
+export interface Subscription {
+    /**
+     * Subscription ID
+     */
+    id: string;
+    /**
+     * User address
+     */
+    user: string;
+    /**
+     * Plan
+     */
+    plan: SubscriptionPlan;
+    /**
+     * Current period start
+     */
+    periodStart: Date;
+    /**
+     * Current period end
+     */
+    periodEnd: Date;
+    /**
+     * Calls used in current period
+     */
+    callsUsed: number;
+    /**
+     * Status
+     */
+    status: 'active' | 'cancelled' | 'expired';
+    /**
+     * Next renewal date
+     */
+    nextRenewal: Date;
+}
+/**
+ * thirdweb x402 Payment Protocol Client
+ *
+ * Monetize your APIs with blockchain micropayments
+ */
+export declare class x402Client {
+    private client;
+    private revenueSplit;
+    private defaultChain?;
+    private baseUrl;
+    constructor(config: x402Config);
+    /**
+     * Create a payment-required endpoint
+     */
+    createPaymentEndpoint(config: PaymentEndpointConfig): Promise<{
+        endpointId: string;
+        paymentUrl: string;
+    }>;
+    /**
+     * Track API usage
+     */
+    trackUsage(usage: Omit<UsageRecord, 'timestamp'>): Promise<void>;
+    /**
+     * Get payment stats for an endpoint
+     */
+    getPaymentStats(endpointUrl: string, period?: {
+        start: Date;
+        end: Date;
+    }): Promise<PaymentStats>;
+    /**
+     * Create a subscription plan
+     */
+    createSubscription(plan: Omit<SubscriptionPlan, 'id'>): Promise<SubscriptionPlan>;
+    /**
+     * Subscribe a user to a plan
+     */
+    subscribe(user: string, planId: string): Promise<Subscription>;
+    /**
+     * Get active subscriptions for a user
+     */
+    getSubscriptions(user: string): Promise<Subscription[]>;
+    /**
+     * Cancel a subscription
+     */
+    cancelSubscription(subscriptionId: string): Promise<void>;
+    /**
+     * Withdraw earned revenue
+     */
+    withdrawRevenue(recipient: string, amount: string, chain: Chain): Promise<{
+        txHash: string;
+        amount: string;
+    }>;
+    /**
+     * Get usage history for a user
+     */
+    getUsageHistory(user: string, options?: {
+        endpoint?: string;
+        startDate?: Date;
+        endDate?: Date;
+        limit?: number;
+    }): Promise<UsageRecord[]>;
+    /**
+     * Verify payment for a request
+     */
+    verifyPayment(txHash: string, expectedAmount: string): Promise<{
+        valid: boolean;
+        amount: string;
+        from: string;
+    }>;
+    /**
+     * Update revenue split configuration
+     */
+    updateRevenueSplit(endpointId: string, revenueSplit: {
+        recipient: string;
+        percentage: number;
+    }[]): Promise<void>;
+    /**
+     * Get total earnings for a recipient
+     */
+    getTotalEarnings(recipient: string, chain?: Chain): Promise<{
+        total: string;
+        byToken: {
+            token: string;
+            amount: string;
+        }[];
+    }>;
+}
+/**
+ * Create x402 client instance
+ */
+export declare function createx402Client(config: x402Config): x402Client;
+/**
+ * Middleware for Express/Fastify to enforce x402 payments
+ */
+export declare function x402Middleware(client: x402Client, endpointConfig: PaymentEndpointConfig): (req: any, res: any, next: any) => Promise<void>;
+//# sourceMappingURL=x402Client.d.ts.map

package/dist/thirdweb/x402Client.d.ts.map

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

package/dist/thirdweb/x402Client.js

@@ -0,0 +1,223 @@
+/**
+ * thirdweb x402 Payment Protocol Client
+ *
+ * Monetize APIs with blockchain micropayments
+ * Implements HTTP 402 (Payment Required) with crypto payments
+ *
+ * Features:
+ * - Pay-per-call API monetization
+ * - Automatic revenue splitting (70/30 model)
+ * - Usage tracking and analytics
+ * - Subscription-based access
+ * - Metered billing
+ * - Multi-chain support
+ */
+/**
+ * thirdweb x402 Payment Protocol Client
+ *
+ * Monetize your APIs with blockchain micropayments
+ */
+export class x402Client {
+    constructor(config) {
+        this.baseUrl = 'https://x402.thirdweb.com/api';
+        this.client = config.client;
+        this.revenueSplit = config.revenueSplit || [
+            { recipient: '0x0', percentage: 70 }, // Creator gets 70%
+            { recipient: 'thirdweb', percentage: 30 }, // thirdweb gets 30%
+        ];
+        this.defaultChain = config.defaultChain;
+    }
+    /**
+     * Create a payment-required endpoint
+     */
+    async createPaymentEndpoint(config) {
+        console.warn('x402 API is placeholder - actual implementation pending');
+        // Generate unique endpoint ID
+        const endpointId = `x402_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+        // Mock implementation
+        return {
+            endpointId,
+            paymentUrl: `${this.baseUrl}/pay/${endpointId}`,
+        };
+    }
+    /**
+     * Track API usage
+     */
+    async trackUsage(usage) {
+        console.warn('x402 API is placeholder - actual implementation pending');
+        // Mock usage tracking
+        console.log('Usage tracked:', {
+            ...usage,
+            timestamp: new Date(),
+        });
+    }
+    /**
+     * Get payment stats for an endpoint
+     */
+    async getPaymentStats(endpointUrl, period) {
+        console.warn('x402 API is placeholder - actual implementation pending');
+        // Mock stats
+        return {
+            url: endpointUrl,
+            totalCalls: 1000,
+            totalRevenue: '1000.0',
+            uniquePayers: 50,
+            averageRevenuePerCall: '1.0',
+            revenueByRecipient: this.revenueSplit.map(split => ({
+                recipient: split.recipient,
+                amount: ((1000 * split.percentage) / 100).toString(),
+                percentage: split.percentage,
+            })),
+            period: period || {
+                start: new Date(Date.now() - 30 * 24 * 60 * 60 * 1000),
+                end: new Date(),
+            },
+        };
+    }
+    /**
+     * Create a subscription plan
+     */
+    async createSubscription(plan) {
+        console.warn('x402 API is placeholder - actual implementation pending');
+        return {
+            id: `plan_${Date.now()}`,
+            ...plan,
+        };
+    }
+    /**
+     * Subscribe a user to a plan
+     */
+    async subscribe(user, planId) {
+        console.warn('x402 API is placeholder - actual implementation pending');
+        const now = new Date();
+        const periodEnd = new Date(now.getTime() + 30 * 24 * 60 * 60 * 1000);
+        return {
+            id: `sub_${Date.now()}`,
+            user,
+            plan: {
+                id: planId,
+                name: 'Basic Plan',
+                price: '10.0',
+                paymentToken: '0x0',
+                periodDays: 30,
+                includedCalls: 1000,
+                endpoints: [],
+            },
+            periodStart: now,
+            periodEnd,
+            callsUsed: 0,
+            status: 'active',
+            nextRenewal: periodEnd,
+        };
+    }
+    /**
+     * Get active subscriptions for a user
+     */
+    async getSubscriptions(user) {
+        console.warn('x402 API is placeholder - actual implementation pending');
+        return [];
+    }
+    /**
+     * Cancel a subscription
+     */
+    async cancelSubscription(subscriptionId) {
+        console.warn('x402 API is placeholder - actual implementation pending');
+        console.log(`Subscription ${subscriptionId} cancelled`);
+    }
+    /**
+     * Withdraw earned revenue
+     */
+    async withdrawRevenue(recipient, amount, chain) {
+        console.warn('x402 API is placeholder - actual implementation pending');
+        return {
+            txHash: `0x${Math.random().toString(16).substr(2)}`,
+            amount,
+        };
+    }
+    /**
+     * Get usage history for a user
+     */
+    async getUsageHistory(user, options) {
+        console.warn('x402 API is placeholder - actual implementation pending');
+        return [];
+    }
+    /**
+     * Verify payment for a request
+     */
+    async verifyPayment(txHash, expectedAmount) {
+        console.warn('x402 API is placeholder - actual implementation pending');
+        return {
+            valid: true,
+            amount: expectedAmount,
+            from: '0x0',
+        };
+    }
+    /**
+     * Update revenue split configuration
+     */
+    async updateRevenueSplit(endpointId, revenueSplit) {
+        // Validate splits add up to 100%
+        const total = revenueSplit.reduce((sum, split) => sum + split.percentage, 0);
+        if (total !== 100) {
+            throw new Error('Revenue split percentages must add up to 100%');
+        }
+        console.warn('x402 API is placeholder - actual implementation pending');
+    }
+    /**
+     * Get total earnings for a recipient
+     */
+    async getTotalEarnings(recipient, chain) {
+        console.warn('x402 API is placeholder - actual implementation pending');
+        return {
+            total: '0',
+            byToken: [],
+        };
+    }
+}
+/**
+ * Create x402 client instance
+ */
+export function createx402Client(config) {
+    return new x402Client(config);
+}
+/**
+ * Middleware for Express/Fastify to enforce x402 payments
+ */
+export function x402Middleware(client, endpointConfig) {
+    return async (req, res, next) => {
+        // Check for payment proof in headers
+        const paymentProof = req.headers['x-payment-proof'];
+        if (!paymentProof) {
+            res.status(402).json({
+                error: 'Payment Required',
+                message: 'This API requires payment',
+                price: endpointConfig.pricePerCall,
+                paymentToken: endpointConfig.paymentToken,
+                chain: endpointConfig.chain.id,
+            });
+            return;
+        }
+        try {
+            // Verify payment
+            const payment = await client.verifyPayment(paymentProof, endpointConfig.pricePerCall);
+            if (!payment.valid) {
+                throw new Error('Invalid payment');
+            }
+            // Track usage
+            await client.trackUsage({
+                user: payment.from,
+                endpoint: endpointConfig.url,
+                cost: payment.amount,
+                txHash: paymentProof,
+            });
+            // Allow request to proceed
+            next();
+        }
+        catch (error) {
+            res.status(402).json({
+                error: 'Payment Verification Failed',
+                message: error.message,
+            });
+        }
+    };
+}

package/dist/tracking/gasTracker.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Gas Usage Tracker
+ *
+ * Tracks gas usage for per-app billing in Varity SDK.
+ * Each app's gas consumption is monitored and sent to backend for billing.
+ *
+ * @module tracking/gasTracker
+ */
+import type { ThirdwebClient, Chain } from 'thirdweb';
+/**
+ * Gas usage event sent to backend for billing
+ */
+export interface GasUsageEvent {
+    /** Unique app identifier from App Store */
+    appId: string;
+    /** Developer's wallet address for billing */
+    developerWallet: string;
+    /** Transaction hash on-chain */
+    transactionHash: string;
+    /** Gas cost in USDC (6 decimal precision) */
+    gasSponsored: string;
+    /** Unix timestamp (milliseconds) */
+    timestamp: number;
+    /** Chain ID (33529 for Varity L3) */
+    chainId: number;
+    /** End user's wallet who triggered the transaction */
+    userWallet: string;
+}
+/**
+ * Transaction receipt with gas information
+ */
+export interface GasTransactionReceipt {
+    /** Transaction hash */
+    transactionHash: string;
+    /** Gas used by the transaction */
+    gasUsed: bigint;
+    /** Effective gas price paid */
+    effectiveGasPrice: bigint;
+    /** Block number */
+    blockNumber: bigint;
+    /** Status (1 = success, 0 = failure) */
+    status: number;
+}
+/**
+ * Gas tracking configuration
+ */
+export interface GasTrackerConfig {
+    /** API endpoint for gas tracking (default: https://api.varity.so) */
+    apiUrl?: string;
+    /** Enable/disable tracking (for development) */
+    enabled?: boolean;
+    /** Retry attempts on failure */
+    retries?: number;
+    /** Timeout for tracking requests (ms) */
+    timeout?: number;
+}
+/**
+ * Wait for transaction receipt with retry logic
+ *
+ * @param client - thirdweb client
+ * @param chain - Chain to query
+ * @param transactionHash - Transaction hash to wait for
+ * @param maxWaitTime - Maximum time to wait in ms (default: 60s)
+ * @returns Transaction receipt
+ */
+export declare function waitForTransactionReceipt(client: ThirdwebClient, chain: Chain, transactionHash: string, maxWaitTime?: number): Promise<GasTransactionReceipt>;
+/**
+ * Calculate gas cost in USDC (6 decimals)
+ *
+ * @param receipt - Transaction receipt with gas information
+ * @param usdcPerGas - USDC price per gas unit (default: auto-fetch from oracle)
+ * @returns Gas cost in USDC as string (6 decimal precision)
+ *
+ * @example
+ * const receipt = await waitForTransactionReceipt(client, chain, txHash);
+ * const usdcCost = await calculateGasInUSDC(receipt);
+ * console.log(`Gas cost: ${usdcCost} USDC`);  // "0.025000"
+ */
+export declare function calculateGasInUSDC(receipt: GasTransactionReceipt, usdcPerGas?: string): Promise<string>;
+/**
+ * Track gas usage for billing
+ *
+ * Sends gas usage event to Varity backend API for billing purposes.
+ * Includes retry logic and error handling.
+ *
+ * @param event - Gas usage event to track
+ * @param config - Optional configuration
+ * @returns Promise that resolves when tracking is complete
+ *
+ * @example
+ * await trackGasUsage({
+ *   appId: 'app_abc123',
+ *   developerWallet: '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb',
+ *   transactionHash: '0x...',
+ *   gasSponsored: '0.025000',
+ *   timestamp: Date.now(),
+ *   chainId: 33529,
+ *   userWallet: '0x...',
+ * });
+ */
+export declare function trackGasUsage(event: GasUsageEvent, config?: GasTrackerConfig): Promise<void>;
+/**
+ * Track gas usage for a transaction (convenience method)
+ *
+ * Waits for transaction receipt, calculates gas cost, and tracks usage.
+ *
+ * @param client - thirdweb client
+ * @param chain - Chain the transaction is on
+ * @param transactionHash - Transaction hash to track
+ * @param appId - App identifier
+ * @param developerWallet - Developer's wallet address
+ * @param userWallet - End user's wallet address
+ * @param config - Optional configuration
+ *
+ * @example
+ * await trackTransactionGasUsage(
+ *   client,
+ *   varityL3Testnet,
+ *   txHash,
+ *   'app_abc123',
+ *   '0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb',
+ *   '0x...'
+ * );
+ */
+export declare function trackTransactionGasUsage(client: ThirdwebClient, chain: Chain, transactionHash: string, appId: string, developerWallet: string, userWallet: string, config?: GasTrackerConfig): Promise<void>;
+/**
+ * Create a gas tracker instance with default config
+ *
+ * @param config - Gas tracker configuration
+ * @returns Object with tracking methods
+ *
+ * @example
+ * const tracker = createGasTracker({
+ *   apiUrl: 'https://api.varity.so',
+ *   enabled: true,
+ * });
+ *
+ * await tracker.trackTransaction(client, chain, txHash, appId, devWallet, userWallet);
+ */
+export declare function createGasTracker(config?: GasTrackerConfig): {
+    /**
+     * Track gas usage event
+     */
+    trackEvent: (event: GasUsageEvent) => Promise<void>;
+    /**
+     * Track transaction gas usage
+     */
+    trackTransaction: (client: ThirdwebClient, chain: Chain, transactionHash: string, appId: string, developerWallet: string, userWallet: string) => Promise<void>;
+    /**
+     * Calculate gas in USDC
+     */
+    calculateGas: typeof calculateGasInUSDC;
+    /**
+     * Wait for receipt
+     */
+    waitForReceipt: (client: ThirdwebClient, chain: Chain, txHash: string) => Promise<GasTransactionReceipt>;
+};
+//# sourceMappingURL=gasTracker.d.ts.map

package/dist/tracking/gasTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gasTracker.d.ts","sourceRoot":"","sources":["../../src/tracking/gasTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IAEd,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IAExB,gCAAgC;IAChC,eAAe,EAAE,MAAM,CAAC;IAExB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IAErB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAEhB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;IAExB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAE1B,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAUD;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,KAAK,EACZ,eAAe,EAAE,MAAM,EACvB,WAAW,GAAE,MAAc,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAgChC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,qBAAqB,EAC9B,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,aAAa,EACpB,MAAM,GAAE,gBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAoDf;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,KAAK,EACZ,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,gBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,gBAAqB;IAI1D;;OAEG;wBACiB,aAAa;IAEjC;;OAEG;+BAEO,cAAc,SACf,KAAK,mBACK,MAAM,SAChB,MAAM,mBACI,MAAM,cACX,MAAM;IAWpB;;OAEG;;IAGH;;OAEG;6BACsB,cAAc,SAAS,KAAK,UAAU,MAAM;EAGxE"}