TL;DR:
The Baseball Card Store Dapp sells baseball cards as NFT tokens in exchange for money.
This dapp requires the Fungible Faucet Dappto be running, so please follow the instructions to set up the Fungible Faucet Dapp first and give yourself some tokens. This dapp runs on port 3001, whereas the Fungible Faucet Dapp runs on port 3000.
Install the prerequisites.
Then in a first terminal in the directory where you want to put your dapp, install the dapp:
agoric init --dapp-template dapp-card-store my-card-store
cd my-card-store
agoric install
# The Agoric platform should be already started so there is no need to run `agoric start`In a second terminal, deploy this contract and the API server
agoric deploy contract/deploy.js
agoric deploy api/deploy.jsIn a third terminal,
# Navigate to the `ui` directory and start a local server
cd ui && yarn startThen navigate to http://127.0.0.1:3001.
The Fungible Faucet Dapp is the simplest Agoric Dapp. It demonstrates the three important parts of a dapp and how they should be connected:
- the browser UI (the frontend)
- the API server (the backend)
- the on-chain contract
This dapp starts a local blockchain on your computer, and deploys a basic contract to that blockchain. It does not currently deploy or connect to the Agoric testnet.
This particular dapp UI is written in vanilla JS for simplicity (as opposed to using a framework).
- Navigate to http://127.0.0.1:3001.
- Enter
agoric openin your terminal - A window for your wallet should open.
- Under "Dapps" in the wallet, enable the CardStore Dapp.
- Now you should be able to click on a card to make an offer to buy it.
- Approve the offer in your wallet
- View the card in your wallet.
To learn more about how to build Agoric Dapps, please see the Dapp Guide.
See the Dapp Deployment Guide for how to deploy this Dapp on a public website, such as https://cardstore.testnet.agoric.com/