@hyperlane-xyz/cli 1.4.2-beta0

package/dist/src/logger.js

@@ -0,0 +1,25 @@
+import chalk from 'chalk';
+import debug from 'debug';
+const HYPERLANE_NS = 'hyperlane';
+// Default root logger for use in utils/scripts
+export const logger = debug(HYPERLANE_NS);
+export const error = debug(`${HYPERLANE_NS}:ERROR`);
+export function createLogger(namespace, isError = false) {
+    return isError ? error.extend(namespace) : logger.extend(namespace);
+}
+// Ensure hyperlane logging is enabled
+const activeNamespaces = debug.disable();
+const otherNamespaces = activeNamespaces
+    .split(',')
+    .filter((ns) => ns.includes(HYPERLANE_NS));
+const hypNamespaces = `${HYPERLANE_NS},${HYPERLANE_NS}:*`;
+debug.enable(otherNamespaces ? `${otherNamespaces},${hypNamespaces}` : `${hypNamespaces}`);
+// Colored logs directly to console
+export const logBlue = (...args) => console.log(chalk.blue(...args));
+export const logPink = (...args) => console.log(chalk.magentaBright(...args));
+export const logGray = (...args) => console.log(chalk.gray(...args));
+export const logGreen = (...args) => console.log(chalk.green(...args));
+export const logRed = (...args) => console.log(chalk.red(...args));
+export const errorRed = (...args) => console.error(chalk.red(...args));
+export const log = (...args) => console.log(...args);
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,YAAY,GAAG,WAAW,CAAC;AAEjC,+CAA+C;AAC/C,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,YAAY,QAAQ,CAAC,CAAC;AAEpD,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,OAAO,GAAG,KAAK;IAC7D,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACtE,CAAC;AAED,sCAAsC;AACtC,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;AACzC,MAAM,eAAe,GAAG,gBAAgB;KACrC,KAAK,CAAC,GAAG,CAAC;KACV,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;AAC7C,MAAM,aAAa,GAAG,GAAG,YAAY,IAAI,YAAY,IAAI,CAAC;AAC1D,KAAK,CAAC,MAAM,CACV,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,IAAI,aAAa,EAAE,CAAC,CAAC,CAAC,GAAG,aAAa,EAAE,CAC7E,CAAC;AAEF,mCAAmC;AACnC,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAS,EAAE,EAAE,CACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAC5C,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAC1E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AACxE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAS,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,IAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC"}

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

@@ -0,0 +1,10 @@
+import { ChainName } from '@hyperlane-xyz/sdk';
+export declare function sendTestMessage({ key, chainConfigPath, coreArtifactsPath, origin, destination, timeout, }: {
+    key: string;
+    chainConfigPath: string;
+    coreArtifactsPath: string;
+    origin: ChainName;
+    destination: ChainName;
+    timeout: number;
+}): Promise<void>;
+//# sourceMappingURL=message.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/send/message.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,SAAS,EAMV,MAAM,oBAAoB,CAAC;AAa5B,wBAAsB,eAAe,CAAC,EACpC,GAAG,EACH,eAAe,EACf,iBAAiB,EACjB,MAAM,EACN,WAAW,EACX,OAAO,GACR,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,SAAS,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,iBAmBA"}

package/dist/src/send/message.js

