@zubari/sdk 0.1.2 → 0.1.4

package/dist/TransactionService-CxwB1kpN.d.mts

@@ -0,0 +1,205 @@
+import { k as SwapQuote, b as TxResult, N as NetworkType } from './index-DhluuR9H.mjs';
+
+/**
+ * SwapService - DEX integration via Velora
+ *
+ * Handles token swaps with slippage protection,
+ * quote fetching, and earnings conversion.
+ */
+declare class SwapService {
+    private readonly _chainId;
+    private readonly isTestnet;
+    constructor(chainId: number, isTestnet?: boolean);
+    /**
+     * Get a swap quote
+     */
+    getQuote(tokenIn: string, tokenOut: string, amountIn: bigint): Promise<SwapQuote>;
+    /**
+     * Execute a swap with slippage protection
+     */
+    executeSwap(quote: SwapQuote, slippageToleranceBps?: number): Promise<TxResult>;
+    /**
+     * Convert earnings to USDT, keeping some ETH for gas
+     */
+    convertEarningsToStable(ethBalance: bigint, reserveForGas?: bigint): Promise<TxResult>;
+    /**
+     * Check if a swap route exists
+     */
+    hasRoute(tokenIn: string, tokenOut: string): Promise<boolean>;
+    /**
+     * Get supported tokens for swapping
+     */
+    getSupportedTokens(): Promise<string[]>;
+}
+
+/**
+ * Transaction Service for Zubari SDK
+ *
+ * Provides multi-chain transaction capabilities using Tether WDK.
+ * Supports Ethereum, Bitcoin, Solana, TON, TRON, and Spark (Lightning).
+ *
+ * @see https://docs.wallet.tether.io/
+ */
+
+/**
+ * Transaction parameters for sending
+ */
+interface TransactionParams {
+    /** Recipient address */
+    to: string;
+    /** Amount to send (in human-readable format, e.g., "0.1") */
+    amount: string;
+    /** Token address (optional, for ERC-20/SPL tokens) */
+    token?: string;
+    /** Transaction memo/message (for chains that support it) */
+    memo?: string;
+    /** Fee priority: 'slow' | 'medium' | 'fast' */
+    feePriority?: 'slow' | 'medium' | 'fast';
+    /** Custom gas limit (EVM chains) */
+    gasLimit?: string;
+    /** Custom gas price (EVM chains) */
+    gasPrice?: string;
+}
+/**
+ * Transaction result with detailed information
+ */
+interface TransactionResult {
+    /** Transaction hash */
+    hash: string;
+    /** Network/chain */
+    network: NetworkType;
+    /** Transaction status */
+    status: 'pending' | 'confirmed' | 'failed';
+    /** Block number (when confirmed) */
+    blockNumber?: number;
+    /** Gas used (EVM chains) */
+    gasUsed?: string;
+    /** Fee paid */
+    fee?: string;
+    /** Explorer URL */
+    explorerUrl?: string;
+    /** Error message if failed */
+    error?: string;
+    /** Timestamp */
+    timestamp: number;
+}
+/**
+ * Transaction history item
+ */
+interface TransactionHistoryItem {
+    hash: string;
+    network: NetworkType;
+    type: 'send' | 'receive' | 'swap' | 'contract';
+    from: string;
+    to: string;
+    amount: string;
+    token?: string;
+    fee?: string;
+    status: 'pending' | 'confirmed' | 'failed';
+    timestamp: number;
+    blockNumber?: number;
+}
+/**
+ * Fee estimate for a transaction
+ */
+interface FeeEstimate {
+    slow: {
+        fee: string;
+        estimatedTime: string;
+    };
+    medium: {
+        fee: string;
+        estimatedTime: string;
+    };
+    fast: {
+        fee: string;
+        estimatedTime: string;
+    };
+}
+/**
+ * Transaction Service configuration
+ */
+interface TransactionServiceConfig {
+    network: 'mainnet' | 'testnet';
+    rpcUrls?: Partial<Record<NetworkType, string>>;
+}
+/**
+ * Transaction Service
+ *
+ * Provides multi-chain transaction capabilities:
+ * - Send native tokens (ETH, BTC, SOL, TON, TRX)
+ * - Send ERC-20/SPL tokens
+ * - Fee estimation
+ * - Transaction history
+ */
+declare class TransactionService {
+    private seed;
+    private config;
+    private wallets;
+    constructor(config?: Partial<TransactionServiceConfig>);
+    /**
+     * Ensure WDK modules are loaded
+     */
+    private ensureLoaded;
+    /**
+     * Get RPC URL for a chain
+     */
+    private getRpcUrl;
+    /**
+     * Get explorer URL for a transaction
+     */
+    getExplorerUrl(chain: NetworkType, txHash: string): string;
+    /**
+     * Initialize the service with a seed phrase
+     */
+    initialize(seed: string): Promise<void>;
+    /**
+     * Check if service is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get or create wallet instance for a specific chain
+     */
+    private getWallet;
+    /**
+     * Estimate transaction fee
+     */
+    estimateFee(chain: NetworkType, params: TransactionParams): Promise<FeeEstimate>;
+    /**
+     * Send a transaction
+     */
+    send(chain: NetworkType, params: TransactionParams): Promise<TransactionResult>;
+    /**
+     * Get transaction status
+     */
+    getTransactionStatus(chain: NetworkType, txHash: string): Promise<TransactionResult>;
+    /**
+     * Get transaction history for an address
+     */
+    getTransactionHistory(chain: NetworkType, limit?: number): Promise<TransactionHistoryItem[]>;
+    /**
+     * Get balance for a specific chain
+     */
+    getBalance(chain: NetworkType): Promise<{
+        balance: string;
+        balanceUsd: number;
+    }>;
+    /**
+     * Get the current network configuration
+     */
+    getNetwork(): 'mainnet' | 'testnet';
+    /**
+     * Clean up and dispose of wallet instances
+     */
+    dispose(): void;
+}
+/**
+ * Get or create the Transaction service singleton
+ */
+declare function getTransactionService(config?: Partial<TransactionServiceConfig>): TransactionService;
+/**
+ * Create a new Transaction service instance (non-singleton)
+ */
+declare function createTransactionService(config?: Partial<TransactionServiceConfig>): TransactionService;
+
+export { type FeeEstimate as F, SwapService as S, TransactionService as T, type TransactionParams as a, type TransactionResult as b, createTransactionService as c, type TransactionHistoryItem as d, type TransactionServiceConfig as e, getTransactionService as g };

