@varity-labs/sdk 2.0.0-alpha.1

package/dist/contracts/addresses.js

@@ -0,0 +1,94 @@
+/**
+ * Varity L3 Contract Addresses
+ *
+ * All deployed contract addresses on Varity L3 Testnet (Chain ID 33529)
+ *
+ * @example
+ * ```typescript
+ * import { VARITY_CONTRACTS } from '@varity-labs/sdk';
+ *
+ * const marketplaceAddress = VARITY_CONTRACTS.TemplateMarketplace;
+ * ```
+ */
+/**
+ * Varity L3 Chain ID
+ */
+export const VARITY_L3_CHAIN_ID = 33529;
+/**
+ * All deployed contract addresses on Varity L3
+ */
+export const VARITY_CONTRACTS = {
+    // ============================================================
+    // Revenue & Marketplace Contracts
+    // ============================================================
+    /**
+     * TemplateMarketplace - 90/10 revenue split
+     * - 90% goes to Developer (template/app creator)
+     * - 10% goes to Varity (platform fee)
+     *
+     * @deployed January 30, 2026 (Updated revenue split)
+     * @network Varity L3 (Chain ID 33529)
+     */
+    TemplateMarketplace: '0x769250dac29817081f38CfBa597Ef2485F3a94e8',
+    /**
+     * TemplateRegistry - Template metadata storage
+     *
+     * @deployed January 24, 2026
+     * @network Varity L3 (Chain ID 33529)
+     */
+    TemplateRegistry: '0xEbD8C516c05BD2b76b5CDd56530b3Dd9f8b3D748',
+    // ============================================================
+    // App Store Contracts
+    // ============================================================
+    /**
+     * VarityAppRegistry - App Store submissions
+     * - Developers submit apps here
+     * - Admin approval workflow
+     *
+     * @deployed January 24, 2026
+     * @network Varity L3 (Chain ID 33529)
+     * @technology Arbitrum Stylus (Rust)
+     */
+    VarityAppRegistry: '0x52d4f28ebe20fad743bbef9daa61bfe3ce91eb74',
+    // ============================================================
+    // Smart Wallet Contracts (ERC-4337 Account Abstraction)
+    // ============================================================
+    /**
+     * SimplifiedPaymaster - Sponsors gas for users
+     * - Users NEVER pay gas fees
+     * - Funded with USDC via Conduit
+     *
+     * @deployed January 13, 2026
+     * @network Varity L3 (Chain ID 33529)
+     */
+    SimplifiedPaymaster: '0xeF467aef91d4e626C7e56967779069bEF22c4453',
+    /**
+     * VarityWalletFactory - Creates smart wallets for users
+     * - Users login with email/social (never see wallet)
+     * - Creates smart wallet behind the scenes
+     *
+     * @deployed January 13, 2026
+     * @network Varity L3 (Chain ID 33529)
+     */
+    VarityWalletFactory: '0x85AB92708CB4d921f5c2BdCCd7f2D0813a380f71',
+    /**
+     * ERC-4337 EntryPoint (standard address)
+     * - v0.6: 0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789
+     */
+    EntryPoint: '0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789',
+};
+/**
+ * Revenue split percentages (TemplateMarketplace)
+ */
+export const REVENUE_SPLIT = {
+    /** Developer (creator) receives 90% */
+    DEVELOPER_PERCENT: 90,
+    /** Varity (platform) receives 10% */
+    PLATFORM_PERCENT: 10,
+};
+/**
+ * Get contract address by name
+ */
+export function getContractAddress(name) {
+    return VARITY_CONTRACTS[name];
+}

package/dist/contracts/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Contract Addresses Module
+ *
+ * Exports all deployed Varity L3 contract addresses
+ */
+export { VARITY_L3_CHAIN_ID, VARITY_CONTRACTS, REVENUE_SPLIT, getContractAddress, type VarityContractName, } from './addresses';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC"}

package/dist/contracts/index.js

@@ -0,0 +1,6 @@
+/**
+ * Contract Addresses Module
+ *
+ * Exports all deployed Varity L3 contract addresses
+ */
+export { VARITY_L3_CHAIN_ID, VARITY_CONTRACTS, REVENUE_SPLIT, getContractAddress, } from './addresses';

