@varity-labs/sdk 2.0.0-alpha.1

package/dist/thirdweb/ThirdwebWrapper.js

@@ -0,0 +1,332 @@
+/**
+ * Thirdweb Wrapper for Varity SDK
+ *
+ * This wrapper provides Thirdweb SDK v5 functionality while maintaining
+ * 100% backwards compatibility with existing ethers.js v6 implementation.
+ *
+ * Pattern: Optional enhancement layer - does NOT break existing functionality
+ */
+import { createThirdwebClient, getContract as getThirdwebContract } from 'thirdweb';
+import { deployContract as deployThirdwebContract } from 'thirdweb/deploys';
+import { upload, download } from 'thirdweb/storage';
+import { privateKeyToAccount } from 'thirdweb/wallets';
+import { ethers } from 'ethers';
+import { VARITY_TESTNET_RPC } from './varity-chain';
+import { ChainRegistry, varityL3Testnet } from '../chains';
+/**
+ * ThirdwebWrapper Class
+ *
+ * Provides Thirdweb SDK capabilities with ethers.js fallback.
+ * All existing ethers.js functionality is preserved.
+ */
+export class ThirdwebWrapper {
+    constructor(config) {
+        // Determine chain
+        if (config.chain) {
+            if (typeof config.chain === 'number') {
+                // Chain ID provided - look up in registry
+                this.chain = ChainRegistry.getChain(config.chain);
+                this.chainId = config.chain;
+            }
+            else {
+                // Chain object provided directly
+                this.chain = config.chain;
+                this.chainId = config.chain.id;
+            }
+        }
+        else if (config.chainId) {
+            // Legacy chainId parameter (deprecated but supported)
+            console.warn('ThirdwebWrapper: chainId parameter is deprecated. Use chain parameter instead.');
+            this.chain = ChainRegistry.getChain(config.chainId);
+            this.chainId = config.chainId;
+        }
+        else {
+            // Default to Varity L3 Testnet
+            this.chain = varityL3Testnet;
+            this.chainId = varityL3Testnet.id;
+        }
+        // Initialize Thirdweb Client
+        const clientId = config.clientId || process.env.VARITY_THIRDWEB_CLIENT_ID || process.env.THIRDWEB_CLIENT_ID;
+        if (!clientId) {
+            throw new Error('Thirdweb Client ID required. Set VARITY_THIRDWEB_CLIENT_ID environment variable or pass clientId in config.');
+        }
+        this.client = createThirdwebClient({
+            clientId,
+        });
+        // Initialize account if private key provided
+        if (config.privateKey) {
+            this.account = privateKeyToAccount({
+                client: this.client,
+                privateKey: config.privateKey,
+            });
+        }
+        // Preserve ethers.js fallback with RPC from config or chain default
+        const rpcUrl = config.rpcUrl || this.chain.rpc || VARITY_TESTNET_RPC;
+        this.ethersProvider = new ethers.JsonRpcProvider(rpcUrl);
+    }
+    // ===== NEW: Thirdweb Methods =====
+    /**
+     * Get a contract instance using Thirdweb
+     * @param address Contract address
+     * @returns Thirdweb contract instance
+     */
+    async getContract(address) {
+        return getThirdwebContract({
+            client: this.client,
+            chain: this.chain,
+            address,
+        });
+    }
+    /**
+     * Deploy a contract using Thirdweb
+     * @param params Deployment parameters
+     * @returns Deployed contract address
+     */
+    async deployContract(params) {
+        if (!this.account) {
+            throw new Error('Account required for contract deployment. Provide privateKey in config.');
+        }
+        const address = await deployThirdwebContract({
+            client: this.client,
+            chain: this.chain,
+            account: this.account,
+            abi: params.abi, // Type cast to satisfy Thirdweb's strict typing
+            bytecode: params.bytecode,
+            constructorParams: params.constructorArgs || [],
+        });
+        return {
+            address,
+            deployed: true,
+            method: 'thirdweb',
+            transactionHash: address, // Thirdweb v5 returns address directly
+        };
+    }
+    /**
+     * Upload data to IPFS using Thirdweb Storage
+     * @param data Data to upload (can be JSON, File, or any supported type)
+     * @returns IPFS URI
+     */
+    async uploadToIPFS(data) {
+        const uri = await upload({
+            client: this.client,
+            files: [data],
+        });
+        return uri;
+    }
+    /**
+     * Download data from IPFS using Thirdweb Storage
+     * @param uri IPFS URI
+     * @returns Downloaded data
+     */
+    async downloadFromIPFS(uri) {
+        const data = await download({
+            client: this.client,
+            uri,
+        });
+        return data;
+    }
+    // ===== PRESERVED: Ethers.js Fallback Methods =====
+    /**
+     * Get the ethers.js provider (backwards compatibility)
+     * @returns Ethers JsonRpcProvider
+     */
+    getEthersProvider() {
+        return this.ethersProvider;
+    }
+    /**
+     * Get a contract instance using ethers.js (backwards compatibility)
+     * @param address Contract address
+     * @param abi Contract ABI
+     * @returns Ethers Contract instance
+     */
+    async getContractWithEthers(address, abi) {
+        return new ethers.Contract(address, abi, this.ethersProvider);
+    }
+    /**
+     * Deploy a contract using ethers.js (backwards compatibility)
+     * @param params Deployment parameters
+     * @returns Deployment result
+     */
+    async deployContractWithEthers(params) {
+        if (!this.account) {
+            throw new Error('Account required for contract deployment. Provide privateKey in config.');
+        }
+        const wallet = new ethers.Wallet(this.account.address, this.ethersProvider);
+        const factory = new ethers.ContractFactory(params.abi, params.bytecode, wallet);
+        const contract = await factory.deploy(...(params.constructorArgs || []));
+        await contract.waitForDeployment();
+        return {
+            address: await contract.getAddress(),
+            deployed: true,
+            method: 'ethers',
+            transactionHash: contract.deploymentTransaction()?.hash,
+        };
+    }
+    // ===== UTILITY METHODS =====
+    /**
+     * Get the Thirdweb client instance
+     * @returns Thirdweb client
+     */
+    getClient() {
+        return this.client;
+    }
+    /**
+     * Get the Thirdweb account (if configured)
+     * @returns Thirdweb account or undefined
+     */
+    getAccount() {
+        return this.account;
+    }
+    /**
+     * Get the chain configuration
+     * @returns Varity chain definition
+     */
+    getChain() {
+        return this.chain;
+    }
+    /**
+     * Get the chain ID
+     * @returns Chain ID (33529)
+     */
+    getChainId() {
+        return this.chainId;
+    }
+    /**
+     * Check if Thirdweb account is configured
+     * @returns True if account is available
+     */
+    hasAccount() {
+        return !!this.account;
+    }
+    // ===== HYBRID METHODS: Try Thirdweb, fallback to Ethers =====
+    /**
+     * Deploy contract with automatic fallback
+     * Tries Thirdweb first, falls back to ethers.js on error
+     * @param params Deployment parameters
+     * @returns Deployment result
+     */
+    async deployWithFallback(params) {
+        try {
+            return await this.deployContract(params);
+        }
+        catch (error) {
+            console.warn('Thirdweb deployment failed, falling back to ethers.js:', error);
+            return await this.deployContractWithEthers(params);
+        }
+    }
+    // ===== BLOCKCHAIN QUERY METHODS (using ethers.js) =====
+    /**
+     * Get contract events
+     * @param params Event query parameters
+     * @returns Contract events
+     */
+    async getContractEvents(params) {
+        // Use ethers.js to query events
+        const provider = this.ethersProvider;
+        const filter = {
+            address: params.contract.address,
+            fromBlock: params.fromBlock || 0,
+            toBlock: params.toBlock || 'latest',
+        };
+        const logs = await provider.getLogs(filter);
+        return logs;
+    }
+    /**
+     * Get block information
+     * @param blockNumber Block number or 'latest'
+     * @returns Block information
+     */
+    async getBlock(blockNumber) {
+        return await this.ethersProvider.getBlock(blockNumber);
+    }
+    /**
+     * Get transaction information
+     * @param hash Transaction hash
+     * @returns Transaction information
+     */
+    async getTransaction(hash) {
+        return await this.ethersProvider.getTransaction(hash);
+    }
+    /**
+     * Get current gas price
+     * @returns Gas price in wei
+     */
+    async getGasPrice() {
+        const feeData = await this.ethersProvider.getFeeData();
+        return feeData.gasPrice;
+    }
+    /**
+     * Get wallet balance
+     * @param address Wallet address
+     * @returns Balance in wei
+     */
+    async getBalance(address) {
+        return await this.ethersProvider.getBalance(address);
+    }
+    /**
+     * Get NFTs for a wallet
+     * @param address Wallet address
+     * @param options Query options
+     * @returns NFT list
+     */
+    async getNFTs(address, options) {
+        // TODO: Implement NFT querying using Thirdweb SDK or external API
+        // For now, return empty array as placeholder
+        console.warn('getNFTs not yet implemented, returning empty array');
+        return [];
+    }
+    /**
+     * Get transaction history for a wallet
+     * @param address Wallet address
+     * @param options Query options
+     * @returns Transaction history
+     */
+    async getTransactionHistory(address, options) {
+        // TODO: Implement transaction history using block explorer API
+        // For now, return empty array as placeholder
+        console.warn('getTransactionHistory not yet implemented, returning empty array');
+        return [];
+    }
+    /**
+     * Get token balances for a wallet
+     * @param address Wallet address
+     * @returns Token balances
+     */
+    async getTokenBalances(address) {
+        // TODO: Implement token balance querying using Thirdweb SDK or external API
+        // For now, return empty array as placeholder
+        console.warn('getTokenBalances not yet implemented, returning empty array');
+        return [];
+    }
+    /**
+     * Send transaction
+     * @param params Transaction parameters
+     * @returns Transaction result
+     */
+    async sendTransaction(params) {
+        if (!this.account) {
+            throw new Error('Account required for sending transactions. Provide privateKey in config.');
+        }
+        // Use ethers.js to send transaction
+        const wallet = new ethers.Wallet(this.account.address, this.ethersProvider);
+        const tx = await wallet.sendTransaction({
+            to: params.to,
+            value: ethers.parseEther(params.amount),
+        });
+        await tx.wait();
+        return {
+            transactionHash: tx.hash,
+            from: params.from,
+            to: params.to,
+            amount: params.amount,
+        };
+    }
+}
+/**
+ * Factory function to create ThirdwebWrapper instance
+ * @param config Configuration options
+ * @returns ThirdwebWrapper instance
+ */
+export function createThirdwebWrapper(config) {
+    return new ThirdwebWrapper(config);
+}

