A pure, powerful core for your Flappycoin project.
Flappycore is a complete, native interface to the Flappycoin network, and provides the core functionality needed to develop apps for Flappycoin.
#Principles
Flappycoin is a powerful new peer-to-peer platform for the next generation of financial and social technology. The decentralized nature of the Flappycoin network allows for highly resilient Flappycoin infrastructure, and the developer community needs reliable, open-source tools to implement Flappycoin apps and services.
Flappycore unchains developers from fallible, centralized APIs, and provides the tools to interact with the real Flappycoin network.
#Get Started
Flappycore runs on node, and can be installed via npm:
npm install flappycore
It is a collection of objects useful to Flappycoin applications; class-like idioms are enabled viaSoop. In most cases, a developer will require the object's class directly. For instance:
var flappycore = require('flappycore');
var Address = flappycore.Address;
var Transaction = flappycore.Transaction;
var PeerManager = flappycore.PeerManager;#Examples
Examples are provided here Build the examples by installing and running gulp:
npm install -g gulp
gulp
Javascript files available at /examples folder.
#Security
Please use at your own risk.
Flappycore is still under heavy development and not quite ready for "drop-in" production use. If you find a security issue, please email [email protected]
#Contributing
Flappycore needs some developer love. Please send pull requests for bug fixes, code optimization, and ideas for improvement.
#Browser support
To build Flappycore full bundle for the browser (this is automatically executed after you run npm install):
node browser/build.js -a
This will generate a browser/bundle.js file which you can include in your HTML to use Flappycore in the browser.
##Example browser usage
From example/simple.html
<!DOCTYPE html>
<html>
<body>
<script src="../browser/bundle.js"></script>
<script>
var flappycore = require('flappycore');
var Address = flappycore.Address;
var a = new Address('sgrHPw4aEPos8YJDNfefsUSjPYWc5fzpLE');
console.log('sgrHPw4aEPos8YJDNfefsUSjPYWc5fzpLE is valid? '+a.isValid());
</script>
</body>
</html>You can check a more complex usage example at examples/example.html.
To build the main Flappycore bundle, run:
node browser/build.js -m
To build all features into the Flappycore bundle (which will lead to a large file size), run:
node browser/build.js -a
To generate a customized Flappycore bundle, you can specify which submodules you want to include in it with the -s option:
node browser/build.js -s Transaction,Address
This will generate a browser/bundle.js containing only the Transaction and Address class, with all their dependencies.
Use this option if you are not using the whole Flappycore library, to optimize the bundle size, script loading time, and general resource usage.
Run tests in node:
mocha
Or generate tests in the browser:
grunt shell
And then open test/index.html in your browser.
To run the code coverage report:
npm run-script coverage
And then open coverage/lcov-report/index.html in your browser.
#License
Bitcore Code released under the MIT license.
Copyright 2013-2014 BitPay, Inc. Bitcore is a trademark maintained by BitPay, Inc.