@@ -0,0 +1,66 @@
+import { BigNumber } from 'ethers';
+import { HyperlaneCore, HyperlaneIgp, } from '@hyperlane-xyz/sdk';
+import { utils } from '@hyperlane-xyz/utils';
+import { readDeploymentArtifacts } from '../configs.js';
+import { MINIMUM_TEST_SEND_BALANCE } from '../consts.js';
+import { getDeployerContext, getMergedContractAddresses } from '../context.js';
+import { runPreflightChecks } from '../deploy/utils.js';
+import { errorRed, log, logBlue, logGreen } from '../logger.js';
+const GAS_AMOUNT = 300000;
+// TODO improve the UX here by making params optional and
+// prompting for missing values
+export async function sendTestMessage({ key, chainConfigPath, coreArtifactsPath, origin, destination, timeout, }) {
+    const { signer, multiProvider } = getDeployerContext(key, chainConfigPath);
+    const artifacts = coreArtifactsPath
+        ? readDeploymentArtifacts(coreArtifactsPath)
+        : undefined;
+    await runPreflightChecks({
+        local: origin,
+        remotes: [destination],
+        multiProvider,
+        signer,
+        minBalanceWei: MINIMUM_TEST_SEND_BALANCE,
+    });
+    await utils.timeout(executeDelivery({ origin, destination, multiProvider, signer, artifacts }), timeout * 1000, 'Timed out waiting for messages to be delivered');
+}
+async function executeDelivery({ origin, destination, multiProvider, signer, artifacts, }) {
+    const mergedContractAddrs = getMergedContractAddresses(artifacts);
+    const core = HyperlaneCore.fromAddressesMap(mergedContractAddrs, multiProvider);
+    const mailbox = core.getContracts(origin).mailbox;
+    const igp = HyperlaneIgp.fromAddressesMap(mergedContractAddrs, multiProvider);
+    const igpContract = igp.getContracts(origin).defaultIsmInterchainGasPaymaster;
+    const destinationDomain = multiProvider.getDomainId(destination);
+    const signerAddress = await signer.getAddress();
+    let message;
+    try {
+        const recipient = mergedContractAddrs[destination].testRecipient;
+        if (!recipient) {
+            throw new Error(`Unable to find TestRecipient for ${destination}`);
+        }
+        log('Dispatching message');
+        const messageTx = await mailbox.dispatch(destinationDomain, utils.addressToBytes32(recipient), '0x48656c6c6f21');
+        const messageReceipt = await multiProvider.handleTx(origin, messageTx);
+        message = core.getDispatchedMessages(messageReceipt)[0];
+        logBlue(`Sent message from ${origin} to ${recipient} on ${destination}.`);
+        logBlue(`Message ID: ${message.id}`);
+        const value = await igp.quoteGasPaymentForDefaultIsmIgp(origin, destination, BigNumber.from(GAS_AMOUNT));
+        log(`Paying for gas with ${value} wei`);
+        const paymentTx = await igpContract.payForGas(message.id, destinationDomain, GAS_AMOUNT, signerAddress, { value });
+        await paymentTx.wait();
+    }
+    catch (e) {
+        errorRed(`Encountered error sending message from ${origin} to ${destination}`);
+        throw e;
+    }
+    while (true) {
+        const destination = multiProvider.getChainName(message.parsed.destination);
+        const mailbox = core.getContracts(destination).mailbox;
+        const delivered = await mailbox.delivered(message.id);
+        if (delivered)
+            break;
+        log('Waiting for message delivery on destination chain...');
+        await utils.sleep(5000);
+    }
+    logGreen('Message was delivered!');
+}
+//# sourceMappingURL=message.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/send/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAU,MAAM,QAAQ,CAAC;AAE3C,OAAO,EAIL,aAAa,EACb,YAAY,GAEb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,UAAU,GAAG,MAAO,CAAC;AAE3B,yDAAyD;AACzD,+BAA+B;AAC/B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EACpC,GAAG,EACH,eAAe,EACf,iBAAiB,EACjB,MAAM,EACN,WAAW,EACX,OAAO,GAQR;IACC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,kBAAkB,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAC3E,MAAM,SAAS,GAAG,iBAAiB;QACjC,CAAC,CAAC,uBAAuB,CAAC,iBAAiB,CAAC;QAC5C,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,kBAAkB,CAAC;QACvB,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,CAAC,WAAW,CAAC;QACtB,aAAa;QACb,MAAM;QACN,aAAa,EAAE,yBAAyB;KACzC,CAAC,CAAC;IAEH,MAAM,KAAK,CAAC,OAAO,CACjB,eAAe,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAC1E,OAAO,GAAG,IAAI,EACd,gDAAgD,CACjD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,EAC7B,MAAM,EACN,WAAW,EACX,aAAa,EACb,MAAM,EACN,SAAS,GAOV;IACC,MAAM,mBAAmB,GAAG,0BAA0B,CAAC,SAAS,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,aAAa,CAAC,gBAAgB,CACzC,mBAAmB,EACnB,aAAa,CACd,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;IAClD,MAAM,GAAG,GAAG,YAAY,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;IAC9E,MAAM,WAAW,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,gCAAgC,CAAC;IAE9E,MAAM,iBAAiB,GAAG,aAAa,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IACjE,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;IAEhD,IAAI,OAA0B,CAAC;IAC/B,IAAI;QACF,MAAM,SAAS,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC,aAAa,CAAC;QACjE,IAAI,CAAC,SAAS,EAAE;YACd,MAAM,IAAI,KAAK,CAAC,oCAAoC,WAAW,EAAE,CAAC,CAAC;SACpE;QAED,GAAG,CAAC,qBAAqB,CAAC,CAAC;QAC3B,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,QAAQ,CACtC,iBAAiB,EACjB,KAAK,CAAC,gBAAgB,CAAC,SAAS,CAAC,EACjC,gBAAgB,CACjB,CAAC;QACF,MAAM,cAAc,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACvE,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,qBAAqB,MAAM,OAAO,SAAS,OAAO,WAAW,GAAG,CAAC,CAAC;QAC1E,OAAO,CAAC,eAAe,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QAErC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,+BAA+B,CACrD,MAAM,EACN,WAAW,EACX,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAC3B,CAAC;QACF,GAAG,CAAC,uBAAuB,KAAK,MAAM,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,SAAS,CAC3C,OAAO,CAAC,EAAE,EACV,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,EAAE,KAAK,EAAE,CACV,CAAC;QACF,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;KACxB;IAAC,OAAO,CAAC,EAAE;QACV,QAAQ,CACN,0CAA0C,MAAM,OAAO,WAAW,EAAE,CACrE,CAAC;QACF,MAAM,CAAC,CAAC;KACT;IACD,OAAO,IAAI,EAAE;QACX,MAAM,WAAW,GAAG,aAAa,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3E,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC;QACvD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACtD,IAAI,SAAS;YAAE,MAAM;QAErB,GAAG,CAAC,sDAAsD,CAAC,CAAC;QAC5D,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;KACzB;IAED,QAAQ,CAAC,wBAAwB,CAAC,CAAC;AACrC,CAAC"}

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

