clawntenna 0.12.7 → 0.12.9

package/dist/cli/{chunk-T4XLWYPQ.js → chunk-EOKSFPRZ.js}

@@ -3,7 +3,7 @@ import {
   CONFIG_DIR,
   loadCredentials,
   output
-} from "./chunk-7CKZWKH5.js";
+} from "./chunk-S2IWR2YO.js";
 
 // src/cli/state.ts
 import { existsSync, mkdirSync, writeFileSync } from "fs";
@@ -21,7 +21,7 @@ function initState(address) {
       startedAt: now,
       lastScanAt: now,
       mode: "active",
-      skillVersion: "0.12.7",
+      skillVersion: "0.12.9",
       lastSkillCheck: now
     },
     chains: {

package/dist/cli/{chunk-QENCMD4F.js → chunk-FDS4E5ME.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CONFIG_DIR
-} from "./chunk-7CKZWKH5.js";
+} from "./chunk-S2IWR2YO.js";
 
 // src/cli/skill.ts
 import { readFileSync, existsSync, copyFileSync, mkdirSync } from "fs";

package/dist/cli/{chunk-7CKZWKH5.js → chunk-S2IWR2YO.js}

@@ -4446,16 +4446,22 @@ var Clawntenna = class _Clawntenna {
     this.ecdhPrivateKey = privateKey;
     this.ecdhPublicKey = publicKey;
   }
