@sudobility/contracts 1.11.1 → 1.12.0

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

@@ -1,210 +1,966 @@
-import { Account, Address, Hash, PublicClient, WalletClient } from "viem";
+import { Account, Address, Hash, PublicClient, WalletClient } from 'viem';
+type RecipientClaim = {
+    amount: bigint;
+    expiresAt: bigint;
+    isExpired: boolean;
+};
 /**
- * @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);
- * ```
+ * Gas estimation options for transactions
  */
-export declare class MailerClient {
-    private contractAddress;
-    private publicClient;
+export interface GasOptions {
     /**
-     * @description Creates a new MailerClient instance
-     * @param contractAddress The deployed Mailer contract address
-     * @param publicClient Viem public client for reading blockchain state
+     * Gas multiplier to apply to estimated gas (e.g., 1.2 for 20% buffer)
+     * @default 1.2
      */
-    constructor(contractAddress: string, publicClient: PublicClient);
+    gasMultiplier?: number;
     /**
-     * @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
+     * Maximum gas limit to use (prevents excessive gas usage)
      */
-    static deploy(walletClient: WalletClient, publicClient: PublicClient, account: Account | Address, usdcTokenAddress: string, ownerAddress: string): Promise<MailerClient>;
+    maxGasLimit?: bigint;
     /**
-     * @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 });
-     * ```
+     * Skip gas estimation and use provided gas limit
      */
-    send(to: Address, subject: string, body: string, revenueShareToReceiver: boolean, resolveSenderToName: boolean | undefined, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    gasLimit?: bigint;
     /**
-     * @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
+     * Max fee per gas for EIP-1559 transactions
      */
-    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>;
+    maxFeePerGas?: bigint;
     /**
-     * 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
+     * Max priority fee per gas for EIP-1559 transactions
      */
-    delegateTo(delegate: string, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    maxPriorityFeePerGas?: bigint;
+}
+/**
+ * Transaction result with gas estimation details
+ */
+export interface TransactionResult {
     /**
-     * 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
+     * Transaction hash
      */
-    rejectDelegation(delegatingAddress: string, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    hash: Hash;
     /**
-     * Get current delegation fee in USDC (6 decimals)
-     * @returns Delegation fee amount
+     * Estimated gas used
      */
-    getDelegationFee(): Promise<bigint>;
+    estimatedGas?: bigint;
     /**
-     * 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
+     * Actual gas limit used
      */
-    setDelegationFee(newFee: bigint, walletClient: WalletClient, account: Account | Address): Promise<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);
     /**
-     * @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 });
-     * ```
+     * Helper method to estimate gas for a transaction with optional buffer
      */
-    sendToEmailAddress(toEmail: string, subject: string, body: string, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    private estimateGasWithBuffer;
     /**
-     * @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
+     * Helper method to build transaction parameters with gas options
      */
-    sendPreparedToEmailAddress(toEmail: string, mailId: string, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    private buildTxParams;
     /**
-     * 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
+     * Deploy a fresh Mailer contract instance with gas estimation.
      */
-    setFee(newFee: bigint, walletClient: WalletClient, account: Account | Address): Promise<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;
     /**
-     * Get the current send fee
-     * @returns Current send fee in USDC (6 decimals)
+     * Core message send with explicit payer control and gas estimation.
      */
+    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>;
-    /**
-     * 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
-     */
+    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>;
     isPaused(): Promise<boolean>;
-    /**
-     * 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>;
+    distributeClaimableFunds(recipient: Address | string, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
 }
+export {};
 //# sourceMappingURL=mailer-client.d.ts.map