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

• 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

• cargo / rust

• 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

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

CLUSTER=testnet make localnet

CLUSTER variables can be either mainnet, testnet or localnet, which corresponding to RENEC cluster url. Default CLUSTER is testnet.

• To gen a new wallet, run:

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

If not passing name parameter, the default name of the wallet will be id. 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>"

• To build program:

make build

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.

• To deploy

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

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

• 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.

• 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.

cd app

yarn && yarn dev