@net-protocol/cli 0.1.3 → 0.1.5

package/README.md

@@ -1,6 +1,6 @@
 # @net-protocol/cli
 
-A command-line tool for interacting with Net Protocol. Supports storage uploads and more.
+Command-line tool for Net Protocol — send messages, store data onchain, and deploy tokens across Base and other EVM chains.
 
 ## Installation
 
@@ -354,6 +354,128 @@ netp token info \
   --json
 ```
 
+#### Profile Command
+
+Profile operations for managing your Net Protocol profile.
+
+**Available Subcommands:**
+
+- `profile get` - Get profile data for an address
+- `profile set-picture` - Set your profile picture URL
+- `profile set-x-username` - Set your X (Twitter) username
+
+##### Profile Get
+
+Read profile data for any address.
+
+```bash
+netp profile get \
+  --address <wallet-address> \
+  [--chain-id <8453|1|...>] \
+  [--rpc-url <custom-rpc>] \
+  [--json]
+```
+
+**Profile Get Arguments:**
+
+- `--address` (required): Wallet address to get profile for
+- `--chain-id` (optional): Chain ID. 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
+- `--json` (optional): Output in JSON format
+
+**Example:**
+
+```bash
+# Human-readable output
+netp profile get \
+  --address 0x1234567890abcdef1234567890abcdef12345678 \
+  --chain-id 8453
+
+# JSON output
+netp profile get \
+  --address 0x1234567890abcdef1234567890abcdef12345678 \
+  --chain-id 8453 \
+  --json
+```
+
+##### Profile Set Picture
+
+Set your profile picture URL.
+
+```bash
+netp profile set-picture \
+  --url <image-url> \
+  [--private-key <0x...>] \
+  [--chain-id <8453|1|...>] \
+  [--rpc-url <custom-rpc>] \
+  [--encode-only]
+```
+
+**Profile Set Picture Arguments:**
+
+- `--url` (required): Image URL for profile picture (HTTPS, IPFS, etc.)
+- `--private-key` (optional): Private key. Can also be set via `NET_PRIVATE_KEY` environment variable
+- `--chain-id` (optional): Chain ID. 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
+- `--encode-only` (optional): Output transaction data as JSON instead of executing
+
+**Example:**
+
+```bash
+# Set profile picture
+netp profile set-picture \
+  --url "https://example.com/my-avatar.jpg" \
+  --chain-id 8453
+
+# Encode-only (get transaction data without executing)
+netp profile set-picture \
+  --url "https://example.com/my-avatar.jpg" \
+  --chain-id 8453 \
+  --encode-only
+```
+
+##### Profile Set X Username
+
+Set your X (Twitter) username for your profile.
+
+**Note:** The username is stored without the @ prefix. If you provide @ it will be stripped automatically.
+
+```bash
+netp profile set-x-username \
+  --username <x-username> \
+  [--private-key <0x...>] \
+  [--chain-id <8453|1|...>] \
+  [--rpc-url <custom-rpc>] \
+  [--encode-only]
+```
+
+**Profile Set X Username Arguments:**
+
+- `--username` (required): Your X (Twitter) username (with or without @, stored without @)
+- `--private-key` (optional): Private key. Can also be set via `NET_PRIVATE_KEY` environment variable
+- `--chain-id` (optional): Chain ID. 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
+- `--encode-only` (optional): Output transaction data as JSON instead of executing
+
+**Example:**
+
+```bash
+# Set X username (@ is optional, will be stripped before storage)
+netp profile set-x-username \
+  --username "myusername" \
+  --chain-id 8453
+
+netp profile set-x-username \
+  --username "@myusername" \
+  --chain-id 8453
+
+# Encode-only
+netp profile set-x-username \
+  --username "myusername" \
+  --chain-id 8453 \
+  --encode-only
+```
+
 #### Info Command
 
 Show contract info and stats.
@@ -429,13 +551,21 @@ src/
 │   ├── index.ts          # Main entry point, sets up commander program
 │   └── shared.ts         # Shared option parsing and validation
 ├── commands/
-│   └── storage/          # Storage command module
-│       ├── index.ts      # Storage command definition
-│       ├── core/         # Upload and preview logic
-│       ├── storage/      # Storage operations
-│       ├── transactions/ # Transaction handling
-│       ├── utils.ts      # Storage-specific utilities
-│       └── types.ts      # Storage-specific types
+│   ├── storage/          # Storage command module
+│   │   ├── index.ts      # Storage command definition
+│   │   ├── core/         # Upload and preview logic
+│   │   ├── storage/      # Storage operations
+│   │   ├── transactions/ # Transaction handling
+│   │   ├── utils.ts      # Storage-specific utilities
+│   │   └── types.ts      # Storage-specific types
+│   ├── profile/          # Profile command module
+│   │   ├── index.ts      # Profile command definition
+│   │   ├── get.ts        # Profile get logic
+│   │   ├── set-picture.ts    # Set profile picture
+│   │   ├── set-username.ts   # Set X username
+│   │   └── types.ts      # Profile-specific types
+│   ├── message/          # Message command module
+│   └── token/            # Token command module
 └── shared/               # Shared utilities across commands
     └── types.ts          # Common types (CommonOptions, etc.)
 ```

