@anywalletkit/wallet-btc 0.2.4 → 0.3.0

package/dist/index.cjs

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   BlockbookClient: () => BlockbookClient,
+  BroadcastUnknownError: () => BroadcastUnknownError,
   CAIP2_GENESIS: () => CAIP2_GENESIS,
   DEFAULT_MAX_FEE_RATE: () => DEFAULT_MAX_FEE_RATE,
   DUST_LIMIT_P2TR: () => DUST_LIMIT_P2TR,
@@ -54,6 +55,7 @@ __export(src_exports, {
   encodeHistoryCursor: () => encodeCursor,
   encodeMessageSignature: () => encodeMessageSignature,
   estimateVsize: () => estimateVsize,
+  isAnsweredRefusal: () => isAnsweredRefusal,
   magicHash: () => magicHash,
   mapBlockbookTx: () => mapBlockbookTx,
   networkParams: () => networkParams,
@@ -102,9 +104,17 @@ var UnsupportedAddressTypeError = class extends Error {
     this.name = "UnsupportedAddressTypeError";
   }
 };
-
-// src/blockbook.ts
-var import_core3 = require("@anywalletkit/core");
+var BroadcastUnknownError = class extends Error {
+  /** Always true: the transaction may be on its way. */
+  maybeSent = true;
+  /** The transaction id (hex). */
+  hash;
+  constructor(hash, cause) {
+    super(`Broadcast outcome unknown for ${hash}: ${cause instanceof Error ? cause.message.slice(0, 200) : String(cause).slice(0, 200)}`, { cause });
+    this.name = "BroadcastUnknownError";
+    this.hash = hash;
+  }
+};
 
 // src/http.ts
 var import_core2 = require("@anywalletkit/core");
@@ -117,11 +127,25 @@ async function fetchWithTimeout(fetchFn, url, init, timeoutMs, provider) {
     throw new import_core2.NetworkError(`Request failed: ${url}`, { provider, cause: e });
   }
 }
+var refusedStatus = (status) => status >= 400 && status < 500 && status !== 408;
+function refusal(e) {
+  return Object.assign(e, { answered: true });
+}
+function isAnsweredRefusal(e) {
+  return e?.answered === true;
+}
+function isAlreadyKnown(e) {
+  for (let x = e, depth = 0; x instanceof Error && depth < 5; x = x.cause, depth++) {
+    if (/txn-already-(in-mempool|known)|already (known|in (the )?(mempool|block ?chain))/i.test(x.message)) return true;
+  }
+  return false;
+}
 var isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 var isHex64 = (v) => typeof v === "string" && /^[0-9a-fA-F]{64}$/.test(v);
 var isIntString = (v) => typeof v === "string" && /^-?\d+$/.test(v);
 
 // src/blockbook.ts
