@sudobility/contracts 0.14.0

package/dist/unified-esm/src/react/hooks/useMailerQueries.js

@@ -0,0 +1,186 @@
+import { useQuery } from '@tanstack/react-query';
+import { useMailerClient } from '../context/MailerProvider.js';
+/**
+ * Query keys for React Query cache management
+ */
+export const mailerQueryKeys = {
+    all: ['mailer'],
+    sendFee: () => [...mailerQueryKeys.all, 'sendFee'],
+    delegationFee: () => [...mailerQueryKeys.all, 'delegationFee'],
+    claimableAmount: (address) => [...mailerQueryKeys.all, 'claimableAmount', address],
+    ownerClaimable: () => [...mailerQueryKeys.all, 'ownerClaimable'],
+    delegation: (address) => [...mailerQueryKeys.all, 'delegation', address],
+    isPaused: () => [...mailerQueryKeys.all, 'isPaused'],
+};
+/**
+ * Hook to get the current send fee
+ *
+ * @example
+ * ```tsx
+ * function FeeDisplay() {
+ *   const { data: fee, isLoading } = useGetSendFee();
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *   return <div>Send Fee: {Number(fee) / 1_000_000} USDC</div>;
+ * }
+ * ```
+ */
+export function useGetSendFee(options) {
+    const client = useMailerClient();
+    return useQuery({
+        queryKey: mailerQueryKeys.sendFee(),
+        queryFn: () => client.getSendFee(),
+        staleTime: 5 * 60 * 1000, // 5 minutes - fees don't change often
+        ...options,
+    });
+}
+/**
+ * Hook to get the current delegation fee
+ *
+ * @example
+ * ```tsx
+ * function DelegationFeeDisplay() {
+ *   const { data: fee, isLoading } = useGetDelegationFee();
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *   return <div>Delegation Fee: {Number(fee) / 1_000_000} USDC</div>;
+ * }
+ * ```
+ */
+export function useGetDelegationFee(options) {
+    const client = useMailerClient();
+    return useQuery({
+        queryKey: mailerQueryKeys.delegationFee(),
+        queryFn: () => client.getDelegationFee(),
+        staleTime: 5 * 60 * 1000, // 5 minutes
+        ...options,
+    });
+}
+/**
+ * Hook to get claimable amount for an address
+ *
+ * @param address - Address to check (defaults to connected wallet)
+ * @example
+ * ```tsx
+ * function ClaimableBalance() {
+ *   const { data: amount, isLoading } = useGetClaimableAmount();
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *   if (!amount || amount === 0n) return <div>No claimable balance</div>;
+ *   return <div>Claimable: {Number(amount) / 1_000_000} USDC</div>;
+ * }
+ * ```
+ */
+export function useGetClaimableAmount(address, options) {
+    const client = useMailerClient();
+    return useQuery({
+        queryKey: mailerQueryKeys.claimableAmount(address),
+        queryFn: () => client.getClaimableAmount(address),
+        staleTime: 30 * 1000, // 30 seconds - balances change more frequently
+        ...options,
+    });
+}
+/**
+ * Hook to get owner's claimable fee balance
+ *
+ * @example
+ * ```tsx
+ * function OwnerDashboard() {
+ *   const { data: amount, isLoading } = useGetOwnerClaimable();
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *   return <div>Owner Fees: {Number(amount) / 1_000_000} USDC</div>;
+ * }
+ * ```
+ */
+export function useGetOwnerClaimable(options) {
+    const client = useMailerClient();
+    return useQuery({
+        queryKey: mailerQueryKeys.ownerClaimable(),
+        queryFn: () => client.getOwnerClaimable(),
+        staleTime: 30 * 1000, // 30 seconds
+        ...options,
+    });
+}
+/**
+ * Hook to get delegation information for an address
+ *
+ * @param address - Address to check delegation for (defaults to connected wallet)
+ * @example
+ * ```tsx
+ * function DelegationStatus() {
+ *   const { data: delegate, isLoading } = useGetDelegation();
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *   if (!delegate) return <div>No delegation set</div>;
+ *   return <div>Delegated to: {delegate}</div>;
+ * }
+ * ```
+ */
+export function useGetDelegation(address, options) {
+    const client = useMailerClient();
+    return useQuery({
+        queryKey: mailerQueryKeys.delegation(address),
+        queryFn: () => client.getDelegation(address),
+        staleTime: 1 * 60 * 1000, // 1 minute
+        ...options,
+    });
+}
+/**
+ * Hook to check if contract is currently paused
+ *
+ * @example
+ * ```tsx
+ * function PauseStatus() {
+ *   const { data: isPaused, isLoading } = useIsPaused();
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *   return (
+ *     <div>
+ *       Contract Status: {isPaused ? '⏸️ Paused' : '✅ Active'}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useIsPaused(options) {
+    const client = useMailerClient();
+    return useQuery({
+        queryKey: mailerQueryKeys.isPaused(),
+        queryFn: () => client.isPaused(),
+        staleTime: 10 * 1000, // 10 seconds - pause status is critical
+        refetchInterval: 30 * 1000, // Refetch every 30 seconds
+        ...options,
+    });
+}
+/**
+ * Hook to get wallet address from the client
+ *
+ * @example
+ * ```tsx
+ * function WalletAddress() {
+ *   const address = useWalletAddress();
+ *   return <div>Connected: {address}</div>;
+ * }
+ * ```
+ */
+export function useWalletAddress() {
+    const client = useMailerClient();
+    return client.getWalletAddress();
+}
+/**
+ * Hook to get chain type (EVM or Solana)
+ *
+ * @example
+ * ```tsx
+ * function ChainBadge() {
+ *   const chainType = useChainType();
+ *   return <div>Chain: {chainType}</div>;
+ * }
+ * ```
+ */
+export function useChainType() {
+    const client = useMailerClient();
+    return client.getChainType();
+}
+//# sourceMappingURL=useMailerQueries.js.map

