@avalabs/core-wallets-sdk 2.8.0-alpha.197

package/esm/BitcoinVM/models.d.ts

@@ -0,0 +1,77 @@
+import { Transaction } from '@ledgerhq/hw-app-btc/lib/types';
+
+/**
+ * Custom Bitcoin UTXO interface.
+ */
+interface BitcoinInputUTXO {
+    txHash: string;
+    txHex?: string;
+    index: number;
+    value: number;
+    script: string;
+    blockHeight: number;
+    confirmations: number;
+    confirmedTime?: string;
+}
+interface BitcoinInputUTXOWithOptionalScript extends Omit<BitcoinInputUTXO, 'script'> {
+    script?: string;
+}
+/**
+ * Used for defining outputs when creating a transaction.
+ */
+interface BitcoinOutputUTXO {
+    address: string;
+    value: number;
+}
+/**
+ * Ledger needs UTXOs organized like this when signing.
+ */
+type BitcoinLedgerInputUTXO = [
+    tx: Transaction,
+    outputIndex: number,
+    script: string | null | undefined,
+    sequence: number | null | undefined
+];
+/**
+ * An interface to simplify historic BTC transactions.
+ */
+interface BitcoinHistoryTx {
+    hash: string;
+    isSender: boolean;
+    addresses: string[];
+    fee: number;
+    block: number;
+    amount: number;
+    confirmations: number;
+    containsMultisig: boolean;
+    receivedTime: number;
+    confirmedTime?: number;
+}
+interface BitcoinTx {
+    hash: string;
+    fees: number;
+    block: number;
+    amount: number;
+    confirmations: number;
+    blockTime: number;
+    addresses: string[];
+    inputs: {
+        txid: string;
+        vout: number;
+        sequence: number;
+        n: number;
+        addresses: string[];
+        isAddress: boolean;
+        value: number;
+    }[];
+    outputs: {
+        addresses: string[];
+        value: number;
+        n: number;
+        spent: boolean;
+        hex: string;
+        isAddress: boolean;
+    }[];
+}
+
+export { BitcoinHistoryTx, BitcoinInputUTXO, BitcoinInputUTXOWithOptionalScript, BitcoinLedgerInputUTXO, BitcoinOutputUTXO, BitcoinTx };

package/esm/BitcoinVM/providers/BitcoinProvider.d.ts

@@ -0,0 +1,42 @@
+import { BitcoinProviderAbstract } from './BitcoinProviderAbstract.js';
+import { Network } from 'bitcoinjs-lib';
+import { BitcoinInputUTXOWithOptionalScript, BitcoinInputUTXO, BitcoinTx, BitcoinHistoryTx } from '../models.js';
+
+declare class BitcoinProvider extends BitcoinProviderAbstract {
+    #private;
+    private readonly isMainnet;
+    private readonly extraParams?;
+    constructor(isMainnet?: boolean, apiKey?: string, explorerUrl?: string, nodeUrl?: string, extraParams?: Record<string, string> | undefined);
+    getTxHex(txHash: string): Promise<string>;
+    getUTXOs(address: string, withScripts?: boolean): Promise<{
+        confirmed: BitcoinInputUTXOWithOptionalScript[];
+        unconfirmed: BitcoinInputUTXOWithOptionalScript[];
+    }>;
+    getScriptsForUtxos(utxos: BitcoinInputUTXOWithOptionalScript[]): Promise<BitcoinInputUTXO[]>;
+    private _parseUtxo;
+    getBalances(address: string): Promise<{
+        available: bigint;
+        pending: bigint;
+        final: bigint;
+    }>;
+    getChainHeight(): Promise<number>;
+    getFeeRates(): Promise<{
+        low: number;
+        medium: number;
+        high: number;
+    }>;
+    getNetwork(): Network;
+    issueRawTx(tx: string): Promise<string>;
+    getTransaction(hash: string): Promise<BitcoinTx>;
+    /**
+     * Returns the last 25 transactions
+     */
+    getTxHistory(address: string): Promise<BitcoinHistoryTx[]>;
+    waitForTx(txHash: string, { maxAttempts, attempt, pollInterval, }?: {
+        maxAttempts?: number;
+        attempt?: number;
+        pollInterval?: number;
+    }): Promise<BitcoinTx>;
+}
+
+export { BitcoinProvider };

package/esm/BitcoinVM/providers/BitcoinProvider.js

