@sentio/cli 3.6.3-rc.1 → 3.7.0-rc.2

package/lib/index.js

@@ -139190,7 +139190,7 @@ var TESTNET_CONFIG = {
   chainId: 7892101,
   rpcUrl: "https://sentio-testnet.rpc.sentio.xyz",
   explorerUrl: "https://testnet-explorer.sentio.xyz",
-  addressBookAddress: "0x11cDDF46f16925aa630Af9D5158028E56309868f"
+  addressBookAddress: "0x94579F0e7873097279B48d7b15043698c522e47c"
 };
 function getSentioNetworkConfig(network) {
   if (network === "testnet" || network === "7892101") {
@@ -139214,6 +139214,13 @@ var PROCESSOR_REGISTRY_ABI = [
     tuple(string chainId, bool enableRpc, bool enableTrace)[] requireChains,
     string sdkVersion
   ) returns (string)`,
+  `function createProcessor(
+    address owner,
+    string id,
+    tuple(uint8 sourceType, string ipfsCid) source,
+    tuple(string chainId, bool enableRpc, bool enableTrace)[] requireChains,
+    string sdkVersion
+  ) returns (string)`,
   "event ProcessorCreated(string indexed processorId)",
   `function getProcessor(string processorId) view returns (
     tuple(
@@ -139235,6 +139242,7 @@ var CONTROLLER_ABI = [
   "function getAllocations(string processorId) view returns (tuple(uint256 indexerId, uint256 allocationTime, bool indexerReady, uint256 replicaIndex)[])"
 ];
 var DATABASES_ABI = ["function getProcessorDatabases(string processorId) view returns (string[])"];
+var PERMISSIONS_ABI = ["function isOperator(address account, address operator) view returns (bool)"];
 var ERC20_ABI = [
   "function balanceOf(address account) view returns (uint256)",
   "function approve(address spender, uint256 amount) returns (bool)"
@@ -139245,7 +139253,8 @@ var ADDRESS_BOOK_KEYS = {
   controller: "controller",
   token: "sentio_token",
   billing: "billing",
-  databases: "databases"
+  databases: "databases",
+  permissions: "permissions"
 };
 var cachedAddresses;
 async function resolveNetworkAddresses(config) {
@@ -139266,19 +139275,29 @@ async function resolveNetworkAddresses(config) {
       }
     }
   };
-  const [processorRegistry, controller, token, billing, databases] = await Promise.all([
+  const [processorRegistry, controller, token, billing, databases, permissions] = await Promise.all([
     resolveAddress2(ADDRESS_BOOK_KEYS.processorRegistry),
     resolveAddress2(ADDRESS_BOOK_KEYS.controller),
     resolveAddress2(ADDRESS_BOOK_KEYS.token),
     resolveAddress2(ADDRESS_BOOK_KEYS.billing),
-    resolveAddress2(ADDRESS_BOOK_KEYS.databases)
+    resolveAddress2(ADDRESS_BOOK_KEYS.databases),
+    resolveAddress2(ADDRESS_BOOK_KEYS.permissions)
   ]);
   console.log(source_default.gray(`ProcessorRegistry: ${processorRegistry}`));
   console.log(source_default.gray(`Controller:        ${controller}`));
   console.log(source_default.gray(`ST Token:          ${token}`));
   console.log(source_default.gray(`Billing:           ${billing}`));
   console.log(source_default.gray(`Databases:         ${databases}`));
-  cachedAddresses = { addressBook: addressBookAddr, processorRegistry, controller, token, billing, databases };
+  console.log(source_default.gray(`Permissions:       ${permissions}`));
+  cachedAddresses = {
+    addressBook: addressBookAddr,
+    processorRegistry,
+    controller,
+    token,
+    billing,
+    databases,
+    permissions
+  };
   return cachedAddresses;
 }
 function getWalletFromPrivateKey(privateKey) {
@@ -139314,6 +139333,11 @@ async function checkBillingBalance(config, addresses, walletAddress) {
     return 0n;
   }
 }
+async function isOperatorOnChain(config, addresses, owner, operator) {
+  const provider = new ethers_exports.JsonRpcProvider(config.rpcUrl);
+  const permissions = new ethers_exports.Contract(addresses.permissions, PERMISSIONS_ABI, provider);
+  return await permissions.isOperator(owner, operator);
+}
 async function uploadToIPFS(fileBuffer, ipfsUrl) {
   const formData = new FormData();
   const blob = new Blob([fileBuffer], { type: "application/octet-stream" });
@@ -139398,7 +139422,7 @@ async function waitForProcessorDatabaseCleanup(addresses, processorId, provider,
   }
   throw new Error(`Timeout: processor databases not cleaned up within ${timeoutMs / 1e3}s`);
 }
-async function createProcessorOnChain(config, addresses, wallet, processorId, ipfsCid, requiredChainIds, sdkVersion) {
+async function createProcessorOnChain(config, addresses, wallet, processorId, ipfsCid, requiredChainIds, sdkVersion, ownerOverride) {
   const provider = new ethers_exports.JsonRpcProvider(config.rpcUrl);
   const signer = wallet.connect(provider);
   const registry = new ethers_exports.Contract(addresses.processorRegistry, PROCESSOR_REGISTRY_ABI, signer);
@@ -139417,11 +139441,22 @@ async function createProcessorOnChain(config, addresses, wallet, processorId, ip
   console.log(source_default.gray(`  IPFS CID:     ${ipfsCid}`));
   console.log(source_default.gray(`  Chains:        ${requiredChainIds.join(", ")}`));
   console.log(source_default.gray(`  SDK Version:   ${sdkVersion}`));
-  const tx = await submitAndWait(
-    config.explorerUrl,
-    "createProcessor",
-    registry.createProcessor(processorId, source, requireChains, sdkVersion)
+  if (ownerOverride) {
+    console.log(source_default.gray(`  Owner:         ${ownerOverride} (operator: ${wallet.address})`));
+  }
+  const txPromise = ownerOverride ? registry["createProcessor(address,string,(uint8,string),(string,bool,bool)[],string)"](
+    ownerOverride,
+    processorId,
+    source,
+    requireChains,
+    sdkVersion
+  ) : registry["createProcessor(string,(uint8,string),(string,bool,bool)[],string)"](
+    processorId,
+    source,
+    requireChains,
+    sdkVersion
   );
+  const tx = await submitAndWait(config.explorerUrl, "createProcessor", txPromise);
   console.log(source_default.green(`Processor created. Tx: ${config.explorerUrl}/tx/${tx.hash}`));
   return tx.hash;
 }
@@ -139448,24 +139483,31 @@ async function stopProcessorOnChain(config, addresses, wallet, processorId) {
   console.log(source_default.green(`Processor stopped. Tx: ${config.explorerUrl}/tx/${tx.hash}`));
   return tx.hash;
 }
-async function confirmNoPlatformUpload(walletAddress, stBalance, billingBalance, addresses, networkConfig) {
+async function confirmNoPlatformUpload(walletAddress, stBalance, billingBalance, addresses, networkConfig, ownerOverride) {
   const formattedST = ethers_exports.formatEther(stBalance);
   const formattedBilling = ethers_exports.formatEther(billingBalance);
   console.log();
   console.log(source_default.blue("=== Sentio Network Direct Upload (No Platform) ==="));
-  console.log(source_default.white(`  Address:         ${walletAddress}`));
+  if (ownerOverride) {
+    console.log(source_default.white(`  Owner:           ${ownerOverride}`));
+    console.log(source_default.white(`  Operator:        ${walletAddress}`));
+  } else {
+    console.log(source_default.white(`  Address:         ${walletAddress}`));
+  }
   console.log(source_default.white(`  ST Balance:      ${formattedST} ST`));
   console.log(source_default.white(`  Billing Balance: ${formattedBilling} ST`));
   if (billingBalance === 0n) {
+    const who = ownerOverride ? `the owner (${ownerOverride})` : "you";
+    const keyHint = ownerOverride ? "<owner's private key>" : "$PRIVATE_KEY";
     console.log();
     console.log(
       source_default.yellow(
-        `  \u26A0 Your Billing balance is 0. Indexing fees are charged from the Billing contract.
-    You must deposit ST tokens into the Billing contract before your processor can run.
+        `  \u26A0 ${ownerOverride ? "Owner's" : "Your"} Billing balance is 0. Indexing fees are charged from the Billing contract.
+    ${who} must deposit ST tokens into the Billing contract before the processor can run.
     Example (replace 100 with your desired ST amount):
     export AMOUNT=$(cast to-wei 100 ether)
-    cast send ${addresses.token} "approve(address,uint256)" ${addresses.billing} $AMOUNT --rpc-url ${networkConfig.rpcUrl} --private-key $PRIVATE_KEY
-    cast send ${addresses.billing} "deposit(uint256)" $AMOUNT --rpc-url ${networkConfig.rpcUrl} --private-key $PRIVATE_KEY`
+    cast send ${addresses.token} "approve(address,uint256)" ${addresses.billing} $AMOUNT --rpc-url ${networkConfig.rpcUrl} --private-key ${keyHint}
+    cast send ${addresses.billing} "deposit(uint256)" $AMOUNT --rpc-url ${networkConfig.rpcUrl} --private-key ${keyHint}`
       )
     );
   }
@@ -139763,7 +139805,10 @@ function myParseInt(value, dummyPrevious) {
   return parsedValue;
 }
 function createUploadCommand() {
-  return new Command("upload").description("Upload processor to Sentio").option("--owner <owner>", "(Optional) Override Project owner").option("--name <name>", "(Optional) Override Project name").option(
+  return new Command("upload").description("Upload processor to Sentio").option(
+    "--owner <owner>",
+    "(Optional) Project owner. Platform mode: project owner username. --no-platform mode: on-chain owner address (0x...) \u2014 $PRIVATE_KEY then signs as an operator on the owner's behalf, requires Permissions.addOperator beforehand."
+  ).option("--name <name>", "(Optional) Override Project name").option(
     "--continue-from <version>",
     "(Optional) Continue processing data from the specific processor version which will keeping the old data from previous version and will STOP that version IMMEDIATELY.",
     myParseInt
@@ -139799,13 +139844,41 @@ async function runNoPlatformUpload(processorConfig, options) {
   const privateKey = requirePrivateKey();
   const wallet = getWalletFromPrivateKey(privateKey);
   const walletAddress = wallet.address;
+  let ownerOverride;
+  if (options.owner) {
+    if (!ethers_exports.isAddress(options.owner)) {
+      console.error(source_default.red(`Invalid --owner: "${options.owner}" is not a valid 0x-prefixed Ethereum address.`));
+      process.exit(1);
+    }
+    ownerOverride = ethers_exports.getAddress(options.owner);
+  }
+  const effectiveOwner = ownerOverride ?? walletAddress;
   console.log(source_default.blue("Resolving contract addresses from AddressBook..."));
   const addresses = await resolveNetworkAddresses(networkConfig);
+  if (ownerOverride) {
+    const isOp = await isOperatorOnChain(networkConfig, addresses, ownerOverride, walletAddress);
+    if (!isOp) {
+      console.error(
+        source_default.red(
+          `Operator ${walletAddress} is not authorized for owner ${ownerOverride}.
+The owner must call Permissions.addOperator(${walletAddress}) first.`
+        )
+      );
+      process.exit(1);
+    }
+  }
   const [stBalance, billingBalance] = await Promise.all([
-    checkSTBalance(networkConfig, addresses, walletAddress),
-    checkBillingBalance(networkConfig, addresses, walletAddress)
+    checkSTBalance(networkConfig, addresses, effectiveOwner),
+    checkBillingBalance(networkConfig, addresses, effectiveOwner)
   ]);
-  const confirmed = await confirmNoPlatformUpload(walletAddress, stBalance, billingBalance, addresses, networkConfig);
+  const confirmed = await confirmNoPlatformUpload(
+    walletAddress,
+    stBalance,
+    billingBalance,
+    addresses,
+    networkConfig,
+    ownerOverride
+  );
   if (!confirmed) {
     console.log("Upload cancelled.");
     process.exit(0);
@@ -139855,9 +139928,10 @@ async function runNoPlatformUpload(processorConfig, options) {
   const existingProcessor = await getProcessorOnChain(networkConfig, addresses, processorId);
   if (existingProcessor) {
     const existingOwner = existingProcessor.owner.toLowerCase();
-    const currentWallet = wallet.address.toLowerCase();
-    if (existingOwner === currentWallet) {
-      console.log(source_default.yellow(`Processor "${processorId}" already exists (owned by you).`));
+    const expectedOwner = effectiveOwner.toLowerCase();
+    if (existingOwner === expectedOwner) {
+      const ownedBy = ownerOverride ? `owned by ${ownerOverride}` : "owned by you";
+      console.log(source_default.yellow(`Processor "${processorId}" already exists (${ownedBy}).`));
       const shouldReplace = await confirm(`Replace existing processor "${processorId}"?`);
       if (!shouldReplace) {
         console.log("Upload cancelled.");
@@ -139866,9 +139940,10 @@ async function runNoPlatformUpload(processorConfig, options) {
       await stopProcessorOnChain(networkConfig, addresses, wallet, processorId);
       await deleteProcessorOnChain(networkConfig, addresses, wallet, processorId);
     } else {
+      const expectedLabel = ownerOverride ? `expected owner ${ownerOverride}` : `your wallet ${wallet.address}`;
       console.log(
         source_default.yellow(
-          `Processor "${processorId}" already exists and is owned by ${existingProcessor.owner} (not your wallet ${wallet.address}).`
+          `Processor "${processorId}" already exists and is owned by ${existingProcessor.owner} (not ${expectedLabel}).`
         )
       );
       const randomSuffix = Math.random().toString(36).substring(2, 8);
@@ -139884,7 +139959,16 @@ async function runNoPlatformUpload(processorConfig, options) {
       console.log(source_default.blue(`Using processor ID: ${processorId}`));
     }
   }
-  await createProcessorOnChain(networkConfig, addresses, wallet, processorId, cid, requiredChainIds, sdkVersion);
+  await createProcessorOnChain(
+    networkConfig,
+    addresses,
+    wallet,
+    processorId,
+    cid,
+    requiredChainIds,
+    sdkVersion,
+    ownerOverride
+  );
   await startProcessorOnChain(networkConfig, addresses, wallet, processorId);
   console.log();
   console.log(source_default.green("=== Upload Complete ==="));

package/package.json

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

package/src/commands/upload.ts

@@ -20,6 +20,7 @@ import {
   requirePrivateKey,
   checkSTBalance,
   checkBillingBalance,
+  isOperatorOnChain,
   uploadToIPFS,
   createProcessorOnChain,
   startProcessorOnChain,
@@ -28,6 +29,7 @@ import {
   getProcessorOnChain,
   deleteProcessorOnChain
 } from '../network.js'
+import { ethers } from 'ethers'
 import { Auth, DefaultBatchUploader, FileType, IPFSBatchUploader, WalrusBatchUploader } from '../uploader.js'
 export { type Auth } from '../uploader.js'
 
@@ -43,7 +45,10 @@ function myParseInt(value: string, dummyPrevious: number): number {
 export function createUploadCommand() {
   return new Command('upload')
     .description('Upload processor to Sentio')
-    .option('--owner <owner>', '(Optional) Override Project owner')
+    .option(
+      '--owner <owner>',
+      "(Optional) Project owner. Platform mode: project owner username. --no-platform mode: on-chain owner address (0x...) — $PRIVATE_KEY then signs as an operator on the owner's behalf, requires Permissions.addOperator beforehand."
+    )
     .option('--name <name>', '(Optional) Override Project name')
     .option(
       '--continue-from <version>',
@@ -102,21 +107,53 @@ async function runNoPlatformUpload(
   const network = options.sentioNetwork || 'testnet'
   const networkConfig = getSentioNetworkConfig(network)
 
-  // Step 1: Require PRIVATE_KEY
+  // Step 1: Require PRIVATE_KEY (operator key when --owner is set, otherwise the owner's own key)
   const privateKey = requirePrivateKey()
   const wallet = getWalletFromPrivateKey(privateKey)
   const walletAddress = wallet.address
 
+  // Operator mode: --owner is the on-chain owner address; PRIVATE_KEY signs as operator on its behalf.
+  let ownerOverride: string | undefined
+  if (options.owner) {
+    if (!ethers.isAddress(options.owner)) {
+      console.error(chalk.red(`Invalid --owner: "${options.owner}" is not a valid 0x-prefixed Ethereum address.`))
+      process.exit(1)
+    }
+    ownerOverride = ethers.getAddress(options.owner)
+  }
+  const effectiveOwner = ownerOverride ?? walletAddress
+
   // Step 2: Resolve contract addresses via AddressBook
   console.log(chalk.blue('Resolving contract addresses from AddressBook...'))
   const addresses = await resolveNetworkAddresses(networkConfig)
 
-  // Step 3: Check ST balance and Billing balance, then confirm
+  // Step 2.5: Pre-flight check that operator is registered for this owner.
+  if (ownerOverride) {
+    const isOp = await isOperatorOnChain(networkConfig, addresses, ownerOverride, walletAddress)
+    if (!isOp) {
+      console.error(
+        chalk.red(
+          `Operator ${walletAddress} is not authorized for owner ${ownerOverride}.\n` +
+            `The owner must call Permissions.addOperator(${walletAddress}) first.`
+        )
+      )
+      process.exit(1)
+    }
+  }
+
+  // Step 3: Check ST balance and Billing balance (always against the owner — operator just submits txs)
   const [stBalance, billingBalance] = await Promise.all([
-    checkSTBalance(networkConfig, addresses, walletAddress),
-    checkBillingBalance(networkConfig, addresses, walletAddress)
+    checkSTBalance(networkConfig, addresses, effectiveOwner),
+    checkBillingBalance(networkConfig, addresses, effectiveOwner)
   ])
-  const confirmed = await confirmNoPlatformUpload(walletAddress, stBalance, billingBalance, addresses, networkConfig)
+  const confirmed = await confirmNoPlatformUpload(
+    walletAddress,
+    stBalance,
+    billingBalance,
+    addresses,
+    networkConfig,
+    ownerOverride
+  )
   if (!confirmed) {
     console.log('Upload cancelled.')
     process.exit(0)
@@ -179,11 +216,13 @@ async function runNoPlatformUpload(
 
   if (existingProcessor) {
     const existingOwner = existingProcessor.owner.toLowerCase()
-    const currentWallet = wallet.address.toLowerCase()
+    const expectedOwner = effectiveOwner.toLowerCase()
 
-    if (existingOwner === currentWallet) {
-      // Same owner — prompt to replace
-      console.log(chalk.yellow(`Processor "${processorId}" already exists (owned by you).`))
+    if (existingOwner === expectedOwner) {
+      // Same owner — prompt to replace. In operator mode the operator is allowed to
+      // stop+delete via the contract's isProcessorAdmin check.
+      const ownedBy = ownerOverride ? `owned by ${ownerOverride}` : 'owned by you'
+      console.log(chalk.yellow(`Processor "${processorId}" already exists (${ownedBy}).`))
       const shouldReplace = await confirm(`Replace existing processor "${processorId}"?`)
       if (!shouldReplace) {
         console.log('Upload cancelled.')
@@ -194,9 +233,10 @@ async function runNoPlatformUpload(
       await deleteProcessorOnChain(networkConfig, addresses, wallet, processorId)
     } else {
       // Different owner — prompt to rename
+      const expectedLabel = ownerOverride ? `expected owner ${ownerOverride}` : `your wallet ${wallet.address}`
       console.log(
         chalk.yellow(
-          `Processor "${processorId}" already exists and is owned by ${existingProcessor.owner} (not your wallet ${wallet.address}).`
+          `Processor "${processorId}" already exists and is owned by ${existingProcessor.owner} (not ${expectedLabel}).`
         )
       )
       const randomSuffix = Math.random().toString(36).substring(2, 8)
@@ -215,7 +255,16 @@ async function runNoPlatformUpload(
   }
 
   // Step 8: Create processor on-chain
-  await createProcessorOnChain(networkConfig, addresses, wallet, processorId, cid, requiredChainIds, sdkVersion)
+  await createProcessorOnChain(
+    networkConfig,
+    addresses,
+    wallet,
+    processorId,
+    cid,
+    requiredChainIds,
+    sdkVersion,
+    ownerOverride
+  )
 
   // Step 9: Start processor on-chain
   await startProcessorOnChain(networkConfig, addresses, wallet, processorId)

package/src/network.ts

@@ -17,7 +17,7 @@ const TESTNET_CONFIG: SentioNetworkConfig = {
   chainId: 7892101,
   rpcUrl: 'https://sentio-testnet.rpc.sentio.xyz',
   explorerUrl: 'https://testnet-explorer.sentio.xyz',
-  addressBookAddress: '0x11cDDF46f16925aa630Af9D5158028E56309868f'
+  addressBookAddress: '0x94579F0e7873097279B48d7b15043698c522e47c'
 }
 
 export function getSentioNetworkConfig(network: string): SentioNetworkConfig {
@@ -40,7 +40,7 @@ const ADDRESS_BOOK_ABI = [
   'function getAddress(bytes32 id) view returns (address)'
 ]
 
-// ProcessorRegistry: createProcessor, getProcessor, deleteProcessor
+// ProcessorRegistry: createProcessor (self + operator overloads), getProcessor, deleteProcessor
 const PROCESSOR_REGISTRY_ABI = [
   `function createProcessor(
     string id,
@@ -48,6 +48,13 @@ const PROCESSOR_REGISTRY_ABI = [
     tuple(string chainId, bool enableRpc, bool enableTrace)[] requireChains,
     string sdkVersion
   ) returns (string)`,
+  `function createProcessor(
+    address owner,
+    string id,
+    tuple(uint8 sourceType, string ipfsCid) source,
+    tuple(string chainId, bool enableRpc, bool enableTrace)[] requireChains,
+    string sdkVersion
+  ) returns (string)`,
   'event ProcessorCreated(string indexed processorId)',
   `function getProcessor(string processorId) view returns (
     tuple(
@@ -74,6 +81,9 @@ const CONTROLLER_ABI = [
 // Databases:  getProcessorDatabases
 const DATABASES_ABI = ['function getProcessorDatabases(string processorId) view returns (string[])']
 
+// Permissions: isOperator (used to pre-check operator delegation before submitting tx)
+const PERMISSIONS_ABI = ['function isOperator(address account, address operator) view returns (bool)']
+
 // ERC20: balanceOf + approve
 const ERC20_ABI = [
   'function balanceOf(address account) view returns (uint256)',
@@ -91,7 +101,8 @@ const ADDRESS_BOOK_KEYS = {
   controller: 'controller',
   token: 'sentio_token',
   billing: 'billing',
-  databases: 'databases'
+  databases: 'databases',
+  permissions: 'permissions'
 } as const
 
 interface ResolvedAddresses {
@@ -101,6 +112,7 @@ interface ResolvedAddresses {
   token: string
   billing: string
   databases: string
+  permissions: string
 }
 
 let cachedAddresses: ResolvedAddresses | undefined
@@ -130,12 +142,13 @@ export async function resolveNetworkAddresses(config: SentioNetworkConfig): Prom
     }
   }
 
-  const [processorRegistry, controller, token, billing, databases] = await Promise.all([
+  const [processorRegistry, controller, token, billing, databases, permissions] = await Promise.all([
     resolveAddress(ADDRESS_BOOK_KEYS.processorRegistry),
     resolveAddress(ADDRESS_BOOK_KEYS.controller),
     resolveAddress(ADDRESS_BOOK_KEYS.token),
     resolveAddress(ADDRESS_BOOK_KEYS.billing),
-    resolveAddress(ADDRESS_BOOK_KEYS.databases)
+    resolveAddress(ADDRESS_BOOK_KEYS.databases),
+    resolveAddress(ADDRESS_BOOK_KEYS.permissions)
   ])
 
   console.log(chalk.gray(`ProcessorRegistry: ${processorRegistry}`))
@@ -143,8 +156,17 @@ export async function resolveNetworkAddresses(config: SentioNetworkConfig): Prom
   console.log(chalk.gray(`ST Token:          ${token}`))
   console.log(chalk.gray(`Billing:           ${billing}`))
   console.log(chalk.gray(`Databases:         ${databases}`))
-
-  cachedAddresses = { addressBook: addressBookAddr, processorRegistry, controller, token, billing, databases }
+  console.log(chalk.gray(`Permissions:       ${permissions}`))
+
+  cachedAddresses = {
+    addressBook: addressBookAddr,
+    processorRegistry,
+    controller,
+    token,
+    billing,
+    databases,
+    permissions
+  }
   return cachedAddresses
 }
 
@@ -196,6 +218,17 @@ export async function checkBillingBalance(
   }
 }
 
+export async function isOperatorOnChain(
+  config: SentioNetworkConfig,
+  addresses: ResolvedAddresses,
+  owner: string,
+  operator: string
+): Promise<boolean> {
+  const provider = new ethers.JsonRpcProvider(config.rpcUrl)
+  const permissions = new ethers.Contract(addresses.permissions, PERMISSIONS_ABI, provider)
+  return await permissions.isOperator(owner, operator)
+}
+
 // --- IPFS Upload ---
 
 export async function uploadToIPFS(fileBuffer: Buffer, ipfsUrl: string): Promise<string> {
@@ -349,7 +382,8 @@ export async function createProcessorOnChain(
   processorId: string,
   ipfsCid: string,
   requiredChainIds: string[],
-  sdkVersion: string
+  sdkVersion: string,
+  ownerOverride?: string
 ): Promise<string> {
   const provider = new ethers.JsonRpcProvider(config.rpcUrl)
   const signer = wallet.connect(provider)
@@ -372,12 +406,26 @@ export async function createProcessorOnChain(
   console.log(chalk.gray(`  IPFS CID:     ${ipfsCid}`))
   console.log(chalk.gray(`  Chains:        ${requiredChainIds.join(', ')}`))
   console.log(chalk.gray(`  SDK Version:   ${sdkVersion}`))
+  if (ownerOverride) {
+    console.log(chalk.gray(`  Owner:         ${ownerOverride} (operator: ${wallet.address})`))
+  }
 
-  const tx = await submitAndWait(
-    config.explorerUrl,
-    'createProcessor',
-    registry.createProcessor(processorId, source, requireChains, sdkVersion)
-  )
+  // ethers v6 disambiguates overloads by full signature when both are present.
+  const txPromise: Promise<ethers.TransactionResponse> = ownerOverride
+    ? registry['createProcessor(address,string,(uint8,string),(string,bool,bool)[],string)'](
+        ownerOverride,
+        processorId,
+        source,
+        requireChains,
+        sdkVersion
+      )
+    : registry['createProcessor(string,(uint8,string),(string,bool,bool)[],string)'](
+        processorId,
+        source,
+        requireChains,
+        sdkVersion
+      )
+  const tx = await submitAndWait(config.explorerUrl, 'createProcessor', txPromise)
   console.log(chalk.green(`Processor created. Tx: ${config.explorerUrl}/tx/${tx.hash}`))
   return tx.hash
 }
@@ -430,26 +478,34 @@ export async function confirmNoPlatformUpload(
   stBalance: bigint,
   billingBalance: bigint,
   addresses: ResolvedAddresses,
-  networkConfig: SentioNetworkConfig
+  networkConfig: SentioNetworkConfig,
+  ownerOverride?: string
 ): Promise<boolean> {
   const formattedST = ethers.formatEther(stBalance)
   const formattedBilling = ethers.formatEther(billingBalance)
   console.log()
   console.log(chalk.blue('=== Sentio Network Direct Upload (No Platform) ==='))
-  console.log(chalk.white(`  Address:         ${walletAddress}`))
+  if (ownerOverride) {
+    console.log(chalk.white(`  Owner:           ${ownerOverride}`))
+    console.log(chalk.white(`  Operator:        ${walletAddress}`))
+  } else {
+    console.log(chalk.white(`  Address:         ${walletAddress}`))
+  }
   console.log(chalk.white(`  ST Balance:      ${formattedST} ST`))
   console.log(chalk.white(`  Billing Balance: ${formattedBilling} ST`))
 
   if (billingBalance === 0n) {
+    const who = ownerOverride ? `the owner (${ownerOverride})` : 'you'
+    const keyHint = ownerOverride ? "<owner's private key>" : '$PRIVATE_KEY'
     console.log()
     console.log(
       chalk.yellow(
-        '  ⚠ Your Billing balance is 0. Indexing fees are charged from the Billing contract.\n' +
-          '    You must deposit ST tokens into the Billing contract before your processor can run.\n' +
-          '    Example (replace 100 with your desired ST amount):\n' +
+        `  ⚠ ${ownerOverride ? "Owner's" : 'Your'} Billing balance is 0. Indexing fees are charged from the Billing contract.\n` +
+          `    ${who} must deposit ST tokens into the Billing contract before the processor can run.\n` +
+          `    Example (replace 100 with your desired ST amount):\n` +
           `    export AMOUNT=$(cast to-wei 100 ether)\n` +
-          `    cast send ${addresses.token} "approve(address,uint256)" ${addresses.billing} $AMOUNT --rpc-url ${networkConfig.rpcUrl} --private-key $PRIVATE_KEY\n` +
-          `    cast send ${addresses.billing} "deposit(uint256)" $AMOUNT --rpc-url ${networkConfig.rpcUrl} --private-key $PRIVATE_KEY`
+          `    cast send ${addresses.token} "approve(address,uint256)" ${addresses.billing} $AMOUNT --rpc-url ${networkConfig.rpcUrl} --private-key ${keyHint}\n` +
+          `    cast send ${addresses.billing} "deposit(uint256)" $AMOUNT --rpc-url ${networkConfig.rpcUrl} --private-key ${keyHint}`
       )
     )
   }