From de806b91ad9a94d1c457c2942c8d8e5ac76d3d10 Mon Sep 17 00:00:00 2001
From: Otto Allmendinger <otto@bitgo.com>
Date: Thu, 29 Jan 2026 14:20:09 +0100
Subject: [PATCH] feat(wasm-utxo): add hasPsbtMagic utility function

Creates a utility function to check if a byte array contains the PSBT magic
bytes header. Exports the function through the main package index.

Issue: BTC-2980

Co-authored-by: llm-git <llm-git@ttll.de>
---
 packages/wasm-utxo/js/index.ts |  1 +
 packages/wasm-utxo/js/psbt.ts  | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 33 insertions(+)
 create mode 100644 packages/wasm-utxo/js/psbt.ts

diff --git a/packages/wasm-utxo/js/index.ts b/packages/wasm-utxo/js/index.ts
index c318c31a28a..75dc66ca9b8 100644
--- a/packages/wasm-utxo/js/index.ts
+++ b/packages/wasm-utxo/js/index.ts
@@ -68,3 +68,4 @@ export { WrapDescriptor as Descriptor } from "./wasm/wasm_utxo.js";
 export { WrapMiniscript as Miniscript } from "./wasm/wasm_utxo.js";
 export { WrapPsbt as Psbt } from "./wasm/wasm_utxo.js";
 export { DashTransaction, Transaction, ZcashTransaction } from "./transaction.js";
+export { hasPsbtMagic } from "./psbt.js";
diff --git a/packages/wasm-utxo/js/psbt.ts b/packages/wasm-utxo/js/psbt.ts
new file mode 100644
index 00000000000..98929dde282
--- /dev/null
+++ b/packages/wasm-utxo/js/psbt.ts
@@ -0,0 +1,32 @@
+/** PSBT magic bytes: "psbt" (0x70 0x73 0x62 0x74) followed by separator 0xff */
+const PSBT_MAGIC = new Uint8Array([0x70, 0x73, 0x62, 0x74, 0xff]);
+
+/**
+ * Check if a byte array has the PSBT magic bytes
+ *
+ * PSBTs start with the magic bytes "psbt" (0x70 0x73 0x62 0x74) followed by a separator 0xff.
+ * This method checks if the given bytes start with these 5 magic bytes.
+ *
+ * @param bytes - The byte array to check
+ * @returns true if the bytes start with PSBT magic, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { hasPsbtMagic } from "@bitgo/wasm-utxo";
+ *
+ * if (hasPsbtMagic(data)) {
+ *   const psbt = BitGoPsbt.fromBytes(data, network);
+ * }
+ * ```
+ */
+export function hasPsbtMagic(bytes: Uint8Array): boolean {
+  if (bytes.length < PSBT_MAGIC.length) {
+    return false;
+  }
+  for (let i = 0; i < PSBT_MAGIC.length; i++) {
+    if (bytes[i] !== PSBT_MAGIC[i]) {
+      return false;
+    }
+  }
+  return true;
+}