pepay-streams-sdk 0.1.0

package/dist/api/index.mjs

@@ -0,0 +1,306 @@
+// src/api/index.ts
+var ApiClient = class {
+  baseUrl;
+  chainId;
+  constructor(baseUrl, chainId) {
+    this.baseUrl = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+    this.chainId = chainId;
+  }
+  // ============================================================================
+  // Campaign Queries
+  // ============================================================================
+  /**
+   * Get campaigns with optional filtering
+   *
+   * @example
+   * ```typescript
+   * const campaigns = await sdk.api.getCampaigns({
+   *   kind: 'vested_airdrop',
+   *   status: 'active',
+   *   page: 1,
+   *   pageSize: 20,
+   * });
+   * ```
+   */
+  async getCampaigns(params = {}) {
+    const searchParams = new URLSearchParams();
+    if (params.kind) searchParams.set("kind", params.kind);
+    if (params.creator) searchParams.set("creator", params.creator);
+    if (params.token) searchParams.set("token", params.token);
+    if (params.status) searchParams.set("status", params.status);
+    if (params.page) searchParams.set("page", String(params.page));
+    if (params.pageSize) searchParams.set("pageSize", String(params.pageSize));
+    if (params.sortBy) searchParams.set("sortBy", params.sortBy);
+    if (params.sortOrder) searchParams.set("sortOrder", params.sortOrder);
+    searchParams.set("chainId", String(this.chainId));
+    return this.fetch(
+      `/v1/campaigns?${searchParams.toString()}`
+    );
+  }
+  /**
+   * Get a single campaign by ID
+   */
+  async getCampaign(campaignId) {
+    return this.fetch(
+      `/v1/campaigns/${campaignId}?chainId=${this.chainId}`
+    );
+  }
+  /**
+   * Get campaign recipients
+   */
+  async getCampaignRecipients(campaignId, params = {}) {
+    const searchParams = new URLSearchParams();
+    searchParams.set("chainId", String(this.chainId));
+    if (params.page) searchParams.set("page", String(params.page));
+    if (params.pageSize) searchParams.set("pageSize", String(params.pageSize));
+    return this.fetch(
+      `/v1/campaigns/${campaignId}/recipients?${searchParams.toString()}`
+    );
+  }
+  /**
+   * Get campaign activity/claims
+   */
+  async getCampaignActivity(campaignId, params = {}) {
+    const searchParams = new URLSearchParams();
+    searchParams.set("chainId", String(this.chainId));
+    if (params.page) searchParams.set("page", String(params.page));
+    if (params.pageSize) searchParams.set("pageSize", String(params.pageSize));
+    return this.fetch(
+      `/v1/campaigns/${campaignId}/activity?${searchParams.toString()}`
+    );
+  }
+  // ============================================================================
+  // Order Queries
+  // ============================================================================
+  /**
+   * Get marketplace orders with optional filtering
+   *
+   * @example
+   * ```typescript
+   * const orders = await sdk.api.getOrders({
+   *   orderType: 'tradable',
+   *   status: 'open',
+   *   sortBy: 'totalPrice',
+   *   sortOrder: 'asc',
+   * });
+   * ```
+   */
+  async getOrders(params = {}) {
+    const searchParams = new URLSearchParams();
+    if (params.orderType) searchParams.set("orderType", params.orderType);
+    if (params.seller) searchParams.set("seller", params.seller);
+    if (params.sellToken) searchParams.set("sellToken", params.sellToken);
+    if (params.payToken) searchParams.set("payToken", params.payToken);
+    if (params.status) searchParams.set("status", params.status);
+    if (params.campaignId) searchParams.set("campaignId", params.campaignId);
+    if (params.page) searchParams.set("page", String(params.page));
+    if (params.pageSize) searchParams.set("pageSize", String(params.pageSize));
+    if (params.sortBy) searchParams.set("sortBy", params.sortBy);
+    if (params.sortOrder) searchParams.set("sortOrder", params.sortOrder);
+    searchParams.set("chainId", String(this.chainId));
+    return this.fetch(
+      `/v1/marketplace/orders?${searchParams.toString()}`
+    );
+  }
+  /**
+   * Get a single order by ID
+   */
+  async getOrder(orderId) {
+    return this.fetch(
+      `/v1/marketplace/orders/${orderId}?chainId=${this.chainId}`
+    );
+  }
+  /**
+   * Get order price quote
+   */
+  async getOrderQuote(orderId) {
+    return this.fetch(
+      `/v1/marketplace/orders/${orderId}/quote?chainId=${this.chainId}`
+    );
+  }
+  // ============================================================================
+  // Staking Queries
+  // ============================================================================
+  /**
+   * Get staking pools with optional filtering
+   */
+  async getStakingPools(params = {}) {
+    const searchParams = new URLSearchParams();
+    if (params.stakeToken) searchParams.set("stakeToken", params.stakeToken);
+    if (params.rewardToken) searchParams.set("rewardToken", params.rewardToken);
+    if (params.creator) searchParams.set("creator", params.creator);
+    if (params.isActive !== void 0)
+      searchParams.set("isActive", String(params.isActive));
+    if (params.page) searchParams.set("page", String(params.page));
+    if (params.pageSize) searchParams.set("pageSize", String(params.pageSize));
+    searchParams.set("chainId", String(this.chainId));
+    return this.fetch(
+      `/v1/staking/pools?${searchParams.toString()}`
+    );
+  }
+  /**
+   * Get a single staking pool by ID
+   */
+  async getStakingPool(poolId) {
+    return this.fetch(
+      `/v1/staking/pools/${poolId}?chainId=${this.chainId}`
+    );
+  }
+  /**
+   * Get stakers for a pool
+   */
+  async getPoolStakers(poolId, params = {}) {
+    const searchParams = new URLSearchParams();
+    searchParams.set("chainId", String(this.chainId));
+    if (params.page) searchParams.set("page", String(params.page));
+    if (params.pageSize) searchParams.set("pageSize", String(params.pageSize));
+    return this.fetch(
+      `/v1/staking/pools/${poolId}/stakers?${searchParams.toString()}`
+    );
+  }
+  // ============================================================================
+  // Wallet Queries
+  // ============================================================================
+  /**
+   * Get wallet activity summary
+   *
+   * @example
+   * ```typescript
+   * const activity = await sdk.api.getWalletActivity(address);
+   * console.log('Campaigns:', activity.campaigns.length);
+   * console.log('Open orders:', activity.openOrders.length);
+   * console.log('Stakes:', activity.stakes.length);
+   * ```
+   */
+  async getWalletActivity(address) {
+    return this.fetch(
+      `/v1/wallets/${address}?chainId=${this.chainId}`
+    );
+  }
+  /**
+   * Get wallet claims history
+   */
+  async getWalletClaims(address, params = {}) {
+    const searchParams = new URLSearchParams();
+    searchParams.set("chainId", String(this.chainId));
+    if (params.page) searchParams.set("page", String(params.page));
+    if (params.pageSize) searchParams.set("pageSize", String(params.pageSize));
+    return this.fetch(
+      `/v1/wallets/${address}/claims?${searchParams.toString()}`
+    );
+  }
+  /**
+   * Get wallet positions (campaigns where wallet has allocations)
+   */
+  async getWalletPositions(address) {
+    return this.fetch(
+      `/v1/wallets/${address}/positions?chainId=${this.chainId}`
+    );
+  }
+  // ============================================================================
+  // Token Queries
+  // ============================================================================
+  /**
+   * Search for tokens
+   *
+   * @example
+   * ```typescript
+   * const tokens = await sdk.api.searchTokens('USDC');
+   * ```
+   */
+  async searchTokens(query) {
+    return this.fetch(
+      `/v1/tokens?q=${encodeURIComponent(query)}&chainId=${this.chainId}`
+    );
+  }
+  /**
+   * Get token information by address
+   */
+  async getToken(address) {
+    return this.fetch(
+      `/v1/tokens/${address}?chainId=${this.chainId}`
+    );
+  }
+  /**
+   * Get token price
+   */
+  async getTokenPrice(address) {
+    return this.fetch(
+      `/v1/tokens/${address}/price?chainId=${this.chainId}`
+    );
+  }
+  // ============================================================================
+  // Health & Status
+  // ============================================================================
+  /**
+   * Check API health
+   */
+  async health() {
+    return this.fetch("/health");
+  }
+  /**
+   * Get supported chains
+   */
+  async getChains() {
+    return this.fetch("/v1/chains");
+  }
+  // ============================================================================
+  // Actions (Transaction Preparation)
+  // ============================================================================
+  /**
+   * Prepare a claim transaction
+   *
+   * Returns the calldata for a claim transaction.
+   */
+  async prepareClaimTx(params) {
+    return this.fetch("/v1/actions/claim", {
+      method: "POST",
+      body: JSON.stringify({
+        ...params,
+        chainId: this.chainId
+      })
+    });
+  }
+  /**
+   * Prepare a fill order transaction
+   */
+  async prepareFillOrderTx(params) {
+    return this.fetch("/v1/actions/fill-order", {
+      method: "POST",
+      body: JSON.stringify({
+        ...params,
+        chainId: this.chainId
+      })
+    });
+  }
+  // ============================================================================
+  // Helpers
+  // ============================================================================
+  async fetch(endpoint, options = {}) {
+    const url = `${this.baseUrl}${endpoint}`;
+    const response = await fetch(url, {
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+    if (!response.ok) {
+      const error = await response.text();
+      throw new ApiError(response.status, error);
+    }
+    return response.json();
+  }
+};
+var ApiError = class extends Error {
+  constructor(status, message) {
+    super(`API Error (${status}): ${message}`);
+    this.status = status;
+    this.name = "ApiError";
+  }
+};
+var api_default = ApiClient;
+
+export { ApiClient, ApiError, api_default as default };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/api/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/index.ts"],"names":[],"mappings":";AA+HO,IAAM,YAAN,MAAgB;AAAA,EACJ,OAAA;AAAA,EACA,OAAA;AAAA,EAEjB,WAAA,CAAY,SAAiB,OAAA,EAAiB;AAC5C,IAAA,IAAA,CAAK,OAAA,GAAU,QAAQ,QAAA,CAAS,GAAG,IAAI,OAAA,CAAQ,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,GAAI,OAAA;AAC9D,IAAA,IAAA,CAAK,OAAA,GAAU,OAAA;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,MAAM,YAAA,CACJ,MAAA,GAA8B,EAAC,EACU;AACzC,IAAA,MAAM,YAAA,GAAe,IAAI,eAAA,EAAgB;AAEzC,IAAA,IAAI,OAAO,IAAA,EAAM,YAAA,CAAa,GAAA,CAAI,MAAA,EAAQ,OAAO,IAAI,CAAA;AACrD,IAAA,IAAI,OAAO,OAAA,EAAS,YAAA,CAAa,GAAA,CAAI,SAAA,EAAW,OAAO,OAAO,CAAA;AAC9D,IAAA,IAAI,OAAO,KAAA,EAAO,YAAA,CAAa,GAAA,CAAI,OAAA,EAAS,OAAO,KAAK,CAAA;AACxD,IAAA,IAAI,OAAO,MAAA,EAAQ,YAAA,CAAa,GAAA,CAAI,QAAA,EAAU,OAAO,MAAM,CAAA;AAC3D,IAAA,IAAI,MAAA,CAAO,MAAM,YAAA,CAAa,GAAA,CAAI,QAAQ,MAAA,CAAO,MAAA,CAAO,IAAI,CAAC,CAAA;AAC7D,IAAA,IAAI,MAAA,CAAO,UAAU,YAAA,CAAa,GAAA,CAAI,YAAY,MAAA,CAAO,MAAA,CAAO,QAAQ,CAAC,CAAA;AACzE,IAAA,IAAI,OAAO,MAAA,EAAQ,YAAA,CAAa,GAAA,CAAI,QAAA,EAAU,OAAO,MAAM,CAAA;AAC3D,IAAA,IAAI,OAAO,SAAA,EAAW,YAAA,CAAa,GAAA,CAAI,WAAA,EAAa,OAAO,SAAS,CAAA;AAEpE,IAAA,YAAA,CAAa,GAAA,CAAI,SAAA,EAAW,MAAA,CAAO,IAAA,CAAK,OAAO,CAAC,CAAA;AAEhD,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,MACV,CAAA,cAAA,EAAiB,YAAA,CAAa,QAAA,EAAU,CAAA;AAAA,KAC1C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,YAAY,UAAA,EAA0C;AAC1D,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,MACV,CAAA,cAAA,EAAiB,UAAU,CAAA,SAAA,EAAY,IAAA,CAAK,OAAO,CAAA;AAAA,KACrD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,qBAAA,CACJ,UAAA,EACA,MAAA,GAA+C,EAAC,EAQhD;AACA,IAAA,MAAM,YAAA,GAAe,IAAI,eAAA,EAAgB;AACzC,IAAA,YAAA,CAAa,GAAA,CAAI,SAAA,EAAW,MAAA,CAAO,IAAA,CAAK,OAAO,CAAC,CAAA;AAChD,IAAA,IAAI,MAAA,CAAO,MAAM,YAAA,CAAa,GAAA,CAAI,QAAQ,MAAA,CAAO,MAAA,CAAO,IAAI,CAAC,CAAA;AAC7D,IAAA,IAAI,MAAA,CAAO,UAAU,YAAA,CAAa,GAAA,CAAI,YAAY,MAAA,CAAO,MAAA,CAAO,QAAQ,CAAC,CAAA;AAEzE,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,MACV,CAAA,cAAA,EAAiB,UAAU,CAAA,YAAA,EAAe,YAAA,CAAa,UAAU,CAAA;AAAA,KACnE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,mBAAA,CACJ,UAAA,EACA,MAAA,GAA+C,EAAC,EAQhD;AACA,IAAA,MAAM,YAAA,GAAe,IAAI,eAAA,EAAgB;AACzC,IAAA,YAAA,CAAa,GAAA,CAAI,SAAA,EAAW,MAAA,CAAO,IAAA,CAAK,OAAO,CAAC,CAAA;AAChD,IAAA,IAAI,MAAA,CAAO,MAAM,YAAA,CAAa,GAAA,CAAI,QAAQ,MAAA,CAAO,MAAA,CAAO,IAAI,CAAC,CAAA;AAC7D,IAAA,IAAI,MAAA,CAAO,UAAU,YAAA,CAAa,GAAA,CAAI,YAAY,MAAA,CAAO,MAAA,CAAO,QAAQ,CAAC,CAAA;AAEzE,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,MACV,CAAA,cAAA,EAAiB,UAAU,CAAA,UAAA,EAAa,YAAA,CAAa,UAAU,CAAA;AAAA,KACjE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,MAAM,SAAA,CACJ,MAAA,GAA2B,EAAC,EACU;AACtC,IAAA,MAAM,YAAA,GAAe,IAAI,eAAA,EAAgB;AAEzC,IAAA,IAAI,OAAO,SAAA,EAAW,YAAA,CAAa,GAAA,CAAI,WAAA,EAAa,OAAO,SAAS,CAAA;AACpE,IAAA,IAAI,OAAO,MAAA,EAAQ,YAAA,CAAa,GAAA,CAAI,QAAA,EAAU,OAAO,MAAM,CAAA;AAC3D,IAAA,IAAI,OAAO,SAAA,EAAW,YAAA,CAAa,GAAA,CAAI,WAAA,EAAa,OAAO,SAAS,CAAA;AACpE,IAAA,IAAI,OAAO,QAAA,EAAU,YAAA,CAAa,GAAA,CAAI,UAAA,EAAY,OAAO,QAAQ,CAAA;AACjE,IAAA,IAAI,OAAO,MAAA,EAAQ,YAAA,CAAa,GAAA,CAAI,QAAA,EAAU,OAAO,MAAM,CAAA;AAC3D,IAAA,IAAI,OAAO,UAAA,EAAY,YAAA,CAAa,GAAA,CAAI,YAAA,EAAc,OAAO,UAAU,CAAA;AACvE,IAAA,IAAI,MAAA,CAAO,MAAM,YAAA,CAAa,GAAA,CAAI,QAAQ,MAAA,CAAO,MAAA,CAAO,IAAI,CAAC,CAAA;AAC7D,IAAA,IAAI,MAAA,CAAO,UAAU,YAAA,CAAa,GAAA,CAAI,YAAY,MAAA,CAAO,MAAA,CAAO,QAAQ,CAAC,CAAA;AACzE,IAAA,IAAI,OAAO,MAAA,EAAQ,YAAA,CAAa,GAAA,CAAI,QAAA,EAAU,OAAO,MAAM,CAAA;AAC3D,IAAA,IAAI,OAAO,SAAA,EAAW,YAAA,CAAa,GAAA,CAAI,WAAA,EAAa,OAAO,SAAS,CAAA;AAEpE,IAAA,YAAA,CAAa,GAAA,CAAI,SAAA,EAAW,MAAA,CAAO,IAAA,CAAK,OAAO,CAAC,CAAA;AAEhD,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,MACV,CAAA,uBAAA,EAA0B,YAAA,CAAa,QAAA,EAAU,CAAA;AAAA,KACnD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,SAAS,OAAA,EAAoC;AACjD,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,MACV,CAAA,uBAAA,EAA0B,OAAO,CAAA,SAAA,EAAY,IAAA,CAAK,OAAO,CAAA;AAAA,KAC3D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,cAAc,OAAA,EAKjB;AACD,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,MACV,CAAA,uBAAA,EAA0B,OAAO,CAAA,eAAA,EAAkB,IAAA,CAAK,OAAO,CAAA;AAAA,KACjE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,eAAA,CACJ,MAAA,GAA0B,EAAC,EACiB;AAC5C,IAAA,MAAM,YAAA,GAAe,IAAI,eAAA,EAAgB;AAEzC,IAAA,IAAI,OAAO,UAAA,EAAY,YAAA,CAAa,GAAA,CAAI,YAAA,EAAc,OAAO,UAAU,CAAA;AACvE,IAAA,IAAI,OAAO,WAAA,EAAa,YAAA,CAAa,GAAA,CAAI,aAAA,EAAe,OAAO,WAAW,CAAA;AAC1E,IAAA,IAAI,OAAO,OAAA,EAAS,YAAA,CAAa,GAAA,CAAI,SAAA,EAAW,OAAO,OAAO,CAAA;AAC9D,IAAA,IAAI,OAAO,QAAA,KAAa,MAAA;AACtB,MAAA,YAAA,CAAa,GAAA,CAAI,UAAA,EAAY,MAAA,CAAO,MAAA,CAAO,QAAQ,CAAC,CAAA;AACtD,IAAA,IAAI,MAAA,CAAO,MAAM,YAAA,CAAa,GAAA,CAAI,QAAQ,MAAA,CAAO,MAAA,CAAO,IAAI,CAAC,CAAA;AAC7D,IAAA,IAAI,MAAA,CAAO,UAAU,YAAA,CAAa,GAAA,CAAI,YAAY,MAAA,CAAO,MAAA,CAAO,QAAQ,CAAC,CAAA;AAEzE,IAAA,YAAA,CAAa,GAAA,CAAI,SAAA,EAAW,MAAA,CAAO,IAAA,CAAK,OAAO,CAAC,CAAA;AAEhD,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,MACV,CAAA,kBAAA,EAAqB,YAAA,CAAa,QAAA,EAAU,CAAA;AAAA,KAC9C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAe,MAAA,EAAyC;AAC5D,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,MACV,CAAA,kBAAA,EAAqB,MAAM,CAAA,SAAA,EAAY,IAAA,CAAK,OAAO,CAAA;AAAA,KACrD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,cAAA,CACJ,MAAA,EACA,MAAA,GAA+C,EAAC,EAOhD;AACA,IAAA,MAAM,YAAA,GAAe,IAAI,eAAA,EAAgB;AACzC,IAAA,YAAA,CAAa,GAAA,CAAI,SAAA,EAAW,MAAA,CAAO,IAAA,CAAK,OAAO,CAAC,CAAA;AAChD,IAAA,IAAI,MAAA,CAAO,MAAM,YAAA,CAAa,GAAA,CAAI,QAAQ,MAAA,CAAO,MAAA,CAAO,IAAI,CAAC,CAAA;AAC7D,IAAA,IAAI,MAAA,CAAO,UAAU,YAAA,CAAa,GAAA,CAAI,YAAY,MAAA,CAAO,MAAA,CAAO,QAAQ,CAAC,CAAA;AAEzE,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,MACV,CAAA,kBAAA,EAAqB,MAAM,CAAA,SAAA,EAAY,YAAA,CAAa,UAAU,CAAA;AAAA,KAChE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,MAAM,kBAAkB,OAAA,EAA2C;AACjE,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,MACV,CAAA,YAAA,EAAe,OAAO,CAAA,SAAA,EAAY,IAAA,CAAK,OAAO,CAAA;AAAA,KAChD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,eAAA,CACJ,OAAA,EACA,MAAA,GAA+C,EAAC,EAQhD;AACA,IAAA,MAAM,YAAA,GAAe,IAAI,eAAA,EAAgB;AACzC,IAAA,YAAA,CAAa,GAAA,CAAI,SAAA,EAAW,MAAA,CAAO,IAAA,CAAK,OAAO,CAAC,CAAA;AAChD,IAAA,IAAI,MAAA,CAAO,MAAM,YAAA,CAAa,GAAA,CAAI,QAAQ,MAAA,CAAO,MAAA,CAAO,IAAI,CAAC,CAAA;AAC7D,IAAA,IAAI,MAAA,CAAO,UAAU,YAAA,CAAa,GAAA,CAAI,YAAY,MAAA,CAAO,MAAA,CAAO,QAAQ,CAAC,CAAA;AAEzE,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,MACV,CAAA,YAAA,EAAe,OAAO,CAAA,QAAA,EAAW,YAAA,CAAa,UAAU,CAAA;AAAA,KAC1D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,mBACJ,OAAA,EAWA;AACA,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,MACV,CAAA,YAAA,EAAe,OAAO,CAAA,mBAAA,EAAsB,IAAA,CAAK,OAAO,CAAA;AAAA,KAC1D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,MAAM,aAAa,KAAA,EAAqC;AACtD,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,MACV,gBAAgB,kBAAA,CAAmB,KAAK,CAAC,CAAA,SAAA,EAAY,KAAK,OAAO,CAAA;AAAA,KACnE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,SAAS,OAAA,EAAsC;AACnD,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,MACV,CAAA,WAAA,EAAc,OAAO,CAAA,SAAA,EAAY,IAAA,CAAK,OAAO,CAAA;AAAA,KAC/C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,cAAc,OAAA,EAIjB;AACD,IAAA,OAAO,IAAA,CAAK,KAAA;AAAA,MACV,CAAA,WAAA,EAAc,OAAO,CAAA,eAAA,EAAkB,IAAA,CAAK,OAAO,CAAA;AAAA,KACrD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,MAAA,GAKH;AACD,IAAA,OAAO,IAAA,CAAK,MAAM,SAAS,CAAA;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,SAAA,GAOJ;AACA,IAAA,OAAO,IAAA,CAAK,MAAM,YAAY,CAAA;AAAA,EAChC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,MAAM,eAAe,MAAA,EAQlB;AACD,IAAA,OAAO,IAAA,CAAK,MAAM,mBAAA,EAAqB;AAAA,MACrC,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,QACnB,GAAG,MAAA;AAAA,QACH,SAAS,IAAA,CAAK;AAAA,OACf;AAAA,KACF,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,mBAAmB,MAAA,EAOtB;AACD,IAAA,OAAO,IAAA,CAAK,MAAM,wBAAA,EAA0B;AAAA,MAC1C,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,QACnB,GAAG,MAAA;AAAA,QACH,SAAS,IAAA,CAAK;AAAA,OACf;AAAA,KACF,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,KAAA,CACZ,QAAA,EACA,OAAA,GAAuB,EAAC,EACZ;AACZ,IAAA,MAAM,GAAA,GAAM,CAAA,EAAG,IAAA,CAAK,OAAO,GAAG,QAAQ,CAAA,CAAA;AAEtC,IAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,MAChC,GAAG,OAAA;AAAA,MACH,OAAA,EAAS;AAAA,QACP,cAAA,EAAgB,kBAAA;AAAA,QAChB,GAAG,OAAA,CAAQ;AAAA;AACb,KACD,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,MAAM,KAAA,GAAQ,MAAM,QAAA,CAAS,IAAA,EAAK;AAClC,MAAA,MAAM,IAAI,QAAA,CAAS,QAAA,CAAS,MAAA,EAAQ,KAAK,CAAA;AAAA,IAC3C;AAEA,IAAA,OAAO,SAAS,IAAA,EAAK;AAAA,EACvB;AACF;AAKO,IAAM,QAAA,GAAN,cAAuB,KAAA,CAAM;AAAA,EAClC,WAAA,CACkB,QAChB,OAAA,EACA;AACA,IAAA,KAAA,CAAM,CAAA,WAAA,EAAc,MAAM,CAAA,GAAA,EAAM,OAAO,CAAA,CAAE,CAAA;AAHzB,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAIhB,IAAA,IAAA,CAAK,IAAA,GAAO,UAAA;AAAA,EACd;AACF;AAEA,IAAO,WAAA,GAAQ","file":"index.mjs","sourcesContent":["/**\r\n * API Client Module\r\n *\r\n * Provides methods for querying indexed blockchain data:\r\n * - Campaign queries\r\n * - Order queries\r\n * - Wallet activity\r\n * - Token information\r\n * - Staking pool queries\r\n */\r\nimport type { Address } from 'viem';\r\nimport type {\r\n  ApiCampaign,\r\n  ApiOrder,\r\n  ApiStakingPool,\r\n  PaginatedResponse,\r\n} from '../types';\r\n\r\n/**\r\n * Query parameters for campaigns\r\n */\r\nexport interface CampaignQueryParams {\r\n  /** Filter by campaign kind */\r\n  kind?: 'instant_airdrop' | 'vested_airdrop' | 'lock' | 'vesting';\r\n  /** Filter by creator address */\r\n  creator?: Address;\r\n  /** Filter by token address */\r\n  token?: Address;\r\n  /** Filter by status */\r\n  status?: 'active' | 'paused' | 'finalized';\r\n  /** Page number (1-indexed) */\r\n  page?: number;\r\n  /** Items per page */\r\n  pageSize?: number;\r\n  /** Sort field */\r\n  sortBy?: 'createdAt' | 'totalAllocated' | 'recipientCount';\r\n  /** Sort direction */\r\n  sortOrder?: 'asc' | 'desc';\r\n}\r\n\r\n/**\r\n * Query parameters for orders\r\n */\r\nexport interface OrderQueryParams {\r\n  /** Filter by order type */\r\n  orderType?: 'instant' | 'vested' | 'tradable';\r\n  /** Filter by seller */\r\n  seller?: Address;\r\n  /** Filter by sell token */\r\n  sellToken?: Address;\r\n  /** Filter by pay token */\r\n  payToken?: Address;\r\n  /** Filter by status */\r\n  status?: 'open' | 'filled' | 'canceled' | 'expired';\r\n  /** Filter by campaign (for tradable) */\r\n  campaignId?: string;\r\n  /** Page number */\r\n  page?: number;\r\n  /** Items per page */\r\n  pageSize?: number;\r\n  /** Sort field */\r\n  sortBy?: 'createdAt' | 'totalPrice' | 'expiresAt';\r\n  /** Sort direction */\r\n  sortOrder?: 'asc' | 'desc';\r\n}\r\n\r\n/**\r\n * Query parameters for staking pools\r\n */\r\nexport interface PoolQueryParams {\r\n  /** Filter by stake token */\r\n  stakeToken?: Address;\r\n  /** Filter by reward token */\r\n  rewardToken?: Address;\r\n  /** Filter by creator */\r\n  creator?: Address;\r\n  /** Filter by active status */\r\n  isActive?: boolean;\r\n  /** Page number */\r\n  page?: number;\r\n  /** Items per page */\r\n  pageSize?: number;\r\n}\r\n\r\n/**\r\n * Wallet activity summary\r\n */\r\nexport interface WalletActivity {\r\n  address: Address;\r\n  /** Campaigns where wallet is a recipient */\r\n  campaigns: {\r\n    id: string;\r\n    kind: string;\r\n    allocated: string;\r\n    claimed: string;\r\n    due: string;\r\n  }[];\r\n  /** Open orders created by wallet */\r\n  openOrders: ApiOrder[];\r\n  /** Staking positions */\r\n  stakes: {\r\n    poolId: string;\r\n    amount: string;\r\n    pendingRewards: string;\r\n  }[];\r\n  /** Total value across all positions (in USD if available) */\r\n  totalValue?: string;\r\n}\r\n\r\n/**\r\n * Token information from enrichment\r\n */\r\nexport interface TokenInfo {\r\n  address: Address;\r\n  chainId: number;\r\n  symbol: string;\r\n  name: string;\r\n  decimals: number;\r\n  logoUrl?: string;\r\n  priceUsd?: string;\r\n  marketCap?: string;\r\n  volume24h?: string;\r\n}\r\n\r\n/**\r\n * API client for indexed blockchain data\r\n */\r\nexport class ApiClient {\r\n  private readonly baseUrl: string;\r\n  private readonly chainId: number;\r\n\r\n  constructor(baseUrl: string, chainId: number) {\r\n    this.baseUrl = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\r\n    this.chainId = chainId;\r\n  }\r\n\r\n  // ============================================================================\r\n  // Campaign Queries\r\n  // ============================================================================\r\n\r\n  /**\r\n   * Get campaigns with optional filtering\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const campaigns = await sdk.api.getCampaigns({\r\n   *   kind: 'vested_airdrop',\r\n   *   status: 'active',\r\n   *   page: 1,\r\n   *   pageSize: 20,\r\n   * });\r\n   * ```\r\n   */\r\n  async getCampaigns(\r\n    params: CampaignQueryParams = {}\r\n  ): Promise<PaginatedResponse<ApiCampaign>> {\r\n    const searchParams = new URLSearchParams();\r\n\r\n    if (params.kind) searchParams.set('kind', params.kind);\r\n    if (params.creator) searchParams.set('creator', params.creator);\r\n    if (params.token) searchParams.set('token', params.token);\r\n    if (params.status) searchParams.set('status', params.status);\r\n    if (params.page) searchParams.set('page', String(params.page));\r\n    if (params.pageSize) searchParams.set('pageSize', String(params.pageSize));\r\n    if (params.sortBy) searchParams.set('sortBy', params.sortBy);\r\n    if (params.sortOrder) searchParams.set('sortOrder', params.sortOrder);\r\n\r\n    searchParams.set('chainId', String(this.chainId));\r\n\r\n    return this.fetch<PaginatedResponse<ApiCampaign>>(\r\n      `/v1/campaigns?${searchParams.toString()}`\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Get a single campaign by ID\r\n   */\r\n  async getCampaign(campaignId: string): Promise<ApiCampaign> {\r\n    return this.fetch<ApiCampaign>(\r\n      `/v1/campaigns/${campaignId}?chainId=${this.chainId}`\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Get campaign recipients\r\n   */\r\n  async getCampaignRecipients(\r\n    campaignId: string,\r\n    params: { page?: number; pageSize?: number } = {}\r\n  ): Promise<\r\n    PaginatedResponse<{\r\n      address: Address;\r\n      allocated: string;\r\n      claimed: string;\r\n      blocked: boolean;\r\n    }>\r\n  > {\r\n    const searchParams = new URLSearchParams();\r\n    searchParams.set('chainId', String(this.chainId));\r\n    if (params.page) searchParams.set('page', String(params.page));\r\n    if (params.pageSize) searchParams.set('pageSize', String(params.pageSize));\r\n\r\n    return this.fetch(\r\n      `/v1/campaigns/${campaignId}/recipients?${searchParams.toString()}`\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Get campaign activity/claims\r\n   */\r\n  async getCampaignActivity(\r\n    campaignId: string,\r\n    params: { page?: number; pageSize?: number } = {}\r\n  ): Promise<\r\n    PaginatedResponse<{\r\n      recipient: Address;\r\n      amount: string;\r\n      timestamp: string;\r\n      txHash: string;\r\n    }>\r\n  > {\r\n    const searchParams = new URLSearchParams();\r\n    searchParams.set('chainId', String(this.chainId));\r\n    if (params.page) searchParams.set('page', String(params.page));\r\n    if (params.pageSize) searchParams.set('pageSize', String(params.pageSize));\r\n\r\n    return this.fetch(\r\n      `/v1/campaigns/${campaignId}/activity?${searchParams.toString()}`\r\n    );\r\n  }\r\n\r\n  // ============================================================================\r\n  // Order Queries\r\n  // ============================================================================\r\n\r\n  /**\r\n   * Get marketplace orders with optional filtering\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const orders = await sdk.api.getOrders({\r\n   *   orderType: 'tradable',\r\n   *   status: 'open',\r\n   *   sortBy: 'totalPrice',\r\n   *   sortOrder: 'asc',\r\n   * });\r\n   * ```\r\n   */\r\n  async getOrders(\r\n    params: OrderQueryParams = {}\r\n  ): Promise<PaginatedResponse<ApiOrder>> {\r\n    const searchParams = new URLSearchParams();\r\n\r\n    if (params.orderType) searchParams.set('orderType', params.orderType);\r\n    if (params.seller) searchParams.set('seller', params.seller);\r\n    if (params.sellToken) searchParams.set('sellToken', params.sellToken);\r\n    if (params.payToken) searchParams.set('payToken', params.payToken);\r\n    if (params.status) searchParams.set('status', params.status);\r\n    if (params.campaignId) searchParams.set('campaignId', params.campaignId);\r\n    if (params.page) searchParams.set('page', String(params.page));\r\n    if (params.pageSize) searchParams.set('pageSize', String(params.pageSize));\r\n    if (params.sortBy) searchParams.set('sortBy', params.sortBy);\r\n    if (params.sortOrder) searchParams.set('sortOrder', params.sortOrder);\r\n\r\n    searchParams.set('chainId', String(this.chainId));\r\n\r\n    return this.fetch<PaginatedResponse<ApiOrder>>(\r\n      `/v1/marketplace/orders?${searchParams.toString()}`\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Get a single order by ID\r\n   */\r\n  async getOrder(orderId: string): Promise<ApiOrder> {\r\n    return this.fetch<ApiOrder>(\r\n      `/v1/marketplace/orders/${orderId}?chainId=${this.chainId}`\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Get order price quote\r\n   */\r\n  async getOrderQuote(orderId: string): Promise<{\r\n    totalPrice: string;\r\n    protocolFee: string;\r\n    sellerReceives: string;\r\n    isValid: boolean;\r\n  }> {\r\n    return this.fetch(\r\n      `/v1/marketplace/orders/${orderId}/quote?chainId=${this.chainId}`\r\n    );\r\n  }\r\n\r\n  // ============================================================================\r\n  // Staking Queries\r\n  // ============================================================================\r\n\r\n  /**\r\n   * Get staking pools with optional filtering\r\n   */\r\n  async getStakingPools(\r\n    params: PoolQueryParams = {}\r\n  ): Promise<PaginatedResponse<ApiStakingPool>> {\r\n    const searchParams = new URLSearchParams();\r\n\r\n    if (params.stakeToken) searchParams.set('stakeToken', params.stakeToken);\r\n    if (params.rewardToken) searchParams.set('rewardToken', params.rewardToken);\r\n    if (params.creator) searchParams.set('creator', params.creator);\r\n    if (params.isActive !== undefined)\r\n      searchParams.set('isActive', String(params.isActive));\r\n    if (params.page) searchParams.set('page', String(params.page));\r\n    if (params.pageSize) searchParams.set('pageSize', String(params.pageSize));\r\n\r\n    searchParams.set('chainId', String(this.chainId));\r\n\r\n    return this.fetch<PaginatedResponse<ApiStakingPool>>(\r\n      `/v1/staking/pools?${searchParams.toString()}`\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Get a single staking pool by ID\r\n   */\r\n  async getStakingPool(poolId: string): Promise<ApiStakingPool> {\r\n    return this.fetch<ApiStakingPool>(\r\n      `/v1/staking/pools/${poolId}?chainId=${this.chainId}`\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Get stakers for a pool\r\n   */\r\n  async getPoolStakers(\r\n    poolId: string,\r\n    params: { page?: number; pageSize?: number } = {}\r\n  ): Promise<\r\n    PaginatedResponse<{\r\n      address: Address;\r\n      amount: string;\r\n      pendingRewards: string;\r\n    }>\r\n  > {\r\n    const searchParams = new URLSearchParams();\r\n    searchParams.set('chainId', String(this.chainId));\r\n    if (params.page) searchParams.set('page', String(params.page));\r\n    if (params.pageSize) searchParams.set('pageSize', String(params.pageSize));\r\n\r\n    return this.fetch(\r\n      `/v1/staking/pools/${poolId}/stakers?${searchParams.toString()}`\r\n    );\r\n  }\r\n\r\n  // ============================================================================\r\n  // Wallet Queries\r\n  // ============================================================================\r\n\r\n  /**\r\n   * Get wallet activity summary\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const activity = await sdk.api.getWalletActivity(address);\r\n   * console.log('Campaigns:', activity.campaigns.length);\r\n   * console.log('Open orders:', activity.openOrders.length);\r\n   * console.log('Stakes:', activity.stakes.length);\r\n   * ```\r\n   */\r\n  async getWalletActivity(address: Address): Promise<WalletActivity> {\r\n    return this.fetch<WalletActivity>(\r\n      `/v1/wallets/${address}?chainId=${this.chainId}`\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Get wallet claims history\r\n   */\r\n  async getWalletClaims(\r\n    address: Address,\r\n    params: { page?: number; pageSize?: number } = {}\r\n  ): Promise<\r\n    PaginatedResponse<{\r\n      campaignId: string;\r\n      amount: string;\r\n      timestamp: string;\r\n      txHash: string;\r\n    }>\r\n  > {\r\n    const searchParams = new URLSearchParams();\r\n    searchParams.set('chainId', String(this.chainId));\r\n    if (params.page) searchParams.set('page', String(params.page));\r\n    if (params.pageSize) searchParams.set('pageSize', String(params.pageSize));\r\n\r\n    return this.fetch(\r\n      `/v1/wallets/${address}/claims?${searchParams.toString()}`\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Get wallet positions (campaigns where wallet has allocations)\r\n   */\r\n  async getWalletPositions(\r\n    address: Address\r\n  ): Promise<\r\n    {\r\n      campaignId: string;\r\n      kind: string;\r\n      token: Address;\r\n      allocated: string;\r\n      claimed: string;\r\n      due: string;\r\n      vestingProgress: number;\r\n    }[]\r\n  > {\r\n    return this.fetch(\r\n      `/v1/wallets/${address}/positions?chainId=${this.chainId}`\r\n    );\r\n  }\r\n\r\n  // ============================================================================\r\n  // Token Queries\r\n  // ============================================================================\r\n\r\n  /**\r\n   * Search for tokens\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const tokens = await sdk.api.searchTokens('USDC');\r\n   * ```\r\n   */\r\n  async searchTokens(query: string): Promise<TokenInfo[]> {\r\n    return this.fetch<TokenInfo[]>(\r\n      `/v1/tokens?q=${encodeURIComponent(query)}&chainId=${this.chainId}`\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Get token information by address\r\n   */\r\n  async getToken(address: Address): Promise<TokenInfo> {\r\n    return this.fetch<TokenInfo>(\r\n      `/v1/tokens/${address}?chainId=${this.chainId}`\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Get token price\r\n   */\r\n  async getTokenPrice(address: Address): Promise<{\r\n    priceUsd: string;\r\n    priceChange24h: string;\r\n    timestamp: string;\r\n  }> {\r\n    return this.fetch(\r\n      `/v1/tokens/${address}/price?chainId=${this.chainId}`\r\n    );\r\n  }\r\n\r\n  // ============================================================================\r\n  // Health & Status\r\n  // ============================================================================\r\n\r\n  /**\r\n   * Check API health\r\n   */\r\n  async health(): Promise<{\r\n    status: 'ok' | 'degraded' | 'down';\r\n    indexerBlockHeight: number;\r\n    chainBlockHeight: number;\r\n    lag: number;\r\n  }> {\r\n    return this.fetch('/health');\r\n  }\r\n\r\n  /**\r\n   * Get supported chains\r\n   */\r\n  async getChains(): Promise<\r\n    {\r\n      chainId: number;\r\n      name: string;\r\n      rpcUrl: string;\r\n      diamondAddress: Address;\r\n    }[]\r\n  > {\r\n    return this.fetch('/v1/chains');\r\n  }\r\n\r\n  // ============================================================================\r\n  // Actions (Transaction Preparation)\r\n  // ============================================================================\r\n\r\n  /**\r\n   * Prepare a claim transaction\r\n   *\r\n   * Returns the calldata for a claim transaction.\r\n   */\r\n  async prepareClaimTx(params: {\r\n    campaignId: string;\r\n    recipient: Address;\r\n  }): Promise<{\r\n    to: Address;\r\n    data: `0x${string}`;\r\n    value: string;\r\n    estimatedGas: string;\r\n  }> {\r\n    return this.fetch('/v1/actions/claim', {\r\n      method: 'POST',\r\n      body: JSON.stringify({\r\n        ...params,\r\n        chainId: this.chainId,\r\n      }),\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Prepare a fill order transaction\r\n   */\r\n  async prepareFillOrderTx(params: {\r\n    orderId: string;\r\n  }): Promise<{\r\n    to: Address;\r\n    data: `0x${string}`;\r\n    value: string;\r\n    estimatedGas: string;\r\n  }> {\r\n    return this.fetch('/v1/actions/fill-order', {\r\n      method: 'POST',\r\n      body: JSON.stringify({\r\n        ...params,\r\n        chainId: this.chainId,\r\n      }),\r\n    });\r\n  }\r\n\r\n  // ============================================================================\r\n  // Helpers\r\n  // ============================================================================\r\n\r\n  private async fetch<T>(\r\n    endpoint: string,\r\n    options: RequestInit = {}\r\n  ): Promise<T> {\r\n    const url = `${this.baseUrl}${endpoint}`;\r\n\r\n    const response = await fetch(url, {\r\n      ...options,\r\n      headers: {\r\n        'Content-Type': 'application/json',\r\n        ...options.headers,\r\n      },\r\n    });\r\n\r\n    if (!response.ok) {\r\n      const error = await response.text();\r\n      throw new ApiError(response.status, error);\r\n    }\r\n\r\n    return response.json() as Promise<T>;\r\n  }\r\n}\r\n\r\n/**\r\n * API error class\r\n */\r\nexport class ApiError extends Error {\r\n  constructor(\r\n    public readonly status: number,\r\n    message: string\r\n  ) {\r\n    super(`API Error (${status}): ${message}`);\r\n    this.name = 'ApiError';\r\n  }\r\n}\r\n\r\nexport default ApiClient;\r\n"]}

package/dist/automation/index.d.mts

@@ -0,0 +1,140 @@
+import { PublicClient, WalletClient, Address } from 'viem';
+import { E as EnableAutoWithdrawParams, T as TransactionResult, h as EnableAutoReleaseParams, A as AutomationStatus } from '../index-BTG0TRJt.mjs';
+
+/**
+ * Automation Module
+ *
+ * Provides methods for keeper automation:
+ * - Enable/disable auto-withdraw for vesting campaigns
+ * - Enable/disable auto-release for locks
+ * - Query automation status
+ */
+
+/**
+ * Automation module for keeper-powered operations
+ */
+declare class AutomationModule {
+    private readonly publicClient;
+    private readonly walletClient;
+    private readonly diamondAddress;
+    constructor(publicClient: PublicClient, walletClient: WalletClient | undefined, diamondAddress: Address);
+    /**
+     * Enable auto-withdraw for a vesting campaign
+     *
+     * Keepers will automatically claim vested tokens on behalf of recipients.
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.automation.enableAutoWithdraw({
+     *   campaignId: 1n,
+     *   frequency: 7 * 24 * 60 * 60, // Weekly
+     *   tipAmount: parseEther('0.1'), // 0.1 ETH for keeper
+     * });
+     * ```
+     */
+    enableAutoWithdraw(params: EnableAutoWithdrawParams): Promise<TransactionResult>;
+    /**
+     * Disable auto-withdraw for a campaign
+     *
+     * Returns remaining tip balance to caller.
+     */
+    disableAutoWithdraw(campaignId: bigint): Promise<TransactionResult>;
+    /**
+     * Enable auto-release for a lock campaign
+     *
+     * Keepers will automatically release tokens when unlock time passes.
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.automation.enableAutoRelease({
+     *   campaignId: 5n,
+     *   frequency: 3600, // Check every hour
+     *   tipAmount: parseEther('0.05'), // 0.05 ETH for keeper
+     * });
+     * ```
+     */
+    enableAutoRelease(params: EnableAutoReleaseParams & {
+        frequency?: number;
+    }): Promise<TransactionResult>;
+    /**
+     * Disable auto-release for a lock campaign
+     */
+    disableAutoRelease(campaignId: bigint): Promise<TransactionResult>;
+    /**
+     * Get auto-withdraw status for a campaign
+     *
+     * @example
+     * ```typescript
+     * const status = await sdk.automation.getAutoWithdrawStatus(campaignId);
+     * console.log('Enabled:', status.enabled);
+     * console.log('Next run:', new Date(status.nextRun * 1000));
+     * console.log('Tip balance:', formatEther(status.tipBalance));
+     * ```
+     */
+    getAutoWithdrawStatus(campaignId: bigint): Promise<AutomationStatus>;
+    /**
+     * Get auto-release status for a lock campaign
+     */
+    getAutoReleaseStatus(campaignId: bigint): Promise<{
+        enabled: boolean;
+        frequency: number;
+        lastRun: number;
+        nextRun: number;
+    }>;
+    /**
+     * Preview automation for specific recipients
+     */
+    previewAutomation(campaignId: bigint, recipients: Address[]): Promise<{
+        pendingCount: bigint;
+        nextFeeWei: bigint;
+        escrowWei: bigint;
+    }>;
+    /**
+     * Get automation run statistics
+     */
+    getAutomationStats(campaignId: bigint, lockMode?: boolean): Promise<{
+        runsObserved: number;
+        avgRecipientsPerRun: number;
+        lastRecipientsProcessed: number;
+        maxRecipientsPerRun: number;
+    }>;
+    /**
+     * Check if auto-withdraw is currently runnable
+     *
+     * Returns true if cooldown has passed and there are pending recipients.
+     */
+    isAutoWithdrawRunnable(campaignId: bigint): Promise<boolean>;
+    /**
+     * Check if auto-release is currently runnable
+     */
+    isAutoReleaseRunnable(campaignId: bigint): Promise<boolean>;
+    /**
+     * Execute auto-withdraw for specific recipients (keeper only)
+     *
+     * @example
+     * ```typescript
+     * // Get recipients from registry or external source
+     * const recipients = ['0x...', '0x...', '0x...'];
+     * await sdk.automation.executeAutoWithdraw(campaignId, recipients);
+     * ```
+     */
+    executeAutoWithdraw(campaignId: bigint, recipients: Address[]): Promise<TransactionResult>;
+    /**
+     * Execute auto-withdraw using registry cursor (keeper only)
+     *
+     * Processes up to batchSize recipients from the registry.
+     */
+    executeAutoWithdrawNext(campaignId: bigint, batchSize?: number): Promise<TransactionResult>;
+    /**
+     * Execute auto-release for specific recipients (keeper only)
+     */
+    executeAutoRelease(campaignId: bigint, recipients: Address[]): Promise<TransactionResult>;
+    /**
+     * Execute auto-release using registry cursor (keeper only)
+     */
+    executeAutoReleaseNext(campaignId: bigint, batchSize?: number): Promise<TransactionResult>;
+    private requireWallet;
+    private createTransactionResult;
+}
+
+export { AutomationModule, AutomationModule as default };

package/dist/automation/index.d.ts

@@ -0,0 +1,140 @@
+import { PublicClient, WalletClient, Address } from 'viem';
+import { E as EnableAutoWithdrawParams, T as TransactionResult, h as EnableAutoReleaseParams, A as AutomationStatus } from '../index-BTG0TRJt.js';
+
+/**
+ * Automation Module
+ *
+ * Provides methods for keeper automation:
+ * - Enable/disable auto-withdraw for vesting campaigns
+ * - Enable/disable auto-release for locks
+ * - Query automation status
+ */
+
+/**
+ * Automation module for keeper-powered operations
+ */
+declare class AutomationModule {
+    private readonly publicClient;
+    private readonly walletClient;
+    private readonly diamondAddress;
+    constructor(publicClient: PublicClient, walletClient: WalletClient | undefined, diamondAddress: Address);
+    /**
+     * Enable auto-withdraw for a vesting campaign
+     *
+     * Keepers will automatically claim vested tokens on behalf of recipients.
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.automation.enableAutoWithdraw({
+     *   campaignId: 1n,
+     *   frequency: 7 * 24 * 60 * 60, // Weekly
+     *   tipAmount: parseEther('0.1'), // 0.1 ETH for keeper
+     * });
+     * ```
+     */
+    enableAutoWithdraw(params: EnableAutoWithdrawParams): Promise<TransactionResult>;
+    /**
+     * Disable auto-withdraw for a campaign
+     *
+     * Returns remaining tip balance to caller.
+     */
+    disableAutoWithdraw(campaignId: bigint): Promise<TransactionResult>;
+    /**
+     * Enable auto-release for a lock campaign
+     *
+     * Keepers will automatically release tokens when unlock time passes.
+     *
+     * @example
+     * ```typescript
+     * const result = await sdk.automation.enableAutoRelease({
+     *   campaignId: 5n,
+     *   frequency: 3600, // Check every hour
+     *   tipAmount: parseEther('0.05'), // 0.05 ETH for keeper
+     * });
+     * ```
+     */
+    enableAutoRelease(params: EnableAutoReleaseParams & {
+        frequency?: number;
+    }): Promise<TransactionResult>;
+    /**
+     * Disable auto-release for a lock campaign
+     */
+    disableAutoRelease(campaignId: bigint): Promise<TransactionResult>;
+    /**
+     * Get auto-withdraw status for a campaign
+     *
+     * @example
+     * ```typescript
+     * const status = await sdk.automation.getAutoWithdrawStatus(campaignId);
+     * console.log('Enabled:', status.enabled);
+     * console.log('Next run:', new Date(status.nextRun * 1000));
+     * console.log('Tip balance:', formatEther(status.tipBalance));
+     * ```
+     */
+    getAutoWithdrawStatus(campaignId: bigint): Promise<AutomationStatus>;
+    /**
+     * Get auto-release status for a lock campaign
+     */
+    getAutoReleaseStatus(campaignId: bigint): Promise<{
+        enabled: boolean;
+        frequency: number;
+        lastRun: number;
+        nextRun: number;
+    }>;
+    /**
+     * Preview automation for specific recipients
+     */
+    previewAutomation(campaignId: bigint, recipients: Address[]): Promise<{
+        pendingCount: bigint;
+        nextFeeWei: bigint;
+        escrowWei: bigint;
+    }>;
+    /**
+     * Get automation run statistics
+     */
+    getAutomationStats(campaignId: bigint, lockMode?: boolean): Promise<{
+        runsObserved: number;
+        avgRecipientsPerRun: number;
+        lastRecipientsProcessed: number;
+        maxRecipientsPerRun: number;
+    }>;
+    /**
+     * Check if auto-withdraw is currently runnable
+     *
+     * Returns true if cooldown has passed and there are pending recipients.
+     */
+    isAutoWithdrawRunnable(campaignId: bigint): Promise<boolean>;
+    /**
+     * Check if auto-release is currently runnable
+     */
+    isAutoReleaseRunnable(campaignId: bigint): Promise<boolean>;
+    /**
+     * Execute auto-withdraw for specific recipients (keeper only)
+     *
+     * @example
+     * ```typescript
+     * // Get recipients from registry or external source
+     * const recipients = ['0x...', '0x...', '0x...'];
+     * await sdk.automation.executeAutoWithdraw(campaignId, recipients);
+     * ```
+     */
+    executeAutoWithdraw(campaignId: bigint, recipients: Address[]): Promise<TransactionResult>;
+    /**
+     * Execute auto-withdraw using registry cursor (keeper only)
+     *
+     * Processes up to batchSize recipients from the registry.
+     */
+    executeAutoWithdrawNext(campaignId: bigint, batchSize?: number): Promise<TransactionResult>;
+    /**
+     * Execute auto-release for specific recipients (keeper only)
+     */
+    executeAutoRelease(campaignId: bigint, recipients: Address[]): Promise<TransactionResult>;
+    /**
+     * Execute auto-release using registry cursor (keeper only)
+     */
+    executeAutoReleaseNext(campaignId: bigint, batchSize?: number): Promise<TransactionResult>;
+    private requireWallet;
+    private createTransactionResult;
+}
+
+export { AutomationModule, AutomationModule as default };