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

package/VERSION

@@ -1,2 +1,2 @@
-version=1.0.0-devep7
-commit=77f99bf086444d26b080c7e076c1dfcc470f36f7
+version=1.0.0
+commit=3f8023569b781e80105d1f06cbba82a8fb7dd3e0

package/dist/billing.cjs

@@ -332,6 +332,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
   // ==========================================================================
   /**
@@ -463,6 +520,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"
 };
@@ -482,27 +540,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",
@@ -510,21 +569,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 = {
@@ -584,7 +643,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") {
@@ -603,6 +662,41 @@ function isEnvironmentAvailable(environment) {
   return getAvailableEnvironments().includes(environment);
 }
 
+// src/client/common/utils/helpers.ts
+var import_viem2 = require("viem");
+var import_chains2 = require("viem/chains");
+var import_accounts = require("viem/accounts");
+
+// src/client/common/constants.ts
+var import_chains = require("viem/chains");
+var SUPPORTED_CHAINS = [import_chains.mainnet, import_chains.sepolia, import_chains.baseSepolia];
+
+// src/client/common/utils/helpers.ts
+function getChainFromID(chainID, fallback2 = import_chains2.sepolia) {
+  const id = Number(chainID);
+  return (0, import_viem2.extractChain)({ chains: SUPPORTED_CHAINS, id }) || fallback2;
+}
+function createClients(options) {
+  const { privateKey, rpcUrl, chainId } = options;
+  const privateKeyHex = addHexPrefix(privateKey);
+  const account = (0, import_accounts.privateKeyToAccount)(privateKeyHex);
+  const chain = getChainFromID(chainId);
+  const transport = typeof rpcUrl === "string" ? (0, import_viem2.http)(rpcUrl) : (0, import_viem2.fallback)(rpcUrl.map((url) => (0, import_viem2.http)(url)));
+  const publicClient = (0, import_viem2.createPublicClient)({
+    chain,
+    transport
+  });
+  const walletClient = (0, import_viem2.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),
@@ -614,14 +708,6 @@ var getLogger = (verbose) => ({
 // src/client/common/utils/userapi.ts
 var import_axios3 = __toESM(require("axios"), 1);
 
-// src/client/common/utils/helpers.ts
-var import_viem2 = require("viem");
-var import_chains2 = require("viem/chains");
-var import_accounts = require("viem/accounts");
-
-// src/client/common/constants.ts
-var import_chains = require("viem/chains");
-
 // src/client/common/utils/retry.ts
 var import_axios2 = __toESM(require("axios"), 1);
 
@@ -2117,7 +2203,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");
   }
@@ -2126,35 +2212,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 module2 = {
     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 };
@@ -2164,11 +2284,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 module2.getTopUpInfo();
+          const { pub, wallet, creditsAddress, envConfig } = resolveChainConfig(opts.chain);
+          const { usdcAddress, currentAllowance } = await module2.getTopUpInfo({ chain: opts.chain });
           const executions = [];
           if (currentAllowance < opts.amount) {
             executions.push({
@@ -2177,12 +2298,12 @@ function createBillingModule(config) {
               callData: (0, import_viem5.encodeFunctionData)({
                 abi: ERC20_default,
                 functionName: "approve",
-                args: [usdcCreditsAddress, opts.amount]
+                args: [creditsAddress, opts.amount]
               })
             });
           }
           executions.push({
-            target: usdcCreditsAddress,
+            target: creditsAddress,
             value: 0n,
             callData: (0, import_viem5.encodeFunctionData)({
               abi: USDCCredits_default,
@@ -2192,9 +2313,9 @@ function createBillingModule(config) {
           });
           const txHash = await executeBatch(
             {
-              walletClient,
-              publicClient,
-              environmentConfig,
+              walletClient: wallet,
+              publicClient: pub,
+              environmentConfig: envConfig,
               executions,
               pendingMessage: "Submitting credit purchase..."
             },
@@ -2294,6 +2415,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 module2;