@sudobility/contracts 0.14.0 → 1.9.0

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

@@ -1,966 +1,210 @@
-import { Account, Address, Hash, PublicClient, WalletClient } from 'viem';
-type RecipientClaim = {
-    amount: bigint;
-    expiresAt: bigint;
-    isExpired: boolean;
-};
+import { Account, Address, Hash, PublicClient, WalletClient } from "viem";
 /**
- * Gas estimation options for transactions
+ * @class MailerClient
+ * @description High-level TypeScript client for the Mailer contract using viem
+ * @notice Provides easy-to-use methods for sending messages with USDC fees and revenue sharing
+ *
+ * ## Key Features:
+ * - **Delegation Management**: Delegate mail handling with rejection capability
+ * - **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
+ *
+ * ## Usage Examples:
+ * ```typescript
+ * // Connect to existing contract
+ * import { createPublicClient, createWalletClient, http } from 'viem';
+ * import { mainnet } from 'viem/chains';
+ *
+ * const publicClient = createPublicClient({
+ *   chain: mainnet,
+ *   transport: http()
+ * });
+ *
+ * const mailer = new MailerClient('CONTRACT_ADDRESS', publicClient);
+ *
+ * // Send message with revenue sharing to recipient
+ * const walletClient = createWalletClient({
+ *   chain: mainnet,
+ *   transport: http()
+ * });
+ *
+ * await mailer.send('0x...', 'Subject', 'Body', true, walletClient, account);
+ *
+ * // Claim your revenue share (as recipient)
+ * await mailer.claimRecipientShare(walletClient, account);
+ * ```
  */
