Kwenta

A dApp enabling derivatives trading — powered by the Synthetix protocol.

The decentralized trading UI is available at kwenta.eth.limo.

ENS link: kwenta.eth.

The latest IPFS hash can be found under releases.

Contributing

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.

Tech stack

• Next.js
• React
• Redux
• Kwenta SDK
• Styled-Components

Ethereum stack

• ethers.js v5 - Ethereum wallet implementation.
• Rainbowkit - for ethereum wallet onboarding.

Development

• Contributing to the Kwenta frontend - Kwenta Code Style Guidelines
• The devDAO - How to contribute

Install dependencies

pnpm install

Set up environment variables

Copy the .env.local.example file in the packages/app directory to .env.local (which will be ignored by Git):

cd packages/app
cp .env.local.example .env.local

Then, open .env.local and add the missing environment variables:

Required:

• NEXT_PUBLIC_PROVIDER_ID - Specifies the default provider, options are INFURA or BLAST_API
• NEXT_PUBLIC_INFURA_PROJECT_ID - Infura project id (get it from infura.io) or
• NEXT_PUBLIC_BLASTAPI_PROJECT_ID - Blast API project id (get it from blastapi.io)
• NEXT_PUBLIC_SOCKET_API_KEY - Socket API key (get it from socket.tech
• NEXT_PUBLIC_SATSUMA_API_KEY - API key for Satsuma subgraph queries
• NEXT_PUBLIC_THEGRAPH_API_KEY - API key for The Graph's decentralized service
• NEXT_PUBLIC_DEFAULT_PRICE_SERVICE - Specifies the default price server, options are KWENTA or PYTH
• NEXT_PUBLIC_SERVICES_PROXY - Specify Kwenta proxy server

Run

cd packages/app
pnpm dev

Open http://localhost:3000 to view it in the browser.

Build

cd packages/app
pnpm build
pnpm start

Unit Testing

cd packages/app
pnpm test:jest

For unit tests we use a combination of Jest and React Testing Library

Page tests should be added to the testing folder at the root as it is not possible to co-locate tests and pages in nextjs. Other tests should be co-located in a __tests__ folder next to their related file.

Contact

Join the community on the Kwenta Discord server!