feat: more ergonomic RPC URL setting (#4413)

### Description

- Updates `scripts/secret-rpc-urls/set-rpc-urls.ts` to:
  - Interactively prompt for what RPC URLs to use
  - If desired, update K8s consumers (secrets & reset pods)

Usage:
```
yarn tsx ./scripts/secret-rpc-urls/set-rpc-urls.ts -e mainnet3 --chain lisk
```

or even
```
yarn tsx ./scripts/secret-rpc-urls/set-rpc-urls.ts -e mainnet3 --chains lisk zircuit
```

Removes `set-rpc-urls-from-registry` in favor of this new command, which
lets you do this as well.

Note that atm it doesn't consider warp monitors as dependent k8s
resources. This is because we haven't really defined infrastructure as
code for these -- the deployments that exist are kinda manually created
by passing in a config file. This should change but didn't feel
appropriate in this PR

The meatiest changes are in utils/rpcUrls.ts and utils/k8s.ts, the rest
were kinda drivebys to accommodate this

### Drive-by changes

- Various tweaks to labels used throughout k8s to be a bit more uniform
- Refactored a lot of helm related scripts to use `HelmManager` as a
superclass

### Related issues

<!--
- Fixes #[issue number here]
-->

### Backward compatibility

<!--
Are these changes backward compatible? Are there any infrastructure
implications, e.g. changes that would prohibit deploying older commits
using this infra tooling?

Yes/No
-->

### Testing

<!--
What kind of testing have these changes undergone?

None/Manual/Unit Tests
-->

typescript/infra/helm/helloworld-kathy/templates/_helpers.tpl

@@ -36,6 +36,8 @@ Common labels
 {{- define "hyperlane.labels" -}}
 helm.sh/chart: {{ include "hyperlane.chart" . }}
 hyperlane/deployment: {{ .Values.hyperlane.runEnv | quote }}
+hyperlane/context: {{ .Values.hyperlane.context | quote }}
+app.kubernetes.io/component: kathy
 {{ include "hyperlane.selectorLabels" . }}
 {{- if .Chart.AppVersion }}
 app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}

typescript/infra/helm/helloworld-kathy/templates/cycle-once-pod.yaml

@@ -4,9 +4,7 @@ kind: Pod
 metadata:
   name: {{ include "hyperlane.fullname" . }}-cycle-once-{{ (randAlphaNum 4 | nospace | lower) }}
   labels: &metadata_labels
-    hyperlane/deployment: {{ .Values.hyperlane.runEnv | quote }}
-    hyperlane/context: {{ .Values.hyperlane.context | quote }}
-    app.kubernetes.io/component: kathy
+    {{- include "hyperlane.labels" . | nindent 4 }}
 spec:
   restartPolicy: Never
   containers:

typescript/infra/helm/helloworld-kathy/templates/stateful-set.yaml

@@ -4,9 +4,7 @@ kind: StatefulSet
 metadata:
   name: {{ include "hyperlane.fullname" . }}
   labels: &metadata_labels
-    hyperlane/deployment: {{ .Values.hyperlane.runEnv | quote }}
-    hyperlane/context: {{ .Values.hyperlane.context | quote }}
-    app.kubernetes.io/component: kathy
+    {{- include "hyperlane.labels" . | nindent 4 }}
 spec:
   selector:
     matchLabels: *metadata_labels

typescript/infra/helm/key-funder/templates/cron-job.yaml

@@ -12,6 +12,9 @@ spec:
       backoffLimit: 0
       activeDeadlineSeconds: 14400 # 60 * 60 * 4 seconds = 4 hours
       template:
+        metadata:
+          labels:
+            {{- include "hyperlane.labels" . | nindent 12 }}
         spec:
           restartPolicy: Never
           containers:

typescript/infra/helm/warp-routes/templates/_helpers.tpl

@@ -36,6 +36,8 @@ Common labels
 {{- define "hyperlane.labels" -}}
 helm.sh/chart: {{ include "hyperlane.chart" . }}
 hyperlane/deployment: {{ .Values.hyperlane.runEnv | quote }}
+hyperlane/context: {{ .Values.hyperlane.context | quote }}
+app.kubernetes.io/component: warp-routes
 {{ include "hyperlane.selectorLabels" . }}
 {{- if .Chart.AppVersion }}
 app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}

typescript/infra/helm/warp-routes/templates/stateful-set.yaml

@@ -4,9 +4,7 @@ kind: StatefulSet
 metadata:
   name: {{ include "hyperlane.fullname" . }}
   labels: &metadata_labels
-    hyperlane/deployment: {{ .Values.hyperlane.runEnv | quote }}
-    hyperlane/context: {{ .Values.hyperlane.context | quote }}
-    app.kubernetes.io/component: warp-routes
+    {{- include "hyperlane.labels" . | nindent 4 }}
 spec:
   selector:
     matchLabels: *metadata_labels

typescript/infra/package.json

@@ -17,6 +17,7 @@
     "@hyperlane-xyz/registry": "2.5.0",
     "@hyperlane-xyz/sdk": "5.1.0",
     "@hyperlane-xyz/utils": "5.1.0",
+    "@inquirer/prompts": "^5.3.8",
     "@nomiclabs/hardhat-etherscan": "^3.0.3",
     "@safe-global/api-kit": "1.3.0",
     "@safe-global/protocol-kit": "1.3.0",

typescript/infra/scripts/agent-utils.ts

@@ -168,6 +168,10 @@ export function withChains<T>(args: Argv<T>) {
   );
 }
 