+  /**
+   * Export loaded ECDH keypair as hex strings for credential persistence.
+   */
+  getECDHKeypairHex() {
+    if (!this.ecdhPrivateKey || !this.ecdhPublicKey) return null;
+    return {
+      privateKey: ethers.hexlify(this.ecdhPrivateKey),
+      publicKey: ethers.hexlify(this.ecdhPublicKey)
+    };
+  }
   /**
    * Register ECDH public key on-chain.
    */
   async registerPublicKey() {
     this.requireSigner();
     if (!this.ecdhPublicKey) throw new Error("ECDH key not derived yet");
-    const hasKey = await this.keyManager.hasPublicKey(this.requireAddress());
-    if (hasKey) {
-      throw new Error("Public key already registered on-chain");
-    }
     return this.keyManager.registerPublicKey(this.ecdhPublicKey);
   }
   /**
@@ -4996,8 +5002,8 @@ function validateKeyAddress(creds) {
   }
 }
 async function runPostInit(address) {
-  const { initState } = await import("./state-W5B24KOL.js");
-  const { copySkillFiles } = await import("./skill-NMABLUB5.js");
+  const { initState } = await import("./state-IT53LF3J.js");
+  const { copySkillFiles } = await import("./skill-CTQZ7YJE.js");
   const stateResult = initState(address);
   const skillResult = copySkillFiles();
   return { stateResult, skillResult };
@@ -5139,6 +5145,10 @@ function loadCredentials() {
   }
   return null;
 }
+function saveCredentials(credentials) {
+  mkdirSync(CONFIG_DIR, { recursive: true, mode: 448 });
+  writeFileSync(CREDS_PATH, JSON.stringify(credentials, null, 2), { mode: 384 });
+}
 
 // src/cli/util.ts
 function parseCommonFlags(flags) {
@@ -5146,7 +5156,8 @@ function parseCommonFlags(flags) {
     chain: flags.chain ?? "base",
     key: flags.key,
     rpc: flags.rpc,
-    json: flags.json === "true"
+    json: flags.json === "true",
+    force: flags.force === "true"
   };
 }
 function loadClient(flags, requireWallet = true) {
@@ -5204,7 +5215,8 @@ export {
   chainIdForCredentials,
   CONFIG_DIR,
   init,
-  loadCredentials
+  loadCredentials,
+  saveCredentials
 };
 /*! Bundled license information:
 

package/dist/cli/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   stateInit
-} from "./chunk-T4XLWYPQ.js";
+} from "./chunk-EOKSFPRZ.js";
 import {
   showHeartbeat,
   showSkill,
   showSkillJson
-} from "./chunk-QENCMD4F.js";
+} from "./chunk-FDS4E5ME.js";
 import {
   REGISTRY_ABI,
   chainIdForCredentials,
@@ -15,8 +15,9 @@ import {
   loadCredentials,
   output,
   outputError,
-  parseCommonFlags
-} from "./chunk-7CKZWKH5.js";
+  parseCommonFlags,
+  saveCredentials
+} from "./chunk-S2IWR2YO.js";
 
 // src/cli/send.ts
 async function send(topicId, message, flags) {
@@ -170,11 +171,14 @@ async function whoami(appId, flags) {
     }
   }
   const creds = loadCredentials();
-  if (creds) {
-    const chainId = chainIdForCredentials(flags.chain);
-    const chainCreds = creds.chains[chainId];
-    result.ecdhRegistered = chainCreds?.ecdh?.registered ?? false;
-  }
+  const chainId = chainIdForCredentials(flags.chain);
+  const chainCreds = creds?.chains[chainId];
+  const [ecdhRegistered, ecdhStored] = await Promise.all([
+    client.hasPublicKey(address).catch(() => false),
+    Promise.resolve(Boolean(chainCreds?.ecdh?.privateKey))
+  ]);
+  result.ecdhRegistered = ecdhRegistered;
+  result.ecdhStored = ecdhStored;
   if (json) {
     output(result, true);
   } else {
@@ -187,7 +191,9 @@ async function whoami(appId, flags) {
       console.log(`Member:   ${result.isMember}`);
       console.log(`Agent:    ${result.hasAgentIdentity}${result.agentTokenId ? ` (token #${result.agentTokenId})` : ""}`);
     }
-    console.log(`ECDH:     ${result.ecdhRegistered ? "registered" : "not registered"}`);
+    const ecdhStatus = result.ecdhRegistered ? "registered on-chain" : "not registered";
+    const ecdhStorage = result.ecdhStored ? "stored locally" : "not stored locally";
+    console.log(`ECDH:     ${ecdhStatus} (${ecdhStorage})`);
   }
 }
 
@@ -786,6 +792,13 @@ async function keysRegister(flags) {
   const creds = loadCredentials();
   const chainId = chainIdForCredentials(flags.chain);
   const ecdhCreds = creds?.chains[chainId]?.ecdh;
+  const hadExistingRegistration = await client.hasPublicKey(client.address);
+  if (hadExistingRegistration && !flags.force) {
+    outputError(
+      "ECDH public key already registered on-chain. Re-run with --force to update it. Warning: existing private-topic key grants encrypted to the old public key may need to be regranted.",
+      json
+    );
+  }
   if (ecdhCreds?.privateKey) {
     client.loadECDHKeypair(ecdhCreds.privateKey);
   } else {
@@ -795,11 +808,40 @@ async function keysRegister(flags) {
   if (!json) console.log("Registering ECDH public key on-chain...");
   const tx = await client.registerPublicKey();
   const receipt = await tx.wait();
+  const txHash = tx.hash;
+  const blockNumber = receipt?.blockNumber;
+  const registeredOnChain = true;
+  const keypair = client.getECDHKeypairHex();
+  if (creds && keypair) {
+    if (!creds.chains[chainId]) {
+      creds.chains[chainId] = {
+        name: flags.chain,
+        ecdh: null,
+        apps: {}
+      };
+    }
+    creds.chains[chainId].ecdh = {
+      privateKey: keypair.privateKey,
+      publicKey: keypair.publicKey,
+      registered: registeredOnChain
+    };
+    saveCredentials(creds);
+  }
   if (json) {
-    output({ txHash: tx.hash, blockNumber: receipt?.blockNumber, chain: flags.chain }, true);
+    output({
+      txHash,
+      blockNumber,
+      chain: flags.chain,
+      registered: registeredOnChain,
+      updated: hadExistingRegistration
+    }, true);
   } else {
-    console.log(`TX: ${tx.hash}`);
-    console.log(`Confirmed in block ${receipt?.blockNumber}`);
+    console.log(`TX: ${txHash}`);
+    console.log(`Confirmed in block ${blockNumber}`);
+    if (hadExistingRegistration) {
+      console.log("ECDH public key updated on-chain.");
+      console.log("Note: existing private-topic key grants encrypted to the old public key may need to be regranted.");
+    }
   }
 }
 async function keysCheck(address, flags) {
@@ -1372,7 +1414,7 @@ async function resolveTopicId(client, {
 }
 
 // src/cli/index.ts
-var VERSION = "0.12.7";
+var VERSION = "0.12.9";
 var HELP = `
   clawntenna v${VERSION}
   Encrypted on-chain coordination for wallets, apps, and agents
@@ -1444,7 +1486,7 @@ var HELP = `
     schema publish <schemaId> "<body>"             Publish new schema version
 
   ECDH / Private Topics:
-    keys register                                  Register ECDH public key on-chain
+    keys register [--force]                        Register ECDH public key on-chain
     keys check <address>                           Check if address has public key
     keys grant <topicId> <address>                 Grant key access to user
     keys revoke <topicId> <address>                Revoke key access
@@ -1501,14 +1543,68 @@ var HELP = `
   Docs: https://clawntenna.com/docs
 `;
 var COMMAND_HELP = {
+  init: "Usage: clawntenna init\n       Creates wallet credentials, state, and synced skill files.",
+  whoami: "Usage: clawntenna whoami [appId]\nOptions: --chain <name> --json\n       Shows wallet, balance, nickname/member/agent info, and ECDH status.",
   send: 'Usage: clawntenna send <topicId> "<message>"\n       clawntenna send --app "<app>" --topic "<topic>" "<message>"\nOptions: --reply-to <txHash> --mentions <addr,...> --no-wait --json --chain <name>',
   read: 'Usage: clawntenna read <topicId>\n       clawntenna read --app "<app>" --topic "<topic>"\nOptions: --limit <N> --json --chain <name>',
   subscribe: 'Usage: clawntenna subscribe <topicId>\n       clawntenna subscribe --app "<app>" --topic "<topic>"\nOptions: --json --chain <name>',
   "app info": 'Usage: clawntenna app info <appId>\n       clawntenna app info --app "<name>"',
   "app create": 'Usage: clawntenna app create --name "<name>" [--description "<desc>"] [--url <url>] [--public]\n       clawntenna app create "<name>" "<desc>" [--url <url>] [--public]',
+  "app update-url": 'Usage: clawntenna app update-url <appId> "<url>"',
+  "app transfer-ownership": "Usage: clawntenna app transfer-ownership <appId> <newOwner>",
+  "app accept-ownership": "Usage: clawntenna app accept-ownership <appId>",
+  "app cancel-transfer": "Usage: clawntenna app cancel-transfer <appId>",
+  "app pending-owner": "Usage: clawntenna app pending-owner <appId>",
   "topic info": 'Usage: clawntenna topic info <topicId>\n       clawntenna topic info --app "<app>" --topic "<name>"',
   "topic create": 'Usage: clawntenna topic create --app "<app>" --name "<name>" [--description "<desc>"] [--access public|limited|private]\n       clawntenna topic create <appId> "<name>" "<desc>" [--access public|limited|private]',
-  topics: 'Usage: clawntenna topics <appId>\n       clawntenna topics --app "<name>"'
+  "nickname set": 'Usage: clawntenna nickname set <appId> "<name>"',
+  "nickname get": "Usage: clawntenna nickname get <appId> <address>",
+  "nickname clear": "Usage: clawntenna nickname clear <appId>",
+  members: "Usage: clawntenna members <appId>",
+  "member info": "Usage: clawntenna member info <appId> <address>",
+  "member add": 'Usage: clawntenna member add <appId> <address> "<nick>" [--roles N]',
+  "member remove": "Usage: clawntenna member remove <appId> <address>",
+  "member roles": "Usage: clawntenna member roles <appId> <address> <roles>",
+  "permission set": "Usage: clawntenna permission set <topicId> <address> <level>",
+  "permission get": "Usage: clawntenna permission get <topicId> <address>",
+  "access check": "Usage: clawntenna access check <topicId> <address>",
+  "agent register": "Usage: clawntenna agent register <appId> <tokenId>",
+  "agent clear": "Usage: clawntenna agent clear <appId>",
+  "agent info": "Usage: clawntenna agent info <appId> <address>",
+  "schema create": 'Usage: clawntenna schema create <appId> "<name>" "<desc>" "<body>"',
+  "schema info": "Usage: clawntenna schema info <schemaId>",
+  "schema list": "Usage: clawntenna schema list <appId>",
+  "schema bind": "Usage: clawntenna schema bind <topicId> <schemaId> <version>",
+  "schema unbind": "Usage: clawntenna schema unbind <topicId>",
+  "schema topic": "Usage: clawntenna schema topic <topicId>",
+  "schema version": "Usage: clawntenna schema version <schemaId> <version>",
+  "schema publish": 'Usage: clawntenna schema publish <schemaId> "<body>"',
+  "keys register": "Usage: clawntenna keys register [--force]\n       Registers your ECDH public key. Use --force to overwrite an existing on-chain key.",
+  "keys check": "Usage: clawntenna keys check <address>",
+  "keys grant": "Usage: clawntenna keys grant <topicId> <address>",
+  "keys revoke": "Usage: clawntenna keys revoke <topicId> <address>",
+  "keys rotate": "Usage: clawntenna keys rotate <topicId>",
+  "keys has": "Usage: clawntenna keys has <topicId> <address>",
+  "keys pending": "Usage: clawntenna keys pending <topicId>",
+  topics: 'Usage: clawntenna topics <appId>\n       clawntenna topics --app "<name>"',
+  "fee topic-creation": "Usage: clawntenna fee topic-creation set <appId> <token> <amount>",
+  "fee message": "Usage: clawntenna fee message set <topicId> <token> <amount>\n       clawntenna fee message get <topicId>",
+  "escrow inbox": "Usage: clawntenna escrow inbox <topicId>",
+  "escrow enable": "Usage: clawntenna escrow enable <topicId> <timeout>",
+  "escrow disable": "Usage: clawntenna escrow disable <topicId>",
+  "escrow status": "Usage: clawntenna escrow status <topicId>",
+  "escrow deposits": "Usage: clawntenna escrow deposits <topicId>",
+  "escrow deposit": "Usage: clawntenna escrow deposit <depositId>",
+  "escrow respond": "Usage: clawntenna escrow respond <topicId> <id1> [id2...] --payload 0x...",
+  "escrow release": "Usage: clawntenna escrow release <depositId> [--ref N]",
+  "escrow release-batch": "Usage: clawntenna escrow release-batch <id1> <id2> ...",
+  "escrow refund": "Usage: clawntenna escrow refund <depositId>",
+  "escrow refund-batch": "Usage: clawntenna escrow refund-batch <id1> <id2> ...",
+  "escrow stats": "Usage: clawntenna escrow stats <address>",
+  skill: "Usage: clawntenna skill\n       Prints skill.md.",
+  heartbeat: "Usage: clawntenna heartbeat\n       Prints heartbeat.md.",
+  "skill-json": "Usage: clawntenna skill-json\n       Prints skill.json.",
+  "state init": "Usage: clawntenna state init\n       Initializes ~/.config/clawntenna/state.json."
 };
 function printCommandHelp(command, subcommand) {
   const key = subcommand ? `${command} ${subcommand}` : command;
@@ -1530,7 +1626,7 @@ function parseArgs(argv) {
         flags[key] = "true";
         i++;
       }
-    } else if (arg === "-h") {
+    } else if (arg === "-h" || arg === "help") {
       flags["help"] = "true";
       i++;
     } else if (arg === "-v") {
@@ -1546,6 +1642,15 @@ function parseArgs(argv) {
 async function main() {
   const { command, args, flags } = parseArgs(process.argv.slice(2));
   const json = flags.json === "true";
+  if (command === "help") {
+    if (args.length === 0) {
+      console.log(HELP);
+      return;
+    }
+    const subcommand = args[1];
+    printCommandHelp(args[0], subcommand);
+    return;
+  }
   if (flags.version) {
     console.log(VERSION);
     return;
@@ -1558,9 +1663,17 @@ async function main() {
   try {
     switch (command) {
       case "init":
+        if (flags.help) {
+          printCommandHelp("init");
+          return;
+        }
         await init(json);
         break;
       case "whoami": {
+        if (flags.help) {
+          printCommandHelp("whoami");
+          return;
+        }
         const appId = args[0] ? parseInt(args[0], 10) : null;
         await whoami(appId, cf);
         break;
@@ -1726,6 +1839,10 @@ async function main() {
       // --- Nicknames ---
       case "nickname": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("nickname", sub);
+          return;
+        }
         if (sub === "set") {
           const appId = parseInt(args[1], 10);
           const name = args[2];
@@ -1747,6 +1864,10 @@ async function main() {
       }
       // --- Members ---
       case "members": {
+        if (flags.help) {
+          printCommandHelp("members");
+          return;
+        }
         const appId = parseInt(args[0], 10);
         if (isNaN(appId)) outputError("Usage: clawntenna members <appId>", json);
         await membersList(appId, cf);
@@ -1754,6 +1875,10 @@ async function main() {
       }
       case "member": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("member", sub);
+          return;
+        }
         if (sub === "info") {
           const appId = parseInt(args[1], 10);
           const address = args[2];
@@ -1785,6 +1910,10 @@ async function main() {
       // --- Permissions ---
       case "permission": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("permission", sub);
+          return;
+        }
         if (sub === "set") {
           const topicId = parseInt(args[1], 10);
           const address = args[2];
@@ -1803,6 +1932,10 @@ async function main() {
       }
       case "access": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("access", sub);
+          return;
+        }
         if (sub === "check") {
           const topicId = parseInt(args[1], 10);
           const address = args[2];
@@ -1816,6 +1949,10 @@ async function main() {
       // --- Agent Identity ---
       case "agent": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("agent", sub);
+          return;
+        }
         if (sub === "register") {
           const appId = parseInt(args[1], 10);
           const tokenId = parseInt(args[2], 10);
@@ -1838,6 +1975,10 @@ async function main() {
       // --- Schemas ---
       case "schema": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("schema", sub);
+          return;
+        }
         if (sub === "create") {
           const appId = parseInt(args[1], 10);
           const name = args[2];
@@ -1885,6 +2026,10 @@ async function main() {
       // --- ECDH Keys ---
       case "keys": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("keys", sub);
+          return;
+        }
         if (sub === "register") {
           await keysRegister(cf);
         } else if (sub === "check") {
@@ -1922,6 +2067,10 @@ async function main() {
       // --- Fees ---
       case "fee": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("fee", sub);
+          return;
+        }
         if (sub === "topic-creation") {
           if (args[1] === "set") {
             const appId = parseInt(args[2], 10);
@@ -1954,6 +2103,10 @@ async function main() {
       // --- Escrow ---
       case "escrow": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("escrow", sub);
+          return;
+        }
         if (sub === "inbox") {
           const topicId = parseInt(args[1], 10);
           if (isNaN(topicId)) outputError("Usage: clawntenna escrow inbox <topicId>", json);
@@ -2014,17 +2167,33 @@ async function main() {
       }
       // --- Skill Files ---
       case "skill":
+        if (flags.help) {
+          printCommandHelp("skill");
+          return;
+        }
         showSkill(json);
         break;
       case "heartbeat":
+        if (flags.help) {
+          printCommandHelp("heartbeat");
+          return;
+        }
         showHeartbeat(json);
         break;
       case "skill-json":
+        if (flags.help) {
+          printCommandHelp("skill-json");
+          return;
+        }
         showSkillJson();
         break;
       // --- State ---
       case "state": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("state", sub);
+          return;
+        }
         if (sub === "init") {
           stateInit(json);
         } else {

package/dist/cli/{skill-NMABLUB5.js → skill-CTQZ7YJE.js}

@@ -4,8 +4,8 @@ import {
   showHeartbeat,
   showSkill,
   showSkillJson
-} from "./chunk-QENCMD4F.js";
-import "./chunk-7CKZWKH5.js";
+} from "./chunk-FDS4E5ME.js";
+import "./chunk-S2IWR2YO.js";
 export {
   copySkillFiles,
   showHeartbeat,

package/dist/cli/{state-W5B24KOL.js → state-IT53LF3J.js}

@@ -2,8 +2,8 @@
 import {
   initState,
   stateInit
-} from "./chunk-T4XLWYPQ.js";
-import "./chunk-7CKZWKH5.js";
+} from "./chunk-EOKSFPRZ.js";
+import "./chunk-S2IWR2YO.js";
 export {
   initState,
   stateInit

package/dist/index.cjs

@@ -1647,16 +1647,22 @@ var Clawntenna = class _Clawntenna {
     this.ecdhPrivateKey = privateKey;
     this.ecdhPublicKey = publicKey;
   }
+  /**
+   * Export loaded ECDH keypair as hex strings for credential persistence.
+   */
+  getECDHKeypairHex() {
+    if (!this.ecdhPrivateKey || !this.ecdhPublicKey) return null;
+    return {
+      privateKey: import_ethers.ethers.hexlify(this.ecdhPrivateKey),
+      publicKey: import_ethers.ethers.hexlify(this.ecdhPublicKey)
+    };
+  }
   /**
    * Register ECDH public key on-chain.
    */
   async registerPublicKey() {
     this.requireSigner();
     if (!this.ecdhPublicKey) throw new Error("ECDH key not derived yet");
-    const hasKey = await this.keyManager.hasPublicKey(this.requireAddress());
-    if (hasKey) {
-      throw new Error("Public key already registered on-chain");
-    }
     return this.keyManager.registerPublicKey(this.ecdhPublicKey);
   }
   /**