@sudobility/contracts 0.15.1 → 1.10.0

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

@@ -0,0 +1,210 @@
+import { Account, Address, Hash, PublicClient, WalletClient } from "viem";
+/**
+ * @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 declare class MailerClient {
+    private contractAddress;
+    private publicClient;
+    /**
+     * @description Creates a new MailerClient instance
+     * @param contractAddress The deployed Mailer contract address
+     * @param publicClient Viem public client for reading blockchain state
+     */
+    constructor(contractAddress: string, publicClient: PublicClient);
+    /**
+     * @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
+     */
+    static deploy(walletClient: WalletClient, publicClient: PublicClient, account: Account | Address, usdcTokenAddress: string, ownerAddress: string): Promise<MailerClient>;
+    /**
+     * @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 });
+     * ```
+     */
+    send(to: Address, subject: string, body: string, revenueShareToReceiver: boolean, resolveSenderToName: boolean | undefined, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    /**
+     * @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
+     */
+    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>;
+    /**
+     * 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
+     */
+    delegateTo(delegate: string, walletClient: WalletClient, account: Account | Address): Promise<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
+     */
+    rejectDelegation(delegatingAddress: string, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    /**
+     * Get current delegation fee in USDC (6 decimals)
+     * @returns Delegation fee amount
+     */
+    getDelegationFee(): Promise<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
+     */
+    setDelegationFee(newFee: bigint, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    /**
+     * @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 });
+     * ```
+     */
+    sendToEmailAddress(toEmail: string, subject: string, body: string, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    /**
+     * @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
+     */
+    sendPreparedToEmailAddress(toEmail: string, mailId: string, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    /**
+     * 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
+     */
+    setFee(newFee: bigint, walletClient: WalletClient, account: Account | Address): Promise<Hash>;
+    /**
+     * Get the current send fee
+     * @returns Current send fee in USDC (6 decimals)
+     */
+    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
+     */
+    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>;
+}
+//# sourceMappingURL=mailer-client.d.ts.map

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

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

package/dist/evm/src/evm/mailer-client.js

@@ -0,0 +1,417 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailerClient = void 0;
+const viem_1 = require("viem");
+const Mailer__factory_js_1 = require("../../typechain-types/factories/Mailer__factory.js");
+// Get ABI from typechain-generated factories
+const MAILER_ABI = Mailer__factory_js_1.Mailer__factory.abi;
+// Get bytecode from typechain-generated factories
+const MAILER_BYTECODE = Mailer__factory_js_1.Mailer__factory.bytecode;
+/**
+ * @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);
+ * ```
+ */
+class MailerClient {
+    /**
+     * @description Creates a new MailerClient instance
+     * @param contractAddress The deployed Mailer contract address
+     * @param publicClient Viem public client for reading blockchain state
+     */
+    constructor(contractAddress, publicClient) {
+        this.contractAddress = (0, viem_1.getAddress)(contractAddress);
+        this.publicClient = publicClient;
+    }
+    /**
+     * @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
+     */
+    static async deploy(walletClient, publicClient, account, usdcTokenAddress, ownerAddress) {
+        const hash = await walletClient.deployContract({
+            abi: MAILER_ABI,
+            bytecode: MAILER_BYTECODE,
+            args: [(0, viem_1.getAddress)(usdcTokenAddress), (0, viem_1.getAddress)(ownerAddress)],
+            account,
+            chain: walletClient.chain,
+        });
+        const receipt = await publicClient.waitForTransactionReceipt({ hash });
+        if (!receipt.contractAddress) {
+            throw new Error("Contract deployment failed");
+        }
+        return new MailerClient(receipt.contractAddress, publicClient);
+    }
+    /**
+     * @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 });
+     * ```
+     */
+    async send(to, subject, body, revenueShareToReceiver, resolveSenderToName = false, walletClient, account) {
+        return await walletClient.writeContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'send',
+            args: [to, subject, body, revenueShareToReceiver, resolveSenderToName],
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    /**
+     * @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
+     */
+    async sendPrepared(to, mailId, revenueShareToReceiver, resolveSenderToName = false, walletClient, account) {
+        return await walletClient.writeContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'sendPrepared',
+            args: [to, mailId, revenueShareToReceiver, resolveSenderToName],
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    async getSendFee() {
+        return await this.publicClient.readContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'sendFee',
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        });
+    }
+    async getUsdcToken() {
+        return await this.publicClient.readContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'usdcToken',
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        });
+    }
+    getAddress() {
+        return this.contractAddress;
+    }
+    async claimRecipientShare(walletClient, account) {
+        return await walletClient.writeContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'claimRecipientShare',
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    async claimOwnerShare(walletClient, account) {
+        return await walletClient.writeContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'claimOwnerShare',
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    async claimExpiredShares(recipient, walletClient, account) {
+        return await walletClient.writeContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'claimExpiredShares',
+            args: [(0, viem_1.getAddress)(recipient)],
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    async getRecipientClaimable(recipient) {
+        const result = await this.publicClient.readContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'getRecipientClaimable',
+            args: [(0, viem_1.getAddress)(recipient)],
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        });
+        return {
+            amount: result[0],
+            expiresAt: result[1],
+            isExpired: result[2]
+        };
+    }
+    async getOwnerClaimable() {
+        return await this.publicClient.readContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'getOwnerClaimable'
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        });
+    }
+    // Delegation functionality
+    /**
+     * 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
+     */
+    async delegateTo(delegate, walletClient, account) {
+        return await walletClient.writeContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'delegateTo',
+            args: [(0, viem_1.getAddress)(delegate)],
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    /**
+     * 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
+     */
+    async rejectDelegation(delegatingAddress, walletClient, account) {
+        return await walletClient.writeContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'rejectDelegation',
+            args: [(0, viem_1.getAddress)(delegatingAddress)],
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    /**
+     * Get current delegation fee in USDC (6 decimals)
+     * @returns Delegation fee amount
+     */
+    async getDelegationFee() {
+        return await this.publicClient.readContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'getDelegationFee',
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        });
+    }
+    /**
+     * 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
+     */
+    async setDelegationFee(newFee, walletClient, account) {
+        return await walletClient.writeContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'setDelegationFee',
+            args: [newFee],
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    /**
+     * @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 });
+     * ```
+     */
+    async sendToEmailAddress(toEmail, subject, body, walletClient, account) {
+        return await walletClient.writeContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'sendToEmailAddress',
+            args: [toEmail, subject, body],
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    /**
+     * @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
+     */
+    async sendPreparedToEmailAddress(toEmail, mailId, walletClient, account) {
+        return await walletClient.writeContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'sendPreparedToEmailAddress',
+            args: [toEmail, mailId],
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    /**
+     * 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
+     */
+    async setFee(newFee, walletClient, account) {
+        return await walletClient.writeContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'setFee',
+            args: [newFee],
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    /**
+     * Get the current send fee
+     * @returns Current send fee in USDC (6 decimals)
+     */
+    async getFee() {
+        return await this.publicClient.readContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'getFee',
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        });
+    }
+    /**
+     * 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
+     */
+    async pause(walletClient, account) {
+        return await walletClient.writeContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'pause',
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    /**
+     * 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
+     */
+    async unpause(walletClient, account) {
+        return await walletClient.writeContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'unpause',
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    /**
+     * 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
+     */
+    async emergencyUnpause(walletClient, account) {
+        return await walletClient.writeContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'emergencyUnpause',
+            account,
+            chain: walletClient.chain,
+        });
+    }
+    /**
+     * Check if contract is currently paused
+     * @returns True if contract is paused, false otherwise
+     */
+    async isPaused() {
+        return await this.publicClient.readContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'isPaused',
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        });
+    }
+    /**
+     * 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
+     */
+    async distributeClaimableFunds(recipient, walletClient, account) {
+        return await walletClient.writeContract({
+            address: this.contractAddress,
+            abi: MAILER_ABI,
+            functionName: 'distributeClaimableFunds',
+            args: [(0, viem_1.getAddress)(recipient)],
+            account,
+            chain: walletClient.chain,
+        });
+    }
+}
+exports.MailerClient = MailerClient;
+//# sourceMappingURL=mailer-client.js.map

package/dist/evm/src/evm/mailer-client.js.map

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