@logrix/sdk 0.3.0 → 0.3.1

package/dist/commands/add.js

@@ -40,40 +40,66 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const yaml_1 = require("yaml");
 const templates_1 = require("../templates");
+const EXPLORER_APIS = {
+    1: "https://api.etherscan.io/api",
+    42161: "https://api.arbiscan.io/api",
+    10: "https://api-optimistic.etherscan.io/api",
+    8453: "https://api.basescan.org/api",
+    137: "https://api.polygonscan.com/api",
+    56: "https://api.bscscan.com/api",
+    43114: "https://api.snowtrace.io/api",
+    59144: "https://api.lineascan.build/api",
+    534352: "https://api.scrollscan.com/api",
+    81457: "https://api.blastscan.io/api",
+    100: "https://api.gnosisscan.io/api",
+    250: "https://api.ftmscan.com/api",
+    42220: "https://api.celoscan.io/api",
+    1101: "https://api-zkevm.polygonscan.com/api",
+    11155111: "https://api-sepolia.etherscan.io/api",
+    17000: "https://api-holesky.etherscan.io/api",
+    421614: "https://api-sepolia.arbiscan.io/api",
+    84532: "https://api-sepolia.basescan.org/api",
+    11155420: "https://api-sepolia-optimistic.etherscan.io/api",
+    80002: "https://api-amoy.polygonscan.com/api",
+    97: "https://api-testnet.bscscan.com/api",
+    43113: "https://api-testnet.snowtrace.io/api",
+    59141: "https://api-sepolia.lineascan.build/api",
+    534351: "https://api-sepolia.scrollscan.com/api",
+    168587773: "https://api-sepolia.blastscan.io/api",
+};
 /**
- * Fetch ABI from Etherscan (mainnet) or Sourcify as fallback.
- * Returns the parsed ABI array, or null if both fail.
+ * Fetch ABI from Etherscan/Etherscan-compatible chain explorer or Sourcify as fallback.
+ * Supports all 26+ major EVM mainnets and testnets.
  */