package/dist/core/VaritySDK.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Varity SDK v1 - Main SDK Class
+ *
+ * Entry point for all Varity SDK functionality.
+ * Provides access to ISO Dashboard modules and shared utilities.
+ */
+import { ethers } from 'ethers';
+import { VaritySDKConfig, NetworkConfig } from './types';
+import { TemplateConfig } from './template';
+import './template-loader';
+import { AuthModule } from '../modules/auth';
+import { StorageModule } from '../modules/storage';
+import { S3Module } from '../modules/storage/S3Module';
+import { ComputeModule } from '../modules/compute';
+import { ZKModule } from '../modules/zk';
+import { ContractsModule } from '../modules/contracts';
+import { OracleModule } from '../modules/oracle';
+import { AnalyticsModule } from '../modules/analytics';
+import { NotificationsModule } from '../modules/notifications';
+import { ExportModule } from '../modules/export';
+import { CacheModule } from '../modules/cache';
+import { MonitoringModule } from '../modules/monitoring';
+import { ForecastingModule } from '../modules/forecasting';
+import { WebhooksModule } from '../modules/webhooks';
+/**
+ * Main Varity SDK class
+ *
+ * **Capability-based architecture** - Universal methods that work across all templates
+ *
+ * @example
+ * ```typescript
+ * import { VaritySDK } from '@varity-labs/sdk'
+ *
+ * const sdk = new VaritySDK({
+ *   network: 'arbitrum-sepolia',
+ *   apiKey: 'your-api-key'
+ * })
+ *
+ * await sdk.connect()
+ *
+ * // Universal capability modules (work for ALL templates)
+ * await sdk.auth.login({ address: '0x...' })
+ * const encrypted = await sdk.storage.uploadEncrypted(data)
+ * const insights = await sdk.compute.query("Analyze performance")
+ * await sdk.contracts.send('MerchantRegistry', 'registerMerchant', [...])
+ * const proof = await sdk.zk.generateProof('login', { public: [...], private: [...] })
+ * const price = await sdk.oracle.getPrice('ETH')
+ * const kpis = await sdk.analytics.getKPIs({ period: 'current_month' })
+ * const forecast = await sdk.forecasting.predict({ metric: 'revenue', periods: 12, interval: 'month' })
+ * await sdk.webhooks.register({ url: 'https://api.example.com/webhook', events: ['transaction.created'] })
+ * ```
+ */
+export declare class VaritySDK {
+    private config;
+    private networkConfig;
+    private provider;
+    private signer;
+    private connected;
+    private templateConfig;
+    auth: AuthModule;
+    storage: StorageModule;
+    s3: S3Module | undefined;
+    compute: ComputeModule;
+    zk: ZKModule;
+    contracts: ContractsModule;
+    oracle: OracleModule;
+    analytics: AnalyticsModule;
+    notifications: NotificationsModule;
+    export: ExportModule;
+    cache: CacheModule;
+    monitoring: MonitoringModule;
+    forecasting: ForecastingModule;
+    webhooks: WebhooksModule;
+    /**
+     * Create a new Varity SDK instance
+     *
+     * @param config - SDK configuration
+     */
+    constructor(config?: Partial<VaritySDKConfig>);
+    /**
+     * Connect to the blockchain network
+     *
+     * @param walletProvider - Optional wallet provider (e.g., window.ethereum)
+     * @returns Promise that resolves when connected
+     */
+    connect(walletProvider?: any): Promise<void>;
+    /**
+     * Disconnect from the network
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Check if SDK is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get the current provider
+     */
+    getProvider(): ethers.Provider;
+    /**
+     * Get the current signer (throws if read-only)
+     */
+    getSigner(): ethers.Signer;
+    /**
+     * Get SDK configuration
+     */
+    getConfig(): VaritySDKConfig;
+    /**
+     * Get network configuration
+     */
+    getNetworkConfig(): NetworkConfig;
+    /**
+     * Get contract address by name
+     */
+    getContractAddress(contractName: keyof NetworkConfig['contracts']): string;
+    /**
+     * Get block number
+     */
+    getBlockNumber(): Promise<number>;
+    /**
+     * Get wallet address (if signer available)
+     */
+    getAddress(): Promise<string>;
+    /**
+     * Get wallet balance (if signer available)
+     */
+    getBalance(): Promise<bigint>;
+    /**
+     * Format balance to ETH
+     */
+    formatBalance(balance: bigint): string;
+    /**
+     * Parse ETH to Wei
+     */
+    parseEther(value: string): bigint;
+    /**
+     * Get backend API base URL
+     */
+    getAPIEndpoint(): string;
+    /**
+     * Get API key for backend services
+     */
+    getAPIKey(): string | undefined;
+    /**
+     * Get current template configuration
+     *
+     * @returns Template configuration or null if no template loaded
+     */
+    getTemplate(): TemplateConfig | null;
+    /**
+     * Load template configuration
+     *
+     * @param template - Template type or custom configuration
+     * @returns Loaded template configuration
+     *
+     * @example
+     * ```typescript
+     * // Load built-in template
+     * await sdk.loadTemplate('iso')
+     *
+     * // Load custom template
+     * await sdk.loadTemplate(customTemplateConfig)
+     * ```
+     */
+    loadTemplate(template: string | TemplateConfig): TemplateConfig;
+    /**
+     * Check if template is loaded
+     */
+    hasTemplate(): boolean;
+}
+/**
+ * Create a new Varity SDK instance (convenience function)
+ *
+ * @param config - SDK configuration
+ * @returns Configured SDK instance
+ */
+export declare function createVaritySDK(config?: Partial<VaritySDKConfig>): VaritySDK;
+//# sourceMappingURL=VaritySDK.d.ts.map

