@bigmi/react 0.0.0-preview-aab0339

package/CHANGELOG.md

@@ -0,0 +1,207 @@
+# @bigmi/react
+
+## 0.0.0-preview-aab0339
+
+### Patch Changes
+
+- Updated dependencies [[`aab0339`](https://github.com/lifinance/bigmi/commit/aab0339402b4a20b70f969ae801e89503b045a9d)]:
+  - @bigmi/client@0.0.0-preview-aab0339
+
+## 0.8.1
+
+### Patch Changes
+
+- Updated dependencies [[`767fb0c`](https://github.com/lifinance/bigmi/commit/767fb0cba233decea140daf1b562c104f027a261)]:
+  - @bigmi/core@0.8.1
+  - @bigmi/client@0.8.1
+
+> **Pre-Changesets history (aggregated, repo-wide).** The entries below are
+> inherited verbatim from the repository root `CHANGELOG.md`, which aggregated
+> releases across all packages of this monorepo before the Changesets cutover.
+> Many entries reference packages other than `@bigmi/react`; per-package release
+> notes (attributed by Changesets) appear above this section as future releases
+> ship.
+
+All notable changes to this project, up to `0.8.0`, were documented in this file
+using [standard-version](https://github.com/conventional-changelog/standard-version)
+commit guidelines.
+
+## [0.8.0](https://github.com/lifinance/bigmi/compare/v0.7.1...v0.8.0) (2026-03-25)
+
+### ⚠ BREAKING CHANGES
+
+- migrate build pipeline from tsc to tsdown (#51)
+
+### Bug Fixes
+
+- **react:** resolve useSyncExternalStore SSR infinite loop in useAccount and useConnectors ([#50](https://github.com/lifinance/bigmi/issues/50)) ([691b26c](https://github.com/lifinance/bigmi/commit/691b26c45c1de91ae3a1aaac93b675b40c1d8e5f))
+
+- migrate build pipeline from tsc to tsdown ([#51](https://github.com/lifinance/bigmi/issues/51)) ([0c4defb](https://github.com/lifinance/bigmi/commit/0c4defb4d4611fe09fddf01fed1a312de0344c1e))
+
+### [0.7.1](https://github.com/lifinance/bigmi/compare/v0.7.0...v0.7.1) (2026-03-12)
+
+### Bug Fixes
+
+- **core:** add missing jsonrpc and id fields to RPC request body ([#48](https://github.com/lifinance/bigmi/issues/48)) ([9896c7c](https://github.com/lifinance/bigmi/commit/9896c7c6f1498f54c29ae78be8a74008bad3a98a))
+
+## [0.7.0](https://github.com/lifinance/bigmi/compare/v0.6.5...v0.7.0) (2026-02-05)
+
+### ⚠ BREAKING CHANGES
+
+- **client:** add unhosted wallet support (#46)
+
+### Features
+
+- add reown support ([#44](https://github.com/lifinance/bigmi/issues/44)) ([657cae6](https://github.com/lifinance/bigmi/commit/657cae6615965ec5be6b1c079abc10c34cdc572d))
+- **client:** add unhosted wallet support ([#46](https://github.com/lifinance/bigmi/issues/46)) ([b3537b7](https://github.com/lifinance/bigmi/commit/b3537b77cc8a6322868330f5c6528834d86a5d99))
+
+### [0.6.5](https://github.com/lifinance/bigmi/compare/v0.6.4...v0.6.5) (2026-01-08)
+
+### Bug Fixes
+
+- **blockchair-getXpubAddresses:** return empty data when api returns empty data with 200 ([#43](https://github.com/lifinance/bigmi/issues/43)) ([d2e9b5b](https://github.com/lifinance/bigmi/commit/d2e9b5ba85eff202bfdafa5b6bf9041589e994c8))
+
+### [0.6.4](https://github.com/lifinance/bigmi/compare/v0.6.3...v0.6.4) (2025-12-17)
+
+### Features
+
+- add getXPubAddresses action ([#41](https://github.com/lifinance/bigmi/issues/41)) ([2aa3216](https://github.com/lifinance/bigmi/commit/2aa321602e83fc5642d7b86c8d114a0e0d38c13b))
+
+### [0.6.3](https://github.com/lifinance/bigmi/compare/v0.6.2...v0.6.3) (2025-11-26)
+
+### [0.6.2](https://github.com/lifinance/bigmi/compare/v0.6.1...v0.6.2) (2025-11-13)
+
+### Bug Fixes
+
+- **leather-wallet:** cache wallet connection with daily expiry and improve wallet reconnection reliability ([#36](https://github.com/lifinance/bigmi/issues/36)) ([fcff06e](https://github.com/lifinance/bigmi/commit/fcff06e19426154750b775f7a1b83f5c6db038dd))
+
+### [0.6.1](https://github.com/lifinance/bigmi/compare/v0.6.0...v0.6.1) (2025-10-29)
+
+## [0.6.0](https://github.com/lifinance/bigmi/compare/v0.5.4...v0.6.0) (2025-10-06)
+
+### ⚠ BREAKING CHANGES
+
+- bump packages
+
+- bump packages ([3576fa5](https://github.com/lifinance/bigmi/commit/3576fa55cd7ed3492f29f96a8cff6274313477ff))
+
+### [0.5.4](https://github.com/lifinance/bigmi/compare/v0.5.3...v0.5.4) (2025-09-29)
+
+### Bug Fixes
+
+- **blockchair:** handle zero balance addresses edge case ([#35](https://github.com/lifinance/bigmi/issues/35)) ([a57c5fd](https://github.com/lifinance/bigmi/commit/a57c5fd49ec22df2dd6165725ce2750d81f3267e))
+
+### [0.5.3](https://github.com/lifinance/bigmi/compare/v0.5.2...v0.5.3) (2025-09-22)
+
+### [0.5.2](https://github.com/lifinance/bigmi/compare/v0.5.1...v0.5.2) (2025-08-28)
+
+### Bug Fixes
+
+- imports ([6b26572](https://github.com/lifinance/bigmi/commit/6b265727d74bd84d326543a61ab52d4fb0c58ae0))
+
+### [0.5.1](https://github.com/lifinance/bigmi/compare/v0.5.0...v0.5.1) (2025-08-28)
+
+### Bug Fixes
+
+- update connectors to determine chain id based on address ([#33](https://github.com/lifinance/bigmi/issues/33)) ([ae969c9](https://github.com/lifinance/bigmi/commit/ae969c909f6ca4376e4e2468152309251a983910))
+
+## [0.5.0](https://github.com/lifinance/bigmi/compare/v0.4.5...v0.5.0) (2025-08-28)
+
+### ⚠ BREAKING CHANGES
+
+- change chainId to enum (#31)
+
+- change chainId to enum ([#31](https://github.com/lifinance/bigmi/issues/31)) ([4e93517](https://github.com/lifinance/bigmi/commit/4e93517e50353ffe949c7fd7cebd3313a9d2d69e))
+
+### [0.4.5](https://github.com/lifinance/bigmi/compare/v0.4.4...v0.4.5) (2025-08-27)
+
+### [0.4.4](https://github.com/lifinance/bigmi/compare/v0.4.3...v0.4.4) (2025-08-18)
+
+### [0.4.3](https://github.com/lifinance/bigmi/compare/v0.4.2...v0.4.3) (2025-07-31)
+
+### Bug Fixes
+
+- **connectors:** remove retry logic when checking if app isAuthorized ([#30](https://github.com/lifinance/bigmi/issues/30)) ([7709d68](https://github.com/lifinance/bigmi/commit/7709d68f67b19880940d68e288ac061ec4f074f8))
+
+### [0.4.2](https://github.com/lifinance/bigmi/compare/v0.4.1...v0.4.2) (2025-07-17)
+
+### [0.4.1](https://github.com/lifinance/bigmi/compare/v0.4.0...v0.4.1) (2025-07-02)
+
+### Bug Fixes
+
+- unisat wallet connector ([#24](https://github.com/lifinance/bigmi/issues/24)) ([6466bc5](https://github.com/lifinance/bigmi/commit/6466bc543719b1b26b1cdf990f2dc667659042a4))
+
+## [0.4.0](https://github.com/lifinance/bigmi/compare/v0.4.0-beta.2...v0.4.0) (2025-07-01)
+
+### Bug Fixes
+
+- **client:** update ctrl wallet signPSBT() signature ([#23](https://github.com/lifinance/bigmi/issues/23)) ([f502b92](https://github.com/lifinance/bigmi/commit/f502b924cdc4412f551c39333ae6bab800904975))
+
+### [0.3.1](https://github.com/lifinance/bigmi/compare/v0.3.0...v0.3.1) (2025-05-30)
+
+### Features
+
+- add more connectors (oyl, binance, magicEden & bitget) ([#17](https://github.com/lifinance/bigmi/issues/17)) ([18ad09a](https://github.com/lifinance/bigmi/commit/18ad09acd07726d25bd6422b0ecedd37745be335))
+
+## [0.3.0](https://github.com/lifinance/bigmi/compare/v0.2.1...v0.3.0) (2025-05-28)
+
+### ⚠ BREAKING CHANGES
+
+- add getUTXOs action (#16)
+
+### Features
+
+- add getUTXOs action ([#16](https://github.com/lifinance/bigmi/issues/16)) ([e884c02](https://github.com/lifinance/bigmi/commit/e884c02ad902123a9daf2edaeea2ab777c315925))
+
+### [0.2.1](https://github.com/lifinance/bigmi/compare/v0.2.0...v0.2.1) (2025-05-14)
+
+### Bug Fixes
+
+- optimize usage of supported methods by RPC and API transports ([#15](https://github.com/lifinance/bigmi/issues/15)) ([ff20e08](https://github.com/lifinance/bigmi/commit/ff20e089286bdc5f6f9d12ed2362f95d3c276fd9))
+
+## [0.2.0](https://github.com/lifinance/bigmi/compare/v0.1.1...v0.2.0) (2025-05-14)
+
+### ⚠ BREAKING CHANGES
+
+- remove viem dependencies (#14)
+
+- remove viem dependencies ([#14](https://github.com/lifinance/bigmi/issues/14)) ([3c3461f](https://github.com/lifinance/bigmi/commit/3c3461f8b646253df0c1614706f4dd5027d53930))
+
+### [0.1.1](https://github.com/lifinance/bigmi/compare/v0.0.8...v0.1.1) (2025-02-04)
+
+### [0.0.8](https://github.com/lifinance/bigmi/compare/v0.0.7...v0.0.8) (2024-12-30)
+
+### Features
+
+- add Leather and OneKey wallets ([#7](https://github.com/lifinance/bigmi/issues/7)) ([ac93f66](https://github.com/lifinance/bigmi/commit/ac93f665c8baa24752fd0ad4e2c513b72587060f))
+
+### [0.0.7](https://github.com/lifinance/bigmi/compare/v0.0.6...v0.0.7) (2024-12-20)
+
+### Features
+
+- improve peer dependencies ([#6](https://github.com/lifinance/bigmi/issues/6)) ([a9359d1](https://github.com/lifinance/bigmi/commit/a9359d1f72d5089652bad9311d8cd0ee67c909d4))
+
+### [0.0.6](https://github.com/lifinance/bigmi/compare/v0.0.5...v0.0.6) (2024-12-13)
+
+### [0.0.5](https://github.com/lifinance/bigmi/compare/v0.0.4...v0.0.5) (2024-12-05)
+
+### [0.0.4](https://github.com/lifinance/bigmi/compare/v0.0.3...v0.0.4) (2024-10-28)
+
+### Features
+
+- add okx wallet ([58b93b5](https://github.com/lifinance/bigmi/commit/58b93b5f8839bbbb0340ff7ac77f03617325c506))
+
+### [0.0.3](https://github.com/lifinance/bigmi/compare/v0.0.2...v0.0.3) (2024-10-23)
+
+### 0.0.2 (2024-10-17)
+
+### Bug Fixes
+
+- add createConfig export ([dec450a](https://github.com/lifinance/bigmi/commit/dec450a7e5a071e67e259be78c0b9a8b616c7183))
+
+### 0.0.1 (2024-10-15)
+
+### Bug Fixes
+
+- biome checks ([bc348fa](https://github.com/lifinance/bigmi/commit/bc348faad5cec9ddada1a0c82f4d34e68b85c1c4))
+- tsconfig ([bf6ccea](https://github.com/lifinance/bigmi/commit/bf6cceae3a1602b99b4825ee3695b367d5935226))

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Bigmi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,471 @@
+<div align="center">
+
+<h1 align="center">Bigmi</h1>
+<p align="center"><strong>TypeScript library and reactive primitives for Bitcoin apps.</strong></p>
+
+[![license](https://img.shields.io/github/license/lifinance/bigmi)](/LICENSE.md)
+[![npm latest package](https://img.shields.io/npm/v/@bigmi/core/latest.svg)](https://www.npmjs.com/package/@bigmi/core)
+[![npm downloads](https://img.shields.io/npm/dm/@bigmi/core.svg)](https://www.npmjs.com/package/@bigmi/core)
+
+</div>
+
+**Bigmi** (short for *Bitcoin Is Gonna Make It*) is a TypeScript library that provides reactive primitives for building Bitcoin applications. Bigmi simplifies Bitcoin app development by offering:
+
+- Abstractions over the [Bitcoin JSON-RPC API](https://developer.bitcoin.org/reference/rpc/)
+- First-class APIs for interacting with the [Bitcoin](https://bitcoin.design/) network, including sending transactions and tracking with [Replace-By-Fee (RBF)](https://github.com/bitcoin/bips/blob/master/bip-0125.mediawiki) support
+- Connectors for popular Bitcoin wallet extensions
+- TypeScript support
+  
+Whether you're building a Node.js application or a client-side app, Bigmi provides the tools you need to interact with the Bitcoin.
+
+### Packages
+
+Bigmi is modularized into several packages, each suited to different use cases:
+
+- [@bigmi/core](https://www.npmjs.com/package/@bigmi/core) - Actions, transports, utilities, and other core primitives for Node.js or client-side applications.
+- [@bigmi/react](https://www.npmjs.com/package/@bigmi/react) - Hooks, providers, and other useful primitives for React applications.
+- [@bigmi/client](https://www.npmjs.com/package/@bigmi/client) - Wallet connectors and other tools to connect wallet extensions with Bitcoin applications.
+
+## Installation
+
+```sh
+pnpm add @bigmi/react
+```
+
+```sh
+pnpm add @bigmi/core
+```
+
+```sh
+pnpm add @bigmi/client
+```
+
+## Getting Started
+
+### Node.js
+
+How to setup Bigmi on the backend with Node.js:
+
+```typescript
+// main.ts
+import {
+  createClient,
+  bitcoin,
+  blockchair,
+  sendUTXOTransaction,
+  waitForTransaction,
+  getBalance,
+} from '@bigmi/core'
+
+// Create a client for Bitcoin mainnet
+const publicClient = createClient({
+  chain: bitcoin,
+  rpcSchema: rpcSchema<UTXOSchema>(),
+  transport: fallback([
+    blockchair(),
+    ankr({apiKey: 'YOUR_ANKR_API_KEY'}),
+    blockcypher(),
+    mempool(),
+  ]),
+})
+
+// Define the Bitcoin address you're working with
+const address = 'BITCOIN_ADDRESS';
+
+// Fetch the balance of the address
+const balance = await getBalance(publicClient, { address });
+console.log(`Balance for ${address}:`, balance);
+
+// Fetch the current block count (height)
+const blockCount = await getBlockCount(publicClient);
+console.log('Current block count:', blockCount);
+
+// Prepare the transaction hex (as a string)
+const txHex = 'TRANSACTION_HEX';
+
+// Send the transaction to the network
+const txId = await sendUTXOTransaction(publicClient, { hex: txHex });
+console.log('Transaction sent with ID:', txId);
+
+// Wait for the transaction to be confirmed
+const transaction = await waitForTransaction(publicClient, {
+  txId,
+  txHex,
+  senderAddress: address,
+  onReplaced: (response) => {
+    console.log('Transaction replaced due to:', response.reason);
+  },
+});
+
+console.log('Transaction confirmed:', transaction);
+ 
+```
+
+### React
+
+Simple bigmi setup with a react app:
+
+```typescript
+// App.tsx
+
+import { bitcoin, http, createClient } from '@bigmi/core'
+import { BigmiProvider, createConfig } from '@bigmi/react'
+import { binance, xverse, phantom } from '@bigmi/client'
+
+// Create bigmi config object
+const config = createConfig({
+    chains: [bitcoin],
+    connectors: [binance(), xverse(), phantom()],
+    client: ({ chain }) => createClient({ chain, transport: http() }),
+    ssr: true // If using Next.js or SSR
+})
+
+
+function App() {
+  return (
+    // Wrap your application with the necessary providers:
+    <BigmiProvider config={config}>
+      <YourApp />
+    </BigmiProvider>
+  )
+}
+```
+
+```typescript
+// YourApp.tsx
+
+// Import the hooks from bigmi/react library
+import { useAccount, useBalance, useConnect } from '@bigmi/react'
+
+const { address, isConnected } = useAccount()
+const { balance } = useBalance()
+const { connect } = useConnect()
+
+function YourApp() {
+  return (
+    <div>
+      {isConnected ? (
+        <p>Connected: {address}: {balance}BTC</p>
+      ) : (
+        <button onClick={connect}>Connect Wallet</button>
+      )}
+    </div>
+  )
+}
+```
+
+## Creating Bitcoin Transactions
+
+While Bigmi excels at blockchain data retrieval and transaction broadcasting, it doesn't include transaction creation functions. For generating valid transaction hex, we recommend using **bitcoinjs-lib** (which Bigmi already depends on).
+
+### Basic Transaction Creation
+
+Here's how to create a Bitcoin transaction using bitcoinjs-lib with Bigmi:
+
+```typescript
+import * as bitcoin from 'bitcoinjs-lib';
+import { 
+  createClient, 
+  getUTXOs, 
+  sendUTXOTransaction, 
+  waitForTransaction,
+  getBlockStats,
+  getBlockCount
+} from '@bigmi/core';
+
+async function createAndSendTransaction(
+  client: Client,
+  fromAddress: string,
+  toAddress: string,
+  amount: number, // in satoshis
+  privateKey: Buffer
+) {
+  // 1. Get UTXOs for the address using Bigmi
+  const utxos = await getUTXOs(client, { address: fromAddress });
+  
+  // 2. Create a new transaction using bitcoinjs-lib
+  const psbt = new bitcoin.Psbt();
+  
+  // 3. Add inputs from UTXOs
+  let inputValue = 0;
+  const estimatedFee = 1000; // You should calculate this properly
+  
+  for (const utxo of utxos) {
+    psbt.addInput({
+      hash: utxo.txId,
+      index: utxo.vout,
+      witnessUtxo: {
+        script: Buffer.from(utxo.scriptHex, 'hex'),
+        value: utxo.value,
+      },
+    });
+    inputValue += utxo.value;
+    if (inputValue >= amount + estimatedFee) break;
+  }
+  
+  // 4. Add recipient output
+  psbt.addOutput({
+    address: toAddress,
+    value: amount,
+  });
+  
+  // 5. Add change output if needed
+  const change = inputValue - amount - estimatedFee;
+  if (change > 546) { // Dust threshold
+    psbt.addOutput({
+      address: fromAddress,
+      value: change,
+    });
+  }
+  
+  // 6. Sign the transaction
+  const keyPair = bitcoin.ECPair.fromPrivateKey(privateKey);
+  psbt.signAllInputs(keyPair);
+  psbt.finalizeAllInputs();
+  
+  // 7. Get the raw transaction hex
+  const rawTx = psbt.extractTransaction().toHex();
+  
+  // 8. Broadcast using Bigmi
+  const txId = await sendUTXOTransaction(client, { hex: rawTx });
+  
+  // 9. Wait for confirmation using Bigmi
+  const confirmedTx = await waitForTransaction(client, {
+    txId,
+    txHex: rawTx,
+    senderAddress: fromAddress,
+    confirmations: 1,
+  });
+  
+  return confirmedTx;
+}
+```
+
+### Fee Estimation
+
+Proper fee estimation is crucial for transaction confirmation:
+
+```typescript
+async function estimateFee(
+  client: Client,
+  numInputs: number,
+  numOutputs: number
+): Promise<number> {
+  // Get recent block stats for fee estimation
+  const blockHeight = await getBlockCount(client);
+  const blockStats = await getBlockStats(client, {
+    blockNumber: blockHeight,
+    stats: ['avgfeerate']
+  });
+  
+  // Estimate transaction size
+  // P2WPKH: ~68 bytes per input, ~31 bytes per output, ~10 bytes overhead
+  const estimatedSize = (numInputs * 68) + (numOutputs * 31) + 10;
+  
+  // Calculate fee (satoshis per byte * size)
+  const feeRate = blockStats.avgfeerate || 1; // fallback to 1 sat/byte
+  return Math.ceil(feeRate * estimatedSize);
+}
+```
+
+### Complete Example with Error Handling
+
+```typescript
+import * as bitcoin from 'bitcoinjs-lib';
+import { createClient, getBalance, getUTXOs, sendUTXOTransaction, waitForTransaction } from '@bigmi/core';
+
+async function safeSendBitcoin(
+  client: Client,
+  fromAddress: string,
+  toAddress: string,
+  amount: number,
+  privateKey: Buffer
+) {
+  try {
+    // Check balance
+    const balance = await getBalance(client, { address: fromAddress });
+    if (balance < amount + 1000) {
+      throw new Error('Insufficient balance');
+    }
+    
+    // Get UTXOs
+    const utxos = await getUTXOs(client, {
+      address: fromAddress,
+      minValue: amount + 1000,
+    });
+    
+    if (utxos.length === 0) {
+      throw new Error('No UTXOs available');
+    }
+    
+    // Create transaction
+    const psbt = new bitcoin.Psbt();
+    
+    let totalInput = 0;
+    for (const utxo of utxos) {
+      psbt.addInput({
+        hash: utxo.txId,
+        index: utxo.vout,
+        witnessUtxo: {
+          script: Buffer.from(utxo.scriptHex, 'hex'),
+          value: utxo.value,
+        },
+      });
+      totalInput += utxo.value;
+    }
+    
+    // Add outputs
+    psbt.addOutput({
+      address: toAddress,
+      value: amount,
+    });
+    
+    // Calculate fee and change
+    const fee = await estimateFee(client, utxos.length, 2);
+    const change = totalInput - amount - fee;
+    
+    if (change < 0) {
+      throw new Error('Insufficient funds for fee');
+    }
+    
+    if (change > 546) { // Dust threshold
+      psbt.addOutput({
+        address: fromAddress,
+        value: change,
+      });
+    }
+    
+    // Sign and finalize
+    const keyPair = bitcoin.ECPair.fromPrivateKey(privateKey);
+    psbt.signAllInputs(keyPair);
+    psbt.finalizeAllInputs();
+    
+    // Get transaction hex
+    const txHex = psbt.extractTransaction().toHex();
+    
+    // Broadcast with Bigmi
+    const txId = await sendUTXOTransaction(client, { hex: txHex });
+    
+    // Wait for confirmation
+    const confirmed = await waitForTransaction(client, {
+      txId,
+      txHex,
+      senderAddress: fromAddress,
+      confirmations: 1,
+    });
+    
+    return {
+      txId,
+      fee,
+      confirmed,
+    };
+    
+  } catch (error) {
+    console.error('Transaction failed:', error);
+    throw error;
+  }
+}
+```
+
+### Working with Different Address Types
+
+```typescript
+import { getAddressInfo } from '@bigmi/core';
+
+function createInputForUTXO(utxo: UTXO, addressInfo: AddressInfo) {
+  const input: any = {
+    hash: utxo.txId,
+    index: utxo.vout,
+  };
+  
+  switch (addressInfo.type) {
+    case 'p2wpkh':
+    case 'p2wsh':
+      // Witness UTXOs for SegWit
+      input.witnessUtxo = {
+        script: Buffer.from(utxo.scriptHex, 'hex'),
+        value: utxo.value,
+      };
+      break;
+    case 'p2pkh':
+    case 'p2sh':
+      // Need full transaction for legacy
+      input.nonWitnessUtxo = Buffer.from(fullTransactionHex, 'hex');
+      break;
+  }
+  
+  return input;
+}
+```
+
+### RBF (Replace-By-Fee) Support
+
+Create transactions with RBF enabled for fee bumping:
+
+```typescript
+const psbt = new bitcoin.Psbt();
+
+// Add inputs with RBF sequence
+for (const utxo of utxos) {
+  psbt.addInput({
+    hash: utxo.txId,
+    index: utxo.vout,
+    sequence: 0xfffffffd, // RBF enabled
+    witnessUtxo: {
+      script: Buffer.from(utxo.scriptHex, 'hex'),
+      value: utxo.value,
+    },
+  });
+}
+```
+
+### Alternative Libraries
+
+While we recommend bitcoinjs-lib, you can also use:
+- **@scure/btc-signer** - Modern, audited Bitcoin transaction library
+- **bitcore-lib** - Alternative to bitcoinjs-lib
+- **bcoin** - Full Bitcoin implementation
+
+### Security Best Practices
+
+1. **Never expose private keys** in client-side code
+2. **Use hardware wallets** for production applications
+3. **Validate all inputs** before creating transactions
+4. **Test on testnet** before mainnet deployment
+5. **Implement proper error handling** for all edge cases
+
+## Examples
+
+- [See Node.js examples](./docs/core/examples.md)
+- [See React examples](./docs/react/examples.md)
+
+You can explore the [LI.FI Widget](https://github.com/lifinance/widget) and [LI.FI SDK](https://github.com/lifinance/sdk) for detailed production examples.
+
+## Documentation
+
+- [Learn more about Configuration](./docs/core/config.md)
+- [See Core Docs](./docs/core/index.md)
+- [See Client Docs](./docs/client/index.md)
+- [See React Docs](./docs/react/index.md)
+
+- [Want to add support for your wallet?](./docs/client/connectors.md)
+
+## Support
+
+If you encounter any issues or have questions, please open an issue.
+
+## Contributing
+
+We welcome contributions from the community!
+
+## Changelog
+
+The [changelog](/CHANGELOG.md) is regularly updated to reflect what's changed in each new release.
+
+## License
+
+This project is licensed under the terms of the [MIT License](/LICENSE.md).
+
+## Acknowledgments
+
+Bigmi is inspired by the [wevm](https://github.com/wevm) stack. We appreciate the open-source community's contributions to advancing blockchain development.