@ledgerhq/hw-app-btc 6.10.0-taproot.0 → 6.11.2

package/README.md

@@ -13,38 +13,96 @@ Ledger Hardware Wallet BTC JavaScript bindings. Also supports many altcoins.
 
 #### Table of Contents
 
--   [Btc](#btc)
-    -   [Parameters](#parameters)
-    -   [Examples](#examples)
-    -   [getWalletPublicKey](#getwalletpublickey)
-        -   [Parameters](#parameters-1)
-        -   [Examples](#examples-1)
-    -   [signMessageNew](#signmessagenew)
-        -   [Parameters](#parameters-2)
-        -   [Examples](#examples-2)
-    -   [createPaymentTransactionNew](#createpaymenttransactionnew)
-        -   [Parameters](#parameters-3)
-        -   [Examples](#examples-3)
-    -   [signP2SHTransaction](#signp2shtransaction)
-        -   [Parameters](#parameters-4)
-        -   [Examples](#examples-4)
-    -   [splitTransaction](#splittransaction)
-        -   [Parameters](#parameters-5)
-        -   [Examples](#examples-5)
-    -   [serializeTransactionOutputs](#serializetransactionoutputs)
-        -   [Parameters](#parameters-6)
-        -   [Examples](#examples-6)
--   [CreateTransactionArg](#createtransactionarg)
-    -   [Properties](#properties)
--   [AddressFormat](#addressformat)
--   [serializeTransactionOutputs](#serializetransactionoutputs-1)
-    -   [Parameters](#parameters-7)
-    -   [Examples](#examples-7)
--   [SignP2SHTransactionArg](#signp2shtransactionarg)
-    -   [Properties](#properties-1)
--   [TransactionInput](#transactioninput)
--   [TransactionOutput](#transactionoutput)
--   [Transaction](#transaction)
+*   [Btc](#btc)
+    *   [Parameters](#parameters)
+    *   [Examples](#examples)
+    *   [getWalletXpub](#getwalletxpub)
+        *   [Parameters](#parameters-1)
+    *   [getWalletPublicKey](#getwalletpublickey)
+        *   [Parameters](#parameters-2)
+        *   [Examples](#examples-1)
+    *   [signMessageNew](#signmessagenew)
+        *   [Parameters](#parameters-3)
+        *   [Examples](#examples-2)
+    *   [createPaymentTransactionNew](#createpaymenttransactionnew)
+        *   [Parameters](#parameters-4)
+        *   [Examples](#examples-3)
+    *   [signP2SHTransaction](#signp2shtransaction)
+        *   [Parameters](#parameters-5)
+        *   [Examples](#examples-4)
+    *   [splitTransaction](#splittransaction)
+        *   [Parameters](#parameters-6)
+        *   [Examples](#examples-5)
+    *   [serializeTransactionOutputs](#serializetransactionoutputs)
+        *   [Parameters](#parameters-7)
+        *   [Examples](#examples-6)
+*   [getWalletPublicKey](#getwalletpublickey-1)
+*   [BtcNew](#btcnew)
+    *   [Parameters](#parameters-8)
+    *   [getWalletXpub](#getwalletxpub-1)
+        *   [Parameters](#parameters-9)
+    *   [getWalletPublicKey](#getwalletpublickey-2)
+        *   [Parameters](#parameters-10)
+    *   [createPaymentTransactionNew](#createpaymenttransactionnew-1)
+        *   [Parameters](#parameters-11)
+*   [BtcOld](#btcold)
+    *   [Parameters](#parameters-12)
+    *   [Examples](#examples-7)
+    *   [getWalletPublicKey](#getwalletpublickey-3)
+        *   [Parameters](#parameters-13)
+        *   [Examples](#examples-8)
+    *   [signMessageNew](#signmessagenew-1)
+        *   [Parameters](#parameters-14)
+        *   [Examples](#examples-9)
+    *   [createPaymentTransactionNew](#createpaymenttransactionnew-2)
+        *   [Parameters](#parameters-15)
+        *   [Examples](#examples-10)
+    *   [signP2SHTransaction](#signp2shtransaction-1)
+        *   [Parameters](#parameters-16)
+        *   [Examples](#examples-11)
+*   [CreateTransactionArg](#createtransactionarg)
+    *   [Properties](#properties)
+*   [AddressFormat](#addressformat)
+*   [AccountType](#accounttype)
+    *   [spendingCondition](#spendingcondition)
+        *   [Parameters](#parameters-17)
+    *   [setInput](#setinput)
+        *   [Parameters](#parameters-18)
+    *   [setOwnOutput](#setownoutput)
+        *   [Parameters](#parameters-19)
+    *   [getDescriptorTemplate](#getdescriptortemplate)
+*   [SingleKeyAccount](#singlekeyaccount)
+*   [getTaprootOutputKey](#gettaprootoutputkey)
+    *   [Parameters](#parameters-20)
+*   [AppClient](#appclient)
+    *   [Parameters](#parameters-21)
+*   [ClientCommandInterpreter](#clientcommandinterpreter)
+    *   [Parameters](#parameters-22)
+*   [MerkelizedPsbt](#merkelizedpsbt)
+    *   [Parameters](#parameters-23)
+*   [Merkle](#merkle)
+    *   [Parameters](#parameters-24)
+*   [MerkleMap](#merklemap)
+    *   [Parameters](#parameters-25)
+*   [WalletPolicy](#walletpolicy)
+    *   [Parameters](#parameters-26)
+*   [extract](#extract)
+    *   [Parameters](#parameters-27)
+*   [finalize](#finalize)
+    *   [Parameters](#parameters-28)
+*   [clearFinalizedInput](#clearfinalizedinput)
+    *   [Parameters](#parameters-29)
+*   [writePush](#writepush)
+    *   [Parameters](#parameters-30)
+*   [PsbtV2](#psbtv2)
+*   [serializeTransactionOutputs](#serializetransactionoutputs-1)
+    *   [Parameters](#parameters-31)
+    *   [Examples](#examples-12)
+*   [SignP2SHTransactionArg](#signp2shtransactionarg)
+    *   [Properties](#properties-1)
+*   [TransactionInput](#transactioninput)
+*   [TransactionOutput](#transactionoutput)
+*   [Transaction](#transaction)
 
 ### Btc
 
@@ -52,8 +110,8 @@ Bitcoin API.
 
 #### Parameters
 
--   `transport` **Transport** 
--   `scrambleKey`   (optional, default `"BTC"`)
+*   `transport` **Transport** 
+*   `scrambleKey`   (optional, default `"BTC"`)
 
 #### Examples
 
@@ -62,21 +120,32 @@ import Btc from "@ledgerhq/hw-app-btc";
 const btc = new Btc(transport)
 ```
 
+#### getWalletXpub
+
+Get an XPUB with a ledger device
+
+##### Parameters
+
+*   `arg` **{path: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), xpubVersion: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)}** derivation parameter*   path: a BIP 32 path of the account level. e.g. `84'/0'/0'`
+    *   xpubVersion: the XPUBVersion of the coin used. (use @ledgerhq/currencies if needed)
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** XPUB of the account
+
 #### getWalletPublicKey
 
 ##### Parameters
 
--   `path` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** a BIP 32 path
--   `opts` **{verify: [boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?, format: [AddressFormat](#addressformat)?}?** 
--   `options`  an object with optional these fields:-   verify (boolean) will ask user to confirm the address on the device
+*   `path` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** a BIP 32 path
+*   `opts` **{verify: [boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?, format: [AddressFormat](#addressformat)?}?** 
+*   `options`  an object with optional these fields:*   verify (boolean) will ask user to confirm the address on the device
 
-    -   format ("legacy" | "p2sh" | "bech32" | "cashaddr") to use different bitcoin address formatter.NB The normal usage is to use:-   legacy format with 44' paths
+    *   format ("legacy" | "p2sh" | "bech32" | "bech32m" | "cashaddr") to use different bitcoin address formatter.NB The normal usage is to use:*   legacy format with 44' paths
 
-    -   p2sh format with 49' paths
+    *   p2sh format with 49' paths
 
-    -   bech32 format with 173' paths
+    *   bech32 format with 84' paths
 
-    -   cashaddr in case of Bitcoin Cash
+    *   cashaddr in case of Bitcoin Cash
 
 ##### Examples
 
@@ -85,7 +154,7 @@ btc.getWalletPublicKey("44'/0'/0'/0/0").then(o => o.bitcoinAddress)
 btc.getWalletPublicKey("49'/0'/0'/0/0", { format: "p2sh" }).then(o => o.bitcoinAddress)
 ```
 
-Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)&lt;{publicKey: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), bitcoinAddress: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), chainCode: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)}>** 
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<{publicKey: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), bitcoinAddress: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), chainCode: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)}>** 
 
 #### signMessageNew
 
@@ -93,8 +162,8 @@ You can sign a message according to the Bitcoin Signature format and retrieve v,
 
 ##### Parameters
 
--   `path` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** 
--   `messageHex` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** 
+*   `path` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** 
+*   `messageHex` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** 
 
 ##### Examples
 
@@ -106,7 +175,7 @@ console.log("Signature : " + signature);
 }).catch(function(ex) {console.log(ex);});
 ```
 
-Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)&lt;{v: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), r: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), s: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)}>** 
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<{v: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), r: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), s: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)}>** 
 
 #### createPaymentTransactionNew
 
@@ -114,25 +183,26 @@ To sign a transaction involving standard (P2PKH) inputs, call createTransaction
 
 ##### Parameters
 
--   `arg` **[CreateTransactionArg](#createtransactionarg)** 
--   `inputs`  is an array of [ transaction, output_index, optional redeem script, optional sequence ] where-   transaction is the previously computed transaction object for this UTXO
-    -   output_index is the output in the transaction used as input for this UTXO (counting from 0)
-    -   redeem script is the optional redeem script to use when consuming a Segregated Witness input
-    -   sequence is the sequence number to use for this input (when using RBF), or non present
--   `associatedKeysets`  is an array of BIP 32 paths pointing to the path to the private key used for each UTXO
--   `changePath`  is an optional BIP 32 path pointing to the path to the public key used to compute the change address
--   `outputScriptHex`  is the hexadecimal serialized outputs of the transaction to sign
--   `lockTime`  is the optional lockTime of the transaction to sign, or default (0)
--   `sigHashType`  is the hash type of the transaction to sign, or default (all)
--   `segwit`  is an optional boolean indicating wether to use segwit or not
--   `initialTimestamp`  is an optional timestamp of the function call to use for coins that necessitate timestamps only, (not the one that the tx will include)
--   `additionals`  list of additionnal options-   "bech32" for spending native segwit outputs
-    -   "abc" for bch
-    -   "gold" for btg
-    -   "bipxxx" for using BIPxxx
-    -   "sapling" to indicate a zec transaction is supporting sapling (to be set over block 419200)
--   `expiryHeight`  is an optional Buffer for zec overwinter / sapling Txs
--   `useTrustedInputForSegwit`  trust inputs for segwit transactions
+*   `arg` **[CreateTransactionArg](#createtransactionarg)** 
+*   `inputs`  is an array of \[ transaction, output_index, optional redeem script, optional sequence ] where*   transaction is the previously computed transaction object for this UTXO
+    *   output_index is the output in the transaction used as input for this UTXO (counting from 0)
+    *   redeem script is the optional redeem script to use when consuming a Segregated Witness input
+    *   sequence is the sequence number to use for this input (when using RBF), or non present
+*   `associatedKeysets`  is an array of BIP 32 paths pointing to the path to the private key used for each UTXO
+*   `changePath`  is an optional BIP 32 path pointing to the path to the public key used to compute the change address
+*   `outputScriptHex`  is the hexadecimal serialized outputs of the transaction to sign, including leading vararg voutCount
+*   `lockTime`  is the optional lockTime of the transaction to sign, or default (0)
+*   `sigHashType`  is the hash type of the transaction to sign, or default (all)
+*   `segwit`  is an optional boolean indicating wether to use segwit or not. This includes wrapped segwit.
+*   `initialTimestamp`  is an optional timestamp of the function call to use for coins that necessitate timestamps only, (not the one that the tx will include)
+*   `additionals`  list of additionnal options*   "bech32" for spending native segwit outputs
+    *   "bech32m" for spending segwit v1+ outputs
+    *   "abc" for bch
+    *   "gold" for btg
+    *   "bipxxx" for using BIPxxx
+    *   "sapling" to indicate a zec transaction is supporting sapling (to be set over block 419200)
+*   `expiryHeight`  is an optional Buffer for zec overwinter / sapling Txs
+*   `useTrustedInputForSegwit`  trust inputs for segwit transactions. If app version >= 1.4.0 this should be true.
 
 ##### Examples
 
@@ -144,7 +214,7 @@ outputScriptHex: "01905f0100000000001976a91472a5d75c8d2d0565b656a5232703b167d50d
 }).then(res => ...);
 ```
 
-Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)&lt;[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** the signed transaction ready to be broadcast
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** the signed transaction ready to be broadcast
 
 #### signP2SHTransaction
 
@@ -152,15 +222,15 @@ To obtain the signature of multisignature (P2SH) inputs, call signP2SHTransactio
 
 ##### Parameters
 
--   `arg` **[SignP2SHTransactionArg](#signp2shtransactionarg)** 
--   `inputs`  is an array of [ transaction, output_index, redeem script, optional sequence ] where-   transaction is the previously computed transaction object for this UTXO
-    -   output_index is the output in the transaction used as input for this UTXO (counting from 0)
-    -   redeem script is the mandatory redeem script associated to the current P2SH input
-    -   sequence is the sequence number to use for this input (when using RBF), or non present
--   `associatedKeysets`  is an array of BIP 32 paths pointing to the path to the private key used for each UTXO
--   `outputScriptHex`  is the hexadecimal serialized outputs of the transaction to sign
--   `lockTime`  is the optional lockTime of the transaction to sign, or default (0)
--   `sigHashType`  is the hash type of the transaction to sign, or default (all)
+*   `arg` **[SignP2SHTransactionArg](#signp2shtransactionarg)** 
+*   `inputs`  is an array of \[ transaction, output_index, redeem script, optional sequence ] where*   transaction is the previously computed transaction object for this UTXO
+    *   output_index is the output in the transaction used as input for this UTXO (counting from 0)
+    *   redeem script is the mandatory redeem script associated to the current P2SH input
+    *   sequence is the sequence number to use for this input (when using RBF), or non present
+*   `associatedKeysets`  is an array of BIP 32 paths pointing to the path to the private key used for each UTXO
+*   `outputScriptHex`  is the hexadecimal serialized outputs of the transaction to sign
+*   `lockTime`  is the optional lockTime of the transaction to sign, or default (0)
+*   `sigHashType`  is the hash type of the transaction to sign, or default (all)
 
 ##### Examples
 
@@ -172,7 +242,7 @@ outputScriptHex: "01905f0100000000001976a91472a5d75c8d2d0565b656a5232703b167d50d
 }).then(result => ...);
 ```
 
-Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)&lt;[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>>** the signed transaction ready to be broadcast
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>>** the signed transaction ready to be broadcast
 
 #### splitTransaction
 
@@ -180,11 +250,11 @@ For each UTXO included in your transaction, create a transaction object from the
 
 ##### Parameters
 
--   `transactionHex` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** 
--   `isSegwitSupported` **([boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**  (optional, default `false`)
--   `hasTimestamp`   (optional, default `false`)
--   `hasExtraData`   (optional, default `false`)
--   `additionals` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>**  (optional, default `[]`)
+*   `transactionHex` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** 
+*   `isSegwitSupported` **([boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))**  (optional, default `false`)
+*   `hasTimestamp`   (optional, default `false`)
+*   `hasExtraData`   (optional, default `false`)
+*   `additionals` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>**  (optional, default `[]`)
 
 ##### Examples
 
@@ -198,7 +268,7 @@ Returns **[Transaction](#transaction)**
 
 ##### Parameters
 
--   `t` **[Transaction](#transaction)** 
+*   `t` **[Transaction](#transaction)** 
 
 ##### Examples
 
@@ -209,39 +279,522 @@ const outputScript = btc.serializeTransactionOutputs(tx1).toString('hex');
 
 Returns **[Buffer](https://nodejs.org/api/buffer.html)** 
 
+### getWalletPublicKey
+
+Definition: A "normal path" is a prefix of a standard path where all
+the hardened steps of the standard path are included. For example, the
+paths m/44'/1'/17' and m/44'/1'/17'/1 are normal paths, but m/44'/1'
+is not. m/'199/1'/17'/0/1 is not a normal path either.
+
+There's a compatiblity issue between old and new app: When exporting
+the key of a non-normal path with verify=false, the new app would
+return an error, whereas the old app would return the key.
+
+See
+<https://github.com/LedgerHQ/app-bitcoin-new/blob/master/doc/bitcoin.md#get_extended_pubkey>
+
+If format bech32m is used, we'll not use old, because it doesn't
+support it.
+
+When to use new (given the app supports it)
+
+*   format is bech32m or
+*   path is normal or
+*   verify is true
+
+Otherwise use old.
+
+### BtcNew
+
+This class implements the same interface as BtcOld (formerly
+named Btc), but interacts with Bitcoin hardware app version 2+
+which uses a totally new APDU protocol. This new
+protocol is documented at
+<https://github.com/LedgerHQ/app-bitcoin-new/blob/master/doc/bitcoin.md>
+
+Since the interface must remain compatible with BtcOld, the methods
+of this class are quite clunky, because it needs to adapt legacy
+input data into the PSBT process. In the future, a new interface should
+be developed that exposes PSBT to the outer world, which would render
+a much cleaner implementation.
+
+#### Parameters
+
+*   ``  
+
+#### getWalletXpub
+
+This is a new method that allow users to get an xpub at a standard path.
+Standard paths are described at
+<https://github.com/LedgerHQ/app-bitcoin-new/blob/master/doc/bitcoin.md#description>
+
+This boils down to paths (N=0 for Bitcoin, N=1 for Testnet):
+M/44'/N'/x'/\*\*
+M/48'/N'/x'/y'/\*\*
+M/49'/N'/x'/\*\*
+M/84'/N'/x'/\*\*
+M/86'/N'/x'/\*\*
+
+The method was added because of added security in the hardware app v2+. The
+new hardware app will allow export of any xpub up to and including the
+deepest hardened key of standard derivation paths, whereas the old app
+would allow export of any key.
+
+This caused an issue for callers of this class, who only had
+getWalletPublicKey() to call which means they have to constuct xpub
+themselves:
+
+Suppose a user of this class wants to create an account xpub on a standard
+path, M/44'/0'/Z'. The user must get the parent key fingerprint (see BIP32)
+by requesting the parent key M/44'/0'. The new app won't allow that, because
+it only allows exporting deepest level hardened path. So the options are to
+allow requesting M/44'/0' from the app, or to add a new function
+"getWalletXpub".
+
+We opted for adding a new function, which can greatly simplify client code.
+
+##### Parameters
+
+*   `$0` **{path: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), xpubVersion: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)}** 
+
+    *   `$0.path`  
+    *   `$0.xpubVersion`  
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** 
+
+#### getWalletPublicKey
+
+This method returns a public key, a bitcoin address, and and a chaincode
+for a specific derivation path.
+
+Limitation: If the path is not a leaf node of a standard path, the address
+will be the empty string "", see this.getWalletAddress() for details.
+
+##### Parameters
+
+*   `path` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** 
+*   `opts` **{verify: [boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?, format: [AddressFormat](#addressformat)?}?** 
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<{publicKey: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), bitcoinAddress: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), chainCode: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)}>** 
+
+#### createPaymentTransactionNew
+
+Build and sign a transaction. See Btc.createPaymentTransactionNew for
+details on how to use this method.
+
+This method will convert the legacy arguments, CreateTransactionArg, into
+a psbt which is finally signed and finalized, and the extracted fully signed
+transaction is returned.
+
+##### Parameters
+
+*   `arg` **[CreateTransactionArg](#createtransactionarg)** 
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** 
+
+### BtcOld
+
+Bitcoin API.
+
+#### Parameters
+
+*   ``  
+
+#### Examples
+
+```javascript
+import Btc from "@ledgerhq/hw-app-btc";
+const btc = new Btc(transport)
+```
+
+#### getWalletPublicKey
+
+##### Parameters
+
+*   `path` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** a BIP 32 path
+*   `opts` **{verify: [boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?, format: [AddressFormat](#addressformat)?}?** 
+*   `options`  an object with optional these fields:*   verify (boolean) will ask user to confirm the address on the device
+
+    *   format ("legacy" | "p2sh" | "bech32" | "cashaddr") to use different bitcoin address formatter.NB The normal usage is to use:*   legacy format with 44' paths
+
+    *   p2sh format with 49' paths
+
+    *   bech32 format with 173' paths
+
+    *   cashaddr in case of Bitcoin Cash
+
+##### Examples
+
+```javascript
+btc.getWalletPublicKey("44'/0'/0'/0/0").then(o => o.bitcoinAddress)
+btc.getWalletPublicKey("49'/0'/0'/0/0", { format: "p2sh" }).then(o => o.bitcoinAddress)
+```
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<{publicKey: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), bitcoinAddress: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), chainCode: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)}>** 
+
+#### signMessageNew
+
+You can sign a message according to the Bitcoin Signature format and retrieve v, r, s given the message and the BIP 32 path of the account to sign.
+
+##### Parameters
+
+*   `path` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** 
+*   `messageHex` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** 
+
+##### Examples
+
+```javascript
+btc.signMessageNew_async("44'/60'/0'/0'/0", Buffer.from("test").toString("hex")).then(function(result) {
+var v = result['v'] + 27 + 4;
+var signature = Buffer.from(v.toString(16) + result['r'] + result['s'], 'hex').toString('base64');
+console.log("Signature : " + signature);
+}).catch(function(ex) {console.log(ex);});
+```
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<{v: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), r: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), s: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)}>** 
+
+#### createPaymentTransactionNew
+
+To sign a transaction involving standard (P2PKH) inputs, call createTransaction with the following parameters
+
+##### Parameters
+
+*   `arg` **[CreateTransactionArg](#createtransactionarg)** 
+*   `inputs`  is an array of \[ transaction, output_index, optional redeem script, optional sequence ] where*   transaction is the previously computed transaction object for this UTXO
+    *   output_index is the output in the transaction used as input for this UTXO (counting from 0)
+    *   redeem script is the optional redeem script to use when consuming a Segregated Witness input
+    *   sequence is the sequence number to use for this input (when using RBF), or non present
+*   `associatedKeysets`  is an array of BIP 32 paths pointing to the path to the private key used for each UTXO
+*   `changePath`  is an optional BIP 32 path pointing to the path to the public key used to compute the change address
+*   `outputScriptHex`  is the hexadecimal serialized outputs of the transaction to sign
+*   `lockTime`  is the optional lockTime of the transaction to sign, or default (0)
+*   `sigHashType`  is the hash type of the transaction to sign, or default (all)
+*   `segwit`  is an optional boolean indicating wether to use segwit or not
+*   `initialTimestamp`  is an optional timestamp of the function call to use for coins that necessitate timestamps only, (not the one that the tx will include)
+*   `additionals`  list of additionnal options*   "bech32" for spending native segwit outputs
+    *   "abc" for bch
+    *   "gold" for btg
+    *   "bipxxx" for using BIPxxx
+    *   "sapling" to indicate a zec transaction is supporting sapling (to be set over block 419200)
+*   `expiryHeight`  is an optional Buffer for zec overwinter / sapling Txs
+*   `useTrustedInputForSegwit`  trust inputs for segwit transactions
+
+##### Examples
+
+```javascript
+btc.createTransaction({
+inputs: [ [tx1, 1] ],
+associatedKeysets: ["0'/0/0"],
+outputScriptHex: "01905f0100000000001976a91472a5d75c8d2d0565b656a5232703b167d50d5a2b88ac"
+}).then(res => ...);
+```
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** the signed transaction ready to be broadcast
+
+#### signP2SHTransaction
+
+To obtain the signature of multisignature (P2SH) inputs, call signP2SHTransaction_async with the folowing parameters
+
+##### Parameters
+
+*   `arg` **[SignP2SHTransactionArg](#signp2shtransactionarg)** 
+*   `inputs`  is an array of \[ transaction, output_index, redeem script, optional sequence ] where*   transaction is the previously computed transaction object for this UTXO
+    *   output_index is the output in the transaction used as input for this UTXO (counting from 0)
+    *   redeem script is the mandatory redeem script associated to the current P2SH input
+    *   sequence is the sequence number to use for this input (when using RBF), or non present
+*   `associatedKeysets`  is an array of BIP 32 paths pointing to the path to the private key used for each UTXO
+*   `outputScriptHex`  is the hexadecimal serialized outputs of the transaction to sign
+*   `lockTime`  is the optional lockTime of the transaction to sign, or default (0)
+*   `sigHashType`  is the hash type of the transaction to sign, or default (all)
+
+##### Examples
+
+```javascript
+btc.signP2SHTransaction({
+inputs: [ [tx, 1, "52210289b4a3ad52a919abd2bdd6920d8a6879b1e788c38aa76f0440a6f32a9f1996d02103a3393b1439d1693b063482c04bd40142db97bdf139eedd1b51ffb7070a37eac321030b9a409a1e476b0d5d17b804fcdb81cf30f9b99c6f3ae1178206e08bc500639853ae"] ],
+associatedKeysets: ["0'/0/0"],
+outputScriptHex: "01905f0100000000001976a91472a5d75c8d2d0565b656a5232703b167d50d5a2b88ac"
+}).then(result => ...);
+```
+
+Returns **[Promise](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>>** the signed transaction ready to be broadcast
+
 ### CreateTransactionArg
 
-Type: {inputs: [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;\[[Transaction](#transaction), [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), ([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined)), ([number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))]>, associatedKeysets: [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>, changePath: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?, outputScriptHex: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), lockTime: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?, sigHashType: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?, segwit: [boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?, initialTimestamp: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?, additionals: [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>, expiryHeight: [Buffer](https://nodejs.org/api/buffer.html)?, useTrustedInputForSegwit: [boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?, onDeviceStreaming: function (arg0: {progress: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), total: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), index: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)}): void?, onDeviceSignatureRequested: function (): void?, onDeviceSignatureGranted: function (): void?}
+Type: {inputs: [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<\[[Transaction](#transaction), [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), ([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined)), ([number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))]>, associatedKeysets: [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>, changePath: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?, outputScriptHex: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), lockTime: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?, sigHashType: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?, segwit: [boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?, initialTimestamp: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?, additionals: [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>, expiryHeight: [Buffer](https://nodejs.org/api/buffer.html)?, useTrustedInputForSegwit: [boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?, onDeviceStreaming: function (arg0: {progress: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), total: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), index: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)}): void?, onDeviceSignatureRequested: function (): void?, onDeviceSignatureGranted: function (): void?}
 
 #### Properties
 
--   `inputs` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;\[[Transaction](#transaction), [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), ([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined)), ([number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))]>** 
--   `associatedKeysets` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** 
--   `changePath` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** 
--   `outputScriptHex` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** 
--   `lockTime` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?** 
--   `sigHashType` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?** 
--   `segwit` **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?** 
--   `initialTimestamp` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?** 
--   `additionals` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** 
--   `expiryHeight` **[Buffer](https://nodejs.org/api/buffer.html)?** 
--   `useTrustedInputForSegwit` **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?** 
--   `onDeviceStreaming` **function (arg0: {progress: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), total: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), index: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)}): void?** 
--   `onDeviceSignatureRequested` **function (): void?** 
--   `onDeviceSignatureGranted` **function (): void?** 
+*   `inputs` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<\[[Transaction](#transaction), [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), ([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined)), ([number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))]>** 
+*   `associatedKeysets` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** 
+*   `changePath` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)?** 
+*   `outputScriptHex` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** 
+*   `lockTime` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?** 
+*   `sigHashType` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?** 
+*   `segwit` **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?** 
+*   `initialTimestamp` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?** 
+*   `additionals` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** 
+*   `expiryHeight` **[Buffer](https://nodejs.org/api/buffer.html)?** 
+*   `useTrustedInputForSegwit` **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?** 
+*   `onDeviceStreaming` **function (arg0: {progress: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), total: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), index: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)}): void?** 
+*   `onDeviceSignatureRequested` **function (): void?** 
+*   `onDeviceSignatureGranted` **function (): void?** 
 
 ### AddressFormat
 
 address format is one of legacy | p2sh | bech32 | cashaddr
 
-Type: (`"legacy"` \| `"p2sh"` \| `"bech32"` \| `"cashaddr"`)
+Type: (`"legacy"` | `"p2sh"` | `"bech32"` | `"bech32m"` | `"cashaddr"`)
+
+### AccountType
+
+Encapsulates differences between account types, for example p2wpkh,
+p2wpkhWrapped, p2tr.
+
+#### spendingCondition
+
+Generates a scriptPubKey (output script) from a list of public keys. If a
+p2sh redeemScript or a p2wsh witnessScript is needed it will also be set on
+the returned SpendingCondition.
+
+The pubkeys are expected to be 33 byte ecdsa compressed pubkeys.
+
+##### Parameters
+
+*   `pubkeys` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Buffer](https://nodejs.org/api/buffer.html)>** 
+
+Returns **SpendingCondition** 
+
+#### setInput
+
+Populates the psbt with account type-specific data for an input.
+
+##### Parameters
+
+*   `i` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** The index of the input map to populate
+*   `inputTx` **([Buffer](https://nodejs.org/api/buffer.html) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))** The full transaction containing the spent output. This may
+    be omitted for taproot.
+*   `spentOutput` **SpentOutput** The amount and spending condition of the spent output
+*   `pubkeys` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Buffer](https://nodejs.org/api/buffer.html)>** The 33 byte ecdsa compressed public keys involved in the input
+*   `pathElems` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)>>** The paths corresponding to the pubkeys, in same order.
+
+Returns **void** 
+
+#### setOwnOutput
+
+Populates the psbt with account type-specific data for an output. This is typically
+done for change outputs and other outputs that goes to the same account as
+being spent from.
+
+##### Parameters
+
+*   `i` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** The index of the output map to populate
+*   `cond` **SpendingCondition** The spending condition for this output
+*   `pubkeys` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Buffer](https://nodejs.org/api/buffer.html)>** The 33 byte ecdsa compressed public keys involved in this output
+*   `paths` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)>>** The paths corresponding to the pubkeys, in same order.
+
+Returns **void** 
+
+#### getDescriptorTemplate
+
+Returns the descriptor template for this account type. Currently only
+DefaultDescriptorTemplates are allowed, but that might be changed in the
+future. See class WalletPolicy for more information on descriptor
+templates.
+
+Returns **DefaultDescriptorTemplate** 
+
+### SingleKeyAccount
+
+**Extends BaseAccount**
+
+Superclass for single signature accounts. This will make sure that the pubkey
+arrays and path arrays in the method arguments contains exactly one element
+and calls an abstract method to do the actual work.
+
+### getTaprootOutputKey
+
+Calculates a taproot output key from an internal key. This output key will be
+used as witness program in a taproot output. The internal key is tweaked
+according to recommendation in BIP341:
+<https://github.com/bitcoin/bips/blob/master/bip-0341.mediawiki#cite_ref-22-0>
+
+#### Parameters
+
+*   `internalPubkey` **[Buffer](https://nodejs.org/api/buffer.html)** A 32 byte x-only taproot internal key
+
+Returns **[Buffer](https://nodejs.org/api/buffer.html)** The output key
+
+### AppClient
+
+This class encapsulates the APDU protocol documented at
+<https://github.com/LedgerHQ/app-bitcoin-new/blob/master/doc/bitcoin.md>
+
+#### Parameters
+
+*   `transport` **Transport** 
+
+### ClientCommandInterpreter
+
+This class will dispatch a client command coming from the hardware device to
+the appropriate client command implementation. Those client commands
+typically requests data from a merkle tree or merkelized maps.
+
+A ClientCommandInterpreter is prepared by adding the merkle trees and
+merkelized maps it should be able to serve to the hardware device. This class
+doesn't know anything about the semantics of the data it holds, it just
+serves merkle data. It doesn't even know in what context it is being
+executed, ie SignPsbt, getWalletAddress, etc.
+
+If the command yelds results to the client, as signPsbt does, the yielded
+data will be accessible after the command completed by calling getYielded(),
+which will return the yields in the same order as they came in.
+
+#### Parameters
+
+*   `progressCallback` **function (): void** 
+
+### MerkelizedPsbt
+
+**Extends PsbtV2**
+
+This class merkelizes a PSBTv2, by merkelizing the different
+maps of the psbt. This is used during the transaction signing process,
+where the hardware app can request specific parts of the psbt from the
+client code and be sure that the response data actually belong to the psbt.
+The reason for this is the limited amount of memory available to the app,
+so it can't always store the full psbt in memory.
+
+The signing process is documented at
+<https://github.com/LedgerHQ/app-bitcoin-new/blob/master/doc/bitcoin.md#sign_psbt>
+
+#### Parameters
+
+*   `psbt` **[PsbtV2](#psbtv2)** 
+
+### Merkle
+
+This class implements the merkle tree used by Ledger Bitcoin app v2+,
+which is documented at
+<https://github.com/LedgerHQ/app-bitcoin-new/blob/master/doc/merkle.md>
+
+#### Parameters
+
+*   `leaves` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Buffer](https://nodejs.org/api/buffer.html)>** 
+*   `hasher` **function (buf: [Buffer](https://nodejs.org/api/buffer.html)): [Buffer](https://nodejs.org/api/buffer.html)**  (optional, default `crypto.sha256`)
+
+### MerkleMap
+
+This implements "Merkelized Maps", documented at
+<https://github.com/LedgerHQ/app-bitcoin-new/blob/master/doc/merkle.md#merkleized-maps>
+
+A merkelized map consist of two merkle trees, one for the keys of
+a map and one for the values of the same map, thus the two merkle
+trees have the same shape. The commitment is the number elements
+in the map followed by the keys' merkle root followed by the
+values' merkle root.
+
+#### Parameters
+
+*   `keys` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Buffer](https://nodejs.org/api/buffer.html)>** Sorted list of (unhashed) keys
+*   `values` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[Buffer](https://nodejs.org/api/buffer.html)>** values, in corresponding order as the keys, and of equal length
+
+### WalletPolicy
+
+The Bitcon hardware app uses a descriptors-like thing to describe
+how to construct output scripts from keys. A "Wallet Policy" consists
+of a "Descriptor Template" and a list of "keys". A key is basically
+a serialized BIP32 extended public key with some added derivation path
+information. This is documented at
+<https://github.com/LedgerHQ/app-bitcoin-new/blob/master/doc/wallet.md>
+
+#### Parameters
+
+*   `descriptorTemplate` **DefaultDescriptorTemplate** 
+*   `key` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** 
+
+### extract
+
+This implements the "Transaction Extractor" role of BIP370 (PSBTv2
+<https://github.com/bitcoin/bips/blob/master/bip-0370.mediawiki#transaction-extractor>). However
+the role is partially documented in BIP174 (PSBTv0
+<https://github.com/bitcoin/bips/blob/master/bip-0174.mediawiki#transaction-extractor>).
+
+#### Parameters
+
+*   `psbt` **[PsbtV2](#psbtv2)** 
+
+Returns **[Buffer](https://nodejs.org/api/buffer.html)** 
+
+### finalize
+
+This roughly implements the "input finalizer" role of BIP370 (PSBTv2
+<https://github.com/bitcoin/bips/blob/master/bip-0370.mediawiki>). However
+the role is documented in BIP174 (PSBTv0
+<https://github.com/bitcoin/bips/blob/master/bip-0174.mediawiki>).
+
+Verify that all inputs have a signature, and set inputFinalScriptwitness
+and/or inputFinalScriptSig depending on the type of the spent outputs. Clean
+fields that aren't useful anymore, partial signatures, redeem script and
+derivation paths.
+
+#### Parameters
+
+*   `psbt` **[PsbtV2](#psbtv2)** The psbt with all signatures added as partial sigs, either
+    through PSBT_IN_PARTIAL_SIG or PSBT_IN_TAP_KEY_SIG
+
+Returns **void** 
+
+### clearFinalizedInput
+
+Deletes fields that are no longer neccesary from the psbt.
+
+Note, the spec doesn't say anything about removing ouput fields
+like PSBT_OUT_BIP32\_DERIVATION_PATH and others, so we keep them
+without actually knowing why. I think we should remove them too.
+
+#### Parameters
+
+*   `psbt` **[PsbtV2](#psbtv2)** 
+*   `inputIndex` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)** 
+
+### writePush
+
+Writes a script push operation to buf, which looks different
+depending on the size of the data. See
+<https://en.bitcoin.it/wiki/Script#Constants>
+
+#### Parameters
+
+*   `buf` **BufferWriter** the BufferWriter to write to
+*   `data` **[Buffer](https://nodejs.org/api/buffer.html)** the Buffer to be pushed.
+
+### PsbtV2
+
+Implements Partially Signed Bitcoin Transaction version 2, BIP370, as
+documented at <https://github.com/bitcoin/bips/blob/master/bip-0370.mediawiki>
+and <https://github.com/bitcoin/bips/blob/master/bip-0174.mediawiki>
+
+A psbt is a data structure that can carry all relevant information about a
+transaction through all stages of the signing process. From constructing an
+unsigned transaction to extracting the final serialized transaction ready for
+broadcast.
+
+This implementation is limited to what's needed in ledgerjs to carry out its
+duties, which means that support for features like multisig or taproot script
+path spending are not implemented. Specifically, it supports p2pkh,
+p2wpkhWrappedInP2sh, p2wpkh and p2tr key path spending.
+
+This class is made purposefully dumb, so it's easy to add support for
+complemantary fields as needed in the future.
 
 ### serializeTransactionOutputs
 
 #### Parameters
 
--   `$0` **[Transaction](#transaction)** 
-    -   `$0.outputs`  
+*   `$0` **[Transaction](#transaction)** 
+
+    *   `$0.outputs`  
 
 #### Examples
 
@@ -254,17 +807,17 @@ Returns **[Buffer](https://nodejs.org/api/buffer.html)**
 
 ### SignP2SHTransactionArg
 
-Type: {inputs: [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;\[[Transaction](#transaction), [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), ([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined)), ([number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))]>, associatedKeysets: [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>, outputScriptHex: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), lockTime: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?, sigHashType: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?, segwit: [boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?, transactionVersion: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?}
+Type: {inputs: [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<\[[Transaction](#transaction), [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), ([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined)), ([number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))]>, associatedKeysets: [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>, outputScriptHex: [string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), lockTime: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?, sigHashType: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?, segwit: [boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?, transactionVersion: [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?}
 
 #### Properties
 
--   `inputs` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;\[[Transaction](#transaction), [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), ([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined)), ([number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))]>** 
--   `associatedKeysets` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)&lt;[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** 
--   `outputScriptHex` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** 
--   `lockTime` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?** 
--   `sigHashType` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?** 
--   `segwit` **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?** 
--   `transactionVersion` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?** 
+*   `inputs` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<\[[Transaction](#transaction), [number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number), ([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined)), ([number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number) | null | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))]>** 
+*   `associatedKeysets` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** 
+*   `outputScriptHex` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** 
+*   `lockTime` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?** 
+*   `sigHashType` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?** 
+*   `segwit` **[boolean](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean)?** 
+*   `transactionVersion` **[number](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number)?** 
 
 ### TransactionInput