@@ -0,0 +1 @@
+import{BitcoinProviderAbstract as t}from"./BitcoinProviderAbstract.js";import{networks as e}from"bitcoinjs-lib";import{HttpClient as a}from"@avalabs/core-utils-sdk";import{URL_EXPLORER_MAINNET as s,URL_EXPLORER_TESTNET as r,URL_NODE_MAINNET as i,URL_NODE_TESTNET as n}from"./models.js";import{parseAddressFullTx as o}from"./utils/parseAddressFullTx.js";class l extends t{constructor(t=!0,e,o,l,m){super(),this.isMainnet=t,this.extraParams=m;const c=e?{headers:{"api-key":e}}:{},p=t?s:r;this.#t=new a(o||p,c);const u=t?i:n;this.#e=new a(l||u,c)}#t;#e;async#a(t){return this.isMainnet?(await Promise.all(t.map((t=>this.#e.post("",t,{},this.extraParams))))).flat():this.#e.post("",t,{},this.extraParams)}async getTxHex(t){return(await this.#t.post(`/api/v2/tx/${t}`,{},{},this.extraParams)).hex}async getUTXOs(t,e=!0){const a=await this.#t.post(`/api/v2/utxo/${t}`,{},{},this.extraParams);if(!a?.length)return{confirmed:[],unconfirmed:[]};const s=a.map(this._parseUtxo),r=t=>({confirmed:t.filter((t=>t.confirmations>0)),unconfirmed:t.filter((t=>0===t.confirmations))});if(!e)return r(s);return r(await this.getScriptsForUtxos(s))}async getScriptsForUtxos(t){const[e,a]=t.reduce((([t,e],a)=>a.script?[[...t,a],e]:[t,[...e,a]]),[[],[]]),s=a.map(((t,e)=>({jsonrpc:"2.0",method:"gettxout",params:[t.txHash,t.index],id:`${e}`}))),r=s.length?(await this.#a(s)).sort(((t,e)=>Number(t.id)-Number(e.id))):[];return[...e,...a.map(((t,e)=>({...t,script:r[e]?.result?.scriptPubKey.hex})))]}_parseUtxo(t){return{...t,txHash:t.txid,index:t.vout,value:Number(t.value),blockHeight:t.height,script:t.script,confirmations:t.confirmations}}async getBalances(t){const e=await this.#t.post(`/api/v2/address/${t}`,{},{},this.extraParams);return{available:BigInt(e.balance),pending:BigInt(e.unconfirmedBalance),final:BigInt(e.balance)+BigInt(e.unconfirmedBalance)}}async getChainHeight(){return(await this.#e.post("",{jsonrpc:"2.0",id:"nownodes",method:"getblockcount",params:[]},{},this.extraParams)).result}async getFeeRates(){const t={jsonrpc:"2.0",method:"estimatesmartfee"},e=await this.#a([{...t,id:"1",params:[1]},{...t,id:"2",params:[3]},{...t,id:"3",params:[7]}]).then((t=>t.sort(((t,e)=>Number(t.id)-Number(e.id))).map((t=>1e8*(t.result?.feerate??0)))));return{high:Math.round(e[0]/1024)||1,medium:Math.round(e[1]/1024)||1,low:Math.floor(e[2]/1024)||1}}getNetwork(){return this.isMainnet?e.bitcoin:e.testnet}async issueRawTx(t){return await this.#e.post("",{jsonrpc:"2.0",id:"nownodes",method:"sendrawtransaction",params:[t]},{},this.extraParams).then((t=>t.result))}async getTransaction(t){const e=await this.#t.post(`/api/v2/tx/${t}`,{},{},this.extraParams);return{block:e.blockHeight,fees:Number(e.fees),confirmations:e.confirmations,amount:Number(e.value),hash:e.txid,addresses:Array.from(new Set([...e.vin.map((t=>t.addresses||[])).flat(),...e.vout.map((t=>t.addresses||[])).flat()])),blockTime:e.blockTime,inputs:[...e.vin.map((t=>({...t,value:Number(t.value)})))],outputs:[...e.vout.map((t=>({...t,value:Number(t.value)})))]}}async getTxHistory(t){const e=await this.#t.post(`/api/v2/address/${t}`,{},{},this.extraParams);return await Promise.allSettled(e.txids?.slice(0,25).map((async e=>{try{const a=await this.#t.post(`/api/v2/tx/${e}`,{},{},this.extraParams);return o(t,a)}catch(t){console.log(`Unable to parse full tx ${e}.`)}}))).then((t=>t.map((t=>"fulfilled"===t.status&&t.value?t.value:void 0)).filter((t=>void 0!==t))))}async waitForTx(t,{maxAttempts:e=20,attempt:a=1,pollInterval:s=500}={}){try{return await this.getTransaction(t)}catch(r){if(a>=e)throw r;return await new Promise((t=>setTimeout(t,s))),this.waitForTx(t,{maxAttempts:e,attempt:a+1,pollInterval:s})}}}export{l as BitcoinProvider};

package/esm/BitcoinVM/providers/BitcoinProviderAbstract.d.ts

@@ -0,0 +1,63 @@
+import { Network } from 'bitcoinjs-lib';
+import { BitcoinInputUTXOWithOptionalScript, BitcoinTx } from '../models.js';
+
+declare abstract class BitcoinProviderAbstract {
+    /**
+     * Returns the UTXOs owned by the given address.
+     * @param address
+     */
+    abstract getUTXOs(address: string, withScripts: boolean): Promise<{
+        confirmed: BitcoinInputUTXOWithOptionalScript[];
+        unconfirmed: BitcoinInputUTXOWithOptionalScript[];
+    }>;
+    /**
+     * Returns the connected network.
+     */
+    abstract getNetwork(): Network;
+    /**
+     * Get the current chain height.
+     */
+    abstract getChainHeight(): Promise<number>;
+    /**
+     * Returns the available balance for the user in satoshis.
+     */
+    abstract getBalances(address: string): Promise<{
+        available: bigint;
+        pending: bigint;
+        final: bigint;
+    }>;
+    /**
+     * Returns available (confirmed) UTXOs and their total balance for the given address.
+     * @address Address to get UTXOs of.
+     */
+    getUtxoBalance(address: string, withScripts?: boolean): Promise<{
+        balance: number;
+        balanceUnconfirmed: number;
+        utxos: BitcoinInputUTXOWithOptionalScript[];
+        utxosUnconfirmed: BitcoinInputUTXOWithOptionalScript[];
+    }>;
+    /**
+     * Given a transaction hash, return the base information of the transaction
+     */
+    abstract getTransaction(hash: string): Promise<BitcoinTx>;
+    /**
+     * Given a transaction hash, return the whole transaction in hex format.
+     * @param txHash
+     */
+    abstract getTxHex(txHash: string): Promise<string>;
+    /**
+     * Issues the given transaction to the bitcoin network
+     * @param tx
+     */
+    abstract issueRawTx(tx: string): Promise<string>;
+    /**
+     * Returns the suggested fee rate in satoshis per byte.
+     */
+    abstract getFeeRates(): Promise<{
+        high: number;
+        medium: number;
+        low: number;
+    }>;
+}
+
+export { BitcoinProviderAbstract };

package/esm/BitcoinVM/providers/BitcoinProviderAbstract.js

@@ -0,0 +1 @@
+import{sumUTXOs as n}from"../utils/sumUTXOs.js";class e{async getUtxoBalance(e,o=!0){const c=await this.getUTXOs(e,o);return{balance:n(c.confirmed),balanceUnconfirmed:n(c.unconfirmed),utxos:c.confirmed,utxosUnconfirmed:c.unconfirmed}}}export{e as BitcoinProviderAbstract};

package/esm/BitcoinVM/providers/models.js

@@ -0,0 +1 @@
+const t="https://btc.nownodes.io",o="https://btcbook.nownodes.io",n="https://btc-testnet.nownodes.io",s="https://btcbook-testnet.nownodes.io";export{o as URL_EXPLORER_MAINNET,s as URL_EXPLORER_TESTNET,t as URL_NODE_MAINNET,n as URL_NODE_TESTNET};

package/esm/BitcoinVM/providers/utils/parseAddressFullTx.js

@@ -0,0 +1 @@
+function e(e,s){const i=s.vin.filter((s=>s.addresses?.includes(e))),n=s.vout.filter((s=>s.addresses?.includes(e))),t=s.vin.filter((s=>!s.addresses?.includes(e))),d=s.vout.filter((s=>!s.addresses?.includes(e))),r=i.reduce(((e,s)=>e+BigInt(s.value)),0n),l=n.reduce(((e,s)=>e+BigInt(s.value)),0n),a=r>l;let o=l-r;a&&(o+=BigInt(s.fees));const c=t.map((e=>e.addresses||[])).flat(),f=d.map((e=>e.addresses||[])).flat(),u=a?f:c,m=u.filter(((e,s)=>u.indexOf(e)===s)),v=n.filter((e=>(e.addresses?.length||0)>1)).length>0;return{addresses:m,isSender:a,block:s.blockHeight,fee:Number(s.fees),confirmations:s.confirmations,amount:Number(o),hash:s.txid,containsMultisig:v,receivedTime:s.blockTime,confirmedTime:s.confirmations>0?s.blockTime:void 0}}export{e as parseAddressFullTx};

package/esm/BitcoinVM/utils/addEncodedSigToPsbt.d.ts

@@ -0,0 +1,5 @@
+import { Psbt } from 'bitcoinjs-lib';
+
+declare function addEncodedSigToPsbt(sig: Buffer, pubkey: Buffer, psbt: Psbt, index: number): void;
+
+export { addEncodedSigToPsbt };

package/esm/BitcoinVM/utils/addEncodedSigToPsbt.js

@@ -0,0 +1 @@
+function t(t,n,p,u){const a=[{pubkey:n,signature:t}];p.updateInput(u,{partialSig:a})}export{t as addEncodedSigToPsbt};

package/esm/BitcoinVM/utils/createPSBTV2.d.ts

@@ -0,0 +1,10 @@
+import { BitcoinInputUTXO, BitcoinOutputUTXO } from '../models.js';
+import { Network } from 'bitcoinjs-lib';
+import { PsbtV2 } from 'ledger-bitcoin';
+
+/**
+ * Used with the new BTC Ledger app.
+ */
+declare function createPSBTV2(ins: BitcoinInputUTXO[], outs: BitcoinOutputUTXO[], network: Network, masterFingerprint: Buffer, signerPubkey: Buffer, signerPath: string): PsbtV2;
+
+export { createPSBTV2 };

package/esm/BitcoinVM/utils/createPSBTV2.js

@@ -0,0 +1 @@
+import{address as t}from"bitcoinjs-lib";import{PsbtV2 as e}from"ledger-bitcoin";import{pathStringToArray as o}from"@ledgerhq/hw-app-btc/lib/bip32";function r(r,n,s,u,i,p){const x=new e;return x.setGlobalPsbtVersion(2),x.setGlobalTxVersion(2),x.setGlobalInputCount(r.length),x.setGlobalOutputCount(n.length),r.forEach(((t,e)=>{if(!t.txHex)throw new Error("Input tx hex is not given");x.setInputPreviousTxId(e,Buffer.from(t.txHash,"hex").reverse()),x.setInputOutputIndex(e,t.index),x.setInputNonWitnessUtxo(e,Buffer.from(t.txHex,"hex")),x.setInputWitnessUtxo(e,t.value,Buffer.from(t.script,"hex")),x.setInputBip32Derivation(e,i,u,o(p))})),n.forEach(((e,o)=>{const r=t.toOutputScript(e.address,s);x.setOutputAmount(o,e.value),x.setOutputScript(o,r)})),x}export{r as createPSBTV2};

package/esm/BitcoinVM/utils/createPsbt.d.ts

@@ -0,0 +1,12 @@
+import { Network, Psbt } from 'bitcoinjs-lib';
+import { BitcoinInputUTXO, BitcoinOutputUTXO } from '../models.js';
+
+/**
+ * Create an unsigned transaction.
+ * @param inputs The input UTXOs for the transaction.
+ * @param outputs The output UTXOs for the transaction.
+ * @param provider The provider for the tx network.
+ */
+declare function createPsbt(inputs: BitcoinInputUTXO[], outputs: BitcoinOutputUTXO[], network: Network): Psbt;
+
+export { createPsbt };

package/esm/BitcoinVM/utils/createPsbt.js

@@ -0,0 +1 @@
+import{Psbt as e}from"bitcoinjs-lib";function t(t,r,a){const s=new e({network:a});return t.forEach((e=>{s.addInput({hash:e.txHash,index:e.index,witnessUtxo:{script:Buffer.from(e.script,"hex"),value:e.value}})})),r.forEach((e=>{s.addOutput({value:e.value,address:e.address})})),s}export{t as createPsbt};

package/esm/BitcoinVM/utils/createTransferTx.d.ts

@@ -0,0 +1,20 @@
+import { BitcoinInputUTXO, BitcoinOutputUTXO } from '../models.js';
+import { Network, Psbt } from 'bitcoinjs-lib';
+
+/**
+ * Create an unsigned bitcoin transfer transaction.
+ * @param to Destination address.
+ * @param changeAddress Change address.
+ * @param amount Amount to send.
+ * @param feeRate Satoshis per byte.
+ * @param sourceUtxos UTXOs to construct the transaction from.
+ * @param network The network the transaction will be on.
+ */
+declare function createTransferTx(to: string, changeAddress: string, amount: number, feeRate: number, sourceUtxos: BitcoinInputUTXO[], network: Network): {
+    fee: number;
+    inputs?: BitcoinInputUTXO[];
+    outputs?: BitcoinOutputUTXO[];
+    psbt?: Psbt;
+};
+
+export { createTransferTx };

package/esm/BitcoinVM/utils/createTransferTx.js

@@ -0,0 +1 @@
+import{createPsbt as t}from"./createPsbt.js";import{selectUtxos as e}from"./selectUtxos.js";import{filterDuplicateUTXOs as o}from"./filterDuplicateUTXOs.js";function s(s,r,n,c,i,p){const u=o(i),f=e(s,r,n,c,u);return f.inputs?{...f,psbt:t(f.inputs,f.outputs,p)}:(console.log("Unable to construct transaction, fee needed: ",f.fee),f)}export{s as createTransferTx};

package/esm/BitcoinVM/utils/createWalletPolicy.d.ts

@@ -0,0 +1,5 @@
+import { WalletPolicy } from 'ledger-bitcoin';
+
+declare function createWalletPolicy(masterFingerprint: string, accountIndex: number, accountXPUB: string, policyName: string): WalletPolicy;
+
+export { createWalletPolicy };

package/esm/BitcoinVM/utils/createWalletPolicy.js

@@ -0,0 +1 @@
+import{DefaultWalletPolicy as e,WalletPolicy as n}from"ledger-bitcoin";function o(o,r,t,i){const p=new e("wpkh(@0/**)",`[${o}/44'/60'/${r}']${t}`);return new n(i,"wpkh(@0/**)",p.keys)}export{o as createWalletPolicy};

package/esm/BitcoinVM/utils/filterDuplicateUTXOs.js

@@ -0,0 +1 @@
+function t(t){const n=[];return t.filter((t=>{const r=t.txHash+t.index.toString();return!n.includes(r)&&(n.push(r),!0)}))}export{t as filterDuplicateUTXOs};

package/esm/BitcoinVM/utils/formatAddressForNetworkBech32.d.ts

@@ -0,0 +1,10 @@
+import { Network } from 'bitcoinjs-lib';
+
+/**
+ * Format the given address for the given network
+ * @param address Bech32 address to format
+ * @param network Network the new bech32 address will belong to
+ */
+declare function formatAddressForNetworkBech32(address: string, network: Network): string;
+
+export { formatAddressForNetworkBech32 };

package/esm/BitcoinVM/utils/formatAddressForNetworkBech32.js

@@ -0,0 +1 @@
+import{address as o}from"bitcoinjs-lib";function t(t,r){const c=o.fromBech32(t);return o.toBech32(c.data,c.version,r.bech32)}export{t as formatAddressForNetworkBech32};

package/esm/BitcoinVM/utils/getBech32Address.d.ts

@@ -0,0 +1,10 @@
+import { Network } from 'bitcoinjs-lib';
+
+/**
+ * Return the bech32 address of a given public key.
+ * @param pubkey
+ * @param network
+ */
+declare function getBech32Address(pubkey: Buffer, network: Network): string;
+
+export { getBech32Address };

package/esm/BitcoinVM/utils/getBech32Address.js

@@ -0,0 +1 @@
+import{payments as r}from"bitcoinjs-lib";function o(o,t){return r.p2wpkh({pubkey:o,network:t}).address}export{o as getBech32Address};

package/esm/BitcoinVM/utils/getBech32AddressFromXPub.d.ts

@@ -0,0 +1,11 @@
+import { Network } from 'bitcoinjs-lib';
+
+/**
+ * Return the Bech32 address of the given address index from an xpub.
+ * @param xpub The extended public key of `m/44'/60'/0'`
+ * @param accountIndex The target address index.
+ * @param network Which network should the address be on.
+ */
+declare function getBech32AddressFromXPub(xpub: string, accountIndex: number, network: Network): string;
+
+export { getBech32AddressFromXPub };

package/esm/BitcoinVM/utils/getBech32AddressFromXPub.js

@@ -0,0 +1 @@
+import"@ledgerhq/hw-app-eth";import"ethers";import"@avalabs/avalanchejs";import"hdkey";import"buffer";import"@openzeppelin/contracts/build/contracts/ERC20.json";import"bip32";import{getAddressPublicKeyFromXPub as t}from"../../EVM/utils/getAddressPublicKeyFromXPub.js";import"bip39";import{getBech32Address as r}from"./getBech32Address.js";import"@avalabs/core-utils-sdk";import"@ledgerhq/hw-transport";import"@metamask/eth-sig-util";function o(o,e,i){const p=t(o,e);return r(p,i)}export{o as getBech32AddressFromXPub};

package/esm/BitcoinVM/utils/getMaxTransferAmount.d.ts

@@ -0,0 +1,13 @@
+import { BitcoinInputUTXOWithOptionalScript } from '../models.js';
+
+/**
+ * Calculate the maximum amount that can be sent in satoshis using the given UTXO set and parameters.
+ * @param ins UTXOs that can be consumed.
+ * @param to Destination address.
+ * @param changeAddress Change address.
+ * @param feeRate Fee rate in satoshis per byte.
+ * @returns Maximum transferable amount in satoshis.
+ */
+declare function getMaxTransferAmount(ins: BitcoinInputUTXOWithOptionalScript[], to: string, changeAddress: string, feeRate: number): number;
+
+export { getMaxTransferAmount };

package/esm/BitcoinVM/utils/getMaxTransferAmount.js

@@ -0,0 +1 @@
+import{selectUtxos as t}from"./selectUtxos.js";import{sumUTXOs as o}from"./sumUTXOs.js";function r(r,s,e,n){const f=o(r);if(!f)return 0;const{fee:m}=t(s,e,f,n,r);return f-m}export{r as getMaxTransferAmount};

package/esm/BitcoinVM/utils/getTransferTxDetails.d.ts

@@ -0,0 +1,17 @@
+import { BitcoinInputUTXO, BitcoinInputUTXOWithOptionalScript, BitcoinOutputUTXO } from '../models.js';
+
+/**
+ * Create an unsigned bitcoin transfer transaction.
+ * @param to Destination address.
+ * @param changeAddress Change address.
+ * @param amount Amount to send.
+ * @param feeRate Satoshis per byte.
+ * @param sourceUtxos UTXOs to construct the transaction from.
+ */
+declare function getTransferTxDetails<InputUtxo extends BitcoinInputUTXO | BitcoinInputUTXOWithOptionalScript = BitcoinInputUTXO>(to: string, changeAddress: string, amount: number, feeRate: number, sourceUtxos: InputUtxo[]): {
+    fee: number;
+    inputs?: InputUtxo[];
+    outputs?: BitcoinOutputUTXO[];
+};
+
+export { getTransferTxDetails };

package/esm/BitcoinVM/utils/getTransferTxDetails.js

@@ -0,0 +1 @@
+import{selectUtxos as t}from"./selectUtxos.js";import{filterDuplicateUTXOs as e}from"./filterDuplicateUTXOs.js";function o(o,n,r,s,c){const i=e(c),f=t(o,n,r,s,i);return f.inputs||console.log("Unable to construct transaction, fee needed: ",f.fee),f}export{o as getTransferTxDetails};

package/esm/BitcoinVM/utils/psbt2ToPsbt0.d.ts

@@ -0,0 +1,15 @@
+import { PsbtV2 } from 'ledger-bitcoin';
+import { Network, Psbt } from 'bitcoinjs-lib';
+
+/**
+ * Convert the given PSBTV2 object to bitcoinjs PSBT object. This is not a full feature
+ * conversion and only focuses on P2WPKH input conversion, which are the input types supported by
+ * the core wallets.
+ * @param psbt2
+ * @param network
+ * @param signerPub
+ * @param signerPath
+ */
+declare function psbt2ToPsbt0(psbt2: PsbtV2, network: Network, signerPub: Buffer, signerPath: string): Psbt;
+
+export { psbt2ToPsbt0 };

package/esm/BitcoinVM/utils/psbt2ToPsbt0.js

@@ -0,0 +1 @@
+import{Psbt as t,address as n}from"bitcoinjs-lib";function e(e,u,i,o){const p=new t({network:u}),r=e.getGlobalInputCount(),s=e.getGlobalOutputCount();for(let t=0;t<r;t++){const n=e.getInputWitnessUtxo(t),u=e.getInputBip32Derivation(t,i);p.addInput({nonWitnessUtxo:e.getInputNonWitnessUtxo(t),witnessUtxo:n?{value:n.amount,script:n.scriptPubKey}:void 0,hash:e.getInputPreviousTxid(t),index:e.getInputOutputIndex(t),bip32Derivation:u?[{path:o,pubkey:i,masterFingerprint:u.masterFingerprint}]:void 0})}for(let t=0;t<s;t++)p.addOutput({value:e.getOutputAmount(t),address:n.fromOutputScript(e.getOutputScript(t),u)});return p}export{e as psbt2ToPsbt0};

package/esm/BitcoinVM/utils/selectUtxos.d.ts

@@ -0,0 +1,22 @@
+import { BitcoinInputUTXO, BitcoinInputUTXOWithOptionalScript, BitcoinOutputUTXO } from '../models.js';
+
+/**
+ * Uses coinselect to select the input and output utxos for the given information.
+ * Returns undefined if the transaction can not be completed.
+ * @param to Destination address.
+ * @param changeAddress Change address.
+ * @param amount Amount to send in satoshis.
+ * @param feeRate Satoshis per byte.
+ * @param sourceUtxos UTXOs to pick from to construct the transaction.
+ */
+declare function selectUtxos<InputUtxo extends BitcoinInputUTXO | BitcoinInputUTXOWithOptionalScript = BitcoinInputUTXO>(to: string, changeAddress: string, amount: number, feeRate: number, sourceUtxos: InputUtxo[]): {
+    fee: any;
+    inputs?: undefined;
+    outputs?: undefined;
+} | {
+    inputs: InputUtxo[];
+    outputs: BitcoinOutputUTXO[];
+    fee: any;
+};
+
+export { selectUtxos };

package/esm/BitcoinVM/utils/selectUtxos.js

@@ -0,0 +1 @@
+import e from"coinselect";function t(t,u,s,n,o){const r=[{address:t,value:s}],{inputs:p,outputs:f,fee:i}=e(o,r,n);if(!p||!f)return{fee:i};const a=[f[0]],c=f[1];return c&&a.push({address:u,value:c.value}),{inputs:p,outputs:a,fee:i}}export{t as selectUtxos};

package/esm/BitcoinVM/utils/sumUTXOs.js

@@ -0,0 +1 @@
+function e(e){return e.reduce(((e,r)=>e+r.value),0)}export{e as sumUTXOs};

package/esm/BitcoinVM/wallets/BitcoinWallet.d.ts

@@ -0,0 +1,44 @@
+import * as bitcoinjs_lib from 'bitcoinjs-lib';
+import { ECPairInterface, Psbt } from 'bitcoinjs-lib';
+import { BitcoinProviderAbstract } from '../providers/BitcoinProviderAbstract.js';
+import { BitcoinWalletAbstract } from './BitcoinWalletAbstract.js';
+import { BitcoinInputUTXO, BitcoinOutputUTXO } from '../models.js';
+import { HDNodeWallet } from 'ethers';
+import { DerivationPath } from '../../EVM/constants.js';
+
+/**
+ * A wallet instance for the given private key. Can sign transactions.
+ */
+declare class BitcoinWallet extends BitcoinWalletAbstract {
+    keypair: ECPairInterface;
+    constructor(privKey: Buffer, provider: BitcoinProviderAbstract);
+    /**
+     *
+     * @param mnemonic The mnemonic phrase to derive the wallet from.
+     * @param accountIndex Used when deriving the private key from mnemonic. The path used is `m/44'/60'/0'/0/n` where `n` is the account index.
+     * @param provider
+     * @param derivationSpec Sets how account paths are generated. BIP44 (Default) or LedgerLive.
+     */
+    static fromMnemonic(mnemonic: string, accountIndex: number, provider: BitcoinProviderAbstract, derivationSpec?: DerivationPath): Promise<BitcoinWallet>;
+    /**
+     * Create a transaction from the given inputs and outputs, and sign it.
+     * @remarks Signs all inputs.
+     * @param ins Array of input UTXOs to consume
+     * @param outs Array of output UTXOs to create.
+     */
+    signTx(ins: BitcoinInputUTXO[], outs: BitcoinOutputUTXO[]): Promise<bitcoinjs_lib.Transaction>;
+    /**
+     * Create a bitcoin wallet using the private key of an Ethers wallet.
+     * @param wallet An Ethers wallet instance that has a private key.
+     * @param prov Bitcoin provider.
+     */
+    static fromEthersWallet(wallet: HDNodeWallet, prov: BitcoinProviderAbstract): BitcoinWallet;
+    /**
+     * Sings a given PSBT and returns the transaction.
+     * @remarks Signs all inputs.
+     * @param tx
+     */
+    signPsbt(tx: Psbt): bitcoinjs_lib.Transaction;
+}
+
+export { BitcoinWallet };

package/esm/BitcoinVM/wallets/BitcoinWallet.js

@@ -0,0 +1 @@
+import{ECPair as t}from"bitcoinjs-lib";import{BitcoinWalletAbstract as r}from"./BitcoinWalletAbstract.js";import{createPsbt as e}from"../utils/createPsbt.js";import"coinselect";import"@ledgerhq/hw-app-eth";import"ethers";import{getAddressDerivationPath as i}from"../../utils/getAddressDerivationPath.js";import"@avalabs/avalanchejs";import"hdkey";import"buffer";import{DerivationPath as o}from"../../EVM/constants.js";import"@openzeppelin/contracts/build/contracts/ERC20.json";import{fromSeed as s}from"bip32";import{validateMnemonic as n,mnemonicToSeed as a}from"bip39";import"@avalabs/core-utils-sdk";import"@ledgerhq/hw-transport";import"@metamask/eth-sig-util";import"ledger-bitcoin";import"@ledgerhq/hw-app-btc/lib/bip32";class p extends r{keypair;constructor(r,e){const i=t.fromPrivateKey(r);super(i.publicKey,e),this.keypair=i}static async fromMnemonic(t,r,e,m=o.BIP44){if(r<0)throw new Error("Account index must be >= 0");if(!n(t))throw new Error("Invalid mnemonic phrase.");const l=await a(t),c=s(l),h=i(r,m,"EVM"),f=c.derivePath(h);if(!f.privateKey)throw new Error("Unable to derive private key from the given mnemonic.");return new p(f.privateKey,e)}signTx(t,r){const i=e(t,r,this.provider.getNetwork());return Promise.resolve(this.signPsbt(i))}static fromEthersWallet(t,r){const e=t.privateKey;if(!e)throw new Error("Unable to get private key from ethers wallet.");const i=Buffer.from(e.substring(2),"hex");return new p(i,r)}signPsbt(t){return t.signAllInputs(this.keypair),t.validateSignaturesOfAllInputs(),t.finalizeAllInputs(),t.extractTransaction()}}export{p as BitcoinWallet};

package/esm/BitcoinVM/wallets/BitcoinWalletAbstract.d.ts

@@ -0,0 +1,72 @@
+import * as bitcoinjs_lib from 'bitcoinjs-lib';
+import { ECPairInterface, Transaction } from 'bitcoinjs-lib';
+import { BitcoinInputUTXO, BitcoinOutputUTXO, BitcoinInputUTXOWithOptionalScript } from '../models.js';
+import { BitcoinProviderAbstract } from '../providers/BitcoinProviderAbstract.js';
+
+declare abstract class BitcoinWalletAbstract {
+    protected pubkey: Buffer;
+    protected provider: BitcoinProviderAbstract;
+    ecPair: ECPairInterface;
+    abstract signTx(ins: BitcoinInputUTXO[], outs: BitcoinOutputUTXO[]): Promise<Transaction>;
+    /**
+     * Return legacy P2PKH address.
+     */
+    getAddressP2PKH(): string | undefined;
+    /**
+     * Get the Bech32 address.
+     * @link https://allprivatekeys.com/bitcoin-address-format
+     */
+    getAddressBech32(): string;
+    protected constructor(pubkey: Buffer, provider: BitcoinProviderAbstract);
+    /**
+     * Returns the UTXOs owned by this address
+     */
+    getUTXOs(): Promise<{
+        confirmed: BitcoinInputUTXOWithOptionalScript[];
+        unconfirmed: BitcoinInputUTXOWithOptionalScript[];
+    }>;
+    /**
+     * Returns the available balance in satoshis.
+     * @remarks Returned balances might not match the sum of available UTXOs if the wallet has pending transactions.
+     * Use `getUTXOBalance` to get the balance from available UTXOs.
+     */
+    getBalances(): Promise<{
+        available: bigint;
+        pending: bigint;
+        final: bigint;
+    }>;
+    /**
+     * Returns available UTXOs and their total balance.
+     */
+    getUtxoBalance(): Promise<{
+        balance: number;
+        balanceUnconfirmed: number;
+        utxos: BitcoinInputUTXOWithOptionalScript[];
+        utxosUnconfirmed: BitcoinInputUTXOWithOptionalScript[];
+    }>;
+    /**
+     * Connects the wallet to the given provider.
+     * @param provider
+     */
+    connect(provider: BitcoinProviderAbstract): void;
+    /**
+     * Returns the current connected provider.
+     */
+    getProvider(): BitcoinProviderAbstract;
+    getPublicKey(): Buffer;
+    /**
+     * Create an unsigned transaction. Change will be returned to this wallet.
+     * @param to
+     * @param amount
+     * @param feeRate
+     * @param sourceUTXOs
+     */
+    createTransferTx(to: string, amount: number, feeRate: number, sourceUTXOs: BitcoinInputUTXO[]): {
+        fee: number;
+        inputs?: BitcoinInputUTXO[] | undefined;
+        outputs?: BitcoinOutputUTXO[] | undefined;
+        psbt?: bitcoinjs_lib.Psbt | undefined;
+    };
+}
+
+export { BitcoinWalletAbstract };

package/esm/BitcoinVM/wallets/BitcoinWalletAbstract.js

@@ -0,0 +1 @@
+import{ECPair as e,payments as r}from"bitcoinjs-lib";import{createTransferTx as t}from"../utils/createTransferTx.js";import{getBech32Address as s}from"../utils/getBech32Address.js";class i{constructor(r,t){this.pubkey=r,this.provider=t;try{this.ecPair=e.fromPublicKey(r)}catch(e){throw new Error("Not a valid public key.")}}ecPair;getAddressP2PKH(){return r.p2pkh({pubkey:this.ecPair.publicKey,network:this.provider.getNetwork()}).address}getAddressBech32(){return s(this.ecPair.publicKey,this.provider.getNetwork())}async getUTXOs(){return this.provider.getUTXOs(this.getAddressBech32(),!0)}async getBalances(){return this.provider.getBalances(this.getAddressBech32())}async getUtxoBalance(){return this.provider.getUtxoBalance(this.getAddressBech32())}connect(e){this.provider=e}getProvider(){return this.provider}getPublicKey(){return this.ecPair.publicKey}createTransferTx(e,r,s,i){const c=this.getAddressBech32();return t(e,c,r,s,i,this.provider.getNetwork())}}export{i as BitcoinWalletAbstract};

package/esm/BitcoinVM/wallets/BitcoinWalletLedger.d.ts

@@ -0,0 +1,34 @@
+import * as bitcoinjs_lib from 'bitcoinjs-lib';
+import { BitcoinProviderAbstract } from '../providers/BitcoinProviderAbstract.js';
+import { BitcoinWalletAbstract } from './BitcoinWalletAbstract.js';
+import Transport from '@ledgerhq/hw-transport';
+import { BitcoinInputUTXO, BitcoinOutputUTXO } from '../models.js';
+import { WalletPolicyDetails } from './models.js';
+
+declare class BitcoinLedgerWallet extends BitcoinWalletAbstract {
+    private derivationPath;
+    protected transport: Transport;
+    private walletPolicyDetails;
+    /**
+     *
+     * @param publicKey Public key of the address
+     * @param derivationPath BIP44 derivation path of the publickey/address
+     * @param provider
+     * @param transport Ledger transport instance.
+     */
+    constructor(publicKey: Buffer, derivationPath: string, provider: BitcoinProviderAbstract, transport: Transport, walletPolicyDetails: WalletPolicyDetails);
+    /**
+     * Update the ledger transport used by this wallet.
+     * @param t
+     */
+    setTransport(t: Transport): void;
+    /**
+     * Creates a transaction with the given inputs & outputs and signs using the ledger.
+     * @param ins Input UTXOs for this transaction. Must be P2WPKH.
+     * @param outs Output UTXOs for this transaction.
+     * @param ledgerConfig
+     */
+    signTx(ins: BitcoinInputUTXO[], outs: BitcoinOutputUTXO[]): Promise<bitcoinjs_lib.Transaction>;
+}
+
+export { BitcoinLedgerWallet };

package/esm/BitcoinVM/wallets/BitcoinWalletLedger.js

@@ -0,0 +1 @@
+import{BitcoinWalletAbstract as t}from"./BitcoinWalletAbstract.js";import i from"ledger-bitcoin";import"bitcoinjs-lib";import"coinselect";import"@ledgerhq/hw-app-eth";import"ethers";import"@avalabs/avalanchejs";import"hdkey";import"buffer";import"@openzeppelin/contracts/build/contracts/ERC20.json";import"bip32";import"bip39";import"@avalabs/core-utils-sdk";import"@ledgerhq/hw-transport";import"@metamask/eth-sig-util";import{createPSBTV2 as r}from"../utils/createPSBTV2.js";import{psbt2ToPsbt0 as e}from"../utils/psbt2ToPsbt0.js";class s extends t{constructor(t,i,r,e,s){super(t,r),this.derivationPath=i,this.transport=e,this.walletPolicyDetails=s}setTransport(t){this.transport=t}async signTx(t,s){const a=function(t){return new i(t)}(this.transport),o=this.ecPair.publicKey,n=this.provider.getNetwork(),p=await a.getMasterFingerprint(),l=r(t,s,n,Buffer.from(p,"hex"),o,this.derivationPath),{policy:c,hmac:h}=this.walletPolicyDetails,m=await a.signPsbt(l,c,h),u=e(l,n,o,this.derivationPath);if(m.forEach((t=>{const[i,r]=t;u.updateInput(i,{partialSig:[{signature:r.signature,pubkey:r.pubkey}]})})),!u.validateSignaturesOfAllInputs())throw new Error("Failed to validate signatures");return u.finalizeAllInputs(),u.extractTransaction()}}export{s as BitcoinLedgerWallet};

package/esm/BitcoinVM/wallets/BitcoinWalletVoid.d.ts

@@ -0,0 +1,12 @@
+import { BitcoinWalletAbstract } from './BitcoinWalletAbstract.js';
+import { BitcoinProviderAbstract } from '../providers/BitcoinProviderAbstract.js';
+
+/**
+ * A wallet class for readonly wallet instances.
+ */
+declare class BitcoinWalletVoid extends BitcoinWalletAbstract {
+    constructor(publicKey: Buffer, provider: BitcoinProviderAbstract);
+    signTx(tx: any): any;
+}
+
+export { BitcoinWalletVoid };

package/esm/BitcoinVM/wallets/BitcoinWalletVoid.js

@@ -0,0 +1 @@
+import{BitcoinWalletAbstract as t}from"./BitcoinWalletAbstract.js";class r extends t{constructor(t,r){super(t,r)}signTx(t){throw new Error("Void wallets can not sign.")}}export{r as BitcoinWalletVoid};

package/esm/BitcoinVM/wallets/models.d.ts

@@ -0,0 +1,8 @@
+import { WalletPolicy } from 'ledger-bitcoin';
+
+interface WalletPolicyDetails {
+    policy: WalletPolicy;
+    hmac: Buffer;
+}
+
+export { WalletPolicyDetails };