Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dionysuzx/hello-prague
https://github.com/dionysuzx/hello-prague
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/dionysuzx/hello-prague
- Owner: dionysuzx
- License: mit
- Created: 2023-06-10T13:51:07.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-06-10T13:51:12.000Z (over 1 year ago)
- Last Synced: 2024-10-17T13:33:16.779Z (3 months ago)
- Language: TypeScript
- Homepage: https://hello-prague.vercel.app
- Size: 79.1 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
## What's included
- SvelteKit app
- Auto-generated and fully-typed ABIs using wagmi-generate
- Web3modal connect button using wagmi-core
- Foundry contracts
- Configured for easy multi-chain deployments
## Create your dapp with one-click deploy button (recommended)
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fd1onys1us%2Fdapp-slaps&env=VITE_WEB3MODAL_PROJECT_ID&envDescription=Retrieve%20a%20Web3Modal%20project%20ID%20%E2%86%92&envLink=https%3A%2F%2Fcloud.walletconnect.com%2Fsign-in&root-directory=packages%2Fapp)
1. Click the **Deploy with Vercel** button above
2. Clone and cd the repo that was created by Vercel using `git clone && cd `
3. Install Foundry dependency because Vercel doesn't clone the submodules: `forge install foundry-rs/forge-std` (must have foundry installed, see here: https://book.getfoundry.sh/getting-started/installation)
4. Install packages and copy .env.example files:
`sh setup.sh`
5. Set mnemonic phrase in root `.env` for test accounts ([generate a bip39 mnemonic](https://iancoleman.io/bip39/))
6. Set web3modal project id in `.env` ([obtain a project id for web3modal](https://cloud.walletconnect.com/sign-in))
## Create your dapp manually
1. Clone/fork the repo:
`git clone https://github.com/d1onys1us/dapp-slaps.git`
2. Install packages and copy .env.example files:
`cd dapp-slaps && sh setup.sh`
3. Set mnemonic phrase in root `.env` for test accounts ([generate a bip39 mnemonic](https://iancoleman.io/bip39/))
4. Set web3modal project id in `.env` ([obtain a project id for web3modal](https://cloud.walletconnect.com/sign-in))
5. Source environment vars: `source .env`
6. (optional) if using vscode check the vscode config section
## Start the development environment
> You will have three development windows, start them all and source all .env files with `source .env && source packages/app/.env`.
1. Start local chain: `anvil -m $MNEMONIC`
2. Deploy the Foo contract: `forge script Deploy --broadcast --rpc-url $FOUNDRY && pnpm -F app wagmi:generate`
3. Start app: `pnpm -F app dev`
## Get testnet ETH
### Sepolia
- [Receive Ether on Sepolia](https://sepolia-faucet.pk910.de/)
### Goerli
- [Receive Ether on Goerli](https://goerlifaucet.com/)
## Common app commands
#### Start the app locally
```sh
pnpm -F app dev
```
#### Generate typed ABIs from Foundry contracts
```sh
pnpm -F app wagmi
```
## Common Foundry commands
#### Install a Foundry package
1. Start by installing the package (example: openzeppelin-contracts):
```sh
forge install OpenZeppelin/openzeppelin-contracts
```
2. Regenerate the remappings for the contract imports (run this from the project root):
```sh
forge remappings > remappings.txt
```
#### Start local anvil chain from mnemonic
```sh
anvil -m $MNEMONIC
```
#### Deploy contracts to some chain and generate types
```sh
forge script Deploy --broadcast --rpc-url $FOUNDRY && pnpm -F app wagmi:generate
```
## Troubleshooting
- Try resetting account in MetaMask
- Try clearing all browser storage
- Try disconnecting account and reconnecting
- Ensure all env vars are set
## Acknowledgements
- PaulRBerg Foundry template: https://github.com/PaulRBerg/foundry-template
- Taiko monorepo: https://github.com/taikoxyz/taiko-mono
- Optimism Starter: https://github.com/ethereum-optimism/optimism-starter
- ScaffoldEth2: https://github.com/scaffold-eth/se-2