create-eclesia-indexer 1.0.2

package/dist/index.js

@@ -0,0 +1,355 @@
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import path, { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import colors from "picocolors";
+import enquirer from "enquirer";
+import fse from "fs-extra";
+
+//#region src/create-indexer.ts
+const { prompt } = enquirer;
+const { ensureDirSync, copySync, writeFileSync, readFileSync } = fse;
+const __filename$1 = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename$1);
+const availableModules = [
+	{
+		name: "Auth",
+		value: "auth",
+		hint: "Account and authentication data"
+	},
+	{
+		name: "Bank",
+		value: "bank",
+		hint: "Token transfers and balances"
+	},
+	{
+		name: "Staking",
+		value: "staking",
+		hint: "Validator and delegation data"
+	}
+];
+const minimalAvailableModules = [{
+	name: "Auth",
+	value: "auth",
+	hint: "Account and authentication data"
+}, {
+	name: "Bank",
+	value: "bank",
+	hint: "Token transfers and balances"
+}];
+async function createIndexer(initialProjectName) {
+	const config = await gatherProjectInfo(initialProjectName);
+	const targetDir = resolve(process.cwd(), config.projectName);
+	console.log(colors.blue("📁 Creating project directory..."));
+	ensureDirSync(targetDir);
+	console.log(colors.blue("📋 Copying files..."));
+	await copyTemplateFiles(config, targetDir);
+	console.log(colors.blue("🔧 Processing template variables..."));
+	await processTemplates(config, targetDir);
+	console.log(colors.blue("📦 Installing dependencies..."));
+	await installDependencies(config, targetDir);
+	console.log(colors.blue("📦 Building..."));
+	await buildProject(config, targetDir);
+	console.log();
+	console.log(colors.green("🎉 Your indexer is ready!"));
+	console.log();
+	console.log("Next steps:");
+	console.log(colors.cyan(`  cd ${config.projectName}`));
+	console.log(colors.cyan(`  ${config.packageManager} local-dev:start # To run a self-contained local development environment with Postgres`));
+	console.log();
+	console.log("If you want to run the indexer against an external Postgres database instead of the local development environment, set the database connection string in the .env file.");
+	console.log();
+	console.log(colors.cyan(`  ${config.packageManager} start # To run the indexer`));
+	console.log();
+	console.log("Happy indexing!");
+	console.log();
+}
+async function gatherProjectInfo(initialProjectName) {
+	const answers1 = await prompt([
+		{
+			type: "input",
+			name: "projectName",
+			message: "Project name:",
+			initial: initialProjectName || "my-indexer",
+			skip: !!initialProjectName
+		},
+		{
+			type: "input",
+			name: "chainName",
+			message: "Chain name:",
+			initial: "cosmos-hub"
+		},
+		{
+			type: "input",
+			name: "chainPrefix",
+			message: "Chain address prefix:",
+			initial: "cosmos"
+		},
+		{
+			type: "input",
+			name: "description",
+			message: "Description:",
+			initial: "A custom Cosmos SDK chain indexer"
+		},
+		{
+			type: "input",
+			name: "rpcEndpoint",
+			message: "RPC endpoint:",
+			initial: "https://rpc.cosmos.network",
+			validate: (value) => {
+				try {
+					const url = new URL(value);
+					if (url.protocol === "http:" || url.protocol === "https:" || url.protocol === "ws:" || url.protocol === "wss:") return true;
+					return "Please enter a valid HTTP/HTTPS/WS/WSS URL.";
+				} catch (err) {
+					return "Please enter a valid URL: " + err;
+				}
+			}
+		},
+		{
+			type: "toggle",
+			name: "minimal",
+			message: "Minimal block indexing? (Only stores heights)",
+			enabled: "Yes",
+			disabled: "No",
+			initial: false
+		},
+		{
+			type: "number",
+			name: "queueSize",
+			message: "Number of blocks to keep prefetched (queue size):",
+			initial: 200
+		},
+		{
+			type: "number",
+			name: "startHeight",
+			message: "Height to start indexing from (>1 not compatible with standard modules):",
+			initial: 1
+		}
+	]);
+	if (answers1.startHeight == 1) answers1.processGenesis = (await prompt([{
+		type: "toggle",
+		name: "processGenesis",
+		message: "Process genesis file?",
+		enabled: "Yes",
+		disabled: "No"
+	}])).processGenesis;
+	else answers1.processGenesis = "No";
+	if (answers1.processGenesis === "Yes") {
+		const genesisPathQuestion = await prompt([{
+			type: "input",
+			name: "genesisPath",
+			message: "Path to genesis file:",
+			initial: "./genesis.json",
+			validate: (value) => {
+				try {
+					fse.accessSync(value, fse.constants.R_OK);
+					return true;
+				} catch (err) {
+					return "File not found or not readable. Please enter a valid path: " + err;
+				}
+			}
+		}]);
+		answers1.genesisPath = genesisPathQuestion.genesisPath ? path.resolve(genesisPathQuestion.genesisPath) : null;
+	} else answers1.genesisPath = null;
+	const questions2 = [
+		{
+			type: "multiselect",
+			name: "modules",
+			message: "Select modules to include:",
+			choices: answers1.startHeight == 1 && !answers1.minimal && answers1.processGenesis ? availableModules : minimalAvailableModules,
+			initial: answers1.startHeight == 1 && !answers1.minimal && answers1.processGenesis ? [
+				0,
+				1,
+				2
+			] : [0, 1]
+		},
+		{
+			type: "select",
+			name: "packageManager",
+			message: "Package manager:",
+			choices: [
+				{
+					name: "pnpm",
+					hint: "recommended"
+				},
+				{ name: "npm" },
+				{ name: "yarn" }
+			],
+			initial: 0
+		},
+		{
+			type: "select",
+			name: "logLevel",
+			message: "Log level:",
+			choices: [
+				"error",
+				"warn",
+				"info",
+				"verbose",
+				"debug",
+				"silly"
+			],
+			initial: 4
+		}
+	];
+	const answers2 = await prompt(questions2);
+	return {
+		...answers1,
+		...answers2
+	};
+}
+async function copyTemplateFiles(config, targetDir) {
+	const templatesDir = resolve(__dirname, "..", "templates", "basic");
+	if (config.genesisPath) {
+		console.log(colors.blue("📋 Copying genesis file..."));
+		copySync(config.genesisPath, targetDir + "/genesis.json");
+	}
+	console.log(colors.blue("📋 Copying template files..."));
+	copySync(templatesDir, targetDir, { filter: (src) => {
+		if (src.includes(".template")) return false;
+		if (config.packageManager !== "pnpm" && src.includes("pnpm-workspace")) return false;
+		if (src.includes("Dockerfile")) return false;
+		return true;
+	} });
+	copySync(resolve(templatesDir, "Dockerfile." + config.packageManager), targetDir + "/Dockerfile");
+	[
+		"package.json.template",
+		"src/index.ts.template",
+		"tsconfig.json.template",
+		"docker-compose.yml.template",
+		"README.md.template",
+		".env.template"
+	].forEach((templateFile) => {
+		const srcPath = resolve(templatesDir, templateFile);
+		const destPath = resolve(targetDir, templateFile.replace(".template", ""));
+		try {
+			copySync(srcPath, destPath);
+		} catch (_error) {}
+	});
+}
+async function processTemplates(config, targetDir) {
+	let polling = false;
+	const url = new URL(config.rpcEndpoint);
+	if (url.protocol === "http:" || url.protocol === "https:") polling = true;
+	const templateVars = {
+		PROJECT_NAME: config.projectName,
+		CHAIN_NAME: config.chainName,
+		DESCRIPTION: config.description,
+		RPC_ENDPOINT: config.rpcEndpoint,
+		PG_CONNECTION_STRING: "postgres://postgres:password@postgres:5432/indexer",
+		LOG_LEVEL: config.logLevel,
+		QUEUE_SIZE: config.queueSize.toString(),
+		USE_POLLING: polling ? "true" : "false",
+		PROCESS_GENESIS: config.processGenesis + "",
+		GENESIS_PATH: path.resolve(targetDir, "genesis.json"),
+		MINIMAL: config.minimal ? "true" : "false",
+		START_HEIGHT: config.startHeight.toString(),
+		CHAIN_PREFIX: config.chainName.split("-")[0] || "cosmos",
+		MODULES_IMPORT: generateModulesImport(config),
+		PACKAGE_MANAGER: config.packageManager,
+		MODULES_INSTANTIATION: generateModulesInstantiation(config),
+		MODULES_ARRAY: generateModulesArray(config)
+	};
+	[
+		"package.json",
+		"src/index.ts",
+		"tsconfig.json",
+		"docker-compose.yml",
+		"README.md",
+		"pnpm-workspace.yaml",
+		".env"
+	].forEach((file) => {
+		const filePath = resolve(targetDir, file);
+		try {
+			let content = readFileSync(filePath, "utf-8");
+			Object.entries(templateVars).forEach(([key, value]) => {
+				const regex = new RegExp(`{{${key}}}`, "g");
+				content = content.replace(regex, value);
+			});
+			writeFileSync(filePath, content);
+		} catch (_error) {}
+	});
+}
+function generateModulesImport(config) {
+	const imports = [];
+	imports.push("  Blocks");
+	if (config.modules.includes("Auth")) imports.push("  AuthModule");
+	if (config.modules.includes("Bank") && config.startHeight === 1 && config.processGenesis) imports.push("  BankModule");
+	if (config.modules.includes("Staking") && !config.minimal) imports.push("  StakingModule");
+	return `import {\n${imports.join(",")}\n} from "@eclesia/core-modules-pg";\n`;
+}
+function generateModulesInstantiation(config) {
+	const instantiations = [];
+	if (config.minimal) instantiations.push("const blocksModule = new Blocks.MinimalBlocksModule(registry);");
+	else instantiations.push("const blocksModule = new Blocks.FullBlocksModule(registry);");
+	if (config.modules.includes("Auth")) instantiations.push("const authModule = new AuthModule(registry);");
+	if (config.modules.includes("Bank") && config.startHeight === 1 && config.processGenesis) instantiations.push("const bankModule = new BankModule(registry);");
+	if (config.modules.includes("Staking") && !config.minimal) instantiations.push("const stakingModule = new StakingModule(registry);");
+	return instantiations.join("\n");
+}
+function generateModulesArray(config) {
+	const moduleNames = [];
+	moduleNames.push("blocksModule");
+	if (config.modules.includes("Auth")) moduleNames.push("authModule");
+	if (config.modules.includes("Bank") && config.startHeight === 1 && config.processGenesis) moduleNames.push("bankModule");
+	if (config.modules.includes("Staking") && !config.minimal) moduleNames.push("stakingModule");
+	return `[${moduleNames.filter((m) => !m.includes("//")).join(", ")}]`;
+}
+async function installDependencies(config, targetDir) {
+	const { spawn } = await import("node:child_process");
+	return new Promise((resolve$1, reject) => {
+		spawn(config.packageManager, ["install"], {
+			cwd: targetDir,
+			stdio: "inherit"
+		}).on("close", (code) => {
+			if (code !== 0) reject(/* @__PURE__ */ new Error(`Package installation failed with code ${code}`));
+			else resolve$1();
+		});
+	});
+}
+async function buildProject(config, targetDir) {
+	const { spawn } = await import("node:child_process");
+	return new Promise((resolve$1, reject) => {
+		spawn(config.packageManager, ["run", "build"], {
+			cwd: targetDir,
+			stdio: "inherit"
+		}).on("close", (code) => {
+			if (code !== 0) reject(/* @__PURE__ */ new Error(`Package installation failed with code ${code}`));
+			else resolve$1();
+		});
+	});
+}
+
+//#endregion
+//#region src/index.ts
+const __filename = fileURLToPath(import.meta.url);
+dirname(__filename);
+async function main() {
+	console.log();
+	console.log(colors.cyan("🚀 Welcome to create-eclesia-indexer!"));
+	console.log(colors.gray("Scaffolding a new Cosmos SDK chain indexer..."));
+	console.log();
+	try {
+		const projectName = process.argv[2];
+		if (projectName && existsSync(resolve(process.cwd(), projectName))) {
+			console.log(colors.red(`❌ Directory '${projectName}' already exists.`));
+			process.exit(1);
+		}
+		await createIndexer(projectName);
+		console.log();
+		console.log(colors.green("✅ Indexer created successfully!"));
+		console.log();
+	} catch (error) {
+		console.error(colors.red("❌ Error creating indexer:"), error);
+		process.exit(1);
+	}
+}
+main().catch((error) => {
+	console.error(error);
+	process.exit(1);
+});
+
+//#endregion
+export {  };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["__filename","imports: string[]","instantiations: string[]","moduleNames: string[]"],"sources":["../src/create-indexer.ts","../src/index.ts"],"sourcesContent":["import enquirer from \"enquirer\";\nconst {\n  prompt,\n} = enquirer;\nimport fse from \"fs-extra\";\nconst {\n  ensureDirSync, copySync, writeFileSync, readFileSync,\n} = fse;\nimport path, {\n  resolve,\n} from \"node:path\";\nimport {\n  dirname,\n} from \"node:path\";\nimport {\n  fileURLToPath,\n} from \"node:url\";\n\nimport colors from \"picocolors\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\ninterface ProjectConfig {\n  projectName: string\n  chainName: string\n  description: string\n  rpcEndpoint: string\n  chainPrefix: string\n  minimal: string\n  startHeight: number\n  queueSize: number\n  logLevel: string\n  processGenesis: string\n  genesisPath: string | null\n  modules: string[]\n  packageManager: \"npm\" | \"yarn\" | \"pnpm\"\n}\n\nconst availableModules = [\n  {\n    name: \"Auth\",\n    value: \"auth\",\n    hint: \"Account and authentication data\",\n  },\n  {\n    name: \"Bank\",\n    value: \"bank\",\n    hint: \"Token transfers and balances\",\n  },\n  {\n    name: \"Staking\",\n    value: \"staking\",\n    hint: \"Validator and delegation data\",\n  },\n];\n\nconst minimalAvailableModules = [\n  {\n    name: \"Auth\",\n    value: \"auth\",\n    hint: \"Account and authentication data\",\n  },\n  {\n    name: \"Bank\",\n    value: \"bank\",\n    hint: \"Token transfers and balances\",\n  },\n];\n\nexport async function createIndexer(initialProjectName?: string): Promise<void> {\n  const config = await gatherProjectInfo(initialProjectName);\n  const targetDir = resolve(process.cwd(), config.projectName);\n\n  console.log(colors.blue(\"📁 Creating project directory...\"));\n  ensureDirSync(targetDir);\n\n  console.log(colors.blue(\"📋 Copying files...\"));\n  await copyTemplateFiles(config, targetDir);\n\n  console.log(colors.blue(\"🔧 Processing template variables...\"));\n  await processTemplates(config, targetDir);\n\n  console.log(colors.blue(\"📦 Installing dependencies...\"));\n  await installDependencies(config, targetDir);\n\n  console.log(colors.blue(\"📦 Building...\"));\n  await buildProject(config, targetDir);\n\n  console.log();\n  console.log(colors.green(\"🎉 Your indexer is ready!\"));\n  console.log();\n  console.log(\"Next steps:\");\n  console.log(colors.cyan(`  cd ${config.projectName}`));\n  console.log(colors.cyan(`  ${config.packageManager} local-dev:start # To run a self-contained local development environment with Postgres`));\n  console.log();\n  console.log(\"If you want to run the indexer against an external Postgres database instead of the local development environment, set the database connection string in the .env file.\");\n  console.log();\n  console.log(colors.cyan(`  ${config.packageManager} start # To run the indexer`));\n  console.log();\n  console.log(\"Happy indexing!\");\n  console.log();\n}\n\nasync function gatherProjectInfo(initialProjectName?: string): Promise<ProjectConfig> {\n  const questions1 = [\n    {\n      type: \"input\",\n      name: \"projectName\",\n      message: \"Project name:\",\n      initial: initialProjectName || \"my-indexer\",\n      skip: !!initialProjectName,\n    },\n    {\n      type: \"input\",\n      name: \"chainName\",\n      message: \"Chain name:\",\n      initial: \"cosmos-hub\",\n    },\n    {\n      type: \"input\",\n      name: \"chainPrefix\",\n      message: \"Chain address prefix:\",\n      initial: \"cosmos\",\n    },\n    {\n      type: \"input\",\n      name: \"description\",\n      message: \"Description:\",\n      initial: \"A custom Cosmos SDK chain indexer\",\n    },\n    {\n      type: \"input\",\n      name: \"rpcEndpoint\",\n      message: \"RPC endpoint:\",\n      initial: \"https://rpc.cosmos.network\",\n      validate: (value: string) => {\n        try {\n          const url = new URL(value);\n          if (url.protocol === \"http:\" || url.protocol === \"https:\" || url.protocol === \"ws:\" || url.protocol === \"wss:\") {\n            return true;\n          }\n          return \"Please enter a valid HTTP/HTTPS/WS/WSS URL.\";\n        }\n        catch (err) {\n          return \"Please enter a valid URL: \" + err;\n        }\n      },\n    },\n    {\n      type: \"toggle\",\n      name: \"minimal\",\n      message: \"Minimal block indexing? (Only stores heights)\",\n      enabled: \"Yes\",\n      disabled: \"No\",\n      initial: false,\n    },\n    {\n      type: \"number\",\n      name: \"queueSize\",\n      message: \"Number of blocks to keep prefetched (queue size):\",\n      initial: 200,\n    },\n    {\n      type: \"number\",\n      name: \"startHeight\",\n      message: \"Height to start indexing from (>1 not compatible with standard modules):\",\n      initial: 1,\n    },\n  ];\n  const answers1 = await prompt(questions1) as ProjectConfig;\n  if (answers1.startHeight == 1) {\n    const genesisQuestion = await prompt([\n      {\n        type: \"toggle\",\n        name: \"processGenesis\",\n        message: \"Process genesis file?\",\n        enabled: \"Yes\",\n        disabled: \"No\",\n      },\n    ]) as ProjectConfig;\n    answers1.processGenesis = genesisQuestion.processGenesis;\n  }\n  else {\n    answers1.processGenesis = \"No\";\n  }\n  if (answers1.processGenesis === \"Yes\") {\n    const genesisPathQuestion = await prompt([\n      {\n        type: \"input\",\n        name: \"genesisPath\",\n        message: \"Path to genesis file:\",\n        initial: \"./genesis.json\",\n        validate: (value: string) => {\n          try {\n            fse.accessSync(value, fse.constants.R_OK);\n            return true;\n          }\n          catch (err) {\n            return \"File not found or not readable. Please enter a valid path: \" + err;\n          }\n        },\n      },\n    ]) as ProjectConfig;\n    answers1.genesisPath = genesisPathQuestion.genesisPath ? path.resolve(genesisPathQuestion.genesisPath) : null;\n  }\n  else {\n    answers1.genesisPath = null;\n  }\n  const questions2 = [\n    {\n      type: \"multiselect\",\n      name: \"modules\",\n      message: \"Select modules to include:\",\n      choices: answers1.startHeight == 1 && !answers1.minimal && answers1.processGenesis ? availableModules : minimalAvailableModules,\n      initial: answers1.startHeight == 1 && !answers1.minimal && answers1.processGenesis ? [0, 1, 2] : [0, 1],\n    },\n    {\n      type: \"select\",\n      name: \"packageManager\",\n      message: \"Package manager:\",\n      choices: [\n        {\n          name: \"pnpm\",\n          hint: \"recommended\",\n        },\n        {\n          name: \"npm\",\n        },\n        {\n          name: \"yarn\",\n        },\n      ],\n      initial: 0,\n    },\n    {\n      type: \"select\",\n      name: \"logLevel\",\n      message: \"Log level:\",\n      choices: [\"error\", \"warn\", \"info\", \"verbose\", \"debug\", \"silly\"],\n      initial: 4,\n    },\n  ];\n  const answers2 = await prompt(questions2) as ProjectConfig;\n  return {\n    ...answers1,\n    ...answers2,\n  };\n}\n\nasync function copyTemplateFiles(config: ProjectConfig, targetDir: string): Promise<void> {\n  const templatesDir = resolve(__dirname, \"..\", \"templates\", \"basic\");\n  if (config.genesisPath) {\n    console.log(colors.blue(\"📋 Copying genesis file...\"));\n    copySync(config.genesisPath, targetDir + \"/genesis.json\");\n  }\n\n  console.log(colors.blue(\"📋 Copying template files...\"));\n  copySync(templatesDir, targetDir, {\n    filter: (src) => {\n      if (src.includes(\".template\")) {\n        return false;\n      }\n      if (config.packageManager !== \"pnpm\" && src.includes(\"pnpm-workspace\")) {\n        return false;\n      }\n      if (src.includes(\"Dockerfile\")) {\n        return false;\n      }\n      return true;\n    },\n  });\n  copySync(resolve(templatesDir, \"Dockerfile.\" + config.packageManager), targetDir + \"/Dockerfile\");\n  // Copy template files\n  const templateFiles = [\"package.json.template\", \"src/index.ts.template\", \"tsconfig.json.template\", \"docker-compose.yml.template\", \"README.md.template\", \".env.template\"];\n\n  templateFiles.forEach((templateFile) => {\n    const srcPath = resolve(templatesDir, templateFile);\n    const destPath = resolve(targetDir, templateFile.replace(\".template\", \"\"));\n\n    try {\n      copySync(srcPath, destPath);\n    }\n    catch (_error) {\n      // Template file might not exist, that's okay\n    }\n  });\n}\n\nasync function processTemplates(config: ProjectConfig, targetDir: string): Promise<void> {\n  let polling = false;\n  const url = new URL(config.rpcEndpoint);\n  if (url.protocol === \"http:\" || url.protocol === \"https:\") {\n    polling = true;\n  }\n  const templateVars = {\n    PROJECT_NAME: config.projectName,\n    CHAIN_NAME: config.chainName,\n    DESCRIPTION: config.description,\n    RPC_ENDPOINT: config.rpcEndpoint,\n    PG_CONNECTION_STRING: \"postgres://postgres:password@postgres:5432/indexer\",\n    LOG_LEVEL: config.logLevel,\n    QUEUE_SIZE: config.queueSize.toString(),\n    USE_POLLING: polling ? \"true\" : \"false\",\n    PROCESS_GENESIS: config.processGenesis + \"\",\n    GENESIS_PATH: path.resolve(targetDir, \"genesis.json\"),\n    MINIMAL: config.minimal ? \"true\" : \"false\",\n    START_HEIGHT: config.startHeight.toString(),\n    CHAIN_PREFIX: config.chainName.split(\"-\")[0] || \"cosmos\",\n    MODULES_IMPORT: generateModulesImport(config),\n    PACKAGE_MANAGER: config.packageManager,\n    MODULES_INSTANTIATION: generateModulesInstantiation(config),\n    MODULES_ARRAY: generateModulesArray(config),\n  };\n\n  const filesToProcess = [\"package.json\", \"src/index.ts\", \"tsconfig.json\", \"docker-compose.yml\", \"README.md\", \"pnpm-workspace.yaml\", \".env\"];\n\n  filesToProcess.forEach((file) => {\n    const filePath = resolve(targetDir, file);\n\n    try {\n      let content = readFileSync(filePath, \"utf-8\");\n\n      Object.entries(templateVars).forEach(([key, value]) => {\n        const regex = new RegExp(`{{${key}}}`, \"g\");\n        content = content.replace(regex, value);\n      });\n\n      writeFileSync(filePath, content);\n    }\n    catch (_error) {\n      // File might not exist, that's okay\n    }\n  });\n}\n\nfunction generateModulesImport(config: ProjectConfig): string {\n  const imports: string[] = [];\n\n  imports.push(\"  Blocks\");\n  if (config.modules.includes(\"Auth\")) {\n    imports.push(\"  AuthModule\");\n  }\n  if (config.modules.includes(\"Bank\") && config.startHeight === 1 && config.processGenesis) {\n    imports.push(\"  BankModule\");\n  }\n  if (config.modules.includes(\"Staking\") && !config.minimal) {\n    imports.push(\"  StakingModule\");\n  }\n\n  return `import {\\n${imports.join(\",\")}\\n} from \"@eclesia/core-modules-pg\";\\n`;\n}\n\nfunction generateModulesInstantiation(config: ProjectConfig): string {\n  const instantiations: string[] = [];\n\n  if (config.minimal) {\n    instantiations.push(\"const blocksModule = new Blocks.MinimalBlocksModule(registry);\");\n  }\n  else {\n    instantiations.push(\"const blocksModule = new Blocks.FullBlocksModule(registry);\");\n  }\n  if (config.modules.includes(\"Auth\")) {\n    instantiations.push(\"const authModule = new AuthModule(registry);\");\n  }\n  if (config.modules.includes(\"Bank\") && config.startHeight === 1 && config.processGenesis) {\n    instantiations.push(\"const bankModule = new BankModule(registry);\");\n  }\n  if (config.modules.includes(\"Staking\") && !config.minimal) {\n    instantiations.push(\"const stakingModule = new StakingModule(registry);\");\n  }\n\n  return instantiations.join(\"\\n\");\n}\n\nfunction generateModulesArray(config: ProjectConfig): string {\n  const moduleNames: string[] = [];\n\n  moduleNames.push(\"blocksModule\");\n\n  if (config.modules.includes(\"Auth\")) {\n    moduleNames.push(\"authModule\");\n  }\n  if (config.modules.includes(\"Bank\") && config.startHeight === 1 && config.processGenesis) {\n    moduleNames.push(\"bankModule\");\n  }\n  if (config.modules.includes(\"Staking\") && !config.minimal) {\n    moduleNames.push(\"stakingModule\");\n  }\n  return `[${moduleNames.filter(m => !m.includes(\"//\")).join(\", \")}]`;\n}\n\nasync function installDependencies(config: ProjectConfig, targetDir: string): Promise<void> {\n  const {\n    spawn,\n  } = await import(\"node:child_process\");\n\n  return new Promise((resolve, reject) => {\n    const child = spawn(config.packageManager, [\"install\"], {\n      cwd: targetDir,\n      stdio: \"inherit\",\n    });\n\n    child.on(\"close\", (code) => {\n      if (code !== 0) {\n        reject(new Error(`Package installation failed with code ${code}`));\n      }\n      else {\n        resolve();\n      }\n    });\n  });\n}\n\nasync function buildProject(config: ProjectConfig, targetDir: string): Promise<void> {\n  const {\n    spawn,\n  } = await import(\"node:child_process\");\n\n  return new Promise((resolve, reject) => {\n    const child = spawn(config.packageManager, [\"run\", \"build\"], {\n      cwd: targetDir,\n      stdio: \"inherit\",\n    });\n\n    child.on(\"close\", (code) => {\n      if (code !== 0) {\n        reject(new Error(`Package installation failed with code ${code}`));\n      }\n      else {\n        resolve();\n      }\n    });\n  });\n}\n","import {\n  existsSync,\n} from \"node:fs\";\nimport {\n  dirname, resolve,\n} from \"node:path\";\nimport {\n  fileURLToPath,\n} from \"node:url\";\n\nimport colors from \"picocolors\";\n\nimport {\n  createIndexer,\n} from \"./create-indexer.js\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\nasync function main() {\n  console.log();\n  console.log(colors.cyan(\"🚀 Welcome to create-eclesia-indexer!\"));\n  console.log(colors.gray(\"Scaffolding a new Cosmos SDK chain indexer...\"));\n  console.log();\n\n  try {\n    const projectName = process.argv[2];\n\n    if (projectName && existsSync(resolve(process.cwd(), projectName))) {\n      console.log(colors.red(`❌ Directory '${projectName}' already exists.`));\n      process.exit(1);\n    }\n\n    await createIndexer(projectName);\n\n    console.log();\n    console.log(colors.green(\"✅ Indexer created successfully!\"));\n    console.log();\n  }\n  catch (error) {\n    console.error(colors.red(\"❌ Error creating indexer:\"), error);\n    process.exit(1);\n  }\n}\n\nmain().catch((error) => {\n  console.error(error);\n  process.exit(1);\n});\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "create-eclesia-indexer",
+  "version": "1.0.2",
+  "description": "CLI tool to scaffold Cosmos SDK chain indexers using eclesia-indexer-core",
+  "type": "module",
+  "bin": {
+    "create-eclesia-indexer": "./bin/create-eclesia-indexer.js"
+  },
+  "scripts": {
+    "build": "tsc --noEmit && tsdown",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist/",
+    "templates/",
+    "bin/"
+  ],
+  "keywords": [
+    "cosmos",
+    "indexer",
+    "blockchain",
+    "cli",
+    "scaffolding",
+    "template"
+  ],
+  "author": "",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "enquirer": "^2.4.1",
+    "fs-extra": "^11.2.0",
+    "picocolors": "^1.1.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.14.0",
+    "@eslint/js": "^9.35.0",
+    "@stylistic/eslint-plugin": "^5.3.1",
+    "eslint": "^9.35.0",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "tsdown": "^0.15.2",
+    "typescript": "^5.9.2",
+    "typescript-eslint": "^8.44.0"
+  }
+}

