64b4538438 | ||
---|---|---|
back-end | ||
config | ||
contracts | ||
public | ||
src | ||
test | ||
utils | ||
.editorconfig | ||
.eslintrc.json | ||
.gitattributes | ||
.gitignore | ||
.npmrc | ||
.prettierrc | ||
.soliumignore | ||
.soliumrc.json | ||
Discover_Specification.md | ||
LICENSE | ||
README.md | ||
build.sh | ||
embark.json | ||
package.json | ||
shared.testnet.chains.json | ||
yarn.lock |
README.md
Discover
Discover new and useful DApps that are mobile-friendly and easy to use. Viewing curated information does not require any special tools, though effecting the way information is ranked will require a web3 wallet, whether that is Status, MetaMask, Trust, Brave or whichever one you prefer.
Available Scripts
This project is based on Embark v4.0.1, with a few things customised for React. Currently, you'll need to run the app and Embark separately, in different tabs in your terminal.
npm run build
Builds the app into the build
directory.
Running and building the app
Step 1 Build the contracts and the embark artifacts
Step 1.1 Check your contracts.js
- Check the
config/contracts.js
file in order for embark to work with the correct contract instance. Starting from line 76, replace your local addresses forMiniMeToken
andDiscover
with
MiniMeToken: {
address: '0x25B1bD06fBfC2CbDbFc174e10f1B78b1c91cc77B'
},
Discover: { address: '0x17e7a7330d23fc6a2ab8578a627408f815396662' },
If you need to deploy new version of the Discover contract the last line read the part below:
MiniMeToken: {
address: '0x25B1bD06fBfC2CbDbFc174e10f1B78b1c91cc77B'
},
Discover: {
args: ['$MiniMeToken'],
},
- Remove any existing
.embark
directory and runembark run testnet --noserver
. Once all deployments are done, you can use this etherscan address to check the address of the contract you last deployed and place it in place of0xc13711209ba3d5b4cbbcb45f7f64643abb267dbd
of the original configuration.
https://ropsten.etherscan.io/address/0x65767f95799109ba028e0397add89b0ef637e444
Step 1.2 Fix embark configuration
In embarkjs.js line 776. If you find this._ipfsConnection.id()
-> change it to this._ipfsConnection.version()
This is needed because Infura's IPFS has deprecated id
endpoint, but it was used in embark in order to check if the Infura IPFS API is active.. The workaround above do the same as the deprecated functionality.
Step 1.3 Generate the embark contract artifacts
Run embark build
in order to (re)generate src/embarkArtifacts/contracts
directory.
Note your index.js
file inside. If it is broken (ending by trailing '
instead of }
), fix it by replacing the last comma with }
.
Observe that you find near the beginning of the Discover.js and MiniMeToken.js files the addresses you supplied in Step 1.1
Step 2. Run the client side app localy.
Run the client side application via npm run start
.
Open http://localhost:3000 to view it in the browser. The page will reload if you make edits. You will also see any lint errors in the console.
Important! If you get can't establish a connection to a node
error, try to open http://localhost:3000 in Chrome.
Step 3 - Run the unit tests
Use embark test
Will compile your contracts, with hot-reloading, and let you test them locally to your heart's content.
Step 4 - Building for deployment
Run the build procedure via npm run build
. Once you are done, copy the contents of the build directory, in the frontend
directory in the branch called app-deployment
.
Deployments Steps AWS
-
Zip everything in the app-deployment branch (maybe omit node_modules and
deployment
directories) -
Click Upload and deploy button in the middle of the screen.
-
Choose the .zip file containing the code
-
Change the version if want to keep some exact numbering
-
Click Deploy
Changing .env variables in AWS
If you've changed some smart contracts you need to change their addresses in the env variables.
- Go to AWS Configuration and on Software section click Modify
- Scroll down and find Environment Properties
- Change whatever property needs changing
- Click Apply at the bottom right
Running slither
slither . --exclude naming-convention --filter-paths token
Make sure you get TrailofBits' latest static analysis tool, and do your own static analysis on the relevant contracts that will be deployed for Discover.