@sudobility/contracts 1.12.0 → 1.13.0

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

@@ -1,282 +0,0 @@
-import { Connection, PublicKey, Transaction, Keypair, ConfirmOptions } from '@solana/web3.js';
-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[]>;
-}
-/**
- * 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
- * @notice Provides easy-to-use methods for sending messages with USDC fees and revenue sharing
- *
- * ## Key Features:
- * - **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
- * - **Delegation Management**: Delegate message handling with rejection capability
- *
- * ## Usage Examples:
- * ```typescript
- * // Connect to existing deployed program
- * const connection = new Connection('https://api.devnet.solana.com');
- * const wallet = new WalletAdapter(keypair);
- * const programId = new PublicKey('9FLkBDGpZBcR8LMsQ7MwwV6X9P4TDFgN3DeRh5qYyHJF');
- * const usdcMint = new PublicKey('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v');
- * const client = new MailerClient(connection, wallet, programId, usdcMint);
- *
- * // Send message with revenue sharing to recipient
- * await client.send('recipient-address', 'Subject', 'Message body', true);
- *
- * // Claim your revenue share within 60 days (as recipient)
- * await client.claimRecipientShare();
- *
- * // Check claimable amount
- * const info = await client.getRecipientClaimable();
- * if (info) console.log(`Claimable: ${formatUSDC(info.amount)} USDC`);
- * ```
- *
- * @author Mailer Team
- * @version 2.0.0 - Native Solana Program (no Anchor)
- */
-export declare class MailerClient {
-    private connection;
-    private wallet;
-    private programId;
-    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(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
-     * @param subject Message subject
-     * @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
-     * @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, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
-    /**
-     * Claim recipient share of revenue
-     * @returns Transaction result
-     */
-    claimRecipientShare(computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
-    /**
-     * Claim owner share of fees (owner only)
-     * @returns Transaction result
-     */
-    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, 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>, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
-    /**
-     * Reject a delegation made to you
-     * @param delegator Address that delegated to you
-     * @returns Transaction signature
-     */
-    rejectDelegation(delegator: string | PublicKey, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
-    /**
-     * Set the send fee (owner only)
-     * @param newFee New fee in USDC micro-units (6 decimals)
-     * @param computeOptions Compute unit optimization options
-     * @returns Transaction result
-     */
-    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, 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
-     * @returns MailerFees object with current fees
-     */
-    getFees(): Promise<MailerFees>;
-    /**
-     * Get recipient claimable information
-     * @param recipient Optional recipient address, defaults to wallet address
-     * @returns ClaimableInfo or null if no claimable amount
-     */
-    getRecipientClaimable(recipient?: Optional<PublicKey>): Promise<Optional<ClaimableInfo>>;
-    /**
-     * Get owner claimable amount
-     * @returns Owner claimable amount in USDC micro-units
-     */
-    getOwnerClaimable(): Promise<number>;
-    /**
-     * Get delegation information for an address
-     * @param delegator Address to check delegation for, defaults to wallet address
-     * @returns Delegation info or null if no delegation
-     */
-    getDelegation(delegator?: Optional<PublicKey>): Promise<Optional<{
-        delegator: string;
-        delegate?: Optional<string>;
-    }>>;
-    /**
-     * Get the mailer state PDA address
-     * @returns PublicKey of the mailer state PDA
-     */
-    getMailerStatePda(): PublicKey;
-    /**
-     * Send a message to an email address (no wallet known)
-     * Charges only 10% owner fee since recipient wallet is unknown
-     * @param toEmail Email address of the recipient
-     * @param subject Message subject
-     * @param body Message body
-     * @param options Transaction confirm options
-     * @returns Transaction signature
-     */
-    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
-     * @param toEmail Email address of the recipient
-     * @param mailId Pre-prepared message ID
-     * @param options Transaction confirm options
-     * @returns Transaction signature
-     */
-    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
-     * @param mailId Pre-prepared message identifier
-     * @param revenueShareToReceiver If true, recipient gets 90% revenue share
-     * @param resolveSenderToName If true, resolve sender address to name
-     * @returns Transaction signature
-     */
-    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, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
-    /**
-     * Unpause the contract (owner only)
-     * @param options Transaction confirm options
-     * @returns Transaction signature
-     */
-    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, 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, computeOptions?: ComputeUnitOptions): Promise<TransactionResult>;
-    /**
-     * Get the current send fee
-     * @returns Send fee in USDC micro-units (6 decimals)
-     */
-    getSendFee(): Promise<bigint>;
-    /**
-     * Check if contract is currently paused
-     * @returns True if contract is paused, false otherwise
-     */
-    isPaused(): Promise<boolean>;
-    /**
-     * Send and confirm a transaction
-     * @param transaction Transaction to send
-     * @param options Confirm options
-     * @returns Transaction signature
-     */
-    private sendTransaction;
-    /**
-     * Create a simple wallet from a keypair for testing
-     * @param keypair Solana keypair
-     * @returns Wallet interface implementation
-     */
-    static createWallet(keypair: Keypair): Wallet;
-}
-//# sourceMappingURL=mailer-client.d.ts.map

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

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