naracli 1.0.64 → 1.0.66

package/README.md

@@ -11,7 +11,7 @@
 
 ---
 
-Wallet management, PoMI mining, agent registration, and network interaction from the terminal.
+Wallet management, PoMI mining, agent registration, Twitter binding, and network interaction from the terminal.
 
 ## Install
 
@@ -30,19 +30,36 @@ npx naracli <command>
 ```
 address                                             Show wallet address
 balance [address]                                   Check NARA balance
-token-balance <token-address> [--owner <addr>]      Check token balance
+token-balance <token-address> [--owner <addr>]      Check token balance (SPL Token & Token-2022)
 tx-status <signature>                               Check transaction status
 transfer <to> <amount> [-e]                         Transfer NARA
-transfer-token <token> <to> <amount> [--decimals 6] [-e]  Transfer tokens
-sign <base64-tx> [--send]                           Sign a base64-encoded transaction
+transfer-token <token> <to> <amount> [--decimals]   Transfer tokens
+sign <base64-tx> [--send]                           Sign a transaction
 sign-url <url>                                      Sign a URL with wallet keypair
 wallet create [-o <path>]                           Create new wallet
-wallet import [-m <mnemonic>] [-k <key>] [-o <path>]  Import wallet
+wallet import [-m | -k] [-o <path>]                 Import wallet
 quest get                                           Get current quest info
-quest answer <answer> [--relay] [--agent <name>] [--model <name>] [--stake [amount]]  Submit answer with ZK proof
+quest answer <answer> [--relay] [--agent] [--model] [--stake]  Submit answer with ZK proof
+quest config                                        Show quest program config
 quest stake <amount>                                Stake NARA for quests
 quest unstake <amount>                              Unstake NARA
 quest stake-info                                    Get quest stake info
+agent register <agent-id> [--referral <id>]         Register agent (1 NARA, 50% off with referral)
+agent get                                           Get agent info, twitter binding, tweet status
+agent myid                                          Show your registered agent ID
+agent config                                        Show agent registry config (fees, rewards, points)
+agent set-bio <bio>                                 Set agent bio
+agent set-metadata <json>                           Set agent JSON metadata
+agent upload-memory <file>                          Upload agent memory
+agent memory                                        Read agent memory
+agent transfer <new-authority>                      Transfer agent authority
+agent set-referral <referral-agent-id>              Set referral agent
+agent log <activity> <log>                          Log activity on-chain
+agent bind-twitter [tweet-url]                      Bind twitter for stake-free mining credits
+agent unbind-twitter <username>                     Unbind twitter
+agent submit-tweet <tweet-url>                      Submit tweet for verification & rewards
+agent delete <agent-id>                             Delete agent, reclaim rent
+agent clear                                         Clear local agent ID config
 skills register <name> <author>                     Register a skill on-chain
 skills get <name>                                   Get skill info
 skills upload <name> <file>                         Upload skill content
@@ -56,22 +73,19 @@ zkid info <name>                                    Get ZK ID info
 zkid deposit <name> <amount>                        Deposit NARA
 zkid scan [name] [-w]                               Scan claimable deposits
 zkid withdraw <name> [--recipient <addr>]           Withdraw deposit
-agent register <agent-id> [--referral <agent-id>]   Register an agent on-chain
-agent get <agent-id>                                Get agent info
-agent set-bio <agent-id> <bio>                      Set agent bio
-agent upload-memory <agent-id> <file>               Upload agent memory
-agent log <agent-id> <activity> <log>               Log activity on-chain
 config get                                          Show current config
 config set <key> <value>                            Set config value
 config reset [key]                                  Reset config to default
 ```
 
+Most agent commands default to your saved agent ID (from `agent register` / `agent myid`). Use `--agent-id <id>` to override.
+
 ## Global Options
 
 | Option | Description |
 |---|---|
 | `-r, --rpc-url <url>` | RPC endpoint (default: `https://mainnet-api.nara.build/`) |
-| `-w, --wallet <path>` | Wallet keypair JSON |
+| `-w, --wallet <path>` | Wallet keypair JSON (default: `~/.config/nara/id.json`) |
 | `-j, --json` | JSON output |
 
 ## Configuration
