clawntenna 0.8.7 → 0.8.8

package/dist/index.cjs

@@ -27,6 +27,8 @@ __export(index_exports, {
   CHAINS: () => CHAINS,
   CHAIN_IDS: () => CHAIN_IDS,
   Clawntenna: () => Clawntenna,
+  DepositStatus: () => DepositStatus,
+  ESCROW_ABI: () => ESCROW_ABI,
   IDENTITY_REGISTRY_ABI: () => IDENTITY_REGISTRY_ABI,
   KEY_MANAGER_ABI: () => KEY_MANAGER_ABI,
   PERMISSION_ADMIN: () => PERMISSION_ADMIN,
@@ -75,7 +77,8 @@ var CHAINS = {
     registry: "0xf39b193aedC1Ec9FD6C5ccc24fBAe58ba9f52413",
     keyManager: "0x5562B553a876CBdc8AA4B3fb0687f22760F4759e",
     schemaRegistry: "0xB7eB50e9058198b99b5b2589E6D70b2d99d5440a",
-    identityRegistry: "0x8004AA63c570c570eBF15376c0dB199918BFe9Fb"
+    identityRegistry: "0x8004AA63c570c570eBF15376c0dB199918BFe9Fb",
+    escrow: "0x74e376C53f4afd5Cd32a77dDc627f477FcFC2333"
   },
   base: {
     chainId: 8453,
@@ -146,6 +149,10 @@ var REGISTRY_ABI = [
   "function appNicknameCooldown(uint256 appId) view returns (uint256)",
   // Fees
   "function getTopicMessageFee(uint256 topicId) view returns (address token, uint256 amount)",
+  "function PLATFORM_FEE_BPS() view returns (uint256)",
+  "function PLATFORM_FEE_BPS_V7() view returns (uint256)",
+  "function APP_OWNER_FEE_BPS() view returns (uint256)",
+  "function BPS_DENOMINATOR() view returns (uint256)",
   // ===== WRITE FUNCTIONS =====
   // Applications
   "function createApplication(string name, string description, string frontendUrl, bool allowPublicTopicCreation) returns (uint256)",
@@ -178,6 +185,7 @@ var REGISTRY_ABI = [
   "event TopicPermissionSet(uint256 indexed topicId, address indexed user, uint8 permission)",
   "event MessageSent(uint256 indexed topicId, address indexed sender, bytes payload, uint256 timestamp)",
   "event TopicMessageFeeUpdated(uint256 indexed topicId, address token, uint256 amount)",
+  "event FeeCollected(address indexed token, uint256 totalAmount, address indexed recipient, uint256 recipientAmount, address indexed appOwner, uint256 appOwnerAmount, uint256 platformAmount)",
   // Agent identity (V5)
   "function registerAgentIdentity(uint256 appId, uint256 tokenId)",
   "function clearAgentIdentity(uint256 appId)",
@@ -239,6 +247,31 @@ var IDENTITY_REGISTRY_ABI = [
   "function getVersion() pure returns (string)",
   "event Registered(uint256 indexed agentId, string agentURI, address indexed owner)"
 ];
+var ESCROW_ABI = [
+  // ===== READ FUNCTIONS =====
+  "function getVersion() pure returns (string)",
+  "function registry() view returns (address)",
+  "function treasury() view returns (address)",
+  "function depositCount() view returns (uint256)",
+  "function isEscrowEnabled(uint256 topicId) view returns (bool)",
+  "function topicEscrowEnabled(uint256 topicId) view returns (bool)",
+  "function topicEscrowTimeout(uint256 topicId) view returns (uint64)",
+  "function getDeposit(uint256 depositId) view returns (uint256 id, uint256 topicId, address sender, address recipient, address token, uint256 amount, address appOwner, uint64 depositedAt, uint64 timeout, uint8 status)",
+  "function getDepositStatus(uint256 depositId) view returns (uint8)",
+  "function getPendingDeposits(uint256 topicId) view returns (uint256[])",
+  "function canClaimRefund(uint256 depositId) view returns (bool)",
+  // ===== WRITE FUNCTIONS =====
+  "function enableEscrow(uint256 topicId, uint64 timeoutSeconds)",
+  "function disableEscrow(uint256 topicId)",
+  "function claimRefund(uint256 depositId)",
+  "function batchClaimRefunds(uint256[] depositIds)",
+  // ===== EVENTS =====
+  "event EscrowEnabled(uint256 indexed topicId, uint64 timeout)",
+  "event EscrowDisabled(uint256 indexed topicId)",
+  "event DepositRecorded(uint256 indexed depositId, uint256 indexed topicId, address indexed sender, uint256 amount)",
+  "event DepositReleased(uint256 indexed depositId, uint256 indexed topicId, uint256 recipientAmount, uint256 appOwnerAmount, uint256 platformAmount)",
+  "event DepositRefunded(uint256 indexed depositId, uint256 indexed topicId, address indexed sender, uint256 amount)"
+];
 var KEY_MANAGER_ABI = [
   // ===== READ FUNCTIONS =====
   "function hasPublicKey(address user) view returns (bool)",
@@ -293,6 +326,12 @@ var Role = /* @__PURE__ */ ((Role2) => {
   Role2[Role2["OWNER_DELEGATE"] = 16] = "OWNER_DELEGATE";
   return Role2;
 })(Role || {});
+var DepositStatus = /* @__PURE__ */ ((DepositStatus2) => {
+  DepositStatus2[DepositStatus2["Pending"] = 0] = "Pending";
+  DepositStatus2[DepositStatus2["Released"] = 1] = "Released";
+  DepositStatus2[DepositStatus2["Refunded"] = 2] = "Refunded";
+  return DepositStatus2;
+})(DepositStatus || {});
 
 // src/constants.ts
 var ACCESS_PUBLIC = 0 /* PUBLIC */;
@@ -466,6 +505,7 @@ var Clawntenna = class {
   keyManager;
   schemaRegistry;
   identityRegistry;
+  escrow;
   chainName;
   // In-memory ECDH state
   ecdhPrivateKey = null;
@@ -481,12 +521,15 @@ var Clawntenna = class {
     const registryAddr = options.registryAddress ?? chain.registry;
     const keyManagerAddr = options.keyManagerAddress ?? chain.keyManager;
     const schemaRegistryAddr = options.schemaRegistryAddress ?? chain.schemaRegistry;
-    if (options.privateKey) {
-      this.wallet = new import_ethers.ethers.Wallet(options.privateKey, this.provider);
-      this.registry = new import_ethers.ethers.Contract(registryAddr, REGISTRY_ABI, this.wallet);
-      this.keyManager = new import_ethers.ethers.Contract(keyManagerAddr, KEY_MANAGER_ABI, this.wallet);
-      this.schemaRegistry = new import_ethers.ethers.Contract(schemaRegistryAddr, SCHEMA_REGISTRY_ABI, this.wallet);
-      this.identityRegistry = chain.identityRegistry ? new import_ethers.ethers.Contract(chain.identityRegistry, IDENTITY_REGISTRY_ABI, this.wallet) : null;
+    const escrowAddr = options.escrowAddress ?? chain.escrow;
+    const signer = options.privateKey ? new import_ethers.ethers.Wallet(options.privateKey, this.provider) : null;
+    const runner = signer ?? this.provider;
+    if (signer) {
+      this.wallet = signer;
+      this.registry = new import_ethers.ethers.Contract(registryAddr, REGISTRY_ABI, signer);
+      this.keyManager = new import_ethers.ethers.Contract(keyManagerAddr, KEY_MANAGER_ABI, signer);
+      this.schemaRegistry = new import_ethers.ethers.Contract(schemaRegistryAddr, SCHEMA_REGISTRY_ABI, signer);
+      this.identityRegistry = chain.identityRegistry ? new import_ethers.ethers.Contract(chain.identityRegistry, IDENTITY_REGISTRY_ABI, signer) : null;
     } else {
       this.wallet = null;
       this.registry = new import_ethers.ethers.Contract(registryAddr, REGISTRY_ABI, this.provider);
@@ -494,6 +537,7 @@ var Clawntenna = class {
       this.schemaRegistry = new import_ethers.ethers.Contract(schemaRegistryAddr, SCHEMA_REGISTRY_ABI, this.provider);
       this.identityRegistry = chain.identityRegistry ? new import_ethers.ethers.Contract(chain.identityRegistry, IDENTITY_REGISTRY_ABI, this.provider) : null;
     }
+    this.escrow = escrowAddr ? new import_ethers.ethers.Contract(escrowAddr, ESCROW_ABI, runner) : null;
   }
   get address() {
     return this.wallet?.address ?? null;
@@ -505,6 +549,12 @@ var Clawntenna = class {
    */
   async sendMessage(topicId, text, options) {
     if (!this.wallet) throw new Error("Wallet required to send messages");
+    if (options?.replyTo && this.escrow && !options?.skipRefundCheck) {
+      const refunded = await this.isMessageRefunded(options.replyTo);
+      if (refunded) {
+        throw new Error(`Cannot reply: escrow deposit was refunded (tx: ${options.replyTo})`);
+      }
+    }
     let replyText = options?.replyText;
     let replyAuthor = options?.replyAuthor;
     if (options?.replyTo && (!replyText || !replyAuthor)) {
@@ -733,6 +783,132 @@ var Clawntenna = class {
     if (!this.wallet) throw new Error("Wallet required");
     return this.registry.setTopicMessageFee(topicId, feeToken, feeAmount);
   }
+  // ===== ESCROW =====
+  requireEscrow() {
+    if (!this.escrow) {
+      throw new Error("Escrow not available on this chain. Use baseSepolia or pass escrowAddress.");
+    }
+    return this.escrow;
+  }
+  /**
+   * Enable escrow for a topic (topic owner only).
+   */
+  async enableEscrow(topicId, timeout) {
+    if (!this.wallet) throw new Error("Wallet required");
+    return this.requireEscrow().enableEscrow(topicId, timeout);
+  }
+  /**
+   * Disable escrow for a topic (topic owner only).
+   */
+  async disableEscrow(topicId) {
+    if (!this.wallet) throw new Error("Wallet required");
+    return this.requireEscrow().disableEscrow(topicId);
+  }
+  /**
+   * Check if escrow is enabled for a topic.
+   */
+  async isEscrowEnabled(topicId) {
+    return this.requireEscrow().isEscrowEnabled(topicId);
+  }
+  /**
+   * Get escrow config for a topic (enabled + timeout).
+   */
+  async getEscrowConfig(topicId) {
+    const escrow = this.requireEscrow();
+    const [enabled, timeout] = await Promise.all([
+      escrow.isEscrowEnabled(topicId),
+      escrow.topicEscrowTimeout(topicId)
+    ]);
+    return { enabled, timeout };
+  }
+  /**
+   * Get full deposit details by ID.
+   */
+  async getDeposit(depositId) {
+    const d = await this.requireEscrow().getDeposit(depositId);
+    return {
+      id: d.id,
+      topicId: d.topicId,
+      sender: d.sender,
+      recipient: d.recipient,
+      token: d.token,
+      amount: d.amount,
+      appOwner: d.appOwner,
+      depositedAt: d.depositedAt,
+      timeout: d.timeout,
+      status: Number(d.status)
+    };
+  }
+  /**
+   * Get deposit status (0=Pending, 1=Released, 2=Refunded).
+   */
+  async getDepositStatus(depositId) {
+    const status = await this.requireEscrow().getDepositStatus(depositId);
+    return Number(status);
+  }
+  /**
+   * Get pending deposit IDs for a topic.
+   */
+  async getPendingDeposits(topicId) {
+    return this.requireEscrow().getPendingDeposits(topicId);
+  }
+  /**
+   * Check if a deposit can be refunded (timeout expired and still pending).
+   */
+  async canClaimRefund(depositId) {
+    return this.requireEscrow().canClaimRefund(depositId);
+  }
+  /**
+   * Claim a refund for a single deposit.
+   */
+  async claimRefund(depositId) {
+    if (!this.wallet) throw new Error("Wallet required");
+    return this.requireEscrow().claimRefund(depositId);
+  }
+  /**
+   * Batch claim refunds for multiple deposits.
+   */
+  async batchClaimRefunds(depositIds) {
+    if (!this.wallet) throw new Error("Wallet required");
+    return this.requireEscrow().batchClaimRefunds(depositIds);
+  }
+  /**
+   * 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).
+   */
+  async getMessageDepositId(txHash) {
+    if (!this.escrow) return null;
+    const receipt = await this.provider.getTransactionReceipt(txHash);
+    if (!receipt) return null;
+    const iface = this.escrow.interface;
+    for (const log of receipt.logs) {
+      try {
+        const parsed = iface.parseLog(log);
+        if (parsed?.name === "DepositRecorded") {
+          return parsed.args.depositId;
+        }
+      } catch {
+      }
+    }
+    return null;
+  }
+  /**
+   * Get the deposit status for a message by its transaction hash.
+   * Returns null if the message has no associated escrow deposit.
+   */
+  async getMessageDepositStatus(txHash) {
+    const depositId = await this.getMessageDepositId(txHash);
+    if (depositId === null) return null;
+    return this.getDepositStatus(Number(depositId));
+  }
+  /**
+   * Check if a message's escrow deposit was refunded.
+   * Returns false if no escrow deposit exists for the tx.
+   */
+  async isMessageRefunded(txHash) {
+    const status = await this.getMessageDepositStatus(txHash);
+    return status === 2 /* Refunded */;
+  }
   // ===== ECDH (Private Topics) =====
   /**
    * Derive ECDH keypair from wallet signature (deterministic).
@@ -1250,6 +1426,8 @@ var Clawntenna = class {
   CHAINS,
   CHAIN_IDS,
   Clawntenna,
+  DepositStatus,
+  ESCROW_ABI,
   IDENTITY_REGISTRY_ABI,
   KEY_MANAGER_ABI,
   PERMISSION_ADMIN,