-export interface GasOptions {
+export declare class MailerClient {
+    private contractAddress;
+    private publicClient;
     /**
-     * Gas multiplier to apply to estimated gas (e.g., 1.2 for 20% buffer)
-     * @default 1.2
+     * @description Creates a new MailerClient instance
+     * @param contractAddress The deployed Mailer contract address
+     * @param publicClient Viem public client for reading blockchain state
      */
-    gasMultiplier?: number;
+    constructor(contractAddress: string, publicClient: PublicClient);
     /**
-     * Maximum gas limit to use (prevents excessive gas usage)
+     * @description Deploy a new Mailer contract and return a client instance
+     * @param walletClient Viem wallet client with deployment permissions
+     * @param account Account to deploy from
+     * @param usdcTokenAddress Address of the USDC token contract
+     * @param ownerAddress Address that will own the deployed contract
+     * @returns Promise resolving to a MailerClient instance
      */
-    maxGasLimit?: bigint;
+    static deploy(walletClient: WalletClient, publicClient: PublicClient, account: Account | Address, usdcTokenAddress: string, ownerAddress: string): Promise<MailerClient>;
     /**
-     * Skip gas estimation and use provided gas limit
+     * @description Send a message with optional revenue sharing
+     * @notice Two modes:
+     *   - revenueShareToReceiver=true: Sender pays 0.1 USDC, recipient gets 90% claimable
+     *   - revenueShareToReceiver=false: Sender pays 0.01 USDC only
+     * @param to Recipient address who receives the message and potential revenue share
+     * @param subject Message subject line
+     * @param body Message content
+     * @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 walletClient Viem wallet client for transaction
+     * @param account Account to send from
+     * @returns Promise resolving to transaction hash
+     * @example
+     * ```typescript
+     * // Send with revenue share to recipient
+     * const hash = await mailer.send('0x...', 'Subject', 'Priority message', true, false, walletClient, account);
+     * // Send standard message (no revenue share)
+     * const hash2 = await mailer.send('0x...', 'Subject', 'Standard message', false, false, walletClient, account);
+     * await publicClient.waitForTransactionReceipt({ hash });
+     * ```
      */
-    gasLimit?: bigint;
+    send(to: Address, subject: string, body: string, revenueShareToReceiver: boolean, resolveSenderToName: boolean | undefined, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
     /**
-     * Max fee per gas for EIP-1559 transactions
+     * @description Send a message using a pre-prepared mail ID with optional revenue sharing
+     * @notice Two modes:
+     *   - revenueShareToReceiver=true: Sender pays 0.1 USDC, recipient gets 90% claimable
+     *   - revenueShareToReceiver=false: Sender pays 0.01 USDC only
+     * @param to Recipient address who receives the message and potential revenue share
+     * @param mailId Pre-prepared message identifier
+     * @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 walletClient Viem wallet client for transaction
+     * @param account Account to send from
+     * @returns Promise resolving to transaction hash
      */
-    maxFeePerGas?: bigint;
+    sendPrepared(to: Address, mailId: string, revenueShareToReceiver: boolean, resolveSenderToName: boolean | undefined, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    getSendFee(): Promise<bigint>;
+    getUsdcToken(): Promise<Address>;
+    getAddress(): Address;
+    claimRecipientShare(walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    claimOwnerShare(walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    claimExpiredShares(recipient: string, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    getRecipientClaimable(recipient: string): Promise<{
+        amount: bigint;
+        expiresAt: bigint;
+        isExpired: boolean;
+    }>;
+    getOwnerClaimable(): Promise<bigint>;
     /**
-     * Max priority fee per gas for EIP-1559 transactions
+     * Delegate mail handling to another address
+     * @param delegate Address to delegate to (or 0x0 to clear delegation)
+     * @param walletClient Connected wallet client
+     * @param account Account to send transaction from
+     * @returns Transaction hash
      */
-    maxPriorityFeePerGas?: bigint;
-}
-/**
- * Transaction result with gas estimation details
- */
-export interface TransactionResult {
+    delegateTo(delegate: string, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
     /**
-     * Transaction hash
+     * Reject a delegation made to you by another address
+     * @param delegatingAddress Address that delegated to you
+     * @param walletClient Connected wallet client
+     * @param account Account to send transaction from
+     * @returns Transaction hash
      */
-    hash: Hash;
+    rejectDelegation(delegatingAddress: string, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
     /**
-     * Estimated gas used
+     * Get current delegation fee in USDC (6 decimals)
+     * @returns Delegation fee amount
      */
-    estimatedGas?: bigint;
+    getDelegationFee(): Promise<bigint>;
     /**
-     * Actual gas limit used
+     * Update delegation fee (owner only)
+     * @param newFee New fee amount in USDC (6 decimals)
+     * @param walletClient Connected wallet client
+     * @param account Account to send transaction from
+     * @returns Transaction hash
      */
-    gasLimit?: bigint;
-}
-/**
- * High-level client for interacting with the EVM Mailer contract.
- * Exposes every callable contract function with type-safe wrappers.
- * Includes automatic gas estimation with configurable buffer for all transactions.
- */
-export declare class MailerClient {
-    static readonly abi: readonly [{
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "_usdcToken";
-            readonly type: "address";
-        }, {
-            readonly internalType: "address";
-            readonly name: "_owner";
-            readonly type: "address";
-        }];
-        readonly stateMutability: "nonpayable";
-        readonly type: "constructor";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "ClaimPeriodNotExpired";
-        readonly type: "error";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "ContractIsPaused";
-        readonly type: "error";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "ContractNotPaused";
-        readonly type: "error";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "FeePaymentRequired";
-        readonly type: "error";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "InvalidAddress";
-        readonly type: "error";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "InvalidPercentage";
-        readonly type: "error";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "MathOverflow";
-        readonly type: "error";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "NoClaimableAmount";
-        readonly type: "error";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "OnlyOwner";
-        readonly type: "error";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "ReentrancyGuard";
-        readonly type: "error";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "TransferFailed";
-        readonly type: "error";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "UnpermittedPayer";
-        readonly type: "error";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [];
-        readonly name: "ContractPaused";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [];
-        readonly name: "ContractUnpaused";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [{
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "account";
-            readonly type: "address";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "uint256";
-            readonly name: "percentage";
-            readonly type: "uint256";
-        }];
-        readonly name: "CustomFeePercentageSet";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [{
-            readonly indexed: false;
-            readonly internalType: "uint256";
-            readonly name: "oldFee";
-            readonly type: "uint256";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "uint256";
-            readonly name: "newFee";
-            readonly type: "uint256";
-        }];
-        readonly name: "DelegationFeeUpdated";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [{
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "delegator";
-            readonly type: "address";
-        }, {
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "delegate";
-            readonly type: "address";
-        }];
-        readonly name: "DelegationSet";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [];
-        readonly name: "EmergencyUnpaused";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [{
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "recipient";
-            readonly type: "address";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "uint256";
-            readonly name: "amount";
-            readonly type: "uint256";
-        }];
-        readonly name: "ExpiredSharesClaimed";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [{
-            readonly indexed: false;
-            readonly internalType: "uint256";
-            readonly name: "oldFee";
-            readonly type: "uint256";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "uint256";
-            readonly name: "newFee";
-            readonly type: "uint256";
-        }];
-        readonly name: "FeeUpdated";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [{
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "recipient";
-            readonly type: "address";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "uint256";
-            readonly name: "amount";
-            readonly type: "uint256";
-        }];
-        readonly name: "FundsDistributed";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [{
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "from";
-            readonly type: "address";
-        }, {
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "to";
-            readonly type: "address";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "string";
-            readonly name: "subject";
-            readonly type: "string";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "string";
-            readonly name: "body";
-            readonly type: "string";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "bool";
-            readonly name: "revenueShareToReceiver";
-            readonly type: "bool";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "bool";
-            readonly name: "resolveSenderToName";
-            readonly type: "bool";
-        }];
-        readonly name: "MailSent";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [{
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "from";
-            readonly type: "address";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "string";
-            readonly name: "toEmail";
-            readonly type: "string";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "string";
-            readonly name: "subject";
-            readonly type: "string";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "string";
-            readonly name: "body";
-            readonly type: "string";
-        }];
-        readonly name: "MailSentToEmail";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [{
-            readonly indexed: false;
-            readonly internalType: "uint256";
-            readonly name: "amount";
-            readonly type: "uint256";
-        }];
-        readonly name: "OwnerClaimed";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [{
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "contractAddress";
-            readonly type: "address";
-        }, {
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "wallet";
-            readonly type: "address";
-        }];
-        readonly name: "PermissionGranted";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [{
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "contractAddress";
-            readonly type: "address";
-        }, {
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "wallet";
-            readonly type: "address";
-        }];
-        readonly name: "PermissionRevoked";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [{
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "from";
-            readonly type: "address";
-        }, {
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "to";
-            readonly type: "address";
-        }, {
-            readonly indexed: true;
-            readonly internalType: "string";
-            readonly name: "mailId";
-            readonly type: "string";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "bool";
-            readonly name: "revenueShareToReceiver";
-            readonly type: "bool";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "bool";
-            readonly name: "resolveSenderToName";
-            readonly type: "bool";
-        }];
-        readonly name: "PreparedMailSent";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [{
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "from";
-            readonly type: "address";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "string";
-            readonly name: "toEmail";
-            readonly type: "string";
-        }, {
-            readonly indexed: true;
-            readonly internalType: "string";
-            readonly name: "mailId";
-            readonly type: "string";
-        }];
-        readonly name: "PreparedMailSentToEmail";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [{
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "recipient";
-            readonly type: "address";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "uint256";
-            readonly name: "amount";
-            readonly type: "uint256";
-        }];
-        readonly name: "RecipientClaimed";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [{
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "recipient";
-            readonly type: "address";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "uint256";
-            readonly name: "recipientAmount";
-            readonly type: "uint256";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "uint256";
-            readonly name: "ownerAmount";
-            readonly type: "uint256";
-        }];
-        readonly name: "SharesRecorded";
-        readonly type: "event";
-    }, {
-        readonly anonymous: false;
-        readonly inputs: readonly [{
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "from";
-            readonly type: "address";
-        }, {
-            readonly indexed: true;
-            readonly internalType: "address";
-            readonly name: "to";
-            readonly type: "address";
-        }, {
-            readonly indexed: true;
-            readonly internalType: "string";
-            readonly name: "webhookId";
-            readonly type: "string";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "bool";
-            readonly name: "revenueShareToReceiver";
-            readonly type: "bool";
-        }, {
-            readonly indexed: false;
-            readonly internalType: "bool";
-            readonly name: "resolveSenderToName";
-            readonly type: "bool";
-        }];
-        readonly name: "WebhookMailSent";
-        readonly type: "event";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "CLAIM_PERIOD";
-        readonly outputs: readonly [{
-            readonly internalType: "uint256";
-            readonly name: "";
-            readonly type: "uint256";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "OWNER_SHARE";
-        readonly outputs: readonly [{
-            readonly internalType: "uint256";
-            readonly name: "";
-            readonly type: "uint256";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "RECIPIENT_SHARE";
-        readonly outputs: readonly [{
-            readonly internalType: "uint256";
-            readonly name: "";
-            readonly type: "uint256";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "recipient";
-            readonly type: "address";
-        }];
-        readonly name: "claimExpiredShares";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "claimOwnerShare";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "claimRecipientShare";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "account";
-            readonly type: "address";
-        }];
-        readonly name: "clearCustomFeePercentage";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "";
-            readonly type: "address";
-        }];
-        readonly name: "customFeeDiscount";
-        readonly outputs: readonly [{
-            readonly internalType: "uint256";
-            readonly name: "";
-            readonly type: "uint256";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "delegate";
-            readonly type: "address";
-        }];
-        readonly name: "delegateTo";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "delegationFee";
-        readonly outputs: readonly [{
-            readonly internalType: "uint256";
-            readonly name: "";
-            readonly type: "uint256";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "recipient";
-            readonly type: "address";
-        }];
-        readonly name: "distributeClaimableFunds";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "emergencyUnpause";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "account";
-            readonly type: "address";
-        }];
-        readonly name: "getCustomFeePercentage";
-        readonly outputs: readonly [{
-            readonly internalType: "uint256";
-            readonly name: "";
-            readonly type: "uint256";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "getDelegationFee";
-        readonly outputs: readonly [{
-            readonly internalType: "uint256";
-            readonly name: "";
-            readonly type: "uint256";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "getFee";
-        readonly outputs: readonly [{
-            readonly internalType: "uint256";
-            readonly name: "";
-            readonly type: "uint256";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "getOwnerClaimable";
-        readonly outputs: readonly [{
-            readonly internalType: "uint256";
-            readonly name: "";
-            readonly type: "uint256";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "recipient";
-            readonly type: "address";
-        }];
-        readonly name: "getRecipientClaimable";
-        readonly outputs: readonly [{
-            readonly internalType: "uint256";
-            readonly name: "amount";
-            readonly type: "uint256";
-        }, {
-            readonly internalType: "uint256";
-            readonly name: "expiresAt";
-            readonly type: "uint256";
-        }, {
-            readonly internalType: "bool";
-            readonly name: "isExpired";
-            readonly type: "bool";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "isPaused";
-        readonly outputs: readonly [{
-            readonly internalType: "bool";
-            readonly name: "";
-            readonly type: "bool";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "owner";
-        readonly outputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "";
-            readonly type: "address";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "ownerClaimable";
-        readonly outputs: readonly [{
-            readonly internalType: "uint256";
-            readonly name: "";
-            readonly type: "uint256";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "pause";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "paused";
-        readonly outputs: readonly [{
-            readonly internalType: "bool";
-            readonly name: "";
-            readonly type: "bool";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "";
-            readonly type: "address";
-        }, {
-            readonly internalType: "address";
-            readonly name: "";
-            readonly type: "address";
-        }];
-        readonly name: "permissions";
-        readonly outputs: readonly [{
-            readonly internalType: "bool";
-            readonly name: "";
-            readonly type: "bool";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "";
-            readonly type: "address";
-        }];
-        readonly name: "recipientClaims";
-        readonly outputs: readonly [{
-            readonly internalType: "uint256";
-            readonly name: "amount";
-            readonly type: "uint256";
-        }, {
-            readonly internalType: "uint256";
-            readonly name: "timestamp";
-            readonly type: "uint256";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "delegatingAddress";
-            readonly type: "address";
-        }];
-        readonly name: "rejectDelegation";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "contractAddress";
-            readonly type: "address";
-        }];
-        readonly name: "removePermission";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "to";
-            readonly type: "address";
-        }, {
-            readonly internalType: "string";
-            readonly name: "subject";
-            readonly type: "string";
-        }, {
-            readonly internalType: "string";
-            readonly name: "body";
-            readonly type: "string";
-        }, {
-            readonly internalType: "address";
-            readonly name: "payer";
-            readonly type: "address";
-        }, {
-            readonly internalType: "bool";
-            readonly name: "revenueShareToReceiver";
-            readonly type: "bool";
-        }, {
-            readonly internalType: "bool";
-            readonly name: "resolveSenderToName";
-            readonly type: "bool";
-        }];
-        readonly name: "send";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "sendFee";
-        readonly outputs: readonly [{
-            readonly internalType: "uint256";
-            readonly name: "";
-            readonly type: "uint256";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "to";
-            readonly type: "address";
-        }, {
-            readonly internalType: "string";
-            readonly name: "mailId";
-            readonly type: "string";
-        }, {
-            readonly internalType: "address";
-            readonly name: "payer";
-            readonly type: "address";
-        }, {
-            readonly internalType: "bool";
-            readonly name: "revenueShareToReceiver";
-            readonly type: "bool";
-        }, {
-            readonly internalType: "bool";
-            readonly name: "resolveSenderToName";
-            readonly type: "bool";
-        }];
-        readonly name: "sendPrepared";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "string";
-            readonly name: "toEmail";
-            readonly type: "string";
-        }, {
-            readonly internalType: "string";
-            readonly name: "mailId";
-            readonly type: "string";
-        }, {
-            readonly internalType: "address";
-            readonly name: "payer";
-            readonly type: "address";
-        }];
-        readonly name: "sendPreparedToEmailAddress";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "to";
-            readonly type: "address";
-        }, {
-            readonly internalType: "string";
-            readonly name: "webhookId";
-            readonly type: "string";
-        }, {
-            readonly internalType: "address";
-            readonly name: "payer";
-            readonly type: "address";
-        }, {
-            readonly internalType: "bool";
-            readonly name: "revenueShareToReceiver";
-            readonly type: "bool";
-        }, {
-            readonly internalType: "bool";
-            readonly name: "resolveSenderToName";
-            readonly type: "bool";
-        }];
-        readonly name: "sendThroughWebhook";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "string";
-            readonly name: "toEmail";
-            readonly type: "string";
-        }, {
-            readonly internalType: "string";
-            readonly name: "subject";
-            readonly type: "string";
-        }, {
-            readonly internalType: "string";
-            readonly name: "body";
-            readonly type: "string";
-        }, {
-            readonly internalType: "address";
-            readonly name: "payer";
-            readonly type: "address";
-        }];
-        readonly name: "sendToEmailAddress";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "account";
-            readonly type: "address";
-        }, {
-            readonly internalType: "uint256";
-            readonly name: "percentage";
-            readonly type: "uint256";
-        }];
-        readonly name: "setCustomFeePercentage";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "uint256";
-            readonly name: "usdcAmount";
-            readonly type: "uint256";
-        }];
-        readonly name: "setDelegationFee";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "uint256";
-            readonly name: "usdcAmount";
-            readonly type: "uint256";
-        }];
-        readonly name: "setFee";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [{
-            readonly internalType: "address";
-            readonly name: "contractAddress";
-            readonly type: "address";
-        }];
-        readonly name: "setPermission";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "unpause";
-        readonly outputs: readonly [];
-        readonly stateMutability: "nonpayable";
-        readonly type: "function";
-    }, {
-        readonly inputs: readonly [];
-        readonly name: "usdcToken";
-        readonly outputs: readonly [{
-            readonly internalType: "contract IERC20";
-            readonly name: "";
-            readonly type: "address";
-        }];
-        readonly stateMutability: "view";
-        readonly type: "function";
-    }];
-    static readonly bytecode: `0x${string}`;
-    private readonly contractAddress;
-    private readonly publicClient;
-    private readonly defaultGasMultiplier;
-    constructor(contractAddress: string | Address, publicClient: PublicClient);
+    setDelegationFee(newFee: bigint, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
     /**
-     * Helper method to estimate gas for a transaction with optional buffer
+     * @description Send a message to an email address (no wallet known)
+     * @notice Charges only 10% owner fee since recipient wallet is unknown
+     * @param toEmail Email address of the recipient
+     * @param subject Message subject line
+     * @param body Message content
+     * @param walletClient Viem wallet client for transaction
+     * @param account Account to send from
+     * @returns Promise resolving to transaction hash
+     * @example
+     * ```typescript
+     * // Send to email address
+     * const hash = await mailer.sendToEmailAddress('user@example.com', 'Subject', 'Body', walletClient, account);
+     * await publicClient.waitForTransactionReceipt({ hash });
+     * ```
      */
-    private estimateGasWithBuffer;
+    sendToEmailAddress(toEmail: string, subject: string, body: string, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
     /**
-     * Helper method to build transaction parameters with gas options
+     * @description Send a pre-prepared message to an email address (no wallet known)
+     * @notice Charges only 10% owner fee since recipient wallet is unknown
+     * @param toEmail Email address of the recipient
+     * @param mailId Pre-prepared message identifier
+     * @param walletClient Viem wallet client for transaction
+     * @param account Account to send from
+     * @returns Promise resolving to transaction hash
      */
-    private buildTxParams;
+    sendPreparedToEmailAddress(toEmail: string, mailId: string, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
     /**
-     * Deploy a fresh Mailer contract instance with gas estimation.
+     * Set the send fee (owner only)
+     * @param newFee New fee amount in USDC (6 decimals)
+     * @param walletClient Viem wallet client for transaction
+     * @param account Account to send from (must be owner)
+     * @returns Promise resolving to transaction hash
      */
-    static deploy(walletClient: WalletClient, publicClient: PublicClient, account: Account | Address, usdcTokenAddress: string | Address, ownerAddress: string | Address, gasOptions?: GasOptions): Promise<{
-        client: MailerClient;
-        result: TransactionResult;
-    }>;
-    getAddress(): Address;
+    setFee(newFee: bigint, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
     /**
-     * Core message send with explicit payer control and gas estimation.
+     * Get the current send fee
+     * @returns Current send fee in USDC (6 decimals)
      */
-    send(to: Address | string, subject: string, body: string, payer: Address | string, revenueShareToReceiver: boolean, resolveSenderToName: boolean, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    sendPrepared(to: Address | string, mailId: string, payer: Address | string, revenueShareToReceiver: boolean, resolveSenderToName: boolean, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    sendThroughWebhook(to: Address | string, webhookId: string, payer: Address | string, revenueShareToReceiver: boolean, resolveSenderToName: boolean, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    sendToEmailAddress(toEmail: string, subject: string, body: string, payer: Address | string, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    sendPreparedToEmailAddress(toEmail: string, mailId: string, payer: Address | string, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
     getFee(): Promise<bigint>;
-    getSendFee(): Promise<bigint>;
-    setFee(newFee: bigint, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    getUsdcToken(): Promise<Address>;
-    getOwner(): Promise<Address>;
-    claimRecipientShare(walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    claimOwnerShare(walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    claimExpiredShares(recipient: Address | string, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    getRecipientClaimable(recipient: Address | string): Promise<RecipientClaim>;
-    getOwnerClaimable(): Promise<bigint>;
-    delegateTo(delegate: Address | string, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    rejectDelegation(delegatingAddress: Address | string, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    getDelegationFee(): Promise<bigint>;
-    setDelegationFee(newFee: bigint, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    setCustomFeePercentage(target: Address | string, percentage: number, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    clearCustomFeePercentage(target: Address | string, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    getCustomFeePercentage(target: Address | string): Promise<number>;
-    getCustomFeeDiscount(target: Address | string): Promise<number>;
-    setPermission(contractAddress: Address | string, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    removePermission(contractAddress: Address | string, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    hasPermission(contractAddress: Address | string, wallet: Address | string): Promise<boolean>;
-    pause(walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    unpause(walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
-    emergencyUnpause(walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
+    /**
+     * Pause the contract and distribute all claimable funds (owner only)
+     * @param walletClient Viem wallet client for transaction
+     * @param account Account to send from (must be owner)
+     * @returns Promise resolving to transaction hash
+     */
+    pause(walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    /**
+     * Unpause the contract (owner only)
+     * @param walletClient Viem wallet client for transaction
+     * @param account Account to send from (must be owner)
+     * @returns Promise resolving to transaction hash
+     */
+    unpause(walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    /**
+     * Emergency unpause without fund distribution (owner only)
+     * @param walletClient Viem wallet client for transaction
+     * @param account Account to send from (must be owner)
+     * @returns Promise resolving to transaction hash
+     */
+    emergencyUnpause(walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    /**
+     * Check if contract is currently paused
+     * @returns True if contract is paused, false otherwise
+     */
     isPaused(): Promise<boolean>;
-    distributeClaimableFunds(recipient: Address | string, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
+    /**
+     * Distribute a specific recipient's claimable funds during pause
+     * Anyone can call this function when contract is paused
+     * @param recipient Address to distribute funds for
+     * @param walletClient Viem wallet client for transaction
+     * @param account Account to send from
+     * @returns Promise resolving to transaction hash
+     */
+    distributeClaimableFunds(recipient: string, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
 }
-export {};
 //# sourceMappingURL=mailer-client.d.ts.map