@babylonlabs-io/ts-sdk 0.72.1 → 0.74.0

package/README.md

@@ -56,22 +56,35 @@ targets — see the [Troubleshooting Guide](./docs/get-started/troubleshooting.m
 
 ### Install
 
+`viem ^2.38.2` is the only required peer. An Ethereum-only consumer installs
+the SDK and viem:
+
+```bash
+pnpm add @babylonlabs-io/ts-sdk viem
+```
+
+The Bitcoin peers are optional. Add their exact supported versions before you
+import a root or Bitcoin entry:
+
 ```bash
-# npm
-npm install @babylonlabs-io/ts-sdk viem bitcoinjs-lib @bitcoin-js/tiny-secp256k1-asmjs
+pnpm add bitcoinjs-lib@6.1.7 @bitcoin-js/tiny-secp256k1-asmjs@2.2.3
+```
 
-# yarn
-yarn add @babylonlabs-io/ts-sdk viem bitcoinjs-lib @bitcoin-js/tiny-secp256k1-asmjs
+The WASM engine is also optional. Add it only for Bitcoin construction and
+signing paths:
 
-# pnpm
-pnpm add @babylonlabs-io/ts-sdk viem bitcoinjs-lib @bitcoin-js/tiny-secp256k1-asmjs
+```bash
+pnpm add @babylonlabs-io/babylon-tbv-rust-wasm
 ```
 
-### ECC Library Initialization (required, once at startup)
+The source manifest uses `workspace:*` for the WASM peer. The release process
+replaces it with the exact engine version used in the release rehearsal.
+
+### ECC Library Initialization (Bitcoin flows only)
 
-The SDK uses `bitcoinjs-lib` for Taproot operations. Call `initEccLib()` once
-at application startup **before any SDK call that builds a PSBT or derives a
-Bitcoin address**:
+ETH-only consumers do not need an ECC library. If your application uses the
+SDK's Bitcoin/Taproot operations, call `initEccLib()` once **before any SDK call
+that builds a PSBT or derives a Bitcoin address**:
 
 ```typescript
 import * as ecc from "@bitcoin-js/tiny-secp256k1-asmjs";
@@ -103,12 +116,35 @@ Run with: `npx tsx verify-install.ts`
 
 ## Package Structure
 
-The SDK uses subpath exports for tree-shaking:
+The SDK uses subpath exports for hard dependency boundaries as well as
+tree-shaking. ETH-only code should import the dedicated `/eth` entries rather
+than a broad compatibility barrel:
 
 ```typescript
 // High-level managers (recommended for most users)
 import { PeginManager, PayoutManager } from "@babylonlabs-io/ts-sdk/tbv/core";
 
+// Ethereum-only readers and prepared peg-in registration (no BTC wallet,
+// bitcoinjs-lib, tiny-secp256k1, or WASM required)
+import {
+  ViemProtocolParamsReader,
+  ViemVaultRegistryReader,
+  ViemPeginRegistrationClient,
+} from "@babylonlabs-io/ts-sdk/tbv/core/clients/eth";
+
+// Ethereum-only transaction receipt helper
+import { waitForTransactionReceiptSmartAware } from "@babylonlabs-io/ts-sdk/tbv/core/utils/eth";
+
+// Unauthenticated VP polling without the Bitcoin-auth implementation
+import {
+  VaultProviderRpcClient,
+  batchPollByProvider,
+  DaemonStatus,
+} from "@babylonlabs-io/ts-sdk/tbv/core/clients/vault-provider/status";
+
+// Mempool reads without bitcoinjs-lib, tiny-secp256k1, or WASM
+import { getTxInfo } from "@babylonlabs-io/ts-sdk/tbv/core/clients/mempool";
+
 // Low-level primitives (advanced use cases)
 import {
   buildPrePeginPsbt,
@@ -140,8 +176,8 @@ import { BitcoinWallet } from "@babylonlabs-io/ts-sdk/shared";
 // UTXO type lives in the core utils module
 import { UTXO } from "@babylonlabs-io/ts-sdk/tbv/core";
 
-// Contract ABIs
-import { BTCVaultRegistryABI } from "@babylonlabs-io/ts-sdk/tbv/core";
+// Contract ABIs (also dependency-clean for ETH consumers)
+import { BTCVaultRegistryABI } from "@babylonlabs-io/ts-sdk/tbv/core/contracts";
 
 // Protocol integrations (Aave)
 import {
@@ -152,6 +188,13 @@ import {
 } from "@babylonlabs-io/ts-sdk/tbv/integrations/aave";
 ```
 
+`ViemPeginRegistrationClient` owns only the Ethereum submission half of a
+peg-in. It accepts a signed PegIn transaction, PoP,
+`depositorPayoutScriptPubKey`, and `depositorBtcPubkeyRaw` prepared earlier. It
+never asks for a BTC wallet. It validates the payout script against the raw key
+and the PoP key before any contract read or wallet call. `PeginManager` also
+checks the wallet address before it delegates to the ETH client.
+
 ## Where to start
 
 The SDK exposes several peer entry points — **managers**, **services**, **primitives**, **utils**, **clients**, and **integrations** — and you compose the pieces you need. The two most common starting points for a new integration are:

package/dist/BTCVaultRegistryKeyEpochs.abi-CrQiTLfA.cjs

@@ -0,0 +1,2 @@
+"use strict";const i={"0x04aabf33":"Vault already exists: This Bitcoin transaction has already been registered. Please select different UTXOs or use a different amount to create a unique transaction.","0x4fec082d":"Script mismatch: The Bitcoin transaction's taproot output does not match the expected vault script. This may be caused by incorrect vault participants or key configuration.","0x6cc363a5":"Invalid BTC proof of possession: The signature could not be verified. Please ensure you're signing with the correct Bitcoin wallet.","0x6c3f2bf6":"Invalid BTC public key: The Bitcoin public key format is invalid.","0x2c5211c6":"Invalid amount: The deposit amount is invalid or below the minimum required.","0x0405f772":"Application not registered: The application controller is not registered in the system.","0x24e165cc":"Invalid provider status: The vault provider is not in a valid state to accept deposits.","0xd92e233d":"Zero address: One of the required addresses is the zero address.","0x65aa7007":"BTC key mismatch: The Bitcoin public key does not match the expected key.","0x82b42900":"Unauthorized: You must be the depositor or vault provider to submit this transaction.","0x8baa579f":"Invalid signature: The BTC proof of possession signature could not be verified.","0x2f9d01e9":"Invalid BTC transaction: The Bitcoin transaction format is invalid.","0x5a3c6b3e":"Vault provider not registered: The selected vault provider is not registered.","0x979f4518":"Invalid pegin fee: The ETH fee sent does not match the required amount. This may indicate a fee rate change during the transaction.","0x5fad9694":"This pre-pegin output has already been used to activate another vault.","0x7ed061c9":"This pegin transaction has already been used to activate another vault.","0x70f7d5e2":"Duplicate deposit: a BTC Vault with this hashlock is already registered to your wallet. Hashlocks are derived from your BTC wallet and selected UTXOs — use different UTXOs to create a unique deposit."};function o(t){return s(t,0)}function s(t,r){if(r>10||!t||typeof t!="object")return;const e=t;if(typeof e.data=="string"&&e.data.startsWith("0x"))return e.data;if(typeof e.revertData=="string"&&e.revertData.startsWith("0x"))return e.revertData;if(typeof e.signature=="string"&&e.signature.startsWith("0x"))return e.signature;if(typeof e.details=="string"&&e.details.startsWith("0x"))return e.details;if(e.error&&typeof e.error=="object"){const n=e.error.data;if(typeof n=="string"&&n.startsWith("0x"))return n}if(e.cause){const n=s(e.cause,r+1);if(n)return n}if(typeof e.walk=="function")try{let n;if(e.walk(a=>{if(a===t)return!1;const c=s(a,r+1);return c?(n=c,!0):!1}),n)return n}catch{}if(r===0){const a=(typeof e.message=="string"?e.message:"").match(/\b(0x[a-fA-F0-9]{8})\b/);if(a)return a[1]}}function u(t){const r=o(t);if(r){const e=r.substring(0,10);return i[r]??i[e]}}function l(t){const r=o(t);if(r===void 0)return!1;const e=r.substring(0,10);return r in i||e in i}function d(t){console.error("[Contract Error] Raw error:",t);const r=o(t);if(console.error("[Contract Error] Extracted error data:",r),r){const n=r.substring(0,10),a=i[r]??i[n];if(a)throw console.error("[Contract Error] Known error:",a),new Error(a)}const e=(t==null?void 0:t.message)||"";if(e.includes("gas limit too high")||e.includes("21000000")||e.includes("Internal JSON-RPC error")){const n=r?` (error code: ${r})`:"";throw console.error("[Contract Error] Transaction rejected. Error code:",r,"Message:",e),new Error(`Transaction failed: The contract rejected this transaction${n}. Possible causes: (1) Vault already exists for this transaction, (2) Invalid signature, (3) Unauthorized caller. Please check your transaction parameters and try again.`)}throw t instanceof Error?(console.error("[Contract Error] Unhandled error:",t.message),t):new Error(`Contract call failed: ${String(t)}`)}const p=[{type:"function",name:"getBtcVaultProtocolInfo",inputs:[{name:"vaultId",type:"bytes32",internalType:"bytes32"}],outputs:[{name:"vProtocol",type:"tuple",internalType:"struct BTCVaultRegistryTypes.BTCVaultProtocolInfo",components:[{name:"depositorSignedPeginTx",type:"bytes",internalType:"bytes"},{name:"universalChallengersVersion",type:"uint16",internalType:"uint16"},{name:"appVaultKeepersVersion",type:"uint16",internalType:"uint16"},{name:"offchainParamsVersion",type:"uint16",internalType:"uint16"},{name:"verifiedAt",type:"uint256",internalType:"uint256"},{name:"depositorWotsPkHash",type:"bytes32",internalType:"bytes32"},{name:"hashlock",type:"bytes32",internalType:"bytes32"},{name:"htlcVout",type:"uint8",internalType:"uint8"},{name:"depositorPopSignature",type:"bytes",internalType:"bytes"},{name:"prePeginTxHash",type:"bytes32",internalType:"bytes32"},{name:"vaultProviderCommissionBps",type:"uint16",internalType:"uint16"},{name:"claimExpiredUntil",type:"uint256",internalType:"uint256"},{name:"vaultCoreVersion",type:"uint16",internalType:"uint16"},{name:"vpKeyEpoch",type:"uint64",internalType:"uint64"},{name:"appKeeperKeyEpoch",type:"uint64",internalType:"uint64"},{name:"ucKeyEpoch",type:"uint64",internalType:"uint64"}]}],stateMutability:"view"}];exports.BTCVaultRegistryKeyEpochsABI=p;exports.CONTRACT_ERRORS=i;exports.extractErrorData=o;exports.getContractErrorMessage=u;exports.handleContractError=d;exports.isKnownContractError=l;
+//# sourceMappingURL=BTCVaultRegistryKeyEpochs.abi-CrQiTLfA.cjs.map

package/dist/BTCVaultRegistryKeyEpochs.abi-CrQiTLfA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"BTCVaultRegistryKeyEpochs.abi-CrQiTLfA.cjs","sources":["../src/tbv/core/contracts/errors.ts","../src/tbv/core/contracts/abis/BTCVaultRegistryKeyEpochs.abi.ts"],"sourcesContent":["/**\n * Contract Error Handling Utilities\n *\n * Provides utilities for extracting and handling contract revert errors.\n * Maps known error selectors to user-friendly messages.\n *\n * @module contracts/errors\n */\n\n/**\n * Known contract error signatures mapped to user-friendly messages.\n *\n * Error selectors are the first 4 bytes of keccak256(error signature).\n * Example: keccak256(\"VaultAlreadyExists()\") = 0x04aabf33...\n */\nexport const CONTRACT_ERRORS: Record<string, string> = {\n  // VaultAlreadyExists()\n  \"0x04aabf33\":\n    \"Vault already exists: This Bitcoin transaction has already been registered. \" +\n    \"Please select different UTXOs or use a different amount to create a unique transaction.\",\n  // ScriptPubKeyMismatch() - taproot output doesn't match expected script\n  \"0x4fec082d\":\n    \"Script mismatch: The Bitcoin transaction's taproot output does not match the expected vault script. \" +\n    \"This may be caused by incorrect vault participants or key configuration.\",\n  // InvalidBTCProofOfPossession()\n  \"0x6cc363a5\":\n    \"Invalid BTC proof of possession: The signature could not be verified. \" +\n    \"Please ensure you're signing with the correct Bitcoin wallet.\",\n  // InvalidBTCPublicKey()\n  \"0x6c3f2bf6\":\n    \"Invalid BTC public key: The Bitcoin public key format is invalid.\",\n  // InvalidAmount()\n  \"0x2c5211c6\":\n    \"Invalid amount: The deposit amount is invalid or below the minimum required.\",\n  // ApplicationNotRegistered()\n  \"0x0405f772\":\n    \"Application not registered: The application controller is not registered in the system.\",\n  // InvalidProviderStatus()\n  \"0x24e165cc\":\n    \"Invalid provider status: The vault provider is not in a valid state to accept deposits.\",\n  // ZeroAddress()\n  \"0xd92e233d\":\n    \"Zero address: One of the required addresses is the zero address.\",\n  // BtcKeyMismatch()\n  \"0x65aa7007\":\n    \"BTC key mismatch: The Bitcoin public key does not match the expected key.\",\n  // Unauthorized()\n  \"0x82b42900\":\n    \"Unauthorized: You must be the depositor or vault provider to submit this transaction.\",\n  // InvalidSignature() - common signature verification error\n  \"0x8baa579f\":\n    \"Invalid signature: The BTC proof of possession signature could not be verified.\",\n  // InvalidBtcTransaction()\n  \"0x2f9d01e9\":\n    \"Invalid BTC transaction: The Bitcoin transaction format is invalid.\",\n  // VaultProviderNotRegistered()\n  \"0x5a3c6b3e\":\n    \"Vault provider not registered: The selected vault provider is not registered.\",\n  // InvalidPeginFee(uint256,uint256)\n  \"0x979f4518\":\n    \"Invalid pegin fee: The ETH fee sent does not match the required amount. \" +\n    \"This may indicate a fee rate change during the transaction.\",\n  // PrePeginOutputAlreadyUsed()\n  \"0x5fad9694\":\n    \"This pre-pegin output has already been used to activate another vault.\",\n  // PeginTransactionAlreadyUsed()\n  \"0x7ed061c9\":\n    \"This pegin transaction has already been used to activate another vault.\",\n  // DuplicateHashlock() — keccak256(abi.encodePacked(hashlock, msg.sender))\n  // collision in BTCVaultRegistry.hashlockToVaultId. Hashlocks are derived\n  // deterministically from the depositor's BTC wallet + selected UTXOs, so\n  // reusing the same UTXOs from the same wallet (even after a previous\n  // vault expires) produces the same hashlock and reverts here.\n  \"0x70f7d5e2\":\n    \"Duplicate deposit: a BTC Vault with this hashlock is already registered to your wallet. Hashlocks are derived from your BTC wallet and selected UTXOs — use different UTXOs to create a unique deposit.\",\n};\n\n/**\n * Extract error data from various error formats.\n *\n * Viem and wallet providers wrap errors in multiple levels. This function\n * searches through the error chain to find the revert data.\n *\n * @param error - The error object to extract data from\n * @returns The error data (e.g., \"0x04aabf33\") or undefined\n */\nexport function extractErrorData(error: unknown): string | undefined {\n  return walkForErrorData(error, 0);\n}\n\n/**\n * Walk an error chain looking for revert data in any of viem 2.x's known\n * shapes. Covers:\n *  - `.data: \"0x...\"` — raw revert hex (most common with `estimateGas`)\n *  - `.revertData: \"0x...\"` — alternate viem shape\n *  - `.signature: \"0x...\"` — 4-byte selector from a *decoded*\n *    ContractFunctionRevertedError (set when the ABI included the error def)\n *  - `.error.data: \"0x...\"` — RPC-level error shape from some providers\n *  - `.walk(fn)` — viem's chainable error walker (BaseError.walk)\n *  - `.cause` chain — viem wraps errors many layers deep\n *\n * Depth-limited (10) and walk-result-deduplicated so a cycle can't loop.\n */\nfunction walkForErrorData(\n  error: unknown,\n  depth: number,\n): string | undefined {\n  if (depth > 10 || !error || typeof error !== \"object\") return undefined;\n\n  const err = error as Record<string, unknown>;\n\n  if (typeof err.data === \"string\" && err.data.startsWith(\"0x\")) {\n    return err.data;\n  }\n  if (typeof err.revertData === \"string\" && err.revertData.startsWith(\"0x\")) {\n    return err.revertData;\n  }\n  if (typeof err.signature === \"string\" && err.signature.startsWith(\"0x\")) {\n    return err.signature;\n  }\n  if (typeof err.details === \"string\" && err.details.startsWith(\"0x\")) {\n    return err.details;\n  }\n\n  // RPC-level error shape (`{ error: { data: \"0x...\" } }`)\n  if (err.error && typeof err.error === \"object\") {\n    const inner = (err.error as Record<string, unknown>).data;\n    if (typeof inner === \"string\" && inner.startsWith(\"0x\")) {\n      return inner;\n    }\n  }\n\n  // Recurse through `.cause`\n  if (err.cause) {\n    const fromCause = walkForErrorData(err.cause, depth + 1);\n    if (fromCause) return fromCause;\n  }\n\n  // Use viem's `.walk()` if available\n  if (typeof err.walk === \"function\") {\n    try {\n      let found: string | undefined;\n      (err.walk as (fn: (e: unknown) => boolean) => unknown)((e) => {\n        if (e === error) return false; // avoid self-cycle\n        const data = walkForErrorData(e, depth + 1);\n        if (data) {\n          found = data;\n          return true;\n        }\n        return false;\n      });\n      if (found) return found;\n    } catch {\n      // walk failed; ignore\n    }\n  }\n\n  // Last resort: regex an embedded hex selector out of the message\n  if (depth === 0) {\n    const message = typeof err.message === \"string\" ? err.message : \"\";\n    const hexMatch = message.match(/\\b(0x[a-fA-F0-9]{8})\\b/);\n    if (hexMatch) return hexMatch[1];\n  }\n\n  return undefined;\n}\n\n/**\n * Get a user-friendly error message for a contract error.\n *\n * @param error - The error object from a contract call\n * @returns A user-friendly error message, or undefined if error is not recognized\n */\nexport function getContractErrorMessage(error: unknown): string | undefined {\n  const errorData = extractErrorData(error);\n  if (errorData) {\n    // Check exact match first, then match by 4-byte selector prefix.\n    // Parametric errors (e.g. InvalidPeginFee(uint256,uint256)) return\n    // the selector + ABI-encoded args, so the full string won't match.\n    const selector = errorData.substring(0, 10); // \"0x\" + 4 bytes\n    return CONTRACT_ERRORS[errorData] ?? CONTRACT_ERRORS[selector];\n  }\n  return undefined;\n}\n\n/**\n * Check if an error is a known contract error.\n *\n * @param error - The error object to check\n * @returns True if the error is a known contract error\n */\nexport function isKnownContractError(error: unknown): boolean {\n  const errorData = extractErrorData(error);\n  if (errorData === undefined) return false;\n  const selector = errorData.substring(0, 10);\n  return errorData in CONTRACT_ERRORS || selector in CONTRACT_ERRORS;\n}\n\n/**\n * Handle a contract error by throwing a user-friendly error.\n *\n * This function extracts error data, maps it to a user-friendly message,\n * and throws an appropriate error. Use this in catch blocks after contract calls.\n *\n * @param error - The error from a contract call\n * @throws Always throws an error with a descriptive message\n */\nexport function handleContractError(error: unknown): never {\n  // Log full error for debugging\n  console.error(\"[Contract Error] Raw error:\", error);\n\n  // Extract error data from the error chain\n  const errorData = extractErrorData(error);\n  console.error(\"[Contract Error] Extracted error data:\", errorData);\n\n  // Check for known contract error signatures (exact match or 4-byte selector prefix)\n  if (errorData) {\n    const selector = errorData.substring(0, 10);\n    const knownError = CONTRACT_ERRORS[errorData] ?? CONTRACT_ERRORS[selector];\n    if (knownError) {\n      console.error(\"[Contract Error] Known error:\", knownError);\n      throw new Error(knownError);\n    }\n  }\n\n  // Check for gas estimation errors or internal JSON-RPC errors\n  const errorMsg = (error as Error)?.message || \"\";\n  if (\n    errorMsg.includes(\"gas limit too high\") ||\n    errorMsg.includes(\"21000000\") ||\n    errorMsg.includes(\"Internal JSON-RPC error\")\n  ) {\n    // If we found error data but it's not in our known list, include it\n    const errorHint = errorData ? ` (error code: ${errorData})` : \"\";\n    console.error(\n      \"[Contract Error] Transaction rejected. Error code:\",\n      errorData,\n      \"Message:\",\n      errorMsg,\n    );\n    throw new Error(\n      `Transaction failed: The contract rejected this transaction${errorHint}. ` +\n        \"Possible causes: (1) Vault already exists for this transaction, \" +\n        \"(2) Invalid signature, (3) Unauthorized caller. \" +\n        \"Please check your transaction parameters and try again.\",\n    );\n  }\n\n  // Default: re-throw original error with better context\n  if (error instanceof Error) {\n    console.error(\"[Contract Error] Unhandled error:\", error.message);\n    throw error;\n  }\n  throw new Error(`Contract call failed: ${String(error)}`);\n}\n","/**\n * BTCVaultRegistry ABI — RFC-006 key-epoch view of `getBtcVaultProtocolInfo`.\n *\n * This is a deliberate second copy of a single function entry, NOT a\n * convenience re-export, and it must never be merged into\n * `BTCVaultRegistryABI`.\n *\n * `getBtcVaultProtocolInfo` returns a *positional* tuple. RFC-006 appended\n * three `uint64` epoch fields (`vpKeyEpoch`, `appKeeperKeyEpoch`,\n * `ucKeyEpoch`) after `vaultCoreVersion`. Declaring those three components\n * against a registry that predates RFC-006 makes viem read past the end of\n * the returndata and throw — and because the shared reader batches this call\n * through `multicall({ allowFailure: false })`, one bad decode fails the\n * whole batch. That would break vault status, resume, payout and refund\n * app-wide, on every network whose registry has not been upgraded yet.\n *\n * So the shared `BTCVaultRegistryABI` keeps the 13-field shape that decodes\n * against every deployed registry, and the extended shape lives here, read\n * only by `ViemVaultRegistryReader.getVaultKeyEpochs*` on the epoch-aware\n * path. Reading the same call through two ABIs is the price of keeping the\n * shared decode path independent of the registry version.\n *\n * The 13 shared components must stay an exact prefix of the 16 below;\n * `__tests__/abi-key-epochs.test.ts` pins that.\n *\n * Generated from vault-contracts-aave-v4\n * `src/protocol/lib/types/BTCVaultRegistryTypes.sol`.\n *\n * @module contracts/abis/BTCVaultRegistryKeyEpochs\n */\n\nexport const BTCVaultRegistryKeyEpochsABI = [\n  {\n    type: \"function\",\n    name: \"getBtcVaultProtocolInfo\",\n    inputs: [\n      {\n        name: \"vaultId\",\n        type: \"bytes32\",\n        internalType: \"bytes32\",\n      },\n    ],\n    outputs: [\n      {\n        name: \"vProtocol\",\n        type: \"tuple\",\n        internalType: \"struct BTCVaultRegistryTypes.BTCVaultProtocolInfo\",\n        components: [\n          {\n            name: \"depositorSignedPeginTx\",\n            type: \"bytes\",\n            internalType: \"bytes\",\n          },\n          {\n            name: \"universalChallengersVersion\",\n            type: \"uint16\",\n            internalType: \"uint16\",\n          },\n          {\n            name: \"appVaultKeepersVersion\",\n            type: \"uint16\",\n            internalType: \"uint16\",\n          },\n          {\n            name: \"offchainParamsVersion\",\n            type: \"uint16\",\n            internalType: \"uint16\",\n          },\n          {\n            name: \"verifiedAt\",\n            type: \"uint256\",\n            internalType: \"uint256\",\n          },\n          {\n            name: \"depositorWotsPkHash\",\n            type: \"bytes32\",\n            internalType: \"bytes32\",\n          },\n          {\n            name: \"hashlock\",\n            type: \"bytes32\",\n            internalType: \"bytes32\",\n          },\n          {\n            name: \"htlcVout\",\n            type: \"uint8\",\n            internalType: \"uint8\",\n          },\n          {\n            name: \"depositorPopSignature\",\n            type: \"bytes\",\n            internalType: \"bytes\",\n          },\n          {\n            name: \"prePeginTxHash\",\n            type: \"bytes32\",\n            internalType: \"bytes32\",\n          },\n          {\n            name: \"vaultProviderCommissionBps\",\n            type: \"uint16\",\n            internalType: \"uint16\",\n          },\n          {\n            name: \"claimExpiredUntil\",\n            type: \"uint256\",\n            internalType: \"uint256\",\n          },\n          {\n            name: \"vaultCoreVersion\",\n            type: \"uint16\",\n            internalType: \"uint16\",\n          },\n          // RFC-006: per-pegin operation-key epochs, frozen at\n          // `submitPeginRequest`. All three pack into one storage slot and were\n          // appended after `vaultCoreVersion` so pre-existing rows decode\n          // unchanged.\n          {\n            name: \"vpKeyEpoch\",\n            type: \"uint64\",\n            internalType: \"uint64\",\n          },\n          {\n            name: \"appKeeperKeyEpoch\",\n            type: \"uint64\",\n            internalType: \"uint64\",\n          },\n          {\n            name: \"ucKeyEpoch\",\n            type: \"uint64\",\n            internalType: \"uint64\",\n          },\n        ],\n      },\n    ],\n    stateMutability: \"view\",\n  },\n] as const;\n"],"names":["CONTRACT_ERRORS","extractErrorData","error","walkForErrorData","depth","err","inner","fromCause","found","e","data","hexMatch","getContractErrorMessage","errorData","selector","isKnownContractError","handleContractError","knownError","errorMsg","errorHint","BTCVaultRegistryKeyEpochsABI"],"mappings":"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"}

package/dist/BTCVaultRegistryKeyEpochs.abi-D8cIbMtH.js

@@ -0,0 +1,229 @@
+const i = {
+  // VaultAlreadyExists()
+  "0x04aabf33": "Vault already exists: This Bitcoin transaction has already been registered. Please select different UTXOs or use a different amount to create a unique transaction.",
+  // ScriptPubKeyMismatch() - taproot output doesn't match expected script
+  "0x4fec082d": "Script mismatch: The Bitcoin transaction's taproot output does not match the expected vault script. This may be caused by incorrect vault participants or key configuration.",
+  // InvalidBTCProofOfPossession()
+  "0x6cc363a5": "Invalid BTC proof of possession: The signature could not be verified. Please ensure you're signing with the correct Bitcoin wallet.",
+  // InvalidBTCPublicKey()
+  "0x6c3f2bf6": "Invalid BTC public key: The Bitcoin public key format is invalid.",
+  // InvalidAmount()
+  "0x2c5211c6": "Invalid amount: The deposit amount is invalid or below the minimum required.",
+  // ApplicationNotRegistered()
+  "0x0405f772": "Application not registered: The application controller is not registered in the system.",
+  // InvalidProviderStatus()
+  "0x24e165cc": "Invalid provider status: The vault provider is not in a valid state to accept deposits.",
+  // ZeroAddress()
+  "0xd92e233d": "Zero address: One of the required addresses is the zero address.",
+  // BtcKeyMismatch()
+  "0x65aa7007": "BTC key mismatch: The Bitcoin public key does not match the expected key.",
+  // Unauthorized()
+  "0x82b42900": "Unauthorized: You must be the depositor or vault provider to submit this transaction.",
+  // InvalidSignature() - common signature verification error
+  "0x8baa579f": "Invalid signature: The BTC proof of possession signature could not be verified.",
+  // InvalidBtcTransaction()
+  "0x2f9d01e9": "Invalid BTC transaction: The Bitcoin transaction format is invalid.",
+  // VaultProviderNotRegistered()
+  "0x5a3c6b3e": "Vault provider not registered: The selected vault provider is not registered.",
+  // InvalidPeginFee(uint256,uint256)
+  "0x979f4518": "Invalid pegin fee: The ETH fee sent does not match the required amount. This may indicate a fee rate change during the transaction.",
+  // PrePeginOutputAlreadyUsed()
+  "0x5fad9694": "This pre-pegin output has already been used to activate another vault.",
+  // PeginTransactionAlreadyUsed()
+  "0x7ed061c9": "This pegin transaction has already been used to activate another vault.",
+  // DuplicateHashlock() — keccak256(abi.encodePacked(hashlock, msg.sender))
+  // collision in BTCVaultRegistry.hashlockToVaultId. Hashlocks are derived
+  // deterministically from the depositor's BTC wallet + selected UTXOs, so
+  // reusing the same UTXOs from the same wallet (even after a previous
+  // vault expires) produces the same hashlock and reverts here.
+  "0x70f7d5e2": "Duplicate deposit: a BTC Vault with this hashlock is already registered to your wallet. Hashlocks are derived from your BTC wallet and selected UTXOs — use different UTXOs to create a unique deposit."
+};
+function s(t) {
+  return o(t, 0);
+}
+function o(t, r) {
+  if (r > 10 || !t || typeof t != "object") return;
+  const e = t;
+  if (typeof e.data == "string" && e.data.startsWith("0x"))
+    return e.data;
+  if (typeof e.revertData == "string" && e.revertData.startsWith("0x"))
+    return e.revertData;
+  if (typeof e.signature == "string" && e.signature.startsWith("0x"))
+    return e.signature;
+  if (typeof e.details == "string" && e.details.startsWith("0x"))
+    return e.details;
+  if (e.error && typeof e.error == "object") {
+    const n = e.error.data;
+    if (typeof n == "string" && n.startsWith("0x"))
+      return n;
+  }
+  if (e.cause) {
+    const n = o(e.cause, r + 1);
+    if (n) return n;
+  }
+  if (typeof e.walk == "function")
+    try {
+      let n;
+      if (e.walk((a) => {
+        if (a === t) return !1;
+        const c = o(a, r + 1);
+        return c ? (n = c, !0) : !1;
+      }), n) return n;
+    } catch {
+    }
+  if (r === 0) {
+    const a = (typeof e.message == "string" ? e.message : "").match(/\b(0x[a-fA-F0-9]{8})\b/);
+    if (a) return a[1];
+  }
+}
+function u(t) {
+  const r = s(t);
+  if (r) {
+    const e = r.substring(0, 10);
+    return i[r] ?? i[e];
+  }
+}
+function l(t) {
+  const r = s(t);
+  if (r === void 0) return !1;
+  const e = r.substring(0, 10);
+  return r in i || e in i;
+}
+function d(t) {
+  console.error("[Contract Error] Raw error:", t);
+  const r = s(t);
+  if (console.error("[Contract Error] Extracted error data:", r), r) {
+    const n = r.substring(0, 10), a = i[r] ?? i[n];
+    if (a)
+      throw console.error("[Contract Error] Known error:", a), new Error(a);
+  }
+  const e = (t == null ? void 0 : t.message) || "";
+  if (e.includes("gas limit too high") || e.includes("21000000") || e.includes("Internal JSON-RPC error")) {
+    const n = r ? ` (error code: ${r})` : "";
+    throw console.error(
+      "[Contract Error] Transaction rejected. Error code:",
+      r,
+      "Message:",
+      e
+    ), new Error(
+      `Transaction failed: The contract rejected this transaction${n}. Possible causes: (1) Vault already exists for this transaction, (2) Invalid signature, (3) Unauthorized caller. Please check your transaction parameters and try again.`
+    );
+  }
+  throw t instanceof Error ? (console.error("[Contract Error] Unhandled error:", t.message), t) : new Error(`Contract call failed: ${String(t)}`);
+}
+const p = [
+  {
+    type: "function",
+    name: "getBtcVaultProtocolInfo",
+    inputs: [
+      {
+        name: "vaultId",
+        type: "bytes32",
+        internalType: "bytes32"
+      }
+    ],
+    outputs: [
+      {
+        name: "vProtocol",
+        type: "tuple",
+        internalType: "struct BTCVaultRegistryTypes.BTCVaultProtocolInfo",
+        components: [
+          {
+            name: "depositorSignedPeginTx",
+            type: "bytes",
+            internalType: "bytes"
+          },
+          {
+            name: "universalChallengersVersion",
+            type: "uint16",
+            internalType: "uint16"
+          },
+          {
+            name: "appVaultKeepersVersion",
+            type: "uint16",
+            internalType: "uint16"
+          },
+          {
+            name: "offchainParamsVersion",
+            type: "uint16",
+            internalType: "uint16"
+          },
+          {
+            name: "verifiedAt",
+            type: "uint256",
+            internalType: "uint256"
+          },
+          {
+            name: "depositorWotsPkHash",
+            type: "bytes32",
+            internalType: "bytes32"
+          },
+          {
+            name: "hashlock",
+            type: "bytes32",
+            internalType: "bytes32"
+          },
+          {
+            name: "htlcVout",
+            type: "uint8",
+            internalType: "uint8"
+          },
+          {
+            name: "depositorPopSignature",
+            type: "bytes",
+            internalType: "bytes"
+          },
+          {
+            name: "prePeginTxHash",
+            type: "bytes32",
+            internalType: "bytes32"
+          },
+          {
+            name: "vaultProviderCommissionBps",
+            type: "uint16",
+            internalType: "uint16"
+          },
+          {
+            name: "claimExpiredUntil",
+            type: "uint256",
+            internalType: "uint256"
+          },
+          {
+            name: "vaultCoreVersion",
+            type: "uint16",
+            internalType: "uint16"
+          },
+          // RFC-006: per-pegin operation-key epochs, frozen at
+          // `submitPeginRequest`. All three pack into one storage slot and were
+          // appended after `vaultCoreVersion` so pre-existing rows decode
+          // unchanged.
+          {
+            name: "vpKeyEpoch",
+            type: "uint64",
+            internalType: "uint64"
+          },
+          {
+            name: "appKeeperKeyEpoch",
+            type: "uint64",
+            internalType: "uint64"
+          },
+          {
+            name: "ucKeyEpoch",
+            type: "uint64",
+            internalType: "uint64"
+          }
+        ]
+      }
+    ],
+    stateMutability: "view"
+  }
+];
+export {
+  p as B,
+  i as C,
+  s as e,
+  u as g,
+  d as h,
+  l as i
+};
+//# sourceMappingURL=BTCVaultRegistryKeyEpochs.abi-D8cIbMtH.js.map

package/dist/BTCVaultRegistryKeyEpochs.abi-D8cIbMtH.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BTCVaultRegistryKeyEpochs.abi-D8cIbMtH.js","sources":["../src/tbv/core/contracts/errors.ts","../src/tbv/core/contracts/abis/BTCVaultRegistryKeyEpochs.abi.ts"],"sourcesContent":["/**\n * Contract Error Handling Utilities\n *\n * Provides utilities for extracting and handling contract revert errors.\n * Maps known error selectors to user-friendly messages.\n *\n * @module contracts/errors\n */\n\n/**\n * Known contract error signatures mapped to user-friendly messages.\n *\n * Error selectors are the first 4 bytes of keccak256(error signature).\n * Example: keccak256(\"VaultAlreadyExists()\") = 0x04aabf33...\n */\nexport const CONTRACT_ERRORS: Record<string, string> = {\n  // VaultAlreadyExists()\n  \"0x04aabf33\":\n    \"Vault already exists: This Bitcoin transaction has already been registered. \" +\n    \"Please select different UTXOs or use a different amount to create a unique transaction.\",\n  // ScriptPubKeyMismatch() - taproot output doesn't match expected script\n  \"0x4fec082d\":\n    \"Script mismatch: The Bitcoin transaction's taproot output does not match the expected vault script. \" +\n    \"This may be caused by incorrect vault participants or key configuration.\",\n  // InvalidBTCProofOfPossession()\n  \"0x6cc363a5\":\n    \"Invalid BTC proof of possession: The signature could not be verified. \" +\n    \"Please ensure you're signing with the correct Bitcoin wallet.\",\n  // InvalidBTCPublicKey()\n  \"0x6c3f2bf6\":\n    \"Invalid BTC public key: The Bitcoin public key format is invalid.\",\n  // InvalidAmount()\n  \"0x2c5211c6\":\n    \"Invalid amount: The deposit amount is invalid or below the minimum required.\",\n  // ApplicationNotRegistered()\n  \"0x0405f772\":\n    \"Application not registered: The application controller is not registered in the system.\",\n  // InvalidProviderStatus()\n  \"0x24e165cc\":\n    \"Invalid provider status: The vault provider is not in a valid state to accept deposits.\",\n  // ZeroAddress()\n  \"0xd92e233d\":\n    \"Zero address: One of the required addresses is the zero address.\",\n  // BtcKeyMismatch()\n  \"0x65aa7007\":\n    \"BTC key mismatch: The Bitcoin public key does not match the expected key.\",\n  // Unauthorized()\n  \"0x82b42900\":\n    \"Unauthorized: You must be the depositor or vault provider to submit this transaction.\",\n  // InvalidSignature() - common signature verification error\n  \"0x8baa579f\":\n    \"Invalid signature: The BTC proof of possession signature could not be verified.\",\n  // InvalidBtcTransaction()\n  \"0x2f9d01e9\":\n    \"Invalid BTC transaction: The Bitcoin transaction format is invalid.\",\n  // VaultProviderNotRegistered()\n  \"0x5a3c6b3e\":\n    \"Vault provider not registered: The selected vault provider is not registered.\",\n  // InvalidPeginFee(uint256,uint256)\n  \"0x979f4518\":\n    \"Invalid pegin fee: The ETH fee sent does not match the required amount. \" +\n    \"This may indicate a fee rate change during the transaction.\",\n  // PrePeginOutputAlreadyUsed()\n  \"0x5fad9694\":\n    \"This pre-pegin output has already been used to activate another vault.\",\n  // PeginTransactionAlreadyUsed()\n  \"0x7ed061c9\":\n    \"This pegin transaction has already been used to activate another vault.\",\n  // DuplicateHashlock() — keccak256(abi.encodePacked(hashlock, msg.sender))\n  // collision in BTCVaultRegistry.hashlockToVaultId. Hashlocks are derived\n  // deterministically from the depositor's BTC wallet + selected UTXOs, so\n  // reusing the same UTXOs from the same wallet (even after a previous\n  // vault expires) produces the same hashlock and reverts here.\n  \"0x70f7d5e2\":\n    \"Duplicate deposit: a BTC Vault with this hashlock is already registered to your wallet. Hashlocks are derived from your BTC wallet and selected UTXOs — use different UTXOs to create a unique deposit.\",\n};\n\n/**\n * Extract error data from various error formats.\n *\n * Viem and wallet providers wrap errors in multiple levels. This function\n * searches through the error chain to find the revert data.\n *\n * @param error - The error object to extract data from\n * @returns The error data (e.g., \"0x04aabf33\") or undefined\n */\nexport function extractErrorData(error: unknown): string | undefined {\n  return walkForErrorData(error, 0);\n}\n\n/**\n * Walk an error chain looking for revert data in any of viem 2.x's known\n * shapes. Covers:\n *  - `.data: \"0x...\"` — raw revert hex (most common with `estimateGas`)\n *  - `.revertData: \"0x...\"` — alternate viem shape\n *  - `.signature: \"0x...\"` — 4-byte selector from a *decoded*\n *    ContractFunctionRevertedError (set when the ABI included the error def)\n *  - `.error.data: \"0x...\"` — RPC-level error shape from some providers\n *  - `.walk(fn)` — viem's chainable error walker (BaseError.walk)\n *  - `.cause` chain — viem wraps errors many layers deep\n *\n * Depth-limited (10) and walk-result-deduplicated so a cycle can't loop.\n */\nfunction walkForErrorData(\n  error: unknown,\n  depth: number,\n): string | undefined {\n  if (depth > 10 || !error || typeof error !== \"object\") return undefined;\n\n  const err = error as Record<string, unknown>;\n\n  if (typeof err.data === \"string\" && err.data.startsWith(\"0x\")) {\n    return err.data;\n  }\n  if (typeof err.revertData === \"string\" && err.revertData.startsWith(\"0x\")) {\n    return err.revertData;\n  }\n  if (typeof err.signature === \"string\" && err.signature.startsWith(\"0x\")) {\n    return err.signature;\n  }\n  if (typeof err.details === \"string\" && err.details.startsWith(\"0x\")) {\n    return err.details;\n  }\n\n  // RPC-level error shape (`{ error: { data: \"0x...\" } }`)\n  if (err.error && typeof err.error === \"object\") {\n    const inner = (err.error as Record<string, unknown>).data;\n    if (typeof inner === \"string\" && inner.startsWith(\"0x\")) {\n      return inner;\n    }\n  }\n\n  // Recurse through `.cause`\n  if (err.cause) {\n    const fromCause = walkForErrorData(err.cause, depth + 1);\n    if (fromCause) return fromCause;\n  }\n\n  // Use viem's `.walk()` if available\n  if (typeof err.walk === \"function\") {\n    try {\n      let found: string | undefined;\n      (err.walk as (fn: (e: unknown) => boolean) => unknown)((e) => {\n        if (e === error) return false; // avoid self-cycle\n        const data = walkForErrorData(e, depth + 1);\n        if (data) {\n          found = data;\n          return true;\n        }\n        return false;\n      });\n      if (found) return found;\n    } catch {\n      // walk failed; ignore\n    }\n  }\n\n  // Last resort: regex an embedded hex selector out of the message\n  if (depth === 0) {\n    const message = typeof err.message === \"string\" ? err.message : \"\";\n    const hexMatch = message.match(/\\b(0x[a-fA-F0-9]{8})\\b/);\n    if (hexMatch) return hexMatch[1];\n  }\n\n  return undefined;\n}\n\n/**\n * Get a user-friendly error message for a contract error.\n *\n * @param error - The error object from a contract call\n * @returns A user-friendly error message, or undefined if error is not recognized\n */\nexport function getContractErrorMessage(error: unknown): string | undefined {\n  const errorData = extractErrorData(error);\n  if (errorData) {\n    // Check exact match first, then match by 4-byte selector prefix.\n    // Parametric errors (e.g. InvalidPeginFee(uint256,uint256)) return\n    // the selector + ABI-encoded args, so the full string won't match.\n    const selector = errorData.substring(0, 10); // \"0x\" + 4 bytes\n    return CONTRACT_ERRORS[errorData] ?? CONTRACT_ERRORS[selector];\n  }\n  return undefined;\n}\n\n/**\n * Check if an error is a known contract error.\n *\n * @param error - The error object to check\n * @returns True if the error is a known contract error\n */\nexport function isKnownContractError(error: unknown): boolean {\n  const errorData = extractErrorData(error);\n  if (errorData === undefined) return false;\n  const selector = errorData.substring(0, 10);\n  return errorData in CONTRACT_ERRORS || selector in CONTRACT_ERRORS;\n}\n\n/**\n * Handle a contract error by throwing a user-friendly error.\n *\n * This function extracts error data, maps it to a user-friendly message,\n * and throws an appropriate error. Use this in catch blocks after contract calls.\n *\n * @param error - The error from a contract call\n * @throws Always throws an error with a descriptive message\n */\nexport function handleContractError(error: unknown): never {\n  // Log full error for debugging\n  console.error(\"[Contract Error] Raw error:\", error);\n\n  // Extract error data from the error chain\n  const errorData = extractErrorData(error);\n  console.error(\"[Contract Error] Extracted error data:\", errorData);\n\n  // Check for known contract error signatures (exact match or 4-byte selector prefix)\n  if (errorData) {\n    const selector = errorData.substring(0, 10);\n    const knownError = CONTRACT_ERRORS[errorData] ?? CONTRACT_ERRORS[selector];\n    if (knownError) {\n      console.error(\"[Contract Error] Known error:\", knownError);\n      throw new Error(knownError);\n    }\n  }\n\n  // Check for gas estimation errors or internal JSON-RPC errors\n  const errorMsg = (error as Error)?.message || \"\";\n  if (\n    errorMsg.includes(\"gas limit too high\") ||\n    errorMsg.includes(\"21000000\") ||\n    errorMsg.includes(\"Internal JSON-RPC error\")\n  ) {\n    // If we found error data but it's not in our known list, include it\n    const errorHint = errorData ? ` (error code: ${errorData})` : \"\";\n    console.error(\n      \"[Contract Error] Transaction rejected. Error code:\",\n      errorData,\n      \"Message:\",\n      errorMsg,\n    );\n    throw new Error(\n      `Transaction failed: The contract rejected this transaction${errorHint}. ` +\n        \"Possible causes: (1) Vault already exists for this transaction, \" +\n        \"(2) Invalid signature, (3) Unauthorized caller. \" +\n        \"Please check your transaction parameters and try again.\",\n    );\n  }\n\n  // Default: re-throw original error with better context\n  if (error instanceof Error) {\n    console.error(\"[Contract Error] Unhandled error:\", error.message);\n    throw error;\n  }\n  throw new Error(`Contract call failed: ${String(error)}`);\n}\n","/**\n * BTCVaultRegistry ABI — RFC-006 key-epoch view of `getBtcVaultProtocolInfo`.\n *\n * This is a deliberate second copy of a single function entry, NOT a\n * convenience re-export, and it must never be merged into\n * `BTCVaultRegistryABI`.\n *\n * `getBtcVaultProtocolInfo` returns a *positional* tuple. RFC-006 appended\n * three `uint64` epoch fields (`vpKeyEpoch`, `appKeeperKeyEpoch`,\n * `ucKeyEpoch`) after `vaultCoreVersion`. Declaring those three components\n * against a registry that predates RFC-006 makes viem read past the end of\n * the returndata and throw — and because the shared reader batches this call\n * through `multicall({ allowFailure: false })`, one bad decode fails the\n * whole batch. That would break vault status, resume, payout and refund\n * app-wide, on every network whose registry has not been upgraded yet.\n *\n * So the shared `BTCVaultRegistryABI` keeps the 13-field shape that decodes\n * against every deployed registry, and the extended shape lives here, read\n * only by `ViemVaultRegistryReader.getVaultKeyEpochs*` on the epoch-aware\n * path. Reading the same call through two ABIs is the price of keeping the\n * shared decode path independent of the registry version.\n *\n * The 13 shared components must stay an exact prefix of the 16 below;\n * `__tests__/abi-key-epochs.test.ts` pins that.\n *\n * Generated from vault-contracts-aave-v4\n * `src/protocol/lib/types/BTCVaultRegistryTypes.sol`.\n *\n * @module contracts/abis/BTCVaultRegistryKeyEpochs\n */\n\nexport const BTCVaultRegistryKeyEpochsABI = [\n  {\n    type: \"function\",\n    name: \"getBtcVaultProtocolInfo\",\n    inputs: [\n      {\n        name: \"vaultId\",\n        type: \"bytes32\",\n        internalType: \"bytes32\",\n      },\n    ],\n    outputs: [\n      {\n        name: \"vProtocol\",\n        type: \"tuple\",\n        internalType: \"struct BTCVaultRegistryTypes.BTCVaultProtocolInfo\",\n        components: [\n          {\n            name: \"depositorSignedPeginTx\",\n            type: \"bytes\",\n            internalType: \"bytes\",\n          },\n          {\n            name: \"universalChallengersVersion\",\n            type: \"uint16\",\n            internalType: \"uint16\",\n          },\n          {\n            name: \"appVaultKeepersVersion\",\n            type: \"uint16\",\n            internalType: \"uint16\",\n          },\n          {\n            name: \"offchainParamsVersion\",\n            type: \"uint16\",\n            internalType: \"uint16\",\n          },\n          {\n            name: \"verifiedAt\",\n            type: \"uint256\",\n            internalType: \"uint256\",\n          },\n          {\n            name: \"depositorWotsPkHash\",\n            type: \"bytes32\",\n            internalType: \"bytes32\",\n          },\n          {\n            name: \"hashlock\",\n            type: \"bytes32\",\n            internalType: \"bytes32\",\n          },\n          {\n            name: \"htlcVout\",\n            type: \"uint8\",\n            internalType: \"uint8\",\n          },\n          {\n            name: \"depositorPopSignature\",\n            type: \"bytes\",\n            internalType: \"bytes\",\n          },\n          {\n            name: \"prePeginTxHash\",\n            type: \"bytes32\",\n            internalType: \"bytes32\",\n          },\n          {\n            name: \"vaultProviderCommissionBps\",\n            type: \"uint16\",\n            internalType: \"uint16\",\n          },\n          {\n            name: \"claimExpiredUntil\",\n            type: \"uint256\",\n            internalType: \"uint256\",\n          },\n          {\n            name: \"vaultCoreVersion\",\n            type: \"uint16\",\n            internalType: \"uint16\",\n          },\n          // RFC-006: per-pegin operation-key epochs, frozen at\n          // `submitPeginRequest`. All three pack into one storage slot and were\n          // appended after `vaultCoreVersion` so pre-existing rows decode\n          // unchanged.\n          {\n            name: \"vpKeyEpoch\",\n            type: \"uint64\",\n            internalType: \"uint64\",\n          },\n          {\n            name: \"appKeeperKeyEpoch\",\n            type: \"uint64\",\n            internalType: \"uint64\",\n          },\n          {\n            name: \"ucKeyEpoch\",\n            type: \"uint64\",\n            internalType: \"uint64\",\n          },\n        ],\n      },\n    ],\n    stateMutability: \"view\",\n  },\n] as const;\n"],"names":["CONTRACT_ERRORS","extractErrorData","error","walkForErrorData","depth","err","inner","fromCause","found","e","data","hexMatch","getContractErrorMessage","errorData","selector","isKnownContractError","handleContractError","knownError","errorMsg","errorHint","BTCVaultRegistryKeyEpochsABI"],"mappings":"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"}