@@ -0,0 +1,14 @@
+import { ChainName } from '@hyperlane-xyz/sdk';
+import { types } from '@hyperlane-xyz/utils';
+export declare function sendTestTransfer({ key, chainConfigPath, coreArtifactsPath, origin, destination, routerAddress, wei, recipient, timeout, }: {
+    key: string;
+    chainConfigPath: string;
+    coreArtifactsPath: string;
+    origin: ChainName;
+    destination: ChainName;
+    routerAddress: types.Address;
+    wei: string;
+    recipient?: string;
+    timeout: number;
+}): Promise<void>;
+//# sourceMappingURL=transfer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../../src/send/transfer.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,SAAS,EAIV,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAS,MAAM,sBAAsB,CAAC;AAWpD,wBAAsB,gBAAgB,CAAC,EACrC,GAAG,EACH,eAAe,EACf,iBAAiB,EACjB,MAAM,EACN,WAAW,EACX,aAAa,EACb,GAAG,EACH,SAAS,EACT,OAAO,GACR,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,SAAS,CAAC;IACvB,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,iBAmCA"}

package/dist/src/send/transfer.js

@@ -0,0 +1,95 @@
+import assert from 'assert';
+import { ethers } from 'ethers';
+import { ERC20__factory, HypERC20App, HypERC20Collateral__factory, } from '@hyperlane-xyz/hyperlane-token';
+import { HyperlaneCore, } from '@hyperlane-xyz/sdk';
+import { utils } from '@hyperlane-xyz/utils';
+import { readDeploymentArtifacts } from '../configs.js';
+import { MINIMUM_TEST_SEND_BALANCE } from '../consts.js';
+import { getDeployerContext, getMergedContractAddresses } from '../context.js';
+import { runPreflightChecks } from '../deploy/utils.js';
+import { log, logBlue, logGreen } from '../logger.js';
+import { assertTokenBalance } from '../utils/balances.js';
+// TODO improve the UX here by making params optional and
+// prompting for missing values
+export async function sendTestTransfer({ key, chainConfigPath, coreArtifactsPath, origin, destination, routerAddress, wei, recipient, timeout, }) {
+    const { signer, multiProvider } = getDeployerContext(key, chainConfigPath);
+    const artifacts = coreArtifactsPath
+        ? readDeploymentArtifacts(coreArtifactsPath)
+        : undefined;
+    await assertTokenBalance(multiProvider, signer, origin, routerAddress, wei.toString());
+    await runPreflightChecks({
+        local: origin,
+        remotes: [destination],
+        multiProvider,
+        signer,
+        minBalanceWei: MINIMUM_TEST_SEND_BALANCE,
+    });
+    await utils.timeout(executeDelivery({
+        origin,
+        destination,
+        routerAddress,
+        wei,
+        recipient,
+        signer,
+        multiProvider,
+        artifacts,
+    }), timeout * 1000, 'Timed out waiting for messages to be delivered');
+}
+async function executeDelivery({ origin, destination, routerAddress, wei, recipient, multiProvider, signer, artifacts, }) {
+    const signerAddress = await signer.getAddress();
+    recipient || (recipient = signerAddress);
+    const mergedContractAddrs = getMergedContractAddresses(artifacts);
+    const core = HyperlaneCore.fromAddressesMap(mergedContractAddrs, multiProvider);
+    const provider = multiProvider.getProvider(origin);
+    const connectedSigner = signer.connect(provider);
+    const wrappedToken = await getWrappedToken(routerAddress, provider);
+    if (wrappedToken) {
+        const token = ERC20__factory.connect(wrappedToken, connectedSigner);
+        const approval = await token.allowance(signerAddress, routerAddress);
+        if (approval.lt(wei)) {
+            const approveTx = await token.approve(routerAddress, wei);
+            await approveTx.wait();
+        }
+    }
+    else {
+        // TODO finish support for other types
+        // See code in warp UI for an example
+        // Requires gas handling
+        throw new Error('Sorry, only HypERC20Collateral transfers are currently supported in the CLI');
+    }
+    const app = new HypERC20App({
+        [origin]: {
+            router: HypERC20Collateral__factory.connect(routerAddress, connectedSigner),
+        },
+    }, multiProvider);
+    const receipt = await app.transfer(origin, destination, recipient, wei);
+    const message = core.getDispatchedMessages(receipt)[0];
+    logBlue(`Sent message from ${origin} to ${recipient} on ${destination}.`);
+    logBlue(`Message ID: ${message.id}`);
+    const msgDestination = multiProvider.getChainName(message.parsed.destination);
+    assert(destination === msgDestination);
+    while (true) {
+        const mailbox = core.getContracts(destination).mailbox;
+        const delivered = await mailbox.delivered(message.id);
+        if (delivered)
+            break;
+        log('Waiting for message delivery on destination chain...');
+        await utils.sleep(5000);
+    }
+    logGreen(`Transfer sent to destination chain!`);
+}
+async function getWrappedToken(address, provider) {
+    try {
+        const contract = HypERC20Collateral__factory.connect(address, provider);
+        const wrappedToken = await contract.wrappedToken();
+        if (ethers.utils.isAddress(wrappedToken))
+            return wrappedToken;
+        else
+            return null;
+    }
+    catch (error) {
+        // Token isn't a HypERC20Collateral
+        return null;
+    }
+}
+//# sourceMappingURL=transfer.js.map

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

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

