@varity-labs/sdk 2.0.0-alpha.1

package/dist/chains/registry.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Chain Registry - Multi-Chain Configuration System
+ *
+ * Central registry for all supported blockchain networks in Varity SDK
+ * Supports Varity L3, Arbitrum, Base, and other EVM chains
+ */
+import { type Chain } from 'thirdweb/chains';
+/**
+ * Chain Selection Configuration
+ */
+export interface ChainSelection {
+    /**
+     * Optimization priority
+     */
+    optimize: 'cost' | 'speed' | 'security';
+    /**
+     * Optional requirements for chain selection
+     */
+    requirements?: {
+        /**
+         * Maximum acceptable gas price (in wei)
+         */
+        maxGasPrice?: bigint;
+        /**
+         * Minimum transactions per second
+         */
+        minTPS?: number;
+        /**
+         * Privacy level required
+         */
+        privacy?: 'none' | 'lit' | 'fhe' | 'tee';
+        /**
+         * Require testnet
+         */
+        testnet?: boolean;
+    };
+}
+/**
+ * Chain metadata for selection
+ */
+export interface ChainMetadata {
+    chain: Chain;
+    averageGasPrice: bigint;
+    estimatedTPS: number;
+    privacyLevel: 'none' | 'lit' | 'fhe' | 'tee';
+    costRating: number;
+    speedRating: number;
+    securityRating: number;
+}
+/**
+ * Chain Registry Class
+ *
+ * Provides centralized access to all supported chains and intelligent
+ * chain selection based on application requirements
+ */
+export declare class ChainRegistry {
+    private static chains;
+    /**
+     * Initialize the registry with chain metadata
+     */
+    static initialize(): void;
+    /**
+     * Get all supported chains
+     */
+    static getAllChains(): Chain[];
+    /**
+     * Get chain by ID
+     */
+    static getChain(chainId: number): Chain;
+    /**
+     * Get chain metadata
+     */
+    static getChainMetadata(chainId: number): ChainMetadata;
+    /**
+     * Select optimal chain based on requirements
+     */
+    static selectChain(config: ChainSelection): Chain;
+    /**
+     * Get testnet chains only
+     */
+    static getTestnetChains(): Chain[];
+    /**
+     * Get mainnet chains only
+     */
+    static getMainnetChains(): Chain[];
+    /**
+     * Check if chain is supported
+     */
+    static isSupported(chainId: number): boolean;
+    /**
+     * Add custom chain to registry
+     */
+    static addChain(chainId: number, metadata: ChainMetadata): void;
+}
+/**
+ * Convenience exports
+ */
+export declare const SUPPORTED_CHAINS: Readonly<import("thirdweb/chains").ChainOptions & {
+    rpc: string;
+}>[];
+export declare const TESTNET_CHAINS: Readonly<import("thirdweb/chains").ChainOptions & {
+    rpc: string;
+}>[];
+export declare const MAINNET_CHAINS: Readonly<import("thirdweb/chains").ChainOptions & {
+    rpc: string;
+}>[];
+/**
+ * Default chain (Varity L3 Testnet)
+ */
+export declare const DEFAULT_CHAIN: Readonly<import("thirdweb/chains").ChainOptions & {
+    rpc: string;
+}>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/chains/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/chains/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAK1D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IAExC;;OAEG;IACH,YAAY,CAAC,EAAE;QACb;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB;;WAEG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;QAEzC;;WAEG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAyC;IAE9D;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAyDzB;;OAEG;IACH,MAAM,CAAC,YAAY,IAAI,KAAK,EAAE;IAO9B;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;IAavC;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa;IAavD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,KAAK;IAgDjD;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,KAAK,EAAE;IAUlC;;OAEG;IACH,MAAM,CAAC,gBAAgB,IAAI,KAAK,EAAE;IAUlC;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAO5C;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;CAMhE;AAKD;;GAEG;AACH,eAAO,MAAM,gBAAgB;;IAA+B,CAAC;AAC7D,eAAO,MAAM,cAAc;;IAAmC,CAAC;AAC/D,eAAO,MAAM,cAAc;;IAAmC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,aAAa;;EAAkB,CAAC"}

