Dapp-starter

This repo provides a starting point for building a dapp on the renec blockchain.

Overview

• Project Structure
• Prerequiresites
• Dependencies
  • Installation
  • Setup wallet
• How to use ?
  • Rpc Endpoint
  • Build & Deploy
  • FE & Dapp
• Port Dapp from Solana
• Notes

Project Structure

• programs: This folder contains the logic code for the program. It uses anchor framework to build the program.
• app: This folder contains FE code for the dapp. It uses next-js and typescript to build the FE.
• dev-scripts: This folder contains scripts to build and deploy the program, and to setup the FE using bash-scripts. Support running on Unix environemnt.
• tests: This folder contains tests for the program

Prerequisite

• For Linux user:

 sudo apt-get update && sudo apt-get upgrade && sudo apt-get install -y pkg-config build-essential libudev-dev
 sudo apt install libssl-dev

• For Mac user:

brew install openssl

• For Windows user: must install make
  • Install Chocolatey from here https://chocolatey.org/install
  • Then run choco install make from a fresh terminal.

Program Scripts

Setup environemnts

• To setup program dependencies, run:

make install-deps

This will install the anchor and solana cli if needed. Default solana 1.14.6, anchor 0.25.0

To use different version compatible with renec cluster, set the CLUSTER and ANCHOR_VERSION environment variables and run the command
For example:

CLUSTER=mainnet ANCHOR_VERSION=0.20.1 make install-deps

CLUSTER can either be mainnet, testnet or localnet. By setting the cluster correctly, the installer will set the corresponding cli for program's interaction.

• To run a localnet that has the same version as renec-mainnet, run;

make localnet

Setup wallets

• To gen a new wallet, run:

make gen-wallet name="<wallet-name>"

The wallets' screte keys will be stored in ./wallets folder.

• To import an existing wallet, run:

make import-wallet name="<wallet-name>"

• To request faucet token in testnet or localnet, run:

make faucet amount=1  name="<wallet-name>"

How to use ?

Rpc Endpoint

• Some free RPC providers:
  • Mainnet
    • https://api-mainnet-beta.renec.foundation:8899/
  • Testnet
    • https://api-testnet.renec.foundation:8899/

Build & Deploy

• Build program:

make build

Notes:

• This command will generate the program keypair if needed, and replace it inside programs/dapp-starter/src/lib.rs file. Then it will build the program and generate program so file.

• For FE interaction, this script copies the dapp_starter.json, dapp_starter.ts and replace program_id into the config.json file in app/src/artifacts folder.

• Deploy program:

CLUSTER=mainnet make deploy name="<wallet-name>"

Notes:

This command deploy the program, under .wallets/<wallet-name>.json authority. The program will be deploy to CLUSTER env, which could either be localnet, mainnet or testnet

Frontend

• The frontend is built with next-js and typescript. It uses @project-serum/anchor to interact with the program.
  

• The FE uses daemon-wallet to connect with renec-blockchain.

• The provided program and the FE provide a simple counter program, which allows users to initialize a counter, and increment the count in that counter.

Presequisites

• Node.js 16.8.0 or newer
• build and deploy the program to the renec testnet. Make sure that you've run make build and CLUSTER=testnet make deploy before running the frontend.

Build and run

cd app

yarn && yarn dev

Port Dapp from Solana

To reduce the time to convert and rebuild programs from solana. We have supported scripts to quickly re-deploy programs to renc from previously built programs.

Bash script params annotation:    - program_file_path: Path to the program file used to deploy on Solana    - keypair_path: Path to the keypair used to deploy on Solana    - program_id_keypair: Path to the program id keypair used to deploy on Solana Deploy on Renec-Testnet

   CLUSTER=testnet make port-dapp program_file_path=path/to/program_file.so keypair_path=path/to/wallet.json program_id_keypair=path/tp/program-id/keypair.json

Deploy on Renec-Mainnet

   CLUSTER=mainnet make port-dapp program_file_path=path/to/program_file.so keypair_path=path/to/wallet.json progran_id_keypair=path/tp/program-id/keypair.json

Notes