Decentralized interfaces into the Webb protocol
Table of Contents
This is a monorepo for decentralized interfaces in the Webb protocol. It uses nx.dev for fast and extensible building. The apps
directory contains the protocol's interfaces while libs
contains the necessary code and logic.
This repository makes use of yarn, nodejs, and requires version node v18. To install node.js binaries, installers, and source tarballs, please visit https://nodejs.org/en/download/. Once node.js is installed you may proceed to install yarn:
npm install --global yarn
Great! Now your Node environment is ready!
- bridge-dapp: an interface for interacting and bridging assets cross-chain using Webb's Asset Protocol.
- faucet: an interface for requesting cryptocurrencies (assets) on the Webb Protocol System.
- hubble-stats: an interface for displaying statistical data of the Cross-chain Bridging System.
- stats-dapp: an interface for displaying statistical data of Webb's Tangle Network (DKG system).
- tangle-website: an interface for the Tangle ecosystem and development.
- webbsite: an interface for the Webb ecosystem and development.
abstract-api-provider
: a collection of base and abstract classes that unify the API across multiple providers.api-provider-environment
: contains the React context definitions, the app event, and functions for handling interactive feedback errors for the bridge app.browser-utils
: contains all the browser utility functions, such as fetch with caching, download file and string, the customized logger class, get browser platform, and the storage factory function for interacting with local storage.dapp-config
: contains all configurations (chains, wallets, etc.) for the bridge dApp.dapp-types
: contains all the sharable TypeScript types and interfaces across the apps.icons
: contains all the sharable icons across the apps.note-manager
: contains all the logic for storing note account data.polkadot-api-provider
: the Substrate (or Polkadot) provider for the bridge.react-hooks
: contains all the sharable hooks across the apps.relayer-manager-factory
: contains all the logic for interacting with the relayer.tailwind-preset
: the Webb TailwindCSS preset for all the apps.web3-api-provider
: the EVM provider for the bridge.- webb-ui-components: a collection of reusable components for building interfaces quickly.
The following instructions outlines how to run Webb Dapp test suite.
yarn test
To start Storybook for component library
-
Install dependencies by
yarn
yarn install
-
Start the storybook:
yarn nx storybook webb-ui-components
Visit https://localhost:4400/
to see the Webb Component Library!
Interested in contributing to the Webb Dapp interface? Thank you so much for your interest! We are always appreciative for contributions from the open-source community!
If you would like to contribute, please refer to our Contribution Guide for instructions. We are excited for your first contribution!
Please ensure you lint and format your changes prior to opening a PR.
To lint:
yarn lint
To Format:
yarn format
To Build:
yarn build
Licensed under Apache 2.0 license.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache 2.0 license, shall be licensed as above, without any additional terms or conditions.
If you need help or you want to additional information please:
- Refer to the Webb Official Documentation.
- If you have feedback on how to improve the Webb Dapp interface or you have a specific question? Check out the Webb Dapp Feedback Discussion.
- If you found a bug please open an issue or join our Discord server to report it.
Follow us at
Share the project link with your network on social media.