@leather.io/bitcoin 0.19.28 → 0.19.30

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @leather.io/bitcoin@0.19.28 build /home/runner/work/mono/mono/packages/bitcoin
+> @leather.io/bitcoin@0.19.30 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     49.51 KB
-ESM dist/index.js.map 97.47 KB
-ESM ⚡️ Build success in 78ms
+ESM dist/index.js     53.95 KB
+ESM dist/index.js.map 106.90 KB
+ESM ⚡️ Build success in 72ms
 DTS Build start
-DTS ⚡️ Build success in 4901ms
-DTS dist/index.d.ts 23.09 KB
+DTS ⚡️ Build success in 5548ms
+DTS dist/index.d.ts 26.02 KB

package/CHANGELOG.md

@@ -537,6 +537,35 @@
   * devDependencies
     * @leather.io/rpc bumped to 2.6.0
 
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @leather.io/constants bumped to 0.17.0
+    * @leather.io/crypto bumped to 1.6.42
+    * @leather.io/utils bumped to 0.27.2
+  * devDependencies
+    * @leather.io/rpc bumped to 2.6.1
+
+## [0.19.30](https://github.com/leather-io/mono/compare/@leather.io/bitcoin-v0.19.29...@leather.io/bitcoin-v0.19.30) (2025-02-21)
+
+
+### Bug Fixes
+
+* block vitest remote code execution ([c00abaf](https://github.com/leather-io/mono/commit/c00abaf33668b3274825dad886feb6dfadb1d9b1))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @leather.io/constants bumped to 0.17.1
+    * @leather.io/crypto bumped to 1.6.43
+    * @leather.io/models bumped to 0.26.1
+    * @leather.io/utils bumped to 0.27.3
+  * devDependencies
+    * @leather.io/rpc bumped to 2.6.2
+
 ## [0.19.10](https://github.com/leather-io/mono/compare/@leather.io/bitcoin-v0.19.9...@leather.io/bitcoin-v0.19.10) (2025-01-07)
 
 

package/dist/index.d.ts

@@ -2,15 +2,16 @@ 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, ValueOf, Inscription } from '@leather.io/models';
+import { BitcoinNetworkModes, Money, AverageBitcoinFeeRates, NetworkModes, Inscription, ValueOf } 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 { HDKey, Versions } from '@scure/bip32';
 import { TransactionInput, TransactionOutput, RawPSBTV0 } from '@scure/btc-signer/psbt';
+import { BitcoinPaymentTypes, signatureHash, PaymentTypes } from '@leather.io/rpc';
 import { deriveBip39SeedFromMnemonic, deriveRootBip32Keychain } from '@leather.io/crypto';
+import { SigHash } from '@scure/btc-signer/transaction';
+import { Network } from 'bitcoin-address-validation';
 
 declare function ecPairFromPrivateKey(key: Uint8Array): ecpair.ECPairInterface;
 declare function hashBip322Message(message: Uint8Array | string): Uint8Array;
@@ -27,14 +28,20 @@ declare function isSupportedMessageSigningPaymentType(paymentType: string): bool
 declare function encodeMessageWitnessData(witnessArray: Buffer[]): Buffer;
 declare function tweakSigner(signer: bitcoin.Signer, opts?: any): bitcoin.Signer;
 
+type BitcoinAddress = string & {
+    readonly __brand: unique symbol;
+};
+declare function isBitcoinAddress(value: string): value is BitcoinAddress;
+declare function createBitcoinAddress(value: string): BitcoinAddress;
+
 declare function createNativeSegwitBitcoinJsSigner(privateKey: Buffer): ecpair.ECPairInterface;
 declare function createTaprootBitcoinJsSigner(privateKey: Buffer): bitcoin.Signer;
-declare function createToSpendTx(address: string, message: string, network: BitcoinNetworkModes): {
+declare function createToSpendTx(address: BitcoinAddress, message: string, network: BitcoinNetworkModes): {
     virtualToSpend: bitcoin.Transaction;
     script: Buffer;
 };
 interface SignBip322MessageSimple {
-    address: string;
+    address: BitcoinAddress;
     message: string;
     network: BitcoinNetworkModes;
     signPsbt(psbt: bitcoin.Psbt): Promise<btc.Transaction>;
@@ -85,17 +92,18 @@ declare function determineUtxosForSpend({ feeRate, recipients, utxos }: Determin
     fee: Money;
 };
 
-interface CalculateMaxBitcoinSpend {
-    address: string;
+interface CalculateMaxSpendArgs {
+    recipient: BitcoinAddress;
     utxos: CoinSelectionUtxo[];
-    fetchedFeeRates?: AverageBitcoinFeeRates;
+    feeRates?: AverageBitcoinFeeRates;
     feeRate?: number;
 }
-declare function calculateMaxBitcoinSpend({ address, utxos, feeRate, fetchedFeeRates, }: CalculateMaxBitcoinSpend): {
+interface CalculateMaxSpendResponse {
     spendAllFee: number;
-    amount: _leather_io_models.Money;
-    spendableBitcoin: BigNumber;
-};
+    amount: Money;
+    spendableBtc: BigNumber;
+}
+declare function calculateMaxSpend({ recipient, utxos, feeRate, feeRates, }: CalculateMaxSpendArgs): CalculateMaxSpendResponse;
 
 declare function getUtxoTotal(utxos: CoinSelectionUtxo[]): BigNumber;
 declare function getSizeInfo(payload: {
@@ -107,11 +115,13 @@ declare function getSizeInfo(payload: {
     txBytes: number;
     txWeight: number;
 };
-declare function getSpendableAmount({ utxos, feeRate, recipients, }: {
+interface GetSpendableAmountArgs {
     utxos: CoinSelectionUtxo[];
     feeRate: number;
     recipients: CoinSelectionRecipient[];
-}): {
+    isSendMax?: boolean;
+}
+declare function getSpendableAmount({ utxos, feeRate, recipients }: GetSpendableAmountArgs): {
     spendableAmount: BigNumber;
     fee: number;
 };
@@ -161,6 +171,20 @@ declare function getBitcoinFees({ feeRates, isSendingMax, recipients, utxos }: G
     };
 };
 
+declare const TEST_ACCOUNT_1_NATIVE_SEGWIT_ADDRESS: BitcoinAddress;
+declare const TEST_ACCOUNT_1_TAPROOT_ADDRESS: BitcoinAddress;
+declare const TEST_ACCOUNT_2_TAPROOT_ADDRESS: BitcoinAddress;
+declare const TEST_TESNET_ACCOUNT_1_NATIVE_SEGWIT_ADDRESS: BitcoinAddress;
+declare const TEST_TESTNET_ACCOUNT_2_BTC_ADDRESS: BitcoinAddress;
+declare const TEST_TESTNET_ACCOUNT_2_TAPROOT_ADDRESS: BitcoinAddress;
+declare const recipientAddress: BitcoinAddress;
+declare const legacyAddress: BitcoinAddress;
+declare const segwitAddress: BitcoinAddress;
+declare const taprootAddress: BitcoinAddress;
+declare const invalidAddress = "whoop-de-da-boop-da-de-not-a-bitcoin-address";
+declare const inValidCharactersAddress: BitcoinAddress;
+declare const inValidLengthAddress: BitcoinAddress;
+
 interface BtcSignerNetwork {
     bech32: string;
     pubKeyHash: number;
@@ -171,7 +195,7 @@ declare function getBtcSignerLibNetworkConfigByMode(network: BitcoinNetworkModes
 declare function getBitcoinJsLibNetworkConfigByMode(network: BitcoinNetworkModes): bitcoin.networks.Network;
 
 interface BitcoinAccount {
-    type: PaymentTypes;
+    type: BitcoinPaymentTypes;
     derivationPath: string;
     keychain: HDKey;
     accountIndex: number;
@@ -206,12 +230,12 @@ declare function getAddressFromOutScript(script: Uint8Array, bitcoinNetwork: Btc
  * Payment type identifiers, as described by `@scure/btc-signer` library
  */
 type BtcSignerLibPaymentTypeIdentifers = 'wpkh' | 'wsh' | 'tr' | 'pkh' | 'sh';
-declare const paymentTypeMap: Record<BtcSignerLibPaymentTypeIdentifers, PaymentTypes>;
+declare const paymentTypeMap: Record<BtcSignerLibPaymentTypeIdentifers, BitcoinPaymentTypes>;
 declare function btcSignerLibPaymentTypeToPaymentTypeMap(payment: BtcSignerLibPaymentTypeIdentifers): "p2tr" | "p2pkh" | "p2sh" | "p2wpkh-p2sh" | "p2wpkh";
 declare function isBtcSignerLibPaymentType(payment: string): payment is BtcSignerLibPaymentTypeIdentifers;
-declare function parseKnownPaymentType(payment: BtcSignerLibPaymentTypeIdentifers | PaymentTypes): "p2tr" | "p2pkh" | "p2sh" | "p2wpkh-p2sh" | "p2wpkh";
-type PaymentTypeMap<T> = Record<PaymentTypes, T>;
-declare function whenPaymentType(mode: PaymentTypes | BtcSignerLibPaymentTypeIdentifers): <T>(paymentMap: PaymentTypeMap<T>) => T;
+declare function parseKnownPaymentType(payment: BtcSignerLibPaymentTypeIdentifers | BitcoinPaymentTypes): "p2tr" | "p2pkh" | "p2sh" | "p2wpkh-p2sh" | "p2wpkh";
+type PaymentTypeMap<T> = Record<BitcoinPaymentTypes, T>;
+declare function whenPaymentType(mode: BitcoinPaymentTypes | BtcSignerLibPaymentTypeIdentifers): <T>(paymentMap: PaymentTypeMap<T>) => T;
 type SupportedPaymentType = 'p2wpkh' | 'p2tr';
 type SupportedPaymentTypeMap<T> = Record<SupportedPaymentType, T>;
 declare function whenSupportedPaymentType(mode: SupportedPaymentType): <T>(paymentMap: SupportedPaymentTypeMap<T>) => T;
@@ -221,13 +245,13 @@ declare function whenSupportedPaymentType(mode: SupportedPaymentType): <T>(payme
  * @example
  * `m/86'/1'/0'/0/0`
  */
-declare function inferPaymentTypeFromPath(path: string): PaymentTypes;
+declare function inferPaymentTypeFromPath(path: string): BitcoinPaymentTypes;
 declare function inferNetworkFromPath(path: string): NetworkModes;
 declare function extractExtendedPublicKeyFromPolicy(policy: string): string;
 declare function createWalletIdDecoratedPath(policy: string, walletId: string): string;
 declare function getHdKeyVersionsFromNetwork(network: NetworkModes): Versions | undefined;
 declare function getBitcoinInputAddress(input: TransactionInput, bitcoinNetwork: BtcSignerNetwork): string;
-declare function getInputPaymentType(input: TransactionInput, network: BitcoinNetworkModes): PaymentTypes;
+declare function getInputPaymentType(input: TransactionInput, network: BitcoinNetworkModes): BitcoinPaymentTypes;
 declare function lookUpLedgerKeysByPath(getDerivationPath: (network: BitcoinNetworkModes, accountIndex: number) => string): (ledgerKeyMap: Record<string, {
     policy: string;
 } | undefined>, network: BitcoinNetworkModes) => (accountIndex: number) => BitcoinAccount | undefined;
@@ -245,10 +269,132 @@ declare function getNativeSegwitAddress({ index, keychain, network }: GetAddress
 declare function mnemonicToRootNode(secretKey: string): HDKey;
 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 inferNetworkFromAddress(address: BitcoinAddress): BitcoinNetworkModes;
+declare function inferPaymentTypeFromAddress(address: BitcoinAddress): SupportedPaymentType;
 declare function getBitcoinInputValue(input: TransactionInput): number;
 
+declare function makeTaprootAccountDerivationPath(network: BitcoinNetworkModes, accountIndex: number): string;
+/** @deprecated Use makeTaprootAccountDerivationPath */
+declare const getTaprootAccountDerivationPath: typeof makeTaprootAccountDerivationPath;
+declare function makeTaprootAddressIndexDerivationPath(network: BitcoinNetworkModes, accountIndex: number, addressIndex: number): string;
+/** @deprecated Use makeTaprootAddressIndexDerivationPath */
+declare const getTaprootAddressIndexDerivationPath: typeof makeTaprootAddressIndexDerivationPath;
+declare function deriveTaprootAccount(keychain: HDKey, network: BitcoinNetworkModes): (accountIndex: number) => BitcoinAccount;
+declare function getTaprootPayment(publicKey: Uint8Array, network: BitcoinNetworkModes): _scure_btc_signer_payment.P2TROut;
+declare function getTaprootPaymentFromAddressIndex(keychain: HDKey, network: BitcoinNetworkModes): _scure_btc_signer_payment.P2TROut;
+interface DeriveTaprootReceiveAddressIndexArgs {
+    keychain: HDKey;
+    network: BitcoinNetworkModes;
+}
+declare function deriveTaprootReceiveAddressIndexZero({ keychain, network, }: DeriveTaprootReceiveAddressIndexArgs): {
+    keychain: HDKey;
+    payment: _scure_btc_signer_payment.P2TROut;
+};
+
+declare function makeNativeSegwitAccountDerivationPath(network: BitcoinNetworkModes, accountIndex: number): string;
+/** @deprecated Use makeNativeSegwitAccountDerivationPath */
+declare const getNativeSegwitAccountDerivationPath: typeof makeNativeSegwitAccountDerivationPath;
+declare function makeNativeSegwitAddressIndexDerivationPath(network: BitcoinNetworkModes, accountIndex: number, addressIndex: number): string;
+/** @deprecated Use makeNativeSegwitAddressIndexDerivationPath */
+declare const getNativeSegwitAddressIndexDerivationPath: typeof makeNativeSegwitAddressIndexDerivationPath;
+declare function deriveNativeSegwitAccountFromRootKeychain(keychain: HDKey, network: BitcoinNetworkModes): (accountIndex: number) => BitcoinAccount;
+declare function getNativeSegwitPaymentFromAddressIndex(keychain: HDKey, network: BitcoinNetworkModes): _scure_btc_signer_payment.P2Ret;
+interface DeriveNativeSegwitReceiveAddressIndexArgs {
+    keychain: HDKey;
+    network: BitcoinNetworkModes;
+}
+declare function deriveNativeSegwitReceiveAddressIndexZero({ keychain, network, }: DeriveNativeSegwitReceiveAddressIndexArgs): {
+    keychain: HDKey;
+    payment: _scure_btc_signer_payment.P2Ret;
+};
+
+/**
+ * @deprecated
+ * Use `deriveBip39MnemonicFromSeed` from `@leather.io/crypto`
+ */
+declare const deriveBtcBip49SeedFromMnemonic: typeof deriveBip39SeedFromMnemonic;
+/**
+ * @deprecated
+ * Use `deriveRootBip32Keychain` from `@leather.io/crypto`
+ */
+declare const deriveRootBtcKeychain: typeof deriveRootBip32Keychain;
+declare function decodeCompressedWifPrivateKey(key: string): Uint8Array;
+declare const payToScriptHashTestnetPrefix = 196;
+declare function makePayToScriptHashKeyHash(publicKey: Uint8Array): Uint8Array;
+declare function makePayToScriptHashAddressBytes(keyHash: Uint8Array): Uint8Array;
+declare function makePayToScriptHashAddress(addressBytes: Uint8Array, network: NetworkModes): string;
+declare function publicKeyToPayToScriptHashAddress(publicKey: Uint8Array, network: NetworkModes): string;
+
+interface PsbtInput {
+    address: BitcoinAddress;
+    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: BitcoinAddress[];
+}
+interface GetParsedInputsResponse {
+    isPsbtMutable: boolean;
+    parsedInputs: PsbtInput[];
+}
+declare function getParsedInputs({ inputs, indexesToSign, networkMode, psbtAddresses, }: GetParsedInputsArgs): GetParsedInputsResponse;
+
+interface PsbtOutput {
+    address: BitcoinAddress;
+    isMutable: boolean;
+    toSign: boolean;
+    value: number;
+}
+interface GetParsedOutputsArgs {
+    isPsbtMutable: boolean;
+    outputs: TransactionOutput[];
+    networkMode: BitcoinNetworkModes;
+    psbtAddresses: BitcoinAddress[];
+}
+declare function getParsedOutputs({ isPsbtMutable, outputs, networkMode, psbtAddresses, }: GetParsedOutputsArgs): PsbtOutput[];
+
+interface GetPsbtTotalsProps {
+    psbtAddresses: BitcoinAddress[];
+    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: BitcoinAddress[];
+    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>;
+
 type AllowedSighashTypes = ValueOf<typeof signatureHash> | SigHash;
 interface BitcoinAccountKeychain {
     descriptor: string;
@@ -265,7 +411,7 @@ interface BitcoinSigner<Payment> {
     payment: Payment;
     keychain: HDKey;
     derivationPath: string;
-    address: string;
+    address: BitcoinAddress;
     publicKey: Uint8Array;
     sign(tx: btc.Transaction): void;
     signIndex(tx: btc.Transaction, index: number, allowedSighash?: AllowedSighashTypes[]): void;
@@ -273,7 +419,7 @@ interface BitcoinSigner<Payment> {
 interface BitcoinPayerBase {
     paymentType: PaymentTypes;
     network: BitcoinNetworkModes;
-    address: string;
+    address: BitcoinAddress;
     keyOrigin: string;
     masterKeyFingerprint: string;
     publicKey: Uint8Array;
@@ -371,70 +517,43 @@ declare function generateBitcoinUnsignedTransactionNativeSegwit({ feeRate, isSen
     fee: _leather_io_models.Money;
 };
 
+declare function getBitcoinAddressNetworkType(network: BitcoinNetworkModes): Network;
+declare function isValidBitcoinAddress(address: string): boolean;
+declare function isValidBitcoinNetworkAddress(address: string, network: BitcoinNetworkModes): boolean;
+
+declare const minSpendAmountInSats = 546;
+interface isBtcBalanceSufficientArgs {
+    amount: Money;
+    spendableBtc: BigNumber;
+}
+declare function isBtcBalanceSufficient({ amount: { amount }, spendableBtc, }: isBtcBalanceSufficientArgs): boolean;
+interface IsBtcMinimumSpendArgs {
+    amount: Money;
+}
+declare function isBtcMinimumSpend({ amount: { amount } }: IsBtcMinimumSpendArgs): boolean;
+
+type TransactionErrorKey = 'InvalidAddress' | 'InsufficientFunds' | 'InvalidNetworkAddress';
 declare class BitcoinError extends Error {
     message: BitcoinErrorKey;
     constructor(message: BitcoinErrorKey);
 }
-type BitcoinErrorKey = 'InvalidAddress' | 'InsufficientFunds' | 'NoInputsToSign' | 'NoOutputsToSign';
-
-declare function makeTaprootAccountDerivationPath(network: BitcoinNetworkModes, accountIndex: number): string;
-/** @deprecated Use makeTaprootAccountDerivationPath */
-declare const getTaprootAccountDerivationPath: typeof makeTaprootAccountDerivationPath;
-declare function makeTaprootAddressIndexDerivationPath(network: BitcoinNetworkModes, accountIndex: number, addressIndex: number): string;
-/** @deprecated Use makeTaprootAddressIndexDerivationPath */
-declare const getTaprootAddressIndexDerivationPath: typeof makeTaprootAddressIndexDerivationPath;
-declare function deriveTaprootAccount(keychain: HDKey, network: BitcoinNetworkModes): (accountIndex: number) => BitcoinAccount;
-declare function getTaprootPayment(publicKey: Uint8Array, network: BitcoinNetworkModes): _scure_btc_signer_payment.P2TROut;
-declare function getTaprootPaymentFromAddressIndex(keychain: HDKey, network: BitcoinNetworkModes): _scure_btc_signer_payment.P2TROut;
-interface DeriveTaprootReceiveAddressIndexArgs {
-    keychain: HDKey;
-    network: BitcoinNetworkModes;
-}
-declare function deriveTaprootReceiveAddressIndexZero({ keychain, network, }: DeriveTaprootReceiveAddressIndexArgs): {
-    keychain: HDKey;
-    payment: _scure_btc_signer_payment.P2TROut;
-};
+type BitcoinErrorKey = TransactionErrorKey | 'InsufficientAmount' | 'NoInputsToSign' | 'NoOutputsToSign';
 
-declare function makeNativeSegwitAccountDerivationPath(network: BitcoinNetworkModes, accountIndex: number): string;
-/** @deprecated Use makeNativeSegwitAccountDerivationPath */
-declare const getNativeSegwitAccountDerivationPath: typeof makeNativeSegwitAccountDerivationPath;
-declare function makeNativeSegwitAddressIndexDerivationPath(network: BitcoinNetworkModes, accountIndex: number, addressIndex: number): string;
-/** @deprecated Use makeNativeSegwitAddressIndexDerivationPath */
-declare const getNativeSegwitAddressIndexDerivationPath: typeof makeNativeSegwitAddressIndexDerivationPath;
-declare function deriveNativeSegwitAccountFromRootKeychain(keychain: HDKey, network: BitcoinNetworkModes): (accountIndex: number) => BitcoinAccount;
-declare function getNativeSegwitPaymentFromAddressIndex(keychain: HDKey, network: BitcoinNetworkModes): _scure_btc_signer_payment.P2Ret;
-interface DeriveNativeSegwitReceiveAddressIndexArgs {
-    keychain: HDKey;
+interface BitcoinTransaction extends Omit<GetBitcoinFeesArgs, 'recipients'> {
+    amount: Money;
+    payer: BitcoinAddress;
+    recipient: BitcoinAddress;
     network: BitcoinNetworkModes;
+    feeRate: number;
 }
-declare function deriveNativeSegwitReceiveAddressIndexZero({ keychain, network, }: DeriveNativeSegwitReceiveAddressIndexArgs): {
-    keychain: HDKey;
-    payment: _scure_btc_signer_payment.P2Ret;
-};
-
-/**
- * @deprecated
- * Use `deriveBip39MnemonicFromSeed` from `@leather.io/crypto`
- */
-declare const deriveBtcBip49SeedFromMnemonic: typeof deriveBip39SeedFromMnemonic;
-/**
- * @deprecated
- * Use `deriveRootBip32Keychain` from `@leather.io/crypto`
- */
-declare const deriveRootBtcKeychain: typeof deriveRootBip32Keychain;
-declare function decodeCompressedWifPrivateKey(key: string): Uint8Array;
-declare const payToScriptHashTestnetPrefix = 196;
-declare function makePayToScriptHashKeyHash(publicKey: Uint8Array): Uint8Array;
-declare function makePayToScriptHashAddressBytes(keyHash: Uint8Array): Uint8Array;
-declare function makePayToScriptHashAddress(addressBytes: Uint8Array, network: NetworkModes): string;
-declare function publicKeyToPayToScriptHashAddress(publicKey: Uint8Array, network: NetworkModes): string;
+declare function isValidBitcoinTransaction({ amount, payer, recipient, network, utxos, feeRate, feeRates, }: BitcoinTransaction): void;
 
 interface LookUpDerivationByAddressArgs {
     taprootXpub: string;
     nativeSegwitXpub: string;
     iterationLimit: number;
 }
-declare function lookupDerivationByAddress(args: LookUpDerivationByAddressArgs): (address: string) => {
+declare function lookupDerivationByAddress(args: LookUpDerivationByAddressArgs): (address: BitcoinAddress) => {
     readonly status: "success";
     readonly duration: number;
     readonly path: string;
@@ -444,74 +563,4 @@ declare function lookupDerivationByAddress(args: LookUpDerivationByAddressArgs):
     readonly path?: undefined;
 };
 
-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, type BitcoinErrorKey, 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 };
+export { type AllowedSighashTypes, type BitcoinAccount, type BitcoinAccountKeychain, type BitcoinAddress, BitcoinError, type BitcoinErrorKey, 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, TEST_ACCOUNT_1_NATIVE_SEGWIT_ADDRESS, TEST_ACCOUNT_1_TAPROOT_ADDRESS, TEST_ACCOUNT_2_TAPROOT_ADDRESS, TEST_TESNET_ACCOUNT_1_NATIVE_SEGWIT_ADDRESS, TEST_TESTNET_ACCOUNT_2_BTC_ADDRESS, TEST_TESTNET_ACCOUNT_2_TAPROOT_ADDRESS, type WithDerivePayer, bip322TransactionToSignValues, bitcoinNetworkModeToCoreNetworkMode, bitcoinNetworkToCoreNetworkMap, btcSignerLibPaymentTypeToPaymentTypeMap, calculateMaxSpend, coinTypeMap, createBitcoinAddress, 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, getBitcoinAddressNetworkType, 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, inValidCharactersAddress, inValidLengthAddress, inferNetworkFromAddress, inferNetworkFromPath, inferPaymentTypeFromAddress, inferPaymentTypeFromPath, initBitcoinAccount, initializeBitcoinAccountKeychainFromDescriptor, invalidAddress, isBitcoinAddress, isBtcBalanceSufficient, isBtcMinimumSpend, isBtcSignerLibPaymentType, isSupportedMessageSigningPaymentType, isValidBitcoinAddress, isValidBitcoinNetworkAddress, isValidBitcoinTransaction, legacyAddress, lookUpLedgerKeysByPath, lookupDerivationByAddress, makeNativeSegwitAccountDerivationPath, makeNativeSegwitAddressIndexDerivationPath, makePayToScriptHashAddress, makePayToScriptHashAddressBytes, makePayToScriptHashKeyHash, makeTaprootAccountDerivationPath, makeTaprootAddressIndexDerivationPath, minSpendAmountInSats, mnemonicToRootNode, parseKnownPaymentType, payToScriptHashTestnetPrefix, payerToBip32Derivation, payerToTapBip32Derivation, paymentTypeMap, publicKeyToPayToScriptHashAddress, recipientAddress, segwitAddress, serializeKeyOrigin, signBip322MessageSimple, taprootAddress, toXOnly, tweakSigner, whenBitcoinNetwork, whenPaymentType, whenSupportedPaymentType };