Framework for rapid Dapp development.
Simple. Robust. Extendable. Testable.
Introduces great features:
- ๐๏ธ React hooks - Uses React hooks as your primary building ingredient
- ๐ Auto refresh - Refreshes on a new block, wallet change or network change
- ๐ Multicall - Combines multiple blockchain calls into a single multicall
Combines the best practices:
- ๐ง Modern stack - Employs ethers.js, web3-react, multicall & waffle
- ๐ Extendability - Extends easily with custom hooks
- ๐ก Testability - Simple integration tests for UI and blockchain
import { Mainnet } from '@usedapp/core/modal/chain/ethereum'
const config = {
readOnlyChainId: Mainnet.chainId,
readOnlyUrls: {
[Mainnet.chainId]: 'https://mainnet.infura.io/v3/62687d1a985d4508b2b7a24827551934',
},
}
ReactDOM.render(
<DAppProvider config={config}>
<App />
</DAppProvider>,
document.getElementById('root')
)
const STAKING_CONTRACT = '0x00000000219ab540356cBB839Cbe05303d7705Fa'
export function App() {
const { activateBrowserWallet, deactivate, account } = useEthers()
const userBalance = useEtherBalance(account)
const stakingBalance = useEtherBalance(STAKING_CONTRACT)
return (
<div>
{!account && <button onClick={activateBrowserWallet}> Connect </button>}
{account && <button onClick={deactivate}> Disconnect </button>}
{stakingBalance && <p>ETH2 staking balance: {formatEther(stakingBalance)} ETH </p>}
{account && <p>Account: {account}</p>}
{userBalance && <p>Ether balance: {formatEther(userBalance)} ETH </p>}
</div>
)
}
See application here.
For detailed feature walkthrough checkout documentation.
Contributions are always welcome, no matter how large or small. Before contributing, please read the code of conduct and contribution policy.
- Make sure all tests pass.
- Make sure linter passes.
- Make sure you have test coverage for any new features.
To install dependencies type:
yarn
To build project:
yarn build
To run tests type:
yarn test
To run linter type:
yarn lint
Install Sphinx to build documentation:
cd docs
make html
Before building documentation for the first time you may have to install required python packages:
pip3 install -r docs/requirements.txt
useDapp is released under the MIT License.