This is a DePIN project in the Solana Blockchain that simulates a network where multiple virtual energy assets are registered, allowing users to rent these devices with blockchain transactions.
This diagram illustrates how the components would communicate in a real-world scenario, with a real energy device, such as a charging point.
This diagram illustrates how the components communicate in the simulation present in this project.
- Solana
- Solana Pay
- Rust (Smart Contract)
- Anchor
- TypeScript
- Next.js
- Register your energy device: By registering your energy device into the network, is it possible to securely rent it for your users.
- Rent the energy device to other users: Let users pay for using your device for a given amount of time by using Solana Pay!
This step describes the prerequisites and install steps for the libraries needed to build and run the project.
First of all, you must clone this repository:
git clone https://github.com/andrewlod/decentralized-energy-grid-simulation.gitThen install all dependencies:
cd decentralized-energy-grid-simulation
# Install Node.js dependencies
yarn install
# Install Cargo dependencies and build the Rust project
anchor buildThe Next.js app uses environment variables on both the non-production and the production environments. In order to setup the environment variables, create a .env file in the app/energy-grid directory. You can use the following template as a starting point:
# Backend
NODE_ENV=development
ICON_URL=https://example.com/example.svg
ICON_LABEL=My Transaction
HOURLY_PRICE=0.0005
MERCHANT_SECRET_KEY=<paste your JSON private key here> # WARNING: THIS IS SENSITIVE DATA
CONNECTION_URL=https://api.devnet.solana.com
ENERGY_DEVICE_NAME=test
ENERGY_DEVICE_OUTPUT_POWER=1100
ENERGY_DEVICE_CAPACITY=50000
ENERGY_DEVICE_LATITUDE=-25.4186261
ENERGY_DEVICE_LONGITUDE=-49.2377127
# Frontend
NEXT_PUBLIC_CONNECTION_URL=https://api.devnet.solana.com
NEXT_PUBLIC_MERCHANT_ADDRESS=<paste the merchant public key here>
NEXT_PUBLIC_ENERGY_DEVICE_NAME=test # Same as ENERGY_DEVICE_NAMEIn order to build and deploy the application in your development environment with the Solana devnet, run the following commands:
# Generate the binary on-chain program
anchor build
# Deploy the program to the devnet
anchor deploy --provider.cluster devnetThen run the Next.js app. Make sure to use an HTTPS connection as Solana Pay only accepts HTTPS endpoints. If you are using localhost, you may use tools such as ngrok to allow your application to be available in an HTTPS endpoint.
# Start Next.js app
cd app/energy-grid
yarn dev -H 0.0.0.0
# In another terminal, expose your port to ngrok
ngrok http 3000Then access the endpoint shown on the ngrok window to test the app.
In order to build and deploy the application in your development environment with the Solana mainnet, run the following commands:
# Generate the binary on-chain program
anchor build
# Deploy the program to the mainnet
anchor deploy --provider.cluster mainnetThen, deploy the backend server according to your needs. An example of a backend/frontend server is located in the /app folder.
In order to build and test the application in your development environment with a Solana localnet, run the following commands:
# Generate the binary on-chain program
anchor build
# Run TypeScript tests
anchor testThis section describes features that are either work-in-progress or will be implemented in the future. Features are sorted by priority.
- 🚧: Work-in-progress
- ❌: Not yet started
| Feature | Status |
|---|
- Andre Wlodkovski - @andrewlod
This project is licensed under the MIT License - see the LICENSE file for details.
The video below showcases how the project works and how it could be used in a real-world scenario.
