Oasis Trade is a marketplace that allows fully on-chain exchange of ETH and DAI tokens. It uses the matching_market smart contract on the Ethereum blockchain.
To run oasis-market locally, clone the respository and then run from the command line:
yarn
yarn start
master branch - uses .env.production configuration file
dev branch - uses .env.dev configuration file
localhost - uses .env configuration file
Configuration files enable different feature switches for each environment.
To start localnode (ganache) with oasis-cache do:
./scripts/dev.sh
NOTE: you need to have access to private docker images from oasisdexorg.
yarn test
yarn storybook
We use SuperCI + reg-suit + storybook-chrome-screenshot or cypress to conduct visual regression tests with every PR.
To ignore given story use ignoreDuringVisualRegression helper. To create screenshots locally, run: yarn storybook:screenshots.
E2E screenshots are pretty hard to make deterministic. We use two two attribute helpers: data-vis-reg-mask (to mask with black rectangle) and data-vis-reg-hide to hide entirely. Each screenshot is made in multiple sizes.
yarn cypress:dev # to develop tests
yarn cypress:run # to run all tests
By default app will try to load .env.$NODE_ENV file and fallback to .env. You can use ENV env variable to override this mechanism for example: ENV=dev will load .env.dev file.
REACT_APP_INSTANT_ENABLED
Inside the app always check process.env.REACT_APP_INSTANT_ENABLED = "1" do not use any helpers to enable simple dead code elimination done by webpack.
REACT_APP_GRAPHQL_DEVMODE
A parameter forwarded to vulcan0x, useful for development purposes.
REACT_APP_TAX_EXPORTER_ENABLED
Enables Tax Exporter button on Account page. Feature allows user to export trade history into CSV format.
REACT_APP_MARKET_CLOSED
Disables the possibility to place new offers on the market.