bcoin-extension-blocks's Introduction

Bcoin

Bcoin is an alternative implementation of the bitcoin protocol, written in node.js.

Although still in a beta state, bcoin is well tested and aware of all known consensus rules. It is currently used in production as the consensus backend and wallet system for purse.io.

Uses

Full Node
SPV Node
Wallet Backend (bip44 derivation)
Mining Backend (getblocktemplate support)
Layer 2 Backend (lightning)
General Purpose Bitcoin Library

Try it in the browser: http://bcoin.io/browser.html

Install

$ git clone git://github.com/bcoin-org/bcoin.git
$ cd bcoin
$ npm install
$ bcoin

See the Beginner's Guide for more in-depth installation instructions.

Documentation

API Docs: http://bcoin.io/docs/
REST Docs: https://github.com/bcoin-org/bcoin/wiki/REST-&-RPC-API
Wiki: https://github.com/bcoin-org/bcoin/wiki

Support

Join us on freenode in the #bcoin channel, or on the bitcoin core slack.

Disclaimer

Bcoin does not guarantee you against theft or lost funds due to bugs, mishaps, or your own incompetence. You and you alone are responsible for securing your money.

Contribution and License Agreement

If you contribute code to this project, you are implicitly allowing your code to be distributed under the MIT license. You are also implicitly verifying that all code is your original work. </legalese>

License

See LICENSE for more info.

bcoin-extension-blocks's People

Contributors

Stargazers

Watchers

bcoin-extension-blocks's Issues

Extension block testnet (extnet)

I've set up an early testnet for extension blocks (extnet) running on bcoin.

Seed: 45.33.50.84:58901
Faucet: http://45.33.50.84:8080

Parameters and genesis block reside in: https://github.com/bcoin-org/bcoin-extension-blocks/blob/extblk/lib/protocol/networks.js#L782

This is still an early iteration of the extension block ruleset. Some of the rules implemented only reside in issues/prs as of right now. They will likely be changed in the near future (i.e. extnet2).

Differences from the current spec

Resolution output maturity requirement of 25 blocks (high due to expectation of extnet reorgs). Described here:
tothemoon-org/extension-blocks#9
DoS limits implemented as described here:
tothemoon-org/extension-blocks#14
Lightning rules not yet implemented.
Deactivation not yet implemented.

Note: Please attempt to break the testnet. That's what it is meant for.

Running

$ git clone git://github.com/bcoin-org/bcoin-extension-blocks.git
$ cd bcoin-extension-blocks
$ git checkout extblk
$ npm install
$ export BCOIN_NETWORK=extnet
$ ./bin/bcoin

Note: ensure you have the required dependencies listed on the bcoin wiki.

Listening Publicly

See the wiki for more info.

Mining

The CPU miner is always available via the RPC:

$ ./bin/bcoin rpc generatetoaddress 1 [addr]

Stratum mining is available via bcoin-stratum. Make sure it is installed in a reachable node_modules directory and run bcoin with:

$ mkdir -p ~/.bcoin/extnet/stratum/shares # temporary fix for an issue
$ ./bin/bcoin -n extnet --plugins bcoin-stratum --coinbase-address [address]

Note: if a stratum server respects GBT's default_witness_commitment property without creating a commitment themselves, it should be possible to get extblk mining working with existing mining clients without any changes.

Creating an extblk account

$ ./bin/bcoin wallet account create foo --witness
# Should return JSON containing your extblk receive addr.
# If you need to see it again, run:
# $ ./bin/bcoin wallet account get foo

TX history

$ ./bin/bcoin wallet history
$ ./bin/bcoin wallet history --account=foo

Sending from extblk account

$ ./bin/bcoin wallet send [address] [value] --account=foo

Extra verbose block output

$ ./bin/bcoin rpc getblockbyheight [number] true true

Please join #bcoin and/or #extblk-dev on freenode to voice any issues you may encounter.

Recommend Projects

bcoin-org / bcoin-extension-blocks Goto Github PK