@gearbox-protocol/cli-utils 5.55.0 → 5.57.0

package/dist/createRevolverTransport.d.ts

@@ -0,0 +1,5 @@
+import type { NetworkType } from "@gearbox-protocol/sdk";
+import { type RevolverTransportConfig, type RevolverTransportValue } from "@gearbox-protocol/sdk/dev";
+import type { Transport } from "viem";
+import type { ProvidersSchema } from "./providers-schema.js";
+export declare function createRevolverTransport(network: NetworkType, providers: ProvidersSchema, config?: Omit<RevolverTransportConfig, "network" | "providers">): Transport<"revolver", RevolverTransportValue>;

package/dist/createRevolverTransport.js

@@ -0,0 +1,56 @@
+import { RevolverTransport, } from "@gearbox-protocol/sdk/dev";
+import { getAlchemyUrl, getAnkrUrl, getDrpcUrl, getErpcKey, getThirdWebUrl, } from "./providers.js";
+function getProviders(network, config) {
+    const { enabledProviders, alchemyKeys = [], ankrKeys = [], drpcKeys = [], thirdwebKeys = [], jsonRpcProviders = [], erpcProjectId, erpcUrl, } = config;
+    const result = [];
+    for (const p of enabledProviders) {
+        switch (p) {
+            case "alchemy":
+                result.push(...alchemyKeys.map(k => ({
+                    name: "alchemy",
+                    url: getAlchemyUrl(network, k.value),
+                })));
+                break;
+            case "drpc":
+                result.push(...drpcKeys.map(k => ({
+                    name: "drpc",
+                    url: getDrpcUrl(network, k.value),
+                })));
+                break;
+            case "ankr":
+                result.push(...ankrKeys.map(k => ({
+                    name: "ankr",
+                    url: getAnkrUrl(network, k.value),
+                })));
+                break;
+            case "thirdweb":
+                result.push(...thirdwebKeys.map(k => ({
+                    name: "thirdweb",
+                    url: getThirdWebUrl(network, k.value),
+                })));
+                break;
+            case "custom":
+                result.push(...jsonRpcProviders.map(url => ({
+                    name: new URL(url.value).hostname,
+                    url: url.value,
+                })));
+                break;
+            case "erpc":
+                if (erpcProjectId && erpcUrl) {
+                    result.push({
+                        name: "erpc",
+                        url: getErpcKey(network, erpcProjectId, erpcUrl),
+                    });
+                }
+                break;
+        }
+    }
+    return result.filter(p => !!p.url);
+}
+export function createRevolverTransport(network, providers, config) {
+    return RevolverTransport.create({
+        network,
+        providers: getProviders(network, providers),
+        ...config,
+    });
+}

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 export * from "./CensoredString.js";
 export * from "./CensoredURL.js";
+export * from "./createRevolverTransport.js";
+export * from "./providers.js";
+export * from "./providers-schema.js";
 export * from "./resolveYamlFiles.js";
 export * from "./SecretsManager.js";
 export * from "./SSMManager.js";

package/dist/index.js

@@ -1,5 +1,8 @@
 export * from "./CensoredString.js";
 export * from "./CensoredURL.js";
+export * from "./createRevolverTransport.js";
+export * from "./providers.js";
+export * from "./providers-schema.js";
 export * from "./resolveYamlFiles.js";
 export * from "./SecretsManager.js";
 export * from "./SSMManager.js";

package/dist/providers-schema.d.ts

