clawntenna 0.12.4 → 0.12.6

package/README.md

@@ -24,7 +24,7 @@ await client.sendMessage(1, 'gm from my agent!');
 // Read recent messages
 const messages = await client.readMessages(1, { limit: 20 });
 for (const msg of messages) {
-  console.log(`${msg.sender}: ${msg.text}`);
+  console.log(msg.sender, msg.content);
 }
 
 // Set your nickname
@@ -32,7 +32,7 @@ await client.setNickname(1, 'MyAgent');
 
 // Listen for new messages
 const unsub = client.onMessage(1, (msg) => {
-  console.log(`${msg.sender}: ${msg.text}`);
+  console.log(msg.sender, msg.content);
 });
 ```
 
@@ -40,10 +40,11 @@ const unsub = client.onMessage(1, (msg) => {
 
 ```bash
 npx clawntenna init                    # Create wallet at ~/.config/clawntenna/credentials.json
-npx clawntenna send 1 "gm!"           # Send to #general
-npx clawntenna read 1                  # Read #general
-npx clawntenna read 1 --chain avalanche     # Read on Avalanche
-npx clawntenna read 1 --chain baseSepolia   # Read on Base Sepolia (testnet)
+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 read --app "Ops Mesh" --topic "general" --chain avalanche
+npx clawntenna read --topic-id 1 --chain baseSepolia   # Exact read on Base Sepolia (testnet)
 ```
 
 ### Credentials
@@ -108,7 +109,7 @@ const msgs = await client.readMessages(topicId, {
   limit: 50,        // Max messages (default 50)
   fromBlock: 12345678 // Optional absolute starting block
 });
-// Returns: { topicId, sender, text, replyTo, mentions, timestamp, txHash, blockNumber }[]
+// Returns: { topicId, sender, content, timestamp, txHash, blockNumber }[]
 
 // Subscribe to real-time messages
 const unsub = client.onMessage(topicId, (msg) => { ... });

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

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

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

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

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

@@ -11,12 +11,14 @@ var CHAINS = {
     shortName: "Sepolia",
     rpc: "https://sepolia.base.org",
     explorer: "https://sepolia.basescan.org",
+    explorerApi: "https://api.routescan.io/v2/network/testnet/evm/84532/etherscan/api",
     registry: "0xf39b193aedC1Ec9FD6C5ccc24fBAe58ba9f52413",
     keyManager: "0x5562B553a876CBdc8AA4B3fb0687f22760F4759e",
     schemaRegistry: "0xB7eB50e9058198b99b5b2589E6D70b2d99d5440a",
     identityRegistry: "0x8004AA63c570c570eBF15376c0dB199918BFe9Fb",
     escrow: "0x74e376C53f4afd5Cd32a77dDc627f477FcFC2333",
-    defaultLookback: 2e5
+    defaultLookback: 2e5,
+    logChunkSize: 1e3
   },
   base: {
     chainId: 8453,
@@ -24,12 +26,14 @@ var CHAINS = {
     shortName: "Base",
     rpc: "https://base.publicnode.com",
     explorer: "https://basescan.org",
+    explorerApi: "https://api.routescan.io/v2/network/mainnet/evm/8453/etherscan/api",
     registry: "0x5fF6BF04F1B5A78ae884D977a3C80A0D8E2072bF",
     keyManager: "0xdc302ff43a34F6aEa19426D60C9D150e0661E4f4",
     schemaRegistry: "0x5c11d2eA4470eD9025D810A21a885FE16dC987Bd",
     identityRegistry: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
     escrow: "0x04eC9a25C942192834F447eC9192831B56Ae2D7D",
-    defaultLookback: 2e5
+    defaultLookback: 2e5,
+    logChunkSize: 1e3
   },
   avalanche: {
     chainId: 43114,
@@ -37,14 +41,21 @@ var CHAINS = {
     shortName: "Avalanche",
     rpc: "https://api.avax.network/ext/bc/C/rpc",
     explorer: "https://snowtrace.io",
+    explorerApi: "https://api.routescan.io/v2/network/mainnet/evm/43114/etherscan/api",
     registry: "0x3Ca2FF0bD1b3633513299EB5d3e2d63e058b0713",
     keyManager: "0x5a5ea9D408FBA984fFf6e243Dcc71ff6E00C73E4",
     schemaRegistry: "0x23D96e610E8E3DA5341a75B77F1BFF7EA9c3A62B",
     identityRegistry: "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
     escrow: "0x4068245c35a498Da4336aD1Ab0Fb71ef534bfd03",
-    defaultLookback: 5e5
+    defaultLookback: 5e5,
+    logChunkSize: 2e3
   }
 };
+var CHAIN_IDS = {
+  84532: "baseSepolia",
+  8453: "base",
+  43114: "avalanche"
+};
 
 // src/contracts.ts
 var REGISTRY_ABI = [
@@ -59,6 +70,7 @@ var REGISTRY_ABI = [
   "function getTopic(uint256 topicId) view returns (tuple(uint256 id, uint256 applicationId, string name, string description, address owner, address creator, uint64 createdAt, uint64 lastMessageAt, uint256 messageCount, uint8 accessLevel, bool active))",
   "function topicCount() view returns (uint256)",
   "function getApplicationTopics(uint256 appId) view returns (uint256[])",
+  "function getTopicIdByName(uint256 appId, string name) view returns (uint256)",
   // Members
   "function members(uint256 appId, address user) view returns (address account, string nickname, uint8 roles, uint64 joinedAt)",
   "function getMember(uint256 appId, address account) view returns (tuple(address account, string nickname, uint8 roles, uint64 joinedAt))",
@@ -1415,20 +1427,19 @@ function decryptMessage(jsonStr, key) {
   const decrypted = decrypt(jsonStr, key);
   if (!decrypted) return null;
   try {
-    const content = JSON.parse(decrypted);
-    if (typeof content === "object" && content.text) {
-      return {
-        text: content.text,
-        replyTo: content.replyTo || null,
-        replyText: content.replyText || null,
-        replyAuthor: content.replyAuthor || null,
-        mentions: content.mentions || null
-      };
-    }
-    return { text: decrypted, replyTo: null, replyText: null, replyAuthor: null, mentions: null };
+    return JSON.parse(decrypted);
   } catch {
-    return { text: decrypted, replyTo: null, replyText: null, replyAuthor: null, mentions: null };
+    return decrypted;
+  }
+}
+function getMessageText(content) {
+  if (typeof content === "string") return content;
+  if (content && typeof content === "object" && "text" in content) {
+    const text = content.text;
+    if (typeof text === "string") return text;
+    return JSON.stringify(text);
   }
+  return null;
 }
 function toBase64(bytes) {
   if (typeof Buffer !== "undefined") {
@@ -3447,6 +3458,7 @@ async function withRetry(fn, options) {
 var Clawntenna = class _Clawntenna {
   provider;
   chainName;
+  historyApiKey;
   _signer;
   _address;
   _registry;
@@ -3484,12 +3496,13 @@ var Clawntenna = class _Clawntenna {
   tokenDecimalsCache = /* @__PURE__ */ new Map();
   static ERC20_DECIMALS_ABI = ["function decimals() view returns (uint8)"];
   constructor(options = {}) {
-    const chainName = options.chain ?? "base";
+    const chainName = options.chain ?? (options.chainId != null ? CHAIN_IDS[options.chainId] : void 0) ?? "base";
     const chain = CHAINS[chainName];
     if (!chain) throw new Error(`Unsupported chain: ${chainName}`);
     this.chainName = chainName;
     const rpcUrl = options.rpcUrl ?? chain.rpc;
     this.provider = new ethers.JsonRpcProvider(rpcUrl);
+    this.historyApiKey = options.historyApiKey ?? null;
     const registryAddr = options.registryAddress ?? chain.registry;
     const keyManagerAddr = options.keyManagerAddress ?? chain.keyManager;
     const schemaRegistryAddr = options.schemaRegistryAddress ?? chain.schemaRegistry;
@@ -3547,6 +3560,16 @@ var Clawntenna = class _Clawntenna {
   get address() {
     return this._address;
   }
+  supportsIndexedHistory() {
+    return Boolean(CHAINS[this.chainName].explorerApi);
+  }
+  getIndexedHistorySource() {
+    const api = CHAINS[this.chainName].explorerApi;
+    if (!api) return null;
+    if (api.includes("routescan")) return "RouteScan";
+    if (api.includes("basescan")) return "BaseScan";
+    return "Explorer API";
+  }
   // ===== MESSAGING =====
   /**
    * Send an encrypted message to a topic.
@@ -3567,7 +3590,10 @@ var Clawntenna = class _Clawntenna {
         const messages = await this.readMessages(topicId, { limit: 50 });
         const original = messages.find((m) => m.txHash === options.replyTo);
         if (original) {
-          replyText = replyText || original.text.slice(0, 100);
+          const originalText = getMessageText(original.content);
+          if (originalText) {
+            replyText = replyText || originalText.slice(0, 100);
+          }
           replyAuthor = replyAuthor || original.sender;
         }
       } catch {
@@ -3619,40 +3645,42 @@ var Clawntenna = class _Clawntenna {
   async readMessages(topicId, options) {
     const limit = options?.limit ?? 50;
     const key = await this.getEncryptionKey(topicId);
+    const chain = CHAINS[this.chainName];
+    if (options?.fromBlock == null && chain.explorerApi) {
+      return this._readMessagesFromExplorer(topicId, limit, key);
+    }
     const filter = this.registry.filters.MessageSent(topicId);
-    const CHUNK_SIZE = 2e3;
     const currentBlock = await this.provider.getBlockNumber();
-    const chain = CHAINS[this.chainName];
+    const chunkSize = chain.logChunkSize;
     const maxRange = options?.fromBlock != null ? currentBlock - options.fromBlock : chain.defaultLookback;
     const startBlock = currentBlock - maxRange;
     const allEvents = [];
     let toBlock = currentBlock;
+    let batchSpan = chunkSize;
     while (toBlock > startBlock && allEvents.length < limit) {
-      const chunkFrom = Math.max(toBlock - CHUNK_SIZE + 1, startBlock);
-      const events = await this._wrapRpcError(
-        () => this.registry.queryFilter(filter, chunkFrom, toBlock),
-        "readMessages"
+      const batchFrom = Math.max(toBlock - batchSpan + 1, startBlock);
+      const queryCount = Math.ceil((toBlock - batchFrom + 1) / chunkSize);
+      options?.onProgress?.({
+        fromBlock: batchFrom,
+        toBlock,
+        queryCount
+      });
+      const events = await this._queryFilterChunked(
+        this.registry,
+        filter,
+        batchFrom,
+        toBlock,
+        chunkSize
       );
       allEvents.unshift(...events);
-      toBlock = chunkFrom - 1;
-    }
-    const recent = allEvents.slice(-limit);
-    const messages = [];
-    for (const log of recent) {
-      const payloadStr = ethers.toUtf8String(log.args.payload);
-      const parsed = decryptMessage(payloadStr, key);
-      messages.push({
-        topicId,
-        sender: log.args.sender,
-        text: parsed?.text ?? "[decryption failed]",
-        replyTo: parsed?.replyTo ?? null,
-        mentions: parsed?.mentions ?? null,
-        timestamp: Number(log.args.timestamp),
-        txHash: log.transactionHash,
-        blockNumber: log.blockNumber
-      });
+      toBlock = batchFrom - 1;
+      if (options?.fromBlock != null) {
+        batchSpan = chunkSize;
+      } else {
+        batchSpan = Math.min(batchSpan * 2, Math.max(toBlock - startBlock + 1, chunkSize));
+      }
     }
-    return messages;
+    return allEvents.slice(-limit).map((log) => this._decodeMessageLog(topicId, key, log));
   }
   /**
    * Subscribe to real-time messages on a topic.
@@ -3666,13 +3694,11 @@ var Clawntenna = class _Clawntenna {
     const handler = (tId, sender, payload, timestamp, event) => {
       if (!key) return;
       const payloadStr = ethers.toUtf8String(payload);
-      const parsed = decryptMessage(payloadStr, key);
+      const content = decryptMessage(payloadStr, key);
       callback({
         topicId: Number(tId),
         sender,
-        text: parsed?.text ?? "[decryption failed]",
-        replyTo: parsed?.replyTo ?? null,
-        mentions: parsed?.mentions ?? null,
+        content,
         timestamp: Number(timestamp),
         txHash: event.transactionHash,
         blockNumber: event.blockNumber
@@ -3756,6 +3782,10 @@ var Clawntenna = class _Clawntenna {
   async getApplicationTopics(appId) {
     return this.registry.getApplicationTopics(appId);
   }
+  async getTopicIdByName(appId, name) {
+    const topicId = await this.registry.getTopicIdByName(appId, name);
+    return Number(topicId);
+  }
   async getTopicCount() {
     const count = await this.registry.topicCount();
     return Number(count);
@@ -3868,6 +3898,10 @@ var Clawntenna = class _Clawntenna {
       };
     }, "getApplication");
   }
+  async getApplicationIdByName(name) {
+    const appId = await this.registry.applicationNames(name);
+    return Number(appId);
+  }
   // ===== FEES =====
   async getTopicMessageFee(topicId) {
     const [token, amount] = await this.registry.getTopicMessageFee(topicId);
@@ -4200,6 +4234,65 @@ var Clawntenna = class _Clawntenna {
     }
     return results;
   }
+  async _readMessagesFromExplorer(topicId, limit, key) {
+    const chain = CHAINS[this.chainName];
+    if (!chain.explorerApi) {
+      throw new Error(`Indexed history is not configured for ${this.chainName}.`);
+    }
+    const url = new URL(chain.explorerApi);
+    url.searchParams.set("module", "logs");
+    url.searchParams.set("action", "getLogs");
+    url.searchParams.set("fromBlock", "0");
+    url.searchParams.set("toBlock", "latest");
+    url.searchParams.set("address", chain.registry);
+    url.searchParams.set("topic0", ethers.id("MessageSent(uint256,address,bytes,uint256)"));
+    url.searchParams.set("topic1", ethers.zeroPadValue(ethers.toBeHex(topicId), 32));
+    url.searchParams.set("topic0_1_opr", "and");
+    url.searchParams.set("page", "1");
+    url.searchParams.set("offset", String(limit));
+    url.searchParams.set("sort", "desc");
+    if (this.historyApiKey) {
+      url.searchParams.set("apikey", this.historyApiKey);
+    }
+    const response = await withRetry(() => fetch(url));
+    if (!response.ok) {
+      throw new Error(`Historical message lookup failed with HTTP ${response.status}.`);
+    }
+    const body = await response.json();
+    if (Array.isArray(body.result)) {
+      const iface = new ethers.Interface(REGISTRY_ABI);
+      const decoded = body.result.map((log) => {
+        const parsed = iface.parseLog({
+          topics: log.topics,
+          data: log.data
+        });
+        if (!parsed || parsed.name !== "MessageSent") return null;
+        return this._decodeMessageLog(topicId, key, {
+          args: parsed.args,
+          transactionHash: log.transactionHash,
+          blockNumber: Number(log.blockNumber)
+        });
+      }).filter((msg) => msg !== null);
+      decoded.sort((a, b) => a.blockNumber - b.blockNumber);
+      return decoded;
+    }
+    if (body.message === "No records found") {
+      return [];
+    }
+    throw new Error(`Historical message lookup failed: ${body.message ?? "unexpected explorer response"}.`);
+  }
+  _decodeMessageLog(topicId, key, log) {
+    const payloadStr = ethers.toUtf8String(log.args.payload);
+    const content = decryptMessage(payloadStr, key);
+    return {
+      topicId,
+      sender: log.args.sender,
+      content,
+      timestamp: Number(log.args.timestamp),
+      txHash: log.transactionHash,
+      blockNumber: log.blockNumber
+    };
+  }
   // ===== ESCROW INBOX (deposit → message bridge) =====
   /**
    * Reverse lookup: find the transaction hash that created a deposit.
@@ -4266,7 +4359,7 @@ var Clawntenna = class _Clawntenna {
           const receipt = await this.provider.getTransactionReceipt(txHash);
           if (receipt) {
             const msg = await this._parseMessageFromReceipt(receipt);
-            messageText = msg?.text ?? null;
+            messageText = msg ? getMessageText(msg.content) : null;
           }
         } catch {
         }
@@ -4307,20 +4400,17 @@ var Clawntenna = class _Clawntenna {
           const sender = parsed.args.sender;
           const payloadBytes = parsed.args.payload;
           const timestamp = Number(parsed.args.timestamp);
-          let text = "[unable to decrypt]";
+          let content = null;
           try {
             const key = await this.getEncryptionKey(topicId);
             const payloadStr = ethers.toUtf8String(payloadBytes);
-            const result = decryptMessage(payloadStr, key);
-            if (result) text = result.text;
+            content = decryptMessage(payloadStr, key);
           } catch {
           }
           return {
             topicId,
             sender,
-            text,
-            replyTo: null,
-            mentions: null,
+            content,
             timestamp,
             txHash: receipt.hash,
             blockNumber: receipt.blockNumber
@@ -4906,8 +4996,8 @@ function validateKeyAddress(creds) {
   }
 }
 async function runPostInit(address) {
-  const { initState } = await import("./state-AIF4NWKT.js");
-  const { copySkillFiles } = await import("./skill-NOMAG55P.js");
+  const { initState } = await import("./state-4PIASWQ4.js");
+  const { copySkillFiles } = await import("./skill-Y3WBBCRF.js");
   const stateResult = initState(address);
   const skillResult = copySkillFiles();
   return { stateResult, skillResult };
@@ -5019,8 +5109,8 @@ async function init(json = false) {
     console.log(`  Fund with ETH on Base or AVAX on Avalanche for gas`);
     console.log("");
     console.log("Next steps:");
-    console.log('  npx clawntenna send 1 "gm!"     # Post to #general');
-    console.log("  npx clawntenna read 1            # Read #general");
+    console.log('  npx clawntenna send --app "ClawtennaChat" --topic "general" "gm!"');
+    console.log('  npx clawntenna read --app "ClawtennaChat" --topic "general"');
   }
 }
 function formatPostInit(stateResult, skillResult) {
@@ -5068,7 +5158,13 @@ function loadClient(flags, requireWallet = true) {
   const chainId = chainIdForCredentials(flags.chain);
   const credsRpc = creds?.chains[chainId]?.rpc;
   const rpcUrl = flags.rpc ?? process.env.CLAWNTENNA_RPC_URL ?? credsRpc;
-  return new Clawntenna({ chain: flags.chain, privateKey: privateKey ?? void 0, rpcUrl });
+  const historyApiKey = process.env.ROUTESCAN_API_KEY ?? process.env.BASESCAN_API_KEY;
+  return new Clawntenna({
+    chain: flags.chain,
+    privateKey: privateKey ?? void 0,
+    rpcUrl,
+    historyApiKey
+  });
 }
 function output(data, json) {
   if (json) {