package/dist/src/utils/balances.d.ts

@@ -0,0 +1,6 @@
+import { ethers } from 'ethers';
+import { ChainName, MultiProvider } from '@hyperlane-xyz/sdk';
+import { types } from '@hyperlane-xyz/utils';
+export declare function assertNativeBalances(multiProvider: MultiProvider, signer: ethers.Signer, chains: ChainName[], minBalanceWei: string): Promise<void>;
+export declare function assertTokenBalance(multiProvider: MultiProvider, signer: ethers.Signer, chain: ChainName, token: types.Address, minBalanceWei: string): Promise<void>;
+//# sourceMappingURL=balances.d.ts.map

package/dist/src/utils/balances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balances.d.ts","sourceRoot":"","sources":["../../../src/utils/balances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,MAAM,EAAE,SAAS,EAAE,EACnB,aAAa,EAAE,MAAM,iBAgBtB;AAED,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,KAAK,CAAC,OAAO,EACpB,aAAa,EAAE,MAAM,iBAUtB"}

package/dist/src/utils/balances.js

@@ -0,0 +1,23 @@
+import { ethers } from 'ethers';
+import { ERC20__factory } from '@hyperlane-xyz/hyperlane-token';
+export async function assertNativeBalances(multiProvider, signer, chains, minBalanceWei) {
+    const address = await signer.getAddress();
+    const minBalance = ethers.utils.formatEther(minBalanceWei.toString());
+    await Promise.all(chains.map(async (chain) => {
+        const balanceWei = await multiProvider
+            .getProvider(chain)
+            .getBalance(address);
+        const balance = ethers.utils.formatEther(balanceWei);
+        if (balanceWei.lte(minBalanceWei))
+            throw new Error(`${address} has insufficient balance on ${chain}. At least ${minBalance} required but found ${balance.toString()} ETH`);
+    }));
+}
+export async function assertTokenBalance(multiProvider, signer, chain, token, minBalanceWei) {
+    const address = await signer.getAddress();
+    const provider = multiProvider.getProvider(chain);
+    const tokenContract = ERC20__factory.connect(token, provider);
+    const balanceWei = await tokenContract.balanceOf(address);
+    if (balanceWei.lte(minBalanceWei))
+        throw new Error(`${address} has insufficient balance on ${chain} for token ${token}. At least ${minBalanceWei} wei required but found ${balanceWei.toString()} wei`);
+}
+//# sourceMappingURL=balances.js.map

