@leather.io/bitcoin 0.18.0 → 0.19.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @leather.io/bitcoin@0.18.0 build /home/runner/work/mono/mono/packages/bitcoin
+> @leather.io/bitcoin@0.19.0 build /home/runner/work/mono/mono/packages/bitcoin
 > tsup
 
 CLI Building entry: src/index.ts
@@ -8,9 +8,9 @@ CLI tsup v8.1.0
 CLI Using tsup config: /home/runner/work/mono/mono/packages/bitcoin/tsup.config.ts
 CLI Target: es2022
 ESM Build start
-ESM dist/index.js     43.72 KB
-ESM dist/index.js.map 84.58 KB
-ESM ⚡️ Build success in 58ms
+ESM dist/index.js     49.89 KB
+ESM dist/index.js.map 97.56 KB
+ESM ⚡️ Build success in 61ms
 DTS Build start
-DTS ⚡️ Build success in 4435ms
-DTS dist/index.d.ts 20.41 KB
+DTS ⚡️ Build success in 4575ms
+DTS dist/index.d.ts 23.04 KB

package/CHANGELOG.md

@@ -310,6 +310,33 @@
   * devDependencies
     * @leather.io/rpc bumped to 2.1.20
 
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @leather.io/constants bumped to 0.13.7
+    * @leather.io/crypto bumped to 1.6.16
+    * @leather.io/models bumped to 0.24.0
+    * @leather.io/utils bumped to 0.21.0
+  * devDependencies
+    * @leather.io/rpc bumped to 2.1.22
+
+## [0.19.0](https://github.com/leather-io/mono/compare/@leather.io/bitcoin-v0.18.1...@leather.io/bitcoin-v0.19.0) (2024-12-04)
+
+
+### Features
+
+* add psbt functionality ([6b676a9](https://github.com/leather-io/mono/commit/6b676a971fbd7497e6c285a818374f13745b032c))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @leather.io/constants bumped to 0.14.0
+    * @leather.io/crypto bumped to 1.6.17
+    * @leather.io/utils bumped to 0.21.1
+
 ## [0.18.0](https://github.com/leather-io/mono/compare/@leather.io/bitcoin-v0.17.0...@leather.io/bitcoin-v0.18.0) (2024-11-29)
 
 

package/dist/index.d.ts

@@ -2,14 +2,14 @@ import * as ecpair from 'ecpair';
 import * as bitcoin from 'bitcoinjs-lib';
 import * as btc from '@scure/btc-signer';
 import * as _leather_io_models from '@leather.io/models';
-import { BitcoinNetworkModes, Money, AverageBitcoinFeeRates, NetworkModes } from '@leather.io/models';
+import { BitcoinNetworkModes, Money, AverageBitcoinFeeRates, NetworkModes, Inscription } from '@leather.io/models';
 import BigNumber from 'bignumber.js';
 import { HDKey, Versions } from '@scure/bip32';
 import * as _scure_btc_signer_payment from '@scure/btc-signer/payment';
 import { P2Ret, P2TROut } from '@scure/btc-signer/payment';
 import { SigHash } from '@scure/btc-signer/transaction';
 import { PaymentTypes, SignatureHash } from '@leather.io/rpc';
-import { TransactionInput, TransactionOutput } from '@scure/btc-signer/psbt';
+import { TransactionInput, TransactionOutput, RawPSBTV0 } from '@scure/btc-signer/psbt';
 import { deriveBip39SeedFromMnemonic, deriveRootBip32Keychain } from '@leather.io/crypto';
 
 declare function ecPairFromPrivateKey(key: Uint8Array): ecpair.ECPairInterface;
@@ -170,32 +170,6 @@ interface BtcSignerNetwork {
 declare function getBtcSignerLibNetworkConfigByMode(network: BitcoinNetworkModes): BtcSignerNetwork;
 declare function getBitcoinJsLibNetworkConfigByMode(network: BitcoinNetworkModes): bitcoin.networks.Network;
 
-interface GenerateBitcoinUnsignedTransactionArgs {
-    feeRate: number;
-    isSendingMax?: boolean;
-    payerAddress: string;
-    payerPublicKey: string;
-    network: BtcSignerNetwork;
-    recipients: CoinSelectionRecipient[];
-    utxos: CoinSelectionUtxo[];
-}
-declare function generateBitcoinUnsignedTransactionNativeSegwit({ feeRate, isSendingMax, payerAddress, payerPublicKey, network, recipients, utxos, }: GenerateBitcoinUnsignedTransactionArgs): Promise<{
-    tx: btc.Transaction;
-    hex: string;
-    psbt: Uint8Array;
-    inputs: CoinSelectionUtxo[];
-    fee: _leather_io_models.Money;
-} | null>;
-
-declare enum BitcoinErrorMessage {
-    InsufficientFunds = "Insufficient funds",
-    NoInputsToSign = "No inputs to sign",
-    NoOutputsToSign = "No outputs to sign"
-}
-declare class BitcoinError extends Error {
-    constructor(message: string);
-}
-
 interface BitcoinAccount {
     type: PaymentTypes;
     derivationPath: string;
@@ -273,6 +247,7 @@ declare function getPsbtTxInputs(psbtTx: btc.Transaction): TransactionInput[];
 declare function getPsbtTxOutputs(psbtTx: btc.Transaction): TransactionOutput[];
 declare function inferNetworkFromAddress(address: string): BitcoinNetworkModes;
 declare function inferPaymentTypeFromAddress(address: string): SupportedPaymentType;
+declare function getBitcoinInputValue(input: TransactionInput): number;
 
 type AllowedSighashTypes = SignatureHash | SigHash;
 interface BitcoinAccountKeychain {
@@ -378,6 +353,33 @@ declare function serializeKeyOrigin({ fingerprint, path }: BtcSignerDerivationPa
  */
 declare function extractRequiredKeyOrigins(derivation: BtcSignerBip32Derivation[]): string[];
 
+interface GenerateBitcoinUnsignedTransactionArgs {
+    feeRate: number;
+    isSendingMax?: boolean;
+    payerAddress: string;
+    payerPublicKey: string;
+    bip32Derivation: BtcSignerDefaultBip32Derivation[];
+    network: BtcSignerNetwork;
+    recipients: CoinSelectionRecipient[];
+    utxos: CoinSelectionUtxo[];
+}
+declare function generateBitcoinUnsignedTransactionNativeSegwit({ feeRate, isSendingMax, payerAddress, payerPublicKey, bip32Derivation, network, recipients, utxos, }: GenerateBitcoinUnsignedTransactionArgs): Promise<{
+    tx: btc.Transaction;
+    hex: string;
+    psbt: Uint8Array;
+    inputs: CoinSelectionUtxo[];
+    fee: _leather_io_models.Money;
+} | null>;
+
+declare enum BitcoinErrorMessage {
+    InsufficientFunds = "Insufficient funds",
+    NoInputsToSign = "No inputs to sign",
+    NoOutputsToSign = "No outputs to sign"
+}
+declare class BitcoinError extends Error {
+    constructor(message: string);
+}
+
 declare function makeTaprootAccountDerivationPath(network: BitcoinNetworkModes, accountIndex: number): string;
 /** @deprecated Use makeTaprootAccountDerivationPath */
 declare const getTaprootAccountDerivationPath: typeof makeTaprootAccountDerivationPath;
@@ -445,4 +447,74 @@ declare function lookupDerivationByAddress(args: LookUpDerivationByAddressArgs):
     readonly path?: undefined;
 };
 
-export { type AllowedSighashTypes, type BitcoinAccount, type BitcoinAccountKeychain, BitcoinError, BitcoinErrorMessage, type BitcoinFees, type BitcoinNativeSegwitPayer, type BitcoinPayer, type BitcoinPayerBase, type BitcoinPayerInfo, type BitcoinSigner, type BitcoinTaprootPayer, type BtcSignerDefaultBip32Derivation, type BtcSignerLibPaymentTypeIdentifers, type BtcSignerNetwork, type BtcSignerTapBip32Derivation, type CoinSelectionOutput, type CoinSelectionRecipient, type CoinSelectionUtxo, type DetermineUtxosForSpendArgs, type GenerateBitcoinUnsignedTransactionArgs, type GetBitcoinFeesArgs, type PaymentTypeMap, type SupportedPaymentType, type SupportedPaymentTypeMap, type WithDerivePayer, bip322TransactionToSignValues, bitcoinNetworkModeToCoreNetworkMode, bitcoinNetworkToCoreNetworkMap, btcSignerLibPaymentTypeToPaymentTypeMap, calculateMaxBitcoinSpend, coinTypeMap, createNativeSegwitBitcoinJsSigner, createTaprootBitcoinJsSigner, createToSpendTx, createWalletIdDecoratedPath, decodeBitcoinTx, decodeCompressedWifPrivateKey, deriveAddressIndexKeychainFromAccount, deriveAddressIndexZeroFromAccount, deriveBitcoinPayerFromAccount, deriveBtcBip49SeedFromMnemonic, deriveNativeSegwitAccountFromRootKeychain, deriveNativeSegwitReceiveAddressIndexZero, deriveRootBtcKeychain, deriveTaprootAccount, deriveTaprootReceiveAddressIndexZero, determineUtxosForSpend, determineUtxosForSpendAll, ecPairFromPrivateKey, ecdsaPublicKeyLength, ecdsaPublicKeyToSchnorr, encodeMessageWitnessData, extractExtendedPublicKeyFromPolicy, extractRequiredKeyOrigins, filterUneconomicalUtxos, generateBitcoinUnsignedTransactionNativeSegwit, getAddressFromOutScript, getBitcoinCoinTypeIndexByNetwork, getBitcoinFees, getBitcoinInputAddress, getBitcoinJsLibNetworkConfigByMode, getBitcoinTransactionFee, getBtcSignerLibNetworkConfigByMode, getHdKeyVersionsFromNetwork, getInputPaymentType, getNativeSegwitAccountDerivationPath, getNativeSegwitAddress, getNativeSegwitAddressIndexDerivationPath, getNativeSegwitPaymentFromAddressIndex, getPsbtTxInputs, getPsbtTxOutputs, getSizeInfo, getSpendableAmount, getTaprootAccountDerivationPath, getTaprootAddress, getTaprootAddressIndexDerivationPath, getTaprootPayment, getTaprootPaymentFromAddressIndex, getUtxoTotal, hashBip322Message, inferNetworkFromAddress, inferNetworkFromPath, inferPaymentTypeFromAddress, inferPaymentTypeFromPath, initBitcoinAccount, initializeBitcoinAccountKeychainFromDescriptor, isBtcSignerLibPaymentType, isSupportedMessageSigningPaymentType, lookUpLedgerKeysByPath, lookupDerivationByAddress, makeNativeSegwitAccountDerivationPath, makeNativeSegwitAddressIndexDerivationPath, makePayToScriptHashAddress, makePayToScriptHashAddressBytes, makePayToScriptHashKeyHash, makeTaprootAccountDerivationPath, makeTaprootAddressIndexDerivationPath, mnemonicToRootNode, parseKnownPaymentType, payToScriptHashTestnetPrefix, payerToBip32Derivation, payerToTapBip32Derivation, paymentTypeMap, publicKeyToPayToScriptHashAddress, serializeKeyOrigin, signBip322MessageSimple, toXOnly, tweakSigner, whenBitcoinNetwork, whenPaymentType, whenSupportedPaymentType };
+interface PsbtInput {
+    address: string;
+    index?: number;
+    inscription?: Inscription;
+    isMutable: boolean;
+    toSign: boolean;
+    txid: string;
+    value: number;
+    bip32Derivation: TransactionInput['bip32Derivation'];
+    tapBip32Derivation: TransactionInput['tapBip32Derivation'];
+}
+interface GetParsedInputsArgs {
+    inputs: TransactionInput[];
+    indexesToSign?: number[];
+    networkMode: BitcoinNetworkModes;
+    psbtAddresses: string[];
+}
+interface GetParsedInputsResponse {
+    isPsbtMutable: boolean;
+    parsedInputs: PsbtInput[];
+}
+declare function getParsedInputs({ inputs, indexesToSign, networkMode, psbtAddresses, }: GetParsedInputsArgs): GetParsedInputsResponse;
+
+interface PsbtOutput {
+    address: string;
+    isMutable: boolean;
+    toSign: boolean;
+    value: number;
+}
+interface GetParsedOutputsArgs {
+    isPsbtMutable: boolean;
+    outputs: TransactionOutput[];
+    networkMode: BitcoinNetworkModes;
+    psbtAddresses: string[];
+}
+declare function getParsedOutputs({ isPsbtMutable, outputs, networkMode, psbtAddresses, }: GetParsedOutputsArgs): PsbtOutput[];
+
+interface GetPsbtTotalsProps {
+    psbtAddresses: string[];
+    parsedInputs: PsbtInput[];
+    parsedOutputs: PsbtOutput[];
+}
+declare function getPsbtTotals({ psbtAddresses, parsedInputs, parsedOutputs }: GetPsbtTotalsProps): {
+    inputsTotalNativeSegwit: _leather_io_models.Money;
+    inputsTotalTaproot: _leather_io_models.Money;
+    outputsTotalNativeSegwit: _leather_io_models.Money;
+    outputsTotalTaproot: _leather_io_models.Money;
+    psbtInputsTotal: _leather_io_models.Money;
+    psbtOutputsTotal: _leather_io_models.Money;
+};
+
+interface GetPsbtDetailsArgs {
+    psbtHex: string;
+    psbtAddresses: string[];
+    networkMode: BitcoinNetworkModes;
+    indexesToSign?: number[];
+}
+declare function getPsbtDetails({ psbtHex, networkMode, indexesToSign, psbtAddresses, }: GetPsbtDetailsArgs): {
+    addressNativeSegwitTotal: _leather_io_models.Money;
+    addressTaprootTotal: _leather_io_models.Money;
+    fee: _leather_io_models.Money;
+    isPsbtMutable: boolean;
+    psbtInputs: PsbtInput[];
+    psbtOutputs: PsbtOutput[];
+};
+
+type RawPsbt = ReturnType<typeof RawPSBTV0.decode>;
+declare function getPsbtAsTransaction(psbt: string | Uint8Array): btc.Transaction;
+declare function getRawPsbt(psbt: string | Uint8Array): ReturnType<typeof RawPSBTV0.decode>;
+
+export { type AllowedSighashTypes, type BitcoinAccount, type BitcoinAccountKeychain, BitcoinError, BitcoinErrorMessage, type BitcoinFees, type BitcoinNativeSegwitPayer, type BitcoinPayer, type BitcoinPayerBase, type BitcoinPayerInfo, type BitcoinSigner, type BitcoinTaprootPayer, type BtcSignerDefaultBip32Derivation, type BtcSignerLibPaymentTypeIdentifers, type BtcSignerNetwork, type BtcSignerTapBip32Derivation, type CoinSelectionOutput, type CoinSelectionRecipient, type CoinSelectionUtxo, type DetermineUtxosForSpendArgs, type GenerateBitcoinUnsignedTransactionArgs, type GetBitcoinFeesArgs, type PaymentTypeMap, type PsbtInput, type PsbtOutput, type RawPsbt, type SupportedPaymentType, type SupportedPaymentTypeMap, type WithDerivePayer, bip322TransactionToSignValues, bitcoinNetworkModeToCoreNetworkMode, bitcoinNetworkToCoreNetworkMap, btcSignerLibPaymentTypeToPaymentTypeMap, calculateMaxBitcoinSpend, coinTypeMap, createNativeSegwitBitcoinJsSigner, createTaprootBitcoinJsSigner, createToSpendTx, createWalletIdDecoratedPath, decodeBitcoinTx, decodeCompressedWifPrivateKey, deriveAddressIndexKeychainFromAccount, deriveAddressIndexZeroFromAccount, deriveBitcoinPayerFromAccount, deriveBtcBip49SeedFromMnemonic, deriveNativeSegwitAccountFromRootKeychain, deriveNativeSegwitReceiveAddressIndexZero, deriveRootBtcKeychain, deriveTaprootAccount, deriveTaprootReceiveAddressIndexZero, determineUtxosForSpend, determineUtxosForSpendAll, ecPairFromPrivateKey, ecdsaPublicKeyLength, ecdsaPublicKeyToSchnorr, encodeMessageWitnessData, extractExtendedPublicKeyFromPolicy, extractRequiredKeyOrigins, filterUneconomicalUtxos, generateBitcoinUnsignedTransactionNativeSegwit, getAddressFromOutScript, getBitcoinCoinTypeIndexByNetwork, getBitcoinFees, getBitcoinInputAddress, getBitcoinInputValue, getBitcoinJsLibNetworkConfigByMode, getBitcoinTransactionFee, getBtcSignerLibNetworkConfigByMode, getHdKeyVersionsFromNetwork, getInputPaymentType, getNativeSegwitAccountDerivationPath, getNativeSegwitAddress, getNativeSegwitAddressIndexDerivationPath, getNativeSegwitPaymentFromAddressIndex, getParsedInputs, getParsedOutputs, getPsbtAsTransaction, getPsbtDetails, getPsbtTotals, getPsbtTxInputs, getPsbtTxOutputs, getRawPsbt, getSizeInfo, getSpendableAmount, getTaprootAccountDerivationPath, getTaprootAddress, getTaprootAddressIndexDerivationPath, getTaprootPayment, getTaprootPaymentFromAddressIndex, getUtxoTotal, hashBip322Message, inferNetworkFromAddress, inferNetworkFromPath, inferPaymentTypeFromAddress, inferPaymentTypeFromPath, initBitcoinAccount, initializeBitcoinAccountKeychainFromDescriptor, isBtcSignerLibPaymentType, isSupportedMessageSigningPaymentType, lookUpLedgerKeysByPath, lookupDerivationByAddress, makeNativeSegwitAccountDerivationPath, makeNativeSegwitAddressIndexDerivationPath, makePayToScriptHashAddress, makePayToScriptHashAddressBytes, makePayToScriptHashKeyHash, makeTaprootAccountDerivationPath, makeTaprootAddressIndexDerivationPath, mnemonicToRootNode, parseKnownPaymentType, payToScriptHashTestnetPrefix, payerToBip32Derivation, payerToTapBip32Derivation, paymentTypeMap, publicKeyToPayToScriptHashAddress, serializeKeyOrigin, signBip322MessageSimple, toXOnly, tweakSigner, whenBitcoinNetwork, whenPaymentType, whenSupportedPaymentType };

package/dist/index.js

@@ -353,6 +353,12 @@ function inferPaymentTypeFromAddress(address2) {
     return "p2tr";
   throw new Error("Unable to infer payment type from address");
 }
+function getBitcoinInputValue(input) {
+  if (isDefined(input.witnessUtxo)) return Number(input.witnessUtxo.amount);
+  if (isDefined(input.nonWitnessUtxo) && isDefined(input.index))
+    return Number(input.nonWitnessUtxo.outputs[input.index]?.amount);
+  return 0;
+}
 
 // src/bip322/bip322-utils.ts
 var bip322MessageTag = "BIP0322-signed-message";
@@ -964,6 +970,7 @@ async function generateBitcoinUnsignedTransactionNativeSegwit({
   isSendingMax,
   payerAddress,
   payerPublicKey,
+  bip32Derivation,
   network,
   recipients,
   utxos
@@ -980,6 +987,7 @@ async function generateBitcoinUnsignedTransactionNativeSegwit({
         txid: input.txid,
         index: input.vout,
         sequence: 0,
+        bip32Derivation,
         witnessUtxo: {
           // script = 0014 + pubKeyHash
           script: p2wpkh3.script,
@@ -1173,6 +1181,169 @@ function lookupDerivationByAddress(args) {
     return { status: "failure" };
   };
 }
+
+// src/psbt/psbt-totals.ts
+import { createMoney as createMoney3, sumNumbers as sumNumbers2 } from "@leather.io/utils";
+function calculateAddressInputsTotal(addresses, inputs) {
+  const sumsByAddress = addresses.map(
+    (address2) => inputs.filter((input) => input.address === address2).map((input) => input.value).reduce((acc, curVal) => acc + curVal, 0)
+  );
+  return createMoney3(sumNumbers2(sumsByAddress), "BTC");
+}
+function calculateAddressOutputsTotal(addresses, outputs) {
+  const sumsByAddress = addresses.map(
+    (address2) => outputs.filter((output) => output.address === address2).map((output) => Number(output.value)).reduce((acc, curVal) => acc + curVal, 0)
+  );
+  return createMoney3(sumNumbers2(sumsByAddress), "BTC");
+}
+function calculatePsbtInputsTotal(inputs) {
+  return createMoney3(sumNumbers2(inputs.map((input) => input.value)), "BTC");
+}
+function calculatePsbtOutputsTotal(outputs) {
+  return createMoney3(sumNumbers2(outputs.map((output) => output.value)), "BTC");
+}
+function getPsbtTotals({ psbtAddresses, parsedInputs, parsedOutputs }) {
+  const nativeSegwitAddresses = psbtAddresses.filter(
+    (addr) => inferPaymentTypeFromAddress(addr) === "p2wpkh"
+  );
+  const taprootAddresses = psbtAddresses.filter(
+    (addr) => inferPaymentTypeFromAddress(addr) === "p2tr"
+  );
+  return {
+    inputsTotalNativeSegwit: calculateAddressInputsTotal(nativeSegwitAddresses, parsedInputs),
+    inputsTotalTaproot: calculateAddressInputsTotal(taprootAddresses, parsedInputs),
+    outputsTotalNativeSegwit: calculateAddressOutputsTotal(nativeSegwitAddresses, parsedOutputs),
+    outputsTotalTaproot: calculateAddressOutputsTotal(taprootAddresses, parsedOutputs),
+    psbtInputsTotal: calculatePsbtInputsTotal(parsedInputs),
+    psbtOutputsTotal: calculatePsbtOutputsTotal(parsedOutputs)
+  };
+}
+
+// src/psbt/psbt-inputs.ts
+import { bytesToHex } from "@stacks/common";
+import { isDefined as isDefined2, isUndefined } from "@leather.io/utils";
+function getParsedInputs({
+  inputs,
+  indexesToSign,
+  networkMode,
+  psbtAddresses
+}) {
+  const bitcoinNetwork = getBtcSignerLibNetworkConfigByMode(networkMode);
+  const signAll = isUndefined(indexesToSign);
+  const psbtInputs = inputs.map((input, i) => {
+    const inputAddress = isDefined2(input.index) ? getBitcoinInputAddress(input, bitcoinNetwork) : "";
+    const isCurrentAddress = psbtAddresses.includes(inputAddress);
+    const canChange = isCurrentAddress && !(!input.sighashType || input.sighashType === 0 || input.sighashType === 1);
+    const toSignAll = isCurrentAddress && signAll;
+    const toSignIndex = isCurrentAddress && !signAll && indexesToSign.includes(i);
+    return {
+      address: inputAddress,
+      index: input.index,
+      bip32Derivation: input.bip32Derivation,
+      tapBip32Derivation: input.tapBip32Derivation,
+      // inscription: inscriptions[i],
+      isMutable: canChange,
+      toSign: toSignAll || toSignIndex,
+      txid: input.txid ? bytesToHex(input.txid) : "",
+      value: isDefined2(input.index) ? getBitcoinInputValue(input) : 0
+    };
+  });
+  const isPsbtMutable = psbtInputs.some((input) => input.isMutable);
+  return { isPsbtMutable, parsedInputs: psbtInputs };
+}
+
+// src/psbt/psbt-outputs.ts
+import { isDefined as isDefined3, isUndefined as isUndefined2 } from "@leather.io/utils";
+function getParsedOutputs({
+  isPsbtMutable,
+  outputs,
+  networkMode,
+  psbtAddresses
+}) {
+  const bitcoinNetwork = getBtcSignerLibNetworkConfigByMode(networkMode);
+  return outputs.map((output) => {
+    if (isUndefined2(output.script)) {
+      return;
+    }
+    const outputAddress = getAddressFromOutScript(output.script, bitcoinNetwork);
+    const isCurrentAddress = psbtAddresses.includes(outputAddress);
+    return {
+      address: outputAddress,
+      isMutable: isPsbtMutable,
+      toSign: isCurrentAddress,
+      value: Number(output.amount)
+    };
+  }).filter(isDefined3);
+}
+
+// src/psbt/psbt-details.ts
+import { createMoney as createMoney4, subtractMoney } from "@leather.io/utils";
+
+// src/psbt/utils.ts
+import { hexToBytes as hexToBytes4 } from "@noble/hashes/utils";
+import * as btc6 from "@scure/btc-signer";
+import { RawPSBTV0, RawPSBTV2 } from "@scure/btc-signer/psbt";
+import { isString as isString2 } from "@leather.io/utils";
+function getPsbtAsTransaction(psbt) {
+  const bytes = isString2(psbt) ? hexToBytes4(psbt) : psbt;
+  return btc6.Transaction.fromPSBT(bytes);
+}
+function getRawPsbt(psbt) {
+  const bytes = isString2(psbt) ? hexToBytes4(psbt) : psbt;
+  try {
+    return RawPSBTV0.decode(bytes);
+  } catch (e1) {
+    try {
+      return RawPSBTV2.decode(bytes);
+    } catch (e2) {
+      throw new Error(`Unable to decode PSBT, ${e1 ?? e2}`);
+    }
+  }
+}
+
+// src/psbt/psbt-details.ts
+function getPsbtDetails({
+  psbtHex,
+  networkMode,
+  indexesToSign,
+  psbtAddresses
+}) {
+  const tx = getPsbtAsTransaction(psbtHex);
+  const inputs = getPsbtTxInputs(tx);
+  const outputs = getPsbtTxOutputs(tx);
+  const { isPsbtMutable, parsedInputs } = getParsedInputs({
+    inputs,
+    indexesToSign,
+    networkMode,
+    psbtAddresses
+  });
+  const parsedOutputs = getParsedOutputs({ isPsbtMutable, outputs, networkMode, psbtAddresses });
+  const {
+    inputsTotalNativeSegwit,
+    inputsTotalTaproot,
+    outputsTotalNativeSegwit,
+    outputsTotalTaproot,
+    psbtInputsTotal,
+    psbtOutputsTotal
+  } = getPsbtTotals({
+    psbtAddresses,
+    parsedInputs,
+    parsedOutputs
+  });
+  function getFee() {
+    if (psbtInputsTotal.amount.isGreaterThan(psbtOutputsTotal.amount))
+      return subtractMoney(psbtInputsTotal, psbtOutputsTotal);
+    return createMoney4(0, "BTC");
+  }
+  return {
+    addressNativeSegwitTotal: subtractMoney(inputsTotalNativeSegwit, outputsTotalNativeSegwit),
+    addressTaprootTotal: subtractMoney(inputsTotalTaproot, outputsTotalTaproot),
+    fee: getFee(),
+    isPsbtMutable,
+    psbtInputs: parsedInputs,
+    psbtOutputs: parsedOutputs
+  };
+}
 export {
   BitcoinError,
   BitcoinErrorMessage,
@@ -1211,6 +1382,7 @@ export {
   getBitcoinCoinTypeIndexByNetwork,
   getBitcoinFees,
   getBitcoinInputAddress,
+  getBitcoinInputValue,
   getBitcoinJsLibNetworkConfigByMode,
   getBitcoinTransactionFee,
   getBtcSignerLibNetworkConfigByMode,
@@ -1220,8 +1392,14 @@ export {
   getNativeSegwitAddress,
   getNativeSegwitAddressIndexDerivationPath,
   getNativeSegwitPaymentFromAddressIndex,
+  getParsedInputs,
+  getParsedOutputs,
+  getPsbtAsTransaction,
+  getPsbtDetails,
+  getPsbtTotals,
   getPsbtTxInputs,
   getPsbtTxOutputs,
+  getRawPsbt,
   getSizeInfo,
   getSpendableAmount,
   getTaprootAccountDerivationPath,