+var import_core3 = require("@anywalletkit/core");
 var MEMPOOL_SPACE_URL = "https://mempool.space";
 function unconfirmedOutgoing(transactions, address) {
   const pending = (transactions ?? []).filter((tx) => tx.blockHeight === -1);
@@ -162,7 +186,11 @@ var BlockbookClient = class _BlockbookClient {
   async get(path, check) {
     const url = `${this.base}/api${path}`;
     const res = await fetchWithTimeout(this.fetchFn, url, void 0, this.timeoutMs, this.base);
-    if (!res.ok) throw new import_core3.NetworkError(`Blockbook request failed: ${res.status} ${res.statusText} (${url})`, { provider: this.base });
+    if (!res.ok) {
+      const reason = refusedStatus(res.status) ? (await res.text().catch(() => "")).slice(0, 200) : "";
+      const err = new import_core3.NetworkError(`Blockbook request failed: ${res.status} ${res.statusText} (${url})${reason ? `: ${reason}` : ""}`, { provider: this.base });
+      throw refusedStatus(res.status) ? refusal(err) : err;
+    }
     let body;
     try {
       body = await res.json();
@@ -226,7 +254,7 @@ var BlockbookClient = class _BlockbookClient {
   }
   async broadcast(rawTx) {
     const data = await this.get(`/v2/sendtx/${rawTx}`, (v) => isRecord(v));
-    if (data.error) throw new Error(typeof data.error === "string" ? data.error : data.error.message ?? "broadcast failed");
+    if (data.error) throw refusal(new Error(typeof data.error === "string" ? data.error : data.error.message ?? "broadcast failed"));
     if (!data.result) throw new import_core3.NetworkError("Blockbook returned no txid", { provider: this.base });
     return data.result;
   }
@@ -274,7 +302,11 @@ var EsploraClient = class {
   async request(path, init) {
     const url = `${this.base}${path}`;
     const res = await fetchWithTimeout(this.fetchFn, url, init, this.timeoutMs, this.base);
-    if (!res.ok) throw new import_core4.NetworkError(`Esplora request failed: ${res.status} ${res.statusText} (${url})`, { provider: this.base });
+    if (!res.ok) {
+      const reason = refusedStatus(res.status) ? (await res.text().catch(() => "")).slice(0, 200) : "";
+      const err = new import_core4.NetworkError(`Esplora request failed: ${res.status} ${res.statusText} (${url})${reason ? `: ${reason}` : ""}`, { provider: this.base });
+      throw refusedStatus(res.status) ? refusal(err) : err;
+    }
     return res;
   }
   async json(path, check) {
@@ -379,6 +411,7 @@ function createClient(config) {
   const attempts = list.length + (config.retries ?? 3);
   const call = (method) => async (...args) => {
     let last;
+    let answered = true;
     for (let i = 0; i < attempts; i++) {
       const c = list[i % list.length];
       const fn = c[method];
@@ -387,9 +420,11 @@ function createClient(config) {
         return await fn.apply(c, args);
       } catch (e) {
         last = e;
+        answered &&= isAnsweredRefusal(e);
       }
     }
-    throw new import_core5.NetworkError(`All BTC clients failed for ${method}`, { cause: last });
+    const err = new import_core5.NetworkError(`All BTC clients failed for ${method}`, { cause: last });
+    throw answered && last !== void 0 ? refusal(err) : err;
   };
   const out = {};
   for (const m of METHODS) out[m] = call(m);
@@ -610,11 +645,28 @@ function describeTransaction(tx, inputValues, ctx) {
   });
   const outputs = [];
   const warnings = /* @__PURE__ */ new Set();
+  const scriptOf = (address) => {
+    try {
+      return import_base2.hex.encode(decodeAddress(address, ctx.network).script);
+    } catch {
+      return void 0;
+    }
+  };
+  const ownScript = scriptOf(ctx.ownAddress);
+  const intendedScript = ctx.intended ? scriptOf(ctx.intended.to) : void 0;
+  let recipientSeen = false;
   for (let i = 0; i < tx.outputsLength; i++) {
     const out = tx.getOutput(i);
     const value = out.amount ?? 0n;
     const address = tx.getOutputAddress(i, ctx.network);
-    const role = address !== void 0 && address === ctx.ownAddress ? "change" : ctx.intended === void 0 ? "recipient" : address !== void 0 && address === ctx.intended.to && value === ctx.intended.value ? "recipient" : "unknown";
+    const script = out.script ? import_base2.hex.encode(out.script) : void 0;
+    const mine = script !== void 0 && script === ownScript;
+    let role;
+    if (ctx.intended === void 0) role = mine ? "change" : "recipient";
+    else if (!recipientSeen && script !== void 0 && script === intendedScript && value === ctx.intended.value) {
+      role = "recipient";
+      recipientSeen = true;
+    } else role = mine ? "change" : "unknown";
     if (out.script && value < dustLimit(scriptKind(out.script))) warnings.add("dust-output");
     outputs.push({ address, value, role });
   }
@@ -901,7 +953,7 @@ var WalletAccountBtc = class _WalletAccountBtc extends WalletAccountReadOnlyBtc
   ctx(intended) {
     return { network: this._network, ownAddress: this.address, intended, maxFeeRate: this.maxFeeRate };
   }
-  async buildAndSign(plan, to, recipientValue, change, lockTime, rbf) {
+  async signPlan(plan, to, recipientValue, change, lockTime, rbf) {
     const spend = spendInfo(this.publicKey, this._network, this.addressType);
     const tx = new import_btc_signer4.Transaction({ lockTime });
     const sequence = rbf ? RBF_SEQUENCE : FINAL_SEQUENCE;
@@ -919,7 +971,7 @@ var WalletAccountBtc = class _WalletAccountBtc extends WalletAccountReadOnlyBtc
    * signed vsize somehow needs more, the difference comes out of change (never the
    * recipient) and the tx is re-signed once.
    */
-  async buildSignedTransaction(spend) {
+  async signSpend(spend) {
     this.live();
     const plan = await this.planSpend(spend);
     await this.verifyPrevouts(plan.utxos);
@@ -927,7 +979,7 @@ var WalletAccountBtc = class _WalletAccountBtc extends WalletAccountReadOnlyBtc
     const rbf = spend.rbf ?? this._config.rbf ?? true;
     let change = plan.change;
     let fee = plan.fee;
-    let tx = await this.buildAndSign(plan, spend.to, plan.amount, change, lockTime, rbf);
+    let tx = await this.signPlan(plan, spend.to, plan.amount, change, lockTime, rbf);
     const required = BigInt(tx.vsize) * plan.feeRate;
     if (required > fee) {
       const delta = required - fee;
@@ -940,7 +992,7 @@ var WalletAccountBtc = class _WalletAccountBtc extends WalletAccountReadOnlyBtc
         fee = plan.fee + plan.change;
         change = 0n;
       } else fee = required;
-      tx = await this.buildAndSign(plan, spend.to, plan.amount, change, lockTime, rbf);
+      tx = await this.signPlan(plan, spend.to, plan.amount, change, lockTime, rbf);
       if (BigInt(tx.vsize) * plan.feeRate > fee) throw new Error("Fee shortfall after output rebalance.");
     }
     const ctx = this.ctx({ to: spend.to, value: plan.amount });
@@ -1011,7 +1063,7 @@ var WalletAccountBtc = class _WalletAccountBtc extends WalletAccountReadOnlyBtc
   /** "What you sign": the fully resolved spend (signed, NOT broadcast) or a caller's raw hex. */
   async describeTransaction(tx) {
     if (typeof tx === "string") return (await this.describeRaw(tx)).desc;
-    return (await this.buildSignedTransaction(tx)).desc;
+    return (await this.signSpend(tx)).desc;
   }
   /** Sign without broadcasting. Returns the raw transaction hex. Raw hex input gets the checks `sendTransaction` runs (prevouts through the client) and is returned unchanged, never re-signed. */
   async signTransaction(tx, options = {}) {
@@ -1021,7 +1073,7 @@ var WalletAccountBtc = class _WalletAccountBtc extends WalletAccountReadOnlyBtc
       this.checkMax(desc.fee, (0, import_core9.feeLimit)(this._config.transactionMaxFee, options), "transaction");
       return tx;
     }
-    const { tx: built, fee } = await this.buildSignedTransaction(tx);
+    const { tx: built, fee } = await this.signSpend(tx);
     this.checkMax(fee, (0, import_core9.feeLimit)(this._config.transactionMaxFee, options), "transaction");
     return built.hex;
   }
@@ -1039,24 +1091,36 @@ var WalletAccountBtc = class _WalletAccountBtc extends WalletAccountReadOnlyBtc
       hash = parsed.id;
       fee = desc.fee;
     } else {
-      const built = await this.buildSignedTransaction(tx);
+      const built = await this.signSpend(tx);
       rawHex = built.tx.hex;
       hash = built.tx.id;
       fee = built.fee;
     }
     this.checkMax(fee, (0, import_core9.feeLimit)(this._config.transactionMaxFee, options), "transaction");
-    const txid = await client.broadcast(rawHex);
-    return { hash: txid || hash, fee };
+    return { hash: await this.broadcast(client, rawHex, hash), fee };
   }
   /** Native BTC only (`token` is rejected). Subject to `transferMaxFee`. */
   async transfer(o, writeOptions = {}) {
     if (o.token) throw new Error("Tokens are not supported on the bitcoin blockchain.");
     this.live();
     const client = this.requireClient("transfer");
-    const built = await this.buildSignedTransaction({ to: o.recipient, value: o.amount });
+    const built = await this.signSpend({ to: o.recipient, value: o.amount });
     this.checkMax(built.fee, (0, import_core9.feeLimit)(this._config.transferMaxFee, writeOptions), "transfer");
-    const txid = await client.broadcast(built.tx.hex);
-    return { hash: txid || built.tx.id, fee: built.fee };
+    return { hash: await this.broadcast(client, built.tx.hex, built.tx.id), fee: built.fee };
+  }
+  /**
+   * Send once through the client. Only a node's refusal means nothing went out; "already in the
+   * mempool / block chain" means an earlier attempt delivered it; anything else may have landed and
+   * is a {@link BroadcastUnknownError} with the txid computed before sending (round 3, M12).
+   */
+  async broadcast(client, rawHex, txid) {
+    try {
+      return await client.broadcast(rawHex) || txid;
+    } catch (e) {
+      if (isAlreadyKnown(e)) return txid;
+      if (isAnsweredRefusal(e)) throw e;
+      throw new BroadcastUnknownError(txid, e);
+    }
   }
   /** The same address as a {@link WalletAccountReadOnlyBtc}. */
   toReadOnlyAccount() {