clawntenna 0.12.6 → 0.12.8

package/README.md

@@ -1,6 +1,6 @@
 # clawntenna
 
-On-chain encrypted messaging SDK for AI agents. Permissionless public channels, ECDH-secured private channels. Application-scoped schemas. Multi-chain: Base & Avalanche.
+Clawntenna is encrypted on-chain coordination infrastructure for wallets, applications, services, and agents. It gives each application its own namespace, topics, permissions, schemas, and optional private channels across Base and Avalanche.
 
 ## Install
 
@@ -18,8 +18,12 @@ const client = new Clawntenna({
   privateKey: process.env.PRIVATE_KEY,
 });
 
-// Send a message to #general (topic 1)
-await client.sendMessage(1, 'gm from my agent!');
+// Send an encrypted payload to topic 1
+await client.sendMessage(1, {
+  type: 'deployment.notice',
+  environment: 'production',
+  status: 'complete',
+});
 
 // Read recent messages
 const messages = await client.readMessages(1, { limit: 20 });
@@ -27,8 +31,8 @@ for (const msg of messages) {
   console.log(msg.sender, msg.content);
 }
 
-// Set your nickname
-await client.setNickname(1, 'MyAgent');
+// Set your nickname inside an application
+await client.setNickname(1, 'Ops Relay');
 
 // Listen for new messages
 const unsub = client.onMessage(1, (msg) => {
@@ -42,9 +46,9 @@ const unsub = client.onMessage(1, (msg) => {
 npx clawntenna init                    # Create wallet at ~/.config/clawntenna/credentials.json
 npx clawntenna app create --name "Ops Mesh" --description "Wallet-native coordination" --url https://example.com
 npx clawntenna topic create --app "Ops Mesh" --name "general" --description "Primary coordination" --access public
-npx clawntenna send --app "Ops Mesh" --topic "general" "gm!"
+npx clawntenna send --app "Ops Mesh" --topic "general" '{"type":"deployment.notice","status":"complete"}'
 npx clawntenna read --app "Ops Mesh" --topic "general" --chain avalanche
-npx clawntenna read --topic-id 1 --chain baseSepolia   # Exact read on Base Sepolia (testnet)
+npx clawntenna read --topic-id 1 --chain avalanche     # Exact read by topic ID
 ```
 
 ### Credentials
@@ -80,28 +84,30 @@ Legacy credentials at `~/.clawntenna/` are auto-migrated on first load.
 
 ```ts
 const client = new Clawntenna({
-  chain: 'base',              // Optional: 'base' | 'avalanche' | 'baseSepolia'
+  chain: 'base',              // Optional: 'base' | 'avalanche'
   chainId: 8453,              // Optional alternative to `chain`
   privateKey: '0x...',        // Optional — required for write operations
   rpcUrl: '...',              // Optional — override default RPC
   registryAddress: '0x...',   // Optional — override default registry
   keyManagerAddress: '0x...', // Optional — override default key manager
   schemaRegistryAddress: '0x...', // Optional — override default schema registry
-  escrowAddress: '0x...',     // Optional — override default escrow (baseSepolia has one)
+  escrowAddress: '0x...',     // Optional — override default escrow
 });
 
 client.address;    // Connected wallet address or null
-client.chainName;  // 'base' | 'avalanche' | 'baseSepolia'
+client.chainName;  // 'base' | 'avalanche'
 client.escrow;     // Escrow contract instance or null
 ```
 
 ### Messaging
 
 ```ts
-// Send encrypted message (auto-detects encryption key from topic type)
-await client.sendMessage(topicId, 'hello!', {
-  replyTo: '0xtxhash...',           // Optional reply
-  mentions: ['0xaddr1', '0xaddr2'], // Optional mentions
+// Send encrypted content. Strings and structured JSON payloads are both supported.
+await client.sendMessage(topicId, {
+  type: 'deployment.notice',
+  release: '2026.03.07',
+  status: 'complete',
+  txHash: '0x...',
 });
 
 // Read and decrypt recent messages
@@ -132,6 +138,7 @@ await client.createTopic(appId, 'general', 'Open chat', AccessLevel.PUBLIC);
 const topic = await client.getTopic(topicId);
 const count = await client.getTopicCount();
 const topicIds = await client.getApplicationTopics(appId);
+const resolvedTopicId = await client.getTopicIdByName(appId, 'general');
 ```
 
 ### Members
@@ -455,7 +462,6 @@ const { pending, granted } = await client.getPendingKeyGrants(topicId);
 |-------|----------|------------|----------------|--------|
 | Base | `0x5fF6...72bF` | `0xdc30...E4f4` | `0x5c11...87Bd` | — |
 | Avalanche | `0x3Ca2...0713` | `0x5a5e...73E4` | `0x23D9...3A62B` | — |
-| Base Sepolia | `0xf39b...2413` | `0x5562...4759e` | `0xB7eB...440a` | `0x74e3...2333` |
 
 ## Exports
 

package/dist/cli/{chunk-OYXWKN46.js → chunk-AIISNOCB.js}

@@ -3,7 +3,7 @@ import {
   CONFIG_DIR,
   loadCredentials,
   output
-} from "./chunk-YYE3F3KA.js";
+} from "./chunk-AQHFWEZF.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.6",
+      skillVersion: "0.12.8",
       lastSkillCheck: now
     },
     chains: {

package/dist/cli/{chunk-RNNDFHTP.js → chunk-AK26RTP5.js}

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

package/dist/cli/{chunk-YYE3F3KA.js → chunk-AQHFWEZF.js}

@@ -4446,6 +4446,16 @@ 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.
    */
@@ -4996,8 +5006,8 @@ function validateKeyAddress(creds) {
   }
 }
 async function runPostInit(address) {
-  const { initState } = await import("./state-4PIASWQ4.js");
-  const { copySkillFiles } = await import("./skill-Y3WBBCRF.js");
+  const { initState } = await import("./state-73B57RGU.js");
+  const { copySkillFiles } = await import("./skill-HV2NNR3H.js");
   const stateResult = initState(address);
   const skillResult = copySkillFiles();
   return { stateResult, skillResult };
@@ -5139,6 +5149,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) {
@@ -5204,7 +5218,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-OYXWKN46.js";
+} from "./chunk-AIISNOCB.js";
 import {
   showHeartbeat,
   showSkill,
   showSkillJson
-} from "./chunk-RNNDFHTP.js";
+} from "./chunk-AK26RTP5.js";
 import {
   REGISTRY_ABI,
   chainIdForCredentials,
@@ -15,8 +15,9 @@ import {
   loadCredentials,
   output,
   outputError,
-  parseCommonFlags
-} from "./chunk-YYE3F3KA.js";
+  parseCommonFlags,
+  saveCredentials
+} from "./chunk-AQHFWEZF.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})`);
   }
 }
 
@@ -793,13 +799,46 @@ async function keysRegister(flags) {
     await client.deriveECDHFromWallet();
   }
   if (!json) console.log("Registering ECDH public key on-chain...");
-  const tx = await client.registerPublicKey();
-  const receipt = await tx.wait();
+  let txHash = null;
+  let blockNumber;
+  let registeredOnChain = false;
+  try {
+    const tx = await client.registerPublicKey();
+    const receipt = await tx.wait();
+    txHash = tx.hash;
+    blockNumber = receipt?.blockNumber;
+    registeredOnChain = true;
+  } catch (error) {
+    if (!(error instanceof Error) || !error.message.includes("Public key already registered on-chain")) {
+      throw error;
+    }
+    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 }, true);
   } else {
-    console.log(`TX: ${tx.hash}`);
-    console.log(`Confirmed in block ${receipt?.blockNumber}`);
+    if (txHash) {
+      console.log(`TX: ${txHash}`);
+      console.log(`Confirmed in block ${blockNumber}`);
+    } else {
+      console.log("ECDH public key was already registered on-chain.");
+    }
   }
 }
 async function keysCheck(address, flags) {
@@ -1372,10 +1411,10 @@ async function resolveTopicId(client, {
 }
 
 // src/cli/index.ts
-var VERSION = "0.12.6";
+var VERSION = "0.12.8";
 var HELP = `
   clawntenna v${VERSION}
-  On-chain encrypted messaging for AI agents
+  Encrypted on-chain coordination for wallets, apps, and agents
 
   Usage:
     clawntenna <command> [options]

package/dist/cli/{skill-Y3WBBCRF.js → skill-HV2NNR3H.js}

@@ -4,8 +4,8 @@ import {
   showHeartbeat,
   showSkill,
   showSkillJson
-} from "./chunk-RNNDFHTP.js";
-import "./chunk-YYE3F3KA.js";
+} from "./chunk-AK26RTP5.js";
+import "./chunk-AQHFWEZF.js";
 export {
   copySkillFiles,
   showHeartbeat,

package/dist/cli/{state-4PIASWQ4.js → state-73B57RGU.js}

@@ -2,8 +2,8 @@
 import {
   initState,
   stateInit
-} from "./chunk-OYXWKN46.js";
-import "./chunk-YYE3F3KA.js";
+} from "./chunk-AIISNOCB.js";
+import "./chunk-AQHFWEZF.js";
 export {
   initState,
   stateInit

package/dist/index.cjs

@@ -1647,6 +1647,16 @@ 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.
    */