@sudobility/contracts 1.11.2 → 1.12.0

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

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

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

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

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

@@ -9,6 +9,57 @@ export interface Wallet {
     signTransaction<T extends Transaction>(transaction: T): Promise<T>;
     signAllTransactions<T extends Transaction>(transactions: T[]): Promise<T[]>;
 }
+/**
+ * Compute unit optimization options for Solana transactions
+ */
+export interface ComputeUnitOptions {
+    /**
+     * Compute unit limit for the transaction (default: 200,000)
+     * Max: 1,400,000
+     */
+    computeUnitLimit?: number;
+    /**
+     * Priority fee in micro-lamports per compute unit
+     * Higher values = faster inclusion during congestion
+     */
+    computeUnitPrice?: number;
+    /**
+     * Automatically simulate and optimize compute units
+     * @default false
+     */
+    autoOptimize?: boolean;
+    /**
+     * Multiplier for compute unit buffer when auto-optimizing
+     * @default 1.2 (20% buffer)
+     */
+    computeUnitMultiplier?: number;
+    /**
+     * Skip compute unit settings entirely
+     * @default false
+     */
+    skipComputeUnits?: boolean;
+}
+/**
+ * Transaction result with compute unit details
+ */
+export interface TransactionResult {
+    /**
+     * Transaction signature
+     */
+    signature: string;
+    /**
+     * Simulated compute units (if auto-optimized)
+     */
+    simulatedUnits?: number;
+    /**
+     * Actual compute unit limit set
+     */
+    computeUnitLimit?: number;
+    /**
+     * Priority fee per compute unit (if set)
+     */
+    computeUnitPrice?: number;
+}
 /**
  * @class MailerClient
  * @description Native Solana program client for the Mailer program
@@ -50,11 +101,20 @@ export declare class MailerClient {
     private usdcMint;
     private mailerStatePda;
     private mailerBump;
+    private defaultComputeUnitMultiplier;
     constructor(connection: Connection, wallet: Wallet, programId: PublicKey, usdcMint: PublicKey);
+    /**
+     * Optimize compute units for a transaction
+     * @param transaction Transaction to optimize
+     * @param options Compute unit options
+     * @returns Optimized transaction with compute budget instructions
+     */
+    private optimizeComputeUnits;
     /**
      * Initialize the mailer program (owner only)
+     * @param computeOptions Compute unit optimization options
      */
