@vultisig/sdk 2.15.0 → 2.16.0

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @vultisig/sdk
 
+## 2.16.0
+
+### Minor Changes
+
+- [#984](https://github.com/vultisig/vultisig-sdk/pull/984) [`0147158`](https://github.com/vultisig/vultisig-sdk/commit/0147158ac6955aa420cdad2da704cba998e4a5f1) Thanks [@gomesalexandre](https://github.com/gomesalexandre)! - feat(utxo): OP_RETURN output in buildUtxoSendTx so UTXO THOR swaps carry the swap memo
+
+  Adds an optional `opReturnData` (UTF-8) to `BuildUtxoSendOptions`. When present,
+  `buildUtxoSendTx` appends a trailing 0-value OP_RETURN output carrying the memo,
+  enabling UTXO (DOGE/BTC/LTC/BCH) THORChain swaps: without the on-chain memo
+  THORChain cannot route the vaulted deposit, so the app currently fails closed on
+  these.
+
+  Fund-safety:
+
+  - The OP_RETURN is built inside `serializeOutputs`, so it feeds the outputs
+    digest every sighash variant consumes (BIP143 / legacy / Zcash). Every input
+    signature commits to the memo - it cannot be stripped or altered post-signing.
+  - The recipient (vault) output keeps the FULL amount; the OP_RETURN is a separate
+    0-value output and its size is folded into the fee estimate, so the fee comes
+    from inputs/change, never by shaving the vault output.
+  - Payload is capped at the 80-byte standard-relay limit (direct push <= 75 bytes,
+    OP_PUSHDATA1 for 76..80); larger memos throw rather than build a non-standard,
+    unbroadcastable tx.
+
 ## 2.15.0
 
 ### Patch Changes

package/dist/index.react-native.d.ts

@@ -1864,6 +1864,15 @@ type BuildUtxoSendOptions = {
      * stale compiled fallback.
      */
     zcashBranchId?: number;
+    /**
+     * Optional UTF-8 data (typically a THORChain swap memo) embedded on-chain as
+     * a trailing 0-value OP_RETURN output. Standard-relay policy caps this at 80
+     * bytes; longer memos throw. The memo feeds the sighash outputs digest, so
+     * every input signature commits to it — the signed tx cannot be rebroadcast
+     * with the memo stripped or altered. Required for UTXO THORChain swaps
+     * (DOGE/BTC/LTC/BCH): without it THORChain can't route the deposit.
+     */
+    opReturnData?: string;
 };
 type UtxoTxBuilderResult = {
     /** SHA-256d preimage hashes to sign, one per input, hex-encoded (no 0x prefix) */