package/dist/thirdweb/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Varity SDK - thirdweb Integration Module
+ *
+ * Complete thirdweb v5 integration including:
+ * - ThirdwebWrapper for contract operations
+ * - Engine for production transaction management
+ * - Nebula AI for natural language blockchain
+ * - Storage for IPFS/Arweave
+ * - Bridge for cross-chain transfers
+ * - Gateway for RPC infrastructure
+ * - x402 for API monetization
+ */
+export { ThirdwebWrapper, createThirdwebWrapper, type ThirdwebWrapperConfig, type DeployContractParams, } from './ThirdwebWrapper';
+export { EngineClient, createEngineClient, parseEngineWebhook, verifyEngineWebhook, type EngineConfig, type EngineTransactionParams, type EngineTransactionStatus, type EngineTransactionResult, type EngineDeployParams, type EngineWebhookPayload, } from './EngineClient';
+export { NebulaClient, createNebulaClient, type NebulaConfig, type GenerateContractOptions, type GeneratedContract, type QueryChainOptions, type QueryResult, type ExplainTransactionOptions, type TransactionExplanation, type GenerateCodeOptions, type GeneratedCode, type AnalyzeContractOptions, type ContractAnalysis, } from './NebulaClient';
+export { StorageClient, createStorageClient, type StorageConfig, type ThirdwebUploadResult, type NFTMetadata, type BatchUploadItem, type BatchUploadResult, type ThirdwebDownloadOptions, type ImageOptimizationOptions, } from './StorageClient';
+export { BridgeClient, createBridgeClient, type BridgeConfig, type AssetType, type BridgeRoute, type BridgeAssetParams, type BridgeStatus, type BridgeTransactionResult, type BridgeQuote, type BridgeHistoryEntry, } from './BridgeClient';
+export { GatewayClient, createGatewayClient, type GatewayConfig, type RPCRequestOptions, type RPCResponse, type GatewayStats, type WebSocketOptions, } from './GatewayClient';
+export { x402Client, createx402Client, x402Middleware, type x402Config, type PaymentEndpointConfig, type PaymentStats, type UsageRecord, type SubscriptionPlan, type Subscription, } from './x402Client';
+export { varietyTestnet, getVarityChain, isVarityChain, VARITY_TESTNET_RPC, VARITY_CHAIN_METADATA, } from './varity-chain';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/thirdweb/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC"}