package/templates/basic/.env.template

@@ -0,0 +1,17 @@
+# {{PROJECT_NAME}} Configuration
+
+# Chain RPC endpoint
+RPC_ENDPOINT={{RPC_ENDPOINT}}
+
+# Database connection
+PG_CONNECTION_STRING={{PG_CONNECTION_STRING}}
+
+# Indexer settings
+LOG_LEVEL={{LOG_LEVEL}}
+QUEUE_SIZE={{QUEUE_SIZE}}
+PROCESS_GENESIS={{PROCESS_GENESIS}}
+CHAIN_PREFIX={{CHAIN_PREFIX}}
+USE_POLLING={{USE_POLLING}}
+
+# Optional: Start from specific height
+START_HEIGHT={{START_HEIGHT}}

package/templates/basic/Dockerfile.npm

@@ -0,0 +1,24 @@
+# syntax=docker.io/docker/dockerfile:1.7-labs
+
+FROM node:20-alpine3.21 AS builder
+
+WORKDIR /usr/src/app
+
+COPY package*.json ./
+
+RUN npm ci
+
+COPY --exclude=genesis.json . .
+
+# Final image
+FROM node:20-alpine3.21 
+
+WORKDIR /usr/src/app
+
+COPY package*.json ./
+
+RUN npm ci --only=production && npm cache clean --force
+
+COPY --from=builder /usr/src/app .
+
+ENTRYPOINT ["node", "dist/index.js" ]

