2.2.0 • Published 5 years ago

bitcoinjs-message v2.2.0

Weekly downloads
7,184
License
MIT
Repository
github
Last release
5 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-testwalltime-clixec-jsswitcheo-jsvexlib-jsjachavaljichaolijs-oipjiclibitgojavascript-frostjavascript-dlchazama-corehydrajs-walletmdip@wagerr-wdk/litecoin-js-wallet-provider@williamqin-bitgo/abstract-utxo@woleet/woleet-secure-module@woleet/woleet-weblibs@wagerr-wdk/ethereum-js-wallet-provider@wagerr-wdk/wagerr-js-wallet-provider@velygood/btcsnap@velygood/btcsnap-mainnet@velygood/btcsnap-testnet@yaswap/yacoin@yaswap/yacoin-js-wallet-provider@yaswap/dogecoin@yaswap/litecoin@yaswap/bitcoin@yaswap/bitcoin-js-wallet-provider@yac-swap/yacoin@yac-swap/yacoin-js-wallet-provider@yac-swap/bitcoin@yac-swap/bitcoin-js-wallet-provider@zalastax/nolb-bitc@temidaio/bm-wa@temidaio/wallet@telestai-project/telestai-messagealiasqui@gobob/bob-snap@gobob/btcsnap@gunner6/ordit-sdk@hashprotocol/bitcoin-js-wallet-provider@joundy/ordit-sdktyler-bitgojs-testingxrg-jszeltrezjsztakio-corevipstarcoinjs-wallet-corezeronet-cryptozetamaskzetalink@liquality-dev/bitcoin-js-wallet-provider@liquality/bitcoin-js-wallet-provider@liquality/litecoin-js-wallet-provider@liquality-dev/ethereum-js-wallet-provider@liquality/bitcoin@nexm-io/bitsnap@hypereon/messagemvcbridge-sdkmudamos-libcryptomigretor-dexoriginalmy-libcryptoordi_exampleoipmwoip-protobufjsoip-reactoip-react-jssoip-hdmwravencoin-messageself_signaturesnbv-ur-codecnbellanichnbellanich-1silalvado@ordzaar/ordit-sdk@onekeyfe/blockchain-libs@payvo/sdk-btc@hyperbitjs/message@getsafle/bitcoin-wallet-controller@getsafle/vault-bitcoin-controller@fluidtokens/ordit-sdk@funkybit-labs/api-client@photon-sdk/photon-lib@pioneer-platform/pioneer-cli-v2@pioneer-platform/signing@pgchain/blockchain-libs@plark/bitbox-sdk@shapeshiftoss/hdwallet-ledger
2.2.0

5 years ago

2.1.4

5 years ago

2.1.3

5 years ago

2.1.2

5 years ago

2.1.1

5 years ago

2.1.0

6 years ago

2.0.0

8 years ago

1.0.1

9 years ago

1.0.0

10 years ago