Skip to content

Latest commit

 

History

History
58 lines (40 loc) · 1.85 KB

README.md

File metadata and controls

58 lines (40 loc) · 1.85 KB

Bitcore P2P

NPM Package Build Status Coverage Status

The peer-to-peer networking protocol for BTC.

bitcore-p2p adds Bitcoin protocol support for Bitcore.

See the main bitcore repo for more information.

Getting Started

npm install bitcore-p2p

In order to connect to the Bitcoin network, you'll need to know the IP address of at least one node of the network, or use Pool to discover peers using a DNS seed.

var Peer = require('bitcore-p2p').Peer;

var peer = new Peer({host: '127.0.0.1'});

peer.on('ready', function() {
  // peer info
  console.log(peer.version, peer.subversion, peer.bestHeight);
});
peer.on('disconnect', function() {
  console.log('connection closed');
});
peer.connect();

Then, you can get information from other peers by using:

// handle events
peer.on('inv', function(message) {
  // message.inventory[]
});
peer.on('tx', function(message) {
  // message.transaction
});

Take a look at this guide on the usage of the Peer class.

Contributing

See CONTRIBUTING.md on the main bitcore repo for information about how to contribute.

License

Code released under the MIT license.

Copyright 2013-2019 BitPay, Inc. Bitcore is a trademark maintained by BitPay, Inc.