package/dist/cli/index.mjs

@@ -5,12 +5,14 @@ import { createRequire } from 'module';
 import chalk4 from 'chalk';
 import * as fs from 'fs';
 import { readFileSync } from 'fs';
-import { StorageClient, detectFileTypeFromBase64, base64ToDataUri, shouldSuggestXmlStorage, getStorageKeyBytes, encodeStorageKeyForUrl, STORAGE_CONTRACT, CHUNKED_STORAGE_CONTRACT } from '@net-protocol/storage';
-import { stringToHex, createWalletClient, http, hexToString, parseEther, encodeFunctionData, defineChain } from 'viem';
+import { StorageClient, detectFileTypeFromBase64, base64ToDataUri, shouldSuggestXmlStorage, getStorageKeyBytes, encodeStorageKeyForUrl, STORAGE_CONTRACT as STORAGE_CONTRACT$1, CHUNKED_STORAGE_CONTRACT } 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 } from '@net-protocol/core';
 import { createRelayX402Client, createRelaySession, checkBackendWalletBalance, fundBackendWallet, batchTransactions, submitTransactionsViaRelay, waitForConfirmations, retryFailedTransactions as retryFailedTransactions$1 } from '@net-protocol/relay';
 import { isNetrSupportedChain, NetrClient } from '@net-protocol/netr';
