BCH Coin Selector

A lightweight TypeScript coin selector for Bitcoin Cash (BCH) with support for CashTokens.

Features

• Select UTXOs based on:
  • Largest value
  • Smallest value
  • Oldest (by age)
  • BCH-only
  • Token-only
• Optional token filtering by category, capability, or amount
• Supports CashToken metadata
• Returns remaining UTXOs after selection

Install

npm install bch-coinselector

Or clone/download and build:

git clone https://github.com/yourname/bch-coinselector
cd bch-coinselector
npm install
npm run build

Usage

import { coinSelect } from 'bch-coinselector'

const utxos = [
  { txid: 'a', vout: 0, value: 1000 },
  { txid: 'b', vout: 1, value: 2000 }
]

const result = coinSelect(utxos, {
  targetSatoshis: 1500,
  strategy: 'largest'
})

console.log(result)

API

coinSelect(utxos, options)

• utxos: UTXO[]
• options: CoinSelectOptions

Returns:

{
  selected: UTXO[]
  total: number
  satisfied: boolean
  remaining: UTXO[]
}

License

MIT