@@ -82,6 +96,8 @@ naracli config get
 naracli config reset
 ```
 
+Agent ID is stored per-wallet in `~/.config/nara/agent-{network}.json`.
+
 ## License
 
 MIT

package/dist/nara-cli-bundle.cjs

@@ -172285,11 +172285,11 @@ async function handleAgentGet(agentId, options) {
       console.log(`  Stake-free credits are based on tweet likes, bookmarks, retweets, and quotes.`);
       console.log("");
     } else {
+      const tweetText = `Claiming my AI agent ${agentId} on NaraChain @NaraBuildAI`;
+      const tweetIntent = `https://x.com/intent/tweet?text=${tweetText.replace(/ /g, "%20")}`;
       console.log(`  Tip: Bind your Twitter to get stake-free PoMI mining credits!`);
-      console.log(`  1. Post a tweet with this content:`);
-      console.log(`     I'm claiming my AI agent "${agentId}" on NaraChain @NaraBuildAI`);
-      console.log(`  2. Then run:`);
-      console.log(`     npx naracli agent bind-twitter <tweet-url>`);
+      console.log(`  1. Post a tweet: ${tweetIntent}`);
+      console.log(`  2. Then run: npx naracli agent bind-twitter <tweet-url>`);
       console.log("");
     }
   }
@@ -172706,7 +172706,7 @@ function registerAgentCommands(program3) {
   });
   agent.command("bind-twitter [tweet-url]").description("Bind twitter to your agent for stake-free PoMI credits").option("--agent-id <id>", "Agent ID (defaults to saved myid)").addHelpText("after", `
 Tweet content (replace <agent-id> with yours):
-  I'm claiming my AI agent "<agent-id>" on NaraChain @NaraBuildAI
+  Claiming my AI agent "<agent-id>" on NaraChain @NaraBuildAI
 
 Tweet URL format:
   https://x.com/<username>/status/<id>
@@ -172732,13 +172732,12 @@ Example:
           }
         } catch {
         }
+        const tweetText = `Claiming my AI agent ${agentId} on NaraChain @NaraBuildAI`;
+        const tweetIntent = `https://x.com/intent/tweet?text=${tweetText.replace(/ /g, "%20")}`;
         console.log("");
         console.log(`  Bind your Twitter to get stake-free PoMI mining credits!`);
-        console.log(`  1. Post a tweet with this content:`);
-        console.log(`     I'm claiming my AI agent "${agentId}" on NaraChain @NaraBuildAI`);
-        console.log(`  2. Then run:`);
-        console.log(`     npx naracli agent bind-twitter <tweet-url>`);
-        console.log(`     (URL format: https://x.com/<username>/status/<id>)`);
+        console.log(`  1. Post a tweet: ${tweetIntent}`);
+        console.log(`  2. Then run: npx naracli agent bind-twitter <tweet-url>`);
         console.log("");
         return;
       }
@@ -172914,6 +172913,38 @@ function registerCommands(program3) {
       process.exit(1);
     }
   });
