@beclab/olaresid 0.1.13 → 0.2.0

package/src/cli.ts

@@ -39,6 +39,7 @@ const CLI_VERSION = packageJson.version;
 
 interface CliOptions {
 	network: string;
+	from?: string;
 	rpc?: string;
 	contractDid?: string;
 	contractResolver?: string;
@@ -85,7 +86,8 @@ function parseArgs(): {
 		'is-owner',
 		'transfer',
 		'fetch',
-		'fetch-domain'
+		'fetch-domain',
+		'fetch-all'
 	];
 
 	for (let i = 0; i < args.length; i++) {
@@ -98,6 +100,8 @@ function parseArgs(): {
 			process.exit(0);
 		} else if (arg === '--network' || arg === '-n') {
 			options.network = args[++i] || 'mainnet';
+		} else if (arg === '--from') {
+			options.from = args[++i];
 		} else if (arg === '--rpc') {
 			options.rpc = args[++i];
 		} else if (arg === '--contract-did') {
@@ -144,6 +148,26 @@ function parseArgs(): {
 	return { command, subCommand, domain, value, options };
 }
 
+function normalizeTagFromDomain(
+	from: string | undefined,
+	toDomain: string
+): string {
+	if (!from) {
+		return toDomain;
+	}
+
+	const normalized = from.trim().toLowerCase();
+	if (
+		normalized === 'root' ||
+		normalized === ':root' ||
+		normalized === '""'
+	) {
+		return '';
+	}
+
+	return normalizeToDomain(from);
+}
+
 function showHelp(): void {
 	console.log(`
 DID CLI Tool v${CLI_VERSION}
@@ -197,15 +221,18 @@ COMMANDS:
                                Define a new tag type (requires PRIVATE_KEY_OR_MNEMONIC)
                                Supported types: string, uint8, uint256, int8, int256, bool, address, bytes, bytes32
                                Array types: string[], uint8[], etc.
-    tag set <domain> <tag-name> <value>
+	tag set <domain> <tag-name> <value> [--from <domain|root>]
                                Set tag value (requires PRIVATE_KEY_OR_MNEMONIC)
-                               Value can be a string or JSON for arrays/objects
-    tag get <domain> <tag-name>
+							   Value can be a string or JSON for arrays/objects
+							   --from specifies where tag type is defined (default: same as <domain>)
+	tag get <domain> <tag-name> [--from <domain|root>]
                                Get tag value (read-only)
-    tag remove <domain> <tag-name>
+	tag remove <domain> <tag-name> [--from <domain|root>]
                                Remove tag value (requires PRIVATE_KEY_OR_MNEMONIC)
-    tag list <domain>          List all tags with values for domain (read-only)
-    tag list-defined <domain>  List all defined tag types for domain (read-only)
+	tag list <domain> [--from <domain|root>]
+                               List all tags with values for domain (read-only)
+    tag list-defined [domain]  List all tag types defined by the domain (read-only)
+                               Omit domain to query tag types defined by root
     tag set-tagger <domain> <tag-name> <address>
                                Set tagger address for a tag (requires PRIVATE_KEY_OR_MNEMONIC)
     tag get-tagger <domain> <tag-name>
@@ -228,7 +255,8 @@ COMMANDS:
     config set <key> <value> [--network <network>]
                                Set configuration value (default network: mainnet)
                                Keys: rpc, contractDid, contractRootResolver,
-                                     contractAbiType, contractRootResolver2, supportSvcUrl
+                                     contractAbiType, contractRootResolver2,
+                                     supportSvcUrl, queryContract
     
   Crypto Utility Commands:
     crypto generate            Generate a new mnemonic phrase (--words option)
@@ -248,12 +276,13 @@ COMMANDS:
     
   Legacy Commands:
     fetch <domain>             Fetch domain information (alias: fetch-domain)
-    fetch-all                  Fetch all domains from contract
-    config                     Show network configurations
+    fetch-all                  Fetch all domains from contract and save to JSON file
+                               Use --output to specify file path (default: domains-<network>-<date>.json)
     help                       Show this help message
 
 OPTIONS:
   -n, --network <network>         Network to use (sepolia|mainnet) [default: mainnet]
+	--from <domain|root>            Tag source domain for tag set/get/remove/list (default: target domain)
   --rpc <url>                     Custom RPC endpoint URL
   --contract-did <address>        Custom DID contract address
   --contract-resolver <address>   Custom RootResolver contract address
@@ -299,7 +328,6 @@ EXAMPLES:
   # Subdomain management (auto-generate mnemonic for subdomain owner)
   export PRIVATE_KEY_OR_MNEMONIC=0xYOUR_PRIVATE_KEY
   did-cli subdomain register parent.com child
-  did-cli subdomain register parent.com child --words 24
   
   # Subdomain management (use existing mnemonic for subdomain owner)
   export SUBDOMAIN_OWNER_MNEMONIC="your twelve word mnemonic here"
@@ -311,7 +339,6 @@ EXAMPLES:
   # Transfer domain ownership (auto-generate mnemonic for new owner)
   export PRIVATE_KEY_OR_MNEMONIC=0xYOUR_PRIVATE_KEY
   did-cli transfer example.com
-  did-cli transfer example.com --words 24
   
   # Transfer domain ownership (use existing mnemonic for new owner)
   export TO_MNEMONIC="your twelve word mnemonic here"
@@ -319,7 +346,7 @@ EXAMPLES:
   
   # Crypto utilities
   did-cli crypto generate --words 12
-  did-cli crypto generate --words 24 --output ./custom-path.txt
+  did-cli crypto generate --output ./custom-path.txt
   export PRIVATE_KEY_OR_MNEMONIC="your twelve word mnemonic here"
   did-cli crypto address
   did-cli crypto did
@@ -390,8 +417,15 @@ EXAMPLES:
   did-cli config list                              # List all networks
   did-cli config set rpc https://optimism.llamarpc.com  # Set mainnet RPC
   did-cli config set contractDid 0x1234... --network sepolia  # Set sepolia contract
+  did-cli config set queryContract 0x637197... --network sepolia  # Set query contract
   did-cli config set rpc https://my-rpc.com --network custom_net  # Create new network
   
+  # Fetch all domains
+  did-cli fetch-all                                # Fetch all mainnet domains (auto-named file)
+  did-cli fetch-all --network sepolia              # Fetch all sepolia domains
+  did-cli fetch-all --output ./my-domains.json     # Custom output file path
+  did-cli fetch-all --network sepolia --verbose    # With progress details
+  
   # Utilities
   did-cli convert pem-to-der ./public-key.pem
   did-cli convert ip-to-bytes 192.168.1.1
@@ -421,39 +455,13 @@ async function fetchDomain(domain: string, options: CliOptions): Promise<void> {
 			debug.setLevel(options.debugLevel as any);
 		}
 
-		// Get network configuration
-		const config = getNetworkConfig(options.network);
-		if (!config) {
-			console.error(`❌ Unknown network: ${options.network}`);
-			console.error(
-				'Available networks:',
-				getAvailableNetworks().join(', ')
-			);
-			process.exit(1);
-		}
-
-		// Command line parameters take priority
-		const finalConfig = {
-			rpc: options.rpc || config.rpc,
-			contractDid: options.contractDid || config.contractDid,
-			contractRootResolver:
-				options.contractResolver || config.contractRootResolver,
-			contractAbiType: options.contractAbi || config.contractAbiType
-		};
-
 		if (debug.isEnabled()) {
 			debug.info(`🔍 Fetching domain: ${domain}`);
 			debug.info(`🌐 Network: ${options.network}`);
-			debug.info('Using configuration:', finalConfig);
 		}
 
-		// Create DID console instance
-		const olaresId = OlaresID.createConsole(
-			finalConfig.rpc,
-			finalConfig.contractDid,
-			finalConfig.contractRootResolver,
-			finalConfig.contractAbiType
-		);
+		// Use getConsole helper to create console instance
+		const olaresId = getConsole(options);
 
 		// Fetch domain data
 		const domainData = await olaresId.fetchDomain(domain);
@@ -476,6 +484,93 @@ async function fetchDomain(domain: string, options: CliOptions): Promise<void> {
 	}
 }
 
+async function fetchAll(options: CliOptions): Promise<void> {
+	try {
+		// Set debug options
+		if (options.verbose || options.debug) {
+			debug.enable();
+			debug.setLevel(options.debugLevel as any);
+		}
+
+		if (debug.isEnabled()) {
+			debug.info('🔍 Fetching all domains');
+			debug.info(`🌐 Network: ${options.network}`);
+		}
+
+		// Use getConsole helper to create console instance
+		const olaresId = getConsole(options);
+
+		// Check if query contract is configured
+		if (!olaresId.queryContractAddress) {
+			console.error(
+				'❌ Query contract address not configured for this network'
+			);
+			console.error(
+				`   Use: did-cli config set queryContract <address> --network ${options.network}`
+			);
+			process.exit(1);
+		}
+
+		console.log('📡 Fetching all domains from contract...');
+		console.log(`   Network: ${options.network}`);
+		console.log(`   Query Contract: ${olaresId.queryContractAddress}`);
+		console.log();
+
+		let totalDomains = 0;
+		const startTime = Date.now();
+
+		// Fetch all domains with progress
+		const domains = await olaresId.fetchAllFlat({
+			batchSize: 100,
+			onProgress: (current, total) => {
+				totalDomains = total;
+				const percent = ((current / total) * 100).toFixed(1);
+				process.stdout.write(
+					`\r⏳ Progress: ${current}/${total} (${percent}%)`
+				);
+			}
+		});
+
+		const elapsed = ((Date.now() - startTime) / 1000).toFixed(2);
+		process.stdout.write('\r' + ' '.repeat(50) + '\r'); // Clear progress line
+		console.log(`✅ Fetched ${totalDomains} domains in ${elapsed}s`);
+		console.log();
+
+		// Determine output file path
+		const timestamp = new Date()
+			.toISOString()
+			.replace(/[:.]/g, '-')
+			.split('T')[0];
+		const defaultFilename = `domains-${options.network}-${timestamp}.json`;
+		const outputPath =
+			options.output || path.join(process.cwd(), defaultFilename);
+
+		// Save to file
+		const jsonContent = JSON.stringify(domains, null, 2);
+		fs.writeFileSync(outputPath, jsonContent, 'utf-8');
+
+		console.log(`💾 Saved to: ${outputPath}`);
+		console.log(
+			`   File size: ${(jsonContent.length / 1024).toFixed(2)} KB`
+		);
+		console.log(`   Total domains: ${domains.length}`);
+
+		if (debug.isEnabled()) {
+			debug.info('Fetch all completed successfully');
+			debug.info(`Output file: ${outputPath}`);
+		}
+	} catch (error) {
+		console.error(
+			'❌ Error fetching all domains:',
+			error instanceof Error ? error.message : String(error)
+		);
+		if (debug.isEnabled()) {
+			debug.error('Full error details:', error);
+		}
+		process.exit(1);
+	}
+}
+
 // ============================================================================
 // Helper Functions
 // ============================================================================
@@ -502,7 +597,8 @@ function getConsole(options: CliOptions) {
 		contractRootResolver2:
 			options.contractRootResolver2 ||
 			networkConfig.contractRootResolver2,
-		supportSvcUrl: options.supportSvcUrl || networkConfig.supportSvcUrl
+		supportSvcUrl: options.supportSvcUrl || networkConfig.supportSvcUrl,
+		queryContract: networkConfig.queryContract
 	};
 
 	return OlaresID.createConsole(
@@ -511,7 +607,8 @@ function getConsole(options: CliOptions) {
 		config.contractRootResolver,
 		config.contractAbiType,
 		config.contractRootResolver2,
-		config.supportSvcUrl
+		config.supportSvcUrl,
+		config.queryContract
 	);
 }
 
@@ -1996,6 +2093,11 @@ async function configShow(options: CliOptions): Promise<void> {
 			console.log(
 				`  Support Service URL:    ${networkConfig.supportSvcUrl}`
 			);
+			console.log(
+				`  Query Contract:         ${
+					networkConfig.queryContract || '(not set)'
+				}`
+			);
 			console.log(`\n📄 Configuration file: ${getConfigFilePath()}`);
 		}
 	} catch (error) {
@@ -2064,7 +2166,8 @@ async function configSet(
 			'contractRootResolver',
 			'contractAbiType',
 			'contractRootResolver2',
-			'supportSvcUrl'
+			'supportSvcUrl',
+			'queryContract'
 		];
 		if (!validKeys.includes(key)) {
 			console.error(`❌ Invalid config key: ${key}`);
@@ -2218,7 +2321,8 @@ async function tagDefine(
  * Set tag value
  */
 async function tagSet(
-	domain: string,
+	toDomain: string,
+	fromDomain: string,
 	tagName: string,
 	valueStr: string,
 	options: CliOptions
@@ -2228,10 +2332,13 @@ async function tagSet(
 		const privateKeyOrMnemonic = getPrivateKeyOrMnemonic();
 		await didConsole.setSigner(privateKeyOrMnemonic);
 
-		const domainContext = didConsole.domain(domain);
+		const domainContext = didConsole.domain(fromDomain);
 		const tagCtx = domainContext.tag();
 
-		console.log(`\n📝 Setting tag "${tagName}" for domain: ${domain}`);
+		const fromLabel = fromDomain === '' ? '(root)' : fromDomain;
+		console.log(`\n📝 Setting tag "${tagName}"`);
+		console.log(`   From: ${fromLabel}`);
+		console.log(`   To:   ${toDomain}`);
 		console.log(`   Value: ${valueStr}`);
 
 		// Try to parse value as JSON, otherwise use as string
@@ -2242,7 +2349,7 @@ async function tagSet(
 			value = valueStr;
 		}
 
-		const result = await tagCtx.setTag(domain, tagName, value);
+		const result = await tagCtx.setTag(toDomain, tagName, value);
 
 		if (result.success) {
 			if (options.json) {
@@ -2250,7 +2357,8 @@ async function tagSet(
 					JSON.stringify(
 						{
 							success: true,
-							domain,
+							from: fromDomain,
+							to: toDomain,
 							tagName,
 							value,
 							transactionHash: result.transactionHash,
@@ -2286,18 +2394,22 @@ async function tagSet(
  * Get tag value
  */
 async function tagGet(
-	domain: string,
+	toDomain: string,
+	fromDomain: string,
 	tagName: string,
 	options: CliOptions
 ): Promise<void> {
 	try {
 		const didConsole = getConsole(options);
-		const domainContext = didConsole.domain(domain);
+		const domainContext = didConsole.domain(fromDomain);
 		const tagCtx = domainContext.tag();
+		const fromLabel = fromDomain === '' ? '(root)' : fromDomain;
 
-		console.log(`\n📖 Getting tag "${tagName}" for domain: ${domain}`);
+		console.log(`\n📖 Getting tag "${tagName}"`);
+		console.log(`   From: ${fromLabel}`);
+		console.log(`   To:   ${toDomain}`);
 
-		const value = await tagCtx.getTag(domain, tagName);
+		const value = await tagCtx.getTag(toDomain, tagName);
 
 		if (value !== null && value !== undefined) {
 			if (options.json) {
@@ -2305,7 +2417,8 @@ async function tagGet(
 					JSON.stringify(
 						{
 							success: true,
-							domain,
+							from: fromDomain,
+							to: toDomain,
 							tagName,
 							value
 						},
@@ -2333,7 +2446,8 @@ async function tagGet(
 				console.log(
 					JSON.stringify({
 						success: true,
-						domain,
+						from: fromDomain,
+						to: toDomain,
 						tagName,
 						value: null
 					})
@@ -2357,7 +2471,8 @@ async function tagGet(
  * Remove tag value
  */
 async function tagRemove(
-	domain: string,
+	toDomain: string,
+	fromDomain: string,
 	tagName: string,
 	options: CliOptions
 ): Promise<void> {
@@ -2366,12 +2481,15 @@ async function tagRemove(
 		const privateKeyOrMnemonic = getPrivateKeyOrMnemonic();
 		await didConsole.setSigner(privateKeyOrMnemonic);
 
-		const domainContext = didConsole.domain(domain);
+		const domainContext = didConsole.domain(fromDomain);
 		const tagCtx = domainContext.tag();
+		const fromLabel = fromDomain === '' ? '(root)' : fromDomain;
 
-		console.log(`\n🗑️  Removing tag "${tagName}" for domain: ${domain}`);
+		console.log(`\n🗑️  Removing tag "${tagName}"`);
+		console.log(`   From: ${fromLabel}`);
+		console.log(`   To:   ${toDomain}`);
 
-		const result = await tagCtx.removeTag(domain, tagName);
+		const result = await tagCtx.removeTag(toDomain, tagName);
 
 		if (result.success) {
 			if (options.json) {
@@ -2379,7 +2497,8 @@ async function tagRemove(
 					JSON.stringify(
 						{
 							success: true,
-							domain,
+							from: fromDomain,
+							to: toDomain,
 							tagName,
 							transactionHash: result.transactionHash,
 							gasUsed: result.gasUsed?.toString(),
@@ -2413,21 +2532,30 @@ async function tagRemove(
 /**
  * List all tags for a domain
  */
-async function tagList(domain: string, options: CliOptions): Promise<void> {
+async function tagList(
+	toDomain: string,
+	fromDomain: string,
+	options: CliOptions
+): Promise<void> {
 	try {
 		const didConsole = getConsole(options);
-		const domainContext = didConsole.domain(domain);
+		const domainContext = didConsole.domain(fromDomain);
+		const tagCtx = domainContext.tag();
+		const fromLabel = fromDomain === '' ? '(root)' : fromDomain;
 
-		console.log(`\n📋 Listing all tags for domain: ${domain}`);
+		console.log(`\n📋 Listing all tags`);
+		console.log(`   From: ${fromLabel}`);
+		console.log(`   To:   ${toDomain}`);
 
-		const tags = await domainContext.getAllTags();
+		const tags = await tagCtx.getAllTags(toDomain);
 
 		if (options.json) {
 			console.log(
 				JSON.stringify(
 					{
 						success: true,
-						domain,
+						from: fromDomain,
+						to: toDomain,
 						count: tags.length,
 						tags
 					},
@@ -2470,7 +2598,8 @@ async function tagListDefined(
 		const didConsole = getConsole(options);
 		const domainContext = didConsole.domain(domain);
 
-		console.log(`\n📋 Listing defined tag types for domain: ${domain}`);
+		const domainLabel = domain === '' ? '(root)' : domain;
+		console.log(`\n📋 Listing tag types defined by: ${domainLabel}`);
 
 		const tags = await domainContext.getDefinedTags();
 
@@ -2908,11 +3037,14 @@ async function main(): Promise<void> {
 								'❌ Error: Usage: did-cli config set <key> <value> [--network <network>]'
 							);
 							console.error(
-								'   Valid keys: rpc, contractDid, contractRootResolver, contractAbiType, contractRootResolver2, supportSvcUrl'
+								'   Valid keys: rpc, contractDid, contractRootResolver, contractAbiType, contractRootResolver2, supportSvcUrl, queryContract'
 							);
 							console.error(
 								'\n   Example: did-cli config set rpc https://optimism.llamarpc.com --network mainnet'
 							);
+							console.error(
+								'   Example: did-cli config set queryContract 0xAf0430AB9f2450c52E7401846C7CA702D53eCFC2 --network sepolia'
+							);
 							process.exit(1);
 						}
 						break;
@@ -3122,7 +3254,7 @@ async function main(): Promise<void> {
 								'❌ Error: tag set requires <domain>, <tag-name> and <value>'
 							);
 							console.error(
-								'Usage: did-cli tag set <domain> <tag-name> <value>'
+								'Usage: did-cli tag set <domain> <tag-name> <value> [--from <domain|root>]'
 							);
 							console.error(
 								'   Value can be a string or JSON (e.g., \'["item1","item2"]\' for arrays)'
@@ -3136,11 +3268,18 @@ async function main(): Promise<void> {
 							const args = process.argv.slice(2);
 							const setIdx = args.indexOf('set');
 							if (setIdx >= 0 && args.length > setIdx + 3) {
-								const actualDomain = args[setIdx + 1];
+								const actualDomain = normalizeToDomain(
+									args[setIdx + 1]
+								);
+								const fromDomain = normalizeTagFromDomain(
+									options.from,
+									actualDomain
+								);
 								const tagName = args[setIdx + 2];
 								const valueStr = args[setIdx + 3];
 								await tagSet(
 									actualDomain,
+									fromDomain,
 									tagName,
 									valueStr,
 									options
@@ -3150,7 +3289,7 @@ async function main(): Promise<void> {
 									'❌ Error: Missing arguments for tag set'
 								);
 								console.error(
-									'Usage: did-cli tag set <domain> <tag-name> <value>'
+									'Usage: did-cli tag set <domain> <tag-name> <value> [--from <domain|root>]'
 								);
 								process.exit(1);
 							}
@@ -3163,7 +3302,7 @@ async function main(): Promise<void> {
 								'❌ Error: tag get requires <domain> and <tag-name>'
 							);
 							console.error(
-								'Usage: did-cli tag get <domain> <tag-name>'
+								'Usage: did-cli tag get <domain> <tag-name> [--from <domain|root>]'
 							);
 							process.exit(1);
 						}
@@ -3171,15 +3310,26 @@ async function main(): Promise<void> {
 							const args = process.argv.slice(2);
 							const getIdx = args.indexOf('get');
 							if (getIdx >= 0 && args.length > getIdx + 2) {
-								const actualDomain = args[getIdx + 1];
+								const actualDomain = normalizeToDomain(
+									args[getIdx + 1]
+								);
+								const fromDomain = normalizeTagFromDomain(
+									options.from,
+									actualDomain
+								);
 								const tagName = args[getIdx + 2];
-								await tagGet(actualDomain, tagName, options);
+								await tagGet(
+									actualDomain,
+									fromDomain,
+									tagName,
+									options
+								);
 							} else {
 								console.error(
 									'❌ Error: Missing arguments for tag get'
 								);
 								console.error(
-									'Usage: did-cli tag get <domain> <tag-name>'
+									'Usage: did-cli tag get <domain> <tag-name> [--from <domain|root>]'
 								);
 								process.exit(1);
 							}
@@ -3192,7 +3342,7 @@ async function main(): Promise<void> {
 								'❌ Error: tag remove requires <domain> and <tag-name>'
 							);
 							console.error(
-								'Usage: did-cli tag remove <domain> <tag-name>'
+								'Usage: did-cli tag remove <domain> <tag-name> [--from <domain|root>]'
 							);
 							console.error(
 								'\nNote: Set PRIVATE_KEY_OR_MNEMONIC environment variable first'
@@ -3203,15 +3353,26 @@ async function main(): Promise<void> {
 							const args = process.argv.slice(2);
 							const removeIdx = args.indexOf('remove');
 							if (removeIdx >= 0 && args.length > removeIdx + 2) {
-								const actualDomain = args[removeIdx + 1];
+								const actualDomain = normalizeToDomain(
+									args[removeIdx + 1]
+								);
+								const fromDomain = normalizeTagFromDomain(
+									options.from,
+									actualDomain
+								);
 								const tagName = args[removeIdx + 2];
-								await tagRemove(actualDomain, tagName, options);
+								await tagRemove(
+									actualDomain,
+									fromDomain,
+									tagName,
+									options
+								);
 							} else {
 								console.error(
 									'❌ Error: Missing arguments for tag remove'
 								);
 								console.error(
-									'Usage: did-cli tag remove <domain> <tag-name>'
+									'Usage: did-cli tag remove <domain> <tag-name> [--from <domain|root>]'
 								);
 								process.exit(1);
 							}
@@ -3223,23 +3384,21 @@ async function main(): Promise<void> {
 							console.error(
 								'❌ Error: Domain argument is required'
 							);
-							console.error('Usage: did-cli tag list <domain>');
+							console.error(
+								'Usage: did-cli tag list <domain> [--from <domain|root>]'
+							);
 							process.exit(1);
 						}
-						await tagList(domain, options);
+						const fromDomain = normalizeTagFromDomain(
+							options.from,
+							domain
+						);
+						await tagList(domain, fromDomain, options);
 						break;
 
 					case 'list-defined':
-						if (!domain) {
-							console.error(
-								'❌ Error: Domain argument is required'
-							);
-							console.error(
-								'Usage: did-cli tag list-defined <domain>'
-							);
-							process.exit(1);
-						}
-						await tagListDefined(domain, options);
+						// domain defaults to "" (root) when not provided
+						await tagListDefined(domain ?? '', options);
 						break;
 
 					case 'set-tagger':
@@ -3341,6 +3500,10 @@ async function main(): Promise<void> {
 				await fetchDomain(domain, options);
 				break;
 
+			case 'fetch-all':
+				await fetchAll(options);
+				break;
+
 			default:
 				console.error(`❌ Unknown command: ${command}`);
 				console.error('Run "did-cli help" for usage information');