@varity-labs/client-js 2.0.0-alpha.1

package/dist/utils/formatting.js

@@ -0,0 +1,236 @@
+"use strict";
+/**
+ * Utility functions for formatting addresses, amounts, and other data
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.USDC_MULTIPLIER = exports.USDC_DECIMALS = void 0;
+exports.formatUSDC = formatUSDC;
+exports.parseUSDC = parseUSDC;
+exports.getUSDCAmount = getUSDCAmount;
+exports.isValidAddress = isValidAddress;
+exports.formatAddress = formatAddress;
+exports.shortenAddress = shortenAddress;
+exports.shortenTxHash = shortenTxHash;
+exports.formatEther = formatEther;
+exports.parseEther = parseEther;
+exports.getChainName = getChainName;
+exports.getBlockExplorerUrl = getBlockExplorerUrl;
+exports.getTxUrl = getTxUrl;
+exports.getAddressUrl = getAddressUrl;
+exports.formatTimestamp = formatTimestamp;
+exports.formatGas = formatGas;
+exports.formatPercentage = formatPercentage;
+exports.formatNumber = formatNumber;
+// USDC has 6 decimals on Varity L3
+exports.USDC_DECIMALS = 6;
+exports.USDC_MULTIPLIER = BigInt(10 ** exports.USDC_DECIMALS);
+/**
+ * Format USDC amount from raw value (6 decimals)
+ * @param amount Raw USDC amount in smallest unit
+ * @returns Formatted USDC string
+ * @example
+ * formatUSDC(1000000n) // "1.000000"
+ * formatUSDC(1500000n) // "1.500000"
+ */
+function formatUSDC(amount) {
+    const wholePart = amount / exports.USDC_MULTIPLIER;
+    const fractionalPart = amount % exports.USDC_MULTIPLIER;
+    const fractionalStr = fractionalPart.toString().padStart(exports.USDC_DECIMALS, '0');
+    return `${wholePart}.${fractionalStr}`;
+}
+/**
+ * Parse USDC amount from string to raw value
+ * @param amount USDC amount as string (e.g., "1.5", "10", "0.000001")
+ * @returns Raw USDC amount in smallest unit
+ * @example
+ * parseUSDC("1.5") // 1500000n
+ * parseUSDC("10") // 10000000n
+ */
+function parseUSDC(amount) {
+    const [whole = '0', fractional = ''] = amount.split('.');
+    const paddedFractional = fractional.padEnd(exports.USDC_DECIMALS, '0').slice(0, exports.USDC_DECIMALS);
+    return BigInt(whole) * exports.USDC_MULTIPLIER + BigInt(paddedFractional);
+}
+/**
+ * Get USDC amount with both raw and formatted values
+ * @param amount Raw USDC amount or string
+ * @returns USDCAmount object
+ */
+function getUSDCAmount(amount) {
+    const raw = typeof amount === 'string' ? parseUSDC(amount) : amount;
+    return {
+        raw,
+        formatted: formatUSDC(raw),
+        decimals: exports.USDC_DECIMALS,
+    };
+}
+/**
+ * Validate Ethereum address
+ * @param address Address to validate
+ * @returns True if valid
+ */
+function isValidAddress(address) {
+    return /^0x[a-fA-F0-9]{40}$/.test(address);
+}
+/**
+ * Format Ethereum address (checksum)
+ * @param address Address to format
+ * @returns Checksummed address
+ */
+function formatAddress(address) {
+    if (!isValidAddress(address)) {
+        throw new Error('Invalid Ethereum address');
+    }
+    // Simple checksum - in production, use ethers.getAddress()
+    return address.toLowerCase();
+}
+/**
+ * Shorten address for display
+ * @param address Full address
+ * @param chars Number of characters to show on each side
+ * @returns Shortened address
+ * @example
+ * shortenAddress("0x1234567890123456789012345678901234567890") // "0x1234...7890"
+ */
+function shortenAddress(address, chars = 4) {
+    if (!isValidAddress(address)) {
+        return address;
+    }
+    return `${address.substring(0, chars + 2)}...${address.substring(42 - chars)}`;
+}
+/**
+ * Format transaction hash for display
+ * @param hash Transaction hash
+ * @param chars Number of characters to show on each side
+ * @returns Shortened hash
+ */
+function shortenTxHash(hash, chars = 6) {
+    if (!hash || hash.length < 10) {
+        return hash;
+    }
+    return `${hash.substring(0, chars + 2)}...${hash.substring(hash.length - chars)}`;
+}
+/**
+ * Convert Wei to Ether
+ * @param wei Amount in Wei
+ * @returns Amount in Ether as string
+ */
+function formatEther(wei) {
+    const ether = wei / BigInt(10 ** 18);
+    const remainder = wei % BigInt(10 ** 18);
+    const remainderStr = remainder.toString().padStart(18, '0');
+    return `${ether}.${remainderStr}`;
+}
+/**
+ * Parse Ether to Wei
+ * @param ether Amount in Ether as string
+ * @returns Amount in Wei
+ */
+function parseEther(ether) {
+    const [whole = '0', fractional = ''] = ether.split('.');
+    const paddedFractional = fractional.padEnd(18, '0').slice(0, 18);
+    return BigInt(whole) * BigInt(10 ** 18) + BigInt(paddedFractional);
+}
+/**
+ * Get chain name from chain ID
+ * @param chainId Chain ID
+ * @returns Chain name
+ */
+function getChainName(chainId) {
+    const chains = {
+        33529: 'Varity L3',
+        421614: 'Arbitrum Sepolia',
+        42161: 'Arbitrum One',
+        1: 'Ethereum Mainnet',
+        11155111: 'Sepolia',
+    };
+    return chains[chainId] || `Chain ${chainId}`;
+}
+/**
+ * Get block explorer URL
+ * @param chainId Chain ID
+ * @returns Block explorer URL
+ */
+function getBlockExplorerUrl(chainId) {
+    const explorers = {
+        33529: 'https://explorer.varity.network',
+        421614: 'https://sepolia.arbiscan.io',
+        42161: 'https://arbiscan.io',
+        1: 'https://etherscan.io',
+        11155111: 'https://sepolia.etherscan.io',
+    };
+    return explorers[chainId] || '';
+}
+/**
+ * Get transaction URL in block explorer
+ * @param chainId Chain ID
+ * @param txHash Transaction hash
+ * @returns Transaction URL
+ */
+function getTxUrl(chainId, txHash) {
+    const explorerUrl = getBlockExplorerUrl(chainId);
+    return explorerUrl ? `${explorerUrl}/tx/${txHash}` : '';
+}
+/**
+ * Get address URL in block explorer
+ * @param chainId Chain ID
+ * @param address Address
+ * @returns Address URL
+ */
+function getAddressUrl(chainId, address) {
+    const explorerUrl = getBlockExplorerUrl(chainId);
+    return explorerUrl ? `${explorerUrl}/address/${address}` : '';
+}
+/**
+ * Format timestamp to date string
+ * @param timestamp Unix timestamp in seconds
+ * @returns Formatted date string
+ */
+function formatTimestamp(timestamp) {
+    return new Date(timestamp * 1000).toLocaleString();
+}
+/**
+ * Format gas amount for display
+ * @param gas Gas amount in wei
+ * @returns Formatted gas string
+ */
+function formatGas(gas) {
+    const gwei = gas / BigInt(10 ** 9);
+    const remainder = gas % BigInt(10 ** 9);
+    if (remainder === BigInt(0)) {
+        return `${gwei} Gwei`;
+    }
+    const decimal = Number(remainder) / 10 ** 9;
+    return `${Number(gwei) + decimal} Gwei`;
+}
+/**
+ * Calculate percentage
+ * @param value Current value
+ * @param total Total value
+ * @param decimals Number of decimal places
+ * @returns Percentage string
+ */
+function formatPercentage(value, total, decimals = 2) {
+    if (total === 0)
+        return '0%';
+    const percentage = (value / total) * 100;
+    return `${percentage.toFixed(decimals)}%`;
+}
+/**
+ * Format large numbers with K, M, B suffixes
+ * @param num Number to format
+ * @param decimals Number of decimal places
+ * @returns Formatted number string
+ */
+function formatNumber(num, decimals = 2) {
+    if (num >= 1000000000) {
+        return `${(num / 1000000000).toFixed(decimals)}B`;
+    }
+    if (num >= 1000000) {
+        return `${(num / 1000000).toFixed(decimals)}M`;
+    }
+    if (num >= 1000) {
+        return `${(num / 1000).toFixed(decimals)}K`;
+    }
+    return num.toFixed(decimals);
+}