package/dist/src/utils/balances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balances.js","sourceRoot":"","sources":["../../../src/utils/balances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIhE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,aAA4B,EAC5B,MAAqB,EACrB,MAAmB,EACnB,aAAqB;IAErB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtE,MAAM,OAAO,CAAC,GAAG,CACf,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACzB,MAAM,UAAU,GAAG,MAAM,aAAa;aACnC,WAAW,CAAC,KAAK,CAAC;aAClB,UAAU,CAAC,OAAO,CAAC,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QACrD,IAAI,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC;YAC/B,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,gCAAgC,KAAK,cAAc,UAAU,uBAAuB,OAAO,CAAC,QAAQ,EAAE,MAAM,CACvH,CAAC;IACN,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,aAA4B,EAC5B,MAAqB,EACrB,KAAgB,EAChB,KAAoB,EACpB,aAAqB;IAErB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAG,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,aAAa,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,gCAAgC,KAAK,cAAc,KAAK,cAAc,aAAa,2BAA2B,UAAU,CAAC,QAAQ,EAAE,MAAM,CACpJ,CAAC;AACN,CAAC"}

package/dist/src/utils/files.d.ts

@@ -0,0 +1,19 @@
+export type FileFormat = 'yaml' | 'json';
+export declare function readFileAtPath(filepath: string): string;
+export declare function writeFileAtPath(filepath: string, value: string): void;
+export declare function readJson<T>(filepath: string): T;
+export declare function tryReadJson<T>(filepath: string): T | null;
+export declare function writeJson(filepath: string, obj: any): void;
+export declare function mergeJson<T extends Record<string, any>>(filepath: string, obj: T): void;
+export declare function readYaml<T>(filepath: string): T;
+export declare function tryReadYamlAtPath<T>(filepath: string): T | null;
+export declare function writeYaml(filepath: string, obj: any): void;
+export declare function mergeYaml<T extends Record<string, any>>(filepath: string, obj: T): void;
+export declare function readYamlOrJson<T>(filepath: string, format?: FileFormat): T;
+export declare function writeYamlOrJson(filepath: string, obj: Record<string, any>, format?: FileFormat): any;
+export declare function mergeYamlOrJson(filepath: string, obj: Record<string, any>, format?: FileFormat): any;
+export declare function prepNewArtifactsFiles(outPath: string, files: Array<{
+    filename: string;
+    description: string;
+}>): string[];
+//# sourceMappingURL=files.d.ts.map

