@graphprotocol/graph-cli 0.40.0 → 0.40.1-alpha-20230216174117-760a195

package/dist/commands/init.js

@@ -29,357 +29,55 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const fs_1 = __importDefault(require("fs"));
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
-const chalk_1 = __importDefault(require("chalk"));
-const graphCli = __importStar(require("../cli"));
+const core_1 = require("@oclif/core");
+const gluegun_1 = require("gluegun");
 const abi_1 = require("../command-helpers/abi");
 const DataSourcesExtractor = __importStar(require("../command-helpers/data-sources"));
-const gluegun_1 = require("../command-helpers/gluegun");
 const network_1 = require("../command-helpers/network");
 const node_1 = require("../command-helpers/node");
 const scaffold_1 = require("../command-helpers/scaffold");
 const spinner_1 = require("../command-helpers/spinner");
 const studio_1 = require("../command-helpers/studio");
 const subgraph_1 = require("../command-helpers/subgraph");
-const debug_1 = __importDefault(require("../debug"));
 const protocols_1 = __importDefault(require("../protocols"));
 const schema_1 = require("../scaffold/schema");
 const validation_1 = require("../validation");
-const abi_2 = require("./../command-helpers/abi");
+const add_1 = __importDefault(require("./add"));
 const protocolChoices = Array.from(protocols_1.default.availableProtocols().keys());
 const availableNetworks = protocols_1.default.availableNetworks();
 const DEFAULT_EXAMPLE_SUBGRAPH = 'ethereum/gravatar';
