96183bea36
* begin capsule workflow * remove workflow file we don't want to run while debugging * vheckout all require repos * checkout repos to a directory each * correct branch names * rename workflow * fix incorrecr branch name * begin building binaries * typo * remove tests we don't want running while debugging * remove tests we don't want running while debugging * typo * incorrect path * comment out frontend checkout * don't install as not done in example script * add required environement variables * change paths * comment out FEM checkout * check binary built properly * path stuff * silly mistake * use relaive path * correct working directory * fix all paths * debugging * bump go verion * fix path * fix all paths * fix cannot find config error * add back in fe stuff * move cehckout to where it is used * revert accidentally committed change * try install over build * use v3 of action * export as per action * debugging * don't pass path to install * chnage go install * change order * pwd * pwd * see what happens without dn * don't use relative path * build correct paths * remove checks as working * make epxlorer run against locla capsule * fix incorrect env file * fix tests * fixing tests * trying for green run * trying for green run * bump timeout * check tm endpoints * configure to use the second tender mint node * ci: add logs out * ci: change paht * ci: set env var correctly * ci: remove wait for blockChain request * ci: make test value assertions more robust * ci: make test value assertions more robust * chore: minor typo * ci: add back test and lint scripts * ci: comment out unused pipeline for now * ci: break up job into steps * ci: run all tests and pray it works * ci: just use local vega wallet * ci: not building it any more, use go installed bin * ci: derive hashes properly * ci: move existing folow into nightly * ci: run nightly for all tests * ci: use install bins * ci: add missing flag * ci: gobin * ci: debugging * ci: echo gopath * ci: wrong syntax? * ci: one last time? * ci: try something else * ci: try other things * ci: again * ci: move var to github env * ci: set gobin * ci: syntax * ci: test out nightly * ci: switch back nightly to posix * ci: force network bootstrap * ci: fix stupid mistake, pass falg to command not name * ci: put test back * ci: run on push as well as on pr * ci: always upload logs if possible * ci: import config from capsule rather than testnet * Update apps/explorer-e2e/cypress.json * test: fix failing test now we are using binaries * ci: correct URL |
||
|---|---|---|
| .github | ||
| .husky | ||
| .storybook | ||
| .vscode | ||
| apps | ||
| libs | ||
| scripts | ||
| tools | ||
| .editorconfig | ||
| .eslintrc.json | ||
| .gitattributes | ||
| .gitignore | ||
| .nvmrc | ||
| .prettierignore | ||
| .prettierrc | ||
| .sentryclirc | ||
| babel.config.json | ||
| CODEOWNERS | ||
| commitlint.config.js | ||
| jest.config.js | ||
| jest.preset.js | ||
| LICENSE | ||
| migrations.json | ||
| netlify.toml | ||
| nx.json | ||
| package.json | ||
| README.md | ||
| tsconfig.base.json | ||
| workspace.json | ||
| yarn.lock | ||
Vega front-end monorepo
The front-end monorepo provides a toolkit for building apps that interact with Vega, as well as the apps themselves.
This repository is managed using Nx.
🔎 Applications in this repo
Block explorer
The Vega block explorer provides an interface that allows users to search for and see transactions, blocks, parties, assets, markets and more on the Vega chain.
Trading UI
The trading interface built based on a component toolkit. It will provide a way for participants to interact with markets and provide resources for others to build additional open-source user interfaces.
Token
The utlity dApp for interacting with the Vega token and using its' utility. This includes; delegation, nomination, governance and redemption of tokens.
Explorer
The block explorer for the Vega network, showing details of raw chain states and the state of markets on the Vega network.
Stats
An application for the status of the Vega network. Showing block height and other network activity.
Static
Hosting for static content being shared across apps, for example fonts.
🧱 Libraries in this repo
UI toolkit
The UI toolkit contains a set of components used to build interfaces that can interact with the Vega protocol, and follow the design style of the project.
It contains a storybook that can be served with yarn nx run ui-toolkit:storybook.
Tailwind CSS config
The Tailwind CSS config contains theme that align default config with Vega design system.
Cypress
For shared Cypress logic, commands and steps.
Web3
A ulitity library for connecting to the Ethereum network and interacting with Vega Web3 contracts.
React Helpers
Generic react helpers that can be used across multilpe applications, along with other utilties.
💻 Develop
Set up
Check you have the correct version of Node. You can install NVM to switch between node versions. Then NVM install.
Before you build you will need to yarn install in the root directory.
The repository includes a number of template .env files for different networks. Copy from these to the .env file before serve to launch app with different network. You can serve any application with yarn nx run <name-of-app>:serve.
Build
Run nx build my-app to build the project. The build artifacts will be stored in the dist/ directory. Use the --prod flag for a production build.
Run nx serve my-app for a dev server. Navigate to the port specified in app/<project-name>/project.json. The app will automatically reload if you change any of the source files.
Using Apollo GraphQL and Generate Types
In order to generate the schemas for your GraphQL queries, you can run nx run types:generate.
If it is the first time you are running the command, make sure you are setting up the environment variable from apollo.config.js.
export NX_VEGA_URL=https://lb.testnet.vega.xyz/query
yarn nx run types:generate
Running tests
Run yarn nx run <my-app>-e2e:e2e to execute the e2e tests with cypress, or nx affected:e2e will execute just the end-to-end tests affected by a change. You can use the --watch flag to open the cypress tests UI in watch mode, see cypress executor for all CLI flags.
Run nx test my-app to execute the unit tests with Jest, or nx affected:test to execute just unit tests affected by a change. You can also use --watch with these test to run jest in watch mode, see Jest executor for all CLI flags.
Trading app E2E tests
To run tests locally using your own wallets you can add the following environment variables to cypress.json
- Change
TRADING_TEST_VEGA_WALLET_NAMEto your Vega wallet name - Add
TRADING_TEST_VEGA_WALLET_PASSPHRASEas your wallet passphrase - Add
ETH_WALLET_MNEMONICas your Ethereum wallet mnemonic
Formatting
In CI linting, formatting and also run. These checks can be seen in the CI workflow file.
- To fix linting errors locally run
yarn nx lint --fix - To fix formatting errors local run
yarn nx format - For either command you may use
--allto run across the entire repository
Further help with Nx
Visit the Nx Documentation to learn more.
Vegacapsule
Explorer
Follow the following steps to start using a local network with the Vega Explorer:
- Prepare vegacapsule. Follow the Vegacapsule instructions
- Build the explorer frontend application
- Start the explorer frontend application with the
.env.vegacapsuleenv file - Go to http://localhost:3000 in your browser
If you simply want to run Explorer locally, without using a local network:
cd apps/explorer && cp .env.testnet .env.local
yarn nx run explorer:serve