package/dist/thirdweb/index.js

@@ -0,0 +1,28 @@
+/**
+ * Varity SDK - thirdweb Integration Module
+ *
+ * Complete thirdweb v5 integration including:
+ * - ThirdwebWrapper for contract operations
+ * - Engine for production transaction management
+ * - Nebula AI for natural language blockchain
+ * - Storage for IPFS/Arweave
+ * - Bridge for cross-chain transfers
+ * - Gateway for RPC infrastructure
+ * - x402 for API monetization
+ */
+// ThirdwebWrapper
+export { ThirdwebWrapper, createThirdwebWrapper, } from './ThirdwebWrapper';
+// Engine Client
+export { EngineClient, createEngineClient, parseEngineWebhook, verifyEngineWebhook, } from './EngineClient';
+// Nebula AI Client
+export { NebulaClient, createNebulaClient, } from './NebulaClient';
+// Storage Client
+export { StorageClient, createStorageClient, } from './StorageClient';
+// Bridge Client
+export { BridgeClient, createBridgeClient, } from './BridgeClient';
+// Gateway Client
+export { GatewayClient, createGatewayClient, } from './GatewayClient';
+// x402 Payment Protocol Client
+export { x402Client, createx402Client, x402Middleware, } from './x402Client';
+// Legacy chain export (backwards compatibility)
+export { varietyTestnet, getVarityChain, isVarityChain, VARITY_TESTNET_RPC, VARITY_CHAIN_METADATA, } from './varity-chain';

