deep-stack/wallet-connect-web-examples
3
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
0d0a6d86a5
wallet-connect-web-examples/wallets/react-wallet-eip155
History
renovate[bot] 63e3df65d8
fix(deps): update dependency @nextui-org/react to v1.0.0-beta.13 (#184) 
Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com>
2023-06-19 10:42:14 +02:00
..
public eip155 example (#115) 2023-02-15 17:11:42 +02:00
src chore: updated @walletconnect deps (#164) 2023-05-23 14:42:34 +03:00
.env.local.example eip155 example (#115) 2023-02-15 17:11:42 +02:00
.eslintrc.json eip155 example (#115) 2023-02-15 17:11:42 +02:00
.gitignore eip155 example (#115) 2023-02-15 17:11:42 +02:00
.prettierrc.json eip155 example (#115) 2023-02-15 17:11:42 +02:00
next-env.d.ts eip155 example (#115) 2023-02-15 17:11:42 +02:00
next.config.js eip155 example (#115) 2023-02-15 17:11:42 +02:00
package.json fix(deps): update dependency @nextui-org/react to v1.0.0-beta.13 (#184) 2023-06-19 10:42:14 +02:00
README.md update README (#119) 2023-05-09 17:57:24 +02:00
tsconfig.json eip155 example (#115) 2023-02-15 17:11:42 +02:00
yarn.lock fix(deps): update dependency @nextui-org/react to v1.0.0-beta.13 (#184) 2023-06-19 10:42:14 +02:00

README.md

Wallet Example (React, Typescript, Ethers, NextJS, Cosmos)

This example aims to demonstrate basic and advanced use cases enabled by WalletConnect's Sign SDK.

The wallet implements Sign v1 and v2 side-by-side, to serve as a reference for wallet developers aiming to support both major versions for backwards compatibility. All files containing code for the legacy v1 implementation are prefixed with Legacy....

Please only use this for reference and development purposes, otherwise you are at risk of losing your funds.

Useful links

🔗 Live wallet app - https://react-wallet-eip155.vercel.app/
🔗 Live dapp - https://react-app.walletconnect.com
📚 WalletConnect docs - https://docs.walletconnect.com/2.0

Getting started

Example is built atop of NextJS in order to abstract complexity of setting up bundlers, routing etc. So there are few steps you need to follow in order to set everything up

  1. Go to WalletConnect Cloud and obtain a project id

  2. Add your project details in WalletConnectUtil.ts file

  3. Install dependencies yarn install or npm install

  4. Setup your environment variables

cp .env.local.example .env.local

Your .env.local now contains the following environment variables:

  1. Run yarn dev or npm run dev to start local development

Navigating through example

  1. Initial setup and initializations happen in _app.ts file
  2. WalletConnect client, ethers and cosmos wallets are initialized in useInitialization.ts hook
  3. Subscription and handling of WalletConnect events happens in useWalletConnectEventsManager.ts hook, that opens related Modal views and passes them all necessary data
  4. Modal views are responsible for data display and handling approval or rejection actions
  5. Upon approval or rejection, modals pass the request data to RequestHandlerUtil.ts that performs all necessary work based on the request method and returns formated json rpc result data that can be then used for WalletConnect client responses

Preview of wallet and dapp examples in action

https://user-images.githubusercontent.com/3154053/156764521-3492c232-7a93-47ba-88bd-2cee3f8366d4.mp4