package/dist/src/utils/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../src/utils/files.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,UAK9C;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAM9D;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAE/C;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAMzD;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,QAEnD;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrD,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,CAAC,QAQP;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,CAE/C;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAM/D;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,QAEnD;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrD,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,CAAC,QAQP;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,CAAC,CAE1E;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,MAAM,CAAC,EAAE,UAAU,OAQpB;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,MAAM,CAAC,EAAE,UAAU,OAQpB;AAqBD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,YAYxD"}

package/dist/src/utils/files.js

@@ -0,0 +1,100 @@
+import fs from 'fs';
+import path from 'path';
+import { parse as yamlParse, stringify as yamlStringify } from 'yaml';
+import { objMerge } from '@hyperlane-xyz/sdk';
+import { logBlue } from '../logger.js';
+import { getTimestampForFilename } from './time.js';
+export function readFileAtPath(filepath) {
+    if (!fs.existsSync(filepath)) {
+        throw Error(`File doesn't exist at ${filepath}`);
+    }
+    return fs.readFileSync(filepath, 'utf8');
+}
+export function writeFileAtPath(filepath, value) {
+    const dirname = path.dirname(filepath);
+    if (!fs.existsSync(dirname)) {
+        fs.mkdirSync(dirname, { recursive: true });
+    }
+    fs.writeFileSync(filepath, value);
+}
+export function readJson(filepath) {
+    return JSON.parse(readFileAtPath(filepath));
+}
+export function tryReadJson(filepath) {
+    try {
+        return readJson(filepath);
+    }
+    catch (error) {
+        return null;
+    }
+}
+export function writeJson(filepath, obj) {
+    writeFileAtPath(filepath, JSON.stringify(obj, null, 2) + '\n');
+}
+export function mergeJson(filepath, obj) {
+    if (fs.existsSync(filepath)) {
+        const previous = readJson(filepath);
+        writeJson(filepath, objMerge(previous, obj));
+    }
+    else {
+        writeJson(filepath, obj);
+    }
+}
+export function readYaml(filepath) {
+    return yamlParse(readFileAtPath(filepath));
+}
+export function tryReadYamlAtPath(filepath) {
+    try {
+        return readYaml(filepath);
+    }
+    catch (error) {
+        return null;
+    }
+}
+export function writeYaml(filepath, obj) {
+    writeFileAtPath(filepath, yamlStringify(obj, null, 2) + '\n');
+}
+export function mergeYaml(filepath, obj) {
+    if (fs.existsSync(filepath)) {
+        const previous = readYaml(filepath);
+        writeYaml(filepath, objMerge(previous, obj));
+    }
+    else {
+        writeYaml(filepath, obj);
+    }
+}
+export function readYamlOrJson(filepath, format) {
+    return resolveYamlOrJson(filepath, readJson, readYaml, format);
+}
+export function writeYamlOrJson(filepath, obj, format) {
+    return resolveYamlOrJson(filepath, (f) => writeJson(f, obj), (f) => writeYaml(f, obj), format);
+}
+export function mergeYamlOrJson(filepath, obj, format) {
+    return resolveYamlOrJson(filepath, (f) => mergeJson(f, obj), (f) => mergeYaml(f, obj), format);
+}
+function resolveYamlOrJson(filepath, jsonFn, yamlFn, format) {
+    if (format === 'json' || filepath.endsWith('.json')) {
+        return jsonFn(filepath);
+    }
+    else if (format === 'yaml' ||
+        filepath.endsWith('.yaml') ||
+        filepath.endsWith('.yml')) {
+        return yamlFn(filepath);
+    }
+    else {
+        throw new Error(`Invalid file format for ${filepath}`);
+    }
+}
+export function prepNewArtifactsFiles(outPath, files) {
+    const timestamp = getTimestampForFilename();
+    const newPaths = [];
+    for (const file of files) {
+        const filePath = path.join(outPath, `${file.filename}-${timestamp}.json`);
+        // Write empty object to ensure permissions are okay
+        writeJson(filePath, {});
+        newPaths.push(filePath);
+        logBlue(`${file.description} will be written to ${filePath}`);
+    }
+    return newPaths;
+}
+//# sourceMappingURL=files.js.map

package/dist/src/utils/files.js.map

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

package/dist/src/utils/keys.d.ts