package/dist/thirdweb/varity-chain.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Varity L3 Chain Definition for Thirdweb SDK v5
+ *
+ * Chain ID: 33529
+ * RPC: https://rpc-varity-testnet-rroe52pwjp.t.conduit.xyz
+ * Explorer: https://explorer-varity-testnet-rroe52pwjp.t.conduit.xyz
+ *
+ * CRITICAL: Native token is USDC with 6 decimals (NOT 18!)
+ */
+/**
+ * Varity Testnet L3 Chain Configuration
+ * Built on Arbitrum Orbit framework
+ */
+export declare const varietyTestnet: Readonly<import("thirdweb/chains").ChainOptions & {
+    rpc: string;
+}>;
+/**
+ * Varity Testnet RPC Configuration
+ */
+export declare const VARITY_TESTNET_RPC = "https://rpc-varity-testnet-rroe52pwjp.t.conduit.xyz";
+/**
+ * Varity Chain Metadata
+ */
+export declare const VARITY_CHAIN_METADATA: {
+    chainId: number;
+    chainName: string;
+    rpcUrl: string;
+    explorerUrl: string;
+    nativeToken: {
+        name: string;
+        symbol: string;
+        decimals: number;
+    };
+    isTestnet: boolean;
+    l1Chain: string;
+    framework: string;
+};
+/**
+ * Helper function to get chain configuration
+ */
+export declare function getVarityChain(): Readonly<import("thirdweb/chains").ChainOptions & {
+    rpc: string;
+}>;
+/**
+ * Helper function to validate chain ID
+ */
+export declare function isVarityChain(chainId: number): boolean;
+//# sourceMappingURL=varity-chain.d.ts.map

package/dist/thirdweb/varity-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"varity-chain.d.ts","sourceRoot":"","sources":["../../src/thirdweb/varity-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;GAGG;AACH,eAAO,MAAM,cAAc;;EAgBzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB,wDAAwD,CAAC;AAExF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;CAajC,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc;;GAE7B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/thirdweb/varity-chain.js

@@ -0,0 +1,64 @@
+/**
+ * Varity L3 Chain Definition for Thirdweb SDK v5
+ *
+ * Chain ID: 33529
+ * RPC: https://rpc-varity-testnet-rroe52pwjp.t.conduit.xyz
+ * Explorer: https://explorer-varity-testnet-rroe52pwjp.t.conduit.xyz
+ *
+ * CRITICAL: Native token is USDC with 6 decimals (NOT 18!)
+ */
+import { defineChain } from 'thirdweb/chains';
+/**
+ * Varity Testnet L3 Chain Configuration
+ * Built on Arbitrum Orbit framework
+ */
+export const varietyTestnet = defineChain({
+    id: 33529,
+    name: 'Varity Testnet',
+    nativeCurrency: {
+        name: 'USDC',
+        symbol: 'USDC',
+        decimals: 6, // CRITICAL: 6 decimals, not 18!
+    },
+    blockExplorers: [
+        {
+            name: 'Varity Explorer',
+            url: 'https://explorer-varity-testnet-rroe52pwjp.t.conduit.xyz',
+            apiUrl: 'https://explorer-varity-testnet-rroe52pwjp.t.conduit.xyz/api',
+        },
+    ],
+    testnet: true,
+});
+/**
+ * Varity Testnet RPC Configuration
+ */
+export const VARITY_TESTNET_RPC = 'https://rpc-varity-testnet-rroe52pwjp.t.conduit.xyz';
+/**
+ * Varity Chain Metadata
+ */
+export const VARITY_CHAIN_METADATA = {
+    chainId: 33529,
+    chainName: 'Varity Testnet',
+    rpcUrl: VARITY_TESTNET_RPC,
+    explorerUrl: 'https://explorer-varity-testnet-rroe52pwjp.t.conduit.xyz',
+    nativeToken: {
+        name: 'USDC',
+        symbol: 'USDC',
+        decimals: 6,
+    },
+    isTestnet: true,
+    l1Chain: 'Arbitrum One',
+    framework: 'Arbitrum Orbit',
+};
+/**
+ * Helper function to get chain configuration
+ */
+export function getVarityChain() {
+    return varietyTestnet;
+}
+/**
+ * Helper function to validate chain ID
+ */
+export function isVarityChain(chainId) {
+    return chainId === 33529;
+}