package/templates/basic/Dockerfile.pnpm

@@ -0,0 +1,28 @@
+# syntax=docker.io/docker/dockerfile:1.7-labs
+
+FROM node:20-alpine3.21 AS builder
+
+RUN corepack enable && corepack prepare pnpm@latest --activate
+
+WORKDIR /usr/src/app
+
+COPY pnpm-lock.yaml package.json pnpm-workspace.yaml ./
+
+RUN pnpm install --frozen-lockfile
+
+COPY --exclude=genesis.json . .
+
+# Final image
+FROM node:20-alpine3.21 
+
+RUN corepack enable && corepack prepare pnpm@latest --activate
+
+WORKDIR /usr/src/app
+
+COPY pnpm-lock.yaml package.json pnpm-workspace.yaml ./
+
+RUN pnpm install --frozen-lockfile --prod
+
+COPY --from=builder /usr/src/app .
+
+ENTRYPOINT ["node", "dist/index.js" ]

package/templates/basic/Dockerfile.yarn

@@ -0,0 +1,25 @@
+# syntax=docker.io/docker/dockerfile:1.7-labs
+
+FROM node:20-alpine3.21 AS builder
+
+WORKDIR /usr/src/app
+
+COPY package.json yarn.lock ./
+
+RUN yarn install --frozen-lockfile
+
+COPY --exclude=genesis.json . .
+
+# Final image
+FROM node:20-alpine3.21 
+
+WORKDIR /usr/src/app
+
+COPY package.json yarn.lock ./
+
+RUN yarn install --frozen-lockfile --production && \
+    yarn cache clean
+
+COPY --from=builder /usr/src/app .
+
+ENTRYPOINT ["node", "dist/index.js" ]