@@ -0,0 +1,4 @@
+import { ethers } from 'ethers';
+export declare function keyToSigner(key: string): ethers.Wallet;
+export declare function assertSigner(signer: ethers.Signer): void;
+//# sourceMappingURL=keys.d.ts.map

package/dist/src/utils/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/utils/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,iBAQtC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,QAGjD"}

package/dist/src/utils/keys.js

@@ -0,0 +1,17 @@
+import { ethers } from 'ethers';
+export function keyToSigner(key) {
+    if (!key)
+        throw new Error('No key provided');
+    const formattedKey = key.trim().toLowerCase();
+    if (ethers.utils.isHexString(formattedKey))
+        return new ethers.Wallet(formattedKey);
+    else if (formattedKey.split(' ').length >= 6)
+        return ethers.Wallet.fromMnemonic(formattedKey);
+    else
+        throw new Error('Invalid key format');
+}
+export function assertSigner(signer) {
+    if (!signer || !ethers.Signer.isSigner(signer))
+        throw new Error('Signer is invalid');
+}
+//# sourceMappingURL=keys.js.map

package/dist/src/utils/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/utils/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,YAAY,CAAC;QACxC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;SACpC,IAAI,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC;QAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;;QAC7C,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;AACzC,CAAC"}

package/dist/src/utils/time.d.ts

@@ -0,0 +1,2 @@
+export declare function getTimestampForFilename(): string;
+//# sourceMappingURL=time.d.ts.map

package/dist/src/utils/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../../src/utils/time.ts"],"names":[],"mappings":"AAAA,wBAAgB,uBAAuB,WAGtC"}

package/dist/src/utils/time.js

@@ -0,0 +1,5 @@
+export function getTimestampForFilename() {
+    const now = new Date();
+    return `${now.getFullYear()}-${now.getMonth()}-${now.getDate()}-${now.getHours()}-${now.getMinutes()}`;
+}
+//# sourceMappingURL=time.js.map

package/dist/src/utils/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../../src/utils/time.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,uBAAuB;IACrC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC;AACzG,CAAC"}

package/examples/chain-config.yaml

@@ -0,0 +1,44 @@
+# Configs for describing chain metadata for use in Hyperlane deployments or apps
+# Consists of a map of chain names to metadata
+# Schema here: https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/main/typescript/sdk/src/metadata/chainMetadataTypes.ts
+---
+mychainname:
+  # Required fields:
+  chainId: 1234567890 # Number: Use EIP-155 for EVM chains
+  domainId: 1234567890 # Number: Recommend matching chainId when possible
+  name: mychainname # String: Unique identifier for the chain, must match key above
+  protocol: ethereum # ProtocolType: Ethereum, Sealevel, etc.
+  rpcUrls: # Array: List of RPC configs
+    # Only http field is required
+    - http: https://mychain.com/rpc # String: HTTP URL of the RPC endpoint (preferably HTTPS)
+      # Others here are optional
+      pagination:
+        maxBlockRange: 1000 # Number
+        maxBlockAge: 1000 # Number
+        minBlockNumber: 1000 # Number
+      retry:
+        maxRequests: 5 # Number
+        baseRetryMs: 1000 # Number
+  # Optional fields, not required for Hyperlane deployments but useful for apps:
+  isTestnet: false # Boolean: Whether the chain is considered a testnet or a mainnet
+  blockExplorers: # Array: List of BlockExplorer configs
+    # Required fields:
+    - name: My Chain Explorer # String: Human-readable name for the explorer
+      url: https://mychain.com/explorer # String: Base URL for the explorer
+      apiUrl: https://mychain.com/api # String: Base URL for the explorer API
+      # Optional fields:
+      apiKey: myapikey # String: API key for the explorer (optional)
+      family: etherscan # ExplorerFamily: See ExplorerFamily for valid values
+  nativeToken:
+    name: Eth # String
+    symbol: ETH # String
+    decimals: 18 # Number
+  displayName: My Chain Name # String: Human-readable name of the chain
+  displayNameShort: My Chain # String: A shorter human-readable name
+  logoURI: https://mychain.com/logo.png # String: URI to a logo image for the chain
+  blocks:
+    confirmations: 12 # Number: Blocks to wait before considering a transaction confirmed
+    reorgPeriod: 100 # Number: Blocks before a transaction has a near-zero chance of reverting
+    estimateBlockTime: 15 # Number: Rough estimate of time per block in seconds
+  # transactionOverrides: # Object: Properties to include when forming transaction requests
+  # Any tx fields are allowed

