This is a basic Agoric Dapp that contains three smart contracts postal-service
, sell-concert-tickets
, and swaparoo
demonstrating different scenarios which can be implemented easily using Agoric SDK. There is also a UI for sell-concert-tickets
contract that a user can use to buy three different types of concert tickets and pay through a wallet extension in the browser.
The following instrucions provide a guide to setup an environment to try dapp-agoric-basics
on your local machine. If you want to try it in cloud environment without any installations or downloads, you can try it in github codespaces.
Make sure all the required dependecies are already installed (including node, nvm, docker, Keplr, and that your node version is set to 18.x.x
by running nvm use 18.20.2
. See a tutorial here on how to install these dependecies.). Here are the steps to run dapp-agoric-basics
:
- run
yarn install
in theagoric-basics
directory, to install dependencies of the Dapp. - run
yarn start:docker
to start Agoric blockchain from the container. - run
yarn docker:logs
to to make sure blocks are being produced by viewing the Docker logs; once your logs resemble the following, stop the logs by pressingctrl+c
.
demo-agd-1 | 2023-12-27T04:08:06.384Z block-manager: block 1003 begin
demo-agd-1 | 2023-12-27T04:08:06.386Z block-manager: block 1003 commit
demo-agd-1 | 2023-12-27T04:08:07.396Z block-manager: block 1004 begin
demo-agd-1 | 2023-12-27T04:08:07.398Z block-manager: block 1004 commit
demo-agd-1 | 2023-12-27T04:08:08.405Z block-manager: block 1005 begin
demo-agd-1 | 2023-12-27T04:08:08.407Z block-manager: block 1005 commit
- run
yarn start:contract
to start the contracts. - run
yarn start:ui
to startsell-concert-tickets
contract UI. - open a browser and navigate to localhost:5173 to interact with the contract via UI.
See a more detailed tutorial.
To perform unit tests:
-run the command yarn test
in the root directory.
To perform end to end test
-run the command yarn test:e2e
in the root directory.
Here are the step-by-step instructions to run/work on dapp-agoric-basic
in github codespaces:
- Go to repo here: https://github.com/Agoric/dapp-agoric-basics/
- Click on
- Click on
Codespaces
tab and create a new Codespace. If you are already using Codespaces on current repo then click the "+" button on top right of theCodespaces
tab to create a new one. - You should see a VSCode environment load in your browser followed by a setup. This should take a few minutes.
- Do
yarn start:docker
followed byyarn docker:logs
- kill it after you seebegin
/commit
. - Do
yarn start:contract
. - Do
yarn start:ui
- a pop-up should appear in bottom right. Click open in browser if needed. - DApp should be load in your browser.
- Connect your Wallet and interact with DApp as usual.
See CONTRIBUTING for more on contributions.