clawntenna 0.8.7 → 0.8.8

package/dist/index.d.cts

@@ -29,6 +29,7 @@ interface ChainConfig {
     keyManager: string;
     schemaRegistry: string;
     identityRegistry?: string;
+    escrow?: string;
 }
 type ChainName = 'base' | 'avalanche' | 'baseSepolia';
 interface Application {
@@ -114,6 +115,27 @@ interface TopicSchemaBinding {
     version: number;
     body: string;
 }
+declare enum DepositStatus {
+    Pending = 0,
+    Released = 1,
+    Refunded = 2
+}
+interface EscrowDeposit {
+    id: bigint;
+    topicId: bigint;
+    sender: string;
+    recipient: string;
+    token: string;
+    amount: bigint;
+    appOwner: string;
+    depositedAt: bigint;
+    timeout: bigint;
+    status: DepositStatus;
+}
+interface EscrowConfig {
+    enabled: boolean;
+    timeout: bigint;
+}
 interface ClawtennaOptions {
     chain?: ChainName;
     chainId?: number;
@@ -122,6 +144,7 @@ interface ClawtennaOptions {
     registryAddress?: string;
     keyManagerAddress?: string;
     schemaRegistryAddress?: string;
+    escrowAddress?: string;
 }
 interface ReadOptions {
     limit?: number;
@@ -132,6 +155,7 @@ interface SendOptions {
     replyText?: string;
     replyAuthor?: string;
     mentions?: string[];
+    skipRefundCheck?: boolean;
 }
 interface Credentials {
     version: 2;
@@ -180,6 +204,7 @@ declare class Clawntenna {
     readonly keyManager: ethers.Contract;
     readonly schemaRegistry: ethers.Contract;
     readonly identityRegistry: ethers.Contract | null;
+    readonly escrow: ethers.Contract | null;
     readonly chainName: ChainName;
     private ecdhPrivateKey;
     private ecdhPublicKey;
@@ -231,6 +256,62 @@ declare class Clawntenna {
     getTopicMessageFee(topicId: number): Promise<TopicMessageFee>;
     setTopicCreationFee(appId: number, feeToken: string, feeAmount: bigint): Promise<ethers.TransactionResponse>;
     setTopicMessageFee(topicId: number, feeToken: string, feeAmount: bigint): Promise<ethers.TransactionResponse>;
+    private requireEscrow;
+    /**
+     * Enable escrow for a topic (topic owner only).
+     */
+    enableEscrow(topicId: number, timeout: number): Promise<ethers.TransactionResponse>;
+    /**
+     * Disable escrow for a topic (topic owner only).
+     */
+    disableEscrow(topicId: number): Promise<ethers.TransactionResponse>;
+    /**
+     * Check if escrow is enabled for a topic.
+     */
+    isEscrowEnabled(topicId: number): Promise<boolean>;
+    /**
+     * Get escrow config for a topic (enabled + timeout).
+     */
+    getEscrowConfig(topicId: number): Promise<EscrowConfig>;
+    /**
+     * Get full deposit details by ID.
+     */
+    getDeposit(depositId: number): Promise<EscrowDeposit>;
+    /**
+     * Get deposit status (0=Pending, 1=Released, 2=Refunded).
+     */
+    getDepositStatus(depositId: number): Promise<DepositStatus>;
+    /**
+     * Get pending deposit IDs for a topic.
+     */
+    getPendingDeposits(topicId: number): Promise<bigint[]>;
+    /**
+     * Check if a deposit can be refunded (timeout expired and still pending).
+     */
+    canClaimRefund(depositId: number): Promise<boolean>;
+    /**
+     * Claim a refund for a single deposit.
+     */
+    claimRefund(depositId: number): Promise<ethers.TransactionResponse>;
+    /**
+     * Batch claim refunds for multiple deposits.
+     */
+    batchClaimRefunds(depositIds: number[]): Promise<ethers.TransactionResponse>;
+    /**
+     * 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).
+     */
+    getMessageDepositId(txHash: string): Promise<bigint | null>;
+    /**
+     * Get the deposit status for a message by its transaction hash.
+     * Returns null if the message has no associated escrow deposit.
+     */
+    getMessageDepositStatus(txHash: string): Promise<DepositStatus | null>;
+    /**
+     * Check if a message's escrow deposit was refunded.
+     * Returns false if no escrow deposit exists for the tx.
+     */
+    isMessageRefunded(txHash: string): Promise<boolean>;
     /**
      * Derive ECDH keypair from wallet signature (deterministic).
      * Requires a signer capable of signing messages.
@@ -485,9 +566,10 @@ declare const ROLE_TOPIC_MANAGER = Role.TOPIC_MANAGER;
 declare const ROLE_ADMIN = Role.ADMIN;
 declare const ROLE_OWNER_DELEGATE = Role.OWNER_DELEGATE;
 
-declare const REGISTRY_ABI: readonly ["function applications(uint256) view returns (uint256 id, string name, string description, string frontendUrl, address owner, uint64 createdAt, uint32 memberCount, uint32 topicCount, bool active, bool allowPublicTopicCreation)", "function getApplication(uint256 appId) view returns (tuple(uint256 id, string name, string description, string frontendUrl, address owner, uint64 createdAt, uint32 memberCount, uint32 topicCount, bool active, bool allowPublicTopicCreation, address topicCreationFeeToken, uint256 topicCreationFeeAmount))", "function applicationCount() view returns (uint256)", "function applicationNames(string) view returns (uint256)", "function topics(uint256) view returns (uint256 id, uint256 applicationId, string name, string description, address owner, address creator, uint64 createdAt, uint64 lastMessageAt, uint256 messageCount, uint8 accessLevel, bool active)", "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 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))", "function isMember(uint256 appId, address account) view returns (bool)", "function getApplicationMembers(uint256 appId) view returns (address[])", "function canReadTopic(uint256 topicId, address user) view returns (bool)", "function canWriteToTopic(uint256 topicId, address user) view returns (bool)", "function getTopicPermission(uint256 topicId, address user) view returns (uint8)", "function topicPermissions(uint256, address) view returns (uint8)", "function getNickname(uint256 appId, address user) view returns (string)", "function hasNickname(uint256 appId, address user) view returns (bool)", "function canChangeNickname(uint256 appId, address user) view returns (bool canChange, uint256 timeRemaining)", "function appNicknameCooldown(uint256 appId) view returns (uint256)", "function getTopicMessageFee(uint256 topicId) view returns (address token, uint256 amount)", "function createApplication(string name, string description, string frontendUrl, bool allowPublicTopicCreation) returns (uint256)", "function updateApplicationFrontendUrl(uint256 appId, string frontendUrl)", "function createTopic(uint256 appId, string name, string description, uint8 accessLevel) returns (uint256)", "function setTopicPermission(uint256 topicId, address user, uint8 permission)", "function addMember(uint256 appId, address member, string nickname, uint8 roles)", "function removeMember(uint256 appId, address member)", "function updateMemberRoles(uint256 appId, address member, uint8 roles)", "function updateMemberNickname(uint256 appId, string nickname)", "function setNickname(uint256 appId, string nickname)", "function clearNickname(uint256 appId)", "function setNicknameCooldown(uint256 appId, uint256 cooldownSeconds)", "function sendMessage(uint256 topicId, bytes payload)", "function setTopicCreationFee(uint256 appId, address feeTokenAddr, uint256 feeAmount)", "function setTopicMessageFee(uint256 topicId, address feeTokenAddr, uint256 feeAmount)", "event ApplicationCreated(uint256 indexed applicationId, string name, address indexed owner)", "event TopicCreated(uint256 indexed topicId, uint256 indexed applicationId, string name, address indexed creator, uint8 accessLevel)", "event MemberAdded(uint256 indexed applicationId, address indexed member, string nickname, uint8 roles)", "event MemberRemoved(uint256 indexed applicationId, address indexed member)", "event MemberRolesUpdated(uint256 indexed applicationId, address indexed member, uint8 roles)", "event NicknameUpdated(uint256 indexed applicationId, address indexed member, string nickname)", "event UserNicknameSet(uint256 indexed applicationId, address indexed user, string nickname)", "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)", "function registerAgentIdentity(uint256 appId, uint256 tokenId)", "function clearAgentIdentity(uint256 appId)", "function getAgentTokenId(uint256 appId, address user) view returns (uint256)", "function hasAgentIdentity(uint256 appId, address user) view returns (bool)", "event AgentIdentityRegistered(uint256 indexed applicationId, address indexed user, uint256 tokenId)", "event AgentIdentityCleared(uint256 indexed applicationId, address indexed user)", "function exportMemberData(uint256 appId, address user) view returns (bytes)", "function exportApplicationData(uint256 appId) view returns (bytes)"];
+declare const REGISTRY_ABI: readonly ["function applications(uint256) view returns (uint256 id, string name, string description, string frontendUrl, address owner, uint64 createdAt, uint32 memberCount, uint32 topicCount, bool active, bool allowPublicTopicCreation)", "function getApplication(uint256 appId) view returns (tuple(uint256 id, string name, string description, string frontendUrl, address owner, uint64 createdAt, uint32 memberCount, uint32 topicCount, bool active, bool allowPublicTopicCreation, address topicCreationFeeToken, uint256 topicCreationFeeAmount))", "function applicationCount() view returns (uint256)", "function applicationNames(string) view returns (uint256)", "function topics(uint256) view returns (uint256 id, uint256 applicationId, string name, string description, address owner, address creator, uint64 createdAt, uint64 lastMessageAt, uint256 messageCount, uint8 accessLevel, bool active)", "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 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))", "function isMember(uint256 appId, address account) view returns (bool)", "function getApplicationMembers(uint256 appId) view returns (address[])", "function canReadTopic(uint256 topicId, address user) view returns (bool)", "function canWriteToTopic(uint256 topicId, address user) view returns (bool)", "function getTopicPermission(uint256 topicId, address user) view returns (uint8)", "function topicPermissions(uint256, address) view returns (uint8)", "function getNickname(uint256 appId, address user) view returns (string)", "function hasNickname(uint256 appId, address user) view returns (bool)", "function canChangeNickname(uint256 appId, address user) view returns (bool canChange, uint256 timeRemaining)", "function appNicknameCooldown(uint256 appId) view returns (uint256)", "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)", "function createApplication(string name, string description, string frontendUrl, bool allowPublicTopicCreation) returns (uint256)", "function updateApplicationFrontendUrl(uint256 appId, string frontendUrl)", "function createTopic(uint256 appId, string name, string description, uint8 accessLevel) returns (uint256)", "function setTopicPermission(uint256 topicId, address user, uint8 permission)", "function addMember(uint256 appId, address member, string nickname, uint8 roles)", "function removeMember(uint256 appId, address member)", "function updateMemberRoles(uint256 appId, address member, uint8 roles)", "function updateMemberNickname(uint256 appId, string nickname)", "function setNickname(uint256 appId, string nickname)", "function clearNickname(uint256 appId)", "function setNicknameCooldown(uint256 appId, uint256 cooldownSeconds)", "function sendMessage(uint256 topicId, bytes payload)", "function setTopicCreationFee(uint256 appId, address feeTokenAddr, uint256 feeAmount)", "function setTopicMessageFee(uint256 topicId, address feeTokenAddr, uint256 feeAmount)", "event ApplicationCreated(uint256 indexed applicationId, string name, address indexed owner)", "event TopicCreated(uint256 indexed topicId, uint256 indexed applicationId, string name, address indexed creator, uint8 accessLevel)", "event MemberAdded(uint256 indexed applicationId, address indexed member, string nickname, uint8 roles)", "event MemberRemoved(uint256 indexed applicationId, address indexed member)", "event MemberRolesUpdated(uint256 indexed applicationId, address indexed member, uint8 roles)", "event NicknameUpdated(uint256 indexed applicationId, address indexed member, string nickname)", "event UserNicknameSet(uint256 indexed applicationId, address indexed user, string nickname)", "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)", "function registerAgentIdentity(uint256 appId, uint256 tokenId)", "function clearAgentIdentity(uint256 appId)", "function getAgentTokenId(uint256 appId, address user) view returns (uint256)", "function hasAgentIdentity(uint256 appId, address user) view returns (bool)", "event AgentIdentityRegistered(uint256 indexed applicationId, address indexed user, uint256 tokenId)", "event AgentIdentityCleared(uint256 indexed applicationId, address indexed user)", "function exportMemberData(uint256 appId, address user) view returns (bytes)", "function exportApplicationData(uint256 appId) view returns (bytes)"];
 declare const SCHEMA_REGISTRY_ABI: readonly ["function schemaCount() view returns (uint256)", "function getSchema(uint256 schemaId) view returns (uint256 id, string name, string description, address creator, uint64 createdAt, uint256 versionCount, bool active)", "function getSchemaWithApp(uint256 schemaId) view returns (uint256 id, string name, string description, address creator, uint64 createdAt, uint256 versionCount, bool active, uint256 applicationId)", "function getSchemaBody(uint256 schemaId, uint256 version) view returns (string)", "function getSchemaVersion(uint256 schemaId, uint256 version) view returns (string body, uint64 publishedAt)", "function schemaApplicationId(uint256 schemaId) view returns (uint256)", "function getApplicationSchemas(uint256 applicationId) view returns (uint256[])", "function getApplicationSchemaCount(uint256 applicationId) view returns (uint256)", "function getTopicSchema(uint256 topicId) view returns (uint256 schemaId, uint256 version, string body)", "function contractVersion() view returns (string)", "function createAppSchema(uint256 applicationId, string name, string description, string body) returns (uint256)", "function publishSchemaVersion(uint256 schemaId, string body) returns (uint256)", "function deactivateSchema(uint256 schemaId)", "function setTopicSchema(uint256 topicId, uint256 schemaId, uint256 version)", "function clearTopicSchema(uint256 topicId)", "event AppSchemaCreated(uint256 indexed schemaId, uint256 indexed applicationId, string name, address indexed creator)", "event SchemaVersionPublished(uint256 indexed schemaId, uint256 version)", "event SchemaDeactivated(uint256 indexed schemaId)", "event TopicSchemaSet(uint256 indexed topicId, uint256 indexed schemaId, uint256 version)", "event TopicSchemaCleared(uint256 indexed topicId)", "event SchemaAssignedToApp(uint256 indexed schemaId, uint256 indexed applicationId)"];
 declare const IDENTITY_REGISTRY_ABI: readonly ["function register() returns (uint256)", "function register(string agentURI) returns (uint256)", "function register(string agentURI, tuple(string metadataKey, bytes metadataValue)[] metadata) returns (uint256)", "function getMetadata(uint256 agentId, string metadataKey) view returns (bytes)", "function setMetadata(uint256 agentId, string metadataKey, bytes metadataValue)", "function setAgentURI(uint256 agentId, string newURI)", "function getAgentWallet(uint256 agentId) view returns (address)", "function setAgentWallet(uint256 agentId, address newWallet, uint256 deadline, bytes signature)", "function unsetAgentWallet(uint256 agentId)", "function ownerOf(uint256 tokenId) view returns (address)", "function balanceOf(address owner) view returns (uint256)", "function tokenOfOwnerByIndex(address owner, uint256 index) view returns (uint256)", "function tokenURI(uint256 tokenId) view returns (string)", "function isAuthorizedOrOwner(address spender, uint256 agentId) view returns (bool)", "function getVersion() pure returns (string)", "event Registered(uint256 indexed agentId, string agentURI, address indexed owner)"];
+declare const ESCROW_ABI: readonly ["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)", "function enableEscrow(uint256 topicId, uint64 timeoutSeconds)", "function disableEscrow(uint256 topicId)", "function claimRefund(uint256 depositId)", "function batchClaimRefunds(uint256[] depositIds)", "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)"];
 declare const KEY_MANAGER_ABI: readonly ["function hasPublicKey(address user) view returns (bool)", "function getPublicKey(address user) view returns (bytes)", "function publicKeys(address) view returns (bytes)", "function hasKeyAccess(uint256 topicId, address user) view returns (bool)", "function getMyKey(uint256 topicId) view returns (bytes encryptedKey, bytes granterPublicKey, address granter, uint256 keyVersion, uint256 currentVersion)", "function getKeyGrant(uint256 topicId, address user) view returns (tuple(bytes encryptedKey, bytes granterPublicKey, address granter, uint256 keyVersion, uint64 grantedAt))", "function keyVersions(uint256 topicId) view returns (uint256)", "function registerPublicKey(bytes publicKey)", "function grantKeyAccess(uint256 topicId, address user, bytes encryptedKey)", "function batchGrantKeyAccess(uint256 topicId, address[] users, bytes[] encryptedKeys)", "function revokeKeyAccess(uint256 topicId, address user)", "function rotateKey(uint256 topicId)", "function exportUserData(address user, uint256[] topicIds) view returns (bytes)", "event PublicKeyRegistered(address indexed user, bytes publicKey)", "event PublicKeyUpdated(address indexed user, bytes publicKey)", "event KeyAccessGranted(uint256 indexed topicId, address indexed user, address indexed granter, uint256 version)", "event KeyAccessRevoked(uint256 indexed topicId, address indexed user)", "event KeyRotated(uint256 indexed topicId, uint256 newVersion)"];
 
 /**
@@ -567,4 +649,4 @@ declare function decryptTopicKey(encryptedKey: Uint8Array, ourPrivateKey: Uint8A
 declare function bytesToHex(bytes: Uint8Array): string;
 declare function hexToBytes(hex: string): Uint8Array;
 
-export { ACCESS_PRIVATE, ACCESS_PUBLIC, ACCESS_PUBLIC_LIMITED, AccessLevel, type Application, CHAINS, CHAIN_IDS, type ChainConfig, type ChainName, Clawntenna, type ClawtennaOptions, type CredentialApp, type CredentialChain, type Credentials, type CredentialsV1, type EncryptedPayload, IDENTITY_REGISTRY_ABI, KEY_MANAGER_ABI, type KeyGrant, type Member, type Message, type MessageContent, PERMISSION_ADMIN, PERMISSION_NONE, PERMISSION_READ, PERMISSION_READ_WRITE, PERMISSION_WRITE, Permission, REGISTRY_ABI, ROLE_ADMIN, ROLE_MEMBER, ROLE_OWNER_DELEGATE, ROLE_SUPPORT_MANAGER, ROLE_TOPIC_MANAGER, type ReadOptions, Role, SCHEMA_REGISTRY_ABI, type SchemaInfo, type SendOptions, type Topic, type TopicMessageFee, type TopicSchemaBinding, bytesToHex, computeSharedSecret, decrypt, decryptMessage, decryptTopicKey, deriveAESKeyFromSecret, deriveKeyFromPassphrase, deriveKeypairFromSignature, derivePublicTopicKey, encrypt, encryptMessage, encryptTopicKeyForUser, getChain, hexToBytes, keypairFromPrivateKey };
+export { ACCESS_PRIVATE, ACCESS_PUBLIC, ACCESS_PUBLIC_LIMITED, AccessLevel, type Application, CHAINS, CHAIN_IDS, type ChainConfig, type ChainName, Clawntenna, type ClawtennaOptions, type CredentialApp, type CredentialChain, type Credentials, type CredentialsV1, DepositStatus, ESCROW_ABI, type EncryptedPayload, type EscrowConfig, type EscrowDeposit, IDENTITY_REGISTRY_ABI, KEY_MANAGER_ABI, type KeyGrant, type Member, type Message, type MessageContent, PERMISSION_ADMIN, PERMISSION_NONE, PERMISSION_READ, PERMISSION_READ_WRITE, PERMISSION_WRITE, Permission, REGISTRY_ABI, ROLE_ADMIN, ROLE_MEMBER, ROLE_OWNER_DELEGATE, ROLE_SUPPORT_MANAGER, ROLE_TOPIC_MANAGER, type ReadOptions, Role, SCHEMA_REGISTRY_ABI, type SchemaInfo, type SendOptions, type Topic, type TopicMessageFee, type TopicSchemaBinding, bytesToHex, computeSharedSecret, decrypt, decryptMessage, decryptTopicKey, deriveAESKeyFromSecret, deriveKeyFromPassphrase, deriveKeypairFromSignature, derivePublicTopicKey, encrypt, encryptMessage, encryptTopicKeyForUser, getChain, hexToBytes, keypairFromPrivateKey };

package/dist/index.d.ts

@@ -29,6 +29,7 @@ interface ChainConfig {
     keyManager: string;
     schemaRegistry: string;
     identityRegistry?: string;
+    escrow?: string;
 }
 type ChainName = 'base' | 'avalanche' | 'baseSepolia';
 interface Application {
@@ -114,6 +115,27 @@ interface TopicSchemaBinding {
     version: number;
     body: string;
 }
+declare enum DepositStatus {
+    Pending = 0,
+    Released = 1,
+    Refunded = 2
+}
+interface EscrowDeposit {
+    id: bigint;
+    topicId: bigint;
+    sender: string;
+    recipient: string;
+    token: string;
+    amount: bigint;
+    appOwner: string;
+    depositedAt: bigint;
+    timeout: bigint;
+    status: DepositStatus;
+}
+interface EscrowConfig {
+    enabled: boolean;
+    timeout: bigint;
+}
 interface ClawtennaOptions {
     chain?: ChainName;
     chainId?: number;
@@ -122,6 +144,7 @@ interface ClawtennaOptions {
     registryAddress?: string;
     keyManagerAddress?: string;
     schemaRegistryAddress?: string;
+    escrowAddress?: string;
 }
 interface ReadOptions {
     limit?: number;
@@ -132,6 +155,7 @@ interface SendOptions {
     replyText?: string;
     replyAuthor?: string;
     mentions?: string[];
+    skipRefundCheck?: boolean;
 }
 interface Credentials {
     version: 2;
@@ -180,6 +204,7 @@ declare class Clawntenna {
     readonly keyManager: ethers.Contract;
     readonly schemaRegistry: ethers.Contract;
     readonly identityRegistry: ethers.Contract | null;
+    readonly escrow: ethers.Contract | null;
     readonly chainName: ChainName;
     private ecdhPrivateKey;
     private ecdhPublicKey;
@@ -231,6 +256,62 @@ declare class Clawntenna {
     getTopicMessageFee(topicId: number): Promise<TopicMessageFee>;
     setTopicCreationFee(appId: number, feeToken: string, feeAmount: bigint): Promise<ethers.TransactionResponse>;
     setTopicMessageFee(topicId: number, feeToken: string, feeAmount: bigint): Promise<ethers.TransactionResponse>;
+    private requireEscrow;
+    /**
+     * Enable escrow for a topic (topic owner only).
+     */
+    enableEscrow(topicId: number, timeout: number): Promise<ethers.TransactionResponse>;
+    /**
+     * Disable escrow for a topic (topic owner only).
+     */
+    disableEscrow(topicId: number): Promise<ethers.TransactionResponse>;
+    /**
+     * Check if escrow is enabled for a topic.
+     */
+    isEscrowEnabled(topicId: number): Promise<boolean>;
+    /**
+     * Get escrow config for a topic (enabled + timeout).
+     */
+    getEscrowConfig(topicId: number): Promise<EscrowConfig>;
+    /**
+     * Get full deposit details by ID.
+     */
+    getDeposit(depositId: number): Promise<EscrowDeposit>;
+    /**
+     * Get deposit status (0=Pending, 1=Released, 2=Refunded).
+     */
+    getDepositStatus(depositId: number): Promise<DepositStatus>;
+    /**
+     * Get pending deposit IDs for a topic.
+     */
+    getPendingDeposits(topicId: number): Promise<bigint[]>;
+    /**
+     * Check if a deposit can be refunded (timeout expired and still pending).
+     */
+    canClaimRefund(depositId: number): Promise<boolean>;
+    /**
+     * Claim a refund for a single deposit.
+     */
+    claimRefund(depositId: number): Promise<ethers.TransactionResponse>;
+    /**
+     * Batch claim refunds for multiple deposits.
+     */
+    batchClaimRefunds(depositIds: number[]): Promise<ethers.TransactionResponse>;
+    /**
+     * 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).
+     */
+    getMessageDepositId(txHash: string): Promise<bigint | null>;
+    /**
+     * Get the deposit status for a message by its transaction hash.
+     * Returns null if the message has no associated escrow deposit.
+     */
+    getMessageDepositStatus(txHash: string): Promise<DepositStatus | null>;
+    /**
+     * Check if a message's escrow deposit was refunded.
+     * Returns false if no escrow deposit exists for the tx.
+     */
+    isMessageRefunded(txHash: string): Promise<boolean>;
     /**
      * Derive ECDH keypair from wallet signature (deterministic).
      * Requires a signer capable of signing messages.
@@ -485,9 +566,10 @@ declare const ROLE_TOPIC_MANAGER = Role.TOPIC_MANAGER;
 declare const ROLE_ADMIN = Role.ADMIN;
 declare const ROLE_OWNER_DELEGATE = Role.OWNER_DELEGATE;
 
-declare const REGISTRY_ABI: readonly ["function applications(uint256) view returns (uint256 id, string name, string description, string frontendUrl, address owner, uint64 createdAt, uint32 memberCount, uint32 topicCount, bool active, bool allowPublicTopicCreation)", "function getApplication(uint256 appId) view returns (tuple(uint256 id, string name, string description, string frontendUrl, address owner, uint64 createdAt, uint32 memberCount, uint32 topicCount, bool active, bool allowPublicTopicCreation, address topicCreationFeeToken, uint256 topicCreationFeeAmount))", "function applicationCount() view returns (uint256)", "function applicationNames(string) view returns (uint256)", "function topics(uint256) view returns (uint256 id, uint256 applicationId, string name, string description, address owner, address creator, uint64 createdAt, uint64 lastMessageAt, uint256 messageCount, uint8 accessLevel, bool active)", "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 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))", "function isMember(uint256 appId, address account) view returns (bool)", "function getApplicationMembers(uint256 appId) view returns (address[])", "function canReadTopic(uint256 topicId, address user) view returns (bool)", "function canWriteToTopic(uint256 topicId, address user) view returns (bool)", "function getTopicPermission(uint256 topicId, address user) view returns (uint8)", "function topicPermissions(uint256, address) view returns (uint8)", "function getNickname(uint256 appId, address user) view returns (string)", "function hasNickname(uint256 appId, address user) view returns (bool)", "function canChangeNickname(uint256 appId, address user) view returns (bool canChange, uint256 timeRemaining)", "function appNicknameCooldown(uint256 appId) view returns (uint256)", "function getTopicMessageFee(uint256 topicId) view returns (address token, uint256 amount)", "function createApplication(string name, string description, string frontendUrl, bool allowPublicTopicCreation) returns (uint256)", "function updateApplicationFrontendUrl(uint256 appId, string frontendUrl)", "function createTopic(uint256 appId, string name, string description, uint8 accessLevel) returns (uint256)", "function setTopicPermission(uint256 topicId, address user, uint8 permission)", "function addMember(uint256 appId, address member, string nickname, uint8 roles)", "function removeMember(uint256 appId, address member)", "function updateMemberRoles(uint256 appId, address member, uint8 roles)", "function updateMemberNickname(uint256 appId, string nickname)", "function setNickname(uint256 appId, string nickname)", "function clearNickname(uint256 appId)", "function setNicknameCooldown(uint256 appId, uint256 cooldownSeconds)", "function sendMessage(uint256 topicId, bytes payload)", "function setTopicCreationFee(uint256 appId, address feeTokenAddr, uint256 feeAmount)", "function setTopicMessageFee(uint256 topicId, address feeTokenAddr, uint256 feeAmount)", "event ApplicationCreated(uint256 indexed applicationId, string name, address indexed owner)", "event TopicCreated(uint256 indexed topicId, uint256 indexed applicationId, string name, address indexed creator, uint8 accessLevel)", "event MemberAdded(uint256 indexed applicationId, address indexed member, string nickname, uint8 roles)", "event MemberRemoved(uint256 indexed applicationId, address indexed member)", "event MemberRolesUpdated(uint256 indexed applicationId, address indexed member, uint8 roles)", "event NicknameUpdated(uint256 indexed applicationId, address indexed member, string nickname)", "event UserNicknameSet(uint256 indexed applicationId, address indexed user, string nickname)", "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)", "function registerAgentIdentity(uint256 appId, uint256 tokenId)", "function clearAgentIdentity(uint256 appId)", "function getAgentTokenId(uint256 appId, address user) view returns (uint256)", "function hasAgentIdentity(uint256 appId, address user) view returns (bool)", "event AgentIdentityRegistered(uint256 indexed applicationId, address indexed user, uint256 tokenId)", "event AgentIdentityCleared(uint256 indexed applicationId, address indexed user)", "function exportMemberData(uint256 appId, address user) view returns (bytes)", "function exportApplicationData(uint256 appId) view returns (bytes)"];
+declare const REGISTRY_ABI: readonly ["function applications(uint256) view returns (uint256 id, string name, string description, string frontendUrl, address owner, uint64 createdAt, uint32 memberCount, uint32 topicCount, bool active, bool allowPublicTopicCreation)", "function getApplication(uint256 appId) view returns (tuple(uint256 id, string name, string description, string frontendUrl, address owner, uint64 createdAt, uint32 memberCount, uint32 topicCount, bool active, bool allowPublicTopicCreation, address topicCreationFeeToken, uint256 topicCreationFeeAmount))", "function applicationCount() view returns (uint256)", "function applicationNames(string) view returns (uint256)", "function topics(uint256) view returns (uint256 id, uint256 applicationId, string name, string description, address owner, address creator, uint64 createdAt, uint64 lastMessageAt, uint256 messageCount, uint8 accessLevel, bool active)", "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 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))", "function isMember(uint256 appId, address account) view returns (bool)", "function getApplicationMembers(uint256 appId) view returns (address[])", "function canReadTopic(uint256 topicId, address user) view returns (bool)", "function canWriteToTopic(uint256 topicId, address user) view returns (bool)", "function getTopicPermission(uint256 topicId, address user) view returns (uint8)", "function topicPermissions(uint256, address) view returns (uint8)", "function getNickname(uint256 appId, address user) view returns (string)", "function hasNickname(uint256 appId, address user) view returns (bool)", "function canChangeNickname(uint256 appId, address user) view returns (bool canChange, uint256 timeRemaining)", "function appNicknameCooldown(uint256 appId) view returns (uint256)", "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)", "function createApplication(string name, string description, string frontendUrl, bool allowPublicTopicCreation) returns (uint256)", "function updateApplicationFrontendUrl(uint256 appId, string frontendUrl)", "function createTopic(uint256 appId, string name, string description, uint8 accessLevel) returns (uint256)", "function setTopicPermission(uint256 topicId, address user, uint8 permission)", "function addMember(uint256 appId, address member, string nickname, uint8 roles)", "function removeMember(uint256 appId, address member)", "function updateMemberRoles(uint256 appId, address member, uint8 roles)", "function updateMemberNickname(uint256 appId, string nickname)", "function setNickname(uint256 appId, string nickname)", "function clearNickname(uint256 appId)", "function setNicknameCooldown(uint256 appId, uint256 cooldownSeconds)", "function sendMessage(uint256 topicId, bytes payload)", "function setTopicCreationFee(uint256 appId, address feeTokenAddr, uint256 feeAmount)", "function setTopicMessageFee(uint256 topicId, address feeTokenAddr, uint256 feeAmount)", "event ApplicationCreated(uint256 indexed applicationId, string name, address indexed owner)", "event TopicCreated(uint256 indexed topicId, uint256 indexed applicationId, string name, address indexed creator, uint8 accessLevel)", "event MemberAdded(uint256 indexed applicationId, address indexed member, string nickname, uint8 roles)", "event MemberRemoved(uint256 indexed applicationId, address indexed member)", "event MemberRolesUpdated(uint256 indexed applicationId, address indexed member, uint8 roles)", "event NicknameUpdated(uint256 indexed applicationId, address indexed member, string nickname)", "event UserNicknameSet(uint256 indexed applicationId, address indexed user, string nickname)", "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)", "function registerAgentIdentity(uint256 appId, uint256 tokenId)", "function clearAgentIdentity(uint256 appId)", "function getAgentTokenId(uint256 appId, address user) view returns (uint256)", "function hasAgentIdentity(uint256 appId, address user) view returns (bool)", "event AgentIdentityRegistered(uint256 indexed applicationId, address indexed user, uint256 tokenId)", "event AgentIdentityCleared(uint256 indexed applicationId, address indexed user)", "function exportMemberData(uint256 appId, address user) view returns (bytes)", "function exportApplicationData(uint256 appId) view returns (bytes)"];
 declare const SCHEMA_REGISTRY_ABI: readonly ["function schemaCount() view returns (uint256)", "function getSchema(uint256 schemaId) view returns (uint256 id, string name, string description, address creator, uint64 createdAt, uint256 versionCount, bool active)", "function getSchemaWithApp(uint256 schemaId) view returns (uint256 id, string name, string description, address creator, uint64 createdAt, uint256 versionCount, bool active, uint256 applicationId)", "function getSchemaBody(uint256 schemaId, uint256 version) view returns (string)", "function getSchemaVersion(uint256 schemaId, uint256 version) view returns (string body, uint64 publishedAt)", "function schemaApplicationId(uint256 schemaId) view returns (uint256)", "function getApplicationSchemas(uint256 applicationId) view returns (uint256[])", "function getApplicationSchemaCount(uint256 applicationId) view returns (uint256)", "function getTopicSchema(uint256 topicId) view returns (uint256 schemaId, uint256 version, string body)", "function contractVersion() view returns (string)", "function createAppSchema(uint256 applicationId, string name, string description, string body) returns (uint256)", "function publishSchemaVersion(uint256 schemaId, string body) returns (uint256)", "function deactivateSchema(uint256 schemaId)", "function setTopicSchema(uint256 topicId, uint256 schemaId, uint256 version)", "function clearTopicSchema(uint256 topicId)", "event AppSchemaCreated(uint256 indexed schemaId, uint256 indexed applicationId, string name, address indexed creator)", "event SchemaVersionPublished(uint256 indexed schemaId, uint256 version)", "event SchemaDeactivated(uint256 indexed schemaId)", "event TopicSchemaSet(uint256 indexed topicId, uint256 indexed schemaId, uint256 version)", "event TopicSchemaCleared(uint256 indexed topicId)", "event SchemaAssignedToApp(uint256 indexed schemaId, uint256 indexed applicationId)"];
 declare const IDENTITY_REGISTRY_ABI: readonly ["function register() returns (uint256)", "function register(string agentURI) returns (uint256)", "function register(string agentURI, tuple(string metadataKey, bytes metadataValue)[] metadata) returns (uint256)", "function getMetadata(uint256 agentId, string metadataKey) view returns (bytes)", "function setMetadata(uint256 agentId, string metadataKey, bytes metadataValue)", "function setAgentURI(uint256 agentId, string newURI)", "function getAgentWallet(uint256 agentId) view returns (address)", "function setAgentWallet(uint256 agentId, address newWallet, uint256 deadline, bytes signature)", "function unsetAgentWallet(uint256 agentId)", "function ownerOf(uint256 tokenId) view returns (address)", "function balanceOf(address owner) view returns (uint256)", "function tokenOfOwnerByIndex(address owner, uint256 index) view returns (uint256)", "function tokenURI(uint256 tokenId) view returns (string)", "function isAuthorizedOrOwner(address spender, uint256 agentId) view returns (bool)", "function getVersion() pure returns (string)", "event Registered(uint256 indexed agentId, string agentURI, address indexed owner)"];
+declare const ESCROW_ABI: readonly ["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)", "function enableEscrow(uint256 topicId, uint64 timeoutSeconds)", "function disableEscrow(uint256 topicId)", "function claimRefund(uint256 depositId)", "function batchClaimRefunds(uint256[] depositIds)", "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)"];
 declare const KEY_MANAGER_ABI: readonly ["function hasPublicKey(address user) view returns (bool)", "function getPublicKey(address user) view returns (bytes)", "function publicKeys(address) view returns (bytes)", "function hasKeyAccess(uint256 topicId, address user) view returns (bool)", "function getMyKey(uint256 topicId) view returns (bytes encryptedKey, bytes granterPublicKey, address granter, uint256 keyVersion, uint256 currentVersion)", "function getKeyGrant(uint256 topicId, address user) view returns (tuple(bytes encryptedKey, bytes granterPublicKey, address granter, uint256 keyVersion, uint64 grantedAt))", "function keyVersions(uint256 topicId) view returns (uint256)", "function registerPublicKey(bytes publicKey)", "function grantKeyAccess(uint256 topicId, address user, bytes encryptedKey)", "function batchGrantKeyAccess(uint256 topicId, address[] users, bytes[] encryptedKeys)", "function revokeKeyAccess(uint256 topicId, address user)", "function rotateKey(uint256 topicId)", "function exportUserData(address user, uint256[] topicIds) view returns (bytes)", "event PublicKeyRegistered(address indexed user, bytes publicKey)", "event PublicKeyUpdated(address indexed user, bytes publicKey)", "event KeyAccessGranted(uint256 indexed topicId, address indexed user, address indexed granter, uint256 version)", "event KeyAccessRevoked(uint256 indexed topicId, address indexed user)", "event KeyRotated(uint256 indexed topicId, uint256 newVersion)"];
 
 /**
@@ -567,4 +649,4 @@ declare function decryptTopicKey(encryptedKey: Uint8Array, ourPrivateKey: Uint8A
 declare function bytesToHex(bytes: Uint8Array): string;
 declare function hexToBytes(hex: string): Uint8Array;
 
-export { ACCESS_PRIVATE, ACCESS_PUBLIC, ACCESS_PUBLIC_LIMITED, AccessLevel, type Application, CHAINS, CHAIN_IDS, type ChainConfig, type ChainName, Clawntenna, type ClawtennaOptions, type CredentialApp, type CredentialChain, type Credentials, type CredentialsV1, type EncryptedPayload, IDENTITY_REGISTRY_ABI, KEY_MANAGER_ABI, type KeyGrant, type Member, type Message, type MessageContent, PERMISSION_ADMIN, PERMISSION_NONE, PERMISSION_READ, PERMISSION_READ_WRITE, PERMISSION_WRITE, Permission, REGISTRY_ABI, ROLE_ADMIN, ROLE_MEMBER, ROLE_OWNER_DELEGATE, ROLE_SUPPORT_MANAGER, ROLE_TOPIC_MANAGER, type ReadOptions, Role, SCHEMA_REGISTRY_ABI, type SchemaInfo, type SendOptions, type Topic, type TopicMessageFee, type TopicSchemaBinding, bytesToHex, computeSharedSecret, decrypt, decryptMessage, decryptTopicKey, deriveAESKeyFromSecret, deriveKeyFromPassphrase, deriveKeypairFromSignature, derivePublicTopicKey, encrypt, encryptMessage, encryptTopicKeyForUser, getChain, hexToBytes, keypairFromPrivateKey };
+export { ACCESS_PRIVATE, ACCESS_PUBLIC, ACCESS_PUBLIC_LIMITED, AccessLevel, type Application, CHAINS, CHAIN_IDS, type ChainConfig, type ChainName, Clawntenna, type ClawtennaOptions, type CredentialApp, type CredentialChain, type Credentials, type CredentialsV1, DepositStatus, ESCROW_ABI, type EncryptedPayload, type EscrowConfig, type EscrowDeposit, IDENTITY_REGISTRY_ABI, KEY_MANAGER_ABI, type KeyGrant, type Member, type Message, type MessageContent, PERMISSION_ADMIN, PERMISSION_NONE, PERMISSION_READ, PERMISSION_READ_WRITE, PERMISSION_WRITE, Permission, REGISTRY_ABI, ROLE_ADMIN, ROLE_MEMBER, ROLE_OWNER_DELEGATE, ROLE_SUPPORT_MANAGER, ROLE_TOPIC_MANAGER, type ReadOptions, Role, SCHEMA_REGISTRY_ABI, type SchemaInfo, type SendOptions, type Topic, type TopicMessageFee, type TopicSchemaBinding, bytesToHex, computeSharedSecret, decrypt, decryptMessage, decryptTopicKey, deriveAESKeyFromSecret, deriveKeyFromPassphrase, deriveKeypairFromSignature, derivePublicTopicKey, encrypt, encryptMessage, encryptTopicKeyForUser, getChain, hexToBytes, keypairFromPrivateKey };

package/dist/index.js

@@ -12,7 +12,8 @@ var CHAINS = {
     registry: "0xf39b193aedC1Ec9FD6C5ccc24fBAe58ba9f52413",
     keyManager: "0x5562B553a876CBdc8AA4B3fb0687f22760F4759e",
     schemaRegistry: "0xB7eB50e9058198b99b5b2589E6D70b2d99d5440a",
-    identityRegistry: "0x8004AA63c570c570eBF15376c0dB199918BFe9Fb"
+    identityRegistry: "0x8004AA63c570c570eBF15376c0dB199918BFe9Fb",
+    escrow: "0x74e376C53f4afd5Cd32a77dDc627f477FcFC2333"
   },
   base: {
     chainId: 8453,
@@ -83,6 +84,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)",
@@ -115,6 +120,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)",
@@ -176,6 +182,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)",
@@ -230,6 +261,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 */;
@@ -403,6 +440,7 @@ var Clawntenna = class {
   keyManager;
   schemaRegistry;
   identityRegistry;
+  escrow;
   chainName;
   // In-memory ECDH state
   ecdhPrivateKey = null;
@@ -418,12 +456,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 ethers.Wallet(options.privateKey, this.provider);
-      this.registry = new ethers.Contract(registryAddr, REGISTRY_ABI, this.wallet);
-      this.keyManager = new ethers.Contract(keyManagerAddr, KEY_MANAGER_ABI, this.wallet);
-      this.schemaRegistry = new ethers.Contract(schemaRegistryAddr, SCHEMA_REGISTRY_ABI, this.wallet);
-      this.identityRegistry = chain.identityRegistry ? new ethers.Contract(chain.identityRegistry, IDENTITY_REGISTRY_ABI, this.wallet) : null;
+    const escrowAddr = options.escrowAddress ?? chain.escrow;
+    const signer = options.privateKey ? new ethers.Wallet(options.privateKey, this.provider) : null;
+    const runner = signer ?? this.provider;
+    if (signer) {
+      this.wallet = signer;
+      this.registry = new ethers.Contract(registryAddr, REGISTRY_ABI, signer);
+      this.keyManager = new ethers.Contract(keyManagerAddr, KEY_MANAGER_ABI, signer);
+      this.schemaRegistry = new ethers.Contract(schemaRegistryAddr, SCHEMA_REGISTRY_ABI, signer);
+      this.identityRegistry = chain.identityRegistry ? new ethers.Contract(chain.identityRegistry, IDENTITY_REGISTRY_ABI, signer) : null;
     } else {
       this.wallet = null;
       this.registry = new ethers.Contract(registryAddr, REGISTRY_ABI, this.provider);
@@ -431,6 +472,7 @@ var Clawntenna = class {
       this.schemaRegistry = new ethers.Contract(schemaRegistryAddr, SCHEMA_REGISTRY_ABI, this.provider);
       this.identityRegistry = chain.identityRegistry ? new ethers.Contract(chain.identityRegistry, IDENTITY_REGISTRY_ABI, this.provider) : null;
     }
+    this.escrow = escrowAddr ? new ethers.Contract(escrowAddr, ESCROW_ABI, runner) : null;
   }
   get address() {
     return this.wallet?.address ?? null;
@@ -442,6 +484,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)) {
@@ -670,6 +718,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).
@@ -1186,6 +1360,8 @@ export {
   CHAINS,
   CHAIN_IDS,
   Clawntenna,
+  DepositStatus,
+  ESCROW_ABI,
   IDENTITY_REGISTRY_ABI,
   KEY_MANAGER_ABI,
   PERMISSION_ADMIN,