@cavos/cli 0.0.7 → 0.1.1

package/README.md

@@ -1,6 +1,6 @@
 # @cavos/cli
 
-**Cavos CLI** is the ultimate toolkit for AI Agents to interact with Starknet. It provides a session-key based wallet interface designed for both human manual use and autonomous agent execution.
+**Cavos CLI** is the ultimate toolkit for AI Agents to interact with Starknet (Mainnet). It provides a session-key based wallet interface designed for both human manual use and autonomous agent execution.
 
 ## Features
 
@@ -31,7 +31,7 @@ Before acting, you need a session token. You can generate one from your Cavos Da
 
 1.  **Import Session:**
     ```bash
-    cavos session import "eyJhbG..." --app-id "YOUR_APP_ID"
+    cavos session import "eyJhbG..."
     ```
 
 2.  **Verify Status:**

package/dist/cli.js

@@ -712,7 +712,7 @@ async function getBalance(provider, tokenAddress, walletAddress) {
     contractAddress: tokenAddress,
     entrypoint: "balanceOf",
     calldata: [walletAddress]
-  });
+  }, "latest");
   const low = BigInt(result[0]);
   const high = BigInt(result[1]);
   return low + (high << 128n);
@@ -1515,20 +1515,19 @@ var tools_default = [
 
 // src/cli.ts
 var program = new import_commander.Command();
-program.name("cavos").description("Cavos CLI \u2014 AI agent wallet toolkit for Starknet").version("0.0.7");
+program.name("cavos").description("Cavos CLI \u2014 AI agent wallet toolkit for Starknet").version("0.1.0");
 var DEFAULT_APP_ID = "0c3ff58a-1968-41c2-b0e0-a5c47309e77d";
-var DEFAULT_NETWORK = "mainnet";
 function getAgent(opts) {
   const config = loadConfig();
   const appId = opts.appId || config.defaultAppId || process.env.CAVOS_APP_ID || DEFAULT_APP_ID;
-  const network = opts.network || config.network || process.env.CAVOS_NETWORK || DEFAULT_NETWORK;
+  const network = "mainnet";
   const policy2 = loadPolicy();
   return new CavosAgent({ appId, network, policy: policy2 });
 }
-function resolveToken(symbol, network) {
-  if (!symbol) return network === "mainnet" ? TOKENS_MAINNET.STRK : TOKENS_SEPOLIA.STRK;
+function resolveToken(symbol) {
+  if (!symbol) return TOKENS_MAINNET.STRK;
   const upper = symbol.toUpperCase();
-  const tokens = network === "mainnet" ? TOKENS_MAINNET : TOKENS_SEPOLIA;
+  const tokens = TOKENS_MAINNET;
   if (upper === "STRK") return tokens.STRK;
   if (upper === "ETH") return tokens.ETH;
   return symbol;
@@ -1571,7 +1570,7 @@ async function waitForTx(agent, txHash, timeoutMs = 12e4) {
   }
   throw new Error(`Transaction confirmation timeout after ${timeoutMs / 1e3}s`);
 }
-program.command("whoami").description("Show current session info").option("--app-id <appId>", "App ID").option("--network <network>", "Network").option("--json", "Output as JSON").action(async (opts) => {
+program.command("whoami").description("Show current session info").option("--app-id <appId>", "App ID").option("--json", "Output as JSON").action(async (opts) => {
   try {
     const agent = getAgent(opts);
     const mode = process.env.CAVOS_TOKEN || process.env.CAVOS_SESSION_TOKEN ? "env" : "disk";
@@ -1608,13 +1607,11 @@ program.command("whoami").description("Show current session info").option("--app
     outError(opts.json, err.message);
   }
 });
-program.command("transfer").description("Transfer ERC-20 tokens").requiredOption("--to <address>", "Recipient address").requiredOption("--amount <amount>", "Amount in human-readable units (e.g. 1.5)").option("--token <token>", "Token symbol (STRK, ETH) or address", "STRK").option("--app-id <appId>", "App ID").option("--network <network>", "Network").option("--wait", "Wait for on-chain confirmation").option("--json", "Output as JSON").action(async (opts) => {
+program.command("transfer").description("Transfer ERC-20 tokens").requiredOption("--to <address>", "Recipient address").requiredOption("--amount <amount>", "Amount in human-readable units (e.g. 1.5)").option("--token <token>", "Token symbol (STRK, ETH) or address", "STRK").option("--app-id <appId>", "App ID").option("--wait", "Wait for on-chain confirmation").option("--json", "Output as JSON").action(async (opts) => {
   try {
     const agent = getAgent(opts);
     if (!agent.isAuthenticated()) outError(opts.json, "No session. Import one: cavos session import <token>", "NoSession");
-    const config = loadConfig();
-    const network = opts.network || config.network || DEFAULT_NETWORK;
-    const tokenAddress = resolveToken(opts.token, network);
+    const tokenAddress = resolveToken(opts.token);
     const amount = BigInt(Math.floor(parseFloat(opts.amount) * 1e18));
     if (!opts.json) console.log(`Transferring ${opts.amount} ${opts.token} to ${opts.to}...`);
     const txHash = await agent.transfer(tokenAddress, opts.to, amount);
@@ -1622,7 +1619,7 @@ program.command("transfer").description("Transfer ERC-20 tokens").requiredOption
       if (!opts.json) console.log("Waiting for confirmation...");
       await waitForTx(agent, txHash);
     }
-    const explorerBase = network === "mainnet" ? "https://voyager.online/tx" : "https://sepolia.voyager.online/tx";
+    const explorerBase = "https://voyager.online/tx";
     out(opts.json, { status: "ok", transaction_hash: txHash, explorer: `${explorerBase}/${txHash}` }, () => {
       console.log(`Transaction: ${txHash}`);
       console.log(`Explorer:    ${explorerBase}/${txHash}`);
@@ -1631,13 +1628,11 @@ program.command("transfer").description("Transfer ERC-20 tokens").requiredOption
     outError(opts.json, err.message, "TransferFailed");
   }
 });
-program.command("approve").description("Approve ERC-20 spending").requiredOption("--spender <address>", "Spender address").requiredOption("--amount <amount>", "Amount in human-readable units").option("--token <token>", "Token symbol or address", "STRK").option("--app-id <appId>", "App ID").option("--network <network>", "Network").option("--wait", "Wait for on-chain confirmation").option("--json", "Output as JSON").action(async (opts) => {
+program.command("approve").description("Approve ERC-20 spending").requiredOption("--spender <address>", "Spender address").requiredOption("--amount <amount>", "Amount in human-readable units").option("--token <token>", "Token symbol or address", "STRK").option("--app-id <appId>", "App ID").option("--wait", "Wait for on-chain confirmation").option("--json", "Output as JSON").action(async (opts) => {
   try {
     const agent = getAgent(opts);
     if (!agent.isAuthenticated()) outError(opts.json, "No session. Import one: cavos session import <token>", "NoSession");
-    const config = loadConfig();
-    const network = opts.network || config.network || DEFAULT_NETWORK;
-    const tokenAddress = resolveToken(opts.token, network);
+    const tokenAddress = resolveToken(opts.token);
     const amount = BigInt(Math.floor(parseFloat(opts.amount) * 1e18));
     if (!opts.json) console.log(`Approving ${opts.amount} ${opts.token} for ${opts.spender}...`);
     const txHash = await agent.approve(tokenAddress, opts.spender, amount);
@@ -1645,7 +1640,7 @@ program.command("approve").description("Approve ERC-20 spending").requiredOption
       if (!opts.json) console.log("Waiting for confirmation...");
       await waitForTx(agent, txHash);
     }
-    const explorerBase = network === "mainnet" ? "https://voyager.online/tx" : "https://sepolia.voyager.online/tx";
+    const explorerBase = "https://voyager.online/tx";
     out(opts.json, { status: "ok", transaction_hash: txHash, explorer: `${explorerBase}/${txHash}` }, () => {
       console.log(`Transaction: ${txHash}`);
       console.log(`Explorer:    ${explorerBase}/${txHash}`);
@@ -1654,20 +1649,18 @@ program.command("approve").description("Approve ERC-20 spending").requiredOption
     outError(opts.json, err.message, "ApproveFailed");
   }
 });
-program.command("execute").description("Execute a raw contract call").requiredOption("--contract <address>", "Contract address").requiredOption("--entrypoint <name>", "Entrypoint name").option("--calldata <data>", "Comma-separated calldata values").option("--app-id <appId>", "App ID").option("--network <network>", "Network").option("--wait", "Wait for on-chain confirmation").option("--json", "Output as JSON").action(async (opts) => {
+program.command("execute").description("Execute a raw contract call").requiredOption("--contract <address>", "Contract address").requiredOption("--entrypoint <name>", "Entrypoint name").option("--calldata <data>", "Comma-separated calldata values").option("--app-id <appId>", "App ID").option("--wait", "Wait for on-chain confirmation").option("--json", "Output as JSON").action(async (opts) => {
   try {
     const agent = getAgent(opts);
     if (!agent.isAuthenticated()) outError(opts.json, "No session. Import one: cavos session import <token>", "NoSession");
     const calldata = opts.calldata ? opts.calldata.split(",").map((s) => s.trim()) : [];
-    const config = loadConfig();
-    const network = opts.network || config.network || DEFAULT_NETWORK;
     if (!opts.json) console.log(`Executing ${opts.entrypoint} on ${opts.contract}...`);
     const txHash = await agent.execute({ contractAddress: opts.contract, entrypoint: opts.entrypoint, calldata });
     if (opts.wait) {
       if (!opts.json) console.log("Waiting for confirmation...");
       await waitForTx(agent, txHash);
     }
-    const explorerBase = network === "mainnet" ? "https://voyager.online/tx" : "https://sepolia.voyager.online/tx";
+    const explorerBase = "https://voyager.online/tx";
     out(opts.json, { status: "ok", transaction_hash: txHash, explorer: `${explorerBase}/${txHash}` }, () => {
       console.log(`Transaction: ${txHash}`);
       console.log(`Explorer:    ${explorerBase}/${txHash}`);
@@ -1676,7 +1669,7 @@ program.command("execute").description("Execute a raw contract call").requiredOp
     outError(opts.json, err.message, "ExecuteFailed");
   }
 });
-program.command("multicall").description("Execute multiple contract calls in one transaction").requiredOption("--calls <json>", 'JSON array of calls: [{"contractAddress":"0x...","entrypoint":"fn","calldata":["0x..."]}]').option("--app-id <appId>", "App ID").option("--network <network>", "Network").option("--wait", "Wait for on-chain confirmation").option("--json", "Output as JSON").action(async (opts) => {
+program.command("multicall").description("Execute multiple contract calls in one transaction").requiredOption("--calls <json>", 'JSON array of calls: [{"contractAddress":"0x...","entrypoint":"fn","calldata":["0x..."]}]').option("--app-id <appId>", "App ID").option("--wait", "Wait for on-chain confirmation").option("--json", "Output as JSON").action(async (opts) => {
   try {
     const agent = getAgent(opts);
     if (!agent.isAuthenticated()) outError(opts.json, "No session. Import one: cavos session import <token>", "NoSession");
@@ -1688,15 +1681,13 @@ program.command("multicall").description("Execute multiple contract calls in one
       outError(opts.json, `Invalid --calls JSON: ${e.message}`, "InvalidInput");
       return;
     }
-    const config = loadConfig();
-    const network = opts.network || config.network || DEFAULT_NETWORK;
     if (!opts.json) console.log(`Executing ${calls.length} calls...`);
     const txHash = await agent.execute(calls);
     if (opts.wait) {
       if (!opts.json) console.log("Waiting for confirmation...");
       await waitForTx(agent, txHash);
     }
-    const explorerBase = network === "mainnet" ? "https://voyager.online/tx" : "https://sepolia.voyager.online/tx";
+    const explorerBase = "https://voyager.online/tx";
     out(opts.json, { status: "ok", transaction_hash: txHash, call_count: calls.length, explorer: `${explorerBase}/${txHash}` }, () => {
       console.log(`Transaction: ${txHash}`);
       console.log(`Explorer:    ${explorerBase}/${txHash}`);
@@ -1705,7 +1696,7 @@ program.command("multicall").description("Execute multiple contract calls in one
     outError(opts.json, err.message, "MulticallFailed");
   }
 });
-program.command("deploy").description("Deploy the account contract").option("--app-id <appId>", "App ID").option("--network <network>", "Network").option("--json", "Output as JSON").action(async (opts) => {
+program.command("deploy").description("Deploy the account contract").option("--app-id <appId>", "App ID").option("--json", "Output as JSON").action(async (opts) => {
   try {
     const agent = getAgent(opts);
     if (!agent.isAuthenticated()) outError(opts.json, "No session. Import one: cavos session import <token>", "NoSession");
@@ -1724,15 +1715,13 @@ program.command("deploy").description("Deploy the account contract").option("--a
     outError(opts.json, err.message, "DeployFailed");
   }
 });
-program.command("balance").description("Show token balance").option("--token <token>", "Token symbol or address").option("--app-id <appId>", "App ID").option("--network <network>", "Network").option("--json", "Output as JSON").action(async (opts) => {
+program.command("balance").description("Show token balance").option("--token <token>", "Token symbol or address").option("--app-id <appId>", "App ID").option("--json", "Output as JSON").action(async (opts) => {
   try {
     const agent = getAgent(opts);
     if (!agent.isAuthenticated()) outError(opts.json, "No session. Import one: cavos session import <token>", "NoSession");
-    const config = loadConfig();
-    const network = opts.network || config.network || DEFAULT_NETWORK;
-    const tokens = network === "mainnet" ? TOKENS_MAINNET : TOKENS_SEPOLIA;
+    const tokens = TOKENS_MAINNET;
     if (opts.token) {
-      const tokenAddress = resolveToken(opts.token, network);
+      const tokenAddress = resolveToken(opts.token);
       const balance = await agent.getBalance(tokenAddress);
       out(opts.json, { status: "ok", token: opts.token, balance: formatBalance(balance), raw: balance.toString() }, () => {
         console.log(`${opts.token}: ${formatBalance(balance)}`);
@@ -1754,7 +1743,7 @@ program.command("balance").description("Show token balance").option("--token <to
     outError(opts.json, err.message);
   }
 });
-program.command("session-status").description("Show on-chain session status").option("--app-id <appId>", "App ID").option("--network <network>", "Network").option("--json", "Output as JSON").action(async (opts) => {
+program.command("session-status").description("Show on-chain session status").option("--app-id <appId>", "App ID").option("--json", "Output as JSON").action(async (opts) => {
   try {
     const agent = getAgent(opts);
     if (!agent.isAuthenticated()) outError(opts.json, "No session. Import one: cavos session import <token>", "NoSession");
@@ -1778,7 +1767,7 @@ program.command("session-status").description("Show on-chain session status").op
   }
 });
 var session = program.command("session").description("Manage agent sessions");
-session.command("import").description("Import an agent session token provisioned from the Dashboard").argument("<token>", "Base64 encoded session token").option("--app-id <appId>", "App ID to associate with this session").option("--network <network>", "Network (mainnet | sepolia)").option("--json", "Output as JSON").action((token, opts) => {
+session.command("import").description("Import an agent session token provisioned from the Dashboard").argument("<token>", "Base64 encoded session token").option("--app-id <appId>", "App ID to associate with this session").option("--json", "Output as JSON").action((token, opts) => {
   try {
     const decoded = Buffer.from(token, "base64").toString();
     const sessionData = JSON.parse(decoded);
@@ -1787,12 +1776,10 @@ session.command("import").description("Import an agent session token provisioned
     }
     const config = loadConfig();
     const appId = opts.appId || config.defaultAppId || DEFAULT_APP_ID;
-    const network = opts.network || config.network || DEFAULT_NETWORK;
     saveSession(appId, sessionData);
-    saveConfig({ defaultAppId: appId, network });
-    out(opts.json, { status: "ok", address: sessionData.walletAddress, app_id: appId, network }, () => {
+    saveConfig({ defaultAppId: appId });
+    out(opts.json, { status: "ok", address: sessionData.walletAddress, app_id: appId }, () => {
       console.log(`Session imported: ${sessionData.walletAddress}`);
-      console.log(`App ID: ${appId} | Network: ${network}`);
     });
   } catch (err) {
     if (opts.json) {
@@ -1802,7 +1789,7 @@ session.command("import").description("Import an agent session token provisioned
     }
   }
 });
-program.command("revoke-session").description("Revoke a session key (requires active session)").option("--key <sessionKey>", "Specific session key to revoke (defaults to current)").option("--app-id <appId>", "App ID").option("--network <network>", "Network").option("--json", "Output as JSON").action(async (opts) => {
+program.command("revoke-session").description("Revoke a session key (requires active session)").option("--key <sessionKey>", "Specific session key to revoke (defaults to current)").option("--app-id <appId>", "App ID").option("--json", "Output as JSON").action(async (opts) => {
   try {
     const agent = getAgent(opts);
     if (!agent.isAuthenticated()) outError(opts.json, "No session. Import one: cavos session import <token>", "NoSession");
@@ -1816,7 +1803,7 @@ program.command("revoke-session").description("Revoke a session key (requires ac
     outError(opts.json, err.message, code);
   }
 });
-program.command("emergency-revoke").description("Emergency revoke all sessions").option("--app-id <appId>", "App ID").option("--network <network>", "Network").option("--json", "Output as JSON").action(async (opts) => {
+program.command("emergency-revoke").description("Emergency revoke all sessions").option("--app-id <appId>", "App ID").option("--json", "Output as JSON").action(async (opts) => {
   try {
     const agent = getAgent(opts);
     if (!agent.isAuthenticated()) outError(opts.json, "No session. Import one: cavos session import <token>", "NoSession");