Fcash

Infrastructure to build Fcash and blockchain-based applications for the next generation of financial technology.

Note: If you're looking for the Fcash Library please see: https://github.com/fcash-js/fcash-lib

Getting Started

Before you begin you'll need to have Node.js v8 installed. There are several options for installation. One method is to use nvm to easily switch between different versions, or download directly from Node.js.

npm install -g fcash-base

Spin up a full node and join the network:

npm install -g fcash-base
fcash-based

You can then view the Insight block explorer at the default location: http://localhost:3001/insight, and your configuration file will be found in your home directory at ~/.fcash-base.

Create a transaction:

var fcashBase = require('fcash-base');
var transaction = new fcashBase.Transaction();
var transaction.from(unspent).to(address, amount);
transaction.sign(privateKey);

Applications

• Node - A full node with extended capabilities using Fcash Core
• Insight API - A blockchain explorer HTTP API
• Insight UI - A blockchain explorer web user interface
• Wallet Service - A multisig HD service for wallets
• Wallet Client - A client for the wallet service
• CLI Wallet - A command-line based wallet client
• Angular Wallet Client - An Angular based wallet client
• FcashApp - An easy-to-use, multiplatform, multisignature, secure bitcoin wallet

Libraries

• Lib - All of the core Fcash primatives including transactions, private key management and others
• Payment Protocol - A protocol for communication between a merchant and customer
• P2P - The peer-to-peer networking protocol
• Mnemonic - Implements mnemonic code for generating deterministic keys
• Channel - Micropayment channels for rapidly adjusting bitcoin transactions
• Message - Fcash message verification and signing
• ECIES - Uses ECIES symmetric key negotiation from public keys to encrypt arbitrarily long data streams.

Documentation

The complete docs are hosted here: fcash-base documentation. There's also a fcash-base API reference available generated from the JSDocs of the project, where you'll find low-level details on each fcash-base utility.

• Read the Developer Guide
• Read the API Reference

To get community assistance and ask for help with implementation questions, please use our community forums.

Security

We're using Fcash in production, as are many others, but please use common sense when doing anything related to finances! We take no responsibility for your implementation decisions.

If you find a security issue, please email [email protected].

Contributing

Please send pull requests for bug fixes, code optimization, and ideas for improvement. For more information on how to contribute, please refer to our CONTRIBUTING file.

This will generate files named fcash-base.js and fcash-base.min.js.

You can also use our pre-generated files, provided for each release along with a PGP signature by one of the project's maintainers. To get them, checkout a release commit (for example, https://github.com/fcash-js/fcash-base/commit/e33b6e3ba6a1e5830a079e02d949fce69ea33546 for v0.12.6).

To verify signatures, use the following PGP keys:

• @gabegattis: https://pgp.mit.edu/pks/lookup?op=get&search=0x441430987182732C F3EA 8E28 29B4 EC93 88CB B0AA 4414 3098 7182 732C
• @kleetus: https://pgp.mit.edu/pks/lookup?op=get&search=0x33195D27EF6BDB7F F8B0 891C C459 C197 65C2 5043 3319 5D27 EF6B DB7F
• @matiu: https://pgp.mit.edu/pks/lookup?op=get&search=0x9EDE6DE4DE531FAC 25CE ED88 A1B1 0CD1 12CD 4121 9EDE 6DE4 DE53 1FAC

License

Code released under the MIT license.

Copyright 2013-2017 Fcash, Inc. Fcash is a trademark maintained by Fcash, Inc.