-    initialize(): Promise<string>;
+    initialize(computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
     /**
      * Send a message with optional revenue sharing
      * @param to Recipient's public key or address string who receives message and potential revenue share
@@ -62,52 +122,54 @@ export declare class MailerClient {
      * @param body Message body
      * @param revenueShareToReceiver If true, recipient gets 90% revenue share; if false, no revenue share
      * @param resolveSenderToName If true, resolve sender address to name via off-chain service
-     * @returns Transaction signature
+     * @param computeOptions Compute unit optimization options
+     * @returns Transaction result with signature and compute details
      */
-    send(to: string | PublicKey, subject: string, body: string, revenueShareToReceiver?: boolean, resolveSenderToName?: boolean): Promise<string>;
+    send(to: string | PublicKey, subject: string, body: string, revenueShareToReceiver?: boolean, resolveSenderToName?: boolean, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
     /**
      * Claim recipient share of revenue
-     * @returns Transaction signature
+     * @returns Transaction result
      */
-    claimRecipientShare(): Promise<string>;
+    claimRecipientShare(computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
     /**
      * Claim owner share of fees (owner only)
-     * @returns Transaction signature
+     * @returns Transaction result
      */
-    claimOwnerShare(): Promise<string>;
+    claimOwnerShare(computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
     /**
      * Claim expired recipient shares and move them under owner control
      * @param recipient Recipient whose expired shares to reclaim
      * @param options Transaction confirm options
      * @returns Transaction signature
      */
-    claimExpiredShares(recipient: string | PublicKey, options?: ConfirmOptions): Promise<string>;
+    claimExpiredShares(recipient: string | PublicKey, options?: ConfirmOptions, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
     /**
      * Delegate message handling to another address
      * @param delegate Address to delegate to, or null to clear delegation
      * @returns Transaction signature
      */
-    delegateTo(delegate?: Optional<string | PublicKey>): Promise<string>;
+    delegateTo(delegate?: Optional<string | PublicKey>, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
     /**
      * Reject a delegation made to you
      * @param delegator Address that delegated to you
      * @returns Transaction signature
      */
-    rejectDelegation(delegator: string | PublicKey): Promise<string>;
+    rejectDelegation(delegator: string | PublicKey, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
     /**
      * Set the send fee (owner only)
      * @param newFee New fee in USDC micro-units (6 decimals)
-     * @returns Transaction signature
+     * @param computeOptions Compute unit optimization options
+     * @returns Transaction result
      */
-    setFee(newFee: number | bigint): Promise<string>;
+    setFee(newFee: number | bigint, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
     /**
      * Set the delegation fee (owner only)
      * @param newFee New delegation fee in USDC micro-units (6 decimals)
      * @returns Transaction signature
      */
-    setDelegationFee(newFee: number | bigint): Promise<string>;
-    setCustomFeePercentage(account: string | PublicKey, percentage: number, payer?: Optional<string | PublicKey>): Promise<string>;
-    clearCustomFeePercentage(account: string | PublicKey): Promise<string>;
+    setDelegationFee(newFee: number | bigint, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    setCustomFeePercentage(account: string | PublicKey, percentage: number, payer?: Optional<string | PublicKey>, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    clearCustomFeePercentage(account: string | PublicKey, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
     getCustomFeePercentage(account: string | PublicKey): Promise<number>;
     /**
      * Get current fees from the mailer state
@@ -148,7 +210,7 @@ export declare class MailerClient {
      * @param options Transaction confirm options
      * @returns Transaction signature
      */
-    sendToEmail(toEmail: string, subject: string, body: string, options?: ConfirmOptions): Promise<string>;
+    sendToEmail(toEmail: string, subject: string, body: string, options?: ConfirmOptions, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
     /**
      * Send a prepared message to an email address (no wallet known)
      * Charges only 10% owner fee since recipient wallet is unknown
@@ -157,7 +219,7 @@ export declare class MailerClient {
      * @param options Transaction confirm options
      * @returns Transaction signature
      */
-    sendPreparedToEmail(toEmail: string, mailId: string, options?: ConfirmOptions): Promise<string>;
+    sendPreparedToEmail(toEmail: string, mailId: string, options?: ConfirmOptions, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
     /**
      * Send a prepared message using a mailId (to match EVM behavior)
      * @param to Recipient's public key or address string
@@ -166,33 +228,33 @@ export declare class MailerClient {
      * @param resolveSenderToName If true, resolve sender address to name
      * @returns Transaction signature
      */
-    sendPrepared(to: string | PublicKey, mailId: string, revenueShareToReceiver?: boolean, resolveSenderToName?: boolean): Promise<string>;
-    sendThroughWebhook(to: string | PublicKey, webhookId: string, revenueShareToReceiver?: boolean, resolveSenderToName?: boolean): Promise<string>;
+    sendPrepared(to: string | PublicKey, mailId: string, revenueShareToReceiver?: boolean, resolveSenderToName?: boolean, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    sendThroughWebhook(to: string | PublicKey, webhookId: string, revenueShareToReceiver?: boolean, resolveSenderToName?: boolean, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
     /**
      * Pause the contract and distribute owner claimable funds (owner only)
      * @param options Transaction confirm options
      * @returns Transaction signature
      */
-    pause(options?: ConfirmOptions): Promise<string>;
+    pause(options?: ConfirmOptions, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
     /**
      * Unpause the contract (owner only)
      * @param options Transaction confirm options
      * @returns Transaction signature
      */
-    unpause(options?: ConfirmOptions): Promise<string>;
+    unpause(options?: ConfirmOptions, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
     /**
      * Emergency unpause without fund distribution (owner only)
      * @param options Transaction confirm options
      * @returns Transaction signature
      */
-    emergencyUnpause(options?: ConfirmOptions): Promise<string>;
+    emergencyUnpause(options?: ConfirmOptions, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
     /**
      * Distribute claimable funds to a recipient when contract is paused
      * @param recipient Recipient address to distribute funds for
      * @param options Transaction confirm options
      * @returns Transaction signature
      */
-    distributeClaimableFunds(recipient: string | PublicKey, options?: ConfirmOptions): Promise<string>;
+    distributeClaimableFunds(recipient: string | PublicKey, options?: ConfirmOptions, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
     /**
      * Get the current send fee
      * @returns Send fee in USDC micro-units (6 decimals)

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

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

package/dist/unified-esm/src/solana/mailer-client.js

@@ -1,4 +1,4 @@
-import { PublicKey, Transaction, TransactionInstruction, SystemProgram, } from '@solana/web3.js';
+import { PublicKey, Transaction, TransactionInstruction, SystemProgram, ComputeBudgetProgram, } from '@solana/web3.js';
 import { TOKEN_PROGRAM_ID, getAssociatedTokenAddressSync, createAssociatedTokenAccountInstruction, } from '@solana/spl-token';
 /**
  * Native Solana Program instruction data structures
@@ -287,6 +287,7 @@ var InstructionType;
  */
 export class MailerClient {
     constructor(connection, wallet, programId, usdcMint) {
+        this.defaultComputeUnitMultiplier = 1.2; // 20% buffer by default
         this.connection = connection;
         this.wallet = wallet;
         this.programId = programId;
@@ -296,10 +297,69 @@ export class MailerClient {
         this.mailerStatePda = mailerPda;
         this.mailerBump = bump;
     }
+    /**
+     * Optimize compute units for a transaction
+     * @param transaction Transaction to optimize
+     * @param options Compute unit options
+     * @returns Optimized transaction with compute budget instructions
+     */
+    async optimizeComputeUnits(transaction, options) {
+        // Skip if explicitly disabled
+        if (options?.skipComputeUnits) {
+            return { transaction };
+        }
+        let simulatedUnits;
+        let computeUnitLimit = options?.computeUnitLimit;
+        // Auto-optimize by simulating transaction
+        if (options?.autoOptimize && !computeUnitLimit) {
+            try {
+                // Set a high limit for simulation
+                const simTransaction = new Transaction().add(...transaction.instructions);
+                simTransaction.add(ComputeBudgetProgram.setComputeUnitLimit({
+                    units: 1400000, // Max for simulation
+                }));
+                simTransaction.recentBlockhash = (await this.connection.getLatestBlockhash()).blockhash;
+                simTransaction.feePayer = this.wallet.publicKey;
+                const simulation = await this.connection.simulateTransaction(simTransaction);
+                if (simulation.value.err === null && simulation.value.unitsConsumed) {
+                    simulatedUnits = simulation.value.unitsConsumed;
+                    const multiplier = options.computeUnitMultiplier ?? this.defaultComputeUnitMultiplier;
+                    computeUnitLimit = Math.min(Math.ceil(simulatedUnits * multiplier), 1400000 // Max compute units
+                    );
+                }
+            }
+            catch (error) {
+                console.warn('Failed to simulate transaction for compute unit optimization:', error);
+                // Fall back to default or specified limit
+                computeUnitLimit = computeUnitLimit ?? 200000;
+            }
+        }
+        // Create new transaction with compute budget instructions prepended
+        const optimizedTx = new Transaction();
+        // Add compute unit limit if specified or auto-optimized
+        if (computeUnitLimit) {
+            optimizedTx.add(ComputeBudgetProgram.setComputeUnitLimit({
+                units: computeUnitLimit,
+            }));
+        }
+        // Add priority fee if specified
+        if (options?.computeUnitPrice) {
+            optimizedTx.add(ComputeBudgetProgram.setComputeUnitPrice({
+                microLamports: options.computeUnitPrice,
+            }));
+        }
+        // Add original instructions
+        optimizedTx.add(...transaction.instructions);
+        return {
+            transaction: optimizedTx,
+            simulatedUnits,
+        };
+    }
     /**
      * Initialize the mailer program (owner only)
+     * @param computeOptions Compute unit optimization options
      */
-    async initialize() {
+    async initialize(computeOptions) {
         const instruction = new TransactionInstruction({
             keys: [
                 { pubkey: this.wallet.publicKey, isSigner: true, isWritable: false },
@@ -310,7 +370,7 @@ export class MailerClient {
             data: encodeInitialize(this.usdcMint),
         });
         const transaction = new Transaction().add(instruction);
-        return await this.sendTransaction(transaction);
+        return await this.sendTransaction(transaction, undefined, computeOptions);
     }
     /**
      * Send a message with optional revenue sharing
@@ -319,9 +379,10 @@ export class MailerClient {
      * @param body Message body
      * @param revenueShareToReceiver If true, recipient gets 90% revenue share; if false, no revenue share
      * @param resolveSenderToName If true, resolve sender address to name via off-chain service
-     * @returns Transaction signature
+     * @param computeOptions Compute unit optimization options
+     * @returns Transaction result with signature and compute details
      */
-    async send(to, subject, body, revenueShareToReceiver = false, resolveSenderToName = false) {
+    async send(to, subject, body, revenueShareToReceiver = false, resolveSenderToName = false, computeOptions) {
         const recipientKey = typeof to === 'string' ? new PublicKey(to) : to;
         // Derive recipient claim PDA
         const [recipientClaimPda] = PublicKey.findProgramAddressSync([Buffer.from('claim'), recipientKey.toBuffer()], this.programId);
@@ -351,13 +412,13 @@ export class MailerClient {
         });
         instructions.push(sendInstruction);
         const transaction = new Transaction().add(...instructions);
-        return await this.sendTransaction(transaction);
+        return await this.sendTransaction(transaction, undefined, computeOptions);
     }
     /**
      * Claim recipient share of revenue
-     * @returns Transaction signature
+     * @returns Transaction result
      */
-    async claimRecipientShare() {
+    async claimRecipientShare(computeOptions) {
         const [recipientClaimPda] = PublicKey.findProgramAddressSync([Buffer.from('claim'), this.wallet.publicKey.toBuffer()], this.programId);
         const recipientTokenAccount = getAssociatedTokenAddressSync(this.usdcMint, this.wallet.publicKey);
         const mailerTokenAccount = getAssociatedTokenAddressSync(this.usdcMint, this.mailerStatePda, true);
@@ -374,13 +435,13 @@ export class MailerClient {
             data: encodeSimpleInstruction(InstructionType.ClaimRecipientShare),
         });
         const transaction = new Transaction().add(instruction);
-        return await this.sendTransaction(transaction);
+        return await this.sendTransaction(transaction, undefined, computeOptions);
     }
     /**
      * Claim owner share of fees (owner only)
-     * @returns Transaction signature
+     * @returns Transaction result
      */
-    async claimOwnerShare() {
+    async claimOwnerShare(computeOptions) {
         const ownerTokenAccount = getAssociatedTokenAddressSync(this.usdcMint, this.wallet.publicKey);
         const mailerTokenAccount = getAssociatedTokenAddressSync(this.usdcMint, this.mailerStatePda, true);
         const instruction = new TransactionInstruction({
@@ -395,7 +456,7 @@ export class MailerClient {
             data: encodeSimpleInstruction(InstructionType.ClaimOwnerShare),
         });
         const transaction = new Transaction().add(instruction);
-        return await this.sendTransaction(transaction);
+        return await this.sendTransaction(transaction, undefined, computeOptions);
     }
     /**
      * Claim expired recipient shares and move them under owner control
@@ -403,7 +464,7 @@ export class MailerClient {
      * @param options Transaction confirm options
      * @returns Transaction signature
      */
-    async claimExpiredShares(recipient, options) {
+    async claimExpiredShares(recipient, options, computeOptions) {
         const recipientKey = typeof recipient === 'string' ? new PublicKey(recipient) : recipient;
         const [recipientClaimPda] = PublicKey.findProgramAddressSync([Buffer.from('claim'), recipientKey.toBuffer()], this.programId);
         const instruction = new TransactionInstruction({
@@ -416,14 +477,14 @@ export class MailerClient {
             data: encodeClaimExpiredShares(recipientKey),
         });
         const transaction = new Transaction().add(instruction);
-        return await this.sendTransaction(transaction, options);
+        return await this.sendTransaction(transaction, options, computeOptions);
     }
     /**
      * Delegate message handling to another address
      * @param delegate Address to delegate to, or null to clear delegation
      * @returns Transaction signature
      */
-    async delegateTo(delegate) {
+    async delegateTo(delegate, computeOptions) {
         const delegateKey = delegate
             ? typeof delegate === 'string'
                 ? new PublicKey(delegate)
@@ -446,14 +507,14 @@ export class MailerClient {
             data: encodeDelegateTo(delegateKey),
         });
         const transaction = new Transaction().add(instruction);
-        return await this.sendTransaction(transaction);
+        return await this.sendTransaction(transaction, undefined, computeOptions);
     }
     /**
      * Reject a delegation made to you
      * @param delegator Address that delegated to you
      * @returns Transaction signature
      */
-    async rejectDelegation(delegator) {
+    async rejectDelegation(delegator, computeOptions) {
         const delegatorKey = typeof delegator === 'string' ? new PublicKey(delegator) : delegator;
         const [delegationPda] = PublicKey.findProgramAddressSync([Buffer.from('delegation'), delegatorKey.toBuffer()], this.programId);
         const instruction = new TransactionInstruction({
@@ -466,14 +527,15 @@ export class MailerClient {
             data: encodeSimpleInstruction(InstructionType.RejectDelegation),
         });
         const transaction = new Transaction().add(instruction);
-        return await this.sendTransaction(transaction);
+        return await this.sendTransaction(transaction, undefined, computeOptions);
     }
     /**
      * Set the send fee (owner only)
      * @param newFee New fee in USDC micro-units (6 decimals)
-     * @returns Transaction signature
+     * @param computeOptions Compute unit optimization options
+     * @returns Transaction result
      */
-    async setFee(newFee) {
+    async setFee(newFee, computeOptions) {
         const instruction = new TransactionInstruction({
             keys: [
                 { pubkey: this.wallet.publicKey, isSigner: true, isWritable: false },
@@ -483,14 +545,14 @@ export class MailerClient {
             data: encodeSetFee(typeof newFee === 'bigint' ? newFee : BigInt(newFee)),
         });
         const transaction = new Transaction().add(instruction);
-        return await this.sendTransaction(transaction);
+        return await this.sendTransaction(transaction, undefined, computeOptions);
     }
     /**
      * Set the delegation fee (owner only)
      * @param newFee New delegation fee in USDC micro-units (6 decimals)
      * @returns Transaction signature
      */
-    async setDelegationFee(newFee) {
+    async setDelegationFee(newFee, computeOptions) {
         const instruction = new TransactionInstruction({
             keys: [
                 { pubkey: this.wallet.publicKey, isSigner: true, isWritable: false },
@@ -500,9 +562,9 @@ export class MailerClient {
             data: encodeSetDelegationFee(typeof newFee === 'bigint' ? newFee : BigInt(newFee)),
         });
         const transaction = new Transaction().add(instruction);
-        return await this.sendTransaction(transaction);
+        return await this.sendTransaction(transaction, undefined, computeOptions);
     }
-    async setCustomFeePercentage(account, percentage, payer) {
+    async setCustomFeePercentage(account, percentage, payer, computeOptions) {
         const normalizedPercentage = Math.trunc(percentage);
         if (normalizedPercentage < 0 || normalizedPercentage > 100) {
             throw new Error('Percentage must be between 0 and 100');
@@ -527,9 +589,9 @@ export class MailerClient {
             data: encodeSetCustomFeePercentage(accountKey, normalizedPercentage),
         });
         const transaction = new Transaction().add(instruction);
-        return this.sendTransaction(transaction);
+        return this.sendTransaction(transaction, undefined, computeOptions);
     }
-    async clearCustomFeePercentage(account) {
+    async clearCustomFeePercentage(account, computeOptions) {
         const accountKey = typeof account === 'string' ? new PublicKey(account) : account;
         const [discountPda] = PublicKey.findProgramAddressSync([Buffer.from('discount'), accountKey.toBuffer()], this.programId);
         const instruction = new TransactionInstruction({
@@ -542,7 +604,7 @@ export class MailerClient {
             data: encodeClearCustomFeePercentage(accountKey),
         });
         const transaction = new Transaction().add(instruction);
-        return this.sendTransaction(transaction);
+        return this.sendTransaction(transaction, undefined, computeOptions);
     }
     async getCustomFeePercentage(account) {
         const accountKey = typeof account === 'string' ? new PublicKey(account) : account;
@@ -640,7 +702,7 @@ export class MailerClient {
      * @param options Transaction confirm options
      * @returns Transaction signature
      */
-    async sendToEmail(toEmail, subject, body, options) {
+    async sendToEmail(toEmail, subject, body, options, computeOptions) {
         // Get associated token accounts
         const senderTokenAccount = getAssociatedTokenAddressSync(this.usdcMint, this.wallet.publicKey);
         const mailerTokenAccount = getAssociatedTokenAddressSync(this.usdcMint, this.mailerStatePda, true);
@@ -666,7 +728,7 @@ export class MailerClient {
             data: instructionData,
         }));
         const transaction = new Transaction().add(...instructions);
-        return this.sendTransaction(transaction, options);
+        return this.sendTransaction(transaction, options, computeOptions);
     }
     /**
      * Send a prepared message to an email address (no wallet known)
@@ -676,7 +738,7 @@ export class MailerClient {
      * @param options Transaction confirm options
      * @returns Transaction signature
      */
-    async sendPreparedToEmail(toEmail, mailId, options) {
+    async sendPreparedToEmail(toEmail, mailId, options, computeOptions) {
         // Get associated token accounts
         const senderTokenAccount = getAssociatedTokenAddressSync(this.usdcMint, this.wallet.publicKey);
         const mailerTokenAccount = getAssociatedTokenAddressSync(this.usdcMint, this.mailerStatePda, true);
@@ -702,7 +764,7 @@ export class MailerClient {
             data: instructionData,
         }));
         const transaction = new Transaction().add(...instructions);
-        return this.sendTransaction(transaction, options);
+        return this.sendTransaction(transaction, options, computeOptions);
     }
     /**
      * Send a prepared message using a mailId (to match EVM behavior)
@@ -712,7 +774,7 @@ export class MailerClient {
      * @param resolveSenderToName If true, resolve sender address to name
      * @returns Transaction signature
      */
-    async sendPrepared(to, mailId, revenueShareToReceiver = false, resolveSenderToName = false) {
+    async sendPrepared(to, mailId, revenueShareToReceiver = false, resolveSenderToName = false, computeOptions) {
         const recipientKey = typeof to === 'string' ? new PublicKey(to) : to;
         const [recipientClaimPda] = PublicKey.findProgramAddressSync([Buffer.from('claim'), recipientKey.toBuffer()], this.programId);
         const senderTokenAccount = getAssociatedTokenAddressSync(this.usdcMint, this.wallet.publicKey);
@@ -737,9 +799,9 @@ export class MailerClient {
         });
         instructions.push(sendInstruction);
         const transaction = new Transaction().add(...instructions);
-        return this.sendTransaction(transaction);
+        return this.sendTransaction(transaction, undefined, computeOptions);
     }
-    async sendThroughWebhook(to, webhookId, revenueShareToReceiver = false, resolveSenderToName = false) {
+    async sendThroughWebhook(to, webhookId, revenueShareToReceiver = false, resolveSenderToName = false, computeOptions) {
         const recipientKey = typeof to === 'string' ? new PublicKey(to) : to;
         const [recipientClaimPda] = PublicKey.findProgramAddressSync([Buffer.from('claim'), recipientKey.toBuffer()], this.programId);
         const senderTokenAccount = getAssociatedTokenAddressSync(this.usdcMint, this.wallet.publicKey);
@@ -764,14 +826,14 @@ export class MailerClient {
         });
         instructions.push(sendInstruction);
         const transaction = new Transaction().add(...instructions);
-        return this.sendTransaction(transaction);
+        return this.sendTransaction(transaction, undefined, computeOptions);
     }
     /**
      * Pause the contract and distribute owner claimable funds (owner only)
      * @param options Transaction confirm options
      * @returns Transaction signature
      */
-    async pause(options) {
+    async pause(options, computeOptions) {
         const ownerTokenAccount = getAssociatedTokenAddressSync(this.usdcMint, this.wallet.publicKey);
         const mailerTokenAccount = getAssociatedTokenAddressSync(this.usdcMint, this.mailerStatePda, true);
         const instruction = new TransactionInstruction({
@@ -786,14 +848,14 @@ export class MailerClient {
             data: encodeSimpleInstruction(InstructionType.Pause),
         });
         const transaction = new Transaction().add(instruction);
-        return await this.sendTransaction(transaction, options);
+        return await this.sendTransaction(transaction, options, computeOptions);
     }
     /**
      * Unpause the contract (owner only)
      * @param options Transaction confirm options
      * @returns Transaction signature
      */
-    async unpause(options) {
+    async unpause(options, computeOptions) {
         const instruction = new TransactionInstruction({
             keys: [
                 { pubkey: this.wallet.publicKey, isSigner: true, isWritable: false },
@@ -803,14 +865,14 @@ export class MailerClient {
             data: encodeSimpleInstruction(InstructionType.Unpause),
         });
         const transaction = new Transaction().add(instruction);
-        return await this.sendTransaction(transaction, options);
+        return await this.sendTransaction(transaction, options, computeOptions);
     }
     /**
      * Emergency unpause without fund distribution (owner only)
      * @param options Transaction confirm options
      * @returns Transaction signature
      */
-    async emergencyUnpause(options) {
+    async emergencyUnpause(options, computeOptions) {
         const instruction = new TransactionInstruction({
             keys: [
                 { pubkey: this.wallet.publicKey, isSigner: true, isWritable: false },
@@ -820,7 +882,7 @@ export class MailerClient {
             data: encodeSimpleInstruction(InstructionType.EmergencyUnpause),
         });
         const transaction = new Transaction().add(instruction);
-        return await this.sendTransaction(transaction, options);
+        return await this.sendTransaction(transaction, options, computeOptions);
     }
     /**
      * Distribute claimable funds to a recipient when contract is paused
@@ -828,7 +890,7 @@ export class MailerClient {
      * @param options Transaction confirm options
      * @returns Transaction signature
      */
-    async distributeClaimableFunds(recipient, options) {
+    async distributeClaimableFunds(recipient, options, computeOptions) {
         const recipientKey = typeof recipient === 'string' ? new PublicKey(recipient) : recipient;
         const [recipientClaimPda] = PublicKey.findProgramAddressSync([Buffer.from('claim'), recipientKey.toBuffer()], this.programId);
         const recipientTokenAccount = getAssociatedTokenAddressSync(this.usdcMint, recipientKey);
@@ -850,7 +912,7 @@ export class MailerClient {
             data,
         });
         const transaction = new Transaction().add(instruction);
-        return await this.sendTransaction(transaction, options);
+        return await this.sendTransaction(transaction, options, computeOptions);
     }
     /**
      * Get the current send fee
@@ -879,17 +941,24 @@ export class MailerClient {
      * @param options Confirm options
      * @returns Transaction signature
      */
-    async sendTransaction(transaction, options) {
+    async sendTransaction(transaction, options, computeOptions) {
+        // Optimize compute units if requested
+        const { transaction: optimizedTx, simulatedUnits } = await this.optimizeComputeUnits(transaction, computeOptions);
         // Get recent blockhash
         const { blockhash } = await this.connection.getLatestBlockhash();
-        transaction.recentBlockhash = blockhash;
-        transaction.feePayer = this.wallet.publicKey;
+        optimizedTx.recentBlockhash = blockhash;
+        optimizedTx.feePayer = this.wallet.publicKey;
         // Sign transaction
-        const signedTx = await this.wallet.signTransaction(transaction);
+        const signedTx = await this.wallet.signTransaction(optimizedTx);
         // Send and confirm
         const signature = await this.connection.sendRawTransaction(signedTx.serialize());
         await this.connection.confirmTransaction(signature, options?.commitment || 'confirmed');
-        return signature;
+        return {
+            signature,
+            simulatedUnits,
+            computeUnitLimit: computeOptions?.computeUnitLimit,
+            computeUnitPrice: computeOptions?.computeUnitPrice,
+        };
     }
     /**
      * Create a simple wallet from a keypair for testing