package/dist/chains/registry.js

@@ -0,0 +1,201 @@
+/**
+ * Chain Registry - Multi-Chain Configuration System
+ *
+ * Central registry for all supported blockchain networks in Varity SDK
+ * Supports Varity L3, Arbitrum, Base, and other EVM chains
+ */
+import { varityL3Testnet } from './varityL3';
+import { arbitrumSepolia, arbitrum } from './arbitrum';
+import { baseSepolia, base } from './base';
+/**
+ * Chain Registry Class
+ *
+ * Provides centralized access to all supported chains and intelligent
+ * chain selection based on application requirements
+ */
+export class ChainRegistry {
+    /**
+     * Initialize the registry with chain metadata
+     */
+    static initialize() {
+        // Varity L3 Testnet
+        this.chains.set(33529, {
+            chain: varityL3Testnet,
+            averageGasPrice: BigInt(100000000), // 0.1 gwei (very low)
+            estimatedTPS: 500,
+            privacyLevel: 'none',
+            costRating: 1, // Cheapest
+            speedRating: 8,
+            securityRating: 7,
+        });
+        // Arbitrum Sepolia (testnet)
+        this.chains.set(421614, {
+            chain: arbitrumSepolia,
+            averageGasPrice: BigInt(100000000), // 0.1 gwei
+            estimatedTPS: 4000,
+            privacyLevel: 'none',
+            costRating: 2,
+            speedRating: 9,
+            securityRating: 8,
+        });
+        // Arbitrum One (mainnet)
+        this.chains.set(42161, {
+            chain: arbitrum,
+            averageGasPrice: BigInt(100000000), // 0.1 gwei
+            estimatedTPS: 4000,
+            privacyLevel: 'none',
+            costRating: 3,
+            speedRating: 9,
+            securityRating: 9,
+        });
+        // Base Sepolia (testnet)
+        this.chains.set(84532, {
+            chain: baseSepolia,
+            averageGasPrice: BigInt(100000000), // 0.1 gwei
+            estimatedTPS: 2000,
+            privacyLevel: 'none',
+            costRating: 2,
+            speedRating: 8,
+            securityRating: 8,
+        });
+        // Base (mainnet)
+        this.chains.set(8453, {
+            chain: base,
+            averageGasPrice: BigInt(100000000), // 0.1 gwei
+            estimatedTPS: 2000,
+            privacyLevel: 'none',
+            costRating: 3,
+            speedRating: 8,
+            securityRating: 9,
+        });
+    }
+    /**
+     * Get all supported chains
+     */
+    static getAllChains() {
+        if (this.chains.size === 0) {
+            this.initialize();
+        }
+        return Array.from(this.chains.values()).map(meta => meta.chain);
+    }
+    /**
+     * Get chain by ID
+     */
+    static getChain(chainId) {
+        if (this.chains.size === 0) {
+            this.initialize();
+        }
+        const metadata = this.chains.get(chainId);
+        if (!metadata) {
+            throw new Error(`Chain ${chainId} not found in registry`);
+        }
+        return metadata.chain;
+    }
+    /**
+     * Get chain metadata
+     */
+    static getChainMetadata(chainId) {
+        if (this.chains.size === 0) {
+            this.initialize();
+        }
+        const metadata = this.chains.get(chainId);
+        if (!metadata) {
+            throw new Error(`Chain ${chainId} not found in registry`);
+        }
+        return metadata;
+    }
+    /**
+     * Select optimal chain based on requirements
+     */
+    static selectChain(config) {
+        if (this.chains.size === 0) {
+            this.initialize();
+        }
+        let candidates = Array.from(this.chains.values());
+        // Filter by requirements
+        if (config.requirements) {
+            const { maxGasPrice, minTPS, privacy, testnet } = config.requirements;
+            if (maxGasPrice) {
+                candidates = candidates.filter(c => c.averageGasPrice <= maxGasPrice);
+            }
+            if (minTPS) {
+                candidates = candidates.filter(c => c.estimatedTPS >= minTPS);
+            }
+            if (privacy && privacy !== 'none') {
+                candidates = candidates.filter(c => c.privacyLevel === privacy);
+            }
+            if (testnet !== undefined) {
+                candidates = candidates.filter(c => c.chain.testnet === testnet);
+            }
+        }
+        if (candidates.length === 0) {
+            throw new Error('No chains match the specified requirements');
+        }
+        // Sort by optimization priority
+        switch (config.optimize) {
+            case 'cost':
+                candidates.sort((a, b) => a.costRating - b.costRating);
+                break;
+            case 'speed':
+                candidates.sort((a, b) => b.speedRating - a.speedRating);
+                break;
+            case 'security':
+                candidates.sort((a, b) => b.securityRating - a.securityRating);
+                break;
+        }
+        return candidates[0].chain;
+    }
+    /**
+     * Get testnet chains only
+     */
+    static getTestnetChains() {
+        if (this.chains.size === 0) {
+            this.initialize();
+        }
+        return Array.from(this.chains.values())
+            .filter(meta => meta.chain.testnet === true)
+            .map(meta => meta.chain);
+    }
+    /**
+     * Get mainnet chains only
+     */
+    static getMainnetChains() {
+        if (this.chains.size === 0) {
+            this.initialize();
+        }
+        return Array.from(this.chains.values())
+            .filter(meta => meta.chain.testnet !== true)
+            .map(meta => meta.chain);
+    }
+    /**
+     * Check if chain is supported
+     */
+    static isSupported(chainId) {
+        if (this.chains.size === 0) {
+            this.initialize();
+        }
+        return this.chains.has(chainId);
+    }
+    /**
+     * Add custom chain to registry
+     */
+    static addChain(chainId, metadata) {
+        if (this.chains.size === 0) {
+            this.initialize();
+        }
+        this.chains.set(chainId, metadata);
+    }
+}
+ChainRegistry.chains = new Map();
+// Initialize on import
+ChainRegistry.initialize();
+/**
+ * Convenience exports
+ */
+export const SUPPORTED_CHAINS = ChainRegistry.getAllChains();
+export const TESTNET_CHAINS = ChainRegistry.getTestnetChains();
+export const MAINNET_CHAINS = ChainRegistry.getMainnetChains();
+/**
+ * Default chain (Varity L3 Testnet)
+ */
+export const DEFAULT_CHAIN = varityL3Testnet;