@@ -0,0 +1,30 @@
+import { z } from "zod/v4";
+import { CensoredString } from "./CensoredString.js";
+import { CensoredURL } from "./CensoredURL.js";
+export declare const RpcProvider: z.ZodEnum<{
+    custom: "custom";
+    alchemy: "alchemy";
+    drpc: "drpc";
+    ankr: "ankr";
+    thirdweb: "thirdweb";
+    erpc: "erpc";
+}>;
+export type RpcProvider = z.infer<typeof RpcProvider>;
+export declare const ProvidersSchema: z.ZodObject<{
+    jsonRpcProviders: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>, z.ZodArray<z.ZodPipe<z.ZodURL, z.ZodTransform<CensoredURL, string>>>>, z.ZodTransform<CensoredURL[] | undefined, CensoredURL[]>>>;
+    enabledProviders: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>, z.ZodArray<z.ZodEnum<{
+        custom: "custom";
+        alchemy: "alchemy";
+        drpc: "drpc";
+        ankr: "ankr";
+        thirdweb: "thirdweb";
+        erpc: "erpc";
+    }>>>>;
+    alchemyKeys: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>, z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<CensoredString<string>, string>>>>, z.ZodTransform<CensoredString<string>[] | undefined, CensoredString<string>[]>>>;
+    drpcKeys: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>, z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<CensoredString<string>, string>>>>, z.ZodTransform<CensoredString<string>[] | undefined, CensoredString<string>[]>>>;
+    ankrKeys: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>, z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<CensoredString<string>, string>>>>, z.ZodTransform<CensoredString<string>[] | undefined, CensoredString<string>[]>>>;
+    thirdwebKeys: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>, z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<CensoredString<string>, string>>>>, z.ZodTransform<CensoredString<string>[] | undefined, CensoredString<string>[]>>>;
+    erpcProjectId: z.ZodOptional<z.ZodString>;
+    erpcUrl: z.ZodDefault<z.ZodURL>;
+}, z.core.$strip>;
+export type ProvidersSchema = z.infer<typeof ProvidersSchema>;

package/dist/providers-schema.js

@@ -0,0 +1,103 @@
+import { z } from "zod/v4";
+import { CensoredString } from "./CensoredString.js";
+import { CensoredURL } from "./CensoredURL.js";
+import { stringArrayLike } from "./schema-primitives.js";
+import { zommandRegistry } from "./Zommand.js";
+export const RpcProvider = z.enum([
+    "alchemy",
+    "drpc",
+    "ankr",
+    "thirdweb",
+    "custom",
+    "erpc",
+]);
+export const ProvidersSchema = z.object({
+    /**
+     * RPC providers to use
+     */
+    jsonRpcProviders: stringArrayLike()
+        .pipe(z.array(z.url().transform(CensoredURL.transform)))
+        .transform(a => (a.length ? a : undefined))
+        .optional()
+        .register(zommandRegistry, {
+        flags: "--json-rpc-providers <urls...>",
+        description: "RPC providers to use, comma separated full http urls.",
+        env: "JSON_RPC_PROVIDERS",
+    }),
+    /**
+     * RPC providers to use with their keys
+     * Order matters
+     */
+    enabledProviders: stringArrayLike()
+        .pipe(z.array(RpcProvider))
+        .default(["erpc", "custom", "drpc", "alchemy", "ankr", "thirdweb"])
+        .register(zommandRegistry, {
+        flags: "--enabled-providers <providers...>",
+        description: "Keyed RPC providers to use, comma separated, order matters. Possible values: custom (for full json rpc urls)/alchemy/drpc/ankr/thirdweb",
+        env: "ENABLED_PROVIDERS",
+    }),
+    /**
+     * Alchemy API keys to use
+     */
+    alchemyKeys: stringArrayLike()
+        .pipe(z.array(z.string().transform(CensoredString.transform)))
+        .transform(a => (a.length ? a : undefined))
+        .optional()
+        .register(zommandRegistry, {
+        flags: "--alchemy-keys <keys...>",
+        description: "Alchemy API keys to use, comma separated",
+        env: "ALCHEMY_KEYS",
+    }),
+    /**
+     * DRPC API keys to use
+     */
+    drpcKeys: stringArrayLike()
+        .pipe(z.array(z.string().transform(CensoredString.transform)))
+        .transform(a => (a.length ? a : undefined))
+        .optional()
+        .register(zommandRegistry, {
+        flags: "--drpc-keys <keys...>",
+        description: "DRPC API keys to use, comma separated",
+        env: "DRPC_KEYS",
+    }),
+    /**
+     * Ankr API keys to use
+     */
+    ankrKeys: stringArrayLike()
+        .pipe(z.array(z.string().transform(CensoredString.transform)))
+        .transform(a => (a.length ? a : undefined))
+        .optional()
+        .register(zommandRegistry, {
+        flags: "--ankr-keys <keys...>",
+        description: "Ankr API keys to use, comma separated",
+        env: "ANKR_KEYS",
+    }),
+    /**
+     * Thirdweb API keys to use
+     */
+    thirdwebKeys: stringArrayLike()
+        .pipe(z.array(z.string().transform(CensoredString.transform)))
+        .transform(a => (a.length ? a : undefined))
+        .optional()
+        .register(zommandRegistry, {
+        flags: "--thirdweb-keys <keys...>",
+        description: "Thirdweb API keys to use, comma separated",
+        env: "THIRDWEB_KEYS",
+    }),
+    /**
+     * If set, eRPC will be added as first provider
+     */
+    erpcProjectId: z.string().optional().register(zommandRegistry, {
+        flags: "--erpc-project-id <project-id>",
+        description: "If set, eRPC will be added as first provider",
+        env: "ERPC_PROJECT_ID",
+    }),
+    /**
+     * eRPC URL to use
+     */
+    erpcUrl: z.url().default("http://erpc.local").register(zommandRegistry, {
+        flags: "--erpc-url <url>",
+        description: "eRPC URL to use",
+        env: "ERPC_URL",
+    }),
+});

