MobileCoin

MobileCoin MobileCoin is a privacy-preserving payments network designed for use on mobile devices. License MobileCoin is available under open-source licenses. Look for the LICENSE file in each crate for more information. Cryptography Notice This distribution includes cryptographic software. Your country may have restrictions on the use of encryption software. Please check your country's laws before downloading or using this software. Repository Structure Directory Description :-- :-- attest Remote attestation primitives. build-info Measurements made at compile time. common Items shared across MobileCoin crates. consensus Byzantine Fault Tolerant Consensus. crypto Cryptography. enclave-boundary Intel® SGX ECALL infrastructure. fog Private payments for mobile devices ledger Storage and synchronization for the MobileCoin blockchain. mcbuild Tools for building and signing enclaves. mcconnection Attested MobileCoin connections. mobilecoind Blockchain daemon and example client code. peers Peer-to-peer networking. sgx Support for Intel® Software Guard eXtensions (Intel SGX). transaction Private transactions. util Miscellaneous utilities. Selected Binaries Target Description Used by... :-- :-- :-- consensus-service Validates new transactions for the public ledger. Validator Nodes ledger-distribution Publishes the ledger to long-term storage. Full Validator Nodes mobilecoind Synchronizes the ledger and provides the desktop API. Watcher and Validator Nodes The workspace can be built with cargo build and tested with cargo test . Either command will recognize the cargo --release flag to build with optimizations. Some crates (for example consensus-service ) depend on Intel SGX, which adds additional build and runtime requirements. For detailed information about setting up a build environment, how enclaves are built, and on configuring the build, see BUILD.md. For a quick start, you can build in the same docker image that we use for CI, using the mob tool. Note that this requires you to install Docker. You can use the mob tool with the following commands: MobileCoin is a payment network with no central authority. The fundamental goal of the network is to safely and efficiently enable the exchange of value, represented as fractional ownership of the total value of the network. Like most cryptocurrencies, MobileCoin maintains a permanent and immutable record of all successfully completed payments in a blockchain data structure. Cryptography is used extensively to establish ownership, control transfers, and to preserve cash-like privacy for users. Here we review a few design concepts that are essential for understanding the software. Ownership of a utxo in the MobileCoin network is equivalent to knowledge of two private keys, called the spend private key and the view private key , that provision control over discovery and transfer of value. Most users will derive these two private key values from a single underlying key we call the root entropy . To receive a payment, a user must calculate the two public key values corresponding to their private keys to share with their counter-party. MobileCoin specifies a standard encoding scheme using a base-58 symbol library for users to safely exchange payment information. For more information on how transactions work, and how they use CrytpoNote-style transactions to preserve privacy of both the sender and receiver, see the transaction crate. To understand the blockchain format and storage, see the ledger db crate. New transactions must be checked for attempts to counterfeit value before new key images and utxos can be added to the MobileCoin blockchain. Transactions are prepared by the user on their local computer or mobile device, and submitted to a secure enclave running on a validator node of their choice. The validator node checks the transaction and, assuming it believes the transaction is valid, shares it with other nodes in the MobileCoin network. The transaction is passed only to p