package/templates/basic/README.md.template

@@ -0,0 +1,109 @@
+# {{PROJECT_NAME}}
+
+{{DESCRIPTION}}
+
+A custom indexer for **{{CHAIN_NAME}}** built with eclesia-indexer-core.
+
+## Features
+
+- ✅ Block indexing
+- ✅ Transaction processing
+- ✅ Module-based architecture
+- ✅ PostgreSQL storage
+- ✅ Real-time synchronization
+- ✅ Docker support
+
+## Prerequisites
+
+- Node.js 18+
+- PostgreSQL 12+
+- Access to {{CHAIN_NAME}} RPC endpoint
+
+## Quick Start
+
+1. **Install dependencies**
+   ```bash
+   npm install
+   ```
+
+2. **Set up environment**
+   ```bash
+   cp .env.example .env
+   # Edit .env with your configuration
+   ```
+
+3. **Start PostgreSQL** (if using Docker)
+   ```bash
+   docker-compose up postgres -d
+   ```
+
+4. **Run the indexer**
+   ```bash
+   npm run build
+   npm start
+   ```
+
+## Configuration
+
+Configure your indexer through environment variables or directly in `src/index.ts`:
+
+- `RPC_ENDPOINT`: {{CHAIN_NAME}} RPC endpoint (default: {{RPC_ENDPOINT}})
+- `PG_CONNECTION_STRING`: PostgreSQL connection string
+- `LOG_LEVEL`: Logging level (info, debug, warn, error)
+- `QUEUE_SIZE`: Batch size for processing blocks
+- `PROCESS_GENESIS`: Whether to process the genesis block
+
+## Docker Deployment
+
+```bash
+docker-compose up -d
+```
+
+This will start both PostgreSQL and the indexer in containers.
+
+## Development
+
+```bash
+npm run dev  # Start in development mode with hot reload
+npm run lint # Run ESLint
+npm run build # Build for production
+```
+
+## Database Schema
+
+The indexer automatically creates the necessary database tables on startup. You can find migration files in the `src/migrations/` directory (if applicable).
+
+## Adding Custom Modules
+
+To add custom indexing logic:
+
+1. Create a new module in `src/modules/`
+2. Implement the required interfaces from eclesia-indexer-core
+3. Register your module in `src/index.ts`
+
+## Troubleshooting
+
+### Common Issues
+
+**Connection refused to database**
+- Ensure PostgreSQL is running
+- Check your connection string
+- Verify network connectivity
+
+**RPC endpoint errors**
+- Verify the RPC endpoint is accessible
+- Check for rate limiting
+- Ensure the endpoint supports the required methods
+
+**High memory usage**
+- Reduce `QUEUE_SIZE` if processing large blocks
+- Monitor PostgreSQL memory usage
+- Consider using connection pooling
+
+## License
+
+ISC
+
+## Support
+
+For issues with eclesia-indexer-core, please refer to the main repository documentation.