2.2.0 • Published 3 years ago

bitcoinjs-message v2.2.0

Weekly downloads
7,184
License
MIT
Repository
github
Last release
3 years ago

bitcoinjs-message

NPM Package Build Status Dependency status

js-standard-style

Examples (Note about Electrum support at the bottom)

var bitcoin = require('bitcoinjs-lib') // v4.x.x
var bitcoinMessage = require('bitcoinjs-message')

sign(message, privateKey, compressed, network.messagePrefix, sigOptions)

  • If you pass the sigOptions arg instead of messagePrefix it will dynamically replace.
  • sigOptions contains two attributes
    • segwitType should be one of 'p2sh(p2wpkh)' or 'p2wpkh'
    • extraEntropy will be used to create non-deterministic signatures using the RFC6979 extra entropy parameter. R value reuse is not an issue.

Sign a Bitcoin message

var keyPair = bitcoin.ECPair.fromWIF('L4rK1yDtCWekvXuE6oXD9jCYfFNV2cWRpVuPLBcCU2z8TrisoyY1')
var privateKey = keyPair.privateKey
var message = 'This is an example of a signed message.'

var signature = bitcoinMessage.sign(message, privateKey, keyPair.compressed)
console.log(signature.toString('base64'))
// => 'H9L5yLFjti0QTHhPyFrZCT1V/MMnBtXKmoiKDZ78NDBjERki6ZTQZdSMCtkgoNmp17By9ItJr8o7ChX0XxY91nk='

To produce non-deterministic signatures you can pass an extra option to sign()

var { randomBytes } = require('crypto')
var keyPair = bitcoin.ECPair.fromWIF('L4rK1yDtCWekvXuE6oXD9jCYfFNV2cWRpVuPLBcCU2z8TrisoyY1')
var privateKey = keyPair.privateKey
var message = 'This is an example of a signed message.'

var signature = bitcoinMessage.sign(message, privateKey, keyPair.compressed, { extraEntropy: randomBytes(32) })
console.log(signature.toString('base64'))
// => different (but valid) signature each time

Sign a Bitcoin message (with segwit addresses)

// P2SH(P2WPKH) address 'p2sh(p2wpkh)'
var signature = bitcoinMessage.sign(message, privateKey, keyPair.compressed, { segwitType: 'p2sh(p2wpkh)' })
console.log(signature.toString('base64'))
// => 'I9L5yLFjti0QTHhPyFrZCT1V/MMnBtXKmoiKDZ78NDBjERki6ZTQZdSMCtkgoNmp17By9ItJr8o7ChX0XxY91nk='

// P2WPKH address 'p2wpkh'
var signature = bitcoinMessage.sign(message, privateKey, keyPair.compressed, { segwitType: 'p2wpkh' })
console.log(signature.toString('base64'))
// => 'J9L5yLFjti0QTHhPyFrZCT1V/MMnBtXKmoiKDZ78NDBjERki6ZTQZdSMCtkgoNmp17By9ItJr8o7ChX0XxY91nk='

verify(message, address, signature, network.messagePrefix, checkSegwitAlways)

Verify a Bitcoin message

var address = '1F3sAm6ZtwLAUnj7d38pGFxtP3RVEvtsbV'

console.log(bitcoinMessage.verify(message, address, signature))
// => true

About Electrum segwit signature support

  • For Signing: Use the non-segwit compressed signing parameters for both segwit types (p2sh-p2wpkh and p2wpkh)
  • For Verifying: Pass the checkSegwitAlways argument as true. (messagePrefix should be set to null to default to Bitcoin messagePrefix)

LICENSE MIT

@thorswap-lib/hdwallet-ledger@thorswap-lib/hdwallet-metamask@thorswap-lib/hdwallet-portisalebussenode_mongo_express@twetch/walletwoleet-weblibshdwalletcoinoxs@diviproject/react-native-bitcoinjs-messagebchidentitybch-js-joey@everything-registry/sub-chunk-1239bch-js-testjiclibitgojichaolijachavaljs-oiphydrajs-wallethazama-coremdip@joundy/ordit-sdkelectra-jsedge-currency-pluginsfrausch-bitgoeiusfacereeumadipiscifch-sdkordi_exampleoriginalmy-libcryptooip-protobufjsoip-reactoip-react-jssoipmwoip-hdmwnbv-ur-codecnbellanichnbellanich-1migretor-dexmudamos-libcryptomvcbridge-sdkravencoin-messagesilalvadotyler-bitgojs-testingswitcheo-js@photon-sdk/photon-lib@pgchain/blockchain-libs@plark/bitbox-sdk@nbellanich/bitgo@nestor0405/xverse-core@nexm-io/bitsnap@psf/bch-js@psf/bch-js-electronztakio-core@ryan-bitgo/bitgo@sambo5000/xec-js@samouraiwallet/auth47@samrock5000/bch-js@samrock5000/xecjs@rafaeltaranto/bitgo@sadoprotocol/ordit-sdkvexlib-js@ordzaar/ordit-sdk@payvo/sdk-btc@liquality/bitcoin-js-wallet-provider@liquality-dev/ethereum-js-wallet-provider@liquality/bitcoin@liquality-dev/bitcoin-js-wallet-provider@liquality/litecoin-js-wallet-provider@mdip/client@mandeep-self/mdip-client-private@onekeyfe/blockchain-libs@ravenrebels/ravencoin-message@pyramation/crypto-keys@pioneer-platform/pioneer-cli-v2@pioneer-platform/signing@self_id/self-platform-sdkwalltime-clixrg-jsxec-jsvipstarcoinjs-wallet-core@keepkey/hdwallet-ledger@keepkey/hdwallet-portis@kitzen/wallet-core-essentialszeronet-cryptozeltrezjs@aidpproject/aidpcoin-message@abcpros/xpi-js@abcpros/bch-js@adawg/ordit-sdk@aloe2/sdk-core@aloe2/abstract-utxo@aloe2/bitgo@aloe2/sdk-api@swipechain/platform-sdk-btc@sudophunk/hdwallet-ledger@tatsujoestar/abstract-utxo@tatsujoestar/bitgo@tatsujoestar/sdk-api@tatsujoestar/sdk-core@velygood/btcsnap
2.2.0

3 years ago

2.1.4

3 years ago

2.1.3

4 years ago

2.1.2

4 years ago

2.1.1

4 years ago

2.1.0

5 years ago

2.0.0

7 years ago

1.0.1

8 years ago

1.0.0

9 years ago