@sudobility/contracts 1.12.0 → 1.13.1

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

@@ -0,0 +1,209 @@
+import { Connection, PublicKey, Transaction } from '@solana/web3.js';
+import { ChainInfo } from '@sudobility/configs';
+import { Optional } from '@sudobility/types';
+import { ClaimableInfo, MailerFees } from './types.js';
+/**
+ * Interface for wallet adapter pattern
+ */
+export interface Wallet {
+    publicKey: PublicKey;
+    signTransaction<T extends Transaction>(transaction: T): Promise<T>;
+    signAllTransactions<T extends Transaction>(transactions: T[]): Promise<T[]>;
+}
+/**
+ * Solana Wallet interface
+ */
+export interface SolanaWallet {
+    wallet: Wallet;
+    connection?: Connection;
+}
+/**
+ * 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;
+    /**
+     * Transaction hash (same as signature for Solana)
+     */
+    transactionHash: 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;
+}
+/**
+ * Stateless Solana Mailer client.
+ * All methods take wallet and chainInfo as parameters.
+ * No state is stored in the instance.
+ */
+export declare class SolanaMailerClient {
+    private defaultComputeUnitMultiplier;
+    private readonly defaultComputeUnits;
+    private readonly priorityFeeRecommendations;
+    /**
+     * Create or get connection from wallet/chainInfo
+     */
+    private getOrCreateConnection;
+    /**
+     * Get program and state PDAs from chainInfo
+     */
+    private getProgramAddresses;
+    /**
+     * Optimize compute units for a transaction
+     */
+    private optimizeComputeUnits;
+    /**
+     * Send and confirm transaction
+     */
+    private sendTransaction;
+    /**
+     * Initialize the mailer program (owner only)
+     */
+    initialize(connectedWallet: SolanaWallet, chainInfo: ChainInfo, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Send a message with optional revenue sharing
+     */
+    send(connectedWallet: SolanaWallet, chainInfo: ChainInfo, to: string | PublicKey, subject: string, body: string, revenueShareToReceiver: boolean, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Send a prepared message
+     */
+    sendPrepared(connectedWallet: SolanaWallet, chainInfo: ChainInfo, to: string | PublicKey, mailId: string, revenueShareToReceiver: boolean, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Send through webhook
+     */
+    sendThroughWebhook(connectedWallet: SolanaWallet, chainInfo: ChainInfo, to: string | PublicKey, subject: string, body: string, webhookId: string, revenueShareToReceiver: boolean, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Send to email address
+     */
+    sendToEmail(emailHash: string, subject: string, body: string, payer: string | PublicKey, revenueShareToReceiver: boolean, connectedWallet: SolanaWallet, chainInfo: ChainInfo, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Send prepared to email address
+     */
+    sendPreparedToEmail(emailHash: string, mailId: string, payer: string | PublicKey, revenueShareToReceiver: boolean, connectedWallet: SolanaWallet, chainInfo: ChainInfo, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Claim recipient share
+     */
+    claimRecipientShare(connectedWallet: SolanaWallet, chainInfo: ChainInfo, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Claim owner share (owner only)
+     */
+    claimOwnerShare(connectedWallet: SolanaWallet, chainInfo: ChainInfo, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Claim expired shares (owner only)
+     */
+    claimExpiredShares(connectedWallet: SolanaWallet, chainInfo: ChainInfo, recipient: string | PublicKey, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Delegate to another address
+     */
+    delegateTo(connectedWallet: SolanaWallet, chainInfo: ChainInfo, delegate: Optional<string | PublicKey>, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Reject delegation
+     */
+    rejectDelegation(connectedWallet: SolanaWallet, chainInfo: ChainInfo, delegatingAddress: string | PublicKey, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Set fees (owner only)
+     */
+    setFees(connectedWallet: SolanaWallet, chainInfo: ChainInfo, sendFee: number | bigint, delegationFee: number | bigint, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Set custom fee percentage
+     */
+    setCustomFeePercentage(account: string | PublicKey, percentage: number, connectedWallet: SolanaWallet, chainInfo: ChainInfo, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Clear custom fee percentage
+     */
+    clearCustomFeePercentage(account: string | PublicKey, connectedWallet: SolanaWallet, chainInfo: ChainInfo, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Pause the program (owner only)
+     */
+    pause(connectedWallet: SolanaWallet, chainInfo: ChainInfo, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Unpause the program (owner only)
+     */
+    unpause(connectedWallet: SolanaWallet, chainInfo: ChainInfo, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Emergency unpause (owner only)
+     */
+    emergencyUnpause(connectedWallet: SolanaWallet, chainInfo: ChainInfo, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Distribute claimable funds when paused
+     */
+    distributeClaimableFunds(connectedWallet: SolanaWallet, chainInfo: ChainInfo, recipients: (string | PublicKey)[], computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
+    /**
+     * Get fees configuration
+     */
+    getFees(chainInfo: ChainInfo, connection?: Connection): Promise<MailerFees>;
+    /**
+     * Get send fee only
+     */
+    getSendFee(chainInfo: ChainInfo, connection?: Connection): Promise<bigint>;
+    /**
+     * Get delegation fee only
+     */
+    getDelegationFee(chainInfo: ChainInfo, connection?: Connection): Promise<bigint>;
+    /**
+     * Get recipient claimable info
+     */
+    getRecipientClaimable(recipient: string | PublicKey, chainInfo: ChainInfo, connection?: Connection): Promise<ClaimableInfo | null>;
+    /**
+     * Get owner claimable amount
+     */
+    getOwnerClaimable(chainInfo: ChainInfo, connection?: Connection): Promise<number>;
+    /**
+     * Get delegation for an address
+     */
+    getDelegation(address: string | PublicKey, chainInfo: ChainInfo, connection?: Connection): Promise<PublicKey | null>;
+    /**
+     * Get custom fee percentage for an account
+     */
+    getCustomFeePercentage(account: string | PublicKey, chainInfo: ChainInfo, connection?: Connection): Promise<number>;
+    /**
+     * Check if the program is paused
+     */
+    isPaused(chainInfo: ChainInfo, connection?: Connection): Promise<boolean>;
+    /**
+     * Get the contract owner
+     */
+    getOwner(chainInfo: ChainInfo, connection?: Connection): Promise<PublicKey>;
+}
+//# sourceMappingURL=solana-mailer-client.d.ts.map

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

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