@sip-protocol/sdk 0.2.7 → 0.2.9

package/dist/index.d.mts

@@ -3100,6 +3100,294 @@ declare class ZcashShieldedService {
  */
 declare function createZcashShieldedService(config: ZcashShieldedServiceConfig): ZcashShieldedService;
 
+/**
+ * Zcash Swap Service
+ *
+ * Handles cross-chain swaps from ETH/SOL/NEAR to Zcash (ZEC).
+ * Since NEAR Intents doesn't support ZEC as destination chain,
+ * this service provides an alternative path for ZEC swaps.
+ *
+ * @example
+ * ```typescript
+ * const swapService = new ZcashSwapService({
+ *   zcashService: zcashShieldedService,
+ *   mode: 'demo', // or 'production' when bridge is available
+ * })
+ *
+ * // Get quote for ETH → ZEC swap
+ * const quote = await swapService.getQuote({
+ *   sourceChain: 'ethereum',
+ *   sourceToken: 'ETH',
+ *   amount: 1000000000000000000n, // 1 ETH
+ *   recipientZAddress: 'zs1...',
+ * })
+ *
+ * // Execute the swap
+ * const result = await swapService.executeSwapToShielded({
+ *   quoteId: quote.quoteId,
+ *   sourceChain: 'ethereum',
+ *   sourceToken: 'ETH',
+ *   amount: 1000000000000000000n,
+ *   recipientZAddress: 'zs1...',
+ * })
+ * ```
+ */
+
+/**
+ * Supported source chains for ZEC swaps
+ */
+type ZcashSwapSourceChain = 'ethereum' | 'solana' | 'near' | 'polygon' | 'arbitrum' | 'base';
+/**
+ * Supported source tokens for ZEC swaps
+ */
+type ZcashSwapSourceToken = 'ETH' | 'SOL' | 'NEAR' | 'USDC' | 'USDT' | 'MATIC';
+/**
+ * Configuration for ZcashSwapService
+ */
+interface ZcashSwapServiceConfig {
+    /** Zcash shielded service for receiving ZEC */
+    zcashService?: ZcashShieldedService;
+    /** Operating mode */
+    mode: 'demo' | 'production';
+    /** Bridge provider (for production) */
+    bridgeProvider?: BridgeProvider;
+    /** Price feed for quotes */
+    priceFeed?: PriceFeed;
+    /** Default slippage tolerance (basis points, default: 100 = 1%) */
+    defaultSlippage?: number;
+    /** Quote validity duration in seconds (default: 60) */
+    quoteValiditySeconds?: number;
+}
+/**
+ * Bridge provider interface (for production mode)
+ */
+interface BridgeProvider {
+    /** Provider name */
+    name: string;
+    /** Get quote from bridge */
+    getQuote(params: BridgeQuoteParams): Promise<BridgeQuote>;
+    /** Execute swap through bridge */
+    executeSwap(params: BridgeSwapParams): Promise<BridgeSwapResult>;
+    /** Get supported chains */
+    getSupportedChains(): Promise<ZcashSwapSourceChain[]>;
+}
+/**
+ * Price feed interface for quote calculations
+ */
+interface PriceFeed {
+    /** Get current price in USD */
+    getPrice(token: string): Promise<number>;
+    /** Get ZEC price in USD */
+    getZecPrice(): Promise<number>;
+}
+/**
+ * Bridge quote parameters
+ */
+interface BridgeQuoteParams {
+    sourceChain: ZcashSwapSourceChain;
+    sourceToken: ZcashSwapSourceToken;
+    amount: bigint;
+    recipientAddress: string;
+}
+/**
+ * Bridge quote result
+ */
+interface BridgeQuote {
+    quoteId: string;
+    amountIn: bigint;
+    amountOut: bigint;
+    fee: bigint;
+    exchangeRate: number;
+    validUntil: number;
+}
+/**
+ * Bridge swap parameters
+ */
+interface BridgeSwapParams extends BridgeQuoteParams {
+    quoteId: string;
+    depositAddress: string;
+}
+/**
+ * Bridge swap result
+ */
+interface BridgeSwapResult {
+    txHash: string;
+    status: 'pending' | 'completed' | 'failed';
+    amountReceived?: bigint;
+}
+/**
+ * Quote request parameters
+ */
+interface ZcashQuoteParams {
+    /** Source blockchain */
+    sourceChain: ZcashSwapSourceChain;
+    /** Source token symbol */
+    sourceToken: ZcashSwapSourceToken;
+    /** Amount in smallest unit (wei, lamports, etc.) */
+    amount: bigint;
+    /** Recipient z-address */
+    recipientZAddress: string;
+    /** Custom slippage (basis points) */
+    slippage?: number;
+}
+/**
+ * Quote response
+ */
+interface ZcashQuote {
+    /** Unique quote identifier */
+    quoteId: string;
+    /** Source chain */
+    sourceChain: ZcashSwapSourceChain;
+    /** Source token */
+    sourceToken: ZcashSwapSourceToken;
+    /** Input amount (in source token's smallest unit) */
+    amountIn: bigint;
+    /** Input amount formatted */
+    amountInFormatted: string;
+    /** Output amount in zatoshis (1 ZEC = 100,000,000 zatoshis) */
+    amountOut: bigint;
+    /** Output amount in ZEC */
+    amountOutFormatted: string;
+    /** Exchange rate (ZEC per source token) */
+    exchangeRate: number;
+    /** Network fee in source token */
+    networkFee: bigint;
+    /** Bridge/swap fee in source token */
+    swapFee: bigint;
+    /** Total fee in source token */
+    totalFee: bigint;
+    /** Slippage tolerance (basis points) */
+    slippage: number;
+    /** Minimum output amount after slippage */
+    minimumOutput: bigint;
+    /** Quote expiration timestamp */
+    validUntil: number;
+    /** Deposit address (where to send source tokens) */
+    depositAddress: string;
+    /** Estimated time to completion (seconds) */
+    estimatedTime: number;
+    /** Privacy level for the swap */
+    privacyLevel: PrivacyLevel;
+}
+/**
+ * Swap execution parameters
+ */
+interface ZcashSwapParams {
+    /** Quote ID to execute */
+    quoteId?: string;
+    /** Source blockchain */
+    sourceChain: ZcashSwapSourceChain;
+    /** Source token symbol */
+    sourceToken: ZcashSwapSourceToken;
+    /** Amount in smallest unit */
+    amount: bigint;
+    /** Recipient z-address (shielded) */
+    recipientZAddress: string;
+    /** Optional memo for the transaction */
+    memo?: string;
+    /** Custom slippage (basis points) */
+    slippage?: number;
+}
+/**
+ * Swap execution result
+ */
+interface ZcashSwapResult {
+    /** Swap request ID */
+    requestId: string;
+    /** Quote used */
+    quoteId: string;
+    /** Current status */
+    status: ZcashSwapStatus;
+    /** Source chain transaction hash (deposit tx) */
+    sourceTxHash?: string;
+    /** Zcash transaction ID (if completed) */
+    zcashTxId?: string;
+    /** Amount deposited */
+    amountIn: bigint;
+    /** Amount received in ZEC (zatoshis) */
+    amountOut?: bigint;
+    /** Recipient z-address */
+    recipientZAddress: string;
+    /** Timestamp */
+    timestamp: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Swap status
+ */
+type ZcashSwapStatus = 'pending_deposit' | 'deposit_confirmed' | 'swapping' | 'sending_zec' | 'completed' | 'failed' | 'expired';
+/**
+ * Zcash Swap Service
+ *
+ * Enables cross-chain swaps from ETH/SOL/NEAR to Zcash's shielded pool.
+ */
+declare class ZcashSwapService {
+    private readonly config;
+    private readonly zcashService?;
+    private readonly bridgeProvider?;
+    private readonly priceFeed?;
+    private readonly quotes;
+    private readonly swaps;
+    constructor(config: ZcashSwapServiceConfig);
+    /**
+     * Get a quote for swapping to ZEC
+     */
+    getQuote(params: ZcashQuoteParams): Promise<ZcashQuote>;
+    /**
+     * Get quote in demo mode (uses mock prices)
+     */
+    private getDemoQuote;
+    /**
+     * Get quote in production mode (uses bridge provider)
+     */
+    private getProductionQuote;
+    /**
+     * Execute a swap to Zcash shielded pool
+     */
+    executeSwapToShielded(params: ZcashSwapParams): Promise<ZcashSwapResult>;
+    /**
+     * Execute swap in demo mode
+     */
+    private executeDemoSwap;
+    /**
+     * Execute swap in production mode
+     */
+    private executeProductionSwap;
+    /**
+     * Get swap status
+     */
+    getSwapStatus(requestId: string): Promise<ZcashSwapResult | null>;
+    /**
+     * Wait for swap completion
+     */
+    waitForCompletion(requestId: string, timeout?: number, pollInterval?: number): Promise<ZcashSwapResult>;
+    /**
+     * Get supported source chains
+     */
+    getSupportedChains(): Promise<ZcashSwapSourceChain[]>;
+    /**
+     * Get supported source tokens for a chain
+     */
+    getSupportedTokens(chain: ZcashSwapSourceChain): ZcashSwapSourceToken[];
+    /**
+     * Check if a swap route is supported
+     */
+    isRouteSupported(chain: ZcashSwapSourceChain, token: ZcashSwapSourceToken): boolean;
+    private validateQuoteParams;
+    private isValidZAddressFormat;
+    private generateMockDepositAddress;
+    private getEstimatedTime;
+    private formatAmount;
+    private randomHex;
+    private randomBase58;
+    private delay;
+}
+/**
+ * Create a Zcash swap service instance
+ */
+declare function createZcashSwapService(config: ZcashSwapServiceConfig): ZcashSwapService;
+
 /**
  * Shielded Payments for SIP Protocol
  *
@@ -5607,4 +5895,4 @@ declare function createMockLedgerAdapter(config: Omit<MockHardwareConfig, 'devic
  */
 declare function createMockTrezorAdapter(config: Omit<MockHardwareConfig, 'deviceType'>): MockTrezorAdapter;
 
-export { ATTESTATION_VERSION, type AttestationRequest, type AttestationResult, BrowserNoirProvider as B, BaseWalletAdapter, type BrowserNoirProviderConfig, CHAIN_NUMERIC_IDS, type CommitmentPoint, ComplianceManager, type CreateIntentOptions, type CreatePaymentOptions, CryptoError, DEFAULT_THRESHOLD, DEFAULT_TOTAL_ORACLES, DerivationPath, type EIP1193ConnectInfo, type EIP1193Event, type EIP1193Provider, type EIP1193ProviderRpcError, type EIP1193RequestArguments, type EIP712Domain, type EIP712TypeDefinition, type EIP712TypedData, type EIP712Types, EncryptionNotImplementedError, ErrorCode, type EthereumAdapterConfig, EthereumChainId, type EthereumChainIdType, type EthereumChainMetadata, type EthereumTokenMetadata, type EthereumTransactionReceipt, type EthereumTransactionRequest, EthereumWalletAdapter, type EthereumWalletName, type ExportedViewingKey, FulfillmentProofParams, FundingProofParams, type HardwareAccount, type HardwareConnectionStatus, type HardwareDeviceInfo, HardwareErrorCode, type HardwareErrorCodeType, type HardwareEthereumTx, type HardwareSignRequest, type HardwareSignature, type HardwareTransport, type HardwareWalletConfig, HardwareWalletError, type HardwareWalletType, IntentBuilder, IntentError, type LedgerConfig, type LedgerModel, LedgerWalletAdapter, MockEthereumAdapter, type MockEthereumAdapterConfig, type MockHardwareConfig, MockLedgerAdapter, MockProofProvider, MockSolanaAdapter, type MockSolanaAdapterConfig, MockSolver, type MockSolverConfig, MockTrezorAdapter, MockWalletAdapter, NEARIntentsAdapter, type NEARIntentsAdapterConfig, NetworkError, ORACLE_DOMAIN, OneClickClient, type OracleAttestationMessage, type OracleId, type OracleInfo, type OracleRegistry, type OracleRegistryConfig, type OracleSignature, type OracleStatus, PaymentBuilder, type PedersenCommitment, type PreparedSwap, type PrivacyConfig, type ProductionQuote, ProofError, ProofFramework, ProofNotImplementedError, type ProofProgressCallback, ProofProvider, ProofResult, type ReceivedNote, SIP, type SIPConfig, SIPError, STABLECOIN_ADDRESSES, STABLECOIN_DECIMALS, STABLECOIN_INFO, type SerializedError, type ShieldedBalance, type ShieldedSendParams, type ShieldedSendResult, type SignedOracleAttestation, type SolanaAdapterConfig, type SolanaCluster, type SolanaConnection, type SolanaPublicKey, type SolanaSendOptions, type SolanaSignature, type SolanaTransaction, type SolanaUnsignedTransaction, type SolanaVersionedTransaction, SolanaWalletAdapter, type SolanaWalletName, type SolanaWalletProvider, type StablecoinInfo, type StealthCurve, type SwapRequest, type SwapResult, type TransactionData, type TransportType, Treasury, type TrezorConfig, type TrezorModel, TrezorWalletAdapter, ValidationError, ValidityProofParams, type VerificationResult, type WalletAdapter, WalletError, ZcashRPCClient, ZcashRPCError, ZcashShieldedService, type ZcashShieldedServiceConfig, addBlindings, addCommitments, addOracle, attachProofs, base58ToHex, bytesToHex as browserBytesToHex, hexToBytes as browserHexToBytes, checkEd25519StealthAddress, checkStealthAddress, commit, commitZero, computeAttestationHash, createCommitment, createEthereumAdapter, createLedgerAdapter, createMockEthereumAdapter, createMockEthereumProvider, createMockLedgerAdapter, createMockSolanaAdapter, createMockSolanaConnection, createMockSolanaProvider, createMockSolver, createMockTrezorAdapter, createNEARIntentsAdapter, createOracleRegistry, createProductionSIP, createSIP, createShieldedIntent, createShieldedPayment, createSolanaAdapter, createTrezorAdapter, createWalletFactory, createZcashClient, createZcashShieldedService, decodeStealthMetaAddress, decryptMemo, decryptWithViewing, deriveEd25519StealthPrivateKey, deriveOracleId, deriveStealthPrivateKey, deriveViewingKey, deserializeAttestationMessage, deserializeIntent, deserializePayment, detectEthereumWallets, detectSolanaWallets, ed25519PublicKeyToNearAddress, ed25519PublicKeyToSolanaAddress, encodeStealthMetaAddress, encryptForViewing, featureNotSupportedError, formatStablecoinAmount, fromHex, fromStablecoinUnits, generateBlinding, generateEd25519StealthAddress, generateEd25519StealthMetaAddress, generateIntentId, generateRandomBytes, generateStealthAddress, generateStealthMetaAddress, generateViewingKey, getActiveOracles, getAvailableTransports, getBrowserInfo, getChainNumericId, getChainsForStablecoin, getCurveForChain, getDefaultRpcEndpoint, getDerivationPath, getErrorMessage, getEthereumProvider, getGenerators, getIntentSummary, getPaymentSummary, getPaymentTimeRemaining, getPrivacyConfig, getPrivacyDescription, getSolanaProvider, getStablecoin, getStablecoinInfo, getStablecoinsForChain, getSupportedStablecoins, getTimeRemaining, hasEnoughOracles, hasErrorCode, hasRequiredProofs, hash, hexToNumber, isBrowser, isEd25519Chain, isExpired, isNonNegativeAmount, isPaymentExpired, isPrivateWalletAdapter, isSIPError, isStablecoin, isStablecoinOnChain, isValidAmount, isValidChainId, isValidCompressedPublicKey, isValidEd25519PublicKey, isValidHex, isValidHexLength, isValidNearAccountId, isValidNearImplicitAddress, isValidPrivacyLevel, isValidPrivateKey, isValidScalar, isValidSlippage, isValidSolanaAddress, isValidStealthMetaAddress, nearAddressToEd25519PublicKey, normalizeAddress, notConnectedError, publicKeyToEthAddress, registerWallet, removeOracle, secureWipe, secureWipeAll, serializeAttestationMessage, serializeIntent, serializePayment, signAttestationMessage, solanaAddressToEd25519PublicKey, solanaPublicKeyToHex, subtractBlindings, subtractCommitments, supportsSharedArrayBuffer, supportsWebBluetooth, supportsWebHID, supportsWebUSB, supportsWebWorkers, toHex, toStablecoinUnits, trackIntent, trackPayment, updateOracleStatus, validateAsset, validateCreateIntentParams, validateIntentInput, validateIntentOutput, validateScalar, validateViewingKey, verifyAttestation, verifyCommitment, verifyOpening, verifyOracleSignature, walletRegistry, withSecureBuffer, withSecureBufferSync, wrapError };
+export { ATTESTATION_VERSION, type AttestationRequest, type AttestationResult, BrowserNoirProvider as B, BaseWalletAdapter, type BridgeProvider, type BrowserNoirProviderConfig, CHAIN_NUMERIC_IDS, type CommitmentPoint, ComplianceManager, type CreateIntentOptions, type CreatePaymentOptions, CryptoError, DEFAULT_THRESHOLD, DEFAULT_TOTAL_ORACLES, DerivationPath, type EIP1193ConnectInfo, type EIP1193Event, type EIP1193Provider, type EIP1193ProviderRpcError, type EIP1193RequestArguments, type EIP712Domain, type EIP712TypeDefinition, type EIP712TypedData, type EIP712Types, EncryptionNotImplementedError, ErrorCode, type EthereumAdapterConfig, EthereumChainId, type EthereumChainIdType, type EthereumChainMetadata, type EthereumTokenMetadata, type EthereumTransactionReceipt, type EthereumTransactionRequest, EthereumWalletAdapter, type EthereumWalletName, type ExportedViewingKey, FulfillmentProofParams, FundingProofParams, type HardwareAccount, type HardwareConnectionStatus, type HardwareDeviceInfo, HardwareErrorCode, type HardwareErrorCodeType, type HardwareEthereumTx, type HardwareSignRequest, type HardwareSignature, type HardwareTransport, type HardwareWalletConfig, HardwareWalletError, type HardwareWalletType, IntentBuilder, IntentError, type LedgerConfig, type LedgerModel, LedgerWalletAdapter, MockEthereumAdapter, type MockEthereumAdapterConfig, type MockHardwareConfig, MockLedgerAdapter, MockProofProvider, MockSolanaAdapter, type MockSolanaAdapterConfig, MockSolver, type MockSolverConfig, MockTrezorAdapter, MockWalletAdapter, NEARIntentsAdapter, type NEARIntentsAdapterConfig, NetworkError, ORACLE_DOMAIN, OneClickClient, type OracleAttestationMessage, type OracleId, type OracleInfo, type OracleRegistry, type OracleRegistryConfig, type OracleSignature, type OracleStatus, PaymentBuilder, type PedersenCommitment, type PreparedSwap, type PriceFeed, type PrivacyConfig, type ProductionQuote, ProofError, ProofFramework, ProofNotImplementedError, type ProofProgressCallback, ProofProvider, ProofResult, type ReceivedNote, SIP, type SIPConfig, SIPError, STABLECOIN_ADDRESSES, STABLECOIN_DECIMALS, STABLECOIN_INFO, type SerializedError, type ShieldedBalance, type ShieldedSendParams, type ShieldedSendResult, type SignedOracleAttestation, type SolanaAdapterConfig, type SolanaCluster, type SolanaConnection, type SolanaPublicKey, type SolanaSendOptions, type SolanaSignature, type SolanaTransaction, type SolanaUnsignedTransaction, type SolanaVersionedTransaction, SolanaWalletAdapter, type SolanaWalletName, type SolanaWalletProvider, type StablecoinInfo, type StealthCurve, type SwapRequest, type SwapResult, type TransactionData, type TransportType, Treasury, type TrezorConfig, type TrezorModel, TrezorWalletAdapter, ValidationError, ValidityProofParams, type VerificationResult, type WalletAdapter, WalletError, type ZcashQuote, type ZcashQuoteParams, ZcashRPCClient, ZcashRPCError, ZcashShieldedService, type ZcashShieldedServiceConfig, type ZcashSwapParams, type ZcashSwapResult, ZcashSwapService, type ZcashSwapServiceConfig, type ZcashSwapSourceChain, type ZcashSwapSourceToken, type ZcashSwapStatus, addBlindings, addCommitments, addOracle, attachProofs, base58ToHex, bytesToHex as browserBytesToHex, hexToBytes as browserHexToBytes, checkEd25519StealthAddress, checkStealthAddress, commit, commitZero, computeAttestationHash, createCommitment, createEthereumAdapter, createLedgerAdapter, createMockEthereumAdapter, createMockEthereumProvider, createMockLedgerAdapter, createMockSolanaAdapter, createMockSolanaConnection, createMockSolanaProvider, createMockSolver, createMockTrezorAdapter, createNEARIntentsAdapter, createOracleRegistry, createProductionSIP, createSIP, createShieldedIntent, createShieldedPayment, createSolanaAdapter, createTrezorAdapter, createWalletFactory, createZcashClient, createZcashShieldedService, createZcashSwapService, decodeStealthMetaAddress, decryptMemo, decryptWithViewing, deriveEd25519StealthPrivateKey, deriveOracleId, deriveStealthPrivateKey, deriveViewingKey, deserializeAttestationMessage, deserializeIntent, deserializePayment, detectEthereumWallets, detectSolanaWallets, ed25519PublicKeyToNearAddress, ed25519PublicKeyToSolanaAddress, encodeStealthMetaAddress, encryptForViewing, featureNotSupportedError, formatStablecoinAmount, fromHex, fromStablecoinUnits, generateBlinding, generateEd25519StealthAddress, generateEd25519StealthMetaAddress, generateIntentId, generateRandomBytes, generateStealthAddress, generateStealthMetaAddress, generateViewingKey, getActiveOracles, getAvailableTransports, getBrowserInfo, getChainNumericId, getChainsForStablecoin, getCurveForChain, getDefaultRpcEndpoint, getDerivationPath, getErrorMessage, getEthereumProvider, getGenerators, getIntentSummary, getPaymentSummary, getPaymentTimeRemaining, getPrivacyConfig, getPrivacyDescription, getSolanaProvider, getStablecoin, getStablecoinInfo, getStablecoinsForChain, getSupportedStablecoins, getTimeRemaining, hasEnoughOracles, hasErrorCode, hasRequiredProofs, hash, hexToNumber, isBrowser, isEd25519Chain, isExpired, isNonNegativeAmount, isPaymentExpired, isPrivateWalletAdapter, isSIPError, isStablecoin, isStablecoinOnChain, isValidAmount, isValidChainId, isValidCompressedPublicKey, isValidEd25519PublicKey, isValidHex, isValidHexLength, isValidNearAccountId, isValidNearImplicitAddress, isValidPrivacyLevel, isValidPrivateKey, isValidScalar, isValidSlippage, isValidSolanaAddress, isValidStealthMetaAddress, nearAddressToEd25519PublicKey, normalizeAddress, notConnectedError, publicKeyToEthAddress, registerWallet, removeOracle, secureWipe, secureWipeAll, serializeAttestationMessage, serializeIntent, serializePayment, signAttestationMessage, solanaAddressToEd25519PublicKey, solanaPublicKeyToHex, subtractBlindings, subtractCommitments, supportsSharedArrayBuffer, supportsWebBluetooth, supportsWebHID, supportsWebUSB, supportsWebWorkers, toHex, toStablecoinUnits, trackIntent, trackPayment, updateOracleStatus, validateAsset, validateCreateIntentParams, validateIntentInput, validateIntentOutput, validateScalar, validateViewingKey, verifyAttestation, verifyCommitment, verifyOpening, verifyOracleSignature, walletRegistry, withSecureBuffer, withSecureBufferSync, wrapError };

package/dist/index.d.ts

@@ -3100,6 +3100,294 @@ declare class ZcashShieldedService {
  */
 declare function createZcashShieldedService(config: ZcashShieldedServiceConfig): ZcashShieldedService;
 
+/**
+ * Zcash Swap Service
+ *
+ * Handles cross-chain swaps from ETH/SOL/NEAR to Zcash (ZEC).
+ * Since NEAR Intents doesn't support ZEC as destination chain,
+ * this service provides an alternative path for ZEC swaps.
+ *
+ * @example
+ * ```typescript
+ * const swapService = new ZcashSwapService({
+ *   zcashService: zcashShieldedService,
+ *   mode: 'demo', // or 'production' when bridge is available
+ * })
+ *
+ * // Get quote for ETH → ZEC swap
+ * const quote = await swapService.getQuote({
+ *   sourceChain: 'ethereum',
+ *   sourceToken: 'ETH',
+ *   amount: 1000000000000000000n, // 1 ETH
+ *   recipientZAddress: 'zs1...',
+ * })
+ *
+ * // Execute the swap
+ * const result = await swapService.executeSwapToShielded({
+ *   quoteId: quote.quoteId,
+ *   sourceChain: 'ethereum',
+ *   sourceToken: 'ETH',
+ *   amount: 1000000000000000000n,
+ *   recipientZAddress: 'zs1...',
+ * })
+ * ```
+ */
+
+/**
+ * Supported source chains for ZEC swaps
+ */
+type ZcashSwapSourceChain = 'ethereum' | 'solana' | 'near' | 'polygon' | 'arbitrum' | 'base';
+/**
+ * Supported source tokens for ZEC swaps
+ */
+type ZcashSwapSourceToken = 'ETH' | 'SOL' | 'NEAR' | 'USDC' | 'USDT' | 'MATIC';
+/**
+ * Configuration for ZcashSwapService
+ */
+interface ZcashSwapServiceConfig {
+    /** Zcash shielded service for receiving ZEC */
+    zcashService?: ZcashShieldedService;
+    /** Operating mode */
+    mode: 'demo' | 'production';
+    /** Bridge provider (for production) */
+    bridgeProvider?: BridgeProvider;
+    /** Price feed for quotes */
+    priceFeed?: PriceFeed;
+    /** Default slippage tolerance (basis points, default: 100 = 1%) */
+    defaultSlippage?: number;
+    /** Quote validity duration in seconds (default: 60) */
+    quoteValiditySeconds?: number;
+}
+/**
+ * Bridge provider interface (for production mode)
+ */
+interface BridgeProvider {
+    /** Provider name */
+    name: string;
+    /** Get quote from bridge */
+    getQuote(params: BridgeQuoteParams): Promise<BridgeQuote>;
+    /** Execute swap through bridge */
+    executeSwap(params: BridgeSwapParams): Promise<BridgeSwapResult>;
+    /** Get supported chains */
+    getSupportedChains(): Promise<ZcashSwapSourceChain[]>;
+}
+/**
+ * Price feed interface for quote calculations
+ */
+interface PriceFeed {
+    /** Get current price in USD */
+    getPrice(token: string): Promise<number>;
+    /** Get ZEC price in USD */
+    getZecPrice(): Promise<number>;
+}
+/**
+ * Bridge quote parameters
+ */
+interface BridgeQuoteParams {
+    sourceChain: ZcashSwapSourceChain;
+    sourceToken: ZcashSwapSourceToken;
+    amount: bigint;
+    recipientAddress: string;
+}
+/**
+ * Bridge quote result
+ */
+interface BridgeQuote {
+    quoteId: string;
+    amountIn: bigint;
+    amountOut: bigint;
+    fee: bigint;
+    exchangeRate: number;
+    validUntil: number;
+}
+/**
+ * Bridge swap parameters
+ */
+interface BridgeSwapParams extends BridgeQuoteParams {
+    quoteId: string;
+    depositAddress: string;
+}
+/**
+ * Bridge swap result
+ */
+interface BridgeSwapResult {
+    txHash: string;
+    status: 'pending' | 'completed' | 'failed';
+    amountReceived?: bigint;
+}
+/**
+ * Quote request parameters
+ */
+interface ZcashQuoteParams {
+    /** Source blockchain */
+    sourceChain: ZcashSwapSourceChain;
+    /** Source token symbol */
+    sourceToken: ZcashSwapSourceToken;
+    /** Amount in smallest unit (wei, lamports, etc.) */
+    amount: bigint;
+    /** Recipient z-address */
+    recipientZAddress: string;
+    /** Custom slippage (basis points) */
+    slippage?: number;
+}
+/**
+ * Quote response
+ */
+interface ZcashQuote {
+    /** Unique quote identifier */
+    quoteId: string;
+    /** Source chain */
+    sourceChain: ZcashSwapSourceChain;
+    /** Source token */
+    sourceToken: ZcashSwapSourceToken;
+    /** Input amount (in source token's smallest unit) */
+    amountIn: bigint;
+    /** Input amount formatted */
+    amountInFormatted: string;
+    /** Output amount in zatoshis (1 ZEC = 100,000,000 zatoshis) */
+    amountOut: bigint;
+    /** Output amount in ZEC */
+    amountOutFormatted: string;
+    /** Exchange rate (ZEC per source token) */
+    exchangeRate: number;
+    /** Network fee in source token */
+    networkFee: bigint;
+    /** Bridge/swap fee in source token */
+    swapFee: bigint;
+    /** Total fee in source token */
+    totalFee: bigint;
+    /** Slippage tolerance (basis points) */
+    slippage: number;
+    /** Minimum output amount after slippage */
+    minimumOutput: bigint;
+    /** Quote expiration timestamp */
+    validUntil: number;
+    /** Deposit address (where to send source tokens) */
+    depositAddress: string;
+    /** Estimated time to completion (seconds) */
+    estimatedTime: number;
+    /** Privacy level for the swap */
+    privacyLevel: PrivacyLevel;
+}
+/**
+ * Swap execution parameters
+ */
+interface ZcashSwapParams {
+    /** Quote ID to execute */
+    quoteId?: string;
+    /** Source blockchain */
+    sourceChain: ZcashSwapSourceChain;
+    /** Source token symbol */
+    sourceToken: ZcashSwapSourceToken;
+    /** Amount in smallest unit */
+    amount: bigint;
+    /** Recipient z-address (shielded) */
+    recipientZAddress: string;
+    /** Optional memo for the transaction */
+    memo?: string;
+    /** Custom slippage (basis points) */
+    slippage?: number;
+}
+/**
+ * Swap execution result
+ */
+interface ZcashSwapResult {
+    /** Swap request ID */
+    requestId: string;
+    /** Quote used */
+    quoteId: string;
+    /** Current status */
+    status: ZcashSwapStatus;
+    /** Source chain transaction hash (deposit tx) */
+    sourceTxHash?: string;
+    /** Zcash transaction ID (if completed) */
+    zcashTxId?: string;
+    /** Amount deposited */
+    amountIn: bigint;
+    /** Amount received in ZEC (zatoshis) */
+    amountOut?: bigint;
+    /** Recipient z-address */
+    recipientZAddress: string;
+    /** Timestamp */
+    timestamp: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Swap status
+ */
+type ZcashSwapStatus = 'pending_deposit' | 'deposit_confirmed' | 'swapping' | 'sending_zec' | 'completed' | 'failed' | 'expired';
+/**
+ * Zcash Swap Service
+ *
+ * Enables cross-chain swaps from ETH/SOL/NEAR to Zcash's shielded pool.
+ */
+declare class ZcashSwapService {
+    private readonly config;
+    private readonly zcashService?;
+    private readonly bridgeProvider?;
+    private readonly priceFeed?;
+    private readonly quotes;
+    private readonly swaps;
+    constructor(config: ZcashSwapServiceConfig);
+    /**
+     * Get a quote for swapping to ZEC
+     */
+    getQuote(params: ZcashQuoteParams): Promise<ZcashQuote>;
+    /**
+     * Get quote in demo mode (uses mock prices)
+     */
+    private getDemoQuote;
+    /**
+     * Get quote in production mode (uses bridge provider)
+     */
+    private getProductionQuote;
+    /**
+     * Execute a swap to Zcash shielded pool
+     */
+    executeSwapToShielded(params: ZcashSwapParams): Promise<ZcashSwapResult>;
+    /**
+     * Execute swap in demo mode
+     */
+    private executeDemoSwap;
+    /**
+     * Execute swap in production mode
+     */
+    private executeProductionSwap;
+    /**
+     * Get swap status
+     */
+    getSwapStatus(requestId: string): Promise<ZcashSwapResult | null>;
+    /**
+     * Wait for swap completion
+     */
+    waitForCompletion(requestId: string, timeout?: number, pollInterval?: number): Promise<ZcashSwapResult>;
+    /**
+     * Get supported source chains
+     */
+    getSupportedChains(): Promise<ZcashSwapSourceChain[]>;
+    /**
+     * Get supported source tokens for a chain
+     */
+    getSupportedTokens(chain: ZcashSwapSourceChain): ZcashSwapSourceToken[];
+    /**
+     * Check if a swap route is supported
+     */
+    isRouteSupported(chain: ZcashSwapSourceChain, token: ZcashSwapSourceToken): boolean;
+    private validateQuoteParams;
+    private isValidZAddressFormat;
+    private generateMockDepositAddress;
+    private getEstimatedTime;
+    private formatAmount;
+    private randomHex;
+    private randomBase58;
+    private delay;
+}
+/**
+ * Create a Zcash swap service instance
+ */
+declare function createZcashSwapService(config: ZcashSwapServiceConfig): ZcashSwapService;
+
 /**
  * Shielded Payments for SIP Protocol
  *
@@ -5607,4 +5895,4 @@ declare function createMockLedgerAdapter(config: Omit<MockHardwareConfig, 'devic
  */
 declare function createMockTrezorAdapter(config: Omit<MockHardwareConfig, 'deviceType'>): MockTrezorAdapter;
 
-export { ATTESTATION_VERSION, type AttestationRequest, type AttestationResult, BrowserNoirProvider as B, BaseWalletAdapter, type BrowserNoirProviderConfig, CHAIN_NUMERIC_IDS, type CommitmentPoint, ComplianceManager, type CreateIntentOptions, type CreatePaymentOptions, CryptoError, DEFAULT_THRESHOLD, DEFAULT_TOTAL_ORACLES, DerivationPath, type EIP1193ConnectInfo, type EIP1193Event, type EIP1193Provider, type EIP1193ProviderRpcError, type EIP1193RequestArguments, type EIP712Domain, type EIP712TypeDefinition, type EIP712TypedData, type EIP712Types, EncryptionNotImplementedError, ErrorCode, type EthereumAdapterConfig, EthereumChainId, type EthereumChainIdType, type EthereumChainMetadata, type EthereumTokenMetadata, type EthereumTransactionReceipt, type EthereumTransactionRequest, EthereumWalletAdapter, type EthereumWalletName, type ExportedViewingKey, FulfillmentProofParams, FundingProofParams, type HardwareAccount, type HardwareConnectionStatus, type HardwareDeviceInfo, HardwareErrorCode, type HardwareErrorCodeType, type HardwareEthereumTx, type HardwareSignRequest, type HardwareSignature, type HardwareTransport, type HardwareWalletConfig, HardwareWalletError, type HardwareWalletType, IntentBuilder, IntentError, type LedgerConfig, type LedgerModel, LedgerWalletAdapter, MockEthereumAdapter, type MockEthereumAdapterConfig, type MockHardwareConfig, MockLedgerAdapter, MockProofProvider, MockSolanaAdapter, type MockSolanaAdapterConfig, MockSolver, type MockSolverConfig, MockTrezorAdapter, MockWalletAdapter, NEARIntentsAdapter, type NEARIntentsAdapterConfig, NetworkError, ORACLE_DOMAIN, OneClickClient, type OracleAttestationMessage, type OracleId, type OracleInfo, type OracleRegistry, type OracleRegistryConfig, type OracleSignature, type OracleStatus, PaymentBuilder, type PedersenCommitment, type PreparedSwap, type PrivacyConfig, type ProductionQuote, ProofError, ProofFramework, ProofNotImplementedError, type ProofProgressCallback, ProofProvider, ProofResult, type ReceivedNote, SIP, type SIPConfig, SIPError, STABLECOIN_ADDRESSES, STABLECOIN_DECIMALS, STABLECOIN_INFO, type SerializedError, type ShieldedBalance, type ShieldedSendParams, type ShieldedSendResult, type SignedOracleAttestation, type SolanaAdapterConfig, type SolanaCluster, type SolanaConnection, type SolanaPublicKey, type SolanaSendOptions, type SolanaSignature, type SolanaTransaction, type SolanaUnsignedTransaction, type SolanaVersionedTransaction, SolanaWalletAdapter, type SolanaWalletName, type SolanaWalletProvider, type StablecoinInfo, type StealthCurve, type SwapRequest, type SwapResult, type TransactionData, type TransportType, Treasury, type TrezorConfig, type TrezorModel, TrezorWalletAdapter, ValidationError, ValidityProofParams, type VerificationResult, type WalletAdapter, WalletError, ZcashRPCClient, ZcashRPCError, ZcashShieldedService, type ZcashShieldedServiceConfig, addBlindings, addCommitments, addOracle, attachProofs, base58ToHex, bytesToHex as browserBytesToHex, hexToBytes as browserHexToBytes, checkEd25519StealthAddress, checkStealthAddress, commit, commitZero, computeAttestationHash, createCommitment, createEthereumAdapter, createLedgerAdapter, createMockEthereumAdapter, createMockEthereumProvider, createMockLedgerAdapter, createMockSolanaAdapter, createMockSolanaConnection, createMockSolanaProvider, createMockSolver, createMockTrezorAdapter, createNEARIntentsAdapter, createOracleRegistry, createProductionSIP, createSIP, createShieldedIntent, createShieldedPayment, createSolanaAdapter, createTrezorAdapter, createWalletFactory, createZcashClient, createZcashShieldedService, decodeStealthMetaAddress, decryptMemo, decryptWithViewing, deriveEd25519StealthPrivateKey, deriveOracleId, deriveStealthPrivateKey, deriveViewingKey, deserializeAttestationMessage, deserializeIntent, deserializePayment, detectEthereumWallets, detectSolanaWallets, ed25519PublicKeyToNearAddress, ed25519PublicKeyToSolanaAddress, encodeStealthMetaAddress, encryptForViewing, featureNotSupportedError, formatStablecoinAmount, fromHex, fromStablecoinUnits, generateBlinding, generateEd25519StealthAddress, generateEd25519StealthMetaAddress, generateIntentId, generateRandomBytes, generateStealthAddress, generateStealthMetaAddress, generateViewingKey, getActiveOracles, getAvailableTransports, getBrowserInfo, getChainNumericId, getChainsForStablecoin, getCurveForChain, getDefaultRpcEndpoint, getDerivationPath, getErrorMessage, getEthereumProvider, getGenerators, getIntentSummary, getPaymentSummary, getPaymentTimeRemaining, getPrivacyConfig, getPrivacyDescription, getSolanaProvider, getStablecoin, getStablecoinInfo, getStablecoinsForChain, getSupportedStablecoins, getTimeRemaining, hasEnoughOracles, hasErrorCode, hasRequiredProofs, hash, hexToNumber, isBrowser, isEd25519Chain, isExpired, isNonNegativeAmount, isPaymentExpired, isPrivateWalletAdapter, isSIPError, isStablecoin, isStablecoinOnChain, isValidAmount, isValidChainId, isValidCompressedPublicKey, isValidEd25519PublicKey, isValidHex, isValidHexLength, isValidNearAccountId, isValidNearImplicitAddress, isValidPrivacyLevel, isValidPrivateKey, isValidScalar, isValidSlippage, isValidSolanaAddress, isValidStealthMetaAddress, nearAddressToEd25519PublicKey, normalizeAddress, notConnectedError, publicKeyToEthAddress, registerWallet, removeOracle, secureWipe, secureWipeAll, serializeAttestationMessage, serializeIntent, serializePayment, signAttestationMessage, solanaAddressToEd25519PublicKey, solanaPublicKeyToHex, subtractBlindings, subtractCommitments, supportsSharedArrayBuffer, supportsWebBluetooth, supportsWebHID, supportsWebUSB, supportsWebWorkers, toHex, toStablecoinUnits, trackIntent, trackPayment, updateOracleStatus, validateAsset, validateCreateIntentParams, validateIntentInput, validateIntentOutput, validateScalar, validateViewingKey, verifyAttestation, verifyCommitment, verifyOpening, verifyOracleSignature, walletRegistry, withSecureBuffer, withSecureBufferSync, wrapError };
+export { ATTESTATION_VERSION, type AttestationRequest, type AttestationResult, BrowserNoirProvider as B, BaseWalletAdapter, type BridgeProvider, type BrowserNoirProviderConfig, CHAIN_NUMERIC_IDS, type CommitmentPoint, ComplianceManager, type CreateIntentOptions, type CreatePaymentOptions, CryptoError, DEFAULT_THRESHOLD, DEFAULT_TOTAL_ORACLES, DerivationPath, type EIP1193ConnectInfo, type EIP1193Event, type EIP1193Provider, type EIP1193ProviderRpcError, type EIP1193RequestArguments, type EIP712Domain, type EIP712TypeDefinition, type EIP712TypedData, type EIP712Types, EncryptionNotImplementedError, ErrorCode, type EthereumAdapterConfig, EthereumChainId, type EthereumChainIdType, type EthereumChainMetadata, type EthereumTokenMetadata, type EthereumTransactionReceipt, type EthereumTransactionRequest, EthereumWalletAdapter, type EthereumWalletName, type ExportedViewingKey, FulfillmentProofParams, FundingProofParams, type HardwareAccount, type HardwareConnectionStatus, type HardwareDeviceInfo, HardwareErrorCode, type HardwareErrorCodeType, type HardwareEthereumTx, type HardwareSignRequest, type HardwareSignature, type HardwareTransport, type HardwareWalletConfig, HardwareWalletError, type HardwareWalletType, IntentBuilder, IntentError, type LedgerConfig, type LedgerModel, LedgerWalletAdapter, MockEthereumAdapter, type MockEthereumAdapterConfig, type MockHardwareConfig, MockLedgerAdapter, MockProofProvider, MockSolanaAdapter, type MockSolanaAdapterConfig, MockSolver, type MockSolverConfig, MockTrezorAdapter, MockWalletAdapter, NEARIntentsAdapter, type NEARIntentsAdapterConfig, NetworkError, ORACLE_DOMAIN, OneClickClient, type OracleAttestationMessage, type OracleId, type OracleInfo, type OracleRegistry, type OracleRegistryConfig, type OracleSignature, type OracleStatus, PaymentBuilder, type PedersenCommitment, type PreparedSwap, type PriceFeed, type PrivacyConfig, type ProductionQuote, ProofError, ProofFramework, ProofNotImplementedError, type ProofProgressCallback, ProofProvider, ProofResult, type ReceivedNote, SIP, type SIPConfig, SIPError, STABLECOIN_ADDRESSES, STABLECOIN_DECIMALS, STABLECOIN_INFO, type SerializedError, type ShieldedBalance, type ShieldedSendParams, type ShieldedSendResult, type SignedOracleAttestation, type SolanaAdapterConfig, type SolanaCluster, type SolanaConnection, type SolanaPublicKey, type SolanaSendOptions, type SolanaSignature, type SolanaTransaction, type SolanaUnsignedTransaction, type SolanaVersionedTransaction, SolanaWalletAdapter, type SolanaWalletName, type SolanaWalletProvider, type StablecoinInfo, type StealthCurve, type SwapRequest, type SwapResult, type TransactionData, type TransportType, Treasury, type TrezorConfig, type TrezorModel, TrezorWalletAdapter, ValidationError, ValidityProofParams, type VerificationResult, type WalletAdapter, WalletError, type ZcashQuote, type ZcashQuoteParams, ZcashRPCClient, ZcashRPCError, ZcashShieldedService, type ZcashShieldedServiceConfig, type ZcashSwapParams, type ZcashSwapResult, ZcashSwapService, type ZcashSwapServiceConfig, type ZcashSwapSourceChain, type ZcashSwapSourceToken, type ZcashSwapStatus, addBlindings, addCommitments, addOracle, attachProofs, base58ToHex, bytesToHex as browserBytesToHex, hexToBytes as browserHexToBytes, checkEd25519StealthAddress, checkStealthAddress, commit, commitZero, computeAttestationHash, createCommitment, createEthereumAdapter, createLedgerAdapter, createMockEthereumAdapter, createMockEthereumProvider, createMockLedgerAdapter, createMockSolanaAdapter, createMockSolanaConnection, createMockSolanaProvider, createMockSolver, createMockTrezorAdapter, createNEARIntentsAdapter, createOracleRegistry, createProductionSIP, createSIP, createShieldedIntent, createShieldedPayment, createSolanaAdapter, createTrezorAdapter, createWalletFactory, createZcashClient, createZcashShieldedService, createZcashSwapService, decodeStealthMetaAddress, decryptMemo, decryptWithViewing, deriveEd25519StealthPrivateKey, deriveOracleId, deriveStealthPrivateKey, deriveViewingKey, deserializeAttestationMessage, deserializeIntent, deserializePayment, detectEthereumWallets, detectSolanaWallets, ed25519PublicKeyToNearAddress, ed25519PublicKeyToSolanaAddress, encodeStealthMetaAddress, encryptForViewing, featureNotSupportedError, formatStablecoinAmount, fromHex, fromStablecoinUnits, generateBlinding, generateEd25519StealthAddress, generateEd25519StealthMetaAddress, generateIntentId, generateRandomBytes, generateStealthAddress, generateStealthMetaAddress, generateViewingKey, getActiveOracles, getAvailableTransports, getBrowserInfo, getChainNumericId, getChainsForStablecoin, getCurveForChain, getDefaultRpcEndpoint, getDerivationPath, getErrorMessage, getEthereumProvider, getGenerators, getIntentSummary, getPaymentSummary, getPaymentTimeRemaining, getPrivacyConfig, getPrivacyDescription, getSolanaProvider, getStablecoin, getStablecoinInfo, getStablecoinsForChain, getSupportedStablecoins, getTimeRemaining, hasEnoughOracles, hasErrorCode, hasRequiredProofs, hash, hexToNumber, isBrowser, isEd25519Chain, isExpired, isNonNegativeAmount, isPaymentExpired, isPrivateWalletAdapter, isSIPError, isStablecoin, isStablecoinOnChain, isValidAmount, isValidChainId, isValidCompressedPublicKey, isValidEd25519PublicKey, isValidHex, isValidHexLength, isValidNearAccountId, isValidNearImplicitAddress, isValidPrivacyLevel, isValidPrivateKey, isValidScalar, isValidSlippage, isValidSolanaAddress, isValidStealthMetaAddress, nearAddressToEd25519PublicKey, normalizeAddress, notConnectedError, publicKeyToEthAddress, registerWallet, removeOracle, secureWipe, secureWipeAll, serializeAttestationMessage, serializeIntent, serializePayment, signAttestationMessage, solanaAddressToEd25519PublicKey, solanaPublicKeyToHex, subtractBlindings, subtractCommitments, supportsSharedArrayBuffer, supportsWebBluetooth, supportsWebHID, supportsWebUSB, supportsWebWorkers, toHex, toStablecoinUnits, trackIntent, trackPayment, updateOracleStatus, validateAsset, validateCreateIntentParams, validateIntentInput, validateIntentOutput, validateScalar, validateViewingKey, verifyAttestation, verifyCommitment, verifyOpening, verifyOracleSignature, walletRegistry, withSecureBuffer, withSecureBufferSync, wrapError };