@layr-labs/ecloud-sdk 1.0.0-devep7 → 1.0.0

package/dist/billing.d.cts

@@ -1,5 +1,5 @@
 import { Address, Hex, WalletClient, PublicClient } from 'viem';
-import { a6 as SubscriptionOpts, a4 as SubscribeResponse, a0 as ProductSubscriptionResponse, g as CancelResponse, M as PaymentMethodsResponse, m as CreditPurchaseResponse } from './index-XhjPvHIY.cjs';
+import { ai as SubscriptionOpts, ag as SubscribeResponse, ab as ProductSubscriptionResponse, k as CancelResponse, Z as PaymentMethodsResponse, s as CreditPurchaseResponse, ac as RedeemCouponResponse } from './index-BVnxNfqb.cjs';
 
 /**
  * Main Billing namespace entry point
@@ -8,11 +8,14 @@ import { a6 as SubscriptionOpts, a4 as SubscribeResponse, a0 as ProductSubscript
  * (privateKeyToAccount) and external signers (MetaMask, etc.).
  */
 
+type BillingChain = "ethereum" | "base";
 interface TopUpOpts {
     /** Amount in raw USDC units (6 decimals, e.g. 50_000_000n = 50 USDC) */
     amount: bigint;
     /** Target account for purchaseCreditsFor (defaults to wallet address) */
     account?: Address;
+    /** Which blockchain to transact on (defaults to "ethereum") */
+    chain?: BillingChain;
 }
 interface TopUpResult {
     txHash: Hex;
@@ -30,11 +33,16 @@ interface BillingModule {
     getStatus: (opts?: SubscriptionOpts) => Promise<ProductSubscriptionResponse>;
     cancel: (opts?: SubscriptionOpts) => Promise<CancelResponse>;
     /** Read on-chain state needed for top-up */
-    getTopUpInfo: () => Promise<TopUpInfo>;
+    getTopUpInfo: (opts?: {
+        chain?: BillingChain;
+    }) => Promise<TopUpInfo>;
     /** Purchase credits with USDC on-chain */
     topUp: (opts: TopUpOpts) => Promise<TopUpResult>;
     getPaymentMethods: () => Promise<PaymentMethodsResponse>;
     purchaseCredits: (amountCents: number, paymentMethodId?: string) => Promise<CreditPurchaseResponse>;
+    /** Check if Base chain is configured for this environment */
+    hasBaseSupport: () => boolean;
+    redeemCoupon: (code: string) => Promise<RedeemCouponResponse>;
 }
 interface BillingModuleConfig {
     verbose?: boolean;
@@ -42,7 +50,8 @@ interface BillingModuleConfig {
     skipTelemetry?: boolean;
     publicClient: PublicClient;
     environment: string;
+    privateKey?: Hex;
 }
 declare function createBillingModule(config: BillingModuleConfig): BillingModule;
 
-export { type BillingModule, type BillingModuleConfig, type TopUpInfo, type TopUpOpts, type TopUpResult, createBillingModule };
+export { type BillingChain, type BillingModule, type BillingModuleConfig, type TopUpInfo, type TopUpOpts, type TopUpResult, createBillingModule };

package/dist/billing.d.ts

@@ -1,5 +1,5 @@
 import { Address, Hex, WalletClient, PublicClient } from 'viem';
-import { a6 as SubscriptionOpts, a4 as SubscribeResponse, a0 as ProductSubscriptionResponse, g as CancelResponse, M as PaymentMethodsResponse, m as CreditPurchaseResponse } from './index-XhjPvHIY.js';
+import { ai as SubscriptionOpts, ag as SubscribeResponse, ab as ProductSubscriptionResponse, k as CancelResponse, Z as PaymentMethodsResponse, s as CreditPurchaseResponse, ac as RedeemCouponResponse } from './index-BVnxNfqb.js';
 
 /**
  * Main Billing namespace entry point
@@ -8,11 +8,14 @@ import { a6 as SubscriptionOpts, a4 as SubscribeResponse, a0 as ProductSubscript
  * (privateKeyToAccount) and external signers (MetaMask, etc.).
  */
 
+type BillingChain = "ethereum" | "base";
 interface TopUpOpts {
     /** Amount in raw USDC units (6 decimals, e.g. 50_000_000n = 50 USDC) */
     amount: bigint;
     /** Target account for purchaseCreditsFor (defaults to wallet address) */
     account?: Address;
+    /** Which blockchain to transact on (defaults to "ethereum") */
+    chain?: BillingChain;
 }
 interface TopUpResult {
     txHash: Hex;
@@ -30,11 +33,16 @@ interface BillingModule {
     getStatus: (opts?: SubscriptionOpts) => Promise<ProductSubscriptionResponse>;
     cancel: (opts?: SubscriptionOpts) => Promise<CancelResponse>;
     /** Read on-chain state needed for top-up */
-    getTopUpInfo: () => Promise<TopUpInfo>;
+    getTopUpInfo: (opts?: {
+        chain?: BillingChain;
+    }) => Promise<TopUpInfo>;
     /** Purchase credits with USDC on-chain */
     topUp: (opts: TopUpOpts) => Promise<TopUpResult>;
     getPaymentMethods: () => Promise<PaymentMethodsResponse>;
     purchaseCredits: (amountCents: number, paymentMethodId?: string) => Promise<CreditPurchaseResponse>;
+    /** Check if Base chain is configured for this environment */
+    hasBaseSupport: () => boolean;
+    redeemCoupon: (code: string) => Promise<RedeemCouponResponse>;
 }
 interface BillingModuleConfig {
     verbose?: boolean;
@@ -42,7 +50,8 @@ interface BillingModuleConfig {
     skipTelemetry?: boolean;
     publicClient: PublicClient;
     environment: string;
+    privateKey?: Hex;
 }
 declare function createBillingModule(config: BillingModuleConfig): BillingModule;
 
-export { type BillingModule, type BillingModuleConfig, type TopUpInfo, type TopUpOpts, type TopUpResult, createBillingModule };
+export { type BillingChain, type BillingModule, type BillingModuleConfig, type TopUpInfo, type TopUpOpts, type TopUpResult, createBillingModule };

package/dist/billing.js

@@ -298,6 +298,63 @@ var BillingApiClient = class {
     return resp.json();
   }
   // ==========================================================================
+  // Admin - Coupon Methods
+  // ==========================================================================
+  async createCoupon(amountCents) {
+    const endpoint = `${this.config.billingApiServerURL}/admin/coupons`;
+    const resp = await this.makeAuthenticatedRequest(endpoint, "POST", "compute", { amountCents });
+    return resp.json();
+  }
+  async listCoupons(opts) {
+    const params = new URLSearchParams();
+    if (opts?.offset !== void 0) params.set("offset", opts.offset.toString());
+    if (opts?.limit !== void 0) params.set("limit", opts.limit.toString());
+    if (opts?.active !== void 0) params.set("active", opts.active.toString());
+    if (opts?.redeemed !== void 0) params.set("redeemed", opts.redeemed.toString());
+    const qs = params.toString();
+    const endpoint = `${this.config.billingApiServerURL}/admin/coupons${qs ? `?${qs}` : ""}`;
+    const resp = await this.makeAuthenticatedRequest(endpoint, "GET", "compute");
+    return resp.json();
+  }
+  async getCoupon(id) {
+    const endpoint = `${this.config.billingApiServerURL}/admin/coupons/${id}`;
+    const resp = await this.makeAuthenticatedRequest(endpoint, "GET", "compute");
+    return resp.json();
+  }
+  async deactivateCoupon(id) {
+    const endpoint = `${this.config.billingApiServerURL}/admin/coupons/${id}/deactivate`;
+    await this.makeAuthenticatedRequest(endpoint, "POST", "compute");
+  }
+  async redeemCouponForUser(id, address) {
+    const endpoint = `${this.config.billingApiServerURL}/admin/coupons/${id}/redeem`;
+    await this.makeAuthenticatedRequest(endpoint, "POST", "compute", { address });
+  }
+  // ==========================================================================
+  // Admin - Admin Management Methods
+  // ==========================================================================
+  async addAdmin(address) {
+    const endpoint = `${this.config.billingApiServerURL}/admin/admins`;
+    const resp = await this.makeAuthenticatedRequest(endpoint, "POST", "compute", { address });
+    return resp.json();
+  }
+  async removeAdmin(address) {
+    const endpoint = `${this.config.billingApiServerURL}/admin/admins/${address}`;
+    await this.makeAuthenticatedRequest(endpoint, "DELETE", "compute");
+  }
+  async listAdmins() {
+    const endpoint = `${this.config.billingApiServerURL}/admin/admins`;
+    const resp = await this.makeAuthenticatedRequest(endpoint, "GET", "compute");
+    return resp.json();
+  }
+  // ==========================================================================
+  // User - Coupon Redemption
+  // ==========================================================================
+  async redeemCoupon(code) {
+    const endpoint = `${this.config.billingApiServerURL}/v1/coupons/redeem`;
+    const resp = await this.makeAuthenticatedRequest(endpoint, "POST", "compute", { code });
+    return resp.json();
+  }
+  // ==========================================================================
   // Internal Methods
   // ==========================================================================
   /**
@@ -429,6 +486,7 @@ Please check:
 // src/client/common/config/environment.ts
 var SEPOLIA_CHAIN_ID = 11155111;
 var MAINNET_CHAIN_ID = 1;
+var BASE_SEPOLIA_CHAIN_ID = 84532;
 var CommonAddresses = {
   ERC7702Delegator: "0x63c0c19a282a1b52b07dd5a65b58948a07dae32b"
 };
@@ -448,27 +506,28 @@ var BILLING_ENVIRONMENTS = {
     billingApiServerURL: "https://billingapi.eigencloud.xyz"
   }
 };
-var PLATFORM_ENV_TESTNET_SEPOLIA = "testnet-sepolia";
-var PLATFORM_ENV_MAINNET_ETHEREUM = "mainnet-ethereum";
-var DEFAULT_APP_BASE_DOMAIN = "eigencloud.xyz";
 var ENVIRONMENTS = {
   "sepolia-dev": {
     name: "sepolia",
     build: "dev",
     appControllerAddress: "0xa86DC1C47cb2518327fB4f9A1627F51966c83B92",
+    releaseAbiVersion: "v1.5",
+    // AppController upgraded to v1.5.x (containerPolicy)
     permissionControllerAddress: ChainAddresses[SEPOLIA_CHAIN_ID].PermissionController,
     erc7702DelegatorAddress: CommonAddresses.ERC7702Delegator,
     kmsServerURL: "http://10.128.0.57:8080",
     userApiServerURL: "https://userapi-compute-sepolia-dev.eigencloud.xyz",
     defaultRPCURL: "https://ethereum-sepolia-rpc.publicnode.com",
     usdcCreditsAddress: "0xbdA3897c3A428763B59015C64AB766c288C97376",
-    platformEnv: PLATFORM_ENV_TESTNET_SEPOLIA,
-    appBaseDomain: DEFAULT_APP_BASE_DOMAIN
+    baseUsdcCreditsAddress: "0x7673a47463F80c6a3553Db9E54c8cDcd5313d0ac",
+    baseRPCURL: "https://base-sepolia-rpc.publicnode.com"
   },
   sepolia: {
     name: "sepolia",
     build: "prod",
     appControllerAddress: "0x0dd810a6ffba6a9820a10d97b659f07d8d23d4E2",
+    releaseAbiVersion: "v1.4",
+    // prod still on AppController v1.4.0 (3-field Release)
     permissionControllerAddress: ChainAddresses[SEPOLIA_CHAIN_ID].PermissionController,
     erc7702DelegatorAddress: CommonAddresses.ERC7702Delegator,
     kmsServerURL: "http://10.128.15.203:8080",
@@ -476,21 +535,21 @@ var ENVIRONMENTS = {
     defaultRPCURL: "https://ethereum-sepolia-rpc.publicnode.com",
     billingRPCURL: "https://ethereum-rpc.publicnode.com",
     usdcCreditsAddress: "0xed9c88640ca9149Bd9f7ee6620074af10F2E145d",
-    platformEnv: PLATFORM_ENV_TESTNET_SEPOLIA,
-    appBaseDomain: DEFAULT_APP_BASE_DOMAIN
+    baseUsdcCreditsAddress: "0x7673a47463F80c6a3553Db9E54c8cDcd5313d0ac",
+    baseRPCURL: "https://base-sepolia-rpc.publicnode.com"
   },
   "mainnet-alpha": {
     name: "mainnet-alpha",
     build: "prod",
     appControllerAddress: "0xc38d35Fc995e75342A21CBd6D770305b142Fbe67",
+    releaseAbiVersion: "v1.4",
+    // prod still on AppController v1.4.0 (3-field Release)
     permissionControllerAddress: ChainAddresses[MAINNET_CHAIN_ID].PermissionController,
     erc7702DelegatorAddress: CommonAddresses.ERC7702Delegator,
     kmsServerURL: "http://10.128.0.2:8080",
     userApiServerURL: "https://userapi-compute.eigencloud.xyz",
     defaultRPCURL: "https://ethereum-rpc.publicnode.com",
-    usdcCreditsAddress: "0xed9c88640ca9149Bd9f7ee6620074af10F2E145d",
-    platformEnv: PLATFORM_ENV_MAINNET_ETHEREUM,
-    appBaseDomain: DEFAULT_APP_BASE_DOMAIN
+    usdcCreditsAddress: "0xed9c88640ca9149Bd9f7ee6620074af10F2E145d"
   }
 };
 var CHAIN_ID_TO_ENVIRONMENT = {
@@ -550,7 +609,7 @@ function getBillingEnvironmentConfig(build) {
   };
 }
 function getBuildType() {
-  const buildTimeType = true ? "dev"?.toLowerCase() : void 0;
+  const buildTimeType = true ? "prod"?.toLowerCase() : void 0;
   const runtimeType = process.env.BUILD_TYPE?.toLowerCase();
   const buildType = buildTimeType || runtimeType;
   if (buildType === "dev") {
@@ -569,6 +628,41 @@ function isEnvironmentAvailable(environment) {
   return getAvailableEnvironments().includes(environment);
 }
 
+// src/client/common/utils/helpers.ts
+import { extractChain, createPublicClient, createWalletClient, http, fallback } from "viem";
+import { sepolia as sepolia2 } from "viem/chains";
+import { privateKeyToAccount } from "viem/accounts";
+
+// src/client/common/constants.ts
+import { sepolia, mainnet, baseSepolia } from "viem/chains";
+var SUPPORTED_CHAINS = [mainnet, sepolia, baseSepolia];
+
+// src/client/common/utils/helpers.ts
+function getChainFromID(chainID, fallback2 = sepolia2) {
+  const id = Number(chainID);
+  return extractChain({ chains: SUPPORTED_CHAINS, id }) || fallback2;
+}
+function createClients(options) {
+  const { privateKey, rpcUrl, chainId } = options;
+  const privateKeyHex = addHexPrefix(privateKey);
+  const account = privateKeyToAccount(privateKeyHex);
+  const chain = getChainFromID(chainId);
+  const transport = typeof rpcUrl === "string" ? http(rpcUrl) : fallback(rpcUrl.map((url) => http(url)));
+  const publicClient = createPublicClient({
+    chain,
+    transport
+  });
+  const walletClient = createWalletClient({
+    account,
+    chain,
+    transport
+  });
+  return { walletClient, publicClient };
+}
+function addHexPrefix(value) {
+  return value.startsWith("0x") ? value : `0x${value}`;
+}
+
 // src/client/common/utils/logger.ts
 var getLogger = (verbose) => ({
   info: (...args) => console.info(...args),
@@ -580,14 +674,6 @@ var getLogger = (verbose) => ({
 // src/client/common/utils/userapi.ts
 import axios3 from "axios";
 
-// src/client/common/utils/helpers.ts
-import { extractChain, createPublicClient, createWalletClient, http, fallback } from "viem";
-import { sepolia as sepolia2 } from "viem/chains";
-import { privateKeyToAccount } from "viem/accounts";
-
-// src/client/common/constants.ts
-import { sepolia, mainnet } from "viem/chains";
-
 // src/client/common/utils/retry.ts
 import axios2 from "axios";
 
@@ -2083,7 +2169,7 @@ var ERC20_default = [
 
 // src/client/modules/billing/index.ts
 function createBillingModule(config) {
-  const { verbose = false, skipTelemetry = false, walletClient, publicClient, environment } = config;
+  const { verbose = false, skipTelemetry = false, walletClient, publicClient, environment, privateKey } = config;
   if (!walletClient.account) {
     throw new Error("WalletClient must have an account attached");
   }
@@ -2092,35 +2178,69 @@ function createBillingModule(config) {
   const billingEnvConfig = getBillingEnvironmentConfig(getBuildType());
   const billingApi = new BillingApiClient(billingEnvConfig, walletClient, { verbose });
   const environmentConfig = getEnvironmentConfig(environment);
-  const usdcCreditsAddress = environmentConfig.usdcCreditsAddress;
-  if (!usdcCreditsAddress) {
+  if (!environmentConfig.usdcCreditsAddress) {
     throw new Error(`USDCCredits contract address not configured for environment "${environment}"`);
   }
+  const usdcCreditsAddress = environmentConfig.usdcCreditsAddress;
+  const baseUsdcCreditsAddress = environmentConfig.baseUsdcCreditsAddress;
+  const baseRPCURL = environmentConfig.baseRPCURL;
+  function resolveChainConfig(chain) {
+    if (chain === "base") {
+      if (!baseUsdcCreditsAddress || !baseRPCURL) {
+        throw new Error(`Base chain not configured for environment "${environment}"`);
+      }
+      if (!privateKey) {
+        throw new Error("Private key required for Base chain transactions");
+      }
+      const baseClients = createClients({
+        privateKey,
+        rpcUrl: baseRPCURL,
+        chainId: BigInt(BASE_SEPOLIA_CHAIN_ID)
+      });
+      return {
+        pub: baseClients.publicClient,
+        wallet: baseClients.walletClient,
+        creditsAddress: baseUsdcCreditsAddress,
+        envConfig: {
+          ...environmentConfig,
+          chainID: BigInt(BASE_SEPOLIA_CHAIN_ID),
+          defaultRPCURL: baseRPCURL
+        }
+      };
+    }
+    return {
+      pub: publicClient,
+      wallet: walletClient,
+      creditsAddress: usdcCreditsAddress,
+      envConfig: environmentConfig
+    };
+  }
   const module = {
     address,
-    async getTopUpInfo() {
-      const usdcAddress = await publicClient.readContract({
-        address: usdcCreditsAddress,
+    async getTopUpInfo(opts) {
+      const { pub, creditsAddress } = resolveChainConfig(opts?.chain);
+      const usdcAddress = await pub.readContract({
+        address: creditsAddress,
         abi: USDCCredits_default,
         functionName: "usdc"
       });
       const [minimumPurchase, usdcBalance, currentAllowance] = await Promise.all([
-        publicClient.readContract({
-          address: usdcCreditsAddress,
+        pub.readContract({
+          address: creditsAddress,
           abi: USDCCredits_default,
           functionName: "minimumPurchase"
         }),
-        publicClient.readContract({
+        pub.readContract({
           address: usdcAddress,
           abi: ERC20_default,
           functionName: "balanceOf",
           args: [address]
         }),
-        publicClient.readContract({
+        pub.readContract({
           address: usdcAddress,
           abi: ERC20_default,
           functionName: "allowance",
-          args: [address, usdcCreditsAddress]
+          args: [address, creditsAddress]
         })
       ]);
       return { usdcAddress, minimumPurchase, usdcBalance, currentAllowance };
@@ -2130,11 +2250,12 @@ function createBillingModule(config) {
         {
           functionName: "topUp",
           skipTelemetry,
-          properties: { amount: opts.amount.toString() }
+          properties: { amount: opts.amount.toString(), chain: opts.chain || "ethereum" }
         },
         async () => {
           const targetAccount = opts.account ?? address;
-          const { usdcAddress, currentAllowance } = await module.getTopUpInfo();
+          const { pub, wallet, creditsAddress, envConfig } = resolveChainConfig(opts.chain);
+          const { usdcAddress, currentAllowance } = await module.getTopUpInfo({ chain: opts.chain });
           const executions = [];
           if (currentAllowance < opts.amount) {
             executions.push({
@@ -2143,12 +2264,12 @@ function createBillingModule(config) {
               callData: encodeFunctionData3({
                 abi: ERC20_default,
                 functionName: "approve",
-                args: [usdcCreditsAddress, opts.amount]
+                args: [creditsAddress, opts.amount]
               })
             });
           }
           executions.push({
-            target: usdcCreditsAddress,
+            target: creditsAddress,
             value: 0n,
             callData: encodeFunctionData3({
               abi: USDCCredits_default,
@@ -2158,9 +2279,9 @@ function createBillingModule(config) {
           });
           const txHash = await executeBatch(
             {
-              walletClient,
-              publicClient,
-              environmentConfig,
+              walletClient: wallet,
+              publicClient: pub,
+              environmentConfig: envConfig,
               executions,
               pendingMessage: "Submitting credit purchase..."
             },
@@ -2260,6 +2381,12 @@ function createBillingModule(config) {
     },
     async purchaseCredits(amountCents, paymentMethodId) {
       return billingApi.purchaseCredits(amountCents, paymentMethodId);
+    },
+    hasBaseSupport() {
+      return !!baseUsdcCreditsAddress && !!baseRPCURL;
+    },
+    async redeemCoupon(code) {
+      return billingApi.redeemCoupon(code);
     }
   };
   return module;