package/dist/TransactionService-DdL6H6M-.d.ts

@@ -0,0 +1,205 @@
+import { k as SwapQuote, b as TxResult, N as NetworkType } from './index-DhluuR9H.js';
+
+/**
+ * SwapService - DEX integration via Velora
+ *
+ * Handles token swaps with slippage protection,
+ * quote fetching, and earnings conversion.
+ */
+declare class SwapService {
+    private readonly _chainId;
+    private readonly isTestnet;
+    constructor(chainId: number, isTestnet?: boolean);
+    /**
+     * Get a swap quote
+     */
+    getQuote(tokenIn: string, tokenOut: string, amountIn: bigint): Promise<SwapQuote>;
+    /**
+     * Execute a swap with slippage protection
+     */
+    executeSwap(quote: SwapQuote, slippageToleranceBps?: number): Promise<TxResult>;
+    /**
+     * Convert earnings to USDT, keeping some ETH for gas
+     */
+    convertEarningsToStable(ethBalance: bigint, reserveForGas?: bigint): Promise<TxResult>;
+    /**
+     * Check if a swap route exists
+     */
+    hasRoute(tokenIn: string, tokenOut: string): Promise<boolean>;
+    /**
+     * Get supported tokens for swapping
+     */
+    getSupportedTokens(): Promise<string[]>;
+}
+
+/**
+ * Transaction Service for Zubari SDK
+ *
+ * Provides multi-chain transaction capabilities using Tether WDK.
+ * Supports Ethereum, Bitcoin, Solana, TON, TRON, and Spark (Lightning).
+ *
+ * @see https://docs.wallet.tether.io/
+ */
+
+/**
+ * Transaction parameters for sending
+ */
+interface TransactionParams {
+    /** Recipient address */
+    to: string;
+    /** Amount to send (in human-readable format, e.g., "0.1") */
+    amount: string;
+    /** Token address (optional, for ERC-20/SPL tokens) */
+    token?: string;
+    /** Transaction memo/message (for chains that support it) */
+    memo?: string;
+    /** Fee priority: 'slow' | 'medium' | 'fast' */
+    feePriority?: 'slow' | 'medium' | 'fast';
+    /** Custom gas limit (EVM chains) */
+    gasLimit?: string;
+    /** Custom gas price (EVM chains) */
+    gasPrice?: string;
+}
+/**
+ * Transaction result with detailed information
+ */
+interface TransactionResult {
+    /** Transaction hash */
+    hash: string;
+    /** Network/chain */
+    network: NetworkType;
+    /** Transaction status */
+    status: 'pending' | 'confirmed' | 'failed';
+    /** Block number (when confirmed) */
+    blockNumber?: number;
+    /** Gas used (EVM chains) */
+    gasUsed?: string;
+    /** Fee paid */
+    fee?: string;
+    /** Explorer URL */
+    explorerUrl?: string;
+    /** Error message if failed */
+    error?: string;
+    /** Timestamp */
+    timestamp: number;
+}
+/**
+ * Transaction history item
+ */
+interface TransactionHistoryItem {
+    hash: string;
+    network: NetworkType;
+    type: 'send' | 'receive' | 'swap' | 'contract';
+    from: string;
+    to: string;
+    amount: string;
+    token?: string;
+    fee?: string;
+    status: 'pending' | 'confirmed' | 'failed';
+    timestamp: number;
+    blockNumber?: number;
+}
+/**
+ * Fee estimate for a transaction
+ */
+interface FeeEstimate {
+    slow: {
+        fee: string;
+        estimatedTime: string;
+    };
+    medium: {
+        fee: string;
+        estimatedTime: string;
+    };
+    fast: {
+        fee: string;
+        estimatedTime: string;
+    };
+}
+/**
+ * Transaction Service configuration
+ */
+interface TransactionServiceConfig {
+    network: 'mainnet' | 'testnet';
+    rpcUrls?: Partial<Record<NetworkType, string>>;
+}
+/**
+ * Transaction Service
+ *
+ * Provides multi-chain transaction capabilities:
+ * - Send native tokens (ETH, BTC, SOL, TON, TRX)
+ * - Send ERC-20/SPL tokens
+ * - Fee estimation
+ * - Transaction history
+ */
+declare class TransactionService {
+    private seed;
+    private config;
+    private wallets;
+    constructor(config?: Partial<TransactionServiceConfig>);
+    /**
+     * Ensure WDK modules are loaded
+     */
+    private ensureLoaded;
+    /**
+     * Get RPC URL for a chain
+     */
+    private getRpcUrl;
+    /**
+     * Get explorer URL for a transaction
+     */
+    getExplorerUrl(chain: NetworkType, txHash: string): string;
+    /**
+     * Initialize the service with a seed phrase
+     */
+    initialize(seed: string): Promise<void>;
+    /**
+     * Check if service is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get or create wallet instance for a specific chain
+     */
+    private getWallet;
+    /**
+     * Estimate transaction fee
+     */
+    estimateFee(chain: NetworkType, params: TransactionParams): Promise<FeeEstimate>;
+    /**
+     * Send a transaction
+     */
+    send(chain: NetworkType, params: TransactionParams): Promise<TransactionResult>;
+    /**
+     * Get transaction status
+     */
+    getTransactionStatus(chain: NetworkType, txHash: string): Promise<TransactionResult>;
+    /**
+     * Get transaction history for an address
+     */
+    getTransactionHistory(chain: NetworkType, limit?: number): Promise<TransactionHistoryItem[]>;
+    /**
+     * Get balance for a specific chain
+     */
+    getBalance(chain: NetworkType): Promise<{
+        balance: string;
+        balanceUsd: number;
+    }>;
+    /**
+     * Get the current network configuration
+     */
+    getNetwork(): 'mainnet' | 'testnet';
+    /**
+     * Clean up and dispose of wallet instances
+     */
+    dispose(): void;
+}
+/**
+ * Get or create the Transaction service singleton
+ */
+declare function getTransactionService(config?: Partial<TransactionServiceConfig>): TransactionService;
+/**
+ * Create a new Transaction service instance (non-singleton)
+ */
+declare function createTransactionService(config?: Partial<TransactionServiceConfig>): TransactionService;
+
+export { type FeeEstimate as F, SwapService as S, TransactionService as T, type TransactionParams as a, type TransactionResult as b, createTransactionService as c, type TransactionHistoryItem as d, type TransactionServiceConfig as e, getTransactionService as g };