@varity-labs/client-js 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,82 @@
+# @varity/client-js
+
+> Comprehensive JavaScript/TypeScript SDK for Varity L3 Blockchain - Powered by Thirdweb v5.112.0
+
+[![npm version](https://img.shields.io/npm/v/@varity/client-js.svg)](https://www.npmjs.com/package/@varity/client-js)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+## Overview
+
+`@varity/client-js` is a complete SDK for building applications on Varity L3, an Arbitrum Orbit L3 blockchain with USDC as the native gas token. This library provides:
+
+- 🔗 **Wallet Management** - Connect MetaMask, WalletConnect, Coinbase, and more
+- 📝 **Smart Contract Interactions** - Read, write, deploy, and monitor contracts
+- 🔐 **SIWE Authentication** - Sign-In with Ethereum (EIP-4361)
+- 📦 **IPFS Storage** - Upload and download files via Thirdweb
+- ⚛️ **React Hooks** - Easy integration with React applications
+- 💰 **USDC Support** - Native 6-decimal USDC handling utilities
+- 🌐 **Multi-Chain** - Support for Varity L3, Arbitrum Sepolia, and Arbitrum One
+
+## Installation
+
+```bash
+npm install @varity/client-js thirdweb
+```
+
+## Quick Start
+
+```typescript
+import { VarityClient, formatUSDC } from '@varity/client-js';
+
+// Initialize client
+const client = new VarityClient({
+  clientId: 'your-thirdweb-client-id',
+  chain: 'varity-l3'
+});
+
+// Connect wallet
+const account = await client.wallet.connect({ walletType: 'metamask' });
+console.log('Connected:', account.address);
+
+// Get balance
+const balance = await client.wallet.getBalance();
+console.log('Balance:', formatUSDC(balance), 'USDC');
+```
+
+## Complete Documentation
+
+See [examples/](./examples/) directory for comprehensive usage examples:
+
+- `basic-usage.ts` - Basic client operations
+- `contract-interaction.ts` - Smart contract interactions
+- `wallet-connection.ts` - Wallet connection methods
+- `siwe-auth.ts` - SIWE authentication flow
+- `storage-ipfs.ts` - IPFS storage operations
+- `react-app.tsx` - React application with hooks
+
+## Chain Configuration
+
+### Varity L3
+
+```
+Chain ID: 33529
+RPC URL: https://rpc-varity-l3-testnet-wkkzw3oqsj.t.conduit.xyz
+Native Currency: USDC (6 decimals)
+Block Explorer: https://explorer-varity-l3-testnet-wkkzw3oqsj.t.conduit.xyz
+```
+
+## API Reference
+
+- **VarityClient** - Main client class
+- **WalletManager** - Wallet operations
+- **ContractManager** - Smart contract interactions
+- **SIWEAuth** - Authentication
+- **StorageManager** - IPFS storage
+
+## License
+
+MIT License - see [LICENSE](./LICENSE) file for details.
+
+---
+
+**Made with ❤️ by Varity**

package/dist/VarityClient.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Varity Client - Main entry point for Varity L3 blockchain interactions
+ *
+ * This client provides a comprehensive SDK for interacting with Varity L3,
+ * including wallet management, contract interactions, authentication, and storage.
+ */
+import { type ThirdwebClient, type Chain } from 'thirdweb';
+import { ContractManager } from './contracts/ContractManager';
+import { WalletManager } from './wallet/WalletManager';
+import { SIWEAuth } from './auth/SIWEAuth';
+import { StorageManager } from './storage/StorageManager';
+import type { VarityClientConfig, ChainConfig } from './types';
+export declare const VARITY_L3_CHAIN: ChainConfig;
+export declare const ARBITRUM_SEPOLIA_CHAIN: ChainConfig;
+export declare const ARBITRUM_ONE_CHAIN: ChainConfig;
+/**
+ * Main Varity Client Class
+ *
+ * Provides comprehensive SDK for Varity L3 blockchain interactions.
+ *
+ * @example
+ * ```typescript
+ * // Initialize client
+ * const client = new VarityClient({
+ *   clientId: 'your-thirdweb-client-id',
+ *   chain: 'varity-l3'
+ * });
+ *
+ * // Connect wallet
+ * await client.wallet.connect({ walletType: 'metamask' });
+ *
+ * // Read from contract
+ * const balance = await client.contracts.read({
+ *   address: '0x...',
+ *   abi: [...],
+ *   functionName: 'balanceOf',
+ *   args: ['0x...']
+ * });
+ * ```
+ */
+export declare class VarityClient {
+    private readonly thirdwebClient;
+    private readonly activeChain;
+    readonly contracts: ContractManager;
+    readonly wallet: WalletManager;
+    readonly auth: SIWEAuth;
+    readonly storage: StorageManager;
+    constructor(config?: VarityClientConfig);
+    /**
+     * Get chain configuration from config
+     */
+    private getChainFromConfig;
+    /**
+     * Get the Thirdweb client instance
+     */
+    getThirdwebClient(): ThirdwebClient;
+    /**
+     * Get the active chain
+     */
+    getChain(): Chain;
+    /**
+     * Get chain ID
+     */
+    getChainId(): number;
+    /**
+     * Get chain name
+     */
+    getChainName(): string;
+    /**
+     * Get RPC URL
+     */
+    getRpcUrl(): string;
+    /**
+     * Check if connected to Varity L3
+     */
+    isVarityL3(): boolean;
+    /**
+     * Get native currency info
+     */
+    getNativeCurrency(): {
+        name?: string;
+        symbol?: string;
+        decimals?: number;
+    };
+    /**
+     * Get client configuration
+     */
+    getConfig(): {
+        chainId: number;
+        chainName: string;
+        rpcUrl: string;
+        nativeCurrency: {
+            name?: string;
+            symbol?: string;
+            decimals?: number;
+        };
+        isVarityL3: boolean;
+    };
+    /**
+     * Dispose and cleanup resources
+     */
+    dispose(): void;
+}
+export default VarityClient;

package/dist/VarityClient.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * Varity Client - Main entry point for Varity L3 blockchain interactions
+ *
+ * This client provides a comprehensive SDK for interacting with Varity L3,
+ * including wallet management, contract interactions, authentication, and storage.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VarityClient = exports.ARBITRUM_ONE_CHAIN = exports.ARBITRUM_SEPOLIA_CHAIN = exports.VARITY_L3_CHAIN = void 0;
+const thirdweb_1 = require("thirdweb");
+const ContractManager_1 = require("./contracts/ContractManager");
+const WalletManager_1 = require("./wallet/WalletManager");
+const SIWEAuth_1 = require("./auth/SIWEAuth");
+const StorageManager_1 = require("./storage/StorageManager");
+// Thirdweb Client ID loaded from environment
+const DEFAULT_CLIENT_ID = process.env.VARITY_THIRDWEB_CLIENT_ID || process.env.THIRDWEB_CLIENT_ID || '';
+// Varity L3 Chain Configuration
+exports.VARITY_L3_CHAIN = {
+    chainId: 33529,
+    name: 'Varity L3',
+    rpcUrl: 'https://rpc-varity-l3-testnet-wkkzw3oqsj.t.conduit.xyz',
+    nativeCurrency: {
+        name: 'USDC',
+        symbol: 'USDC',
+        decimals: 6,
+    },
+    blockExplorer: 'https://explorer-varity-l3-testnet-wkkzw3oqsj.t.conduit.xyz',
+};
+// Arbitrum Sepolia Configuration
+exports.ARBITRUM_SEPOLIA_CHAIN = {
+    chainId: 421614,
+    name: 'Arbitrum Sepolia',
+    rpcUrl: 'https://sepolia-rollup.arbitrum.io/rpc',
+    nativeCurrency: {
+        name: 'Ethereum',
+        symbol: 'ETH',
+        decimals: 18,
+    },
+    blockExplorer: 'https://sepolia.arbiscan.io',
+};
+// Arbitrum One Configuration
+exports.ARBITRUM_ONE_CHAIN = {
+    chainId: 42161,
+    name: 'Arbitrum One',
+    rpcUrl: 'https://arb1.arbitrum.io/rpc',
+    nativeCurrency: {
+        name: 'Ethereum',
+        symbol: 'ETH',
+        decimals: 18,
+    },
+    blockExplorer: 'https://arbiscan.io',
+};
+/**
+ * Main Varity Client Class
+ *
+ * Provides comprehensive SDK for Varity L3 blockchain interactions.
+ *
+ * @example
+ * ```typescript
+ * // Initialize client
+ * const client = new VarityClient({
+ *   clientId: 'your-thirdweb-client-id',
+ *   chain: 'varity-l3'
+ * });
+ *
+ * // Connect wallet
+ * await client.wallet.connect({ walletType: 'metamask' });
+ *
+ * // Read from contract
+ * const balance = await client.contracts.read({
+ *   address: '0x...',
+ *   abi: [...],
+ *   functionName: 'balanceOf',
+ *   args: ['0x...']
+ * });
+ * ```
+ */
+class VarityClient {
+    constructor(config = {}) {
+        // Create Thirdweb client
+        const clientId = config.clientId || DEFAULT_CLIENT_ID;
+        this.thirdwebClient = (0, thirdweb_1.createThirdwebClient)({
+            clientId,
+            secretKey: config.secretKey,
+        });
+        // Setup chain
+        this.activeChain = this.getChainFromConfig(config);
+        // Initialize managers
+        this.contracts = new ContractManager_1.ContractManager(this.thirdwebClient, this.activeChain);
+        this.wallet = new WalletManager_1.WalletManager(this.thirdwebClient, this.activeChain);
+        this.auth = new SIWEAuth_1.SIWEAuth(this.thirdwebClient, this.activeChain);
+        this.storage = new StorageManager_1.StorageManager(this.thirdwebClient);
+    }
+    /**
+     * Get chain configuration from config
+     */
+    getChainFromConfig(config) {
+        // If custom chain provided
+        if (config.customChain) {
+            return (0, thirdweb_1.defineChain)({
+                id: config.customChain.chainId,
+                name: config.customChain.name,
+                rpc: config.customChain.rpcUrl,
+                nativeCurrency: config.customChain.nativeCurrency,
+            });
+        }
+        // If Chain object provided directly
+        if (typeof config.chain === 'object') {
+            return config.chain;
+        }
+        // Use predefined chains
+        const chainName = config.chain || 'varity-l3';
+        switch (chainName) {
+            case 'varity-l3':
+                return (0, thirdweb_1.defineChain)({
+                    id: exports.VARITY_L3_CHAIN.chainId,
+                    name: exports.VARITY_L3_CHAIN.name,
+                    rpc: exports.VARITY_L3_CHAIN.rpcUrl,
+                    nativeCurrency: exports.VARITY_L3_CHAIN.nativeCurrency,
+                });
+            case 'arbitrum-sepolia':
+                return (0, thirdweb_1.defineChain)({
+                    id: exports.ARBITRUM_SEPOLIA_CHAIN.chainId,
+                    name: exports.ARBITRUM_SEPOLIA_CHAIN.name,
+                    rpc: exports.ARBITRUM_SEPOLIA_CHAIN.rpcUrl,
+                    nativeCurrency: exports.ARBITRUM_SEPOLIA_CHAIN.nativeCurrency,
+                });
+            case 'arbitrum-one':
+                return (0, thirdweb_1.defineChain)({
+                    id: exports.ARBITRUM_ONE_CHAIN.chainId,
+                    name: exports.ARBITRUM_ONE_CHAIN.name,
+                    rpc: exports.ARBITRUM_ONE_CHAIN.rpcUrl,
+                    nativeCurrency: exports.ARBITRUM_ONE_CHAIN.nativeCurrency,
+                });
+            default:
+                // Default to Varity L3
+                return (0, thirdweb_1.defineChain)({
+                    id: exports.VARITY_L3_CHAIN.chainId,
+                    name: exports.VARITY_L3_CHAIN.name,
+                    rpc: exports.VARITY_L3_CHAIN.rpcUrl,
+                    nativeCurrency: exports.VARITY_L3_CHAIN.nativeCurrency,
+                });
+        }
+    }
+    /**
+     * Get the Thirdweb client instance
+     */
+    getThirdwebClient() {
+        return this.thirdwebClient;
+    }
+    /**
+     * Get the active chain
+     */
+    getChain() {
+        return this.activeChain;
+    }
+    /**
+     * Get chain ID
+     */
+    getChainId() {
+        return this.activeChain.id;
+    }
+    /**
+     * Get chain name
+     */
+    getChainName() {
+        return this.activeChain.name || `Chain ${this.activeChain.id}`;
+    }
+    /**
+     * Get RPC URL
+     */
+    getRpcUrl() {
+        return this.activeChain.rpc || '';
+    }
+    /**
+     * Check if connected to Varity L3
+     */
+    isVarityL3() {
+        return this.activeChain.id === exports.VARITY_L3_CHAIN.chainId;
+    }
+    /**
+     * Get native currency info
+     */
+    getNativeCurrency() {
+        return this.activeChain.nativeCurrency || {
+            name: 'USDC',
+            symbol: 'USDC',
+            decimals: 6,
+        };
+    }
+    /**
+     * Get client configuration
+     */
+    getConfig() {
+        return {
+            chainId: this.getChainId(),
+            chainName: this.getChainName(),
+            rpcUrl: this.getRpcUrl(),
+            nativeCurrency: this.getNativeCurrency(),
+            isVarityL3: this.isVarityL3(),
+        };
+    }
+    /**
+     * Dispose and cleanup resources
+     */
+    dispose() {
+        // Cleanup any active connections or subscriptions
+        this.wallet.disconnect();
+    }
+}
+exports.VarityClient = VarityClient;
+exports.default = VarityClient;

package/dist/__tests__/client.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Comprehensive Test Suite for Varity Client
+ */
+export {};

package/dist/__tests__/client.test.js

@@ -0,0 +1,251 @@
+"use strict";
+/**
+ * Comprehensive Test Suite for Varity Client
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const VarityClient_1 = require("../VarityClient");
+const formatting_1 = require("../utils/formatting");
+// Mock Thirdweb SDK
+jest.mock('thirdweb', () => ({
+    createThirdwebClient: jest.fn(() => ({ clientId: 'test' })),
+    defineChain: jest.fn((config) => ({
+        id: config.id,
+        name: config.name,
+        rpc: config.rpc,
+        nativeCurrency: config.nativeCurrency,
+    })),
+    getContract: jest.fn(),
+    readContract: jest.fn(),
+    sendTransaction: jest.fn(),
+    upload: jest.fn(),
+    download: jest.fn(),
+    getWalletBalance: jest.fn(),
+}));
+jest.mock('thirdweb/wallets', () => ({
+    createWallet: jest.fn(() => ({
+        connect: jest.fn(),
+        disconnect: jest.fn(),
+    })),
+}));
+describe('VarityClient', () => {
+    describe('Client Initialization', () => {
+        test('should create client with default configuration', () => {
+            const client = new VarityClient_1.VarityClient();
+            expect(client).toBeDefined();
+            expect(client.getChainId()).toBe(33529); // Varity L3
+        });
+        test('should create client with custom chain', () => {
+            const client = new VarityClient_1.VarityClient({
+                chain: 'arbitrum-sepolia',
+            });
+            expect(client.getChainId()).toBe(421614); // Arbitrum Sepolia
+        });
+        test('should create client with custom client ID', () => {
+            const client = new VarityClient_1.VarityClient({
+                clientId: 'custom-client-id',
+            });
+            expect(client).toBeDefined();
+        });
+        test('should identify Varity L3 correctly', () => {
+            const clientL3 = new VarityClient_1.VarityClient({ chain: 'varity-l3' });
+            const clientSepolia = new VarityClient_1.VarityClient({ chain: 'arbitrum-sepolia' });
+            expect(clientL3.isVarityL3()).toBe(true);
+            expect(clientSepolia.isVarityL3()).toBe(false);
+        });
+        test('should get correct chain configuration', () => {
+            const client = new VarityClient_1.VarityClient({ chain: 'varity-l3' });
+            const config = client.getConfig();
+            expect(config.chainId).toBe(33529);
+            expect(config.chainName).toBe('Varity L3');
+            expect(config.isVarityL3).toBe(true);
+            expect(config.nativeCurrency.symbol).toBe('USDC');
+            expect(config.nativeCurrency.decimals).toBe(6);
+        });
+    });
+    describe('USDC Formatting', () => {
+        test('should format USDC correctly', () => {
+            expect((0, formatting_1.formatUSDC)(BigInt(1000000))).toBe('1.000000');
+            expect((0, formatting_1.formatUSDC)(BigInt(1500000))).toBe('1.500000');
+            expect((0, formatting_1.formatUSDC)(BigInt(100))).toBe('0.000100');
+            expect((0, formatting_1.formatUSDC)(BigInt(0))).toBe('0.000000');
+        });
+        test('should parse USDC correctly', () => {
+            expect((0, formatting_1.parseUSDC)('1')).toBe(BigInt(1000000));
+            expect((0, formatting_1.parseUSDC)('1.5')).toBe(BigInt(1500000));
+            expect((0, formatting_1.parseUSDC)('0.000001')).toBe(BigInt(1));
+            expect((0, formatting_1.parseUSDC)('10.5')).toBe(BigInt(10500000));
+        });
+        test('should handle USDC edge cases', () => {
+            expect((0, formatting_1.formatUSDC)(BigInt(0))).toBe('0.000000');
+            expect((0, formatting_1.parseUSDC)('0')).toBe(BigInt(0));
+            expect((0, formatting_1.parseUSDC)('0.000001')).toBe(BigInt(1));
+        });
+        test('should get USDC amount object', () => {
+            const amount = (0, formatting_1.getUSDCAmount)(BigInt(1500000));
+            expect(amount.raw).toBe(BigInt(1500000));
+            expect(amount.formatted).toBe('1.500000');
+            expect(amount.decimals).toBe(6);
+        });
+        test('should parse and format USDC round-trip', () => {
+            const original = '2.5';
+            const parsed = (0, formatting_1.parseUSDC)(original);
+            const formatted = (0, formatting_1.formatUSDC)(parsed);
+            expect(formatted).toBe('2.500000');
+        });
+    });
+    describe('Address Utilities', () => {
+        test('should validate addresses correctly', () => {
+            expect((0, formatting_1.isValidAddress)('0x1234567890123456789012345678901234567890')).toBe(true);
+            expect((0, formatting_1.isValidAddress)('0xABCDEF1234567890ABCDEF1234567890ABCDEF12')).toBe(true);
+            expect((0, formatting_1.isValidAddress)('invalid')).toBe(false);
+            expect((0, formatting_1.isValidAddress)('0x123')).toBe(false);
+            expect((0, formatting_1.isValidAddress)('')).toBe(false);
+        });
+        test('should shorten addresses correctly', () => {
+            const address = '0x1234567890123456789012345678901234567890';
+            expect((0, formatting_1.shortenAddress)(address)).toBe('0x1234...7890');
+            expect((0, formatting_1.shortenAddress)(address, 6)).toBe('0x123456...567890');
+        });
+        test('should handle invalid addresses in shortening', () => {
+            expect((0, formatting_1.shortenAddress)('invalid')).toBe('invalid');
+        });
+    });
+    describe('Chain Utilities', () => {
+        test('should get correct chain names', () => {
+            expect((0, formatting_1.getChainName)(33529)).toBe('Varity L3');
+            expect((0, formatting_1.getChainName)(421614)).toBe('Arbitrum Sepolia');
+            expect((0, formatting_1.getChainName)(42161)).toBe('Arbitrum One');
+            expect((0, formatting_1.getChainName)(999999)).toContain('Chain 999999');
+        });
+    });
+    describe('Client Managers', () => {
+        test('should have contract manager', () => {
+            const client = new VarityClient_1.VarityClient();
+            expect(client.contracts).toBeDefined();
+        });
+        test('should have wallet manager', () => {
+            const client = new VarityClient_1.VarityClient();
+            expect(client.wallet).toBeDefined();
+        });
+        test('should have auth manager', () => {
+            const client = new VarityClient_1.VarityClient();
+            expect(client.auth).toBeDefined();
+        });
+        test('should have storage manager', () => {
+            const client = new VarityClient_1.VarityClient();
+            expect(client.storage).toBeDefined();
+        });
+    });
+});
+describe('WalletManager', () => {
+    let client;
+    beforeEach(() => {
+        client = new VarityClient_1.VarityClient();
+    });
+    test('should check connection status', () => {
+        expect(client.wallet.isConnected()).toBe(false);
+    });
+    test('should get null address when not connected', () => {
+        expect(client.wallet.getAddress()).toBeNull();
+    });
+    test('should get null account when not connected', () => {
+        expect(client.wallet.getAccount()).toBeNull();
+    });
+});
+describe('SIWEAuth', () => {
+    let client;
+    beforeEach(() => {
+        client = new VarityClient_1.VarityClient();
+    });
+    test('should generate SIWE message', async () => {
+        const message = await client.auth.generateMessage({
+            domain: 'example.com',
+            address: '0x1234567890123456789012345678901234567890',
+            statement: 'Sign in to example',
+            uri: 'https://example.com',
+        });
+        expect(message).toContain('example.com');
+        expect(message).toContain('0x1234567890123456789012345678901234567890');
+        expect(message).toContain('Sign in to example');
+    });
+    test('should format SIWE message correctly', async () => {
+        const message = await client.auth.generateMessage({
+            domain: 'test.com',
+            address: '0x0000000000000000000000000000000000000000',
+            statement: 'Test statement',
+        });
+        expect(message).toContain('URI:');
+        expect(message).toContain('Version:');
+        expect(message).toContain('Chain ID:');
+        expect(message).toContain('Nonce:');
+        expect(message).toContain('Issued At:');
+    });
+});
+describe('StorageManager', () => {
+    let client;
+    beforeEach(() => {
+        client = new VarityClient_1.VarityClient();
+    });
+    test('should validate CIDs correctly', () => {
+        const validCIDv0 = 'QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG';
+        const invalidCID = 'invalid-cid';
+        expect(client.storage.isValidCID(validCIDv0)).toBe(true);
+        expect(client.storage.isValidCID(invalidCID)).toBe(false);
+    });
+    test('should get gateway URL', () => {
+        const cid = 'QmTest123';
+        const url = client.storage.getGatewayUrl(cid);
+        expect(url).toContain(cid);
+        expect(url).toContain('ipfs');
+    });
+    test('should get IPFS URI', () => {
+        const cid = 'QmTest123';
+        const uri = client.storage.getIPFSUri(cid);
+        expect(uri).toBe(`ipfs://${cid}`);
+    });
+    test('should handle CID with ipfs:// prefix', () => {
+        const cid = 'ipfs://QmTest123';
+        const uri = client.storage.getIPFSUri(cid);
+        expect(uri).toBe('ipfs://QmTest123');
+    });
+});
+describe('Error Handling', () => {
+    test('should create custom errors', () => {
+        const { VarityError, WalletError, ContractError } = require('../types');
+        const varietyError = new VarityError('Test error', 'TEST_CODE');
+        expect(varietyError.message).toBe('Test error');
+        expect(varietyError.code).toBe('TEST_CODE');
+        const walletError = new WalletError('Wallet error');
+        expect(walletError.name).toBe('WalletError');
+        const contractError = new ContractError('Contract error');
+        expect(contractError.name).toBe('ContractError');
+    });
+});
+describe('Integration Tests', () => {
+    test('should create full workflow', () => {
+        // Create client
+        const client = new VarityClient_1.VarityClient({ chain: 'varity-l3' });
+        // Verify client is created
+        expect(client).toBeDefined();
+        expect(client.isVarityL3()).toBe(true);
+        // Verify all managers are available
+        expect(client.contracts).toBeDefined();
+        expect(client.wallet).toBeDefined();
+        expect(client.auth).toBeDefined();
+        expect(client.storage).toBeDefined();
+        // Test USDC operations
+        const amount = (0, formatting_1.parseUSDC)('10.5');
+        const formatted = (0, formatting_1.formatUSDC)(amount);
+        expect(formatted).toBe('10.500000');
+        // Cleanup
+        client.dispose();
+    });
+    test('should handle multiple clients', () => {
+        const client1 = new VarityClient_1.VarityClient({ chain: 'varity-l3' });
+        const client2 = new VarityClient_1.VarityClient({ chain: 'arbitrum-sepolia' });
+        expect(client1.getChainId()).toBe(33529);
+        expect(client2.getChainId()).toBe(421614);
+        client1.dispose();
+        client2.dispose();
+    });
+});