pepay-streams-sdk 0.1.0

package/src/campaigns/index.ts

@@ -0,0 +1,835 @@
+/**
+ * Campaign Creation Module
+ *
+ * Provides methods for creating all campaign types:
+ * - Instant Airdrops (Kind.INSTANT = 0)
+ * - Vested Airdrops (Kind.VESTED = 1)
+ * - Token Locks (Kind.LOCK = 2)
+ * - Vesting Streams (Kind.VESTING = 3)
+ */
+import {
+  type PublicClient,
+  type WalletClient,
+  type Address,
+  type Hash,
+  type Hex,
+  zeroAddress,
+} from 'viem';
+import { DIAMOND_ABI } from '@pepay-streams/abi/diamond';
+import type {
+  InstantAirdropParams,
+  VestedAirdropParams,
+  LockParams,
+  VestingParams,
+  CampaignInfo,
+  TransactionResult,
+} from '../types';
+
+/**
+ * Campaign Kind enum matching the contract
+ */
+export enum CampaignKind {
+  INSTANT = 0,
+  VESTED = 1,
+  LOCK = 2,
+  VESTING = 3,
+}
+
+/**
+ * Change policy enum matching the contract
+ */
+export enum ChangePolicy {
+  ONLY_RECIPIENT = 0,
+  ONLY_CREATOR = 1,
+  BOTH = 2,
+  NO_ONE = 3,
+}
+
+/**
+ * CreateArgs struct matching the contract
+ */
+interface CreateArgs {
+  kind: number;
+  token: Address;
+  start: bigint;
+  end: bigint;
+  step: bigint;
+  cliffReleaseTime: bigint;
+  cliffBps: number;
+  autoClaimIncentiveBps: number;
+  cancelable: boolean;
+  claimOnce: boolean;
+  changePolicy: number;
+  claimGrace: bigint;
+  recipients: Address[];
+  amounts: bigint[];
+  feeBuffer: bigint;
+  attachDefaultRegistry: boolean;
+  unwrapWETH: boolean;
+  weth: Address;
+}
+
+/**
+ * Campaigns module for creating and managing token distribution campaigns
+ */
+export class CampaignsModule {
+  constructor(
+    private readonly publicClient: PublicClient,
+    private readonly walletClient: WalletClient | undefined,
+    private readonly diamondAddress: Address
+  ) {}
+
+  // ============================================================================
+  // Campaign Creation
+  // ============================================================================
+
+  /**
+   * Create an Instant Airdrop campaign
+   *
+   * Tokens are immediately claimable by recipients after funding.
+   *
+   * @example
+   * ```typescript
+   * const result = await sdk.campaigns.createInstantAirdrop({
+   *   token: '0x...',
+   *   recipients: [
+   *     { address: '0x...', amount: parseEther('100') },
+   *     { address: '0x...', amount: parseEther('50') },
+   *   ],
+   * });
+   * console.log('Campaign created, tx:', result.hash);
+   * ```
+   */
+  async createInstantAirdrop(
+    params: InstantAirdropParams
+  ): Promise<TransactionResult> {
+    const wallet = this.requireWallet();
+
+    const recipients = params.recipients.map((r) => r.address);
+    const amounts = params.recipients.map((r) => r.amount);
+
+    const now = BigInt(Math.floor(Date.now() / 1000));
+    const args: CreateArgs = {
+      kind: CampaignKind.INSTANT,
+      token: params.token,
+      start: now,
+      end: now, // Instant airdrop - same start/end
+      step: 0n,
+      cliffReleaseTime: 0n,
+      cliffBps: 0,
+      autoClaimIncentiveBps: params.autoClaimIncentiveBps ?? 0,
+      cancelable: params.cancelable ?? true,
+      claimOnce: params.claimOnce ?? true,
+      changePolicy: this.changePolicyToEnum(params.changePolicy),
+      claimGrace: BigInt(params.claimGrace ?? 0),
+      recipients,
+      amounts,
+      feeBuffer: params.feeBuffer ?? 0n,
+      attachDefaultRegistry: params.attachDefaultRegistry ?? false,
+      unwrapWETH: params.unwrapWETH ?? false,
+      weth: params.weth ?? zeroAddress,
+    };
+
+    const hash = await wallet.writeContract({
+      chain: wallet.chain,
+      account: wallet.account!,
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'createCampaign',
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      args: [args] as any,
+    });
+
+    return this.createTransactionResult(hash);
+  }
+
+  /**
+   * Create a Vested Airdrop campaign
+   *
+   * Tokens vest linearly over time with optional cliff period.
+   *
+   * @example
+   * ```typescript
+   * const result = await sdk.campaigns.createVestedAirdrop({
+   *   token: '0x...',
+   *   recipients: [
+   *     { address: '0x...', amount: parseEther('1000') },
+   *   ],
+   *   startTime: Math.floor(Date.now() / 1000), // Start now
+   *   duration: 365 * 24 * 60 * 60, // 1 year
+   *   cliffDuration: 90 * 24 * 60 * 60, // 3 month cliff
+   *   steps: 12, // Monthly releases
+   * });
+   * ```
+   */
+  async createVestedAirdrop(
+    params: VestedAirdropParams
+  ): Promise<TransactionResult> {
+    const wallet = this.requireWallet();
+
+    const recipients = params.recipients.map((r) => r.address);
+    const amounts = params.recipients.map((r) => r.amount);
+
+    const startTime = BigInt(params.startTime);
+    const endTime = startTime + BigInt(params.duration);
+    const steps = params.steps ?? 1;
+    const step = steps > 1 ? BigInt(params.duration) / BigInt(steps) : 0n;
+    const cliffReleaseTime = params.cliffDuration
+      ? startTime + BigInt(params.cliffDuration)
+      : 0n;
+
+    const args: CreateArgs = {
+      kind: CampaignKind.VESTED,
+      token: params.token,
+      start: startTime,
+      end: endTime,
+      step,
+      cliffReleaseTime,
+      cliffBps: params.cliffBps ?? 0,
+      autoClaimIncentiveBps: params.autoClaimIncentiveBps ?? 0,
+      cancelable: params.cancelable ?? true,
+      claimOnce: false, // Vested can claim multiple times
+      changePolicy: this.changePolicyToEnum(params.changePolicy),
+      claimGrace: BigInt(params.claimGrace ?? 0),
+      recipients,
+      amounts,
+      feeBuffer: params.feeBuffer ?? 0n,
+      attachDefaultRegistry: params.attachDefaultRegistry ?? false,
+      unwrapWETH: params.unwrapWETH ?? false,
+      weth: params.weth ?? zeroAddress,
+    };
+
+    const hash = await wallet.writeContract({
+      chain: wallet.chain,
+      account: wallet.account!,
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'createCampaign',
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      args: [args] as any,
+    });
+
+    return this.createTransactionResult(hash);
+  }
+
+  /**
+   * Create a Token Lock
+   *
+   * Tokens are locked until a specific unlock time, then fully releasable.
+   *
+   * @example
+   * ```typescript
+   * const result = await sdk.campaigns.createLock({
+   *   token: '0x...',
+   *   recipient: '0x...',
+   *   amount: parseEther('1000000'),
+   *   unlockTime: Math.floor(Date.now() / 1000) + 180 * 24 * 60 * 60, // 6 months
+   * });
+   * ```
+   */
+  async createLock(params: LockParams): Promise<TransactionResult> {
+    const wallet = this.requireWallet();
+
+    const now = BigInt(Math.floor(Date.now() / 1000));
+    const unlockTime = BigInt(params.unlockTime);
+
+    const args: CreateArgs = {
+      kind: CampaignKind.LOCK,
+      token: params.token,
+      start: now,
+      end: unlockTime,
+      step: 0n,
+      cliffReleaseTime: unlockTime, // Lock releases at this time
+      cliffBps: 10000, // 100% released at cliff
+      autoClaimIncentiveBps: 0,
+      cancelable: params.cancelable ?? false,
+      claimOnce: true,
+      changePolicy: this.changePolicyToEnum(params.changePolicy),
+      claimGrace: 0n,
+      recipients: [params.recipient],
+      amounts: [params.amount],
+      feeBuffer: params.feeBuffer ?? 0n,
+      attachDefaultRegistry: false,
+      unwrapWETH: params.unwrapWETH ?? false,
+      weth: params.weth ?? zeroAddress,
+    };
+
+    const hash = await wallet.writeContract({
+      chain: wallet.chain,
+      account: wallet.account!,
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'createCampaign',
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      args: [args] as any,
+    });
+
+    return this.createTransactionResult(hash);
+  }
+
+  /**
+   * Create a Vesting Stream (Payment)
+   *
+   * Single-recipient vesting with optional automation.
+   *
+   * @example
+   * ```typescript
+   * const result = await sdk.campaigns.createVesting({
+   *   token: '0x...',
+   *   recipient: '0x...',
+   *   amount: parseEther('120000'), // 120k tokens
+   *   startTime: Math.floor(Date.now() / 1000),
+   *   duration: 365 * 24 * 60 * 60, // 1 year
+   *   cliffDuration: 0, // No cliff
+   *   steps: 12, // Monthly
+   * });
+   * ```
+   */
+  async createVesting(params: VestingParams): Promise<TransactionResult> {
+    const wallet = this.requireWallet();
+
+    const startTime = BigInt(params.startTime);
+    const endTime = startTime + BigInt(params.duration);
+    const steps = params.steps ?? 1;
+    const step = steps > 1 ? BigInt(params.duration) / BigInt(steps) : 0n;
+    const cliffReleaseTime = params.cliffDuration
+      ? startTime + BigInt(params.cliffDuration)
+      : 0n;
+
+    const args: CreateArgs = {
+      kind: CampaignKind.VESTING,
+      token: params.token,
+      start: startTime,
+      end: endTime,
+      step,
+      cliffReleaseTime,
+      cliffBps: params.cliffBps ?? 0,
+      autoClaimIncentiveBps: params.autoClaimIncentiveBps ?? 0,
+      cancelable: params.cancelable ?? true,
+      claimOnce: false,
+      changePolicy: this.changePolicyToEnum(params.changePolicy),
+      claimGrace: BigInt(params.claimGrace ?? 0),
+      recipients: [params.recipient],
+      amounts: [params.amount],
+      feeBuffer: params.feeBuffer ?? 0n,
+      attachDefaultRegistry: false,
+      unwrapWETH: params.unwrapWETH ?? false,
+      weth: params.weth ?? zeroAddress,
+    };
+
+    const hash = await wallet.writeContract({
+      chain: wallet.chain,
+      account: wallet.account!,
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'createCampaign',
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      args: [args] as any,
+    });
+
+    return this.createTransactionResult(hash);
+  }
+
+  /**
+   * Create a campaign with raw CreateArgs
+   *
+   * Low-level function for full control over campaign parameters.
+   */
+  async createCampaign(args: CreateArgs): Promise<TransactionResult> {
+    const wallet = this.requireWallet();
+
+    const hash = await wallet.writeContract({
+      chain: wallet.chain,
+      account: wallet.account!,
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'createCampaign',
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      args: [args] as any,
+    });
+
+    return this.createTransactionResult(hash);
+  }
+
+  // ============================================================================
+  // Campaign Funding
+  // ============================================================================
+
+  /**
+   * Fund a campaign using EIP-2612 Permit (gasless approval)
+   *
+   * @example
+   * ```typescript
+   * const result = await sdk.campaigns.fundWithPermit({
+   *   campaignId,
+   *   amount: parseEther('1000'),
+   *   deadline: Math.floor(Date.now() / 1000) + 3600,
+   *   v: 28,
+   *   r: '0x...',
+   *   s: '0x...',
+   * });
+   * ```
+   */
+  async fundWithPermit(params: {
+    campaignId: bigint;
+    amount: bigint;
+    deadline: bigint;
+    v: number;
+    r: Hex;
+    s: Hex;
+  }): Promise<TransactionResult> {
+    const wallet = this.requireWallet();
+
+    const hash = await wallet.writeContract({
+      chain: wallet.chain,
+      account: wallet.account!,
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'fundWithPermit',
+      args: [
+        params.campaignId,
+        params.amount,
+        params.deadline,
+        params.v,
+        params.r,
+        params.s,
+      ],
+    });
+
+    return this.createTransactionResult(hash);
+  }
+
+  /**
+   * Fund a campaign using Permit2 (gasless approval)
+   *
+   * @example
+   * ```typescript
+   * const result = await sdk.campaigns.fundWithPermit2({
+   *   campaignId,
+   *   from: userAddress,
+   *   amount: parseEther('1000'),
+   *   permit2Data: encodedPermit2Data,
+   * });
+   * ```
+   */
+  async fundWithPermit2(params: {
+    campaignId: bigint;
+    from: Address;
+    amount: bigint;
+    permit2Data: Hex;
+  }): Promise<TransactionResult> {
+    const wallet = this.requireWallet();
+
+    const hash = await wallet.writeContract({
+      chain: wallet.chain,
+      account: wallet.account!,
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'fundWithPermit2',
+      args: [
+        params.campaignId,
+        params.from,
+        params.amount,
+        params.permit2Data,
+      ],
+    });
+
+    return this.createTransactionResult(hash);
+  }
+
+  /**
+   * Return leftover tokens to creator
+   *
+   * @example
+   * ```typescript
+   * const result = await sdk.campaigns.returnLeftover(campaignId, parseEther('100'));
+   * ```
+   */
+  async returnLeftover(
+    campaignId: bigint,
+    amountToReturn: bigint
+  ): Promise<TransactionResult> {
+    const wallet = this.requireWallet();
+
+    const hash = await wallet.writeContract({
+      chain: wallet.chain,
+      account: wallet.account!,
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'returnLeftover',
+      args: [campaignId, amountToReturn],
+    });
+
+    return this.createTransactionResult(hash);
+  }
+
+  /**
+   * Add native tips to a campaign for automation
+   */
+  async addNativeTips(
+    campaignId: bigint,
+    tipAmount: bigint
+  ): Promise<TransactionResult> {
+    const wallet = this.requireWallet();
+
+    const hash = await wallet.writeContract({
+      chain: wallet.chain,
+      account: wallet.account!,
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'addNativeTips',
+      args: [campaignId, tipAmount],
+      value: tipAmount,
+    });
+
+    return this.createTransactionResult(hash);
+  }
+
+  // ============================================================================
+  // Campaign Queries
+  // ============================================================================
+
+  /**
+   * Get campaign summary by ID
+   *
+   * Returns full campaign configuration and state.
+   *
+   * @example
+   * ```typescript
+   * const campaign = await sdk.campaigns.getCampaign(1n);
+   * console.log('Campaign token:', campaign.token);
+   * console.log('Total claimed:', campaign.totalClaimed);
+   * ```
+   */
+  async getCampaign(campaignId: bigint): Promise<CampaignInfo> {
+    const result = await this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'campaignSummary',
+      args: [campaignId],
+    });
+
+    return this.parseCampaignSummary(campaignId, result as Record<string, unknown>);
+  }
+
+  /**
+   * Get campaign configuration only
+   */
+  async getCampaignConfig(campaignId: bigint): Promise<{
+    kind: number;
+    cancelable: boolean;
+    claimOnce: boolean;
+    canceled: boolean;
+    changePolicy: number;
+    token: Address;
+    creator: Address;
+    cliffBps: number;
+    autoClaimIncentiveBps: number;
+    start: number;
+    end: number;
+    step: number;
+    canceledAt: number;
+    cliffReleaseTime: number;
+    claimGrace: number;
+    unwrapWETH: boolean;
+    weth: Address;
+  }> {
+    const result = await this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'campaignConfig',
+      args: [campaignId],
+    }) as Record<string, unknown>;
+
+    return {
+      kind: Number(result.kind),
+      cancelable: Boolean(result.cancelable),
+      claimOnce: Boolean(result.claimOnce),
+      canceled: Boolean(result.canceled),
+      changePolicy: Number(result.changePolicy),
+      token: result.token as Address,
+      creator: result.creator as Address,
+      cliffBps: Number(result.cliffBps),
+      autoClaimIncentiveBps: Number(result.autoClaimIncentiveBps),
+      start: Number(result.start),
+      end: Number(result.end),
+      step: Number(result.step),
+      canceledAt: Number(result.canceledAt),
+      cliffReleaseTime: Number(result.cliffReleaseTime),
+      claimGrace: Number(result.claimGrace),
+      unwrapWETH: Boolean(result.unwrapWETH),
+      weth: result.weth as Address,
+    };
+  }
+
+  /**
+   * Get campaign state (totals and accounting)
+   */
+  async getCampaignState(campaignId: bigint): Promise<{
+    totalAllocated: bigint;
+    totalClaimed: bigint;
+    nativeTips: bigint;
+    returned: bigint;
+    feeBuffer: bigint;
+    feeLoss: bigint;
+    totalFunded: bigint;
+    statusBits: number;
+    uniqueRecipients: bigint;
+  }> {
+    const result = await this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'campaignState',
+      args: [campaignId],
+    }) as Record<string, unknown>;
+
+    return {
+      totalAllocated: result.totalAllocated as bigint,
+      totalClaimed: result.totalClaimed as bigint,
+      nativeTips: result.nativeTips as bigint,
+      returned: result.returned as bigint,
+      feeBuffer: result.feeBuffer as bigint,
+      feeLoss: result.feeLoss as bigint,
+      totalFunded: result.totalFunded as bigint,
+      statusBits: Number(result.statusBits),
+      uniqueRecipients: result.uniqueRecipients as bigint,
+    };
+  }
+
+  /**
+   * Get campaign status bits
+   */
+  async getCampaignStatus(campaignId: bigint): Promise<number> {
+    const result = await this.publicClient.readContract({
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'campaignStatus',
+      args: [campaignId],
+    });
+
+    return Number(result);
+  }
+
+  // ============================================================================
+  // Campaign Administration
+  // ============================================================================
+
+  /**
+   * Pause a campaign (creator or admin only)
+   *
+   * @param campaignId - Campaign ID
+   * @param reason - Pause reason as status bits (e.g., 1 for creator pause)
+   */
+  async pause(campaignId: bigint, reason: number = 1): Promise<TransactionResult> {
+    const wallet = this.requireWallet();
+
+    const hash = await wallet.writeContract({
+      chain: wallet.chain,
+      account: wallet.account!,
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'pauseCampaign',
+      args: [campaignId, reason],
+    });
+
+    return this.createTransactionResult(hash);
+  }
+
+  /**
+   * Resume a paused campaign
+   *
+   * @param campaignId - Campaign ID
+   * @param clearBits - Status bits to clear (e.g., 1 for creator pause)
+   */
+  async resume(campaignId: bigint, clearBits: number = 1): Promise<TransactionResult> {
+    const wallet = this.requireWallet();
+
+    const hash = await wallet.writeContract({
+      chain: wallet.chain,
+      account: wallet.account!,
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'resumeCampaign',
+      args: [campaignId, clearBits],
+    });
+
+    return this.createTransactionResult(hash);
+  }
+
+  /**
+   * Finalize a campaign (no more claims possible)
+   */
+  async finalize(campaignId: bigint): Promise<TransactionResult> {
+    const wallet = this.requireWallet();
+
+    const hash = await wallet.writeContract({
+      chain: wallet.chain,
+      account: wallet.account!,
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'finalizeCampaign',
+      args: [campaignId],
+    });
+
+    return this.createTransactionResult(hash);
+  }
+
+  /**
+   * Cancel a campaign and return funds to creator
+   */
+  async cancel(campaignId: bigint): Promise<TransactionResult> {
+    const wallet = this.requireWallet();
+
+    const hash = await wallet.writeContract({
+      chain: wallet.chain,
+      account: wallet.account!,
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'cancel',
+      args: [campaignId],
+    });
+
+    return this.createTransactionResult(hash);
+  }
+
+  /**
+   * Change a recipient address (for blocked recipients)
+   */
+  async changeRecipient(
+    campaignId: bigint,
+    fromAddress: Address,
+    toAddress: Address
+  ): Promise<TransactionResult> {
+    const wallet = this.requireWallet();
+
+    const hash = await wallet.writeContract({
+      chain: wallet.chain,
+      account: wallet.account!,
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'changeRecipient',
+      args: [campaignId, fromAddress, toAddress],
+    });
+
+    return this.createTransactionResult(hash);
+  }
+
+  /**
+   * Add recipients to an existing campaign
+   */
+  async addRecipients(
+    campaignId: bigint,
+    recipients: Address[],
+    amounts: bigint[],
+    additionalBuffer: bigint = 0n
+  ): Promise<TransactionResult> {
+    const wallet = this.requireWallet();
+
+    const hash = await wallet.writeContract({
+      chain: wallet.chain,
+      account: wallet.account!,
+      address: this.diamondAddress,
+      abi: DIAMOND_ABI,
+      functionName: 'addRecipients',
+      args: [campaignId, recipients, amounts, additionalBuffer],
+    });
+
+    return this.createTransactionResult(hash);
+  }
+
+  // ============================================================================
+  // Helpers
+  // ============================================================================
+
+  private requireWallet(): WalletClient {
+    if (!this.walletClient) {
+      throw new Error(
+        'Wallet client required for write operations. Initialize SDK with a signer.'
+      );
+    }
+    return this.walletClient;
+  }
+
+  private changePolicyToEnum(
+    policy?: 'only_recipient' | 'only_creator' | 'both' | 'no_one'
+  ): number {
+    switch (policy) {
+      case 'only_recipient':
+        return ChangePolicy.ONLY_RECIPIENT;
+      case 'only_creator':
+        return ChangePolicy.ONLY_CREATOR;
+      case 'both':
+        return ChangePolicy.BOTH;
+      case 'no_one':
+        return ChangePolicy.NO_ONE;
+      default:
+        return ChangePolicy.ONLY_RECIPIENT;
+    }
+  }
+
+  private parseCampaignSummary(id: bigint, data: Record<string, unknown>): CampaignInfo {
+    const cfg = data.cfg as Record<string, unknown>;
+    const state = data.state as Record<string, unknown>;
+
+    const kindMap: Record<number, CampaignInfo['kind']> = {
+      0: 'instant_airdrop',
+      1: 'vested_airdrop',
+      2: 'lock',
+      3: 'vesting',
+    };
+
+    const kind = Number(cfg.kind);
+
+    const result: CampaignInfo = {
+      id,
+      kind: kindMap[kind] ?? 'instant_airdrop',
+      token: cfg.token as Address,
+      creator: cfg.creator as Address,
+      name: '', // Not stored on-chain
+      totalAllocated: state.totalAllocated as bigint,
+      totalFunded: state.totalFunded as bigint,
+      totalClaimed: state.totalClaimed as bigint,
+      totalReturned: state.returned as bigint,
+      feeLoss: state.feeLoss as bigint,
+      feeBuffer: state.feeBuffer as bigint,
+      startTime: Number(cfg.start),
+      endTime: Number(cfg.end),
+      cliffTime: Number(cfg.cliffReleaseTime),
+      steps: Number(cfg.step) > 0 ? Math.ceil((Number(cfg.end) - Number(cfg.start)) / Number(cfg.step)) : 1,
+      recipientCount: Number(state.uniqueRecipients),
+      statusBits: Number(state.statusBits),
+      changePolicy: Number(cfg.changePolicy),
+      hasAutomation: (Number(state.statusBits) & (1 << 5)) !== 0,
+    };
+
+    // Add optional fields
+    if (data.hasRegistry) {
+      result.hasRegistry = true;
+    }
+    if (data.merkleRoot) {
+      result.merkleRoot = data.merkleRoot as Hex;
+    }
+
+    return result;
+  }
+
+  private createTransactionResult(hash: Hash): TransactionResult {
+    return {
+      hash,
+      wait: async () => {
+        const receipt = await this.publicClient.waitForTransactionReceipt({
+          hash,
+        });
+        return {
+          blockNumber: receipt.blockNumber,
+          transactionHash: receipt.transactionHash,
+          gasUsed: receipt.gasUsed,
+          status: receipt.status,
+          logs: receipt.logs,
+        };
+      },
+    };
+  }
+}
+
+export default CampaignsModule;