package/dist/varity-s3-client.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Varity S3-Compatible Client
+ *
+ * AWS SDK-compatible client for Varity's decentralized storage infrastructure.
+ * Supports standard S3 operations with Filecoin/IPFS backend.
+ *
+ * @module @varity-labs/client-js
+ */
+import { S3Client, S3ClientConfig, PutObjectCommand, GetObjectCommand, DeleteObjectCommand, ListObjectsV2Command, HeadObjectCommand, CreateBucketCommand, DeleteBucketCommand, ListBucketsCommand, CopyObjectCommand, PutObjectCommandInput, GetObjectCommandInput, DeleteObjectCommandInput, ListObjectsV2CommandInput, HeadObjectCommandInput, CreateBucketCommandInput, DeleteBucketCommandInput, CopyObjectCommandInput } from '@aws-sdk/client-s3';
+export interface VarityS3ClientConfig extends Omit<S3ClientConfig, 'endpoint'> {
+    endpoint?: string;
+    gatewayType?: 's3' | 'gcs';
+    network?: 'arbitrum-sepolia' | 'arbitrum-one' | 'mainnet';
+    storageBackend?: 'filecoin-ipfs' | 'filecoin-lighthouse';
+    encryptionEnabled?: boolean;
+}
+/**
+ * Varity S3 Client
+ *
+ * Extends AWS S3Client with Varity-specific configurations and optimizations
+ * for decentralized storage infrastructure.
+ *
+ * @example
+ * ```typescript
+ * const client = new VarityS3Client({
+ *   credentials: {
+ *     accessKeyId: 'YOUR_ACCESS_KEY',
+ *     secretAccessKey: 'YOUR_SECRET_KEY'
+ *   },
+ *   network: 'arbitrum-sepolia'
+ * });
+ *
+ * // Upload object
+ * await client.putObject({
+ *   Bucket: 'my-bucket',
+ *   Key: 'my-file.txt',
+ *   Body: 'Hello, Varity!'
+ * });
+ *
+ * // Download object
+ * const response = await client.getObject({
+ *   Bucket: 'my-bucket',
+ *   Key: 'my-file.txt'
+ * });
+ * ```
+ */
+export declare class VarityS3Client extends S3Client {
+    private readonly gatewayType;
+    private readonly network;
+    private readonly storageBackend;
+    private readonly encryptionEnabled;
+    constructor(config?: VarityS3ClientConfig);
+    /**
+     * Get default endpoint based on gateway type
+     */
+    private static getDefaultEndpoint;
+    /**
+     * Upload object to Varity storage
+     */
+    putObject(params: PutObjectCommandInput): Promise<any>;
+    /**
+     * Download object from Varity storage
+     */
+    getObject(params: GetObjectCommandInput): Promise<any>;
+    /**
+     * Delete object from Varity storage
+     */
+    deleteObject(params: DeleteObjectCommandInput): Promise<any>;
+    /**
+     * List objects in bucket
+     */
+    listObjects(params: ListObjectsV2CommandInput): Promise<any>;
+    /**
+     * Get object metadata
+     */
+    headObject(params: HeadObjectCommandInput): Promise<any>;
+    /**
+     * Create bucket
+     */
+    createBucket(params: CreateBucketCommandInput): Promise<any>;
+    /**
+     * Delete bucket
+     */
+    deleteBucket(params: DeleteBucketCommandInput): Promise<any>;
+    /**
+     * List all buckets
+     */
+    listBuckets(): Promise<any>;
+    /**
+     * Copy object
+     */
+    copyObject(params: CopyObjectCommandInput): Promise<any>;
+    /**
+     * Generate presigned URL for object access
+     */
+    getSignedUrl(command: PutObjectCommand | GetObjectCommand, expiresIn?: number): Promise<string>;
+    /**
+     * Get client configuration
+     */
+    getConfig(): {
+        gatewayType: "s3" | "gcs";
+        network: string;
+        storageBackend: string;
+        encryptionEnabled: boolean;
+    };
+    /**
+     * Stream upload for large files
+     */
+    uploadStream(bucket: string, key: string, stream: ReadableStream | NodeJS.ReadableStream, metadata?: Record<string, string>): Promise<any>;
+    /**
+     * Stream download for large files
+     */
+    downloadStream(bucket: string, key: string): Promise<any>;
+}
+/**
+ * Export commonly used types
+ */
+export { PutObjectCommand, GetObjectCommand, DeleteObjectCommand, ListObjectsV2Command, HeadObjectCommand, CreateBucketCommand, DeleteBucketCommand, ListBucketsCommand, CopyObjectCommand, type PutObjectCommandInput, type GetObjectCommandInput, type DeleteObjectCommandInput, type ListObjectsV2CommandInput, type HeadObjectCommandInput, type CreateBucketCommandInput, type DeleteBucketCommandInput, type CopyObjectCommandInput };
+export default VarityS3Client;