package/dist/core/VaritySDK.d.ts.map

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

package/dist/core/VaritySDK.js

@@ -0,0 +1,325 @@
+/**
+ * Varity SDK v1 - Main SDK Class
+ *
+ * Entry point for all Varity SDK functionality.
+ * Provides access to ISO Dashboard modules and shared utilities.
+ */
+import { ethers } from 'ethers';
+import { getNetworkConfig, validateContractAddresses, DEFAULT_CONFIG } from './config';
+import { templateRegistry, validateTemplate } from './template';
+import './template-loader'; // Auto-load built-in templates
+import { AuthModule } from '../modules/auth';
+import { StorageModule } from '../modules/storage';
+import { S3Module } from '../modules/storage/S3Module';
+import { ComputeModule } from '../modules/compute';
+import { ZKModule } from '../modules/zk';
+import { ContractsModule } from '../modules/contracts';
+import { OracleModule } from '../modules/oracle';
+import { AnalyticsModule } from '../modules/analytics';
+import { NotificationsModule } from '../modules/notifications';
+import { ExportModule } from '../modules/export';
+import { CacheModule } from '../modules/cache';
+import { MonitoringModule } from '../modules/monitoring';
+import { ForecastingModule } from '../modules/forecasting';
+import { WebhooksModule } from '../modules/webhooks';
+/**
+ * Main Varity SDK class
+ *
+ * **Capability-based architecture** - Universal methods that work across all templates
+ *
+ * @example
+ * ```typescript
+ * import { VaritySDK } from '@varity-labs/sdk'
+ *
+ * const sdk = new VaritySDK({
+ *   network: 'arbitrum-sepolia',
+ *   apiKey: 'your-api-key'
+ * })
+ *
+ * await sdk.connect()
+ *
+ * // Universal capability modules (work for ALL templates)
+ * await sdk.auth.login({ address: '0x...' })
+ * const encrypted = await sdk.storage.uploadEncrypted(data)
+ * const insights = await sdk.compute.query("Analyze performance")
+ * await sdk.contracts.send('MerchantRegistry', 'registerMerchant', [...])
+ * const proof = await sdk.zk.generateProof('login', { public: [...], private: [...] })
+ * const price = await sdk.oracle.getPrice('ETH')
+ * const kpis = await sdk.analytics.getKPIs({ period: 'current_month' })
+ * const forecast = await sdk.forecasting.predict({ metric: 'revenue', periods: 12, interval: 'month' })
+ * await sdk.webhooks.register({ url: 'https://api.example.com/webhook', events: ['transaction.created'] })
+ * ```
+ */
+export class VaritySDK {
+    /**
+     * Create a new Varity SDK instance
+     *
+     * @param config - SDK configuration
+     */
+    constructor(config = {}) {
+        this.provider = null;
+        this.signer = null;
+        this.connected = false;
+        this.templateConfig = null;
+        // Merge with defaults
+        this.config = {
+            ...DEFAULT_CONFIG,
+            ...config
+        };
+        // Get network configuration
+        this.networkConfig = getNetworkConfig(this.config.network);
+        // Load template configuration if specified
+        if (this.config.template) {
+            this.templateConfig = templateRegistry.get(this.config.template) || null;
+            if (!this.templateConfig) {
+                console.warn(`Warning: Template '${this.config.template}' not found in registry. ` +
+                    `SDK will operate with default configuration.`);
+            }
+        }
+        // Apply custom template config overrides
+        if (this.config.templateConfig && this.templateConfig) {
+            this.templateConfig = { ...this.templateConfig, ...this.config.templateConfig };
+        }
+        else if (this.config.templateConfig) {
+            this.templateConfig = this.config.templateConfig;
+        }
+        // Validate template if loaded
+        if (this.templateConfig) {
+            const validation = validateTemplate(this.templateConfig);
+            if (!validation.valid) {
+                console.warn(`Warning: Template validation failed:\n` +
+                    validation.errors.join('\n'));
+            }
+        }
+        // Validate contract addresses are configured (warning only, not blocking)
+        try {
+            validateContractAddresses(this.config.network);
+        }
+        catch (error) {
+            console.warn(`Warning: ${error instanceof Error ? error.message : 'Contract validation failed'}\n` +
+                `SDK will operate in read-only mode until contracts are deployed.`);
+        }
+        // Initialize capability modules (universal - work across ALL templates)
+        this.auth = new AuthModule(this);
+        this.storage = new StorageModule(this);
+        this.compute = new ComputeModule(this);
+        this.zk = new ZKModule(this);
+        this.contracts = new ContractsModule(this);
+        this.oracle = new OracleModule(this);
+        this.analytics = new AnalyticsModule(this);
+        this.notifications = new NotificationsModule(this);
+        this.export = new ExportModule(this);
+        this.cache = new CacheModule(this);
+        this.monitoring = new MonitoringModule(this);
+        this.forecasting = new ForecastingModule(this);
+        this.webhooks = new WebhooksModule(this);
+        // Initialize S3 module if S3 config provided
+        if (this.config.s3Config) {
+            this.s3 = new S3Module(this, this.config.s3Config);
+            console.log('✅ S3-compatible storage module initialized');
+        }
+        const moduleCount = 13 + (this.s3 ? 1 : 0);
+        console.log(`✅ Varity SDK initialized with comprehensive capability-based architecture (${moduleCount} universal modules)`);
+    }
+    /**
+     * Connect to the blockchain network
+     *
+     * @param walletProvider - Optional wallet provider (e.g., window.ethereum)
+     * @returns Promise that resolves when connected
+     */
+    async connect(walletProvider) {
+        try {
+            // Priority 1: Use provided wallet provider
+            if (walletProvider) {
+                const browserProvider = new ethers.BrowserProvider(walletProvider);
+                this.provider = browserProvider;
+                this.signer = await browserProvider.getSigner();
+            }
+            // Priority 2: Use configured wallet provider
+            else if (this.config.walletProvider) {
+                const browserProvider = new ethers.BrowserProvider(this.config.walletProvider);
+                this.provider = browserProvider;
+                this.signer = await browserProvider.getSigner();
+            }
+            // Priority 3: Use private key (server-side)
+            else if (this.config.privateKey) {
+                this.provider = new ethers.JsonRpcProvider(this.config.rpcUrl || this.networkConfig.rpcUrl);
+                this.signer = new ethers.Wallet(this.config.privateKey, this.provider);
+            }
+            // Priority 4: Read-only mode
+            else {
+                this.provider = new ethers.JsonRpcProvider(this.config.rpcUrl || this.networkConfig.rpcUrl);
+                console.warn('Connected in read-only mode. Provide a wallet or private key for write operations.');
+            }
+            // Verify network
+            const network = await this.provider.getNetwork();
+            if (Number(network.chainId) !== this.networkConfig.chainId) {
+                throw new Error(`Network mismatch: Expected chain ID ${this.networkConfig.chainId}, ` +
+                    `but connected to ${network.chainId}`);
+            }
+            this.connected = true;
+            console.log(`✅ Connected to ${this.config.network} (Chain ID: ${network.chainId})`);
+        }
+        catch (error) {
+            throw new Error(`Failed to connect to network: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Disconnect from the network
+     */
+    async disconnect() {
+        this.provider = null;
+        this.signer = null;
+        this.connected = false;
+        console.log('Disconnected from network');
+    }
+    /**
+     * Check if SDK is connected
+     */
+    isConnected() {
+        return this.connected;
+    }
+    /**
+     * Get the current provider
+     */
+    getProvider() {
+        if (!this.provider) {
+            throw new Error('SDK not connected. Call connect() first.');
+        }
+        return this.provider;
+    }
+    /**
+     * Get the current signer (throws if read-only)
+     */
+    getSigner() {
+        if (!this.signer) {
+            throw new Error('No signer available. SDK is in read-only mode.');
+        }
+        return this.signer;
+    }
+    /**
+     * Get SDK configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Get network configuration
+     */
+    getNetworkConfig() {
+        return { ...this.networkConfig };
+    }
+    /**
+     * Get contract address by name
+     */
+    getContractAddress(contractName) {
+        const address = this.networkConfig.contracts[contractName];
+        if (!address || address === '') {
+            throw new Error(`Contract ${contractName} not deployed on ${this.config.network}. ` +
+                `Please deploy contracts or check configuration.`);
+        }
+        return address;
+    }
+    /**
+     * Get block number
+     */
+    async getBlockNumber() {
+        const provider = this.getProvider();
+        return await provider.getBlockNumber();
+    }
+    /**
+     * Get wallet address (if signer available)
+     */
+    async getAddress() {
+        const signer = this.getSigner();
+        return await signer.getAddress();
+    }
+    /**
+     * Get wallet balance (if signer available)
+     */
+    async getBalance() {
+        const signer = this.getSigner();
+        const address = await signer.getAddress();
+        const provider = this.getProvider();
+        return await provider.getBalance(address);
+    }
+    /**
+     * Format balance to ETH
+     */
+    formatBalance(balance) {
+        return ethers.formatEther(balance);
+    }
+    /**
+     * Parse ETH to Wei
+     */
+    parseEther(value) {
+        return ethers.parseEther(value);
+    }
+    /**
+     * Get backend API base URL
+     */
+    getAPIEndpoint() {
+        return this.config.apiEndpoint || DEFAULT_CONFIG.apiEndpoint;
+    }
+    /**
+     * Get API key for backend services
+     */
+    getAPIKey() {
+        return this.config.apiKey;
+    }
+    /**
+     * Get current template configuration
+     *
+     * @returns Template configuration or null if no template loaded
+     */
+    getTemplate() {
+        return this.templateConfig;
+    }
+    /**
+     * Load template configuration
+     *
+     * @param template - Template type or custom configuration
+     * @returns Loaded template configuration
+     *
+     * @example
+     * ```typescript
+     * // Load built-in template
+     * await sdk.loadTemplate('iso')
+     *
+     * // Load custom template
+     * await sdk.loadTemplate(customTemplateConfig)
+     * ```
+     */
+    loadTemplate(template) {
+        if (typeof template === 'string') {
+            const config = templateRegistry.get(template);
+            if (!config) {
+                throw new Error(`Template '${template}' not found in registry`);
+            }
+            this.templateConfig = config;
+        }
+        else {
+            const validation = validateTemplate(template);
+            if (!validation.valid) {
+                throw new Error(`Invalid template configuration:\n${validation.errors.join('\n')}`);
+            }
+            this.templateConfig = template;
+        }
+        return this.templateConfig;
+    }
+    /**
+     * Check if template is loaded
+     */
+    hasTemplate() {
+        return this.templateConfig !== null;
+    }
+}
+/**
+ * Create a new Varity SDK instance (convenience function)
+ *
+ * @param config - SDK configuration
+ * @returns Configured SDK instance
+ */
+export function createVaritySDK(config = {}) {
+    return new VaritySDK(config);
+}