@cicero-zcash/react 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -2,16 +2,7 @@ import React from 'react';
 
 type ZcashAddressType = 'unified' | 'sapling' | 'transparent' | 'unknown';
 type ZcashNetwork = 'mainnet' | 'testnet';
-type PaymentStatus = 'idle' | 'pending' | 'detected' | 'confirmed' | 'expired' | 'failed';
 type CiceroTheme = 'supabase' | 'emerald' | 'dark' | 'light';
-interface PaymentDetails {
-    recipient: string;
-    amount: number | string;
-    memo?: string;
-    message?: string;
-    network?: ZcashNetwork;
-    invoiceId?: string;
-}
 interface Zip321PaymentRequest {
     address: string;
     amount?: string;
@@ -19,52 +10,6 @@ interface Zip321PaymentRequest {
     message?: string;
     rawUri: string;
 }
-interface CiceroPayProps {
-    /** Zcash recipient address (Unified, Sapling, or Transparent) */
-    recipient: string;
-    /** Amount in ZEC */
-    amount: number | string;
-    /** Optional encrypted memo (up to 512 bytes, supported on shielded addresses) */
-    memo?: string;
-    /** Optional human-readable message */
-    message?: string;
-    /** Button label text */
-    label?: string;
-    /** Zcash network (defaults to 'mainnet') */
-    network?: ZcashNetwork;
-    /** Visual theme */
-    theme?: CiceroTheme;
-    /** Button variant */
-    variant?: 'primary' | 'outline' | 'dark';
-    /** Button size */
-    size?: 'sm' | 'md' | 'lg';
-    /** Whether to show estimated USD value alongside ZEC */
-    showUsd?: boolean;
-    /** Custom modal title */
-    modalTitle?: string;
-    /** Custom modal subtitle */
-    modalSubtitle?: string;
-    /** Invoice expiration time in seconds (defaults to 900 = 15 mins) */
-    expiresInSeconds?: number;
-    /** Optional custom lightwalletd or indexer URL */
-    customRpcUrl?: string;
-    /** Optional unique invoice or order reference */
-    invoiceId?: string;
-    /** Callback fired when transaction confirmation is detected */
-    onSuccess?: (tx: {
-        txId: string;
-        amount: number;
-        memo?: string;
-    }) => void;
-    /** Callback fired on payment error */
-    onError?: (error: Error) => void;
-    /** Callback fired whenever the payment status transitions */
-    onStatusChange?: (status: PaymentStatus) => void;
-    /** Custom CSS classes for the trigger button */
-    className?: string;
-    /** Disable the button */
-    disabled?: boolean;
-}
 
 type WalletCategory = 'extension' | 'mobile' | 'desktop' | 'read-only' | 'developer';
 interface WalletSession$1 {
@@ -102,6 +47,12 @@ interface ZcashWallet {
         address?: string;
         network?: ZcashNetwork;
     }) => Promise<number | null>;
+    getNetwork?: () => Promise<ZcashNetwork>;
+    switchNetwork?: (network: ZcashNetwork) => Promise<{
+        success: boolean;
+        requiresManualSwitch?: boolean;
+        currentNetwork?: ZcashNetwork;
+    }>;
     sendPayment?: (params: SendPaymentParams) => Promise<SendPaymentResult>;
 }
 