+export function withChainsRequired<T>(args: Argv<T>) {
+  return withChains(args).demandOption('chains');
+}
+
 export function withWarpRouteId<T>(args: Argv<T>) {
   return args.describe('warpRouteId', 'warp route id').string('warpRouteId');
 }

typescript/infra/scripts/funding/deploy-key-funder.ts

@@ -1,28 +1,21 @@
 import { Contexts } from '../../config/contexts.js';
-import {
-  getKeyFunderConfig,
-  runKeyFunderHelmCommand,
-} from '../../src/funding/key-funder.js';
+import { environment } from '../../config/environments/mainnet3/chains.js';
+import { KeyFunderHelmManager } from '../../src/funding/key-funder.js';
 import { HelmCommand } from '../../src/utils/helm.js';
 import { assertCorrectKubeContext } from '../agent-utils.js';
 import { getConfigsBasedOnArgs } from '../core-utils.js';
 
 async function main() {
-  const { agentConfig, envConfig } = await getConfigsBasedOnArgs();
+  const { agentConfig, envConfig, context } = await getConfigsBasedOnArgs();
   if (agentConfig.context != Contexts.Hyperlane)
     throw new Error(
       `Invalid context ${agentConfig.context}, must be ${Contexts.Hyperlane}`,
     );
 
   await assertCorrectKubeContext(envConfig);
 
-  const keyFunderConfig = getKeyFunderConfig(envConfig);
-
-  await runKeyFunderHelmCommand(
-    HelmCommand.InstallOrUpgrade,
-    agentConfig,
-    keyFunderConfig,
-  );
+  const manager = KeyFunderHelmManager.forEnvironment(environment);
+  await manager.runHelmCommand(HelmCommand.InstallOrUpgrade);
 }
 
 main()

typescript/infra/scripts/helloworld/deploy-kathy.ts

@@ -1,20 +1,14 @@
-import { runHelloworldKathyHelmCommand } from '../../src/helloworld/kathy.js';
+import { KathyHelmManager } from '../../src/helloworld/kathy.js';
 import { HelmCommand } from '../../src/utils/helm.js';
 import { assertCorrectKubeContext } from '../agent-utils.js';
 import { getConfigsBasedOnArgs } from '../core-utils.js';
 
-import { getHelloWorldConfig } from './utils.js';
-
 async function main() {
-  const { agentConfig, envConfig, context } = await getConfigsBasedOnArgs();
+  const { envConfig, environment, context } = await getConfigsBasedOnArgs();
   await assertCorrectKubeContext(envConfig);
-  const kathyConfig = getHelloWorldConfig(envConfig, context).kathy;
 
-  await runHelloworldKathyHelmCommand(
-    HelmCommand.InstallOrUpgrade,
-    agentConfig,
-    kathyConfig,
-  );
+  const manager = KathyHelmManager.forEnvironment(environment, context);
+  await manager.runHelmCommand(HelmCommand.InstallOrUpgrade);
 }
 
 main()

typescript/infra/scripts/secret-rpc-urls/set-rpc-urls.ts

@@ -1,22 +1,28 @@
-import { setAndVerifyRpcUrls } from '../../src/utils/rpcUrls.js';
-import { getArgs, withChainRequired, withRpcUrls } from '../agent-utils.js';
+import { setRpcUrlsInteractive } from '../../src/utils/rpcUrls.js';
+import {
+  assertCorrectKubeContext,
+  getArgs,
+  withChainsRequired,
+} from '../agent-utils.js';
+import { getEnvironmentConfig } from '../core-utils.js';
 
 async function main() {
-  const { environment, chain, rpcUrls } = await withRpcUrls(
-    withChainRequired(getArgs()),
-  ).argv;
+  const { environment, chains } = await withChainsRequired(getArgs())
+    // For ease of use and backward compatibility, we allow the `chain` argument to be
+    // singular or plural.
+    .alias('chain', 'chains').argv;
 
-  const rpcUrlsArray = rpcUrls
-    .split(/,\s*/)
-    .filter(Boolean) // filter out empty strings
-    .map((url) => url.trim());
+  await assertCorrectKubeContext(getEnvironmentConfig(environment));
 
-  if (!rpcUrlsArray.length) {
-    console.error('No rpc urls provided, Exiting.');
+  if (!chains || chains.length === 0) {
+    console.error('No chains provided, Exiting.');
     process.exit(1);
   }
 
-  await setAndVerifyRpcUrls(environment, chain, rpcUrlsArray);
+  for (const chain of chains) {
+    console.log(`Setting RPC URLs for chain: ${chain}`);
+    await setRpcUrlsInteractive(environment, chain);
+  }
 }
 
 main()

typescript/infra/scripts/warp-routes/deploy-warp-monitor.ts

@@ -1,8 +1,9 @@
 import yargs from 'yargs';
 
 import { HelmCommand } from '../../src/utils/helm.js';
-
-import { runWarpRouteHelmCommand } from './helm.js';
+import { WarpRouteMonitorHelmManager } from '../../src/warp/helm.js';
+import { assertCorrectKubeContext } from '../agent-utils.js';
+import { getEnvironmentConfig } from '../core-utils.js';
 
 async function main() {
   const { filePath } = await yargs(process.argv.slice(2))
@@ -15,11 +16,10 @@ async function main() {
     .string('filePath')
     .parse();
 
-  await runWarpRouteHelmCommand(
-    HelmCommand.InstallOrUpgrade,
-    'mainnet3',
-    filePath,
-  );
+  await assertCorrectKubeContext(getEnvironmentConfig('mainnet3'));
+
+  const helmManager = new WarpRouteMonitorHelmManager(filePath, 'mainnet3');
+  await helmManager.runHelmCommand(HelmCommand.InstallOrUpgrade);
 }
 
 main()