clawntenna 0.11.1 → 0.11.2

package/dist/cli/index.js

@@ -216,7 +216,14 @@ var ESCROW_ABI = [
   "event DepositRefunded(uint256 indexed depositId, uint256 indexed topicId, address indexed sender, uint256 amount)",
   // V3
   "event DepositReleasedByOwner(uint256 indexed depositId, uint256 indexed topicId, address indexed releasedBy, uint256 messageRef)",
-  "event DepositResponseRecorded(uint256 indexed depositId, uint256 indexed topicId, address indexed respondedBy)"
+  "event DepositResponseRecorded(uint256 indexed depositId, uint256 indexed topicId, address indexed respondedBy)",
+  // V4 — on-chain accumulators + credibility
+  "function getRecipientStats(address wallet) view returns (tuple(uint64 depositsReceived, uint64 depositsReleased, uint64 depositsRefunded, uint64 depositsExpired))",
+  "function getResponseRate(address wallet) view returns (uint256)",
+  "function getCredibility(address wallet) view returns (uint256 responseRate, uint64 depositsReceived, uint64 depositsReleased, uint64 depositsRefunded, uint256 totalEarned, uint256 totalRefunded)",
+  "function amountEarned(address wallet) view returns (uint256)",
+  "function amountRefunded(address wallet) view returns (uint256)",
+  "event RecipientStatsUpdated(address indexed wallet, uint64 received, uint64 released, uint64 refunded)"
 ];
 var KEY_MANAGER_ABI = [
   // ===== READ FUNCTIONS =====
@@ -3970,6 +3977,63 @@ var Clawntenna = class _Clawntenna {
   async hasResponse(depositId) {
     return this.requireEscrow().hasResponse(depositId);
   }
+  /**
+   * Get lifetime escrow stats for a wallet (V4).
+   */
+  async getRecipientStats(wallet) {
+    const s = await this.requireEscrow().getRecipientStats(wallet);
+    return {
+      depositsReceived: BigInt(s.depositsReceived),
+      depositsReleased: BigInt(s.depositsReleased),
+      depositsRefunded: BigInt(s.depositsRefunded),
+      depositsExpired: BigInt(s.depositsExpired)
+    };
+  }
+  /**
+   * Get credibility snapshot for a wallet (V4).
+   * Returns response rate as 0-100 percentage and lifetime escrow totals.
+   */
+  async getWalletCredibility(wallet) {
+    const escrow = this.requireEscrow();
+    const cred = await escrow.getCredibility(wallet);
+    const responseRate = Number(cred.responseRate) / 100;
+    let formattedEarned = null;
+    let formattedRefunded = null;
+    try {
+      formattedEarned = ethers.formatEther(cred.totalEarned);
+      formattedRefunded = ethers.formatEther(cred.totalRefunded);
+    } catch {
+    }
+    return {
+      responseRate,
+      depositsReceived: BigInt(cred.depositsReceived),
+      depositsReleased: BigInt(cred.depositsReleased),
+      depositsRefunded: BigInt(cred.depositsRefunded),
+      totalEarned: BigInt(cred.totalEarned),
+      totalRefunded: BigInt(cred.totalRefunded),
+      formattedEarned,
+      formattedRefunded
+    };
+  }
+  /**
+   * Get the on-chain total amount earned by a wallet via escrow releases (V4).
+   */
+  async getAmountEarned(wallet) {
+    return this.requireEscrow().amountEarned(wallet);
+  }
+  /**
+   * Get the on-chain total amount lost to refunds for a wallet (V4).
+   */
+  async getAmountRefunded(wallet) {
+    return this.requireEscrow().amountRefunded(wallet);
+  }
+  /**
+   * Get response rate for a wallet as basis points (0-10000) (V4).
+   */
+  async getResponseRate(wallet) {
+    const rate = await this.requireEscrow().getResponseRate(wallet);
+    return Number(rate);
+  }
   /**
    * Parse a transaction receipt to extract the depositId from a DepositRecorded event.
    * Returns null if no DepositRecorded event is found (e.g. no escrow on this tx).
@@ -4026,6 +4090,22 @@ var Clawntenna = class _Clawntenna {
       canClaim
     };
   }
+  // ===== PRIVATE HELPERS =====
+  /**
+   * Query contract events in chunked ranges to stay within public RPC limits.
+   */
+  async _queryFilterChunked(contract, filter, fromBlock, toBlock, chunkSize = 1e4) {
+    const results = [];
+    for (let start = fromBlock; start <= toBlock; start += chunkSize) {
+      const end = Math.min(start + chunkSize - 1, toBlock);
+      const chunk = await this._wrapRpcError(
+        () => contract.queryFilter(filter, start, end),
+        "queryFilterChunked"
+      );
+      results.push(...chunk);
+    }
+    return results;
+  }
   // ===== ESCROW INBOX (deposit → message bridge) =====
   /**
    * Reverse lookup: find the transaction hash that created a deposit.
@@ -4037,10 +4117,7 @@ var Clawntenna = class _Clawntenna {
     const currentBlock = await this.provider.getBlockNumber();
     const startBlock = currentBlock - chain.defaultLookback;
     const filter = escrow.filters.DepositRecorded(depositId);
-    const events = await this._wrapRpcError(
-      () => escrow.queryFilter(filter, startBlock, currentBlock),
-      "getDepositTxHash"
-    );
+    const events = await this._queryFilterChunked(escrow, filter, startBlock, currentBlock);
     if (events.length === 0) return null;
     return events[0].transactionHash;
   }
@@ -4072,10 +4149,7 @@ var Clawntenna = class _Clawntenna {
     const currentBlock = await this.provider.getBlockNumber();
     const startBlock = currentBlock - chain.defaultLookback;
     const topicFilter = escrow.filters.DepositRecorded(null, topicId);
-    const events = await this._wrapRpcError(
-      () => escrow.queryFilter(topicFilter, startBlock, currentBlock),
-      "getEscrowInbox"
-    );
+    const events = await this._queryFilterChunked(escrow, topicFilter, startBlock, currentBlock);
     const txHashMap = /* @__PURE__ */ new Map();
     for (const evt of events) {
       const id = evt.args.depositId.toString();
@@ -5966,6 +6040,35 @@ Topic #${topicId} inbox (${inbox.length} pending):
     console.log();
   }
 }
+async function escrowStats(address, flags) {
+  const client = loadClient(flags, false);
+  const json = flags.json ?? false;
+  const cred = await client.getWalletCredibility(address);
+  if (json) {
+    output({
+      address,
+      responseRate: cred.responseRate,
+      depositsReceived: cred.depositsReceived.toString(),
+      depositsReleased: cred.depositsReleased.toString(),
+      depositsRefunded: cred.depositsRefunded.toString(),
+      totalEarned: cred.totalEarned.toString(),
+      totalRefunded: cred.totalRefunded.toString(),
+      formattedEarned: cred.formattedEarned,
+      formattedRefunded: cred.formattedRefunded
+    }, true);
+    return;
+  }
+  const shortAddr = address.slice(0, 6) + "..." + address.slice(-4);
+  console.log(`
+Escrow stats for ${shortAddr}:
+`);
+  console.log(`  Response rate:     ${cred.responseRate.toFixed(1)}%`);
+  console.log(`  Deposits received: ${cred.depositsReceived}`);
+  console.log(`  Released: ${cred.depositsReleased}  |  Refunded: ${cred.depositsRefunded}`);
+  console.log(`  Total earned:      ${cred.formattedEarned ?? cred.totalEarned.toString()} ETH`);
+  console.log(`  Total refunded:    ${cred.formattedRefunded ?? cred.totalRefunded.toString()} ETH`);
+  console.log();
+}
 function formatAgo(epochSeconds) {
   const diff = Math.floor(Date.now() / 1e3) - epochSeconds;
   if (diff < 60) return `${diff}s ago`;
@@ -6024,7 +6127,7 @@ function decodeContractError(err) {
 }
 
 // src/cli/index.ts
-var VERSION = "0.11.1";
+var VERSION = "0.11.2";
 var HELP = `
   clawntenna v${VERSION}
   On-chain encrypted messaging for AI agents
@@ -6108,6 +6211,7 @@ var HELP = `
     escrow respond <topicId> <id1> [id2...] --payload 0x  Respond to deposits (topic owner)
     escrow release <depositId> [--ref N]            Release deposit (topic owner)
     escrow release-batch <id1> <id2> ...           Batch release deposits
+    escrow stats <address>                         Show wallet credibility & escrow stats
     escrow refund <depositId>                      Claim refund
     escrow refund-batch <id1> <id2> ...            Batch refund
 
@@ -6537,8 +6641,12 @@ async function main() {
           const ids = args.slice(1).map((a) => parseInt(a, 10));
           if (ids.length === 0 || ids.some(isNaN)) outputError("Usage: clawntenna escrow refund-batch <id1> <id2> ...", json);
           await escrowRefundBatch(ids, cf);
+        } else if (sub === "stats") {
+          const address = args[1];
+          if (!address) outputError("Usage: clawntenna escrow stats <address>", json);
+          await escrowStats(address, cf);
         } else {
-          outputError(`Unknown escrow subcommand: ${sub}. Use: inbox, enable, disable, status, deposits, deposit, respond, release, release-batch, refund, refund-batch`, json);
+          outputError(`Unknown escrow subcommand: ${sub}. Use: inbox, enable, disable, status, stats, deposits, deposit, respond, release, release-batch, refund, refund-batch`, json);
         }
         break;
       }

package/dist/index.cjs

@@ -302,7 +302,14 @@ var ESCROW_ABI = [
   "event DepositRefunded(uint256 indexed depositId, uint256 indexed topicId, address indexed sender, uint256 amount)",
   // V3
   "event DepositReleasedByOwner(uint256 indexed depositId, uint256 indexed topicId, address indexed releasedBy, uint256 messageRef)",
-  "event DepositResponseRecorded(uint256 indexed depositId, uint256 indexed topicId, address indexed respondedBy)"
+  "event DepositResponseRecorded(uint256 indexed depositId, uint256 indexed topicId, address indexed respondedBy)",
+  // V4 — on-chain accumulators + credibility
+  "function getRecipientStats(address wallet) view returns (tuple(uint64 depositsReceived, uint64 depositsReleased, uint64 depositsRefunded, uint64 depositsExpired))",
+  "function getResponseRate(address wallet) view returns (uint256)",
+  "function getCredibility(address wallet) view returns (uint256 responseRate, uint64 depositsReceived, uint64 depositsReleased, uint64 depositsRefunded, uint256 totalEarned, uint256 totalRefunded)",
+  "function amountEarned(address wallet) view returns (uint256)",
+  "function amountRefunded(address wallet) view returns (uint256)",
+  "event RecipientStatsUpdated(address indexed wallet, uint64 received, uint64 released, uint64 refunded)"
 ];
 var KEY_MANAGER_ABI = [
   // ===== READ FUNCTIONS =====
@@ -1170,6 +1177,63 @@ var Clawntenna = class _Clawntenna {
   async hasResponse(depositId) {
     return this.requireEscrow().hasResponse(depositId);
   }
+  /**
+   * Get lifetime escrow stats for a wallet (V4).
+   */
+  async getRecipientStats(wallet) {
+    const s = await this.requireEscrow().getRecipientStats(wallet);
+    return {
+      depositsReceived: BigInt(s.depositsReceived),
+      depositsReleased: BigInt(s.depositsReleased),
+      depositsRefunded: BigInt(s.depositsRefunded),
+      depositsExpired: BigInt(s.depositsExpired)
+    };
+  }
+  /**
+   * Get credibility snapshot for a wallet (V4).
+   * Returns response rate as 0-100 percentage and lifetime escrow totals.
+   */
+  async getWalletCredibility(wallet) {
+    const escrow = this.requireEscrow();
+    const cred = await escrow.getCredibility(wallet);
+    const responseRate = Number(cred.responseRate) / 100;
+    let formattedEarned = null;
+    let formattedRefunded = null;
+    try {
+      formattedEarned = import_ethers.ethers.formatEther(cred.totalEarned);
+      formattedRefunded = import_ethers.ethers.formatEther(cred.totalRefunded);
+    } catch {
+    }
+    return {
+      responseRate,
+      depositsReceived: BigInt(cred.depositsReceived),
+      depositsReleased: BigInt(cred.depositsReleased),
+      depositsRefunded: BigInt(cred.depositsRefunded),
+      totalEarned: BigInt(cred.totalEarned),
+      totalRefunded: BigInt(cred.totalRefunded),
+      formattedEarned,
+      formattedRefunded
+    };
+  }
+  /**
+   * Get the on-chain total amount earned by a wallet via escrow releases (V4).
+   */
+  async getAmountEarned(wallet) {
+    return this.requireEscrow().amountEarned(wallet);
+  }
+  /**
+   * Get the on-chain total amount lost to refunds for a wallet (V4).
+   */
+  async getAmountRefunded(wallet) {
+    return this.requireEscrow().amountRefunded(wallet);
+  }
+  /**
+   * Get response rate for a wallet as basis points (0-10000) (V4).
+   */
+  async getResponseRate(wallet) {
+    const rate = await this.requireEscrow().getResponseRate(wallet);
+    return Number(rate);
+  }
   /**
    * Parse a transaction receipt to extract the depositId from a DepositRecorded event.
    * Returns null if no DepositRecorded event is found (e.g. no escrow on this tx).
@@ -1226,6 +1290,22 @@ var Clawntenna = class _Clawntenna {
       canClaim
     };
   }
+  // ===== PRIVATE HELPERS =====
+  /**
+   * Query contract events in chunked ranges to stay within public RPC limits.
+   */
+  async _queryFilterChunked(contract, filter, fromBlock, toBlock, chunkSize = 1e4) {
+    const results = [];
+    for (let start = fromBlock; start <= toBlock; start += chunkSize) {
+      const end = Math.min(start + chunkSize - 1, toBlock);
+      const chunk = await this._wrapRpcError(
+        () => contract.queryFilter(filter, start, end),
+        "queryFilterChunked"
+      );
+      results.push(...chunk);
+    }
+    return results;
+  }
   // ===== ESCROW INBOX (deposit → message bridge) =====
   /**
    * Reverse lookup: find the transaction hash that created a deposit.
@@ -1237,10 +1317,7 @@ var Clawntenna = class _Clawntenna {
     const currentBlock = await this.provider.getBlockNumber();
     const startBlock = currentBlock - chain.defaultLookback;
     const filter = escrow.filters.DepositRecorded(depositId);
-    const events = await this._wrapRpcError(
-      () => escrow.queryFilter(filter, startBlock, currentBlock),
-      "getDepositTxHash"
-    );
+    const events = await this._queryFilterChunked(escrow, filter, startBlock, currentBlock);
     if (events.length === 0) return null;
     return events[0].transactionHash;
   }
@@ -1272,10 +1349,7 @@ var Clawntenna = class _Clawntenna {
     const currentBlock = await this.provider.getBlockNumber();
     const startBlock = currentBlock - chain.defaultLookback;
     const topicFilter = escrow.filters.DepositRecorded(null, topicId);
-    const events = await this._wrapRpcError(
-      () => escrow.queryFilter(topicFilter, startBlock, currentBlock),
-      "getEscrowInbox"
-    );
+    const events = await this._queryFilterChunked(escrow, topicFilter, startBlock, currentBlock);
     const txHashMap = /* @__PURE__ */ new Map();
     for (const evt of events) {
       const id = evt.args.depositId.toString();