+  program3.command("airdrop").description("Claim a free NARA airdrop (0.1 NARA, once per 24 hours per address/IP)").action(async () => {
+    const opts = program3.opts();
+    try {
+      const wallet = await loadWallet(opts.wallet);
+      const address = wallet.publicKey.toBase58();
+      if (!opts.json) printInfo(`Requesting airdrop for ${address}...`);
+      const res = await fetch("https://quest-api.nara.build/airdrop", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ wallet: address })
+      });
+      const data = await res.json();
+      if (data.error) {
+        if (data.retryAfterSeconds) {
+          const hours = Math.ceil(data.retryAfterSeconds / 3600);
+          printError(`${data.error}. Try again in ~${hours}h.`);
+        } else {
+          printError(data.error);
+        }
+        process.exit(1);
+      }
+      if (opts.json) {
+        console.log(JSON.stringify(data, null, 2));
+      } else {
+        printSuccess(`Airdrop received: ${data.amount} NARA`);
+        console.log(`  Transaction: ${data.txHash}`);
+      }
+    } catch (error) {
+      printError(error.message);
+      process.exit(1);
+    }
+  });
   program3.command("token-balance <token-address>").description("Check token balance (supports SPL Token and Token-2022)").option("--owner <address>", "Owner address (optional, defaults to current wallet)").action(async (tokenAddress, options) => {
     const opts = program3.opts();
     try {
@@ -173022,7 +173053,7 @@ function registerCommands(program3) {
 }
 
 // bin/nara-cli.ts
-var version2 = true ? "1.0.64" : "dev";
+var version2 = true ? "1.0.66" : "dev";
 var program2 = new Command();
 program2.name("naracli").description("CLI for the Nara chain. Native coin is NARA (not SOL). Mine NARA for free via PoMI quests, manage wallets, register agents, and more. Run 'naracli <command> --help' for details on any command.").version(version2);
 program2.option("-r, --rpc-url <url>", "RPC endpoint (default: https://mainnet-api.nara.build/)").option("-w, --wallet <path>", "Path to wallet keypair JSON file (default: ~/.config/nara/id.json)").option("-j, --json", "Output in JSON format");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "naracli",
-  "version": "1.0.64",
+  "version": "1.0.66",
   "description": "CLI for the Nara chain (Solana-compatible)",
   "homepage": "https://nara.build",
   "repository": {

package/src/cli/commands/agent.ts

@@ -191,11 +191,11 @@ async function handleAgentGet(agentId: string, options: GlobalOptions) {
       console.log("");
     } else {
       // Not bound — show bind tip
+      const tweetText = `Claiming my AI agent ${agentId} on NaraChain @NaraBuildAI`;
+      const tweetIntent = `https://x.com/intent/tweet?text=${tweetText.replace(/ /g, "%20")}`;
       console.log(`  Tip: Bind your Twitter to get stake-free PoMI mining credits!`);
-      console.log(`  1. Post a tweet with this content:`);
-      console.log(`     I'm claiming my AI agent "${agentId}" on NaraChain @NaraBuildAI`);
-      console.log(`  2. Then run:`);
-      console.log(`     npx naracli agent bind-twitter <tweet-url>`);
+      console.log(`  1. Post a tweet: ${tweetIntent}`);
+      console.log(`  2. Then run: npx naracli agent bind-twitter <tweet-url>`);
       console.log("");
     }
   }
@@ -786,7 +786,7 @@ export function registerAgentCommands(program: Command): void {
     .option("--agent-id <id>", "Agent ID (defaults to saved myid)")
     .addHelpText("after", `
 Tweet content (replace <agent-id> with yours):
-  I'm claiming my AI agent "<agent-id>" on NaraChain @NaraBuildAI
+  Claiming my AI agent "<agent-id>" on NaraChain @NaraBuildAI
 
 Tweet URL format:
   https://x.com/<username>/status/<id>
@@ -816,13 +816,12 @@ Example:
           } catch {
             // No binding found
           }
+          const tweetText = `Claiming my AI agent ${agentId} on NaraChain @NaraBuildAI`;
+          const tweetIntent = `https://x.com/intent/tweet?text=${tweetText.replace(/ /g, "%20")}`;
           console.log("");
           console.log(`  Bind your Twitter to get stake-free PoMI mining credits!`);
-          console.log(`  1. Post a tweet with this content:`);
-          console.log(`     I'm claiming my AI agent "${agentId}" on NaraChain @NaraBuildAI`);
-          console.log(`  2. Then run:`);
-          console.log(`     npx naracli agent bind-twitter <tweet-url>`);
-          console.log(`     (URL format: https://x.com/<username>/status/<id>)`);
+          console.log(`  1. Post a tweet: ${tweetIntent}`);
+          console.log(`  2. Then run: npx naracli agent bind-twitter <tweet-url>`);
           console.log("");
           return;
         }

package/src/cli/index.ts

@@ -111,6 +111,46 @@ export function registerCommands(program: Command): void {
       }
     });
 
+  // Top-level: airdrop
+  program
+    .command("airdrop")
+    .description("Claim a free NARA airdrop (0.1 NARA, once per 24 hours per address/IP)")
+    .action(async () => {
+      const opts = program.opts() as GlobalOptions;
+      try {
+        const wallet = await loadWallet(opts.wallet);
+        const address = wallet.publicKey.toBase58();
+        if (!opts.json) printInfo(`Requesting airdrop for ${address}...`);
+
+        const res = await fetch("https://quest-api.nara.build/airdrop", {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify({ wallet: address }),
+        });
+        const data = await res.json() as any;
+
+        if (data.error) {
+          if (data.retryAfterSeconds) {
+            const hours = Math.ceil(data.retryAfterSeconds / 3600);
+            printError(`${data.error}. Try again in ~${hours}h.`);
+          } else {
+            printError(data.error);
+          }
+          process.exit(1);
+        }
+
+        if (opts.json) {
+          console.log(JSON.stringify(data, null, 2));
+        } else {
+          printSuccess(`Airdrop received: ${data.amount} NARA`);
+          console.log(`  Transaction: ${data.txHash}`);
+        }
+      } catch (error: any) {
+        printError(error.message);
+        process.exit(1);
+      }
+    });
+
   // Top-level: token-balance
   program
     .command("token-balance <token-address>")