-const initDebug = (0, debug_1.default)('graph-cli:init');
-const HELP = `
-${chalk_1.default.bold('graph init')} [options] [subgraph-name] [directory]
-
-${chalk_1.default.dim('Options:')}
-
-      --protocol <${protocolChoices.join('|')}>
-      --product <subgraph-studio|hosted-service>
-                                 Selects the product for which to initialize
-      --studio                   Shortcut for --product subgraph-studio
-  -g, --node <node>              Graph node for which to initialize
-      --allow-simple-name        Use a subgraph name without a prefix (default: false)
-  -h, --help                     Show usage information
-
-${chalk_1.default.dim('Choose mode with one of:')}
-
-      --from-contract <contract> Creates a scaffold based on an existing contract
-      --from-example [example]   Creates a scaffold based on an example subgraph
-
-${chalk_1.default.dim('Options for --from-contract:')}
-
-      --contract-name            Name of the contract (default: Contract)
-      --index-events             Index contract events as entities
-      --start-block              Block number to start indexing from (default: 0)
-
-${chalk_1.default.dim.underline('Ethereum:')}
-
-      --abi <path>               Path to the contract ABI (default: download from Etherscan)
-      --network <${availableNetworks.get('ethereum').join('|')}>
-                                 Selects the network the contract is deployed to
-
-${chalk_1.default.dim.underline('NEAR:')}
-
-      --network <${availableNetworks.get('near').join('|')}>
-                                 Selects the network the contract is deployed to
-
-${chalk_1.default.dim.underline('Cosmos:')}
-
-      --network <${availableNetworks.get('cosmos').join('|')}>
-                                 Selects the network the contract is deployed to
-`;
-const processInitForm = async (toolbox, { protocol, product, studio, node, abi, allowSimpleName, directory, contract, indexEvents, fromExample, network, subgraphName, contractName, startBlock, }) => {
-    let abiFromEtherscan = undefined;
-    let abiFromFile = undefined;
-    let protocolInstance;
-    let ProtocolContract;
-    let ABI;
-    const questions = [
-        {
-            type: 'select',
-            name: 'protocol',
-            message: 'Protocol',
-            choices: protocolChoices,
-            skip: protocolChoices.includes(protocol),
-            result: (value) => {
-                protocol || (protocol = value);
-                protocolInstance = new protocols_1.default(protocol);
-                return protocol;
-            },
-        },
-        {
-            type: 'select',
-            name: 'product',
-            message: 'Product for which to initialize',
-            choices: ['subgraph-studio', 'hosted-service'],
-            skip: () => protocol === 'arweave' ||
-                protocol === 'cosmos' ||
-                protocol === 'near' ||
-                product === 'subgraph-studio' ||
-                product === 'hosted-service' ||
-                studio !== undefined ||
-                node !== undefined,
-            result: (value) => {
-                // For now we only support NEAR subgraphs in the Hosted Service
-                if (protocol === 'near') {
-                    // Can be overwritten because the question will be skipped (product === undefined)
-                    product = 'hosted-service';
-                    return product;
-                }
-                if (value == 'subgraph-studio') {
-                    allowSimpleName = true;
-                }
-                product = value;
-                return value;
-            },
-        },
-        {
-            type: 'input',
-            name: 'subgraphName',
-            message: () => (product == 'subgraph-studio' || studio ? 'Subgraph slug' : 'Subgraph name'),
-            initial: subgraphName,
-            validate: (name) => {
-                try {
-                    (0, subgraph_1.validateSubgraphName)(name, { allowSimpleName });
-                    return true;
-                }
-                catch (e) {
-                    return `${e.message}
-
-  Examples:
-
-    $ graph init ${os_1.default.userInfo().username}/${name}
-    $ graph init ${name} --allow-simple-name`;
-                }
-            },
-            result: (value) => {
-                subgraphName = value;
-                return value;
-            },
-        },
-        {
-            type: 'input',
-            name: 'directory',
-            message: 'Directory to create the subgraph in',
-            initial: () => directory || (0, subgraph_1.getSubgraphBasename)(subgraphName),
-            validate: (value) => toolbox.filesystem.exists(value || directory || (0, subgraph_1.getSubgraphBasename)(subgraphName))
-                ? 'Directory already exists'
-                : true,
-        },
-        {
-            type: 'select',
-            name: 'network',
-            message: () => `${protocolInstance.displayName()} network`,
-            choices: () => {
-                initDebug('Generating list of available networks for protocol "%s" (%M)', protocol, availableNetworks.get(protocol));
-                return (
-                // @ts-expect-error TODO: wait what?
-                availableNetworks
-                    .get(protocol) // Get networks related to the chosen protocol.
-                    // @ts-expect-error TODO: wait what?
-                    .toArray()); // Needed because of gluegun. It can't even receive a JS iterable.
-            },
-            skip: fromExample !== undefined,
-            initial: network || 'mainnet',
-            result: (value) => {
-                network = value;
-                return value;
-            },
-        },
-        // TODO:
-        //
-        // protocols that don't support contract
-        // - arweave
-        // - cosmos
-        {
-            type: 'input',
-            name: 'contract',
-            message: () => {
-                ProtocolContract = protocolInstance.getContract();
-                return `Contract ${ProtocolContract.identifierName()}`;
-            },
-            skip: () => fromExample !== undefined || !protocolInstance.hasContract(),
-            initial: contract,
-            validate: async (value) => {
-                if (fromExample !== undefined || !protocolInstance.hasContract()) {
-                    return true;
-                }
-                // Validate whether the contract is valid
-                const { valid, error } = (0, validation_1.validateContract)(value, ProtocolContract);
-                return valid ? true : error;
-            },
-            result: async (value) => {
-                if (fromExample !== undefined) {
-                    return value;
-                }
-                ABI = protocolInstance.getABI();
-                // Try loading the ABI from Etherscan, if none was provided
-                if (protocolInstance.hasABIs() && !abi) {
-                    try {
-                        if (network === 'poa-core') {
-                            // TODO: this variable is never used anywhere, what happens?
-                            // abiFromBlockScout = await loadAbiFromBlockScout(ABI, network, value)
-                        }
-                        else {
-                            abiFromEtherscan = await (0, abi_1.loadAbiFromEtherscan)(ABI, network, value);
-                        }
-                    }
-                    catch (e) {
-                        // noop
-                    }
-                }
-                // If startBlock is not set, try to load it.
-                if (!startBlock) {
-                    try {
-                        // Load startBlock for this contract
-                        startBlock = Number(await (0, abi_2.loadStartBlockForContract)(network, value)).toString();
-                    }
-                    catch (error) {
-                        // noop
-                    }
-                }
-                return value;
-            },
-        },
-        {
-            type: 'input',
-            name: 'abi',
-            message: 'ABI file (path)',
-            initial: abi,
-            skip: () => !protocolInstance.hasABIs() || fromExample !== undefined || abiFromEtherscan !== undefined,
-            validate: async (value) => {
-                if (fromExample || abiFromEtherscan || !protocolInstance.hasABIs()) {
-                    return true;
-                }
-                try {
-                    abiFromFile = loadAbiFromFile(toolbox, ABI, value);
-                    return true;
-                }
-                catch (e) {
-                    return e.message;
-                }
-            },
-        },
-        {
-            type: 'input',
-            name: 'startBlock',
-            message: 'Start Block',
-            initial: () => startBlock || '0',
-            skip: () => fromExample !== undefined,
-            validate: (value) => parseInt(value) >= 0,
-            result: (value) => {
-                startBlock = value;
-                return value;
-            },
-        },
-        {
-            type: 'input',
-            name: 'contractName',
-            message: 'Contract Name',
-            initial: contractName || 'Contract',
-            skip: () => fromExample !== undefined || !protocolInstance.hasContract(),
-            validate: (value) => value && value.length > 0,
-            result: (value) => {
-                contractName = value;
-                return value;
-            },
-        },
-        {
-            type: 'confirm',
-            name: 'indexEvents',
-            message: 'Index contract events as entities',
-            initial: true,
-            skip: () => !!indexEvents,
-            result: (value) => {
-                indexEvents = value;
-                return value;
-            },
-        },
-    ];
-    try {
-        const answers = await toolbox.prompt.ask(
-        // @ts-expect-error questions do somehow fit
-        questions);
-        return {
-            ...answers,
-            abi: (abiFromEtherscan || abiFromFile),
-            protocolInstance,
-        };
-    }
-    catch (e) {
-        return undefined;
-    }
-};
-const loadAbiFromFile = (toolbox, ABI, filename) => {
-    const exists = toolbox.filesystem.exists(filename);
-    if (!exists) {
-        throw Error('File does not exist.');
-    }
-    else if (exists === 'dir') {
-        throw Error('Path points to a directory, not a file.');
-    }
-    else if (exists === 'other') {
-        throw Error('Not sure what this path points to.');
-    }
-    else {
-        return ABI.load('Contract', filename);
-    }
-};
-exports.default = {
-    description: 'Creates a new subgraph with basic scaffolding',
-    run: async (toolbox) => {
-        // Obtain tools
-        const { print, system } = toolbox;
-        // Read CLI parameters
-        let { protocol, product, studio, node, g, abi, allowSimpleName, fromContract, contractName, fromExample, h, help, indexEvents, network, startBlock, } = toolbox.parameters.options;
-        startBlock && (startBlock = Number(startBlock).toString());
-        node || (node = g);
-        ({ node, allowSimpleName } = (0, node_1.chooseNodeUrl)({
+class InitCommand extends core_1.Command {
+    async run() {
+        const { args: { subgraphName, directory }, flags: { protocol: protocolFlag, product, studio, node: nodeFlag, 'allow-simple-name': allowSimpleNameFlag, 'from-contract': fromContract, 'contract-name': contractName, 'from-example': fromExample, 'index-events': indexEvents, network, abi: abiPath, 'start-block': startBlock, }, } = await this.parse(InitCommand);
+        const protocol = protocolFlag;
+        if (!protocolChoices.includes(protocol)) {
+            this.error(`Invalid protocol "${protocol}" provided. Supported protocols are: ${protocolChoices.join(', ')}.`, { exit: 1 });
+        }
+        let { node, allowSimpleName } = (0, node_1.chooseNodeUrl)({
             product,
             studio,
-            node,
-            allowSimpleName,
-        }));
+            node: nodeFlag,
+            allowSimpleName: allowSimpleNameFlag,
+        });
         if (fromContract && fromExample) {
-            print.error(`Only one of --from-example and --from-contract can be used at a time.`);
-            process.exitCode = 1;
-            return;
-        }
-        let subgraphName, directory;
-        try {
-            [subgraphName, directory] = (0, gluegun_1.fixParameters)(toolbox.parameters, {
-                allowSimpleName,
-                help,
-                h,
-                indexEvents,
-                studio,
+            this.error('Only one of "--from-example" and "--from-contract" can be used at a time.', {
+                exit: 1,
             });
         }
-        catch (e) {
-            print.error(e.message);
-            process.exitCode = 1;
-            return;
-        }
-        // Show help text if requested
-        if (help || h) {
-            print.info(HELP);
-            return;
-        }
         // Detect git
-        const git = system.which('git');
-        if (git === null) {
-            print.error(`Git was not found on your system. Please install 'git' so it is in $PATH.`);
-            process.exitCode = 1;
-            return;
+        const git = gluegun_1.system.which('git');
+        if (!git) {
+            this.error('Git was not found on your system. Please install "git" so it is in $PATH.', {
+                exit: 1,
+            });
         }
         // Detect Yarn and/or NPM
-        const yarn = system.which('yarn');
-        const npm = system.which('npm');
+        const yarn = gluegun_1.system.which('yarn');
+        const npm = gluegun_1.system.which('npm');
         if (!yarn && !npm) {
-            print.error(`Neither Yarn nor NPM were found on your system. Please install one of them.`);
-            process.exitCode = 1;
-            return;
+            this.error(`Neither Yarn nor NPM were found on your system. Please install one of them.`, {
+                exit: 1,
+            });
         }
         const commands = {
             link: yarn ? 'yarn link @graphprotocol/graph-cli' : 'npm link @graphprotocol/graph-cli',
@@ -390,27 +88,25 @@ exports.default = {
         // If all parameters are provided from the command-line,
         // go straight to creating the subgraph from the example
         if (fromExample && subgraphName && directory) {
-            return await initSubgraphFromExample(toolbox, { fromExample, allowSimpleName, directory, subgraphName, studio, product }, { commands });
+            return await initSubgraphFromExample.bind(this)({ fromExample, allowSimpleName, directory, subgraphName, studio, product: product }, { commands });
         }
+        // Will be assigned below if ethereum
+        let abi;
+        const protocolInstance = new protocols_1.default(protocol);
         // If all parameters are provided from the command-line,
         // go straight to creating the subgraph from an existing contract
         if (fromContract && protocol && subgraphName && directory && network && node) {
             if (!protocolChoices.includes(protocol)) {
-                print.error(`Protocol '${protocol}' is not supported, choose from these options: ${protocolChoices.join(', ')}`);
-                process.exitCode = 1;
-                return;
+                this.error(`Protocol '${protocol}' is not supported, choose from these options: ${protocolChoices.join(', ')}`, { exit: 1 });
             }
-            const protocolInstance = new protocols_1.default(protocol);
             if (protocolInstance.hasABIs()) {
                 const ABI = protocolInstance.getABI();
-                if (abi) {
+                if (abiPath) {
                     try {
-                        abi = loadAbiFromFile(toolbox, ABI, abi);
+                        abi = loadAbiFromFile(ABI, abiPath);
                     }
                     catch (e) {
-                        print.error(`Failed to load ABI: ${e.message}`);
-                        process.exitCode = 1;
-                        return;
+                        this.error(`Failed to load ABI: ${e.message}`, { exit: 1 });
                     }
                 }
                 else {
@@ -428,7 +124,7 @@ exports.default = {
                     }
                 }
             }
-            return await initSubgraphFromContract(toolbox, {
+            return await initSubgraphFromContract.bind(this)({
                 protocolInstance,
                 abi,
                 allowSimpleName,
@@ -437,139 +133,473 @@ exports.default = {
                 indexEvents,
                 network,
                 subgraphName,
-                contractName,
+                contractName: contractName,
                 node,
                 studio,
-                product,
-                startBlock,
+                product: product,
+                startBlock: startBlock,
             }, { commands, addContract: false });
         }
-        // Otherwise, take the user through the interactive form
-        const inputs = await processInitForm(toolbox, {
-            protocol,
-            product,
-            studio,
-            node,
-            abi,
-            allowSimpleName,
-            directory,
-            contract: fromContract,
-            indexEvents,
-            fromExample,
-            network,
-            subgraphName,
-            contractName,
-            startBlock,
-        });
-        // Exit immediately when the form is cancelled
-        if (inputs === undefined) {
-            process.exit(1);
-        }
-        print.info('———');
         if (fromExample) {
-            await initSubgraphFromExample(toolbox, {
+            await initSubgraphFromExample.bind(this)({
                 fromExample,
-                subgraphName: inputs.subgraphName,
-                directory: inputs.directory,
-                studio: inputs.studio,
-                product: inputs.product,
+                subgraphName,
+                directory,
+                studio,
+                product: product,
             }, { commands });
         }
         else {
             ({ node, allowSimpleName } = (0, node_1.chooseNodeUrl)({
-                product: inputs.product,
+                product,
                 studio,
                 node,
                 allowSimpleName,
             }));
-            await initSubgraphFromContract(toolbox, {
-                protocolInstance: inputs.protocolInstance,
+            await initSubgraphFromContract.bind(this)({
+                protocolInstance,
                 allowSimpleName,
-                subgraphName: inputs.subgraphName,
-                directory: inputs.directory,
-                abi: inputs.abi,
-                network: inputs.network,
-                contract: inputs.contract,
-                indexEvents: inputs.indexEvents,
-                contractName: inputs.contractName,
-                node,
-                studio: inputs.studio,
-                product: inputs.product,
-                startBlock: inputs.startBlock,
+                subgraphName,
+                directory,
+                abi,
+                network: network,
+                contract: fromContract,
+                indexEvents,
+                contractName: contractName,
+                node: node,
+                studio,
+                product: product,
+                startBlock: startBlock,
             }, { commands, addContract: true });
         }
-    },
+    }
+}
+exports.default = InitCommand;
+InitCommand.description = 'Creates a new subgraph with basic scaffolding.';
+InitCommand.args = {
+    subgraphName: core_1.Args.string({
+        required: true,
+    }),
+    directory: core_1.Args.string({
+        required: true,
+    }),
+};
+InitCommand.flags = {
+    protocol: core_1.Flags.string({
+        required: true,
+        options: protocolChoices,
+    }),
+    product: core_1.Flags.string({
+        summary: 'Selects the product for which to initialize.',
+        options: ['subgraph-studio', 'hosted-service'],
+    }),
+    studio: core_1.Flags.boolean({
+        summary: 'Shortcut for "--product subgraph-studio".',
+        exclusive: ['product'],
+    }),
+    node: core_1.Flags.string({
+        summary: 'Graph node for which to initialize.',
+        char: 'g',
+    }),
+    'allow-simple-name': core_1.Flags.boolean({
+        description: 'Use a subgraph name without a prefix.',
+        default: false,
+    }),
+    'from-contract': core_1.Flags.string({
+        description: 'Creates a scaffold based on an existing contract.',
+        exclusive: ['from-example'],
+    }),
+    'from-example': core_1.Flags.string({
+        description: 'Creates a scaffold based on an example subgraph.',
+        // TODO: using a default sets the value and therefore requires not to have --from-contract
+        // default: 'Contract',
+        exclusive: ['from-contract'],
+    }),
+    'contract-name': core_1.Flags.string({
+        helpGroup: 'Scaffold from contract',
+        description: 'Name of the contract.',
+        dependsOn: ['from-contract'],
+    }),
+    'index-events': core_1.Flags.boolean({
+        helpGroup: 'Scaffold from contract',
+        description: 'Index contract events as entities.',
+        dependsOn: ['from-contract'],
+    }),
+    'start-block': core_1.Flags.string({
+        helpGroup: 'Scaffold from contract',
+        description: 'Block number to start indexing from.',
+        // TODO: using a default sets the value and therefore requires --from-contract
+        // default: '0',
+        dependsOn: ['from-contract'],
+    }),
+    abi: core_1.Flags.string({
+        summary: 'Path to the contract ABI',
+        // TODO: using a default sets the value and therefore requires --from-contract
+        // default: '*Download from Etherscan*',
+        dependsOn: ['from-contract'],
+    }),
+    network: core_1.Flags.string({
+        summary: 'Network the contract is deployed to.',
+        dependsOn: ['from-contract'],
+        options: [
+            ...availableNetworks.get('ethereum'),
+            ...availableNetworks.get('near'),
+            ...availableNetworks.get('cosmos'),
+        ],
+    }),
+};
+// const processInitForm = async (
+//   toolbox: GluegunToolbox,
+//   {
+//     protocol,
+//     product,
+//     studio,
+//     node,
+//     abi,
+//     allowSimpleName,
+//     directory,
+//     contract,
+//     indexEvents,
+//     fromExample,
+//     network,
+//     subgraphName,
+//     contractName,
+//     startBlock,
+//   }: {
+//     protocol: ProtocolName;
+//     product: string;
+//     studio: string;
+//     node: string;
+//     abi: EthereumABI;
+//     allowSimpleName: boolean | undefined;
+//     directory: string;
+//     contract: string;
+//     indexEvents: boolean;
+//     fromExample: string | boolean;
+//     network: string;
+//     subgraphName: string;
+//     contractName: string;
+//     startBlock: string;
+//   },
+// ): Promise<
+//   | {
+//       abi: EthereumABI;
+//       protocolInstance: Protocol;
+//       subgraphName: string;
+//       directory: string;
+//       studio: string;
+//       product: string;
+//       network: string;
+//       contract: string;
+//       indexEvents: boolean;
+//       contractName: string;
+//       startBlock: string;
+//     }
+//   | undefined
+// > => {
+//   let abiFromEtherscan: EthereumABI | undefined = undefined;
+//   let abiFromFile = undefined;
+//   let protocolInstance!: Protocol;
+//   let ProtocolContract: ContractCtor;
+//   let ABI: typeof EthereumABI;
+//   const questions = [
+//     {
+//       type: 'select',
+//       name: 'protocol',
+//       message: 'Protocol',
+//       choices: protocolChoices,
+//       skip: protocolChoices.includes(protocol),
+//       result: (value: ProtocolName) => {
+//         // eslint-disable-next-line -- prettier has problems with ||=
+//         protocol = protocol || value;
+//         protocolInstance = new Protocol(protocol);
+//         return protocol;
+//       },
+//     },
+//     {
+//       type: 'select',
+//       name: 'product',
+//       message: 'Product for which to initialize',
+//       choices: ['subgraph-studio', 'hosted-service'],
+//       skip: () =>
+//         protocol === 'arweave' ||
+//         protocol === 'cosmos' ||
+//         protocol === 'near' ||
+//         product === 'subgraph-studio' ||
+//         product === 'hosted-service' ||
+//         studio !== undefined ||
+//         node !== undefined,
+//       result: (value: string | undefined) => {
+//         // For now we only support NEAR subgraphs in the Hosted Service
+//         if (protocol === 'near') {
+//           // Can be overwritten because the question will be skipped (product === undefined)
+//           product = 'hosted-service';
+//           return product;
+//         }
+//         if (value == 'subgraph-studio') {
+//           allowSimpleName = true;
+//         }
+//         product = value as any;
+//         return value;
+//       },
+//     },
+//     {
+//       type: 'input',
+//       name: 'subgraphName',
+//       message: () => (product == 'subgraph-studio' || studio ? 'Subgraph slug' : 'Subgraph name'),
+//       initial: subgraphName,
+//       validate: (name: string) => {
+//         try {
+//           validateSubgraphName(name, { allowSimpleName });
+//           return true;
+//         } catch (e) {
+//           return `${e.message}
+//   Examples:
+//     $ graph init ${os.userInfo().username}/${name}
+//     $ graph init ${name} --allow-simple-name`;
+//         }
+//       },
+//       result: (value: string) => {
+//         subgraphName = value;
+//         return value;
+//       },
+//     },
+//     {
+//       type: 'input',
+//       name: 'directory',
+//       message: 'Directory to create the subgraph in',
+//       initial: () => directory || getSubgraphBasename(subgraphName),
+//       validate: (value: string) =>
+//         toolbox.filesystem.exists(value || directory || getSubgraphBasename(subgraphName))
+//           ? 'Directory already exists'
+//           : true,
+//     },
+//     {
+//       type: 'select',
+//       name: 'network',
+//       message: () => `${protocolInstance.displayName()} network`,
+//       choices: () => {
+//         initDebug(
+//           'Generating list of available networks for protocol "%s" (%M)',
+//           protocol,
+//           availableNetworks.get(protocol as any),
+//         );
+//         return (
+//           // @ts-expect-error TODO: wait what?
+//           availableNetworks
+//             .get(protocol) // Get networks related to the chosen protocol.
+//             // @ts-expect-error TODO: wait what?
+//             .toArray()
+//         ); // Needed because of gluegun. It can't even receive a JS iterable.
+//       },
+//       skip: fromExample !== undefined,
+//       initial: network || 'mainnet',
+//       result: (value: string) => {
+//         network = value;
+//         return value;
+//       },
+//     },
+//     // TODO:
+//     //
+//     // protocols that don't support contract
+//     // - arweave
+//     // - cosmos
+//     {
+//       type: 'input',
+//       name: 'contract',
+//       message: () => {
+//         ProtocolContract = protocolInstance.getContract()!;
+//         return `Contract ${ProtocolContract.identifierName()}`;
+//       },
+//       skip: () => fromExample !== undefined || !protocolInstance.hasContract(),
+//       initial: contract,
+//       validate: async (value: string) => {
+//         if (fromExample !== undefined || !protocolInstance.hasContract()) {
+//           return true;
+//         }
+//         // Validate whether the contract is valid
+//         const { valid, error } = validateContract(value, ProtocolContract);
+//         return valid ? true : error;
+//       },
+//       result: async (value: string) => {
+//         if (fromExample !== undefined) {
+//           return value;
+//         }
+//         ABI = protocolInstance.getABI();
+//         // Try loading the ABI from Etherscan, if none was provided
+//         if (protocolInstance.hasABIs() && !abi) {
+//           try {
+//             if (network === 'poa-core') {
+//               // TODO: this variable is never used anywhere, what happens?
+//               // abiFromBlockScout = await loadAbiFromBlockScout(ABI, network, value)
+//             } else {
+//               abiFromEtherscan = await loadAbiFromEtherscan(ABI, network!, value);
+//             }
+//           } catch (e) {
+//             // noop
+//           }
+//         }
+//         // If startBlock is not set, try to load it.
+//         if (!startBlock) {
+//           try {
+//             // Load startBlock for this contract
+//             startBlock = Number(await loadStartBlockForContract(network!, value)).toString();
+//           } catch (error) {
+//             // noop
+//           }
+//         }
+//         return value;
+//       },
+//     },
+//     {
+//       type: 'input',
+//       name: 'abi',
+//       message: 'ABI file (path)',
+//       initial: abi,
+//       skip: () =>
+//         !protocolInstance.hasABIs() || fromExample !== undefined || abiFromEtherscan !== undefined,
+//       validate: async (value: string) => {
+//         if (fromExample || abiFromEtherscan || !protocolInstance.hasABIs()) {
+//           return true;
+//         }
+//         try {
+//           abiFromFile = loadAbiFromFile(ABI, value);
+//           return true;
+//         } catch (e) {
+//           return e.message;
+//         }
+//       },
+//     },
+//     {
+//       type: 'input',
+//       name: 'startBlock',
+//       message: 'Start Block',
+//       initial: () => startBlock || '0',
+//       skip: () => fromExample !== undefined,
+//       validate: (value: string) => parseInt(value) >= 0,
+//       result: (value: string) => {
+//         startBlock = value;
+//         return value;
+//       },
+//     },
+//     {
+//       type: 'input',
+//       name: 'contractName',
+//       message: 'Contract Name',
+//       initial: contractName || 'Contract',
+//       skip: () => fromExample !== undefined || !protocolInstance.hasContract(),
+//       validate: (value: string) => value && value.length > 0,
+//       result: (value: string) => {
+//         contractName = value;
+//         return value;
+//       },
+//     },
+//     {
+//       type: 'confirm',
+//       name: 'indexEvents',
+//       message: 'Index contract events as entities',
+//       initial: true,
+//       skip: () => !!indexEvents,
+//       result: (value: boolean) => {
+//         indexEvents = value;
+//         return value;
+//       },
+//     },
+//   ];
+//   try {
+//     const answers = await toolbox.prompt.ask(
+//       // @ts-expect-error questions do somehow fit
+//       questions,
+//     );
+//     return {
+//       ...(answers as any), // necessary answers are here
+//       abi: (abiFromEtherscan || abiFromFile)!,
+//       protocolInstance,
+//     };
+//   } catch (e) {
+//     return undefined;
+//   }
+// };
+const loadAbiFromFile = (ABI, filename) => {
+    const exists = gluegun_1.filesystem.exists(filename);
+    if (!exists) {
+        throw Error('File does not exist.');
+    }
+    else if (exists === 'dir') {
+        throw Error('Path points to a directory, not a file.');
+    }
+    else if (exists === 'other') {
+        throw Error('Not sure what this path points to.');
+    }
+    else {
+        return ABI.load('Contract', filename);
+    }
 };
-const revalidateSubgraphName = async (toolbox, subgraphName, { allowSimpleName }) => {
+function revalidateSubgraphName(subgraphName, { allowSimpleName }) {
     // Fail if the subgraph name is invalid
     try {
         (0, subgraph_1.validateSubgraphName)(subgraphName, { allowSimpleName });
         return true;
     }
     catch (e) {
-        toolbox.print.error(`${e.message}
+        this.error(`${e.message}
 
   Examples:
 
     $ graph init ${os_1.default.userInfo().username}/${subgraphName}
     $ graph init ${subgraphName} --allow-simple-name`);
-        return false;
     }
-};
-const initRepository = async (toolbox, directory) => await (0, spinner_1.withSpinner)(`Initialize subgraph repository`, `Failed to initialize subgraph repository`, `Warnings while initializing subgraph repository`, async () => {
+}
+const initRepository = async (directory) => await (0, spinner_1.withSpinner)(`Initialize subgraph repository`, `Failed to initialize subgraph repository`, `Warnings while initializing subgraph repository`, async () => {
     // Remove .git dir in --from-example mode; in --from-contract, we're
     // starting from an empty directory
     const gitDir = path_1.default.join(directory, '.git');
-    if (toolbox.filesystem.exists(gitDir)) {
-        toolbox.filesystem.remove(gitDir);
+    if (gluegun_1.filesystem.exists(gitDir)) {
+        gluegun_1.filesystem.remove(gitDir);
     }
-    await toolbox.system.run('git init', { cwd: directory });
-    await toolbox.system.run('git add --all', { cwd: directory });
-    await toolbox.system.run('git commit -m "Initial commit"', {
+    await gluegun_1.system.run('git init', { cwd: directory });
+    await gluegun_1.system.run('git add --all', { cwd: directory });
+    await gluegun_1.system.run('git commit -m "Initial commit"', {
         cwd: directory,
     });
     return true;
 });
-const installDependencies = async (toolbox, directory, commands) => await (0, spinner_1.withSpinner)(`Install dependencies with ${toolbox.print.colors.muted(commands.install)}`, `Failed to install dependencies`, `Warnings while installing dependencies`, async () => {
+const installDependencies = async (directory, commands) => await (0, spinner_1.withSpinner)(`Install dependencies with ${commands.install}`, `Failed to install dependencies`, `Warnings while installing dependencies`, async () => {
     if (process.env.GRAPH_CLI_TESTS) {
-        await toolbox.system.run(commands.link, { cwd: directory });
+        await gluegun_1.system.run(commands.link, { cwd: directory });
     }
-    await toolbox.system.run(commands.install, { cwd: directory });
+    await gluegun_1.system.run(commands.install, { cwd: directory });
     return true;
 });
-const runCodegen = async (toolbox, directory, codegenCommand) => await (0, spinner_1.withSpinner)(`Generate ABI and schema types with ${toolbox.print.colors.muted(codegenCommand)}`, `Failed to generate code from ABI and GraphQL schema`, `Warnings while generating code from ABI and GraphQL schema`, async () => {
-    await toolbox.system.run(codegenCommand, { cwd: directory });
+const runCodegen = async (directory, codegenCommand) => await (0, spinner_1.withSpinner)(`Generate ABI and schema types with ${codegenCommand}`, `Failed to generate code from ABI and GraphQL schema`, `Warnings while generating code from ABI and GraphQL schema`, async () => {
+    await gluegun_1.system.run(codegenCommand, { cwd: directory });
     return true;
 });
-const printNextSteps = (toolbox, { subgraphName, directory }, { commands, }) => {
-    const { print } = toolbox;
+function printNextSteps({ subgraphName, directory }, { commands, }) {
     const relativeDir = path_1.default.relative(process.cwd(), directory);
     // Print instructions
-    print.success(`
-Subgraph ${print.colors.blue(subgraphName)} created in ${print.colors.blue(relativeDir)}
+    this.log(`
+Subgraph ${subgraphName} created in ${relativeDir}
 `);
-    print.info(`Next steps:
+    this.log(`Next steps:
 
-  1. Run \`${print.colors.muted('graph auth')}\` to authenticate with your deploy key.
+  1. Run \`graph auth\` to authenticate with your deploy key.
 
-  2. Type \`${print.colors.muted(`cd ${relativeDir}`)}\` to enter the subgraph.
+  2. Type \`cd ${relativeDir}\` to enter the subgraph.
 
-  3. Run \`${print.colors.muted(commands.deploy)}\` to deploy the subgraph.
+  3. Run \`${commands.deploy}\` to deploy the subgraph.
 
 Make sure to visit the documentation on https://thegraph.com/docs/ for further information.`);
-};
-const initSubgraphFromExample = async (toolbox, { fromExample, allowSimpleName, subgraphName, directory, studio, product, }, { commands, }) => {
-    const { filesystem, print, system } = toolbox;
+}
+async function initSubgraphFromExample({ fromExample, allowSimpleName, subgraphName, directory, studio, product, }, { commands, }) {
     // Fail if the subgraph name is invalid
-    if (!revalidateSubgraphName(toolbox, subgraphName, { allowSimpleName: !!allowSimpleName })) {
+    if (!revalidateSubgraphName.bind(this)(subgraphName, { allowSimpleName })) {
         process.exitCode = 1;
         return;
     }
     // Fail if the output directory already exists
-    if (filesystem.exists(directory)) {
-        print.error(`Directory or file "${directory}" already exists`);
-        process.exitCode = 1;
-        return;
+    if (gluegun_1.filesystem.exists(directory)) {
+        this.error(`Directory or file "${directory}" already exists`, { exit: 1 });
     }
     // Clone the example subgraph repository
     const cloned = await (0, spinner_1.withSpinner)(`Cloning example subgraph`, `Failed to clone example subgraph`, `Warnings while cloning example subgraph`, async () => {
@@ -577,24 +607,24 @@ const initSubgraphFromExample = async (toolbox, { fromExample, allowSimpleName,
         const prefix = path_1.default.join(os_1.default.tmpdir(), 'example-subgraph-');
         const tmpDir = fs_1.default.mkdtempSync(prefix);
         try {
-            await system.run(`git clone http://github.com/graphprotocol/example-subgraphs ${tmpDir}`);
+            await gluegun_1.system.run(`git clone http://github.com/graphprotocol/example-subgraphs ${tmpDir}`);
             // If an example is not specified, use the default one
             if (fromExample === undefined || fromExample === true) {
                 fromExample = DEFAULT_EXAMPLE_SUBGRAPH;
             }
             const exampleSubgraphPath = path_1.default.join(tmpDir, String(fromExample));
-            if (!filesystem.exists(exampleSubgraphPath)) {
+            if (!gluegun_1.filesystem.exists(exampleSubgraphPath)) {
                 return { result: false, error: `Example not found: ${fromExample}` };
             }
-            filesystem.copy(exampleSubgraphPath, directory);
+            gluegun_1.filesystem.copy(exampleSubgraphPath, directory);
             return true;
         }
         finally {
-            filesystem.remove(tmpDir);
+            gluegun_1.filesystem.remove(tmpDir);
         }
     });
     if (!cloned) {
-        process.exitCode = 1;
+        this.exit(1);
         return;
     }
     try {
@@ -606,21 +636,19 @@ const initSubgraphFromExample = async (toolbox, { fromExample, allowSimpleName,
         }
     }
     catch (e) {
-        print.error(e.message);
-        process.exitCode = 1;
-        return;
+        this.error(e.message, { exit: 1 });
     }
-    const networkConf = await (0, network_1.initNetworksConfig)(toolbox, directory, 'address');
+    const networkConf = await (0, network_1.initNetworksConfig)(directory, 'address');
     if (networkConf !== true) {
-        process.exitCode = 1;
+        this.exit(1);
         return;
     }
     // Update package.json to match the subgraph name
     const prepared = await (0, spinner_1.withSpinner)(`Update subgraph name and commands in package.json`, `Failed to update subgraph name and commands in package.json`, `Warnings while updating subgraph name and commands in package.json`, async () => {
         try {
             // Load package.json
-            const pkgJsonFilename = filesystem.path(directory, 'package.json');
-            const pkgJson = await filesystem.read(pkgJsonFilename, 'json');
+            const pkgJsonFilename = gluegun_1.filesystem.path(directory, 'package.json');
+            const pkgJson = await gluegun_1.filesystem.read(pkgJsonFilename, 'json');
             pkgJson.name = (0, subgraph_1.getSubgraphBasename)(subgraphName);
             Object.keys(pkgJson.scripts).forEach(name => {
                 pkgJson.scripts[name] = pkgJson.scripts[name].replace('example', subgraphName);
@@ -632,60 +660,54 @@ const initSubgraphFromExample = async (toolbox, { fromExample, allowSimpleName,
                 delete pkgJson['devDependencies']['@graphprotocol/graph-cli'];
             }
             // Write package.json
-            filesystem.write(pkgJsonFilename, pkgJson, { jsonIndent: 2 });
+            gluegun_1.filesystem.write(pkgJsonFilename, pkgJson, { jsonIndent: 2 });
             return true;
         }
         catch (e) {
-            print.error(`Failed to preconfigure the subgraph: ${e}`);
-            filesystem.remove(directory);
-            return false;
+            gluegun_1.filesystem.remove(directory);
+            this.error(`Failed to preconfigure the subgraph: ${e}`);
         }
     });
     if (!prepared) {
-        process.exitCode = 1;
+        this.exit(1);
         return;
     }
     // Initialize a fresh Git repository
-    const repo = await initRepository(toolbox, directory);
+    const repo = await initRepository(directory);
     if (repo !== true) {
-        process.exitCode = 1;
+        this.exit(1);
         return;
     }
     // Install dependencies
-    const installed = await installDependencies(toolbox, directory, commands);
+    const installed = await installDependencies(directory, commands);
     if (installed !== true) {
-        process.exitCode = 1;
+        this.exit(1);
         return;
     }
     // Run code-generation
-    const codegen = await runCodegen(toolbox, directory, commands.codegen);
+    const codegen = await runCodegen(directory, commands.codegen);
     if (codegen !== true) {
-        process.exitCode = 1;
+        this.exit(1);
         return;
     }
-    printNextSteps(toolbox, { subgraphName, directory }, { commands });
-};
-const initSubgraphFromContract = async (toolbox, { protocolInstance, allowSimpleName, subgraphName, directory, abi, network, contract, indexEvents, contractName, node, studio, product, startBlock, }, { commands, addContract, }) => {
-    const { print } = toolbox;
+    printNextSteps.bind(this)({ subgraphName, directory }, { commands });
+}
+async function initSubgraphFromContract({ protocolInstance, allowSimpleName, subgraphName, directory, abi, network, contract, indexEvents, contractName, node, studio, product, startBlock, }, { commands, addContract, }) {
     // Fail if the subgraph name is invalid
-    if (!revalidateSubgraphName(toolbox, subgraphName, { allowSimpleName })) {
-        process.exitCode = 1;
+    if (!revalidateSubgraphName.bind(this)(subgraphName, { allowSimpleName })) {
+        this.exit(1);
         return;
     }
     // Fail if the output directory already exists
-    if (toolbox.filesystem.exists(directory)) {
-        print.error(`Directory or file "${directory}" already exists`);
-        process.exitCode = 1;
-        return;
+    if (gluegun_1.filesystem.exists(directory)) {
+        this.error(`Directory or file "${directory}" already exists`, { exit: 1 });
     }
     if (protocolInstance.hasABIs() &&
         ((0, schema_1.abiEvents)(abi).size === 0 ||
             // @ts-expect-error TODO: the abiEvents result is expected to be a List, how's it an array?
             (0, schema_1.abiEvents)(abi).length === 0)) {
         // Fail if the ABI does not contain any events
-        print.error(`ABI does not contain any events`);
-        process.exitCode = 1;
-        return;
+        this.error(`ABI does not contain any events`, { exit: 1 });
     }
     // We can validate this before the scaffold because we receive
     // the network from the form or via command line argument.
@@ -694,9 +716,7 @@ const initSubgraphFromContract = async (toolbox, { protocolInstance, allowSimple
         (0, studio_1.validateStudioNetwork)({ studio, product, network });
     }
     catch (e) {
-        print.error(e.message);
-        process.exitCode = 1;
-        return;
+        this.error(e, { exit: 1 });
     }
     // Scaffold subgraph
     const scaffold = await (0, spinner_1.withSpinner)(`Create subgraph scaffold`, `Failed to create subgraph scaffold`, `Warnings while creating subgraph scaffold`, async (spinner) => {
@@ -720,102 +740,89 @@ const initSubgraphFromContract = async (toolbox, { protocolInstance, allowSimple
     }
     if (protocolInstance.hasContract()) {
         const identifierName = protocolInstance.getContract().identifierName();
-        const networkConf = await (0, network_1.initNetworksConfig)(toolbox, directory, identifierName);
+        const networkConf = await (0, network_1.initNetworksConfig)(directory, identifierName);
         if (networkConf !== true) {
             process.exitCode = 1;
             return;
         }
     }
     // Initialize a fresh Git repository
-    const repo = await initRepository(toolbox, directory);
+    const repo = await initRepository(directory);
     if (repo !== true) {
-        process.exitCode = 1;
+        this.exit(1);
         return;
     }
     // Install dependencies
-    const installed = await installDependencies(toolbox, directory, commands);
+    const installed = await installDependencies(directory, commands);
     if (installed !== true) {
-        process.exitCode = 1;
+        this.exit(1);
         return;
     }
     // Run code-generation
-    const codegen = await runCodegen(toolbox, directory, commands.codegen);
+    const codegen = await runCodegen(directory, commands.codegen);
     if (codegen !== true) {
-        process.exitCode = 1;
+        this.exit(1);
         return;
     }
     while (addContract) {
-        addContract = await addAnotherContract(toolbox, { protocolInstance, directory });
-    }
-    printNextSteps(toolbox, { subgraphName, directory }, { commands });
-};
-const addAnotherContract = async (toolbox, { protocolInstance, directory }) => {
-    const addContractConfirmation = await toolbox.prompt.confirm('Add another contract?');
+        addContract = await addAnotherContract.bind(this)({ protocolInstance, directory });
+    }
+    printNextSteps.bind(this)({ subgraphName, directory }, { commands });
+}
+async function addAnotherContract({ protocolInstance, directory, }) {
+    const addContractAnswer = await core_1.ux.prompt('Add another contract? (y/n)', {
+        required: true,
+        type: 'single',
+    });
+    const addContractConfirmation = addContractAnswer.toLowerCase() === 'y';
     if (addContractConfirmation) {
         let abiFromFile = false;
         const ProtocolContract = protocolInstance.getContract();
-        const questions = [
-            {
-                type: 'input',
-                name: 'contract',
-                message: () => `Contract ${ProtocolContract.identifierName()}`,
-                validate: async (value) => {
-                    // Validate whether the contract is valid
-                    const { valid, error } = (0, validation_1.validateContract)(value, ProtocolContract);
-                    return valid ? true : error;
-                },
-            },
-            {
-                type: 'select',
-                name: 'localAbi',
-                message: 'Provide local ABI path?',
-                choices: ['yes', 'no'],
-                result: (value) => {
-                    abiFromFile = value === 'yes' ? true : false;
-                    return abiFromFile;
-                },
-            },
-            {
-                type: 'input',
-                name: 'abi',
-                message: 'ABI file (path)',
-                skip: () => abiFromFile === false,
-            },
-            {
-                type: 'input',
-                name: 'contractName',
-                message: 'Contract Name',
-                initial: 'Contract',
-                validate: (value) => value && value.length > 0,
-            },
-        ];
+        let contract = '';
+        for (;;) {
+            contract = await core_1.ux.prompt(`Contract ${ProtocolContract.identifierName()}`, {
+                required: true,
+            });
+            const { valid, error } = (0, validation_1.validateContract)(contract, ProtocolContract);
+            if (valid) {
+                break;
+            }
+            this.log(`✖ ${error}`);
+        }
+        const localAbi = await core_1.ux.prompt('Provide local ABI path? (y/n)', {
+            required: true,
+            type: 'single',
+        });
+        abiFromFile = localAbi.toLowerCase() === 'y';
+        let abiPath = '';
+        if (abiFromFile) {
+            abiPath = await core_1.ux.prompt('ABI file (path)', { required: true });
+        }
+        const contractName = await core_1.ux.prompt('Contract Name', { required: true, default: 'Contract' });
         // Get the cwd before process.chdir in order to switch back in the end of command execution
         const cwd = process.cwd();
         try {
-            const { abi, contract, contractName } = await toolbox.prompt.ask(
-            // @ts-expect-error questions do somehow fit
-            questions);
             if (fs_1.default.existsSync(directory)) {
                 process.chdir(directory);
             }
             const commandLine = ['add', contract, '--contract-name', contractName];
             if (abiFromFile) {
-                if (abi.includes(directory)) {
-                    commandLine.push('--abi', path_1.default.normalize(abi.replace(directory, '')));
+                if (abiPath.includes(directory)) {
+                    commandLine.push('--abi', path_1.default.normalize(abiPath.replace(directory, '')));
                 }
                 else {
-                    commandLine.push('--abi', abi);
+                    commandLine.push('--abi', abiPath);
                 }
             }
-            await graphCli.run(commandLine);
+            await add_1.default.run(commandLine);
         }
         catch (e) {
-            toolbox.print.error(e);
-            process.exit(1);
+            this.error(e);
         }
         finally {
+            // TODO: safer way of doing this?
             process.chdir(cwd);
         }
     }
     return addContractConfirmation;
-};
+}