package/dist/varity-s3-client.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * Varity S3-Compatible Client
+ *
+ * AWS SDK-compatible client for Varity's decentralized storage infrastructure.
+ * Supports standard S3 operations with Filecoin/IPFS backend.
+ *
+ * @module @varity/client-js
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CopyObjectCommand = exports.ListBucketsCommand = exports.DeleteBucketCommand = exports.CreateBucketCommand = exports.HeadObjectCommand = exports.ListObjectsV2Command = exports.DeleteObjectCommand = exports.GetObjectCommand = exports.PutObjectCommand = exports.VarityS3Client = void 0;
+const client_s3_1 = require("@aws-sdk/client-s3");
+Object.defineProperty(exports, "PutObjectCommand", { enumerable: true, get: function () { return client_s3_1.PutObjectCommand; } });
+Object.defineProperty(exports, "GetObjectCommand", { enumerable: true, get: function () { return client_s3_1.GetObjectCommand; } });
+Object.defineProperty(exports, "DeleteObjectCommand", { enumerable: true, get: function () { return client_s3_1.DeleteObjectCommand; } });
+Object.defineProperty(exports, "ListObjectsV2Command", { enumerable: true, get: function () { return client_s3_1.ListObjectsV2Command; } });
+Object.defineProperty(exports, "HeadObjectCommand", { enumerable: true, get: function () { return client_s3_1.HeadObjectCommand; } });
+Object.defineProperty(exports, "CreateBucketCommand", { enumerable: true, get: function () { return client_s3_1.CreateBucketCommand; } });
+Object.defineProperty(exports, "DeleteBucketCommand", { enumerable: true, get: function () { return client_s3_1.DeleteBucketCommand; } });
+Object.defineProperty(exports, "ListBucketsCommand", { enumerable: true, get: function () { return client_s3_1.ListBucketsCommand; } });
+Object.defineProperty(exports, "CopyObjectCommand", { enumerable: true, get: function () { return client_s3_1.CopyObjectCommand; } });
+const s3_request_presigner_1 = require("@aws-sdk/s3-request-presigner");
+/**
+ * Varity S3 Client
+ *
+ * Extends AWS S3Client with Varity-specific configurations and optimizations
+ * for decentralized storage infrastructure.
+ *
+ * @example
+ * ```typescript
+ * const client = new VarityS3Client({
+ *   credentials: {
+ *     accessKeyId: 'YOUR_ACCESS_KEY',
+ *     secretAccessKey: 'YOUR_SECRET_KEY'
+ *   },
+ *   network: 'arbitrum-sepolia'
+ * });
+ *
+ * // Upload object
+ * await client.putObject({
+ *   Bucket: 'my-bucket',
+ *   Key: 'my-file.txt',
+ *   Body: 'Hello, Varity!'
+ * });
+ *
+ * // Download object
+ * const response = await client.getObject({
+ *   Bucket: 'my-bucket',
+ *   Key: 'my-file.txt'
+ * });
+ * ```
+ */
+class VarityS3Client extends client_s3_1.S3Client {
+    constructor(config = {}) {
+        const endpoint = config.endpoint || VarityS3Client.getDefaultEndpoint(config.gatewayType);
+        const region = config.region || 'us-east-1';
+        super({
+            ...config,
+            endpoint,
+            region,
+            forcePathStyle: true, // Required for S3-compatible APIs
+        });
+        this.gatewayType = config.gatewayType || 's3';
+        this.network = config.network || 'arbitrum-sepolia';
+        this.storageBackend = config.storageBackend || 'filecoin-ipfs';
+        this.encryptionEnabled = config.encryptionEnabled ?? true;
+    }
+    /**
+     * Get default endpoint based on gateway type
+     */
+    static getDefaultEndpoint(gatewayType) {
+        return gatewayType === 'gcs'
+            ? 'http://localhost:8080' // GCS gateway default port
+            : 'http://localhost:3001'; // S3 gateway default port
+    }
+    /**
+     * Upload object to Varity storage
+     */
+    async putObject(params) {
+        const command = new client_s3_1.PutObjectCommand(params);
+        return this.send(command);
+    }
+    /**
+     * Download object from Varity storage
+     */
+    async getObject(params) {
+        const command = new client_s3_1.GetObjectCommand(params);
+        return this.send(command);
+    }
+    /**
+     * Delete object from Varity storage
+     */
+    async deleteObject(params) {
+        const command = new client_s3_1.DeleteObjectCommand(params);
+        return this.send(command);
+    }
+    /**
+     * List objects in bucket
+     */
+    async listObjects(params) {
+        const command = new client_s3_1.ListObjectsV2Command(params);
+        return this.send(command);
+    }
+    /**
+     * Get object metadata
+     */
+    async headObject(params) {
+        const command = new client_s3_1.HeadObjectCommand(params);
+        return this.send(command);
+    }
+    /**
+     * Create bucket
+     */
+    async createBucket(params) {
+        const command = new client_s3_1.CreateBucketCommand(params);
+        return this.send(command);
+    }
+    /**
+     * Delete bucket
+     */
+    async deleteBucket(params) {
+        const command = new client_s3_1.DeleteBucketCommand(params);
+        return this.send(command);
+    }
+    /**
+     * List all buckets
+     */
+    async listBuckets() {
+        const command = new client_s3_1.ListBucketsCommand({});
+        return this.send(command);
+    }
+    /**
+     * Copy object
+     */
+    async copyObject(params) {
+        const command = new client_s3_1.CopyObjectCommand(params);
+        return this.send(command);
+    }
+    /**
+     * Generate presigned URL for object access
+     */
+    async getSignedUrl(command, expiresIn = 3600) {
+        return (0, s3_request_presigner_1.getSignedUrl)(this, command, { expiresIn });
+    }
+    /**
+     * Get client configuration
+     */
+    getConfig() {
+        return {
+            gatewayType: this.gatewayType,
+            network: this.network,
+            storageBackend: this.storageBackend,
+            encryptionEnabled: this.encryptionEnabled
+        };
+    }
+    /**
+     * Stream upload for large files
+     */
+    async uploadStream(bucket, key, stream, metadata) {
+        return this.putObject({
+            Bucket: bucket,
+            Key: key,
+            Body: stream,
+            Metadata: metadata
+        });
+    }
+    /**
+     * Stream download for large files
+     */
+    async downloadStream(bucket, key) {
+        const response = await this.getObject({
+            Bucket: bucket,
+            Key: key
+        });
+        return response.Body;
+    }
+}
+exports.VarityS3Client = VarityS3Client;
+exports.default = VarityS3Client;