package/examples/contract-artifacts.yaml

@@ -0,0 +1,20 @@
+# Artifacts representing contract addresses
+# Typically not written by hand but generated as JSON by the deploy command
+# Consists of a map of chain names to contract names to addresses
+---
+mychainname:
+  storageGasOracle: '0xD9A9966E7dA9a7f0032bF449FB12696a638E673C'
+  validatorAnnounce: '0x9bBdef63594D5FFc2f370Fe52115DdFFe97Bc524'
+  proxyAdmin: '0x90f9a2E9eCe93516d65FdaB726a3c62F5960a1b9'
+  mailbox: '0x35231d4c2D8B8ADcB5617A638A0c4548684c7C70'
+  interchainGasPaymaster: '0x6cA0B6D22da47f091B7613223cD4BB03a2d77918'
+  defaultIsmInterchainGasPaymaster: '0x56f52c0A1ddcD557285f7CBc782D3d83096CE1Cc'
+  multisigIsm: '0x9bDE63104EE030d9De419EEd6bA7D14b86D6fE3f'
+  testRecipient: '0x36FdA966CfffF8a9Cdc814f546db0e6378bFef35'
+  interchainAccountIsm: '0x5e8ee6840caa4f367aff1FF28aA36D5B1b836d35'
+  aggregationIsmFactory: '0xc864fa3B662613cA5051f41e157d0a997f9a5A87'
+  routingIsmFactory: '0x1fdfD1486b8339638C6b92f8a96D698D8182D2b1'
+  interchainQueryRouter: '0xA837e38C3F7D509DF3a7a0fCf65E3814DB6c2618'
+  interchainAccountRouter: '0x9521291A43ebA3aD3FD24d610F4b7F7543C8d761'
+  merkleRootMultisigIsmFactory: '0x82140b2ddAd4E4dd7e1D6757Fb5F9485c230B79d'
+  messageIdMultisigIsmFactory: '0x1079056da3EC7D55521F27e1E094015C0d39Cc65'

package/examples/multisig-ism.yaml

@@ -0,0 +1,20 @@
+# A config for a multisig Interchain Security Module (ISM)
+# Schema: https://github.com/hyperlane-xyz/hyperlane-monorepo/blob/main/typescript/sdk/src/ism/types.ts
+# Module types:
+#   UNUSED : 0
+#   ROUTING : 1
+#   AGGREGATION : 2
+#   LEGACY_MULTISIG : 3
+#   MERKLE_ROOT_MULTISIG : 4
+#   MESSAGE_ID_MULTISIG : 5
+---
+anvil1:
+  type: 3 # ModuleType.LEGACY_MULTISIG
+  threshold: 1 # Number: Signatures required to approve a message
+  validators: # Array: List of validator configs
+    - '0xa0ee7a142d267c1f36714e4a8f75612f20a79720'
+anvil2:
+  type: 3
+  threshold: 1
+  validators:
+    - '0xa0ee7a142d267c1f36714e4a8f75612f20a79720'

package/examples/warp-tokens.yaml

@@ -0,0 +1,23 @@
+# A config for a Warp Route deployment
+# Typically used with the 'hyperlane deploy warp' command
+# Token Types:
+#   synthetic
+#   syntheticUri
+#   collateral
+#   collateralUri
+#   native
+---
+base:
+  chainName: anvil1
+  type: native
+  # address: 0x123... # Required for collateral types)
+  # isNft: true # If the token is an NFT (ERC721), set to true)
+  # owner: 0x123 # Optional owner address for synthetic token
+  # mailbox: 0x123 # Optional mailbox address route
+  # interchainGasPaymaster: 0x123 # Optional interchainGasPaymaster address
+synthetics:
+  - chainName: anvil2
+  # You can optionally set the token metadata, otherwise the base token's will be used
+  # name: "MySyntheticToken"
+  # symbol: "MST"
+  # totalSupply: 10000000