Note to readers: On December 1, 2020, the Libra Association was renamed to Diem Association. The project repos are in the process of being migrated. All projects will remain available for use here until the migration to the new GitHub Organization is complete.

Reference Merchant

Reference Merchant is an open-source project aimed at demonstrating integration of payments into an existing e-commerce solution. We tried to incorporate both technical and design aspects not only to show how the different technical pieces fit together, but also demonstrate thoughtful design, content, and best experience practices.

Note to Developers

• Reference Merchant is a reference implementation, and not meant to be fully production grade.
• The project will continue to develop to include the different aspects of the evolving developer ecosystem.

Project Organization

The project is separated into the following components:

• Merchant - e-commerce website mock.
• VASP - VASP fulfilling the merchant's payment requests.
• Gateway - Nginx server routing requests to the various system components.
• Liquidity - Liquidity provider mock implementing simple liquidity functionality. This piece should be replaced by a service that provides your organization with needed liquidity functionality.

Getting started

The project uses Docker containers to run its components. The containers are orchestrated using docker-compose.

System Requirements:

• docker and docker-compose - Docker can be installed from the web. If you are installing Docker for the first time on your system, be sure to run it at least once to have it configure itself and get docker-compose as a runnable command.
• python 3.7
• yarn
• react-scripts
• macOS: xcode cli tools xcode-select --install

Run the following commands in the repository root:

scripts/lrm.sh setup_environment
scripts/lrm.sh build
scripts/lrm.sh develop

The merchant website will be available at http://localhost:8000

See docker/docker-compose.yaml for the setup details.