-async function fetchAbi(address, etherscanKey) {
+async function fetchAbi(address, chainId = 1, apiKey) {
     const addr = address.toLowerCase();
-    // Try Etherscan first if API key provided
-    if (etherscanKey) {
-        try {
-            const url = `https://api.etherscan.io/api?module=contract&action=getabi&address=${addr}&apikey=${etherscanKey}`;
-            const resp = await fetch(url);
-            const json = await resp.json();
-            if (json.status === "1" && json.result) {
-                const parsed = JSON.parse(json.result);
-                if (Array.isArray(parsed) && parsed.length > 0) {
-                    console.log(`  Fetched ABI from Etherscan for ${address}`);
-                    return parsed;
-                }
+    // Try Etherscan-compatible explorer API
+    const baseExplorer = EXPLORER_APIS[chainId] || EXPLORER_APIS[1];
+    try {
+        const keyParam = apiKey ? `&apikey=${apiKey}` : "";
+        const url = `${baseExplorer}?module=contract&action=getabi&address=${addr}${keyParam}`;
+        const resp = await fetch(url);
+        const json = await resp.json();
+        if (json.status === "1" && json.result) {
+            const parsed = JSON.parse(json.result);
+            if (Array.isArray(parsed) && parsed.length > 0) {
+                console.log(`  Fetched verified ABI from block explorer for ${address}`);
+                return parsed;
             }
         }
-        catch {
-            // fall through
-        }
     }
-    // Try Sourcify (no key required)
+    catch {
+        // fall through to Sourcify
+    }
+    // Try Sourcify (supports any chainId, no API key required)
     try {
-        // Sourcify returns verified contracts at chainId 1 (mainnet)
-        const url = `https://repo.sourcify.dev/contracts/full_match/1/${addr}/metadata.json`;
+        const url = `https://repo.sourcify.dev/contracts/full_match/${chainId}/${addr}/metadata.json`;
         const resp = await fetch(url);
         if (resp.ok) {
             const json = await resp.json();
             const abi = json?.output?.abi;
             if (Array.isArray(abi) && abi.length > 0) {
-                console.log(`  Fetched ABI from Sourcify for ${address}`);
+                console.log(`  Fetched verified ABI from Sourcify for ${address}`);
                 return abi;
             }
         }
@@ -91,8 +117,8 @@ function addCommand() {
         .argument("[name]", "Name of the component")
         .option("--address <address>", "Contract address")
         .option("--abi <path>", "Path to ABI JSON file")
-        .option("--fetch-abi", "Auto-fetch ABI from Etherscan / Sourcify")
-        .option("--etherscan-key <key>", "Etherscan API key for ABI fetch (optional)")
+        .option("--fetch-abi", "Auto-fetch ABI from block explorer / Sourcify")
+        .option("--etherscan-key <key>", "Explorer API key for ABI fetch (optional)")
         .option("--start-block <block>", "Starting block number", "0")
         .action(async (type, nameArg, opts) => {
         const projectDir = process.cwd();
@@ -116,6 +142,7 @@ function addCommand() {
         if (!config.dataSources) {
             config.dataSources = [];
         }
+        const chainId = config.network?.chainId ?? 1;
         // 1. Resolve contract name
         let contractName = nameArg;
         if (!contractName) {
@@ -168,7 +195,6 @@ function addCommand() {
         fs.mkdirSync(abisDir, { recursive: true });
         const targetAbiFile = path.join(abisDir, `${contractName}.json`);
         if (opts.abi) {
-            // Explicit local file
             const sourceAbi = path.resolve(projectDir, opts.abi);
             if (!fs.existsSync(sourceAbi)) {
                 console.error(`Error: Specified ABI file not found: ${opts.abi}`);
@@ -178,9 +204,8 @@ function addCommand() {
             console.log(`  Copied ABI from ${opts.abi} to abis/${contractName}.json`);
         }
         else if (opts.fetchAbi) {
-            // Auto-fetch from Etherscan / Sourcify
-            console.log(`  Fetching ABI for ${contractAddress} ...`);
-            const abi = await fetchAbi(contractAddress, opts.etherscanKey);
+            console.log(`  Fetching ABI for ${contractAddress} (Chain ID: ${chainId}) ...`);
+            const abi = await fetchAbi(contractAddress, chainId, opts.etherscanKey);
             if (abi) {
                 fs.writeFileSync(targetAbiFile, JSON.stringify(abi, null, 2));
                 console.log(`  Saved fetched ABI to abis/${contractName}.json`);
@@ -191,7 +216,6 @@ function addCommand() {
             }
         }
         else if (!fs.existsSync(targetAbiFile)) {
-            // Default placeholder
             fs.writeFileSync(targetAbiFile, JSON.stringify(templates_1.ERC20_ABI, null, 2));
             console.log(`  Created default ERC-20 placeholder ABI at abis/${contractName}.json`);
         }

package/dist/commands/init.js

@@ -33,19 +33,42 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.NETWORKS = void 0;
 exports.initCommand = initCommand;
 const commander_1 = require("commander");
 const prompts_1 = require("@inquirer/prompts");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const templates_1 = require("../templates");
-const NETWORKS = {
-    "ethereum": { name: "ethereum", chainId: 1, rpcUrl: "https://eth.llamarpc.com" },
-    "arbitrum-one": { name: "arbitrum-one", chainId: 42161, rpcUrl: "https://arb1.arbitrum.io/rpc" },
-    "base": { name: "base", chainId: 8453, rpcUrl: "https://mainnet.base.org" },
-    "polygon": { name: "polygon", chainId: 137, rpcUrl: "https://polygon-rpc.com" },
-    "arbitrum-sepolia": { name: "arbitrum-sepolia", chainId: 421614, rpcUrl: "https://sepolia-rollup.arbitrum.io/rpc" },
-    "sepolia": { name: "sepolia", chainId: 11155111, rpcUrl: "https://rpc.sepolia.org" },
+exports.NETWORKS = {
+    // Mainnets
+    "ethereum": { name: "Ethereum Mainnet", chainId: 1, rpcUrl: "https://eth.llamarpc.com", category: "mainnet" },
+    "arbitrum-one": { name: "Arbitrum One", chainId: 42161, rpcUrl: "https://arb1.arbitrum.io/rpc", category: "mainnet" },
+    "base": { name: "Base Mainnet", chainId: 8453, rpcUrl: "https://mainnet.base.org", category: "mainnet" },
+    "optimism": { name: "Optimism Mainnet", chainId: 10, rpcUrl: "https://mainnet.optimism.io", category: "mainnet" },
+    "polygon": { name: "Polygon PoS", chainId: 137, rpcUrl: "https://polygon-rpc.com", category: "mainnet" },
+    "bsc": { name: "BNB Smart Chain", chainId: 56, rpcUrl: "https://binance.llamarpc.com", category: "mainnet" },
+    "avalanche": { name: "Avalanche C-Chain", chainId: 43114, rpcUrl: "https://api.avax.network/ext/bc/C/rpc", category: "mainnet" },
+    "linea": { name: "Linea Mainnet", chainId: 59144, rpcUrl: "https://rpc.linea.build", category: "mainnet" },
+    "scroll": { name: "Scroll Mainnet", chainId: 534352, rpcUrl: "https://rpc.scroll.io", category: "mainnet" },
+    "blast": { name: "Blast Mainnet", chainId: 81457, rpcUrl: "https://rpc.blast.io", category: "mainnet" },
+    "zksync": { name: "ZKsync Era", chainId: 324, rpcUrl: "https://mainnet.era.zksync.io", category: "mainnet" },
+    "gnosis": { name: "Gnosis Chain", chainId: 100, rpcUrl: "https://rpc.gnosischain.com", category: "mainnet" },
+    "fantom": { name: "Fantom Opera", chainId: 250, rpcUrl: "https://rpcapi.fantom.network", category: "mainnet" },
+    "celo": { name: "Celo Mainnet", chainId: 42220, rpcUrl: "https://forno.celo.org", category: "mainnet" },
+    "polygon-zkevm": { name: "Polygon zkEVM", chainId: 1101, rpcUrl: "https://zkevm-rpc.com", category: "mainnet" },
+    // Testnets
+    "sepolia": { name: "Ethereum Sepolia", chainId: 11155111, rpcUrl: "https://rpc.sepolia.org", category: "testnet" },
+    "holesky": { name: "Ethereum Holesky", chainId: 17000, rpcUrl: "https://ethereum-holesky-rpc.publicnode.com", category: "testnet" },
+    "arbitrum-sepolia": { name: "Arbitrum Sepolia", chainId: 421614, rpcUrl: "https://sepolia-rollup.arbitrum.io/rpc", category: "testnet" },
+    "base-sepolia": { name: "Base Sepolia", chainId: 84532, rpcUrl: "https://sepolia.base.org", category: "testnet" },
+    "optimism-sepolia": { name: "Optimism Sepolia", chainId: 11155420, rpcUrl: "https://sepolia.optimism.io", category: "testnet" },
+    "polygon-amoy": { name: "Polygon Amoy", chainId: 80002, rpcUrl: "https://rpc-amoy.polygon.technology", category: "testnet" },
+    "bsc-testnet": { name: "BNB Smart Chain Testnet", chainId: 97, rpcUrl: "https://data-seed-prebsc-1-s1.binance.org:8545", category: "testnet" },
+    "avalanche-fuji": { name: "Avalanche Fuji", chainId: 43113, rpcUrl: "https://api.avax-test.network/ext/bc/C/rpc", category: "testnet" },
+    "linea-sepolia": { name: "Linea Sepolia", chainId: 59141, rpcUrl: "https://rpc.sepolia.linea.build", category: "testnet" },
+    "scroll-sepolia": { name: "Scroll Sepolia", chainId: 534351, rpcUrl: "https://sepolia-rpc.scroll.io", category: "testnet" },
+    "blast-sepolia": { name: "Blast Sepolia", chainId: 168587773, rpcUrl: "https://sepolia.blast.io", category: "testnet" },
 };
 function initCommand() {
     const cmd = new commander_1.Command("init");
@@ -53,7 +76,7 @@ function initCommand() {
         .description("Scaffold a new Logrix indexer project")
         .argument("[name]", "Project directory name")
         .option("-y, --yes", "Skip prompts and use defaults (non-interactive)")
-        .option("--network <network>", "Network preset name (e.g. arbitrum-one, ethereum, base)")
+        .option("--network <network>", "Network preset name (e.g. arbitrum-one, ethereum, base, sepolia)")
         .option("--rpc <url>", "Custom RPC endpoint URL")
         .option("--contract-name <name>", "Contract name")
         .option("--address <address>", "Contract target address")
@@ -83,22 +106,22 @@ function initCommand() {
         }
         // Network selection
         let networkKey = opts.network;
-        if (!networkKey || !NETWORKS[networkKey]) {
+        if (!networkKey || !exports.NETWORKS[networkKey]) {
             if (isNonInteractive) {
                 networkKey = "arbitrum-one";
             }
             else {
                 networkKey = await (0, prompts_1.select)({
                     message: "Network:",
-                    choices: Object.entries(NETWORKS).map(([key, net]) => ({
-                        name: `${net.name} (chain ${net.chainId})`,
+                    choices: Object.entries(exports.NETWORKS).map(([key, net]) => ({
+                        name: `[${net.category.toUpperCase()}] ${net.name} (Chain ID: ${net.chainId})`,
                         value: key,
                     })),
                     default: "arbitrum-one",
                 });
             }
         }
-        const network = NETWORKS[networkKey] || NETWORKS["arbitrum-one"];
+        const network = exports.NETWORKS[networkKey] || exports.NETWORKS["arbitrum-one"];
         // RPC URL
         let rpcUrl = opts.rpc;
         if (!rpcUrl) {
@@ -140,7 +163,7 @@ function initCommand() {
                 contractAddress = await (0, prompts_1.input)({
                     message: "Contract address:",
                     default: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
-                    validate: (v) => /^0x[0-9a-fA-F]{40}$/.test(v.trim()) || "Must be a valid 0x address",
+                    validate: (v) => /^0x[0-9a-fA-F]{40}$/.test(v.trim()) || "Must be a valid 0x hex address",
                 });
             }
         }
@@ -153,41 +176,34 @@ function initCommand() {
             }
             else {
                 startBlockStr = await (0, prompts_1.input)({
-                    message: "Start block:",
+                    message: "Start block (indexing starting point):",
                     default: "0",
                     validate: (v) => /^\d+$/.test(v.trim()) || "Must be a non-negative integer",
                 });
             }
         }
+        const startBlock = parseInt(startBlockStr.trim(), 10);
         const answers = {
             projectName,
-            networkName: network.name,
+            networkName: networkKey,
             chainId: network.chainId,
             rpcUrl,
             contractName,
             contractAddress,
-            startBlock: parseInt(startBlockStr.trim(), 10),
+            startBlock,
         };
-        console.log(`Scaffolding in ./${projectName}/ ...\n`);
-        // Directory structure
+        console.log(`\nScaffolding in ./${projectName}/ ...\n`);
+        // Create directories
         fs.mkdirSync(path.join(targetDir, "abis"), { recursive: true });
         fs.mkdirSync(path.join(targetDir, "src"), { recursive: true });
-        fs.mkdirSync(path.join(targetDir, "build"), { recursive: true });
-        // logrix.yaml
+        // Write files
         fs.writeFileSync(path.join(targetDir, "logrix.yaml"), (0, templates_1.logrixYamlTemplate)(answers));
-        // schema.graphql
         fs.writeFileSync(path.join(targetDir, "schema.graphql"), (0, templates_1.schemaGraphqlTemplate)());
-        // Placeholder ABI
-        fs.writeFileSync(path.join(targetDir, "abis", `${answers.contractName}.json`), JSON.stringify(templates_1.ERC20_ABI, null, 2));
-        // src/mapping.ts
-        fs.writeFileSync(path.join(targetDir, "src", "mapping.ts"), (0, templates_1.mappingTemplate)(answers.contractName));
-        // package.json
+        fs.writeFileSync(path.join(targetDir, "abis", `${contractName}.json`), JSON.stringify(templates_1.ERC20_ABI, null, 2));
+        fs.writeFileSync(path.join(targetDir, "src", "mapping.ts"), (0, templates_1.mappingTemplate)(contractName));
         fs.writeFileSync(path.join(targetDir, "package.json"), JSON.stringify((0, templates_1.packageJsonTemplate)(projectName), null, 2));
-        // tsconfig.json (AS config)
         fs.writeFileSync(path.join(targetDir, "tsconfig.json"), JSON.stringify((0, templates_1.tsconfigTemplate)(), null, 2));
-        // .gitignore
         fs.writeFileSync(path.join(targetDir, ".gitignore"), (0, templates_1.gitignoreTemplate)());
-        // README.md
         fs.writeFileSync(path.join(targetDir, "README.md"), (0, templates_1.readmeTemplate)(projectName));
         console.log("Done. Next steps:\n");
         console.log(`  cd ${projectName}`);

package/dist/index.js

@@ -13,7 +13,7 @@ const program = new commander_1.Command();
 program
     .name("logrix")
     .description("Developer CLI for Logrix blockchain indexers")
-    .version("0.3.0");
+    .version("0.3.1");
 program.addCommand((0, init_1.initCommand)());
 program.addCommand((0, add_1.addCommand)());
 program.addCommand((0, codegen_1.codegenCommand)());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logrix/sdk",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Official CLI and AssemblyScript runtime library for Logrix blockchain indexers",
   "main": "index.ts",
   "bin": {