@xchainjs/xchain-bitcoin
TypeScript icon, indicating that this package has built-in type declarations

1.1.3 • Public • Published

@xchainjs/xchain-bitcoin

Modules

Installation

yarn add @xchainjs/xchain-bitcoin

Following peer dependencies have to be installed into your project. These are not included in @xchainjs/xchain-bitcoin.

yarn add @xchainjs/xchain-client @xchainjs/xchain-crypto @xchainjs/xchain-util axios bitcoinjs-lib wif

Documentation

How xchain-bitcoin works
How to use xchain-bitcoin

Service Providers

This package uses the following service providers:

Function Service Notes
Balances Sochain https://sochain.com/api#get-balance
Transaction history Sochain https://sochain.com/api#get-display-data-address, https://sochain.com/api#get-tx
Transaction details by hash Sochain https://sochain.com/api#get-tx
Transaction fees Bitgo https://app.bitgo.com/docs/#operation/v2.tx.getfeeestimate
Transaction broadcast Sochain https://sochain.com/api#send-transaction
Explorer Blockstream https://blockstream.info

Sochain API rate limits: https://sochain.com/api#rate-limits (300 requests/minute)

Bitgo API rate limits: https://app.bitgo.com/docs/#section/Rate-Limiting (10 requests/second)

Setting Headers for Nine Realms endpoints

If you plan on using the publically accessible endpoints provided by Nine Realms(listed below), ensure that you add a valid 'x-client-id' to all requests

Example

import cosmosclient from '@cosmos-client/core'
import axios from 'axios'
import { register9Rheader } from '@xchainjs/xchain-util'

register9Rheader(axios)
register9Rheader(cosmosclient.config.globalAxios)

For a complete example please see this test

UtxoOnlineDataProviders

default providers

Creating a no-arg BTC Client will default to the following settings:

const defaultBTCParams: UtxoClientParams = {
  network: Network.Mainnet,
  phrase: '',
  explorerProviders: blockstreamExplorerProviders,
  dataProviders: [BlockcypherDataProviders],
  rootDerivationPaths: {
    [Network.Mainnet]: `84'/0'/0'/0/`,
    [Network.Testnet]: `84'/1'/0'/0/`,
    [Network.Stagenet]: `84'/0'/0'/0/`,
  },
  feeBounds: {
    lower: LOWER_FEE_BOUND,
    upper: UPPER_FEE_BOUND,
  },
}

Note: BlockCypher is the default online data provider (to fetch realtime utxos, balances, etc)

Overriding providers

You can specify own array of providers, whoch will be executed in array-order, to provide automated failover to the subsequent providers if calls to the first providers fail

example sochain v3, blockcypher backup

import { Client, defaultBTCParams, AssetBTC, SochainDataProviders, BlockcypherDataProviders } from '@xchainjs/xchain-bitcoin'
import { SochainNetwork,  SochainProvider } from '@xchainjs/xchain-utxo-providers'
import { Network, UtxoClientParams } from '@xchainjs/xchain-client'

// override with your API key
SochainDataProviders[Network.Mainnet].apiKey = 'YOUR_SOCHAIN_API_KEY'

// or set in env variables so default config can access.
`SOCHAIN_API_KEY={YOUR_SOCHAIN_API_KEY}`
`BLOCKCYPHER_API_KEY={YOUR_BLOCKCYPHER_API_KEY}`
//Default config can access.
process.env.BLOCKCYPHER_API_KEY
process.env.SOCHAIN_API_KEY

//overridde the default init params with your onfig
const initParams: UtxoClientParams = {
  ...defaultBTCParams,
  dataProviders: [SochainDataProviders, BlockcypherDataProviders]// use sochain first and blockcypher as fallback
  phrase: process.env.PHRASE,
}
const btcClient = new Client(sochainParams)

Versions

Current Tags

VersionDownloads (Last 7 Days)Tag
1.1.355latest

Version History

VersionDownloads (Last 7 Days)Published
1.1.355
1.1.215
1.1.10
1.1.00
1.0.40
1.0.30
1.0.212
1.0.12
1.0.00
0.23.1925
0.23.180
0.23.170
0.23.160
0.23.150
0.23.140
0.23.132
0.23.120
0.23.110
0.23.101
0.23.90
0.23.721
0.23.60
0.23.41
0.23.30
0.23.28
0.23.010
0.22.419
0.22.35
0.22.22
0.22.12
0.22.02
0.21.42
0.21.311
0.21.21
0.21.13
0.21.02
0.20.96
0.20.88
0.20.71
0.20.61
0.20.51
0.20.411
0.20.257
0.20.12
0.20.02
0.19.01
0.18.42
0.18.21
0.18.12
0.18.01
0.18.0-alpha.21
0.18.0-alpha.11
0.17.17
0.17.01
0.16.01
0.15.131
0.15.1221
0.15.117
0.15.101
0.15.91
0.15.81
0.15.74
0.15.61
0.15.51
0.15.41
0.15.31
0.15.21
0.15.11
0.15.02
0.13.01
0.12.21
0.12.066
0.11.15
0.11.01
0.10.11
0.10.01
0.9.01
0.8.22
0.8.11
0.8.01
0.7.11
0.7.01
0.6.01
0.5.11
0.5.01
0.4.41
0.4.31
0.4.21
0.4.11
0.4.02
0.3.32

Package Sidebar

Install

npm i @xchainjs/xchain-bitcoin

Weekly Downloads

105

Version

1.1.3

License

MIT

Unpacked Size

181 kB

Total Files

16

Last publish

Collaborators

  • xchainjsadmin
  • thorianite
  • polaris_9r
  • thorchain_org
  • _stu
  • veado
  • thatstrangeguy
  • junkai121
  • sarawut11
  • thorswap
  • hodrthemediocre