feat: implement auto coin select

Adds and implements auto coin select functionality.
Bumps version to 0.0.52.
Adds coinSelectPreference to example in README.md.

Author: coreyphillips

README.md

@@ -102,6 +102,7 @@ import { Wallet, generateMnemonic } from 'beignet';
 import net from 'net'
 import tls from 'tls'
 import { TStorage } from './wallet';
+import { ECoinSelectPreference } from "./transaction";
 
 // Generate a mnemonic phrase
 const mnemonic = generateMnemonic();
@@ -111,10 +112,10 @@ const passphrase = 'passphrase';
 
 // Connect to custom electrum server
 const servers: TServer = {
-	host: '35.233.47.252',
-	ssl: 18484,
-	tcp: 18483,
-	protocol: EProtocol.ssl,
+  host: '35.233.47.252',
+  ssl: 18484,
+  tcp: 18483,
+  protocol: EProtocol.ssl,
 };
 
 // Use a specific network (Defaults to mainnet)
@@ -128,43 +129,47 @@ const addressTypesToMonitor = [EAddressType.p2tr, EAddressType.p2wpkh];
 
 // Subscribe to server messages (TOnMessage)
 const onMessage: TOnMessage = (id, data) => {
-	console.log(id);
-	console.dir(data, { depth: null });
+  console.log(id);
+  console.dir(data, { depth: null });
 }
 
 // Disable startup messages. Messages resume once startup is complete. (Defaults to false)
 const disableMessagesOnCreate = true;
 
 // Persist sessions by getting and setting data from storage
 const storage: TStorage = {
-	async getData<K extends keyof IWalletData>(
-		key: string
-	): Promise<Result<IWalletData[K]>> {
-		// Add your logic here
-	},
-	async setData<K extends keyof IWalletData>(
-		key: string,
-		value: IWalletData[K]
-	): Promise<Result<boolean>> {
-		// Add your logic here
-	}
+  async getData<K extends keyof IWalletData>(
+    key: string
+  ): Promise<Result<IWalletData[K]>> {
+    // Add your logic here
+  },
+  async setData<K extends keyof IWalletData>(
+    key: string,
+    value: IWalletData[K]
+  ): Promise<Result<boolean>> {
+    // Add your logic here
+  }
 };
 
+// Set the auto coin selection preference. (Defaults to ECoinSelectPreference.consolidate)
+const coinSelectPreference = ECoinSelectPreference.small;
+
 // Create a wallet instance
 const createWalletRes = await Wallet.create({
-	mnemonic,
-	passphrase,
-	electrumOptions: {
-		servers,
-		net,
-		tls
-	},
-	network,
-	onMessage,
-	storage, 
-    addressType,
-	addressTypesToMonitor,
-	disableMessagesOnCreate
+  mnemonic,
+  passphrase,
+  electrumOptions: {
+    servers,
+    net,
+    tls
+  },
+  network,
+  onMessage,
+  storage,
+  addressType,
+  addressTypesToMonitor,
+  disableMessagesOnCreate,
+  coinSelectPreference
 });
 if (createWalletRes.isErr()) return;
 const wallet = createWalletRes.value;
@@ -174,18 +179,18 @@ const utxos = wallet.listUtxos();
 
 // Send sats to multiple outputs
 const txs = [
-	{ address: 'address1', amount: 1000 },
-	{ address: 'address2', amount: 2000 },
-	{ address: 'address3', amount: 3000 },
+  { address: 'address1', amount: 1000 },
+  { address: 'address2', amount: 2000 },
+  { address: 'address3', amount: 3000 },
 ];
 const sendManyRes = await wallet.sendMany({ txs });
 
 // Sweep from a private key
 const sweepPrivateKeyRes = await wallet.sweepPrivateKey({
-	privateKey: 'privateKey',
-	toAddress: 'toAddress',
-	satsPerByte: 5,
-	broadcast: false
+  privateKey: 'privateKey',
+  toAddress: 'toAddress',
+  satsPerByte: 5,
+  broadcast: false
 });
 
 // Get tx history for a given address. { tx_hash: string; height: number; }[]

example/helpers.ts

@@ -77,7 +77,7 @@ export const servers = {
 			host: '35.233.47.252',
 			ssl: 18484,
 			tcp: 18483,
-			protocol: EProtocol.ssl
+			protocol: EProtocol.tcp
 		}
 	]
 };

example/index.ts

@@ -1,4 +1,9 @@
-import { EAvailableNetworks, generateMnemonic, Wallet } from '../src';
+import {
+	EAvailableNetworks,
+	ECoinSelectPreference,
+	generateMnemonic,
+	Wallet
+} from '../src';
 import { getData, onMessage, servers, setData } from './helpers';
 import * as repl from 'repl';
 import net from 'net';
@@ -26,7 +31,8 @@ const runExample = async (mnemonic = generateMnemonic()): Promise<void> => {
 			lookBehind: 5,
 			lookAheadChange: 5,
 			lookBehindChange: 5
-		}
+		},
+		coinSelectPreference: ECoinSelectPreference.small
 	});
 	if (createWalletResponse.isErr()) return;
 	const wallet = createWalletResponse.value;

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "beignet",
-  "version": "0.0.51",
+  "version": "0.0.52",
   "description": "A self-custodial, JS Bitcoin wallet management library.",
   "main": "dist/index.js",
   "scripts": {