@net-protocol/cli 0.1.17 → 0.1.19

package/README.md

@@ -43,7 +43,8 @@ netp storage upload \
   --text <description> \
   [--private-key <0x...>] \
   --chain-id <8453|1|...> \
-  [--rpc-url <custom-rpc>]
+  [--rpc-url <custom-rpc>] \
+  [--chunk-size <bytes>]
 ```
 
 **Storage Upload Arguments:**
@@ -54,6 +55,7 @@ netp storage upload \
 - `--private-key` (optional): Private key (0x-prefixed hex, 66 characters). Can also be set via `NET_PRIVATE_KEY` or `PRIVATE_KEY` environment variable
 - `--chain-id` (optional): Chain ID (8453 for Base, 1 for Ethereum, etc.). Can also be set via `NET_CHAIN_ID` environment variable
 - `--rpc-url` (optional): Custom RPC URL. Can also be set via `NET_RPC_URL` environment variable
+- `--chunk-size` (optional): Size of each XML chunk in bytes (default: 80000). Controls how large files are split for XML storage
 
 **Examples:**
 
@@ -80,6 +82,14 @@ netp storage upload \
 # NET_CHAIN_ID=8453
 # NET_RPC_URL=https://base-mainnet.public.blastapi.io  # optional
 netp storage upload --file ./example.txt --key "my-file" --text "Example file"
+
+# Custom chunk size (40KB instead of default 80KB)
+netp storage upload \
+  --file ./large-file.bin \
+  --key "my-file" \
+  --text "Large file" \
+  --chunk-size 40000 \
+  --chain-id 8453
 ```
 
 ##### Storage Preview
@@ -93,7 +103,8 @@ netp storage preview \
   --text <description> \
   [--private-key <0x...>] \
   --chain-id <8453|1|...> \
