Marlowe Payouts is a decentralized application (dApp) designed to help users discover payouts available for withdrawal from Marlowe contracts on the Cardano blockchain. With a user-friendly interface and seamless integration with the Cardano network, Marlowe Payouts simplifies the process of tracking and withdrawing your payouts.
This dApp was built using the Marlowe-ts-sdk, a collection of JavaScript/TypeScript libraries that helps dApp developers to interact with the Marlowe ecosystem.
This project was bootstrapped with Create React App.
- Discover Payouts: Easily find payouts available for withdrawal from Marlowe Contracts.
- User-Friendly Interface: A clean and intuitive design ensures a smooth user experience.
- Secure: Built with the security and reliability of the Cardano blockchain in mind.
To get the dApp up and running on your local machine, follow these steps:
-
Clone the Repository
git clone https://github.com/input-output-hk/marlowe-payouts cd marlowe-payouts
-
Install Dependencies
npm install
-
Configure Marlowe URLs in .env
To ensure the dApp communicates correctly with the Marlowe runtime and scan instances, you need to set the appropriate URLs in the
.env
file.-
Open the .env File: Navigate to the root directory of your project and open the
.env
file in your preferred text editor. -
Set the Marlowe Runtime Web URL: Locate the line
MARLOWE_RUNTIME_WEB_URL=<Your-Runtime-Instance>
. Replace<Your-Runtime-Instance>
with the actual URL of your Marlowe runtime instance.MARLOWE_RUNTIME_WEB_URL=https://example-runtime-url.com
-
Set the Marlowe Scan URL: Locate the line
MARLOWE_SCAN_URL=<Your-Scan-Instance>
. Replace<Your-Scan-Instance>
with the actual URL of your Marlowe scan instance.MARLOWE_SCAN_URL=https://example-scan-url.com
-
-
Run the dApp
npm run start
This repository uses nix to provide the development and build environment.
For instructions on how to install and configure nix (including how to enable access to our binary caches), refer to this document.
If you already have nix installed and configured, you may enter the development shell by running nix develop
.
To generate payouts for testing purposes on the preprod and preview networks, we recommend using the Marlowe Starter Kit. The starter kit provides comprehensive instructions and tools, including Jupyter notebooks, to help you understand and work with Marlowe contracts.
-
Clone the Marlowe Starter Kit Repository:
git clone https://github.com/input-output-hk/marlowe-starter-kit.git cd marlowe-starter-kit
-
Follow the Instructions: Navigate to the Marlowe Starter Kit repository and follow the provided instructions to set up and run the Jupyter notebooks.
-
Generate Payouts: To generate payouts specifically, refer to Lesson 8 - CIP45 in the starter kit. This lesson provides a detailed guide on how to generate payouts for Marlowe contracts.
By following the above steps, you can easily generate payouts for testing purposes and further explore the capabilities of Marlowe contracts on the Cardano blockchain.
- Marlowe Documentation
- Marlowe-ts-sdk
- Marlowe Starter Kit
- Create React App documentation
- React documentation
We welcome contributions from the community! If you'd like to contribute, please fork the repository, make your changes, and submit a pull request. Ensure that your code adheres to the project's coding standards.
This project is licensed under the MIT License. See the LICENSE file for details.