This project is for the blockchain application My Dapp. It contains code for the Smart Contract, web-based dapp and NodeJS server.
In order to develop and build "My Dapp," the following pre-requisites must be installed:
- Visual Studio Code (or any IDE for editing Javascript)
- NodeJS
- Yarn (DappStarter uses Yarn Workspaces)
- Solana CLI Tools
- Rust (see "Dependency Guides" at the end for help installing)
$ node --version
$ npm --version
$ rustup --version
$ rustc --version
$ cargo --version
$ solana --version
Using a terminal (or command prompt), change to the folder containing the project files and type: yarn
This will fetch all required dependencies. The process will take 1-3 minutes and while it is in progress you can move on to the next step.
You might see failures related to the node-gyp
package when Yarn installs dependencies.
These failures occur because the node-gyp package requires certain additional build tools
to be installed on your computer. Follow the instructions for adding build tools and then try running yarn
again.
Using a terminal (or command prompt), change to the folder containing the project files and type: yarn start
This will run all the dev scripts in each project package.json.
The first time you run yarn start
there are a fair number of Rust libraries that are
downloaded and pre-compiled. As a result, it may be take from 5-10 mins. before the
dapp is compiled and launched the first time. On subsequent compilations, the build
time will only be a few seconds.
Here are the locations of some important files:
- Program Code: packages/dapplib/programs/src/lib.rs
- Dapp Library: packages/dapplib/src/lib/dapp-lib.js
- Solana Wrapper: packages/dapplib/src/lib/solana.js
- Blockchain Interactions: packages/dapplib/src/lib/blockchain.js
- Data Layouts: packages/dapplib/src/scripts/layouts.js
- Migration Script: packages/dapplib/src/scripts/migrate.js
To view your dapp, open your browser to http://localhost:5000
We
This section contains installation guides for common dev environments.
(Source: Solana) We suggest that you install Rust using the 'rustup' tool. Rustup will install the latest version of Rust, Cargo, and the other binaries.
Follow the instructions at Installing Rust.
For Mac users, Homebrew is also an option. The Mac Homebrew command is brew install rustup
and then
rustup-init
. See Mac Setup &
Installing Rust for more details.
After installation, you should have rustc
, cargo
, & rustup
. You should
also have ~/.cargo/bin
in your PATH environment variable.