package/dist/unified-esm/src/react/hooks/useMailerQueries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMailerQueries.js","sourceRoot":"","sources":["../../../../../src/react/hooks/useMailerQueries.ts"],"names":[],"mappings":"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"}

package/dist/unified-esm/src/react/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * React integration for @johnqh/mail_box_contracts
+ *
+ * Provides React Query hooks and context for interacting with the
+ * OnchainMailerClient across EVM and Solana chains.
+ *
+ * @module @johnqh/mail_box_contracts/react
+ *
+ * @example
+ * ```tsx
+ * import { MailerProvider, useGetSendFee, useSendMessage } from '@johnqh/mail_box_contracts/react';
+ *
+ * function App() {
+ *   return (
+ *     <MailerProvider wallet={wallet} config={config}>
+ *       <MessageSender />
+ *     </MailerProvider>
+ *   );
+ * }
+ *
+ * function MessageSender() {
+ *   const { data: fee } = useGetSendFee();
+ *   const sendMessage = useSendMessage();
+ *
+ *   return (
+ *     <button onClick={() => sendMessage.mutate({ subject: 'Hi', body: 'Hello!' })}>
+ *       Send (Fee: {Number(fee) / 1_000_000} USDC)
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+export { MailerProvider, useMailerClient, QueryClient, QueryClientProvider } from './context/MailerProvider';
+export { useGetSendFee, useGetDelegationFee, useGetClaimableAmount, useGetOwnerClaimable, useGetDelegation, useIsPaused, useWalletAddress, useChainType, mailerQueryKeys, } from './hooks/useMailerQueries';
+export { useSendMessage, useSendPrepared, useSendToEmail, useSendPreparedToEmail, useClaimRevenue, useClaimOwnerShare, useClaimExpiredShares, useDelegateTo, useRejectDelegation, useSetFee, useSetDelegationFee, usePause, useUnpause, useEmergencyUnpause, useDistributeClaimableFunds, } from './hooks/useMailerMutations';
+export type { ChainConfig, MessageResult, UnifiedTransaction } from '../unified/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/unified-esm/src/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG7G,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACnB,SAAS,EACT,mBAAmB,EACnB,QAAQ,EACR,UAAU,EACV,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC;AAGpC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/unified-esm/src/react/index.js

@@ -0,0 +1,39 @@
+/**
+ * React integration for @johnqh/mail_box_contracts
+ *
+ * Provides React Query hooks and context for interacting with the
+ * OnchainMailerClient across EVM and Solana chains.
+ *
+ * @module @johnqh/mail_box_contracts/react
+ *
+ * @example
+ * ```tsx
+ * import { MailerProvider, useGetSendFee, useSendMessage } from '@johnqh/mail_box_contracts/react';
+ *
+ * function App() {
+ *   return (
+ *     <MailerProvider wallet={wallet} config={config}>
+ *       <MessageSender />
+ *     </MailerProvider>
+ *   );
+ * }
+ *
+ * function MessageSender() {
+ *   const { data: fee } = useGetSendFee();
+ *   const sendMessage = useSendMessage();
+ *
+ *   return (
+ *     <button onClick={() => sendMessage.mutate({ subject: 'Hi', body: 'Hello!' })}>
+ *       Send (Fee: {Number(fee) / 1_000_000} USDC)
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+// Context and Provider
+export { MailerProvider, useMailerClient, QueryClient, QueryClientProvider } from './context/MailerProvider.js';
+// Query Hooks (Read Operations)
+export { useGetSendFee, useGetDelegationFee, useGetClaimableAmount, useGetOwnerClaimable, useGetDelegation, useIsPaused, useWalletAddress, useChainType, mailerQueryKeys, } from './hooks/useMailerQueries.js';
+// Mutation Hooks (Write Operations)
+export { useSendMessage, useSendPrepared, useSendToEmail, useSendPreparedToEmail, useClaimRevenue, useClaimOwnerShare, useClaimExpiredShares, useDelegateTo, useRejectDelegation, useSetFee, useSetDelegationFee, usePause, useUnpause, useEmergencyUnpause, useDistributeClaimableFunds, } from './hooks/useMailerMutations.js';
+//# sourceMappingURL=index.js.map

package/dist/unified-esm/src/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,uBAAuB;AACvB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE7G,gCAAgC;AAChC,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAElC,oCAAoC;AACpC,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACnB,SAAS,EACT,mBAAmB,EACnB,QAAQ,EACR,UAAU,EACV,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,4BAA4B,CAAC"}

package/dist/unified-esm/src/solana/index.d.ts

@@ -0,0 +1,3 @@
+export { MailerClient, type Wallet, type ComputeUnitOptions, type TransactionResult } from './mailer-client.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/unified-esm/src/solana/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/solana/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/unified-esm/src/solana/index.js

@@ -0,0 +1,3 @@
+export { MailerClient } from './mailer-client.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/unified-esm/src/solana/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/solana/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAIb,MAAM,oBAAoB,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/dist/unified-esm/src/solana/mailer-client.d.ts

@@ -0,0 +1,282 @@
+import { Connection, PublicKey, Transaction, Keypair, ConfirmOptions } from '@solana/web3.js';
+import { Optional } from '@sudobility/types';
+import { ClaimableInfo, MailerFees } from './types.js';
+/**
+ * Interface for wallet adapter pattern
+ */
+export interface Wallet {
+    publicKey: PublicKey;
+    signTransaction<T extends Transaction>(transaction: T): Promise<T>;
+    signAllTransactions<T extends Transaction>(transactions: T[]): Promise<T[]>;
+}
+/**
+ * Compute unit optimization options for Solana transactions
+ */
+export interface ComputeUnitOptions {
+    /**
+     * Compute unit limit for the transaction (default: 200,000)
+     * Max: 1,400,000
+     */
+    computeUnitLimit?: number;
+    /**
+     * Priority fee in micro-lamports per compute unit
+     * Higher values = faster inclusion during congestion
+     */
+    computeUnitPrice?: number;
+    /**
+     * Automatically simulate and optimize compute units
+     * @default false
+     */
+    autoOptimize?: boolean;
+    /**
+     * Multiplier for compute unit buffer when auto-optimizing
+     * @default 1.2 (20% buffer)
+     */
+    computeUnitMultiplier?: number;
+    /**
+     * Skip compute unit settings entirely
+     * @default false
+     */
+    skipComputeUnits?: boolean;
+}
+/**
+ * Transaction result with compute unit details
+ */
+export interface TransactionResult {
+    /**
+     * Transaction signature
+     */
+    signature: string;
+    /**
+     * Simulated compute units (if auto-optimized)
+     */
+    simulatedUnits?: number;
+    /**
+     * Actual compute unit limit set
+     */
+    computeUnitLimit?: number;
+    /**
+     * Priority fee per compute unit (if set)
+     */
+    computeUnitPrice?: number;
+}
+/**
+ * @class MailerClient
+ * @description Native Solana program client for the Mailer program
+ * @notice Provides easy-to-use methods for sending messages with USDC fees and revenue sharing
+ *
+ * ## Key Features:
+ * - **Priority Messages**: Full fee (0.1 USDC) with 90% revenue share to recipient
+ * - **Standard Messages**: 10% fee only (0.01 USDC) with no revenue share
+ * - **Revenue Claims**: 60-day claim period for priority message revenue shares
+ * - **Delegation Management**: Delegate message handling with rejection capability
+ *
+ * ## Usage Examples:
+ * ```typescript
+ * // Connect to existing deployed program
+ * const connection = new Connection('https://api.devnet.solana.com');
+ * const wallet = new WalletAdapter(keypair);
+ * const programId = new PublicKey('9FLkBDGpZBcR8LMsQ7MwwV6X9P4TDFgN3DeRh5qYyHJF');
+ * const usdcMint = new PublicKey('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v');
+ * const client = new MailerClient(connection, wallet, programId, usdcMint);
+ *
+ * // Send message with revenue sharing to recipient
+ * await client.send('recipient-address', 'Subject', 'Message body', true);
+ *
+ * // Claim your revenue share within 60 days (as recipient)
+ * await client.claimRecipientShare();
+ *
+ * // Check claimable amount
+ * const info = await client.getRecipientClaimable();
+ * if (info) console.log(`Claimable: ${formatUSDC(info.amount)} USDC`);
+ * ```
+ *
+ * @author Mailer Team
+ * @version 2.0.0 - Native Solana Program (no Anchor)
+ */
+export declare class MailerClient {
+    private connection;
+    private wallet;
+    private programId;
+    private usdcMint;
+    private mailerStatePda;
+    private mailerBump;
+    private defaultComputeUnitMultiplier;
+    constructor(connection: Connection, wallet: Wallet, programId: PublicKey, usdcMint: PublicKey);
+    /**
+     * Optimize compute units for a transaction
+     * @param transaction Transaction to optimize
+     * @param options Compute unit options
+     * @returns Optimized transaction with compute budget instructions
+     */
+    private optimizeComputeUnits;
+    /**
+     * Initialize the mailer program (owner only)
+     * @param computeOptions Compute unit optimization options
+     */
+    initialize(computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Send a message with optional revenue sharing
+     * @param to Recipient's public key or address string who receives message and potential revenue share
+     * @param subject Message subject
+     * @param body Message body
+     * @param revenueShareToReceiver If true, recipient gets 90% revenue share; if false, no revenue share
+     * @param resolveSenderToName If true, resolve sender address to name via off-chain service
+     * @param computeOptions Compute unit optimization options
+     * @returns Transaction result with signature and compute details
+     */
+    send(to: string | PublicKey, subject: string, body: string, revenueShareToReceiver?: boolean, resolveSenderToName?: boolean, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Claim recipient share of revenue
+     * @returns Transaction result
+     */
+    claimRecipientShare(computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Claim owner share of fees (owner only)
+     * @returns Transaction result
+     */
+    claimOwnerShare(computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Claim expired recipient shares and move them under owner control
+     * @param recipient Recipient whose expired shares to reclaim
+     * @param options Transaction confirm options
+     * @returns Transaction signature
+     */
+    claimExpiredShares(recipient: string | PublicKey, options?: ConfirmOptions, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Delegate message handling to another address
+     * @param delegate Address to delegate to, or null to clear delegation
+     * @returns Transaction signature
+     */
+    delegateTo(delegate?: Optional<string | PublicKey>, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Reject a delegation made to you
+     * @param delegator Address that delegated to you
+     * @returns Transaction signature
+     */
+    rejectDelegation(delegator: string | PublicKey, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Set the send fee (owner only)
+     * @param newFee New fee in USDC micro-units (6 decimals)
+     * @param computeOptions Compute unit optimization options
+     * @returns Transaction result
+     */
+    setFee(newFee: number | bigint, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Set the delegation fee (owner only)
+     * @param newFee New delegation fee in USDC micro-units (6 decimals)
+     * @returns Transaction signature
+     */
+    setDelegationFee(newFee: number | bigint, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    setCustomFeePercentage(account: string | PublicKey, percentage: number, payer?: Optional<string | PublicKey>, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    clearCustomFeePercentage(account: string | PublicKey, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    getCustomFeePercentage(account: string | PublicKey): Promise<number>;
+    /**
+     * Get current fees from the mailer state
+     * @returns MailerFees object with current fees
+     */
+    getFees(): Promise<MailerFees>;
+    /**
+     * Get recipient claimable information
+     * @param recipient Optional recipient address, defaults to wallet address
+     * @returns ClaimableInfo or null if no claimable amount
+     */
+    getRecipientClaimable(recipient?: Optional<PublicKey>): Promise<Optional<ClaimableInfo>>;
+    /**
+     * Get owner claimable amount
+     * @returns Owner claimable amount in USDC micro-units
+     */
+    getOwnerClaimable(): Promise<number>;
+    /**
+     * Get delegation information for an address
+     * @param delegator Address to check delegation for, defaults to wallet address
+     * @returns Delegation info or null if no delegation
+     */
+    getDelegation(delegator?: Optional<PublicKey>): Promise<Optional<{
+        delegator: string;
+        delegate?: Optional<string>;
+    }>>;
+    /**
+     * Get the mailer state PDA address
+     * @returns PublicKey of the mailer state PDA
+     */
+    getMailerStatePda(): PublicKey;
+    /**
+     * Send a message to an email address (no wallet known)
+     * Charges only 10% owner fee since recipient wallet is unknown
+     * @param toEmail Email address of the recipient
+     * @param subject Message subject
+     * @param body Message body
+     * @param options Transaction confirm options
+     * @returns Transaction signature
+     */
+    sendToEmail(toEmail: string, subject: string, body: string, options?: ConfirmOptions, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Send a prepared message to an email address (no wallet known)
+     * Charges only 10% owner fee since recipient wallet is unknown
+     * @param toEmail Email address of the recipient
+     * @param mailId Pre-prepared message ID
+     * @param options Transaction confirm options
+     * @returns Transaction signature
+     */
+    sendPreparedToEmail(toEmail: string, mailId: string, options?: ConfirmOptions, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Send a prepared message using a mailId (to match EVM behavior)
+     * @param to Recipient's public key or address string
+     * @param mailId Pre-prepared message identifier
+     * @param revenueShareToReceiver If true, recipient gets 90% revenue share
+     * @param resolveSenderToName If true, resolve sender address to name
+     * @returns Transaction signature
+     */
+    sendPrepared(to: string | PublicKey, mailId: string, revenueShareToReceiver?: boolean, resolveSenderToName?: boolean, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    sendThroughWebhook(to: string | PublicKey, webhookId: string, revenueShareToReceiver?: boolean, resolveSenderToName?: boolean, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Pause the contract and distribute owner claimable funds (owner only)
+     * @param options Transaction confirm options
+     * @returns Transaction signature
+     */
+    pause(options?: ConfirmOptions, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Unpause the contract (owner only)
+     * @param options Transaction confirm options
+     * @returns Transaction signature
+     */
+    unpause(options?: ConfirmOptions, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Emergency unpause without fund distribution (owner only)
+     * @param options Transaction confirm options
+     * @returns Transaction signature
+     */
+    emergencyUnpause(options?: ConfirmOptions, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Distribute claimable funds to a recipient when contract is paused
+     * @param recipient Recipient address to distribute funds for
+     * @param options Transaction confirm options
+     * @returns Transaction signature
+     */
+    distributeClaimableFunds(recipient: string | PublicKey, options?: ConfirmOptions, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Get the current send fee
+     * @returns Send fee in USDC micro-units (6 decimals)
+     */
+    getSendFee(): Promise<bigint>;
+    /**
+     * Check if contract is currently paused
+     * @returns True if contract is paused, false otherwise
+     */
+    isPaused(): Promise<boolean>;
+    /**
+     * Send and confirm a transaction
+     * @param transaction Transaction to send
+     * @param options Confirm options
+     * @returns Transaction signature
+     */
+    private sendTransaction;
+    /**
+     * Create a simple wallet from a keypair for testing
+     * @param keypair Solana keypair
+     * @returns Wallet interface implementation
+     */
+    static createWallet(keypair: Keypair): Wallet;
+}
+//# sourceMappingURL=mailer-client.d.ts.map

package/dist/unified-esm/src/solana/mailer-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailer-client.d.ts","sourceRoot":"","sources":["../../../../src/solana/mailer-client.ts"],"names":[],"mappings":"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"}