@sudobility/contracts 0.14.0

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

@@ -0,0 +1,966 @@
+import { Account, Address, Hash, PublicClient, WalletClient } from 'viem';
+type RecipientClaim = {
+    amount: bigint;
+    expiresAt: bigint;
+    isExpired: boolean;
+};
+/**
+ * Gas estimation options for transactions
+ */
+export interface GasOptions {
+    /**
+     * Gas multiplier to apply to estimated gas (e.g., 1.2 for 20% buffer)
+     * @default 1.2
+     */
+    gasMultiplier?: number;
+    /**
+     * Maximum gas limit to use (prevents excessive gas usage)
+     */
+    maxGasLimit?: bigint;
+    /**
+     * Skip gas estimation and use provided gas limit
+     */
+    gasLimit?: bigint;
+    /**
+     * Max fee per gas for EIP-1559 transactions
+     */
+    maxFeePerGas?: bigint;
+    /**
+     * Max priority fee per gas for EIP-1559 transactions
+     */
+    maxPriorityFeePerGas?: bigint;
+}
+/**
+ * Transaction result with gas estimation details
+ */
+export interface TransactionResult {
+    /**
+     * Transaction hash
+     */
+    hash: Hash;
+    /**
+     * Estimated gas used
+     */
+    estimatedGas?: bigint;
+    /**
+     * Actual gas limit used
+     */
+    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);
+    /**
+     * Helper method to estimate gas for a transaction with optional buffer
+     */
+    private estimateGasWithBuffer;
+    /**
+     * Helper method to build transaction parameters with gas options
+     */
+    private buildTxParams;
+    /**
+     * Deploy a fresh Mailer contract instance with gas estimation.
+     */
+    static deploy(walletClient: WalletClient, publicClient: PublicClient, account: Account | Address, usdcTokenAddress: string | Address, ownerAddress: string | Address, gasOptions?: GasOptions): Promise<{
+        client: MailerClient;
+        result: TransactionResult;
+    }>;
+    getAddress(): Address;
+    /**
+     * 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>;
+    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>;
+    distributeClaimableFunds(recipient: Address | string, walletClient: WalletClient, account: Account | Address, gasOptions?: GasOptions): Promise<TransactionResult>;
+}
+export {};
+//# sourceMappingURL=mailer-client.d.ts.map