package/dist/providers.d.ts

@@ -0,0 +1,6 @@
+import { type NetworkType } from "@gearbox-protocol/sdk";
+export declare function getAlchemyUrl(network: NetworkType, apiKey: string, protocol?: "http" | "ws"): string | undefined;
+export declare function getDrpcUrl(network: NetworkType, apiKey: string, protocol?: "http" | "ws"): string | undefined;
+export declare function getAnkrUrl(network: NetworkType, apiKey: string, protocol?: "http" | "ws"): string | undefined;
+export declare function getThirdWebUrl(network: NetworkType, apiKey: string, protocol?: "http" | "ws"): string | undefined;
+export declare function getErpcKey(network: NetworkType, projectId?: string, urlBase?: string): string | undefined;

package/dist/providers.js

@@ -0,0 +1,99 @@
+import { chains, getChain } from "@gearbox-protocol/sdk";
+export function getAlchemyUrl(network, apiKey, protocol = "http") {
+    const alchemyDomain = ALCHEMY_DOMAINS[network];
+    if (!alchemyDomain) {
+        return undefined;
+    }
+    return `${protocol}s://${alchemyDomain}.g.alchemy.com/v2/${apiKey}`;
+}
+const DRPC_NETS = {
+    Arbitrum: "arbitrum",
+    Base: "base",
+    BNB: "bsc",
+    Mainnet: "ethereum",
+    Optimism: "optimism",
+    Sonic: "sonic",
+    WorldChain: "worldchain",
+    Berachain: "berachain",
+    Avalanche: "avalanche",
+    Monad: "monad-testnet",
+    Hemi: "hemi",
+    Lisk: "lisk",
+    MegaETH: null,
+    Etherlink: null,
+    Plasma: "plasma",
+};
+const ALCHEMY_DOMAINS = {
+    Mainnet: "eth-mainnet",
+    Arbitrum: "arb-mainnet",
+    Optimism: "opt-mainnet",
+    Base: "base-mainnet",
+    Sonic: "sonic-mainnet",
+    Monad: "monad-testnet",
+    Berachain: "berachain-mainnet",
+    Avalanche: "avax-mainnet",
+    BNB: "bnb-mainnet",
+    WorldChain: "worldchain-mainnet",
+    MegaETH: null,
+    Etherlink: null,
+    Hemi: null,
+    Lisk: null,
+    Plasma: "plasma-mainnet",
+};
+export function getDrpcUrl(network, apiKey, protocol = "http") {
+    const net = DRPC_NETS[network];
+    return net ? `${protocol}s://lb.drpc.org/${net}/${apiKey}` : undefined;
+}
+const ANKR_DOMAINS = {
+    Arbitrum: "arbitrum",
+    Avalanche: "avalanche",
+    Base: "base",
+    Berachain: null,
+    BNB: "bsc",
+    Etherlink: "etherlink_mainnet",
+    Hemi: null,
+    Lisk: null,
+    Mainnet: "eth",
+    MegaETH: null,
+    Monad: "monad_testnet",
+    Optimism: "optimism",
+    Plasma: null,
+    Sonic: "sonic_mainnet",
+    WorldChain: null,
+};
+export function getAnkrUrl(network, apiKey, protocol = "http") {
+    const net = ANKR_DOMAINS[network];
+    const sep = protocol === "ws" ? "/ws/" : "/";
+    return net ? `${protocol}s://rpc.ankr.com/${net}${sep}${apiKey}` : undefined;
+}
+const THIRDWEB_DOMAINS = {
+    Arbitrum: chains.Arbitrum.id.toString(),
+    Avalanche: chains.Avalanche.id.toString(),
+    Base: chains.Base.id.toString(),
+    Berachain: chains.Berachain.id.toString(),
+    BNB: chains.BNB.id.toString(),
+    Etherlink: chains.Etherlink.id.toString(),
+    Hemi: chains.Hemi.id.toString(),
+    Lisk: chains.Lisk.id.toString(),
+    Mainnet: chains.Mainnet.id.toString(),
+    MegaETH: chains.MegaETH.id.toString(),
+    Monad: chains.Monad.id.toString(),
+    Optimism: chains.Optimism.id.toString(),
+    Plasma: chains.Plasma.id.toString(),
+    Sonic: chains.Sonic.id.toString(),
+    WorldChain: chains.WorldChain.id.toString(),
+};
+export function getThirdWebUrl(network, apiKey, protocol = "http") {
+    if (protocol === "ws") {
+        return undefined;
+    }
+    const net = THIRDWEB_DOMAINS[network];
+    return `https://${net}.rpc.thirdweb.com/${apiKey}`;
+}
+export function getErpcKey(network, projectId, urlBase) {
+    if (!projectId || !urlBase) {
+        return undefined;
+    }
+    const chain = getChain(network);
+    return `${urlBase}/${projectId}/evm/${chain.id}`;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gearbox-protocol/cli-utils",
   "description": "Utils for creating cli apps",
-  "version": "5.55.0",
+  "version": "5.57.0",
   "homepage": "https://gearbox.fi",
   "keywords": [
     "gearbox"
@@ -29,17 +29,19 @@
     "package:version": "yarn version"
   },
   "dependencies": {
-    "@aws-sdk/client-secrets-manager": "^3.914.0",
-    "@aws-sdk/client-ssm": "^3.914.0",
+    "@aws-sdk/client-secrets-manager": "^3.922.0",
+    "@aws-sdk/client-ssm": "^3.922.0",
+    "@gearbox-protocol/sdk": ">=10.4.3",
     "abitype": "^1.1.1",
-    "commander": "^14.0.1",
+    "commander": "^14.0.2",
     "lodash-es": "^4.17.21",
+    "viem": "^2.38.6",
     "yaml": "^2.8.1",
     "zod": "^4.1.12"
   },
   "devDependencies": {
     "@commander-js/extra-typings": "^14.0.0",
     "@types/lodash-es": "^4.17.12",
-    "@types/node": "^24.9.1"
+    "@types/node": "^24.10.0"
   }
 }