+import { PROFILE_PICTURE_STORAGE_KEY, PROFILE_METADATA_STORAGE_KEY, parseProfileMetadata, isValidUrl, getProfilePictureStorageArgs, STORAGE_CONTRACT, isValidXUsername, getXUsernameStorageArgs } from '@net-protocol/profiles';
+import { base } from 'viem/chains';
 
 function getRequiredChainId(optionValue) {
   const chainId = optionValue || (process.env.NET_CHAIN_ID ? parseInt(process.env.NET_CHAIN_ID, 10) : void 0);
@@ -297,7 +299,7 @@ async function filterExistingTransactions(params) {
 async function filterXmlStorageTransactions(params) {
   const { storageClient, transactions, operatorAddress } = params;
   const metadataTx = transactions.find(
-    (tx) => tx.to.toLowerCase() === STORAGE_CONTRACT.address.toLowerCase()
+    (tx) => tx.to.toLowerCase() === STORAGE_CONTRACT$1.address.toLowerCase()
   );
   const chunkTxs = transactions.filter(
     (tx) => tx.to.toLowerCase() === CHUNKED_STORAGE_CONTRACT.address.toLowerCase()
@@ -1468,8 +1470,8 @@ function registerStorageCommand(program2) {
       console.log(chalk4.blue(`\u{1F4C1} Reading file: ${options.file}`));
       console.log(chalk4.blue(`\u{1F517} Using relay API: ${options.apiUrl}`));
       const result = await uploadFileWithRelay(uploadRelayOptions);
-      const { privateKeyToAccount: privateKeyToAccount6 } = await import('viem/accounts');
-      const userAccount = privateKeyToAccount6(commonOptions.privateKey);
+      const { privateKeyToAccount: privateKeyToAccount8 } = await import('viem/accounts');
+      const userAccount = privateKeyToAccount8(commonOptions.privateKey);
       const storageUrl = generateStorageUrl(
         userAccount.address,
         commonOptions.chainId,
@@ -2216,6 +2218,289 @@ function registerTokenCommand(program2) {
   tokenCommand.addCommand(deployCommand);
   tokenCommand.addCommand(infoCommand);
 }
+async function executeProfileGet(options) {
+  const readOnlyOptions = parseReadOnlyOptions({
+    chainId: options.chainId,
+    rpcUrl: options.rpcUrl
+  });
+  const client = new StorageClient({
+    chainId: readOnlyOptions.chainId,
+    overrides: options.rpcUrl ? { rpcUrls: [options.rpcUrl] } : void 0
+  });
+  try {
+    let profilePicture;
+    try {
+      const pictureResult = await client.readStorageData({
+        key: PROFILE_PICTURE_STORAGE_KEY,
+        operator: options.address
+      });
+      if (pictureResult.data) {
+        profilePicture = pictureResult.data;
+      }
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      if (errorMessage !== "StoredDataNotFound") {
+        throw error;
+      }
+    }
+    let xUsername;
+    try {
+      const metadataResult = await client.readStorageData({
+        key: PROFILE_METADATA_STORAGE_KEY,
+        operator: options.address
+      });
+      if (metadataResult.data) {
+        const metadata = parseProfileMetadata(metadataResult.data);
+        xUsername = metadata?.x_username;
+      }
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      if (errorMessage !== "StoredDataNotFound") {
+        throw error;
+      }
+    }
+    const hasProfile = profilePicture || xUsername;
+    if (options.json) {
+      const output = {
+        address: options.address,
+        chainId: readOnlyOptions.chainId,
+        profilePicture: profilePicture || null,
+        xUsername: xUsername || null,
+        hasProfile
+      };
+      console.log(JSON.stringify(output, null, 2));
+      return;
+    }
+    console.log(chalk4.white.bold("\nProfile:\n"));
+    console.log(`  ${chalk4.cyan("Address:")} ${options.address}`);
+    console.log(`  ${chalk4.cyan("Chain ID:")} ${readOnlyOptions.chainId}`);
+    console.log(
+      `  ${chalk4.cyan("Profile Picture:")} ${profilePicture || chalk4.gray("(not set)")}`
+    );
+    console.log(
+      `  ${chalk4.cyan("X Username:")} ${xUsername ? `@${xUsername}` : chalk4.gray("(not set)")}`
+    );
+    if (!hasProfile) {
+      console.log(chalk4.yellow("\n  No profile data found for this address."));
+    }
+    console.log();
+  } catch (error) {
+    exitWithError(
+      `Failed to read profile: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}
+async function executeProfileSetPicture(options) {
+  if (!isValidUrl(options.url)) {
+    exitWithError(
+      `Invalid URL: "${options.url}". Please provide a valid URL (e.g., https://example.com/image.jpg)`
+    );
+  }
+  const storageArgs = getProfilePictureStorageArgs(options.url);
+  if (options.encodeOnly) {
+    const readOnlyOptions = parseReadOnlyOptions({
+      chainId: options.chainId,
+      rpcUrl: options.rpcUrl
+    });
+    const encoded = encodeTransaction(
+      {
+        to: STORAGE_CONTRACT.address,
+        abi: STORAGE_CONTRACT.abi,
+        functionName: "put",
+        args: [storageArgs.bytesKey, storageArgs.topic, storageArgs.bytesValue]
+      },
+      readOnlyOptions.chainId
+    );
+    console.log(JSON.stringify(encoded, null, 2));
+    return;
+  }
+  const commonOptions = parseCommonOptions({
+    privateKey: options.privateKey,
+    chainId: options.chainId,
+    rpcUrl: options.rpcUrl
+  });
+  try {
+    const account = privateKeyToAccount(commonOptions.privateKey);
+    const rpcUrls = getChainRpcUrls({
+      chainId: commonOptions.chainId,
+      rpcUrl: commonOptions.rpcUrl
+    });
+    const client = createWalletClient({
+      account,
+      chain: base,
+      // TODO: Support other chains
+      transport: http(rpcUrls[0])
+    }).extend(publicActions);
+    console.log(chalk4.blue(`\u{1F4F7} Setting profile picture...`));
+    console.log(chalk4.gray(`   URL: ${options.url}`));
+    console.log(chalk4.gray(`   Address: ${account.address}`));
+    const hash = await client.writeContract({
+      address: STORAGE_CONTRACT.address,
+      abi: STORAGE_CONTRACT.abi,
+      functionName: "put",
+      args: [storageArgs.bytesKey, storageArgs.topic, storageArgs.bytesValue]
+    });
+    console.log(chalk4.blue(`\u23F3 Waiting for confirmation...`));
+    const receipt = await client.waitForTransactionReceipt({ hash });
+    if (receipt.status === "success") {
+      console.log(
+        chalk4.green(
+          `
+\u2713 Profile picture updated successfully!
+  Transaction: ${hash}
+  URL: ${options.url}`
+        )
+      );
+    } else {
+      exitWithError(`Transaction failed: ${hash}`);
+    }
+  } catch (error) {
+    exitWithError(
+      `Failed to set profile picture: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}
+async function executeProfileSetUsername(options) {
+  if (!isValidXUsername(options.username)) {
+    exitWithError(
+      `Invalid X username: "${options.username}". Usernames must be 1-15 characters, alphanumeric and underscores only.`
+    );
+  }
+  const storageArgs = getXUsernameStorageArgs(options.username);
+  const displayUsername = options.username.startsWith("@") ? options.username : `@${options.username}`;
+  if (options.encodeOnly) {
+    const readOnlyOptions = parseReadOnlyOptions({
+      chainId: options.chainId,
+      rpcUrl: options.rpcUrl
+    });
+    const encoded = encodeTransaction(
+      {
+        to: STORAGE_CONTRACT.address,
+        abi: STORAGE_CONTRACT.abi,
+        functionName: "put",
+        args: [storageArgs.bytesKey, storageArgs.topic, storageArgs.bytesValue]
+      },
+      readOnlyOptions.chainId
+    );
+    console.log(JSON.stringify(encoded, null, 2));
+    return;
+  }
+  const commonOptions = parseCommonOptions({
+    privateKey: options.privateKey,
+    chainId: options.chainId,
+    rpcUrl: options.rpcUrl
+  });
+  try {
+    const account = privateKeyToAccount(commonOptions.privateKey);
+    const rpcUrls = getChainRpcUrls({
+      chainId: commonOptions.chainId,
+      rpcUrl: commonOptions.rpcUrl
+    });
+    const client = createWalletClient({
+      account,
+      chain: base,
+      // TODO: Support other chains
+      transport: http(rpcUrls[0])
+    }).extend(publicActions);
+    console.log(chalk4.blue(`\u{1F426} Setting X username...`));
+    console.log(chalk4.gray(`   Username: ${displayUsername}`));
+    console.log(chalk4.gray(`   Address: ${account.address}`));
+    const hash = await client.writeContract({
+      address: STORAGE_CONTRACT.address,
+      abi: STORAGE_CONTRACT.abi,
+      functionName: "put",
+      args: [storageArgs.bytesKey, storageArgs.topic, storageArgs.bytesValue]
+    });
+    console.log(chalk4.blue(`\u23F3 Waiting for confirmation...`));
+    const receipt = await client.waitForTransactionReceipt({ hash });
+    if (receipt.status === "success") {
+      console.log(
+        chalk4.green(
+          `
+\u2713 X username updated successfully!
+  Transaction: ${hash}
+  Username: ${displayUsername}`
+        )
+      );
+    } else {
+      exitWithError(`Transaction failed: ${hash}`);
+    }
+  } catch (error) {
+    exitWithError(
+      `Failed to set X username: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}
+
+// src/commands/profile/index.ts
+function registerProfileCommand(program2) {
+  const profileCommand = program2.command("profile").description("User profile operations");
+  const getCommand = new Command("get").description("Get profile data for an address").requiredOption("--address <address>", "Wallet address to get profile for").option(
+    "--chain-id <id>",
+    "Chain ID. Can also be set via NET_CHAIN_ID env var",
+    (value) => parseInt(value, 10)
+  ).option(
+    "--rpc-url <url>",
+    "Custom RPC URL. Can also be set via NET_RPC_URL env var"
+  ).option("--json", "Output in JSON format").action(async (options) => {
+    await executeProfileGet({
+      address: options.address,
+      chainId: options.chainId,
+      rpcUrl: options.rpcUrl,
+      json: options.json
+    });
+  });
+  const setPictureCommand = new Command("set-picture").description("Set your profile picture URL").requiredOption("--url <url>", "Image URL for profile picture").option(
+    "--private-key <key>",
+    "Private key (0x-prefixed hex, 66 characters). Can also be set via NET_PRIVATE_KEY env var"
+  ).option(
+    "--chain-id <id>",
+    "Chain ID. Can also be set via NET_CHAIN_ID env var",
+    (value) => parseInt(value, 10)
+  ).option(
+    "--rpc-url <url>",
+    "Custom RPC URL. Can also be set via NET_RPC_URL env var"
+  ).option(
+    "--encode-only",
+    "Output transaction data as JSON instead of executing"
+  ).action(async (options) => {
+    await executeProfileSetPicture({
+      url: options.url,
+      privateKey: options.privateKey,
+      chainId: options.chainId,
+      rpcUrl: options.rpcUrl,
+      encodeOnly: options.encodeOnly
+    });
+  });
+  const setUsernameCommand = new Command("set-x-username").description("Set your X (Twitter) username for your profile").requiredOption(
+    "--username <username>",
+    "Your X (Twitter) username (with or without @)"
+  ).option(
+    "--private-key <key>",
+    "Private key (0x-prefixed hex, 66 characters). Can also be set via NET_PRIVATE_KEY env var"
+  ).option(
+    "--chain-id <id>",
+    "Chain ID. Can also be set via NET_CHAIN_ID env var",
+    (value) => parseInt(value, 10)
+  ).option(
+    "--rpc-url <url>",
+    "Custom RPC URL. Can also be set via NET_RPC_URL env var"
+  ).option(
+    "--encode-only",
+    "Output transaction data as JSON instead of executing"
+  ).action(async (options) => {
+    await executeProfileSetUsername({
+      username: options.username,
+      privateKey: options.privateKey,
+      chainId: options.chainId,
+      rpcUrl: options.rpcUrl,
+      encodeOnly: options.encodeOnly
+    });
+  });
+  profileCommand.addCommand(getCommand);
+  profileCommand.addCommand(setPictureCommand);
+  profileCommand.addCommand(setUsernameCommand);
+}
 
 // src/cli/index.ts
 var require2 = createRequire(import.meta.url);
@@ -2227,6 +2512,7 @@ registerMessageCommand(program);
 registerChainsCommand(program);
 registerInfoCommand(program);
 registerTokenCommand(program);
+registerProfileCommand(program);
 program.parse();
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map