@hyperlane-xyz/cli 1.4.2-beta0

package/README.md

@@ -0,0 +1,57 @@
+# Hyperlane CLI
+
+The Hyperlane CLI is a command-line tool written in Typescript that facilitates common operations on Hyperlane, such as deploying the core contracts and/or warp routes to new chains.
+
+## Hyperlane overview
+
+Hyperlane is an interchain messaging protocol that allows applications to communicate between blockchains.
+
+Developers can use Hyperlane to share state between blockchains, allowing them to build interchain applications that live natively across multiple chains.
+
+To read more about interchain applications, how the protocol works, and how to integrate with Hyperlane, please see the [documentation](https://docs.hyperlane.xyz).
+
+## Setup
+
+Node 16 or newer is required.
+
+**Option 1: Global install:**
+
+```bash
+# Install with NPM
+npm install -g @hyperlane-xyz/cli
+# Or uninstall old versions
+npm uninstall -g @hyperlane-xyz/cli
+```
+
+**Option 2: Temp install:**
+
+```bash
+# Run via NPM's npx command
+npx @hyperlane-xyz/cli
+# Or via Yarn's dlx command
+yarn dlx @hyperlane-xyz/cli
+```
+
+**Option 3: Run from source:**
+
+```bash
+git clone https://github.com/hyperlane-xyz/hyperlane-monorepo.git
+cd hyperlane-monorepo
+yarn install && yarn build
+cd typescript/cli
+yarn hyperlane
+```
+
+## Common commands
+
+View help: `hyperlane --help`
+
+Create a core deployment config: `hyperlane config create`
+
+Run hyperlane core deployments: `hyperlane deploy core`
+
+Run warp route deployments: `hyperlane deploy warp`
+
+View SDK contract addresses: `hyperlane chains addresses`
+
+Send test message: `hyperlane send message`

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#! /usr/bin/env node
+import './src/logger.js';
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../cli.ts"],"names":[],"mappings":";AAQA,OAAO,iBAAiB,CAAC"}

package/dist/cli.js

@@ -0,0 +1,38 @@
+#! /usr/bin/env node
+import chalk from 'chalk';
+import yargs from 'yargs';
+import { chainsCommand } from './src/commands/chains.js';
+import { configCommand } from './src/commands/config.js';
+import { deployCommand } from './src/commands/deploy.js';
+import { sendCommand } from './src/commands/send.js';
+import './src/logger.js';
+import { errorRed } from './src/logger.js';
+const MISSING_PARAMS_ERROR = 'Not enough non-option arguments';
+console.log(chalk.blue('Hyperlane'), chalk.magentaBright('CLI'));
+try {
+    await yargs(process.argv.slice(2))
+        .scriptName('hyperlane')
+        // TODO get version num from package.json
+        .version(false)
+        .command(chainsCommand)
+        .command(configCommand)
+        .command(deployCommand)
+        .command(sendCommand)
+        .demandCommand()
+        .strict()
+        .help()
+        .fail((msg, err, yargs) => {
+        if (msg && !msg.includes(MISSING_PARAMS_ERROR))
+            errorRed('Error: ' + msg);
+        console.log('');
+        yargs.showHelp();
+        console.log('');
+        if (err)
+            errorRed(err.toString());
+        process.exit(1);
+    }).argv;
+}
+catch (error) {
+    errorRed('Error: ' + error.message);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../cli.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,oBAAoB,GAAG,iCAAiC,CAAC;AAE/D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AAEjE,IAAI;IACF,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC/B,UAAU,CAAC,WAAW,CAAC;QACxB,yCAAyC;SACxC,OAAO,CAAC,KAAK,CAAC;SACd,OAAO,CAAC,aAAa,CAAC;SACtB,OAAO,CAAC,aAAa,CAAC;SACtB,OAAO,CAAC,aAAa,CAAC;SACtB,OAAO,CAAC,WAAW,CAAC;SACpB,aAAa,EAAE;SACf,MAAM,EAAE;SACR,IAAI,EAAE;SACN,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACxB,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YAAE,QAAQ,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,IAAI,GAAG;YAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC,IAAI,CAAC;CACX;AAAC,OAAO,KAAU,EAAE;IACnB,QAAQ,CAAC,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;CACrC"}

package/dist/src/commands/chains.d.ts

@@ -0,0 +1,6 @@
+import { CommandModule } from 'yargs';
+/**
+ * Parent command
+ */
+export declare const chainsCommand: CommandModule;
+//# sourceMappingURL=chains.d.ts.map

package/dist/src/commands/chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.d.ts","sourceRoot":"","sources":["../../../src/commands/chains.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAatC;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,aAU3B,CAAC"}

package/dist/src/commands/chains.js

@@ -0,0 +1,59 @@
+import { Chains, Mainnets, Testnets, chainMetadata, hyperlaneContractAddresses, } from '@hyperlane-xyz/sdk';
+import { log, logBlue, logGray } from '../logger.js';
+/**
+ * Parent command
+ */
+export const chainsCommand = {
+    command: 'chains',
+    describe: 'View information about core Hyperlane chains',
+    builder: (yargs) => yargs
+        .command(listCommand)
+        .command(addressesCommand)
+        .version(false)
+        .demandCommand(),
+    handler: () => log('Command required'),
+};
+/**
+ * List command
+ */
+const listCommand = {
+    command: 'list',
+    describe: 'List all core chains included in the Hyperlane SDK',
+    handler: () => {
+        logBlue('Hyperlane core mainnet chains:');
+        logGray('------------------------------');
+        log(Mainnets.map((chain) => chainMetadata[chain].displayName).join(', '));
+        log('');
+        logBlue('Hyperlane core testnet chains:');
+        logGray('------------------------------');
+        log(Testnets.map((chain) => chainMetadata[chain].displayName).join(', '));
+    },
+};
+/**
+ * Addresses command
+ */
+const addressesCommand = {
+    command: 'addresses',
+    describe: 'Display the addresses of core Hyperlane contracts',
+    builder: (yargs) => yargs.options({
+        name: {
+            type: 'string',
+            description: 'Chain to display addresses for',
+            choices: Object.values(Chains),
+        },
+    }),
+    handler: (args) => {
+        const name = args.name;
+        if (name && hyperlaneContractAddresses[name]) {
+            logBlue('Hyperlane contract addresses for:', name);
+            logGray('---------------------------------');
+            log(JSON.stringify(hyperlaneContractAddresses[name], null, 2));
+        }
+        else {
+            logBlue('Hyperlane core contract addresses:');
+            logGray('----------------------------------');
+            log(JSON.stringify(hyperlaneContractAddresses, null, 2));
+        }
+    },
+};
+//# sourceMappingURL=chains.js.map

package/dist/src/commands/chains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chains.js","sourceRoot":"","sources":["../../../src/commands/chains.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,MAAM,EAEN,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,0BAA0B,GAC3B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,8CAA8C;IACxD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,OAAO,CAAC,WAAW,CAAC;SACpB,OAAO,CAAC,gBAAgB,CAAC;SACzB,OAAO,CAAC,KAAK,CAAC;SACd,aAAa,EAAE;IACpB,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,kBAAkB,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,GAAkB;IACjC,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,oDAAoD;IAC9D,OAAO,EAAE,GAAG,EAAE;QACZ,OAAO,CAAC,gCAAgC,CAAC,CAAC;QAC1C,OAAO,CAAC,gCAAgC,CAAC,CAAC;QAC1C,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1E,GAAG,CAAC,EAAE,CAAC,CAAC;QACR,OAAO,CAAC,gCAAgC,CAAC,CAAC;QAC1C,OAAO,CAAC,gCAAgC,CAAC,CAAC;QAC1C,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5E,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,gBAAgB,GAAkB;IACtC,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,mDAAmD;IAC7D,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK,CAAC,OAAO,CAAC;QACZ,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gCAAgC;YAC7C,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;SAC/B;KACF,CAAC;IACJ,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;QAChB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAiC,CAAC;QACpD,IAAI,IAAI,IAAI,0BAA0B,CAAC,IAAI,CAAC,EAAE;YAC5C,OAAO,CAAC,mCAAmC,EAAE,IAAI,CAAC,CAAC;YACnD,OAAO,CAAC,mCAAmC,CAAC,CAAC;YAC7C,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,0BAA0B,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;SAChE;aAAM;YACL,OAAO,CAAC,oCAAoC,CAAC,CAAC;YAC9C,OAAO,CAAC,oCAAoC,CAAC,CAAC;YAC9C,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,0BAA0B,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;SAC1D;IACH,CAAC;CACF,CAAC"}

package/dist/src/commands/config.d.ts

@@ -0,0 +1,6 @@
+import { CommandModule } from 'yargs';
+/**
+ * Parent command
+ */
+export declare const configCommand: CommandModule;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/commands/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAYtC;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,aAU3B,CAAC"}

package/dist/src/commands/config.js

@@ -0,0 +1,94 @@
+import { input } from '@inquirer/prompts';
+import select from '@inquirer/select';
+import { ProtocolType, isValidChainMetadata, } from '@hyperlane-xyz/sdk';
+import { readChainConfig } from '../configs.js';
+import { errorRed, logBlue, logGreen } from '../logger.js';
+import { mergeYamlOrJson } from '../utils/files.js';
+/**
+ * Parent command
+ */
+export const configCommand = {
+    command: 'config',
+    describe: 'Create or validate Hyperlane configs',
+    builder: (yargs) => yargs
+        .command(createCommand)
+        .command(validateCommand)
+        .version(false)
+        .demandCommand(),
+    handler: () => console.log('Command required'),
+};
+/**
+ * Create command
+ */
+const createCommand = {
+    command: 'create',
+    describe: 'Create a new, minimal Hyperlane config',
+    builder: (yargs) => yargs.options({
+        output: {
+            type: 'string',
+            alias: 'o',
+            description: 'Output file path',
+        },
+        format: {
+            type: 'string',
+            alias: 'f',
+            description: 'Output file format',
+            choices: ['json', 'yaml'],
+        },
+    }),
+    handler: async (argv) => {
+        const format = argv.format || 'yaml';
+        const output = argv.output || `./configs/chain-config.${format}`;
+        logBlue('Creating a new chain config');
+        const name = await input({
+            message: 'Enter chain name (one word, lower case)',
+        });
+        const chainId = await input({ message: 'Enter chain id (number)' });
+        const domainId = await input({
+            message: 'Enter domain id (number, often matches chainId)',
+        });
+        const protocol = await select({
+            message: 'Select protocol type',
+            choices: Object.values(ProtocolType).map((protocol) => ({
+                name: protocol,
+                value: protocol,
+            })),
+        });
+        const rpcUrl = await input({ message: 'Enter http or https rpc url' });
+        const metadata = {
+            name,
+            chainId: parseInt(chainId, 10),
+            domainId: parseInt(domainId, 10),
+            protocol,
+            rpcUrls: [{ http: rpcUrl }],
+        };
+        if (isValidChainMetadata(metadata)) {
+            logGreen(`Chain config is valid, writing to file ${output}`);
+            mergeYamlOrJson(output, { [name]: metadata }, format);
+        }
+        else {
+            errorRed(`Chain config is invalid, please see https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/main/typescript/cli/examples/chain-config.yaml for an example`);
+            throw new Error('Invalid chain config');
+        }
+        process.exit(0);
+    },
+};
+/**
+ * Validate command
+ */
+const validateCommand = {
+    command: 'validate',
+    describe: 'Validate the configs in a YAML or JSON file',
+    builder: (yargs) => yargs.options({
+        path: {
+            type: 'string',
+            description: 'Input file path',
+            demandOption: true,
+        },
+    }),
+    handler: async (argv) => {
+        const path = argv.path;
+        readChainConfig(path);
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/src/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/commands/config.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/deploy.d.ts

@@ -0,0 +1,6 @@
+import { CommandModule } from 'yargs';
+/**
+ * Parent command
+ */
+export declare const deployCommand: CommandModule;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/src/commands/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/commands/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAatC;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,aAU3B,CAAC"}

package/dist/src/commands/deploy.js

@@ -0,0 +1,72 @@
+import { runCoreDeploy } from '../deploy/core.js';
+import { runWarpDeploy } from '../deploy/warp.js';
+import { logGray } from '../logger.js';
+import { chainsCommandOption, coreArtifactsOption, keyCommandOption, outDirCommandOption, } from './options.js';
+/**
+ * Parent command
+ */
+export const deployCommand = {
+    command: 'deploy',
+    describe: 'Permisionslessly deploy a Hyperlane contracts or extensions',
+    builder: (yargs) => yargs
+        .command(coreCommand)
+        .command(warpCommand)
+        .version(false)
+        .demandCommand(),
+    handler: () => console.log('Command required'),
+};
+/**
+ * Core command
+ */
+const coreCommand = {
+    command: 'core',
+    describe: 'Deploy core Hyperlane contracts',
+    builder: (yargs) => yargs.options({
+        key: keyCommandOption,
+        chains: chainsCommandOption,
+        out: outDirCommandOption,
+    }),
+    handler: async (argv) => {
+        logGray('Hyperlane permissionless core deployment');
+        logGray('----------------------------------------');
+        const key = argv.key || process.env.HYP_KEY;
+        const chainConfigPath = argv.chains;
+        const outPath = argv.out;
+        await runCoreDeploy({ key, chainConfigPath, outPath });
+        process.exit(0);
+    },
+};
+/**
+ * Warp command
+ */
+const warpCommand = {
+    command: 'warp',
+    describe: 'Deploy Warp Route contracts',
+    builder: (yargs) => yargs.options({
+        key: keyCommandOption,
+        chains: chainsCommandOption,
+        out: outDirCommandOption,
+        core: coreArtifactsOption,
+        config: {
+            type: 'string',
+            description: 'A path to a JSON or YAML file with a warp config.',
+            default: './configs/warp-tokens.yaml',
+        },
+    }),
+    handler: async (argv) => {
+        const key = argv.key || process.env.HYP_KEY;
+        const chainConfigPath = argv.chains;
+        const warpConfigPath = argv.config;
+        const coreArtifactsPath = argv.core;
+        const outPath = argv.out;
+        await runWarpDeploy({
+            key,
+            chainConfigPath,
+            warpConfigPath,
+            coreArtifactsPath,
+            outPath,
+        });
+        process.exit(0);
+    },
+};
+//# sourceMappingURL=deploy.js.map

package/dist/src/commands/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../../src/commands/deploy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,6DAA6D;IACvE,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,OAAO,CAAC,WAAW,CAAC;SACpB,OAAO,CAAC,WAAW,CAAC;SACpB,OAAO,CAAC,KAAK,CAAC;SACd,aAAa,EAAE;IACpB,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;CAC/C,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,GAAkB;IACjC,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,iCAAiC;IAC3C,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK,CAAC,OAAO,CAAC;QACZ,GAAG,EAAE,gBAAgB;QACrB,MAAM,EAAE,mBAAmB;QAC3B,GAAG,EAAE,mBAAmB;KACzB,CAAC;IACJ,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,EAAE;QAC3B,OAAO,CAAC,0CAA0C,CAAC,CAAC;QACpD,OAAO,CAAC,0CAA0C,CAAC,CAAC;QACpD,MAAM,GAAG,GAAW,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QACpD,MAAM,eAAe,GAAW,IAAI,CAAC,MAAM,CAAC;QAC5C,MAAM,OAAO,GAAW,IAAI,CAAC,GAAG,CAAC;QACjC,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,GAAkB;IACjC,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,6BAA6B;IACvC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK,CAAC,OAAO,CAAC;QACZ,GAAG,EAAE,gBAAgB;QACrB,MAAM,EAAE,mBAAmB;QAC3B,GAAG,EAAE,mBAAmB;QACxB,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,mDAAmD;YAChE,OAAO,EAAE,4BAA4B;SACtC;KACF,CAAC;IACJ,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,EAAE;QAC3B,MAAM,GAAG,GAAW,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QACpD,MAAM,eAAe,GAAW,IAAI,CAAC,MAAM,CAAC;QAC5C,MAAM,cAAc,GAAW,IAAI,CAAC,MAAM,CAAC;QAC3C,MAAM,iBAAiB,GAAW,IAAI,CAAC,IAAI,CAAC;QAC5C,MAAM,OAAO,GAAW,IAAI,CAAC,GAAG,CAAC;QACjC,MAAM,aAAa,CAAC;YAClB,GAAG;YACH,eAAe;YACf,cAAc;YACd,iBAAiB;YACjB,OAAO;SACR,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;CACF,CAAC"}

package/dist/src/commands/options.d.ts

@@ -0,0 +1,6 @@
+import { Options } from 'yargs';
+export declare const keyCommandOption: Options;
+export declare const chainsCommandOption: Options;
+export declare const outDirCommandOption: Options;
+export declare const coreArtifactsOption: Options;
+//# sourceMappingURL=options.d.ts.map

package/dist/src/commands/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/commands/options.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,eAAO,MAAM,gBAAgB,EAAE,OAI9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,OAIjC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,OAIjC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,OAGjC,CAAC"}

package/dist/src/commands/options.js

@@ -0,0 +1,19 @@
+export const keyCommandOption = {
+    type: 'string',
+    description: 'A hex private key or seed phrase for transaction signing. Or use the HYP_KEY env var',
+};
+export const chainsCommandOption = {
+    type: 'string',
+    description: 'A path to a JSON or YAML file with chain configs.',
+    default: './configs/chain-config.yaml',
+};
+export const outDirCommandOption = {
+    type: 'string',
+    description: 'A folder name output artifacts into.',
+    default: './artifacts',
+};
+export const coreArtifactsOption = {
+    type: 'string',
+    description: 'File path to core deployment output artifacts',
+};
+//# sourceMappingURL=options.js.map

package/dist/src/commands/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/commands/options.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,gBAAgB,GAAY;IACvC,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,sFAAsF;CACzF,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAY;IAC1C,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,mDAAmD;IAChE,OAAO,EAAE,6BAA6B;CACvC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAY;IAC1C,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,sCAAsC;IACnD,OAAO,EAAE,aAAa;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAY;IAC1C,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,+CAA+C;CAC7D,CAAC"}

package/dist/src/commands/send.d.ts

@@ -0,0 +1,6 @@
+import { CommandModule } from 'yargs';
+/**
+ * Parent command
+ */
+export declare const sendCommand: CommandModule;
+//# sourceMappingURL=send.d.ts.map

package/dist/src/commands/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../src/commands/send.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAW,MAAM,OAAO,CAAC;AAY/C;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,aAUzB,CAAC"}

package/dist/src/commands/send.js

@@ -0,0 +1,110 @@
+import { log } from '../logger.js';
+import { sendTestMessage } from '../send/message.js';
+import { sendTestTransfer } from '../send/transfer.js';
+import { chainsCommandOption, coreArtifactsOption, keyCommandOption, } from './options.js';
+/**
+ * Parent command
+ */
+export const sendCommand = {
+    command: 'send',
+    describe: 'Send a test message or transfer',
+    builder: (yargs) => yargs
+        .command(messageCommand)
+        .command(transferCommand)
+        .version(false)
+        .demandCommand(),
+    handler: () => log('Command required'),
+};
+/**
+ * Message command
+ */
+const messageOptions = {
+    key: keyCommandOption,
+    chains: chainsCommandOption,
+    core: coreArtifactsOption,
+    origin: {
+        type: 'string',
+        description: 'Origin chain to send message from',
+        demandOption: true,
+    },
+    destination: {
+        type: 'string',
+        description: 'Destination chain to send message to',
+        demandOption: true,
+    },
+    timeout: {
+        type: 'number',
+        description: 'Timeout in seconds',
+        default: 5 * 60,
+    },
+};
+const messageCommand = {
+    command: 'message',
+    describe: 'Send a test message to a remote chain',
+    builder: (yargs) => yargs.options(messageOptions),
+    handler: async (argv) => {
+        const key = argv.key || process.env.HYP_KEY;
+        const chainConfigPath = argv.chains;
+        const coreArtifactsPath = argv.core;
+        const origin = argv.origin;
+        const destination = argv.destination;
+        const timeout = argv.timeout;
+        await sendTestMessage({
+            key,
+            chainConfigPath,
+            coreArtifactsPath,
+            origin,
+            destination,
+            timeout,
+        });
+        process.exit(0);
+    },
+};
+/**
+ * Transfer command
+ */
+const transferCommand = {
+    command: 'transfer',
+    describe: 'Send a test token transfer on a warp route',
+    builder: (yargs) => yargs.options({
+        ...messageOptions,
+        router: {
+            type: 'string',
+            description: 'The address of the token router contract',
+            demandOption: true,
+        },
+        wei: {
+            type: 'string',
+            description: 'Amount in wei to send',
+            default: 1,
+        },
+        recipient: {
+            type: 'string',
+            description: 'Token recipient address (defaults to sender)',
+        },
+    }),
+    handler: async (argv) => {
+        const key = argv.key || process.env.HYP_KEY;
+        const chainConfigPath = argv.chains;
+        const coreArtifactsPath = argv.core;
+        const origin = argv.origin;
+        const destination = argv.destination;
+        const timeout = argv.timeout;
+        const routerAddress = argv.router;
+        const wei = argv.wei;
+        const recipient = argv.recipient;
+        await sendTestTransfer({
+            key,
+            chainConfigPath,
+            coreArtifactsPath,
+            origin,
+            destination,
+            routerAddress,
+            wei,
+            recipient,
+            timeout,
+        });
+        process.exit(0);
+    },
+};
+//# sourceMappingURL=send.js.map

package/dist/src/commands/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../../src/commands/send.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAkB;IACxC,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,iCAAiC;IAC3C,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK;SACF,OAAO,CAAC,cAAc,CAAC;SACvB,OAAO,CAAC,eAAe,CAAC;SACxB,OAAO,CAAC,KAAK,CAAC;SACd,aAAa,EAAE;IACpB,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,kBAAkB,CAAC;CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,cAAc,GAA6B;IAC/C,GAAG,EAAE,gBAAgB;IACrB,MAAM,EAAE,mBAAmB;IAC3B,IAAI,EAAE,mBAAmB;IACzB,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,mCAAmC;QAChD,YAAY,EAAE,IAAI;KACnB;IACD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,sCAAsC;QACnD,YAAY,EAAE,IAAI;KACnB;IACD,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,oBAAoB;QACjC,OAAO,EAAE,CAAC,GAAG,EAAE;KAChB;CACF,CAAC;AAEF,MAAM,cAAc,GAAkB;IACpC,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,uCAAuC;IACjD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC;IACjD,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,EAAE;QAC3B,MAAM,GAAG,GAAW,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QACpD,MAAM,eAAe,GAAW,IAAI,CAAC,MAAM,CAAC;QAC5C,MAAM,iBAAiB,GAAW,IAAI,CAAC,IAAI,CAAC;QAC5C,MAAM,MAAM,GAAW,IAAI,CAAC,MAAM,CAAC;QACnC,MAAM,WAAW,GAAW,IAAI,CAAC,WAAW,CAAC;QAC7C,MAAM,OAAO,GAAW,IAAI,CAAC,OAAO,CAAC;QACrC,MAAM,eAAe,CAAC;YACpB,GAAG;YACH,eAAe;YACf,iBAAiB;YACjB,MAAM;YACN,WAAW;YACX,OAAO;SACR,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,eAAe,GAAkB;IACrC,OAAO,EAAE,UAAU;IACnB,QAAQ,EAAE,4CAA4C;IACtD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CACjB,KAAK,CAAC,OAAO,CAAC;QACZ,GAAG,cAAc;QACjB,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0CAA0C;YACvD,YAAY,EAAE,IAAI;SACnB;QACD,GAAG,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,uBAAuB;YACpC,OAAO,EAAE,CAAC;SACX;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8CAA8C;SAC5D;KACF,CAAC;IACJ,OAAO,EAAE,KAAK,EAAE,IAAS,EAAE,EAAE;QAC3B,MAAM,GAAG,GAAW,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QACpD,MAAM,eAAe,GAAW,IAAI,CAAC,MAAM,CAAC;QAC5C,MAAM,iBAAiB,GAAW,IAAI,CAAC,IAAI,CAAC;QAC5C,MAAM,MAAM,GAAW,IAAI,CAAC,MAAM,CAAC;QACnC,MAAM,WAAW,GAAW,IAAI,CAAC,WAAW,CAAC;QAC7C,MAAM,OAAO,GAAW,IAAI,CAAC,OAAO,CAAC;QACrC,MAAM,aAAa,GAAW,IAAI,CAAC,MAAM,CAAC;QAC1C,MAAM,GAAG,GAAW,IAAI,CAAC,GAAG,CAAC;QAC7B,MAAM,SAAS,GAAuB,IAAI,CAAC,SAAS,CAAC;QACrD,MAAM,gBAAgB,CAAC;YACrB,GAAG;YACH,eAAe;YACf,iBAAiB;YACjB,MAAM;YACN,WAAW;YACX,aAAa;YACb,GAAG;YACH,SAAS;YACT,OAAO;SACR,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;CACF,CAAC"}