@varity-labs/sdk 2.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,31 @@
+MIT License
+
+Copyright (c) 2026 Varity Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Varity SDK - Web3 Operating System
+
+Build and deploy apps on Varity L3 with 70-85% cost savings vs traditional cloud.
+
+For more information, visit https://varity.so
+
+"Powered by Varity" attribution is required when using this SDK.

package/README.md

@@ -0,0 +1,253 @@
+# @varity/sdk
+
+**Complete Web3 SDK for Varity L3** - Build production-ready blockchain applications with multi-chain support, thirdweb integration, and enterprise-grade features.
+
+**Status:** ✅ **ALL BLOCKERS RESOLVED** - Ready for End-to-End Testing (Jan 24, 2026)
+
+## Deployed Contracts (Varity L3 - Chain ID 33529)
+
+| Contract | Address | Purpose |
+|----------|---------|---------|
+| **TemplateMarketplace** | `0x769250dac29817081f38CfBa597Ef2485F3a94e8` | **70/30 Revenue Split** |
+| **TemplateRegistry** | `0xEbD8C516c05BD2b76b5CDd56530b3Dd9f8b3D748` | Template metadata |
+| **VarityAppRegistry** | `0x52d4f28ebe20fad743bbef9daa61bfe3ce91eb74` | App Store submissions |
+| **SimplifiedPaymaster** | `0xeF467aef91d4e626C7e56967779069bEF22c4453` | Gas sponsorship |
+| **VarityWalletFactory** | `0x85AB92708CB4d921f5c2BdCCd7f2D0813a380f71` | Smart wallets |
+
+**Revenue Split:** 70% → Developer | 30% → Varity Platform
+
+## Installation
+
+```bash
+npm install @varity/sdk@alpha
+```
+
+## Quick Start
+
+```typescript
+import { createVaritySDK, varityL3Testnet, ChainRegistry } from '@varity/sdk';
+
+// Initialize SDK
+const sdk = createVaritySDK({
+  network: 'testnet',
+  apiUrl: 'https://api.varity.io',
+  thirdwebClientId: 'your-client-id'
+});
+
+// Use multi-chain configuration
+const chain = ChainRegistry.getChain(33529); // Varity L3
+console.log('Connected to:', chain.name);
+
+// Deploy a contract
+const contract = await sdk.deployContract({
+  chain: varityL3Testnet,
+  contractType: 'nft-collection',
+  name: 'My Collection'
+});
+```
+
+## Features
+
+### 🔗 Multi-Chain Support
+- **Varity L3** (Chain ID 33529) - Low-cost Arbitrum Orbit rollup with USDC gas token
+- **Arbitrum** (Sepolia & Mainnet) - Fast, low-cost L2
+- **Base** (Sepolia & Mainnet) - Coinbase's L2 built on OP Stack
+- **ChainRegistry** - Intelligent chain selection based on cost, speed, security
+
+### ⚡ Complete thirdweb Integration
+- **Engine** - Production transaction management with auto-retry and webhooks
+- **Nebula AI** - Natural language blockchain interactions (generate contracts, query chains)
+- **Storage** - Decentralized storage via IPFS/Arweave
+- **Bridge** - Cross-chain asset transfers
+- **Gateway** - Production RPC infrastructure with WebSocket support
+- **x402** - API monetization with 70/30 revenue split
+- **Smart Wallets** - ERC-4337 gasless transactions with account abstraction
+- **Server Wallets** - Backend automation for transaction signing
+
+### 🎯 Enterprise Features
+- Template system for rapid deployment (ISO, SaaS, eCommerce, Healthcare)
+- Multi-tenant architecture with wallet-based isolation
+- Comprehensive analytics and forecasting
+- ZK proofs (ZKML, privacy-preserving computations)
+- TEE support (confidential computing)
+- Encryption (Lit Protocol, FHE, AES-256-GCM)
+
+### 📦 Developer Experience
+- TypeScript-first with full type safety
+- Function-based API (thirdweb v5)
+- Comprehensive error handling
+- Detailed logging and monitoring
+- Extensive documentation
+
+## Documentation
+
+See [docs.varity.ai/packages/sdk](https://docs.varity.ai) for full documentation.
+
+## Key Exports
+
+### Multi-Chain
+```typescript
+import {
+  ChainRegistry,      // Chain registry with intelligent selection
+  varityL3,          // Varity L3 Testnet (Chain ID 33529)
+  arbitrum,          // Arbitrum One mainnet
+  arbitrumSepolia,   // Arbitrum Sepolia testnet
+  base,              // Base mainnet
+  baseSepolia,       // Base Sepolia testnet
+  formatUSDC,        // Format USDC with 6 decimals
+  parseUSDC,         // Parse USDC from string
+} from '@varity/sdk';
+```
+
+### thirdweb Clients
+```typescript
+import {
+  EngineClient,      // Production transaction management
+  NebulaClient,      // AI-powered blockchain interactions
+  StorageClient,     // IPFS/Arweave storage
+  BridgeClient,      // Cross-chain bridging
+  GatewayClient,     // RPC infrastructure
+  x402Client,        // API monetization
+  createThirdwebWrapper, // Base thirdweb wrapper
+} from '@varity/sdk';
+```
+
+### Core SDK
+```typescript
+import {
+  VaritySDK,         // Main SDK class
+  createVaritySDK,   // Factory function
+  TemplateRegistry,  // Template management
+  loadISOTemplate,   // Load ISO template
+} from '@varity/sdk';
+```
+
+### Contract Addresses (NEW - Jan 24, 2026)
+```typescript
+import {
+  VARITY_L3_CHAIN_ID,       // 33529
+  VARITY_CONTRACTS,          // All deployed contract addresses
+  REVENUE_SPLIT,             // { DEVELOPER_PERCENT: 70, PLATFORM_PERCENT: 30 }
+  getVarityContractAddress,  // Helper function
+} from '@varity/sdk';
+
+// Access specific contracts
+const marketplaceAddress = VARITY_CONTRACTS.TemplateMarketplace;
+const paymasterAddress = VARITY_CONTRACTS.SimplifiedPaymaster;
+const factoryAddress = VARITY_CONTRACTS.VarityWalletFactory;
+```
+
+## Examples
+
+### Deploy Contract with Multi-Chain
+```typescript
+import { createVaritySDK, ChainRegistry } from '@varity/sdk';
+
+const sdk = createVaritySDK({ /* config */ });
+
+// Auto-select cheapest chain
+const chain = ChainRegistry.selectChain({
+  optimize: 'cost',
+  requirements: { testnet: true }
+});
+
+const contract = await sdk.deployContract({
+  chain,
+  contractType: 'marketplace',
+  name: 'My Marketplace'
+});
+```
+
+### AI-Powered Contract Generation
+```typescript
+import { NebulaClient } from '@varity/sdk';
+
+const nebula = new NebulaClient({ apiKey: 'your-key' });
+
+// Generate Solidity from natural language
+const result = await nebula.generateContract({
+  prompt: 'Create an NFT marketplace with royalty splits',
+  language: 'solidity',
+  framework: 'foundry'
+});
+
+console.log(result.code); // Generated Solidity contract
+```
+
+### Cross-Chain Asset Bridge
+```typescript
+import { BridgeClient, varityL3, arbitrum } from '@varity/sdk';
+
+const bridge = new BridgeClient({ clientId: 'your-id' });
+
+// Get quote for bridging USDC
+const quote = await bridge.getQuote({
+  fromChain: varityL3,
+  toChain: arbitrum,
+  amount: 1000000n, // 1 USDC (6 decimals)
+  token: 'USDC'
+});
+
+// Execute bridge
+const tx = await bridge.bridgeAsset({
+  quote,
+  fromAddress: '0x...',
+  toAddress: '0x...'
+});
+```
+
+### Decentralized Storage
+```typescript
+import { StorageClient } from '@varity/sdk';
+
+const storage = new StorageClient({ clientId: 'your-id' });
+
+// Upload file to IPFS
+const file = new File(['Hello World'], 'hello.txt');
+const result = await storage.uploadFile(file);
+console.log('IPFS URI:', result.uri); // ipfs://...
+
+// Download from IPFS
+const blob = await storage.downloadFile({ uri: result.uri });
+```
+
+### API Monetization with x402
+```typescript
+import { x402Client } from '@varity/sdk';
+
+const x402 = new x402Client({ clientId: 'your-id' });
+
+// Create pay-per-call API endpoint
+const endpoint = await x402.createPaymentEndpoint({
+  apiUrl: 'https://api.yourapp.com/data',
+  pricePerCall: 10000n, // 0.01 USDC per call
+  paymentToken: 'USDC',
+  chain: varityL3
+});
+
+// Users pay with crypto, you earn 70% (thirdweb takes 30%)
+console.log('Payment endpoint:', endpoint.endpointId);
+```
+
+## Version
+
+Current version: **2.0.0-alpha.1**
+
+## License
+
+MIT - See [LICENSE](../../LICENSE) file
+
+## Contributing
+
+See [CONTRIBUTING.md](../../CONTRIBUTING.md) for development guidelines.
+
+## Support
+
+- Documentation: https://docs.varity.ai
+- Discord: https://discord.gg/varity
+- GitHub Issues: https://github.com/varity-labs/varity-sdk/issues
+- Email: support@varity.ai
+
+---
+
+**Powered by Varity** | [Website](https://varity.ai) | [Twitter](https://twitter.com/VarityLabs) | [Discord](https://discord.gg/varity)

package/dist/analytics/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Analytics Module
+ *
+ * Tracks usage events for billing and analytics
+ */
+export { AnalyticsTracker, UsageEvent, AnalyticsConfig, initializeAnalytics, getAnalyticsTracker, shutdownAnalytics } from './tracker';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,WAAW,CAAC"}

package/dist/analytics/index.js

@@ -0,0 +1,6 @@
+/**
+ * Analytics Module
+ *
+ * Tracks usage events for billing and analytics
+ */
+export { AnalyticsTracker, initializeAnalytics, getAnalyticsTracker, shutdownAnalytics } from './tracker';

package/dist/analytics/tracker.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Analytics Tracker - Tracks app usage for billing
+ *
+ * Tracks:
+ * - Deployments (static/dynamic)
+ * - API requests
+ * - Storage operations (uploads, downloads, bandwidth)
+ * - Compute usage (function executions, duration)
+ * - Smart contract interactions
+ */
+export interface UsageEvent {
+    appId: string;
+    developerId: string;
+    eventType: 'deploy' | 'api_request' | 'storage' | 'compute' | 'contract';
+    timestamp: number;
+    metadata: {
+        hostingType?: 'static' | 'dynamic';
+        buildTime?: number;
+        endpoint?: string;
+        statusCode?: number;
+        responseTime?: number;
+        operation?: 'upload' | 'download' | 'delete';
+        bytes?: number;
+        fileCount?: number;
+        functionName?: string;
+        executionTime?: number;
+        memoryUsed?: number;
+        contractAddress?: string;
+        method?: string;
+        gasUsed?: number;
+    };
+}
+export interface AnalyticsConfig {
+    apiEndpoint: string;
+    apiKey: string;
+    batchSize?: number;
+    flushInterval?: number;
+}
+export declare class AnalyticsTracker {
+    private apiEndpoint;
+    private apiKey;
+    private batchSize;
+    private flushInterval;
+    private eventQueue;
+    private flushTimer;
+    constructor(config: AnalyticsConfig);
+    /**
+     * Start auto-flush timer
+     */
+    private startAutoFlush;
+    /**
+     * Stop auto-flush timer
+     */
+    stopAutoFlush(): void;
+    /**
+     * Track a deployment event
+     */
+    trackDeployment(params: {
+        appId: string;
+        developerId: string;
+        hostingType: 'static' | 'dynamic';
+        buildTime: number;
+    }): void;
+    /**
+     * Track an API request
+     */
+    trackApiRequest(params: {
+        appId: string;
+        developerId: string;
+        endpoint: string;
+        statusCode: number;
+        responseTime: number;
+    }): void;
+    /**
+     * Track storage operation
+     */
+    trackStorage(params: {
+        appId: string;
+        developerId: string;
+        operation: 'upload' | 'download' | 'delete';
+        bytes: number;
+        fileCount: number;
+    }): void;
+    /**
+     * Track compute usage
+     */
+    trackCompute(params: {
+        appId: string;
+        developerId: string;
+        functionName: string;
+        executionTime: number;
+        memoryUsed: number;
+    }): void;
+    /**
+     * Track smart contract interaction
+     */
+    trackContract(params: {
+        appId: string;
+        developerId: string;
+        contractAddress: string;
+        method: string;
+        gasUsed: number;
+    }): void;
+    /**
+     * Internal: Add event to queue
+     */
+    private track;
+    /**
+     * Flush events to backend
+     */
+    flush(): Promise<void>;
+    /**
+     * Get current queue size
+     */
+    getQueueSize(): number;
+    /**
+     * Clear all queued events
+     */
+    clearQueue(): void;
+    /**
+     * Shutdown the tracker (flush remaining events and stop auto-flush)
+     */
+    shutdown(): Promise<void>;
+}
+export declare function initializeAnalytics(config: AnalyticsConfig): AnalyticsTracker;
+export declare function getAnalyticsTracker(): AnalyticsTracker;
+export declare function shutdownAnalytics(): Promise<void>;
+//# sourceMappingURL=tracker.d.ts.map

package/dist/analytics/tracker.d.ts.map

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

package/dist/analytics/tracker.js

@@ -0,0 +1,203 @@
+/**
+ * Analytics Tracker - Tracks app usage for billing
+ *
+ * Tracks:
+ * - Deployments (static/dynamic)
+ * - API requests
+ * - Storage operations (uploads, downloads, bandwidth)
+ * - Compute usage (function executions, duration)
+ * - Smart contract interactions
+ */
+export class AnalyticsTracker {
+    constructor(config) {
+        this.batchSize = 50;
+        this.flushInterval = 30000; // 30 seconds
+        this.eventQueue = [];
+        this.flushTimer = null;
+        this.apiEndpoint = config.apiEndpoint;
+        this.apiKey = config.apiKey;
+        if (config.batchSize) {
+            this.batchSize = config.batchSize;
+        }
+        if (config.flushInterval) {
+            this.flushInterval = config.flushInterval;
+        }
+        // Auto-flush every interval
+        this.startAutoFlush();
+    }
+    /**
+     * Start auto-flush timer
+     */
+    startAutoFlush() {
+        this.flushTimer = setInterval(() => {
+            this.flush().catch(err => {
+                console.error('Auto-flush failed:', err);
+            });
+        }, this.flushInterval);
+    }
+    /**
+     * Stop auto-flush timer
+     */
+    stopAutoFlush() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+    }
+    /**
+     * Track a deployment event
+     */
+    trackDeployment(params) {
+        this.track({
+            appId: params.appId,
+            developerId: params.developerId,
+            eventType: 'deploy',
+            timestamp: Date.now(),
+            metadata: {
+                hostingType: params.hostingType,
+                buildTime: params.buildTime
+            }
+        });
+    }
+    /**
+     * Track an API request
+     */
+    trackApiRequest(params) {
+        this.track({
+            appId: params.appId,
+            developerId: params.developerId,
+            eventType: 'api_request',
+            timestamp: Date.now(),
+            metadata: {
+                endpoint: params.endpoint,
+                statusCode: params.statusCode,
+                responseTime: params.responseTime
+            }
+        });
+    }
+    /**
+     * Track storage operation
+     */
+    trackStorage(params) {
+        this.track({
+            appId: params.appId,
+            developerId: params.developerId,
+            eventType: 'storage',
+            timestamp: Date.now(),
+            metadata: {
+                operation: params.operation,
+                bytes: params.bytes,
+                fileCount: params.fileCount
+            }
+        });
+    }
+    /**
+     * Track compute usage
+     */
+    trackCompute(params) {
+        this.track({
+            appId: params.appId,
+            developerId: params.developerId,
+            eventType: 'compute',
+            timestamp: Date.now(),
+            metadata: {
+                functionName: params.functionName,
+                executionTime: params.executionTime,
+                memoryUsed: params.memoryUsed
+            }
+        });
+    }
+    /**
+     * Track smart contract interaction
+     */
+    trackContract(params) {
+        this.track({
+            appId: params.appId,
+            developerId: params.developerId,
+            eventType: 'contract',
+            timestamp: Date.now(),
+            metadata: {
+                contractAddress: params.contractAddress,
+                method: params.method,
+                gasUsed: params.gasUsed
+            }
+        });
+    }
+    /**
+     * Internal: Add event to queue
+     */
+    track(event) {
+        this.eventQueue.push(event);
+        // Auto-flush when batch is full
+        if (this.eventQueue.length >= this.batchSize) {
+            this.flush().catch(err => {
+                console.error('Auto-flush on batch size failed:', err);
+            });
+        }
+    }
+    /**
+     * Flush events to backend
+     */
+    async flush() {
+        if (this.eventQueue.length === 0)
+            return;
+        const events = [...this.eventQueue];
+        this.eventQueue = [];
+        try {
+            const response = await fetch(`${this.apiEndpoint}/analytics/events`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-API-Key': this.apiKey
+                },
+                body: JSON.stringify({ events })
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to send analytics: ${response.status} ${response.statusText}`);
+            }
+        }
+        catch (error) {
+            console.error('Failed to send analytics events:', error);
+            // Re-queue failed events at the beginning
+            this.eventQueue.unshift(...events);
+            throw error;
+        }
+    }
+    /**
+     * Get current queue size
+     */
+    getQueueSize() {
+        return this.eventQueue.length;
+    }
+    /**
+     * Clear all queued events
+     */
+    clearQueue() {
+        this.eventQueue = [];
+    }
+    /**
+     * Shutdown the tracker (flush remaining events and stop auto-flush)
+     */
+    async shutdown() {
+        this.stopAutoFlush();
+        await this.flush();
+    }
+}
+// Global instance
+let globalTracker = null;
+export function initializeAnalytics(config) {
+    globalTracker = new AnalyticsTracker(config);
+    return globalTracker;
+}
+export function getAnalyticsTracker() {
+    if (!globalTracker) {
+        throw new Error('Analytics not initialized. Call initializeAnalytics() first.');
+    }
+    return globalTracker;
+}
+export function shutdownAnalytics() {
+    if (globalTracker) {
+        return globalTracker.shutdown();
+    }
+    return Promise.resolve();
+}