clawntenna 0.12.3 → 0.12.5

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);
 });
 ```
 
@@ -79,7 +79,8 @@ Legacy credentials at `~/.clawntenna/` are auto-migrated on first load.
 
 ```ts
 const client = new Clawntenna({
-  chain: 'base',              // 'base' | 'avalanche' | 'baseSepolia'
+  chain: 'base',              // Optional: 'base' | 'avalanche' | 'baseSepolia'
+  chainId: 8453,              // Optional alternative to `chain`
   privateKey: '0x...',        // Optional — required for write operations
   rpcUrl: '...',              // Optional — override default RPC
   registryAddress: '0x...',   // Optional — override default registry
@@ -105,9 +106,9 @@ await client.sendMessage(topicId, 'hello!', {
 // Read and decrypt recent messages
 const msgs = await client.readMessages(topicId, {
   limit: 50,        // Max messages (default 50)
-  fromBlock: -100000 // How far back to scan (default -100000)
+  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-5MUM5BAH.js}

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

package/dist/cli/{chunk-6VM633OH.js → chunk-C5RR5Q6G.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 = [
@@ -1415,21 +1426,20 @@ 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") {
     return Buffer.from(bytes).toString("base64");
@@ -3447,6 +3457,7 @@ async function withRetry(fn, options) {
 var Clawntenna = class _Clawntenna {
   provider;
   chainName;
+  historyApiKey;
   _signer;
   _address;
   _registry;
@@ -3484,12 +3495,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 +3559,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 +3589,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 +3644,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 +3693,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
@@ -4200,6 +4225,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 +4350,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 +4391,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 +4987,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-DNMI7HY4.js");
+  const { copySkillFiles } = await import("./skill-FSWNTKL5.js");
   const stateResult = initState(address);
   const skillResult = copySkillFiles();
   return { stateResult, skillResult };
@@ -5068,7 +5149,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) {

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

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

package/dist/cli/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   stateInit
-} from "./chunk-VMA7BES6.js";
+} from "./chunk-5MUM5BAH.js";
 import {
   showHeartbeat,
   showSkill,
   showSkillJson
-} from "./chunk-KDFBD47K.js";
+} from "./chunk-VCEFHKGA.js";
 import {
   REGISTRY_ABI,
   chainIdForCredentials,
@@ -16,7 +16,7 @@ import {
   output,
   outputError,
   parseCommonFlags
-} from "./chunk-6VM633OH.js";
+} from "./chunk-C5RR5Q6G.js";
 
 // src/cli/send.ts
 async function send(topicId, message, flags) {
@@ -85,9 +85,21 @@ async function read(topicId, flags) {
     } catch {
     }
   }
-  if (!json) console.log(`Reading topic ${topicId} on ${flags.chain} (last ${flags.limit} messages)...
+  if (!json) {
+    console.log(`Reading topic ${topicId} on ${flags.chain} (last ${flags.limit} messages)...
 `);
-  const messages = await client.readMessages(topicId, { limit: flags.limit });
+    const source = client.supportsIndexedHistory() ? client.getIndexedHistorySource() : null;
+    if (source) {
+      console.log(`Loading historical messages from ${source}...
+`);
+    }
+  }
+  const messages = await client.readMessages(topicId, {
+    limit: flags.limit,
+    onProgress: json ? void 0 : ({ fromBlock, toBlock, queryCount }) => {
+      console.log(`Scanning blocks ${fromBlock}-${toBlock} (${queryCount} RPC quer${queryCount === 1 ? "y" : "ies"})...`);
+    }
+  });
   if (json) {
     const agentStatus = {};
     const uniqueSenders = [...new Set(messages.map((m) => m.sender))];
@@ -108,9 +120,7 @@ async function read(topicId, flags) {
     }
     output(messages.map((m) => ({
       sender: m.sender,
-      text: m.text,
-      replyTo: m.replyTo,
-      mentions: m.mentions,
+      content: m.content,
       timestamp: m.timestamp.toString(),
       txHash: m.txHash,
       blockNumber: m.blockNumber,
@@ -124,8 +134,8 @@ async function read(topicId, flags) {
   }
   for (const msg of messages) {
     const time = new Date(Number(msg.timestamp) * 1e3).toISOString().slice(0, 19).replace("T", " ");
-    const reply = msg.replyTo ? ` (reply to ${msg.replyTo.slice(0, 10)}...)` : "";
-    console.log(`[${time}] ${msg.sender.slice(0, 8)}...: ${msg.text}${reply}`);
+    const content = typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content);
+    console.log(`[${time}] ${msg.sender.slice(0, 8)}...: ${content}`);
   }
   console.log(`
 ${messages.length} message(s) displayed.`);
@@ -907,17 +917,15 @@ async function subscribe(topicId, flags) {
         if (json) {
           console.log(JSON.stringify({
             sender: msg.sender,
-            text: msg.text,
-            replyTo: msg.replyTo,
-            mentions: msg.mentions,
+            content: msg.content,
             timestamp: msg.timestamp.toString(),
             txHash: msg.txHash,
             blockNumber: msg.blockNumber
           }));
         } else {
           const time = new Date(Number(msg.timestamp) * 1e3).toISOString().slice(0, 19).replace("T", " ");
-          const reply = msg.replyTo ? ` (reply to ${msg.replyTo.slice(0, 10)}...)` : "";
-          console.log(`[${time}] ${msg.sender.slice(0, 8)}...: ${msg.text}${reply}`);
+          const content = typeof msg.content === "string" ? msg.content : JSON.stringify(msg.content);
+          console.log(`[${time}] ${msg.sender.slice(0, 8)}...: ${content}`);
         }
       }
       lastBlock = currentBlock;
@@ -1299,7 +1307,7 @@ function decodeContractError(err) {
 }
 
 // src/cli/index.ts
-var VERSION = "0.12.3";
+var VERSION = "0.12.5";
 var HELP = `
   clawntenna v${VERSION}
   On-chain encrypted messaging for AI agents

package/dist/cli/{skill-NOMAG55P.js → skill-FSWNTKL5.js}

@@ -4,8 +4,8 @@ import {
   showHeartbeat,
   showSkill,
   showSkillJson
-} from "./chunk-KDFBD47K.js";
-import "./chunk-6VM633OH.js";
+} from "./chunk-VCEFHKGA.js";
+import "./chunk-C5RR5Q6G.js";
 export {
   copySkillFiles,
   showHeartbeat,

package/dist/cli/{state-AIF4NWKT.js → state-DNMI7HY4.js}

@@ -2,8 +2,8 @@
 import {
   initState,
   stateInit
-} from "./chunk-VMA7BES6.js";
-import "./chunk-6VM633OH.js";
+} from "./chunk-5MUM5BAH.js";
+import "./chunk-C5RR5Q6G.js";
 export {
   initState,
   stateInit