A dApp enabling derivatives trading with infinite liquidity โ powered by the Synthetix protocol.
The trading UI is available on kwenta.io.
ENS link: kwenta.eth.
- Next.js
- React
- React Query
- Recoil
- Unstated-next
- Styled-Components
- Immer
- ethers.js v5 - Ethereum wallet implementation.
- Blocknative Onboard - for ethereum wallet connectivity.
- @synthetixio/contracts-interface - for interactions with the Synthetix protocol.
- @synthetixio/queries - for historical data (powered by TheGraph)
npm install --legacy-peer-deps
Copy the .env.local.example
file in this directory to .env.local
(which will be ignored by Git):
cp .env.local.example .env.local
Then, open .env.local
and add the missing environment variables:
Required:
NEXT_PUBLIC_PORTIS_APP_ID
- Portis app id (get it from portis.io)NEXT_PUBLIC_BN_ONBOARD_API_KEY
- Blocknative Onboard API key (get it from blocknative.com)NEXT_PUBLIC_PROVIDER_ID
- Specifies the default provider, options areINFURA
orBLAST_API
Optional:
NEXT_PUBLIC_INFURA_PROJECT_ID
- Infura project id (get it from infura.io)NEXT_PUBLIC_BLASTAPI_PROJECT_ID
- Blast API project id (get it from blastapi.io)
npm run dev
Open http://localhost:3000 to view it in the browser.
npm run build
npm start
In order to run fully automated end-2-end (e2e) tests Kwenta uses Synpress (a wrapper around Cynpress).
The current e2e tests are written to be run on Optimistic Kovan using Chrome as the browser.
- Download and install Google Chrome
- Setup a test wallet on Optimistic Kovan and fund it with plenty of ETH (to pay for gas) and sUSD
- Prior to running the tests you must set the environment variables below in the shell from which npm is started. Unfortunately, at this time other methods to set said environment variables (eg. through
.env.local
) don't work in conjunction with Synpress.
PRIVATE_KEY=<INSERTPRIVATEKEY>
NETWORK_NAME=OptimisticKovan
RPC_URL=https://kovan.optimism.io
CHAIN_ID=69
BLOCK_EXPLORER=https://kovan-optimistic.etherscan.io
IS_TESTNET=true
A Bash convenience script has been made available here.
- Open bash
- Copy the private key of the test wallet into the file
SYNPRESS_PRIVATEKEY
into the same folder location as the script. While using this method, please don't forget to update your .gitignore file to prevent your private key to be leaked. - Run the following command
source ./synpress-envsetter.sh
npm run build
npm start
npm run test:e2e:only:tests
Kwenta welcomes contributors. Regardless of the time you have available, everyone can provide meaningful contributions to the project by submitting bug reports, feature requests or even the smallest of fixes! To submit your contribution, please fork, fix, commit and create a pull-request describing your work in detail. For more details, please have a look at the Contribution guidelines.
Join the community on the Kwenta Discord server!