package/dist/wallet/WalletManager.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Wallet Manager - Handle wallet connections and operations
+ */
+import { type ThirdwebClient, type Chain } from 'thirdweb';
+import { type Account } from 'thirdweb/wallets';
+import type { WalletConnectionOptions, WalletInfo } from '../types';
+/**
+ * WalletManager - Manage wallet connections and operations
+ *
+ * @example
+ * ```typescript
+ * // Connect MetaMask
+ * const account = await walletManager.connect({ walletType: 'metamask' });
+ *
+ * // Get balance
+ * const balance = await walletManager.getBalance();
+ *
+ * // Disconnect
+ * walletManager.disconnect();
+ * ```
+ */
+export declare class WalletManager {
+    private readonly client;
+    private readonly chain;
+    private activeWallet;
+    private activeAccount;
+    constructor(client: ThirdwebClient, chain: Chain);
+    /**
+     * Connect wallet
+     * @param options Wallet connection options
+     * @returns Connected account
+     */
+    connect(options: WalletConnectionOptions): Promise<Account>;
+    /**
+     * Disconnect wallet
+     */
+    disconnect(): void;
+    /**
+     * Get connected account
+     * @returns Active account or null
+     */
+    getAccount(): Account | null;
+    /**
+     * Check if wallet is connected
+     * @returns True if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get wallet address
+     * @returns Wallet address or null
+     */
+    getAddress(): string | null;
+    /**
+     * Get wallet balance (native currency)
+     * @returns Balance in wei/smallest unit
+     */
+    getBalance(): Promise<bigint>;
+    /**
+     * Get wallet info with balance
+     * @returns Wallet information
+     */
+    getWalletInfo(): Promise<WalletInfo>;
+    /**
+     * Sign message
+     * @param message Message to sign
+     * @returns Signature
+     */
+    signMessage(message: string): Promise<string>;
+    /**
+     * Sign typed data (EIP-712)
+     * @param domain Domain data
+     * @param types Type definitions
+     * @param value Value to sign
+     * @returns Signature
+     */
+    signTypedData(domain: any, types: any, value: any): Promise<string>;
+    /**
+     * Switch chain
+     * @param chainId Chain ID to switch to
+     */
+    switchChain(chainId: number): Promise<void>;
+    /**
+     * Get chain ID from wallet
+     * @returns Current chain ID
+     */
+    getChainId(): Promise<number>;
+    /**
+     * Send native currency transaction
+     * @param to Recipient address
+     * @param amount Amount to send (in wei/smallest unit)
+     * @returns Transaction hash
+     */
+    sendTransaction(to: string, amount: bigint): Promise<string>;
+    /**
+     * Get transaction count (nonce)
+     * @returns Transaction count
+     */
+    getTransactionCount(): Promise<number>;
+    /**
+     * Format balance with decimals
+     * @param balance Balance in smallest unit
+     * @param decimals Number of decimals
+     * @returns Formatted balance string
+     */
+    private formatBalance;
+    /**
+     * Request wallet permissions
+     * @param permissions Permissions to request
+     */
+    requestPermissions(permissions: string[]): Promise<void>;
+    /**
+     * Add custom token to wallet
+     * @param tokenAddress Token contract address
+     * @param symbol Token symbol
+     * @param decimals Token decimals
+     * @param image Token image URL
+     */
+    addToken(tokenAddress: string, symbol: string, decimals: number, image?: string): Promise<void>;
+}
+export default WalletManager;