package/dist/chains/varityL3.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Varity L3 Chain Configuration
+ *
+ * Varity L3 is an Arbitrum Orbit rollup deployed on Conduit
+ * Chain ID: 33529
+ * Native Token: Bridged USDC (6 decimals - NOT 18!)
+ */
+/**
+ * Varity L3 Testnet Configuration
+ *
+ * CRITICAL NOTES:
+ * - Native token is USDC with 6 decimals (not 18 like ETH)
+ * - All token amounts must account for 6 decimals: 1 USDC = 1_000_000 (not 10^18)
+ * - Chain ID 33529 is unique to Varity L3 testnet
+ * - RPC URL is Conduit-hosted (managed Arbitrum Orbit)
+ */
+export declare const varityL3Testnet: Readonly<import("thirdweb/chains").ChainOptions & {
+    rpc: string;
+}>;
+/**
+ * Alias for varityL3Testnet (for backwards compatibility)
+ */
+export declare const varityL3: Readonly<import("thirdweb/chains").ChainOptions & {
+    rpc: string;
+}>;
+/**
+ * USDC decimals constant
+ */
+export declare const USDC_DECIMALS = 6;
+/**
+ * USDC Contract Address on Varity L3
+ * CRITICAL: This is bridged USDC with 6 decimals
+ */
+export declare const VARITY_USDC_ADDRESS = "0x6Fd8ee6B4C2193e9E2e0E2EC5D295689B607c0cE";
+/**
+ * Format USDC amount (6 decimals)
+ */
+export declare function formatUSDC(amount: bigint | string | number, decimals?: number): string;
+/**
+ * Parse USDC amount to bigint (6 decimals)
+ */
+export declare function parseUSDC(amount: string | number): bigint;
+/**
+ * Block explorer URL builder
+ */
+export declare function getExplorerUrl(type: 'tx' | 'address' | 'block', hash: string): string;
+/**
+ * Format address for display (0x1234...5678)
+ */
+export declare function formatAddress(address: string, startChars?: number, endChars?: number): string;
+/**
+ * Wagmi-compatible chain configuration for Privy integration
+ * NOTE: nativeCurrency should NOT have an address field - that's non-standard
+ * and can cause issues with wallet_switchEthereumChain
+ */
+export declare const varityL3Wagmi: {
+    readonly id: 33529;
+    readonly name: "Varity L3 Testnet";
+    readonly network: "varity-testnet";
+    readonly nativeCurrency: {
+        readonly name: "USDC";
+        readonly symbol: "USDC";
+        readonly decimals: 6;
+    };
+    readonly rpcUrls: {
+        readonly default: {
+            readonly http: readonly ["https://rpc-varity-testnet-rroe52pwjp.t.conduit.xyz"];
+        };
+        readonly public: {
+            readonly http: readonly ["https://rpc-varity-testnet-rroe52pwjp.t.conduit.xyz"];
+        };
+    };
+    readonly blockExplorers: {
+        readonly default: {
+            readonly name: "Varity Explorer";
+            readonly url: "https://explorer-varity-testnet-rroe52pwjp.t.conduit.xyz";
+        };
+    };
+    readonly testnet: true;
+};
+//# sourceMappingURL=varityL3.d.ts.map