@@ -142,7 +93,11 @@ interface CiceroContextType {
     isConnecting: boolean;
     wallet: ZcashWallet | null;
     network: ZcashNetwork;
-    switchNetwork: (net: ZcashNetwork) => void;
+    switchNetwork: (net: ZcashNetwork) => Promise<{
+        success: boolean;
+        requiresManualSwitch?: boolean;
+        currentNetwork?: ZcashNetwork;
+    }>;
     balance: BalanceState;
     refetchBalance: () => Promise<void>;
     connect: (walletId: string, customAddressOrKey?: string) => Promise<void>;
@@ -217,39 +172,6 @@ interface CiceroAccountModalProps {
 }
 declare const CiceroAccountModal: React.FC<CiceroAccountModalProps>;
 
-declare const CiceroPayButton: React.FC<CiceroPayProps>;
-
-interface CiceroModalProps {
-    isOpen: boolean;
-    onClose: () => void;
-    recipient: string;
-    amount: number | string;
-    memo?: string;
-    message?: string;
-    network?: ZcashNetwork;
-    status: PaymentStatus;
-    txId: string | null;
-    secondsRemaining: number;
-    zip321Uri: string;
-    addressType: string;
-    isShielded: boolean;
-    memoValidation: {
-        valid: boolean;
-        warning?: string;
-        byteLength: number;
-    };
-    onSimulateDetection?: () => void;
-    onResetPayment?: () => void;
-    title?: string;
-    subtitle?: string;
-    showUsd?: boolean;
-    /** Zucchini Wallet integration */
-    zucchiniAvailable?: boolean;
-    zucchiniPaying?: boolean;
-    onPayWithZucchini?: () => void;
-}
-declare const CiceroModal: React.FC<CiceroModalProps>;
-
 interface CiceroQRCodeProps {
     value: string;
     size?: number;
@@ -259,56 +181,6 @@ interface CiceroQRCodeProps {
 }
 declare const CiceroQRCode: React.FC<CiceroQRCodeProps>;
 
-declare const CiceroInvoice: React.FC<CiceroPayProps>;
-
-interface UseCiceroPaymentOptions {
-    recipient: string;
-    amount: number | string;
-    memo?: string;
-    message?: string;
-    network?: ZcashNetwork;
-    expiresInSeconds?: number;
-    invoiceId?: string;
-    customRpcUrl?: string;
-    onSuccess?: (tx: {
-        txId: string;
-        amount: number;
-        memo?: string;
-    }) => void;
-    onError?: (error: Error) => void;
-    onStatusChange?: (status: PaymentStatus) => void;
-}
-declare function useCiceroPayment({ recipient, amount, memo, message, network, expiresInSeconds, // 15 mins
-invoiceId, customRpcUrl, onSuccess, onError, onStatusChange, }: UseCiceroPaymentOptions): {
-    status: PaymentStatus;
-    txId: string | null;
-    secondsRemaining: number;
-    isModalOpen: boolean;
-    openModal: () => void;
-    closeModal: () => void;
-    resetPayment: () => void;
-    zip321Uri: string;
-    deepLinks: {
-        generic: string;
-        zashi: string;
-        ywallet: string;
-    };
-    addressType: ZcashAddressType;
-    isShielded: boolean;
-    memoValidation: {
-        valid: boolean;
-        warning?: string;
-        byteLength: number;
-    };
-    simulateDetection: () => void;
-    invoiceId: string | undefined;
-    network: ZcashNetwork;
-    customRpcUrl: string | undefined;
-    zucchiniAvailable: boolean;
-    zucchiniPaying: boolean;
-    payWithZucchini: () => Promise<void>;
-};
-
 declare function useZcashPrice(enabled?: boolean): {
     convertZecToUsd: (zecAmount: number | string) => string | null;
     usdPrice: number | null;
@@ -322,6 +194,7 @@ type WalletPaymentStatus = 'idle' | 'requesting' | 'submitted' | 'error';
 interface WalletSession {
     address?: string;
     connected: boolean;
+    network?: ZcashNetwork;
     balance?: number;
 }
 interface WalletPaymentResult {
@@ -360,6 +233,23 @@ declare class ZucchiniWalletAdapter {
      * Resolves the user's active Shielded Unified Address.
      */
     connect(): Promise<WalletSession>;
+    /**
+     * Queries the active network of the Zucchini Wallet ('mainnet' | 'testnet').
+     */
+    getNetwork(): Promise<ZcashNetwork>;
+    /**
+     * Requests a network change. If the extension does not support programmatic
+     * switching, informs the application that manual user toggle is needed.
+     */
+    switchNetwork(targetNetwork: ZcashNetwork): Promise<{
+        success: boolean;
+        requiresManualSwitch?: boolean;
+        currentNetwork: ZcashNetwork;
+    }>;
+    /**
+     * Subscribes to network change events from the wallet extension.
+     */
+    onNetworkChanged(listener: (network: ZcashNetwork) => void): () => void;
     /**
      * Helper to normalize raw balance formats (e.g. number, string, zatoshis, or pool totals).
      */
@@ -481,4 +371,4 @@ declare function getWalletDeepLinks(zip321Uri: string): {
     ywallet: string;
 };
 
-export { type AccountState, type BalanceState, type BuildZip321Params, CiceroAccountModal, type CiceroAccountModalProps, CiceroConnectButton, type CiceroConnectButtonProps, CiceroConnectModal, type CiceroConnectModalProps, type CiceroContextType, CiceroInvoice, CiceroModal, CiceroPayButton, type CiceroPayProps, CiceroProvider, type CiceroProviderProps, CiceroQRCode, type CiceroTheme, type PaymentDetails, type PaymentStatus, type SendPaymentParams, type SendPaymentResult, type UseCiceroPaymentOptions, type UseZucchiniWalletOptions, type WalletCategory, type WalletSession$1 as WalletSession, type ZcashAddressType, type ZcashNetwork, type ZcashWallet, type Zip321PaymentRequest, ZucchiniWalletAdapter, burnerWallet, decodeBase64Url, encodeBase64Url, generateZip321Uri, getAddressType, getDefaultWallets, getWalletDeepLinks, isShieldedAddress, parseZip321Uri, truncateAddress, useAccount, useAccountModal, useBalance, useCicero, useCiceroPayment, useConnectModal, useZcashPrice, useZucchiniWallet, validateMemoSupport, viewingKeyWallet, ywallet, zashiWallet, zucchiniWallet };
+export { type AccountState, type BalanceState, type BuildZip321Params, CiceroAccountModal, type CiceroAccountModalProps, CiceroConnectButton, type CiceroConnectButtonProps, CiceroConnectModal, type CiceroConnectModalProps, type CiceroContextType, CiceroProvider, type CiceroProviderProps, CiceroQRCode, type CiceroTheme, type SendPaymentParams, type SendPaymentResult, type UseZucchiniWalletOptions, type WalletCategory, type WalletSession$1 as WalletSession, type ZcashAddressType, type ZcashNetwork, type ZcashWallet, ZucchiniWalletAdapter, burnerWallet, decodeBase64Url, encodeBase64Url, generateZip321Uri, getAddressType, getDefaultWallets, getWalletDeepLinks, isShieldedAddress, parseZip321Uri, truncateAddress, useAccount, useAccountModal, useBalance, useCicero, useConnectModal, useZcashPrice, useZucchiniWallet, validateMemoSupport, viewingKeyWallet, ywallet, zashiWallet, zucchiniWallet };