@sentio/cli 3.7.0 → 3.8.0-rc.1

package/lib/index.js

@@ -109910,12 +109910,16 @@ function overrideConfigWithOptions(config, options) {
       case "testnet":
         config.sentioNetwork = "7892101";
         break;
+      case "devnet":
+        config.sentioNetwork = "7892201";
+        break;
       case "7892101":
+      case "7892201":
       case "789210":
         config.sentioNetwork = options.sentioNetwork;
         break;
       default:
-        console.error(`Invalid sentio network: ${options.sentioNetwork}, only mainnet or testnet is allowed`);
+        console.error(`Invalid sentio network: ${options.sentioNetwork}, only mainnet, testnet or devnet is allowed`);
         process.exit(1);
     }
   }
@@ -139193,15 +139197,25 @@ var TESTNET_CONFIG = {
   explorerUrl: "https://testnet-explorer.sentio.xyz",
   addressBookAddress: "0x94579F0e7873097279B48d7b15043698c522e47c"
 };
+var DEVNET_CONFIG = {
+  chainId: 7892201,
+  rpcUrl: "https://sentio-devnet.rpc.sentio.xyz",
+  explorerUrl: "https://devnet-explorer.sentio.xyz",
+  // TODO: replace with actual AddressBook address once deployed on devnet
+  addressBookAddress: "0x0000000000000000000000000000000000000000"
+};
 function getSentioNetworkConfig(network) {
   if (network === "testnet" || network === "7892101") {
     return TESTNET_CONFIG;
   }
+  if (network === "devnet" || network === "7892201") {
+    return DEVNET_CONFIG;
+  }
   if (network === "mainnet" || network === "789210") {
     console.error(source_default.red("Sentio Network mainnet is not yet supported. Only testnet is available."));
     process.exit(1);
   }
-  console.error(source_default.red(`Invalid sentio network: ${network}. Only "testnet" is supported.`));
+  console.error(source_default.red(`Invalid sentio network: ${network}. Only "testnet" or "devnet" is supported.`));
   process.exit(1);
 }
 var ADDRESS_BOOK_ABI = [
@@ -139798,6 +139812,18 @@ async function finishUpload(options, auth, sha2565, commitSha, gitUrl, continueF
 }
 
 // src/commands/upload.ts
+var PROCESSOR_ID_RE = /^[a-zA-Z0-9_-]+$/;
+function validateProcessorId(id2) {
+  if (id2.length === 0) {
+    throw new Error("Processor ID must not be empty.");
+  }
+  if (id2.length >= 32) {
+    throw new Error(`Processor ID "${id2}" is too long (${id2.length} chars). Maximum length is 31 characters.`);
+  }
+  if (!PROCESSOR_ID_RE.test(id2)) {
+    throw new Error(`Processor ID "${id2}" contains invalid characters. Only alphanumeric, "-", and "_" are allowed.`);
+  }
+}
 function myParseInt(value, dummyPrevious) {
   const parsedValue = parseInt(value, 10);
   if (isNaN(parsedValue)) {
@@ -139816,12 +139842,12 @@ function createUploadCommand() {
   ).option(
     "--checkpoint <checkpoint...>",
     '(Optional) Checkpoint(s) to rollback to, only available with --continue-from. Format: "chain_id:block_number" or "block_number" (uses default chain). Can specify multiple checkpoints.'
-  ).option("--debug", "(Optional) Run driver in debug mode").option("-y --silent-overwrite", "(Optional) Create project or upload new version without confirmation").option("--skip-build", "Skip build & pack file before uploading").option("--skip-gen", "Skip code generation.").option("--skip-deps", "Skip dependency enforce.").option("--example", "Generate example usage of the processor.").option("--walrus", "Store file in walrus").option("--path <path>", "override project path, default to current directory").option("--api-key <key>", "(Optional) Manually provide API key rather than use saved credential").option("--token <token>", "(Optional) Manually provide token rather than use saved credential").option("--host <host>", "(Optional) Override Sentio Host name").option("--num-workers <count>", "(Optional) Number of processor workers to start", myParseInt).option("--sentio-network <network>", "(Optional) Sentio network to connect to, can be testnet or mainnet").option(
+  ).option("--debug", "(Optional) Run driver in debug mode").option("-y --silent-overwrite", "(Optional) Create project or upload new version without confirmation").option("--skip-build", "Skip build & pack file before uploading").option("--skip-gen", "Skip code generation.").option("--skip-deps", "Skip dependency enforce.").option("--example", "Generate example usage of the processor.").option("--walrus", "Store file in walrus").option("--path <path>", "override project path, default to current directory").option("--api-key <key>", "(Optional) Manually provide API key rather than use saved credential").option("--token <token>", "(Optional) Manually provide token rather than use saved credential").option("--host <host>", "(Optional) Override Sentio Host name").option("--num-workers <count>", "(Optional) Number of processor workers to start", myParseInt).option("--sentio-network <network>", "(Optional) Sentio network to connect to, can be testnet, devnet or mainnet").option(
     "--required-chain-id <chain_id...>",
     "(Optional) Specify chain IDs required for the Sentio network. This option is only available when --sentio-network is used. If omitted, all chain IDs from the project configuration (contracts or network overrides) will be used."
   ).option(
     "--no-platform",
-    "Upload processor directly to Sentio Network without platform support. Requires $PRIVATE_KEY env var. Only testnet is supported."
+    "Upload processor directly to Sentio Network without platform support. Requires $PRIVATE_KEY env var. Only testnet and devnet are supported."
   ).option(
     "--ipfs-put-url <url>",
     "IPFS upload endpoint (used with --no-platform)",
@@ -139924,6 +139950,7 @@ The owner must call Permissions.addOperator(${walletAddress}) first.`
     process.exit(1);
   }
   let processorId = processorConfig.project.replace("/", "_");
+  validateProcessorId(processorId);
   const sdkVersion = getSdkVersion() || "unknown";
   console.log(source_default.blue("Checking if processor already exists on-chain..."));
   const existingProcessor = await getProcessorOnChain(networkConfig, addresses, processorId);
@@ -139949,13 +139976,22 @@ The owner must call Permissions.addOperator(${walletAddress}) first.`
       );
       const randomSuffix = Math.random().toString(36).substring(2, 8);
       const defaultNewId = `${processorId}-${randomSuffix}`;
-      const rl = readline3.createInterface({ input: process.stdin, output: process.stdout });
-      const newId = await new Promise(
-        (resolve) => rl.question(`Enter a new processor ID [${defaultNewId}]: `, (answer) => {
-          rl.close();
-          resolve(answer.trim() || defaultNewId);
-        })
-      );
+      let newId;
+      for (; ; ) {
+        const rl = readline3.createInterface({ input: process.stdin, output: process.stdout });
+        newId = await new Promise(
+          (resolve) => rl.question(`Enter a new processor ID [${defaultNewId}]: `, (answer) => {
+            rl.close();
+            resolve(answer.trim() || defaultNewId);
+          })
+        );
+        try {
+          validateProcessorId(newId);
+          break;
+        } catch (e10) {
+          console.log(source_default.red(e10.message));
+        }
+      }
       processorId = newId;
       console.log(source_default.blue(`Using processor ID: ${processorId}`));
     }
@@ -140201,7 +140237,7 @@ async function checkOrCreateProject(options, auth) {
     console.error(
       source_default.red(
         `Project ${project?.slug} is a Sentio Network project. Please add the --sentio-network flag when uploading.
-Example: sentio upload --sentio-network testnet`
+Example: sentio upload --sentio-network testnet|devnet`
       )
     );
     process.exit(1);
@@ -145453,7 +145489,7 @@ function formatTimestamp3(value) {
 // src/commands/stop-processor.ts
 init_cjs_shim();
 function createStopProcessorCommand() {
-  return new Command("stop").description("Stop a processor. Uses Sentio Network contract when --sentio-network is specified.").argument("<processorId>", "ID of the processor to stop").option("--sentio-network <network>", 'Stop via Sentio Network contract (only "testnet" supported)').option("--host <host>", "Override Sentio host").option("--api-key <key>", "Use an explicit API key instead of saved credentials").option("--token <token>", "Use an explicit bearer token instead of saved credentials").option("--project <owner/slug>", "Sentio project in <owner>/<slug> format").option("--owner <owner>", "Sentio project owner").option("--name <name>", "Sentio project name").option("-y, --yes", "Bypass confirmation").showHelpAfterError().action(async (processorId, options) => {
+  return new Command("stop").description("Stop a processor. Uses Sentio Network contract when --sentio-network is specified.").argument("<processorId>", "ID of the processor to stop").option("--sentio-network <network>", "Stop via Sentio Network contract (testnet or devnet)").option("--host <host>", "Override Sentio host").option("--api-key <key>", "Use an explicit API key instead of saved credentials").option("--token <token>", "Use an explicit bearer token instead of saved credentials").option("--project <owner/slug>", "Sentio project in <owner>/<slug> format").option("--owner <owner>", "Sentio project owner").option("--name <name>", "Sentio project name").option("-y, --yes", "Bypass confirmation").option("--no-delete", "Skip deleting the processor after stopping").showHelpAfterError().action(async (processorId, options) => {
     try {
       if (options.sentioNetwork) {
         await runStopProcessorOnChain(processorId, options);
@@ -145473,16 +145509,22 @@ async function runStopProcessorOnChain(processorId, options) {
   console.log(source_default.blue(`Wallet address: ${wallet.address}`));
   console.log(source_default.blue("Resolving contract addresses from AddressBook..."));
   const addresses = await resolveNetworkAddresses(networkConfig);
+  const willDelete = options.delete !== false;
   if (!options.yes) {
-    const confirmed = await confirm(`Stop processor "${processorId}" on Sentio Network ${network}?`);
+    const action = willDelete ? "Stop and delete" : "Stop";
+    const confirmed = await confirm(`${action} processor "${processorId}" on Sentio Network ${network}?`);
     if (!confirmed) {
-      console.log("Stop cancelled.");
+      console.log("Cancelled.");
       return;
     }
   }
   await stopProcessorOnChain(networkConfig, addresses, wallet, processorId);
-  console.log();
   console.log(source_default.green(`Processor "${processorId}" stopped on Sentio Network ${network}.`));
+  if (willDelete) {
+    console.log();
+    await deleteProcessorOnChain(networkConfig, addresses, wallet, processorId);
+    console.log(source_default.green(`Processor "${processorId}" deleted on Sentio Network ${network}.`));
+  }
 }
 
 // src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentio/cli",
-  "version": "3.7.0",
+  "version": "3.8.0-rc.1",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {

package/src/commands/stop-processor.ts

@@ -8,14 +8,15 @@ import {
   resolveNetworkAddresses,
   getWalletFromPrivateKey,
   requirePrivateKey,
-  stopProcessorOnChain
+  stopProcessorOnChain,
+  deleteProcessorOnChain
 } from '../network.js'
 
 export function createStopProcessorCommand() {
   return new Command('stop')
     .description('Stop a processor. Uses Sentio Network contract when --sentio-network is specified.')
     .argument('<processorId>', 'ID of the processor to stop')
-    .option('--sentio-network <network>', 'Stop via Sentio Network contract (only "testnet" supported)')
+    .option('--sentio-network <network>', 'Stop via Sentio Network contract (testnet or devnet)')
     .option('--host <host>', 'Override Sentio host')
     .option('--api-key <key>', 'Use an explicit API key instead of saved credentials')
     .option('--token <token>', 'Use an explicit bearer token instead of saved credentials')
@@ -23,6 +24,7 @@ export function createStopProcessorCommand() {
     .option('--owner <owner>', 'Sentio project owner')
     .option('--name <name>', 'Sentio project name')
     .option('-y, --yes', 'Bypass confirmation')
+    .option('--no-delete', 'Skip deleting the processor after stopping')
     .showHelpAfterError()
     .action(async (processorId, options) => {
       try {
@@ -37,7 +39,10 @@ export function createStopProcessorCommand() {
     })
 }
 
-async function runStopProcessorOnChain(processorId: string, options: { sentioNetwork?: string; yes?: boolean }) {
+async function runStopProcessorOnChain(
+  processorId: string,
+  options: { sentioNetwork?: string; yes?: boolean; delete?: boolean }
+) {
   const network = options.sentioNetwork!
   const networkConfig = getSentioNetworkConfig(network)
 
@@ -48,16 +53,23 @@ async function runStopProcessorOnChain(processorId: string, options: { sentioNet
   console.log(chalk.blue('Resolving contract addresses from AddressBook...'))
   const addresses = await resolveNetworkAddresses(networkConfig)
 
+  const willDelete = options.delete !== false
+
   if (!options.yes) {
-    const confirmed = await confirm(`Stop processor "${processorId}" on Sentio Network ${network}?`)
+    const action = willDelete ? 'Stop and delete' : 'Stop'
+    const confirmed = await confirm(`${action} processor "${processorId}" on Sentio Network ${network}?`)
     if (!confirmed) {
-      console.log('Stop cancelled.')
+      console.log('Cancelled.')
       return
     }
   }
 
   await stopProcessorOnChain(networkConfig, addresses, wallet, processorId)
-
-  console.log()
   console.log(chalk.green(`Processor "${processorId}" stopped on Sentio Network ${network}.`))
+
+  if (willDelete) {
+    console.log()
+    await deleteProcessorOnChain(networkConfig, addresses, wallet, processorId)
+    console.log(chalk.green(`Processor "${processorId}" deleted on Sentio Network ${network}.`))
+  }
 }

package/src/commands/upload.ts

@@ -33,6 +33,20 @@ import { ethers } from 'ethers'
 import { Auth, DefaultBatchUploader, FileType, IPFSBatchUploader, WalrusBatchUploader } from '../uploader.js'
 export { type Auth } from '../uploader.js'
 
+const PROCESSOR_ID_RE = /^[a-zA-Z0-9_-]+$/
+
+function validateProcessorId(id: string): void {
+  if (id.length === 0) {
+    throw new Error('Processor ID must not be empty.')
+  }
+  if (id.length >= 32) {
+    throw new Error(`Processor ID "${id}" is too long (${id.length} chars). Maximum length is 31 characters.`)
+  }
+  if (!PROCESSOR_ID_RE.test(id)) {
+    throw new Error(`Processor ID "${id}" contains invalid characters. Only alphanumeric, "-", and "_" are allowed.`)
+  }
+}
+
 function myParseInt(value: string, dummyPrevious: number): number {
   // parseInt takes a string and a radix
   const parsedValue = parseInt(value, 10)
@@ -71,14 +85,14 @@ export function createUploadCommand() {
     .option('--token <token>', '(Optional) Manually provide token rather than use saved credential')
     .option('--host <host>', '(Optional) Override Sentio Host name')
     .option('--num-workers <count>', '(Optional) Number of processor workers to start', myParseInt)
-    .option('--sentio-network <network>', '(Optional) Sentio network to connect to, can be testnet or mainnet')
+    .option('--sentio-network <network>', '(Optional) Sentio network to connect to, can be testnet, devnet or mainnet')
     .option(
       '--required-chain-id <chain_id...>',
       '(Optional) Specify chain IDs required for the Sentio network. This option is only available when --sentio-network is used. If omitted, all chain IDs from the project configuration (contracts or network overrides) will be used.'
     )
     .option(
       '--no-platform',
-      'Upload processor directly to Sentio Network without platform support. Requires $PRIVATE_KEY env var. Only testnet is supported.'
+      'Upload processor directly to Sentio Network without platform support. Requires $PRIVATE_KEY env var. Only testnet and devnet are supported.'
     )
     .option(
       '--ipfs-put-url <url>',
@@ -208,6 +222,7 @@ async function runNoPlatformUpload(
 
   // Step 7: Derive processor ID from project name
   let processorId = processorConfig.project.replace('/', '_')
+  validateProcessorId(processorId)
   const sdkVersion = getSdkVersion() || 'unknown'
 
   // Step 7.5: Check if processor already exists on-chain
@@ -242,13 +257,22 @@ async function runNoPlatformUpload(
       const randomSuffix = Math.random().toString(36).substring(2, 8)
       const defaultNewId = `${processorId}-${randomSuffix}`
 
-      const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
-      const newId: string = await new Promise((resolve) =>
-        rl.question(`Enter a new processor ID [${defaultNewId}]: `, (answer) => {
-          rl.close()
-          resolve(answer.trim() || defaultNewId)
-        })
-      )
+      let newId: string
+      for (;;) {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+        newId = await new Promise((resolve) =>
+          rl.question(`Enter a new processor ID [${defaultNewId}]: `, (answer) => {
+            rl.close()
+            resolve(answer.trim() || defaultNewId)
+          })
+        )
+        try {
+          validateProcessorId(newId)
+          break
+        } catch (e: any) {
+          console.log(chalk.red(e.message))
+        }
+      }
       processorId = newId
       console.log(chalk.blue(`Using processor ID: ${processorId}`))
     }
@@ -538,7 +562,7 @@ async function checkOrCreateProject(options: YamlProjectConfig, auth: Auth) {
     console.error(
       chalk.red(
         `Project ${project?.slug} is a Sentio Network project. Please add the --sentio-network flag when uploading.\n` +
-          `Example: sentio upload --sentio-network testnet`
+          `Example: sentio upload --sentio-network testnet|devnet`
       )
     )
     process.exit(1)

package/src/config.ts

@@ -115,12 +115,16 @@ export function overrideConfigWithOptions(config: YamlProjectConfig, options: an
       case 'testnet':
         config.sentioNetwork = '7892101'
         break
+      case 'devnet':
+        config.sentioNetwork = '7892201'
+        break
       case '7892101':
+      case '7892201':
       case '789210':
         config.sentioNetwork = options.sentioNetwork
         break
       default:
-        console.error(`Invalid sentio network: ${options.sentioNetwork}, only mainnet or testnet is allowed`)
+        console.error(`Invalid sentio network: ${options.sentioNetwork}, only mainnet, testnet or devnet is allowed`)
         process.exit(1)
     }
   }

package/src/network.ts

@@ -20,15 +20,26 @@ const TESTNET_CONFIG: SentioNetworkConfig = {
   addressBookAddress: '0x94579F0e7873097279B48d7b15043698c522e47c'
 }
 
+const DEVNET_CONFIG: SentioNetworkConfig = {
+  chainId: 7892201,
+  rpcUrl: 'https://sentio-devnet.rpc.sentio.xyz',
+  explorerUrl: 'https://devnet-explorer.sentio.xyz',
+  // TODO: replace with actual AddressBook address once deployed on devnet
+  addressBookAddress: '0x0000000000000000000000000000000000000000'
+}
+
 export function getSentioNetworkConfig(network: string): SentioNetworkConfig {
   if (network === 'testnet' || network === '7892101') {
     return TESTNET_CONFIG
   }
+  if (network === 'devnet' || network === '7892201') {
+    return DEVNET_CONFIG
+  }
   if (network === 'mainnet' || network === '789210') {
     console.error(chalk.red('Sentio Network mainnet is not yet supported. Only testnet is available.'))
     process.exit(1)
   }
-  console.error(chalk.red(`Invalid sentio network: ${network}. Only "testnet" is supported.`))
+  console.error(chalk.red(`Invalid sentio network: ${network}. Only "testnet" or "devnet" is supported.`))
   process.exit(1)
 }