package/dist/chains/varityL3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"varityL3.d.ts","sourceRoot":"","sources":["../../src/chains/varityL3.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;;EAgB1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ;;EAAkB,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,aAAa,IAAI,CAAC;AAE/B;;;GAGG;AACH,eAAO,MAAM,mBAAmB,+CAA+C,CAAC;AAEhF;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAUjF;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAKzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAcrF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,SAAI,EAAE,QAAQ,SAAI,GAAG,MAAM,CAKnF;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;CAwBhB,CAAC"}

package/dist/chains/varityL3.js

@@ -0,0 +1,125 @@
+/**
+ * Varity L3 Chain Configuration
+ *
+ * Varity L3 is an Arbitrum Orbit rollup deployed on Conduit
+ * Chain ID: 33529
+ * Native Token: Bridged USDC (6 decimals - NOT 18!)
+ */
+import { defineChain } from 'thirdweb/chains';
+/**
+ * Varity L3 Testnet Configuration
+ *
+ * CRITICAL NOTES:
+ * - Native token is USDC with 6 decimals (not 18 like ETH)
+ * - All token amounts must account for 6 decimals: 1 USDC = 1_000_000 (not 10^18)
+ * - Chain ID 33529 is unique to Varity L3 testnet
+ * - RPC URL is Conduit-hosted (managed Arbitrum Orbit)
+ */
+export const varityL3Testnet = defineChain({
+    id: 33529,
+    name: 'Varity L3 Testnet',
+    nativeCurrency: {
+        name: 'USDC',
+        symbol: 'USDC',
+        decimals: 6, // CRITICAL: 6 decimals, NOT 18!
+    },
+    rpc: 'https://rpc-varity-testnet-rroe52pwjp.t.conduit.xyz',
+    blockExplorers: [
+        {
+            name: 'Varity Explorer',
+            url: 'https://explorer-varity-testnet-rroe52pwjp.t.conduit.xyz',
+        },
+    ],
+    testnet: true,
+});
+/**
+ * Alias for varityL3Testnet (for backwards compatibility)
+ */
+export const varityL3 = varityL3Testnet;
+/**
+ * USDC decimals constant
+ */
+export const USDC_DECIMALS = 6;
+/**
+ * USDC Contract Address on Varity L3
+ * CRITICAL: This is bridged USDC with 6 decimals
+ */
+export const VARITY_USDC_ADDRESS = '0x6Fd8ee6B4C2193e9E2e0E2EC5D295689B607c0cE';
+/**
+ * Format USDC amount (6 decimals)
+ */
+export function formatUSDC(amount, decimals = 2) {
+    const amountBigInt = typeof amount === 'bigint' ? amount : BigInt(amount);
+    const divisor = BigInt(10 ** USDC_DECIMALS);
+    const wholePart = amountBigInt / divisor;
+    const fractionalPart = amountBigInt % divisor;
+    const fractionalStr = fractionalPart.toString().padStart(USDC_DECIMALS, '0');
+    const truncatedFractional = fractionalStr.slice(0, decimals);
+    return `${wholePart}.${truncatedFractional}`;
+}
+/**
+ * Parse USDC amount to bigint (6 decimals)
+ */
+export function parseUSDC(amount) {
+    const amountStr = typeof amount === 'number' ? amount.toString() : amount;
+    const [whole, fractional = ''] = amountStr.split('.');
+    const paddedFractional = fractional.padEnd(USDC_DECIMALS, '0').slice(0, USDC_DECIMALS);
+    return BigInt(whole + paddedFractional);
+}
+/**
+ * Block explorer URL builder
+ */
+export function getExplorerUrl(type, hash) {
+    const baseUrl = varityL3Testnet.blockExplorers?.[0]?.url;
+    if (!baseUrl)
+        return '';
+    switch (type) {
+        case 'tx':
+            return `${baseUrl}/tx/${hash}`;
+        case 'address':
+            return `${baseUrl}/address/${hash}`;
+        case 'block':
+            return `${baseUrl}/block/${hash}`;
+        default:
+            return baseUrl;
+    }
+}
+/**
+ * Format address for display (0x1234...5678)
+ */
+export function formatAddress(address, startChars = 6, endChars = 4) {
+    if (!address || address.length < startChars + endChars) {
+        return address;
+    }
+    return `${address.slice(0, startChars)}...${address.slice(-endChars)}`;
+}
+/**
+ * Wagmi-compatible chain configuration for Privy integration
+ * NOTE: nativeCurrency should NOT have an address field - that's non-standard
+ * and can cause issues with wallet_switchEthereumChain
+ */
+export const varityL3Wagmi = {
+    id: 33529,
+    name: 'Varity L3 Testnet',
+    network: 'varity-testnet',
+    nativeCurrency: {
+        name: 'USDC',
+        symbol: 'USDC',
+        decimals: 6,
+    },
+    rpcUrls: {
+        default: {
+            http: ['https://rpc-varity-testnet-rroe52pwjp.t.conduit.xyz'],
+        },
+        public: {
+            http: ['https://rpc-varity-testnet-rroe52pwjp.t.conduit.xyz'],
+        },
+    },
+    blockExplorers: {
+        default: {
+            name: 'Varity Explorer',
+            url: 'https://explorer-varity-testnet-rroe52pwjp.t.conduit.xyz',
+        },
+    },
+    testnet: true,
+};

package/dist/cli/commands/clone.d.ts

@@ -0,0 +1,8 @@
+/**
+ * varity clone - Clone existing template
+ *
+ * Quickly create new template from existing one
+ */
+import { Command } from 'commander';
+export declare const cloneCommand: Command;
+//# sourceMappingURL=clone.d.ts.map

package/dist/cli/commands/clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/clone.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAOnC,eAAO,MAAM,YAAY,SAqHrB,CAAA"}