@lifi/sdk-provider-bitcoin 4.0.1-alpha.0 → 4.0.1

package/dist/esm/types.d.ts

@@ -1,9 +1,20 @@
-import type { Client } from '@bigmi/core';
-import { type SDKProvider } from '@lifi/sdk';
-export interface BitcoinProviderOptions {
-    getWalletClient?: () => Promise<Client>;
+import { PublicClient } from "./client/publicClient.js";
+import { Client } from "@bigmi/core";
+import { LiFiStepExtended, SDKProvider, StepExecutorContext } from "@lifi/sdk";
+
+//#region src/types.d.ts
+interface BitcoinProviderOptions {
+  getWalletClient?: () => Promise<Client>;
 }
-export interface BitcoinSDKProvider extends SDKProvider {
-    setOptions(options: BitcoinProviderOptions): void;
+interface BitcoinStepExecutorContext extends StepExecutorContext {
+  walletClient: Client;
+  publicClient: PublicClient;
+  checkClient: (step: LiFiStepExtended) => void;
 }
-export declare function isBitcoinProvider(provider: SDKProvider): provider is BitcoinSDKProvider;
+interface BitcoinSDKProvider extends SDKProvider {
+  setOptions(options: BitcoinProviderOptions): void;
+}
+declare function isBitcoinProvider(provider: SDKProvider): provider is BitcoinSDKProvider;
+//#endregion
+export { BitcoinProviderOptions, BitcoinSDKProvider, BitcoinStepExecutorContext, isBitcoinProvider };
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/types.ts"],"mappings":";;;;;UASiB,sBAAA;EACf,eAAA,SAAwB,OAAA,CAAQ,MAAA;AAAA;AAAA,UAGjB,0BAAA,SAAmC,mBAAA;EAClD,YAAA,EAAc,MAAA;EACd,YAAA,EAAc,YAAA;EACd,WAAA,GAAc,IAAA,EAAM,gBAAA;AAAA;AAAA,UAGL,kBAAA,SAA2B,WAAA;EAC1C,UAAA,CAAW,OAAA,EAAS,sBAAA;AAAA;AAAA,iBAGN,iBAAA,CACd,QAAA,EAAU,WAAA,GACT,QAAA,IAAY,kBAAA"}

package/dist/esm/types.js

@@ -1,5 +1,9 @@
-import { ChainType } from '@lifi/sdk';
-export function isBitcoinProvider(provider) {
-    return provider.type === ChainType.UTXO;
+import { ChainType } from "@lifi/sdk";
+//#region src/types.ts
+function isBitcoinProvider(provider) {
+	return provider.type === ChainType.UTXO;
 }
+//#endregion
+export { isBitcoinProvider };
+
 //# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAoB,MAAM,WAAW,CAAA;AAUvD,MAAM,UAAU,iBAAiB,CAC/B,QAAqB;IAErB,OAAO,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,CAAA;AACzC,CAAC"}
+{"version":3,"file":"types.js","names":[],"sources":["../../src/types.ts"],"sourcesContent":["import type { Client } from '@bigmi/core'\nimport {\n  ChainType,\n  type LiFiStepExtended,\n  type SDKProvider,\n  type StepExecutorContext,\n} from '@lifi/sdk'\nimport type { PublicClient } from './client/publicClient.js'\n\nexport interface BitcoinProviderOptions {\n  getWalletClient?: () => Promise<Client>\n}\n\nexport interface BitcoinStepExecutorContext extends StepExecutorContext {\n  walletClient: Client\n  publicClient: PublicClient\n  checkClient: (step: LiFiStepExtended) => void\n}\n\nexport interface BitcoinSDKProvider extends SDKProvider {\n  setOptions(options: BitcoinProviderOptions): void\n}\n\nexport function isBitcoinProvider(\n  provider: SDKProvider\n): provider is BitcoinSDKProvider {\n  return provider.type === ChainType.UTXO\n}\n"],"mappings":";;AAuBA,SAAgB,kBACd,UACgC;CAChC,OAAO,SAAS,SAAS,UAAU;AACrC"}

package/dist/esm/utils/generateRedeemScript.d.ts

@@ -1,6 +1,10 @@
+//#region src/utils/generateRedeemScript.d.ts
 /**
- * Generate redeem script for P2SH addresses
- * @param publicKey
- * @returns redeem script
- */
-export declare const generateRedeemScript: (publicKey: Uint8Array) => Uint8Array<ArrayBufferLike> | undefined;
+* Generate redeem script for P2SH addresses
+* @param publicKey
+* @returns redeem script
+*/
+declare const generateRedeemScript: (publicKey: Uint8Array) => Uint8Array | undefined;
+//#endregion
+export { generateRedeemScript };
+//# sourceMappingURL=generateRedeemScript.d.ts.map

package/dist/esm/utils/generateRedeemScript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateRedeemScript.d.ts","names":[],"sources":["../../../src/utils/generateRedeemScript.ts"],"mappings":";;AAOA;;;;cAAa,oBAAA,GACX,SAAA,EAAW,UAAA,KACV,UAAA"}

package/dist/esm/utils/generateRedeemScript.js

@@ -1,10 +1,12 @@
-import { payments } from 'bitcoinjs-lib';
+import { payments } from "bitcoinjs-lib";
+//#region src/utils/generateRedeemScript.ts
 /**
- * Generate redeem script for P2SH addresses
- * @param publicKey
- * @returns redeem script
- */
-export const generateRedeemScript = (publicKey) => 
-// P2SH addresses are created by hashing the public key and using the result as the script
-payments.p2wpkh({ pubkey: publicKey }).output;
+* Generate redeem script for P2SH addresses
+* @param publicKey
+* @returns redeem script
+*/
+const generateRedeemScript = (publicKey) => payments.p2wpkh({ pubkey: publicKey }).output;
+//#endregion
+export { generateRedeemScript };
+
 //# sourceMappingURL=generateRedeemScript.js.map

package/dist/esm/utils/generateRedeemScript.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateRedeemScript.js","sourceRoot":"","sources":["../../../src/utils/generateRedeemScript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,SAAqB,EAAE,EAAE;AAC5D,0FAA0F;AAC1F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAA"}
+{"version":3,"file":"generateRedeemScript.js","names":[],"sources":["../../../src/utils/generateRedeemScript.ts"],"sourcesContent":["import { payments } from 'bitcoinjs-lib'\n\n/**\n * Generate redeem script for P2SH addresses\n * @param publicKey\n * @returns redeem script\n */\nexport const generateRedeemScript = (\n  publicKey: Uint8Array\n): Uint8Array | undefined =>\n  // P2SH addresses are created by hashing the public key and using the result as the script\n  payments.p2wpkh({ pubkey: publicKey }).output\n"],"mappings":";;;;;;;AAOA,MAAa,wBACX,cAGA,SAAS,OAAO,EAAE,QAAQ,UAAU,CAAC,CAAC,CAAC"}

package/dist/esm/utils/isPsbtFinalized.d.ts

@@ -1,2 +1,7 @@
-import type { Psbt } from 'bitcoinjs-lib';
-export declare function isPsbtFinalized(psbt: Psbt): boolean;
+import { Psbt } from "bitcoinjs-lib";
+
+//#region src/utils/isPsbtFinalized.d.ts
+declare function isPsbtFinalized(psbt: Psbt): boolean;
+//#endregion
+export { isPsbtFinalized };
+//# sourceMappingURL=isPsbtFinalized.d.ts.map

package/dist/esm/utils/isPsbtFinalized.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isPsbtFinalized.d.ts","names":[],"sources":["../../../src/utils/isPsbtFinalized.ts"],"mappings":";;;iBAEgB,eAAA,CAAgB,IAAM,EAAA,IAAA"}

package/dist/esm/utils/isPsbtFinalized.js

@@ -1,10 +1,13 @@
-export function isPsbtFinalized(psbt) {
-    try {
-        psbt.extractTransaction();
-        return true;
-    }
-    catch (_) {
-        return false;
-    }
+//#region src/utils/isPsbtFinalized.ts
+function isPsbtFinalized(psbt) {
+	try {
+		psbt.extractTransaction();
+		return true;
+	} catch (_) {
+		return false;
+	}
 }
+//#endregion
+export { isPsbtFinalized };
+
 //# sourceMappingURL=isPsbtFinalized.js.map

package/dist/esm/utils/isPsbtFinalized.js.map

@@ -1 +1 @@
-{"version":3,"file":"isPsbtFinalized.js","sourceRoot":"","sources":["../../../src/utils/isPsbtFinalized.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,IAAU;IACxC,IAAI,CAAC;QACH,IAAI,CAAC,kBAAkB,EAAE,CAAA;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"isPsbtFinalized.js","names":[],"sources":["../../../src/utils/isPsbtFinalized.ts"],"sourcesContent":["import type { Psbt } from 'bitcoinjs-lib'\n\nexport function isPsbtFinalized(psbt: Psbt): boolean {\n  try {\n    psbt.extractTransaction()\n    return true\n  } catch (_) {\n    return false\n  }\n}\n"],"mappings":";AAEA,SAAgB,gBAAgB,MAAqB;CACnD,IAAI;EACF,KAAK,mBAAmB;EACxB,OAAO;CACT,SAAS,GAAG;EACV,OAAO;CACT;AACF"}

package/dist/esm/utils/toBigmiChainId.d.ts

@@ -1,3 +1,8 @@
-import { ChainId as BigmiChainId } from '@bigmi/core';
-import { ChainId } from '@lifi/sdk';
-export declare const toBigmiChainId: (chainId: ChainId) => BigmiChainId;
+import { ChainId } from "@bigmi/core";
+import { ChainId as ChainId$1 } from "@lifi/sdk";
+
+//#region src/utils/toBigmiChainId.d.ts
+declare const toBigmiChainId: (chainId: ChainId$1) => ChainId;
+//#endregion
+export { toBigmiChainId };
+//# sourceMappingURL=toBigmiChainId.d.ts.map

package/dist/esm/utils/toBigmiChainId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toBigmiChainId.d.ts","names":[],"sources":["../../../src/utils/toBigmiChainId.ts"],"mappings":";;;;cAGa,cAAA,GAAkB,OAAA,EAAS,SAAA,KAAU,OAAA"}

package/dist/esm/utils/toBigmiChainId.js

@@ -1,11 +1,13 @@
-import { ChainId as BigmiChainId } from '@bigmi/core';
-import { ChainId } from '@lifi/sdk';
-export const toBigmiChainId = (chainId) => {
-    switch (chainId) {
-        case ChainId.BTC:
-            return BigmiChainId.BITCOIN_MAINNET;
-        default:
-            throw new Error(`Unsupported chainId mapping: ${chainId}`);
-    }
+import { ChainId } from "@bigmi/core";
+import { ChainId as ChainId$1 } from "@lifi/sdk";
+//#region src/utils/toBigmiChainId.ts
+const toBigmiChainId = (chainId) => {
+	switch (chainId) {
+		case ChainId$1.BTC: return ChainId.BITCOIN_MAINNET;
+		default: throw new Error(`Unsupported chainId mapping: ${chainId}`);
+	}
 };
+//#endregion
+export { toBigmiChainId };
+
 //# sourceMappingURL=toBigmiChainId.js.map

package/dist/esm/utils/toBigmiChainId.js.map

@@ -1 +1 @@
-{"version":3,"file":"toBigmiChainId.js","sourceRoot":"","sources":["../../../src/utils/toBigmiChainId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAgB,EAAgB,EAAE;IAC/D,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO,CAAC,GAAG;YACd,OAAO,YAAY,CAAC,eAAe,CAAA;QACrC;YACE,MAAM,IAAI,KAAK,CAAC,gCAAgC,OAAO,EAAE,CAAC,CAAA;IAC9D,CAAC;AACH,CAAC,CAAA"}
+{"version":3,"file":"toBigmiChainId.js","names":["ChainId","BigmiChainId"],"sources":["../../../src/utils/toBigmiChainId.ts"],"sourcesContent":["import { ChainId as BigmiChainId } from '@bigmi/core'\nimport { ChainId } from '@lifi/sdk'\n\nexport const toBigmiChainId = (chainId: ChainId): BigmiChainId => {\n  switch (chainId) {\n    case ChainId.BTC:\n      return BigmiChainId.BITCOIN_MAINNET\n    default:\n      throw new Error(`Unsupported chainId mapping: ${chainId}`)\n  }\n}\n"],"mappings":";;;AAGA,MAAa,kBAAkB,YAAmC;CAChE,QAAQ,SAAR;EACE,KAAKA,UAAQ,KACX,OAAOC,QAAa;EACtB,SACE,MAAM,IAAI,MAAM,gCAAgC,SAAS;CAC7D;AACF"}

package/dist/esm/utils/toXOnly.d.ts

@@ -1 +1,5 @@
-export declare const toXOnly: (pubKey: Uint8Array) => Uint8Array<ArrayBufferLike>;
+//#region src/utils/toXOnly.d.ts
+declare const toXOnly: (pubKey: Uint8Array) => Uint8Array;
+//#endregion
+export { toXOnly };
+//# sourceMappingURL=toXOnly.d.ts.map

package/dist/esm/utils/toXOnly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toXOnly.d.ts","names":[],"sources":["../../../src/utils/toXOnly.ts"],"mappings":";cACa,OAAA,GAAW,MAAA,EAAQ,UAAA,KAAa,UAAA"}

package/dist/esm/utils/toXOnly.js

@@ -1,3 +1,6 @@
-// helper function to convert full public key (33 bytes) to x-only compressed format (32 bytes) required after taproot update
-export const toXOnly = (pubKey) => pubKey.length === 32 ? pubKey : pubKey.subarray(1, 33);
+//#region src/utils/toXOnly.ts
+const toXOnly = (pubKey) => pubKey.length === 32 ? pubKey : pubKey.subarray(1, 33);
+//#endregion
+export { toXOnly };
+
 //# sourceMappingURL=toXOnly.js.map

package/dist/esm/utils/toXOnly.js.map

@@ -1 +1 @@
-{"version":3,"file":"toXOnly.js","sourceRoot":"","sources":["../../../src/utils/toXOnly.ts"],"names":[],"mappings":"AAAA,6HAA6H;AAC7H,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAkB,EAAE,EAAE,CAC5C,MAAM,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA"}
+{"version":3,"file":"toXOnly.js","names":[],"sources":["../../../src/utils/toXOnly.ts"],"sourcesContent":["// helper function to convert full public key (33 bytes) to x-only compressed format (32 bytes) required after taproot update\nexport const toXOnly = (pubKey: Uint8Array): Uint8Array =>\n  pubKey.length === 32 ? pubKey : pubKey.subarray(1, 33)\n"],"mappings":";AACA,MAAa,WAAW,WACtB,OAAO,WAAW,KAAK,SAAS,OAAO,SAAS,GAAG,EAAE"}

package/dist/esm/version.d.ts

@@ -1,2 +1,6 @@
-export declare const name = "@lifi/sdk-provider-bitcoin";
-export declare const version = "4.0.1-alpha.0";
+//#region src/version.d.ts
+declare const name = "@lifi/sdk-provider-bitcoin";
+declare const version = "4.0.1";
+//#endregion
+export { name, version };
+//# sourceMappingURL=version.d.ts.map

package/dist/esm/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","names":[],"sources":["../../src/version.ts"],"mappings":";cAAa,IAAA;AAAA,cACA,OAAA"}

package/dist/esm/version.js

@@ -1,3 +1,7 @@
-export const name = '@lifi/sdk-provider-bitcoin';
-export const version = '4.0.1-alpha.0';
+//#region src/version.ts
+const name = "@lifi/sdk-provider-bitcoin";
+const version = "4.0.1";
+//#endregion
+export { name, version };
+
 //# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,4BAA4B,CAAA;AAChD,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAA"}
+{"version":3,"file":"version.js","names":[],"sources":["../../src/version.ts"],"sourcesContent":["export const name = '@lifi/sdk-provider-bitcoin'\nexport const version = '4.0.1'\n"],"mappings":";AAAA,MAAa,OAAO;AACpB,MAAa,UAAU"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/sdk-provider-bitcoin",
-  "version": "4.0.1-alpha.0",
+  "version": "4.0.1",
   "description": "LI.FI Bitcoin SDK Provider for Any-to-Any Cross-Chain-Swap",
   "homepage": "https://github.com/lifinance/sdk",
   "bugs": {
@@ -17,27 +17,28 @@
   "sideEffects": false,
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
-  "types": "./dist/types/index.d.ts",
-  "typings": "./dist/types/index.d.ts",
+  "types": "./dist/esm/index.d.ts",
+  "typings": "./dist/esm/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/types/index.d.ts",
+      "types": "./dist/esm/index.d.ts",
       "import": "./dist/esm/index.js",
       "default": "./dist/cjs/index.js"
     },
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@bigmi/core": "^0.6.5",
+    "@bigmi/core": "^0.8.1",
     "@bitcoinerlab/secp256k1": "^1.2.0",
     "bech32": "^2.0.0",
     "bitcoinjs-lib": "^7.0.1",
-    "@lifi/sdk": "4.0.1-alpha.0"
+    "@lifi/sdk": "4.0.1"
   },
   "publishConfig": {
     "access": "public"
   },
   "files": [
+    "CHANGELOG.md",
     "dist/**",
     "!dist/**/*.tsbuildinfo",
     "src/**/*.ts",

package/src/BitcoinProvider.ts

@@ -2,7 +2,7 @@ import { isUTXOAddress } from '@bigmi/core'
 import { ChainType, type StepExecutorOptions } from '@lifi/sdk'
 import { getBitcoinBalance } from './actions/getBitcoinBalance.js'
 import { resolveBitcoinAddress } from './actions/resolveBitcoinAddress.js'
-import { BitcoinStepExecutor } from './BitcoinStepExecutor.js'
+import { BitcoinStepExecutor } from './core/BitcoinStepExecutor.js'
 import type { BitcoinProviderOptions, BitcoinSDKProvider } from './types.js'
 
 export function BitcoinProvider(

package/src/actions/getBitcoinBalance.ts

@@ -21,14 +21,26 @@ export const getBitcoinBalance = async (
     }
   }
   const bigmiClient = await getBitcoinPublicClient(client, ChainId.BTC)
-  const [balance, blockCount] = await Promise.all([
+  const [balance, blockCount] = await Promise.allSettled([
     bigmiClient.getBalance({ address: walletAddress }),
     bigmiClient.getBlockCount(),
   ])
 
+  const blockNumber =
+    blockCount.status === 'fulfilled' ? BigInt(blockCount.value) : 0n
+
+  if (balance.status !== 'fulfilled') {
+    // RPC failed — leave amount undefined so callers can distinguish
+    // an unknown balance from a known zero.
+    return tokens.map((token) => ({
+      ...token,
+      blockNumber,
+    }))
+  }
+
   return tokens.map((token) => ({
     ...token,
-    amount: balance,
-    blockNumber: BigInt(blockCount),
+    amount: balance.value,
+    blockNumber,
   }))
 }

package/src/client/publicClient.ts

@@ -20,7 +20,7 @@ import {
 import type { SDKClient } from '@lifi/sdk'
 import { toBigmiChainId } from '../utils/toBigmiChainId.js'
 
-type PublicClient = Client<
+export type PublicClient = Client<
   FallbackTransport<readonly HttpTransport[]>,
   Chain,
   Account | undefined,

package/src/core/BitcoinStepExecutor.ts

@@ -0,0 +1,100 @@
+import type { Client } from '@bigmi/core'
+import {
+  BaseStepExecutor,
+  CheckBalanceTask,
+  type ExecutionAction,
+  LiFiErrorCode,
+  type LiFiStepExtended,
+  PrepareTransactionTask,
+  type SDKError,
+  type StepExecutorBaseContext,
+  type StepExecutorOptions,
+  TaskPipeline,
+  TransactionError,
+  WaitForTransactionStatusTask,
+} from '@lifi/sdk'
+import { getBitcoinPublicClient } from '../client/publicClient.js'
+import { parseBitcoinErrors } from '../errors/parseBitcoinErrors.js'
+import type { BitcoinStepExecutorContext } from '../types.js'
+import { BitcoinSignAndExecuteTask } from './tasks/BitcoinSignAndExecuteTask.js'
+import { BitcoinWaitForTransactionTask } from './tasks/BitcoinWaitForTransactionTask.js'
+
+interface BitcoinStepExecutorOptions extends StepExecutorOptions {
+  client: Client
+}
+
+export class BitcoinStepExecutor extends BaseStepExecutor {
+  private client: Client
+
+  constructor(options: BitcoinStepExecutorOptions) {
+    super(options)
+    this.client = options.client
+  }
+
+  checkClient = (step: LiFiStepExtended): void => {
+    // TODO: check chain and possibly implement chain switch?
+    // Prevent execution of the quote by wallet different from the one which requested the quote
+    if (this.client.account?.address !== step.action.fromAddress) {
+      throw new TransactionError(
+        LiFiErrorCode.WalletChangedDuringExecution,
+        'The wallet address that requested the quote does not match the wallet address attempting to sign the transaction.'
+      )
+    }
+  }
+
+  override createPipeline = (
+    context: BitcoinStepExecutorContext
+  ): TaskPipeline => {
+    const { step, isBridgeExecution } = context
+
+    const tasks = [
+      new CheckBalanceTask(),
+      new PrepareTransactionTask(),
+      new BitcoinSignAndExecuteTask(),
+      new BitcoinWaitForTransactionTask(),
+      new WaitForTransactionStatusTask(
+        isBridgeExecution ? 'RECEIVING_CHAIN' : 'SWAP'
+      ),
+    ]
+    const swapOrBridgeAction = this.statusManager.findAction(
+      step,
+      isBridgeExecution ? 'CROSS_CHAIN' : 'SWAP'
+    )
+
+    const taskName = swapOrBridgeAction?.txHash
+      ? swapOrBridgeAction?.status === 'DONE'
+        ? WaitForTransactionStatusTask.name
+        : BitcoinWaitForTransactionTask.name
+      : CheckBalanceTask.name
+
+    const firstTaskIndex = tasks.findIndex(
+      (task) => task.constructor.name === taskName
+    )
+
+    const tasksToRun = tasks.slice(firstTaskIndex)
+
+    return new TaskPipeline(tasksToRun)
+  }
+
+  override parseErrors = (
+    error: Error,
+    step?: LiFiStepExtended,
+    action?: ExecutionAction
+  ): Promise<SDKError> => parseBitcoinErrors(error, step, action)
+
+  override createContext = async (
+    baseContext: StepExecutorBaseContext
+  ): Promise<BitcoinStepExecutorContext> => {
+    const { client, fromChain } = baseContext
+
+    const publicClient = await getBitcoinPublicClient(client, fromChain.id)
+
+    return {
+      ...baseContext,
+      pollingIntervalMs: 10_000,
+      checkClient: this.checkClient,
+      walletClient: this.client,
+      publicClient,
+    }
+  }
+}

package/src/core/tasks/BitcoinSignAndExecuteTask.ts

@@ -0,0 +1,168 @@
+import {
+  AddressType,
+  getAddressInfo,
+  hexToUnit8Array,
+  signPsbt,
+  withTimeout,
+} from '@bigmi/core'
+import * as ecc from '@bitcoinerlab/secp256k1'
+import {
+  BaseStepExecutionTask,
+  getTransactionRequestData,
+  LiFiErrorCode,
+  type TaskResult,
+  TransactionError,
+} from '@lifi/sdk'
+import { address, initEccLib, networks, Psbt } from 'bitcoinjs-lib'
+import type { BitcoinStepExecutorContext } from '../../types.js'
+import { generateRedeemScript } from '../../utils/generateRedeemScript.js'
+import { isPsbtFinalized } from '../../utils/isPsbtFinalized.js'
+import { toXOnly } from '../../utils/toXOnly.js'
+
+export class BitcoinSignAndExecuteTask extends BaseStepExecutionTask {
+  async run(context: BitcoinStepExecutorContext): Promise<TaskResult> {
+    const {
+      step,
+      walletClient,
+      statusManager,
+      executionOptions,
+      fromChain,
+      publicClient,
+      checkClient,
+      isBridgeExecution,
+    } = context
+
+    const action = statusManager.findAction(
+      step,
+      isBridgeExecution ? 'CROSS_CHAIN' : 'SWAP'
+    )
+
+    if (!action) {
+      throw new TransactionError(
+        LiFiErrorCode.TransactionUnprepared,
+        'Unable to prepare transaction. Action not found.'
+      )
+    }
+
+    const transactionRequestData = await getTransactionRequestData(
+      step,
+      executionOptions
+    )
+
+    checkClient(step)
+
+    const psbtHex = transactionRequestData
+
+    // Initialize ECC library required for Taproot operations
+    // https://github.com/bitcoinjs/bitcoinjs-lib?tab=readme-ov-file#using-taproot
+    initEccLib(ecc)
+
+    const psbt = Psbt.fromHex(psbtHex, { network: networks.bitcoin })
+
+    psbt.data.inputs.forEach((input, index) => {
+      const accountAddress = input.witnessUtxo
+        ? address.fromOutputScript(input.witnessUtxo.script, networks.bitcoin)
+        : (walletClient.account?.address as string)
+      const addressInfo = getAddressInfo(accountAddress)
+      if (addressInfo.type === AddressType.p2tr) {
+        // Taproot (P2TR) addresses require specific PSBT fields for proper signing
+
+        // tapInternalKey: Required for Taproot key-path spending
+        // Most wallets  / libraries usually handle this already
+        if (!input.tapInternalKey) {
+          const pubKey = walletClient.account?.publicKey
+          if (pubKey) {
+            const tapInternalKey = toXOnly(hexToUnit8Array(pubKey))
+            psbt.updateInput(index, {
+              tapInternalKey,
+            })
+          }
+        }
+        // sighashType: Required by bitcoinjs-lib even though the bitcoin protocol allows defaults
+        // check if sighashType is default (0) or not set (undefined)
+        if (!input.sighashType) {
+          psbt.updateInput(index, {
+            sighashType: 1, // Default to Transaction.SIGHASH_ALL - 1
+          })
+        }
+      }
+      // redeemScript: Required by Pay-to-Script-Hash (P2SH) addresses for proper spending
+      if (addressInfo.type === AddressType.p2sh) {
+        if (!input.redeemScript) {
+          const pubKey = walletClient.account?.publicKey
+          if (pubKey) {
+            psbt.updateInput(index, {
+              redeemScript: generateRedeemScript(hexToUnit8Array(pubKey)),
+            })
+          }
+        }
+      }
+    })
+
+    const inputsToSign = Array.from(
+      psbt.data.inputs
+        .reduce((map, input, index) => {
+          const accountAddress = input.witnessUtxo
+            ? address.fromOutputScript(
+                input.witnessUtxo.script,
+                networks.bitcoin
+              )
+            : (walletClient.account?.address as string)
+          if (map.has(accountAddress)) {
+            map.get(accountAddress)!.signingIndexes.push(index)
+          } else {
+            map.set(accountAddress, {
+              address: accountAddress,
+              sigHash: 1, // Default to Transaction.SIGHASH_ALL - 1
+              signingIndexes: [index],
+            })
+          }
+          return map
+        }, new Map<
+          string,
+          { address: string; sigHash: number; signingIndexes: number[] }
+        >())
+        .values()
+    )
+
+    // We give users 10 minutes to sign the transaction or it should be considered expired
+    const signedPsbtHex = await withTimeout(
+      () =>
+        signPsbt(walletClient, {
+          psbt: psbt.toHex(),
+          inputsToSign: inputsToSign,
+          finalize: false,
+        }),
+      {
+        timeout: 600_000,
+        errorInstance: new TransactionError(
+          LiFiErrorCode.TransactionExpired,
+          'Transaction has expired.'
+        ),
+      }
+    )
+
+    const signedPsbt = Psbt.fromHex(signedPsbtHex)
+
+    if (!isPsbtFinalized(signedPsbt)) {
+      signedPsbt.finalizeAllInputs()
+    }
+
+    const txHex = signedPsbt.extractTransaction().toHex()
+
+    const txHash = await publicClient.sendUTXOTransaction({
+      hex: txHex,
+    })
+
+    statusManager.updateAction(step, action.type, 'PENDING', {
+      txHash: txHash,
+      txLink: `${fromChain.metamask.blockExplorerUrls[0]}tx/${txHash}`,
+      txHex,
+      signedAt: Date.now(),
+    })
+
+    return {
+      status: 'COMPLETED',
+    }
+  }
+}