Skip to content

Salmandabbakuti/superfluid-devmode-dashboard

Repository files navigation

Superfluid Developer-Mode Dashboard

CLI != Dashboard

A dashboard is a way of displaying various types of visual data in one place. Usually, a dashboard is intended to convey different, but related information in an easy-to-digest form. A dashboard is often called a control panel, but the terms are interchangeable.

The Superfluid Developer-Mode Dashboard is a fullstack application that allows developers to deploy superfluid contracts and manage money streams on their local Superfluid instance. The dashboard is designed to be easy to use and can be quickly set up to connect to your local blockchain where Superfluid is deployed. The dashboard provides a centralized location for users to manage all of their streams, view important details, and perform actions on them.

Dashboard

dashboard-sf-dm

sf-dm-list

Search

sf-dm-search

Features

The Developer-Mode Dashboard for Superfluid simplifies the process of creating, updating, and deleting, reading streams by eliminating the need to remember wallet/token addresses or type stream IDs. Here's a simplified description of the features:

1. Creating streams: You can easily create streams by copying the recipient address from select account dropdown and pasting it. Additionally, you can choose the desired token and specify the flow rate in a user-friendly "tokens per month" format.

2. Updating streams: To update a stream, you can simply click the edit button of the desired stream. There's no need to input the stream ID or sender/receiver addresses. Just enter the new flow rate and confirm the update.

3. Deleting streams: Deleting a stream is straightforward. By clicking the delete button of a specific stream, you can remove it without the hassle of entering sender/receiver addresses.

4. View stream details: You have the ability to access and review essential details about your streams. This includes information such as the token being used, recipient address, flow rate, stream type, last updated timestamp, and more. This comprehensive view allows you to easily track and understand the characteristics of each stream.

5. Filter and search streams: The dashboard offers a convenient way to filter and search for specific streams based on various criteria. You can apply filters based on the token being used, recipient address, flow rate, stream type. This functionality enables you to quickly locate and manage streams based on specific parameters, enhancing efficiency and streamlining the workflow.

Getting Started

Prerequisites

1. Deploying the Superfluid Framework locally:

Before starting with the Developer-Mode Dashboard, you will need to deploy the Superfluid contracts on your local blockchain. Here are the steps to do this:

  1. Install required dependencies:
npm install
  1. Start a local blockchain using Hardhat:
npx hardhat node
  1. Deploy the Superfluid contracts:
npx hardhat run scripts/deploy.js --network localhost

2. Deploying Subgraph Locally:

Next, you will need to deploy the Superfluid subgraph locally. Here are the steps to do this:

  1. Start local docker containers:
docker-compose up -d
  1. Generate code for the subgraph:
npm run codegen

Note: Wait for a few seconds to ensure that the containers have started completely before running next commands.

  1. Create Subgraph and deploy it locally:
npm run create-local
npm run deploy-local

3. Starting the Client Application (Optional):

Note: Running the client application is optional. You can use this deployed frontend directly. Just ensure that your blockchain is running on port 8545 and that the framework and subgraph are deployed (following the previous steps).

Finally, you will need to start the client application. Here are the steps to do this:

  1. Navigate to the client directory and install required dependencies:
cd client
npm install
  1. Start the client application:
npm run dev
  1. Navigate to http://localhost:3000/ and choose an account to use from dropdown and connect. Now, You can create, update, and delete, view, query, search streams on your local Superfluid instance with ease.

That's it! You are now ready to use the Developer-Mode Dashboard for Superfluid on your local blockchain.

Demo

ssd-demo.mp4

Troubleshooting

  1. If you encounter any issues deploying the Superfluid contracts, make sure you have a local blockchain running on port 8545 and that you have started a Hardhat node using npx hardhat node. Check Hardhat errors and try running npx hardhat clean and then npx hardhat node again. Rerun the deploy script: npx hardhat run scripts/deploy.js --network localhost.

  2. If you encounter any issues deploying the Superfluid subgraph, make sure you have started the local docker containers using docker-compose up -d. Wait for a few seconds to ensure that the containers have started completely before running next commands. This will give them enough time to initialize and set up the required services. Make sure you have generated the subgraph code using npm run codegen. Check Docker container logs for errors: docker logs <container-name>. If you are still having issues, kill the docker containers using docker-compose down and try again.

Credits & Resources:

Safety

This is experimental software and subject to change over time.

This is a proof of concept and is not ready for production use. It is not audited and has not been tested for security. Use at your own risk. I do not give any warranties and will not be liable for any loss incurred through any use of this codebase.

License

This project is licensed under the MIT License - see the LICENSE file for details