-  [--rpc-url <custom-rpc>]
+  [--rpc-url <custom-rpc>] \
+  [--chunk-size <bytes>]
 ```
 
 **Storage Preview Arguments:**
@@ -675,7 +686,7 @@ For files up to 20KB, the tool uses normal storage:
 
 For files larger than 20KB or containing XML references, the tool uses XML storage:
 
-- Breaks file into 80KB XML chunks
+- Breaks file into 80KB XML chunks (configurable via `--chunk-size`)
 - Each XML chunk is stored in ChunkedStorage (compressed and chunked into 20KB pieces)
 - XML metadata references all chunks
 - Multiple sequential transactions (metadata first, then chunks)

package/dist/cli/index.mjs

@@ -6,12 +6,12 @@ import { createRequire } from 'module';
 import chalk4 from 'chalk';
 import * as fs4 from 'fs';
 import { readFileSync } from 'fs';
-import { StorageClient, detectFileTypeFromBase64, base64ToDataUri, shouldSuggestXmlStorage, getStorageKeyBytes, encodeStorageKeyForUrl, chunkDataForStorage, CHUNKED_STORAGE_CONTRACT, STORAGE_CONTRACT as STORAGE_CONTRACT$1 } from '@net-protocol/storage';
+import { OPTIMAL_CHUNK_SIZE, StorageClient, detectFileTypeFromBase64, base64ToDataUri, shouldSuggestXmlStorage, getStorageKeyBytes, encodeStorageKeyForUrl, chunkDataForStorage, CHUNKED_STORAGE_CONTRACT, STORAGE_CONTRACT as STORAGE_CONTRACT$1 } from '@net-protocol/storage';
 import { stringToHex, createWalletClient, http, hexToString, parseEther, encodeFunctionData, publicActions, defineChain } from 'viem';
 import { privateKeyToAccount } from 'viem/accounts';
 import { getNetContract, getChainName, getPublicClient, getChainRpcUrls, NetClient, toBytes32, NULL_ADDRESS } from '@net-protocol/core';
 import { createRelayX402Client, createRelaySession, checkBackendWalletBalance, fundBackendWallet, batchTransactions, submitTransactionsViaRelay, waitForConfirmations, retryFailedTransactions as retryFailedTransactions$1 } from '@net-protocol/relay';
-import { FeedRegistryClient, FeedClient } from '@net-protocol/feeds';
+import { FeedRegistryClient, FeedClient, AgentRegistryClient } from '@net-protocol/feeds';
 import { isNetrSupportedChain, NetrClient } from '@net-protocol/netr';
 import { PROFILE_PICTURE_STORAGE_KEY, PROFILE_METADATA_STORAGE_KEY, parseProfileMetadata, PROFILE_CANVAS_STORAGE_KEY, isValidUrl, getProfilePictureStorageArgs, STORAGE_CONTRACT, isValidXUsername, getProfileMetadataStorageArgs, isValidBio, isValidTokenAddress } from '@net-protocol/profiles';
 import { base } from 'viem/chains';
@@ -264,7 +264,7 @@ function prepareNormalStorageTransaction(storageClient, args, originalStorageKey
   };
 }
 function prepareXmlStorageTransactions(params) {
-  const { storageClient, storageKey, text, content, operatorAddress } = params;
+  const { storageClient, storageKey, text, content, operatorAddress, chunkSize } = params;
   const storageKeyBytes = getStorageKeyBytes(storageKey);
   const result = storageClient.prepareXmlStorage({
     data: content,
@@ -272,8 +272,9 @@ function prepareXmlStorageTransactions(params) {
     storageKey,
     // Pass as string, not bytes32
     filename: text,
-    useChunkedStorageBackend: true
+    useChunkedStorageBackend: true,
     // Use ChunkedStorage backend (default)
+    chunkSize
   });
   const transactions = result.transactionConfigs.map(
     (tx, index) => {
@@ -550,7 +551,8 @@ async function uploadFile(options) {
       storageKey: options.storageKey,
       text: options.text,
       content: fileContent,
-      operatorAddress
+      operatorAddress,
+      chunkSize: options.chunkSize
     });
   } else {
     const storageKeyBytes = getStorageKeyBytes(
@@ -791,7 +793,8 @@ async function uploadFileWithRelay(options) {
     operatorAddress: backendWalletAddress,
     storageKey: options.storageKey,
     filename: options.text,
-    useChunkedStorageBackend: true
+    useChunkedStorageBackend: true,
+    chunkSize: options.chunkSize
   });
   const chunkTxs = chunkPrepareResult.transactionConfigs.slice(1);
   const topLevelHash = chunkPrepareResult.topLevelHash;
@@ -999,7 +1002,8 @@ async function previewFile(options) {
       storageKey: options.storageKey,
       text: options.text,
       content: fileContent,
-      operatorAddress
+      operatorAddress,
+      chunkSize: options.chunkSize
     });
   } else {
     const storageKeyBytes = getStorageKeyBytes(
@@ -1260,7 +1264,8 @@ async function encodeStorageUpload(options) {
       data: fileContent,
       operatorAddress,
       storageKey: options.storageKey,
-      filename: options.text
+      filename: options.text,
+      chunkSize: options.chunkSize
     });
     const encodedTransactions = transactionConfigs.map(
       (config) => encodeTransaction(config, readOnlyOptions.chainId)
@@ -1290,8 +1295,6 @@ async function encodeStorageUpload(options) {
     };
   }
 }
-
-// src/commands/storage/index.ts
 function registerStorageCommand(program2) {
   const storageCommand = program2.command("storage").description("Storage operations");
   const uploadCommand = new Command("upload").description("Upload files to Net Storage").requiredOption("--file <path>", "Path to file to upload").requiredOption("--key <key>", "Storage key (filename/identifier)").requiredOption("--text <text>", "Text description/filename").option(
@@ -1307,6 +1310,10 @@ function registerStorageCommand(program2) {
   ).option(
     "--encode-only",
     "Output transaction data as JSON instead of executing"
+  ).option(
+    "--chunk-size <bytes>",
+    `Max chunk size in bytes for splitting large files (default: ${OPTIMAL_CHUNK_SIZE})`,
+    (value) => parseInt(value, 10)
   ).action(async (options) => {
     if (options.encodeOnly) {
       try {
@@ -1316,7 +1323,8 @@ function registerStorageCommand(program2) {
           text: options.text,
           privateKey: options.privateKey,
           chainId: options.chainId,
-          rpcUrl: options.rpcUrl
+          rpcUrl: options.rpcUrl,
+          chunkSize: options.chunkSize
         });
         console.log(JSON.stringify(result, null, 2));
         process.exit(0);
@@ -1345,7 +1353,8 @@ function registerStorageCommand(program2) {
       text: options.text,
       privateKey: commonOptions.privateKey,
       chainId: commonOptions.chainId,
-      rpcUrl: commonOptions.rpcUrl
+      rpcUrl: commonOptions.rpcUrl,
+      chunkSize: options.chunkSize
     };
     try {
       console.log(chalk4.blue(`\u{1F4C1} Reading file: ${options.file}`));
@@ -1410,6 +1419,10 @@ function registerStorageCommand(program2) {
   ).option(
     "--rpc-url <url>",
     "Custom RPC URL (can also be set via NET_RPC_URL env var)"
+  ).option(
+    "--chunk-size <bytes>",
+    `Max chunk size in bytes for splitting large files (default: ${OPTIMAL_CHUNK_SIZE})`,
+    (value) => parseInt(value, 10)
   ).action(async (options) => {
     const commonOptions = parseCommonOptions({
       privateKey: options.privateKey,
@@ -1422,7 +1435,8 @@ function registerStorageCommand(program2) {
       text: options.text,
       privateKey: commonOptions.privateKey,
       chainId: commonOptions.chainId,
-      rpcUrl: commonOptions.rpcUrl
+      rpcUrl: commonOptions.rpcUrl,
+      chunkSize: options.chunkSize
     };
     try {
       console.log(chalk4.blue(`\u{1F4C1} Reading file: ${options.file}`));
@@ -1504,6 +1518,10 @@ function registerStorageCommand(program2) {
   ).option(
     "--rpc-url <url>",
     "Custom RPC URL (can also be set via NET_RPC_URL env var)"
+  ).option(
+    "--chunk-size <bytes>",
+    `Max chunk size in bytes for splitting large files (default: ${OPTIMAL_CHUNK_SIZE})`,
+    (value) => parseInt(value, 10)
   ).action(async (options) => {
     const commonOptions = parseCommonOptions({
       privateKey: options.privateKey,
@@ -1527,7 +1545,8 @@ function registerStorageCommand(program2) {
       chainId: commonOptions.chainId,
       rpcUrl: commonOptions.rpcUrl,
       apiUrl: options.apiUrl,
-      secretKey
+      secretKey,
+      chunkSize: options.chunkSize
     };
     try {
       console.log(chalk4.blue(`\u{1F4C1} Reading file: ${options.file}`));
@@ -1622,6 +1641,12 @@ function createNetClient(options) {
     overrides: options.rpcUrl ? { rpcUrls: [options.rpcUrl] } : void 0
   });
 }
+function createAgentRegistryClient(options) {
+  return new AgentRegistryClient({
+    chainId: options.chainId,
+    overrides: options.rpcUrl ? { rpcUrls: [options.rpcUrl] } : void 0
+  });
+}
 
 // src/commands/message/send.ts
 function prepareMessageConfig(client, options) {
@@ -6365,6 +6390,73 @@ function registerFeedHistoryCommand(parent) {
     await executeFeedHistory(options);
   });
 }
+async function executeRegisterAgent(options) {
+  if (options.encodeOnly) {
+    const readOnlyOptions = parseReadOnlyOptionsWithDefault({
+      chainId: options.chainId,
+      rpcUrl: options.rpcUrl
+    });
+    const client2 = createAgentRegistryClient(readOnlyOptions);
+    const txConfig2 = client2.prepareRegisterAgent();
+    const encoded = encodeTransaction(txConfig2, readOnlyOptions.chainId);
+    printJson(encoded);
+    return;
+  }
+  const commonOptions = parseCommonOptionsWithDefault(
+    {
+      privateKey: options.privateKey,
+      chainId: options.chainId,
+      rpcUrl: options.rpcUrl
+    },
+    true
+    // supports --encode-only
+  );
+  const client = createAgentRegistryClient(commonOptions);
+  const walletClient = createWallet(
+    commonOptions.privateKey,
+    commonOptions.chainId,
+    commonOptions.rpcUrl
+  );
+  const isRegistered = await client.isAgentRegistered(walletClient.account.address);
+  if (isRegistered) {
+    exitWithError(`Address ${walletClient.account.address} is already registered as an agent`);
+  }
+  console.log(chalk4.blue(`Registering agent ${walletClient.account.address}...`));
+  const txConfig = client.prepareRegisterAgent();
+  try {
+    const hash = await executeTransaction(walletClient, txConfig);
+    addHistoryEntry({
+      type: "register",
+      txHash: hash,
+      chainId: commonOptions.chainId,
+      feed: "agent-registry",
+      sender: walletClient.account.address
+    });
+    console.log(
+      chalk4.green(
+        `Agent registered successfully!
+  Transaction: ${hash}
+  Address: ${walletClient.account.address}`
+      )
+    );
+  } catch (error) {
+    exitWithError(
+      `Failed to register agent: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}
+function registerAgentRegisterCommand(parent) {
+  parent.command("register-agent").description("Register your address on the agent leaderboard").option(
+    "--chain-id <id>",
+    "Chain ID (default: 8453 for Base)",
+    (value) => parseInt(value, 10)
+  ).option("--rpc-url <url>", "Custom RPC URL").option("--private-key <key>", "Private key (0x-prefixed)").option(
+    "--encode-only",
+    "Output transaction data as JSON instead of executing"
+  ).action(async (options) => {
+    await executeRegisterAgent(options);
+  });
+}
 
 // src/commands/feed/index.ts
 function registerFeedCommand(program2) {
@@ -6379,6 +6471,7 @@ function registerFeedCommand(program2) {
   registerFeedPostsCommand(feedCommand);
   registerFeedConfigCommand(feedCommand);
   registerFeedHistoryCommand(feedCommand);
+  registerAgentRegisterCommand(feedCommand);
 }
 
 // src/cli/index.ts