Agoric React App Starter

This repo helps your start with the development of Agoric dApps. This repo contains:

Local Agoric Chain
Smart Contract that can mint Moola tokens
React App written in TypeScript (built with Vite, not using create-react-app)

Prerequisites

Install Agoric SDK from Agoric repository by executing the following steps:

node --version # 14.15.0 or higher
npm install --global yarn
git clone https://github.com/Agoric/agoric-sdk
cd agoric-sdk
yarn install
yarn build
yarn link-cli ~/bin/agoric
agoric --version
# 0.16.0 or higher should be printed out

For more detail check the Agoric documentation.

Getting Started

Clone or Degit the repository

degit downloads the repo without git history attached to it (without .git file).

Clone

Clone the repo: git clone https://github.com/RBFLabs/agoric-react-app-starter.git
Enter the project folder: cd agoric-react-app-starter

Degit

Install degit: npm install -g degit
Degit the repo: degit https://github.com/RBFLabs/agoric-react-app-starter my-agoric-react-app
Enter the project folder: cd my-agoric-react-app

Deploy the contract and run the React App

In all of the following <github-root> is the directory with the clone of this repository.

Make sure you are running Node 16 (you can use nvm to switch between different Node versions).

1. Run the local Agoric chain

Open terminal #1
cd <github-root>/agoric
agoric install
agoric start --reset

There will be several log messages printed out. Wait until the message

Deployed Wallet!

is printed out.

2. Open Agoric wallet in your browser

When the chain is running, open terminal #2
cd <github-root>/agoric
agoric open

This will open up a new browser tab with the Agoric wallet.

3. Deploy the contract (in the same terminal #2)

cd <github-root>/agoric/contract
yarn install
agoric deploy deploy.js

After successful completion, the deployment script should print out a message that looks like the following:

- SUCCESS! contract code installed on Zoe
-- Contract Name: moolaMinter
-- Installation Board Id: board02021
-- Instance Board Id: board01422
-- Token Issuer Board Id: board04719
-- Token Brand Board Id: board06120
writing .../react-app/src/dAppConstants.mts

This deploys the contract and generates dAppConstants.mts file in react-app/src folder.

4. Run the React App

Open terminal #3

cd <github-root>/react-app
yarn install
yarn run dev

You need to run yarn dev from the root folder, otherwise linked packages in this monorepo will not get resolved properly.

livthomas / agoric-react-app-starter.