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)

1. 
2. Clone the repo that was created by Vercel using git clone <REPO_NAME>
3. Install Foundry dependency because Vercel doesn't clone the submodules: forge install foundry-rs/forge-std
4. Install packages and copy .env.example files: cd <REPO_NAME> && sh setup.sh
5. Set mnemonic phrase in root .env for test accounts (generate a bip39 mnemonic)
6. Set web3modal project id in packages/app/.env (obtain a project id for web3modal)
7. Source environment vars: source .env && source packages/app/.env

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)
4. Set web3modal project id in packages/app/.env (obtain a project id for web3modal)
5. Source environment vars: source .env && source packages/app/.env

Start the development environment

1. Start local chain: anvil -m $MNEMONIC
2. Start ABI generation in separate window: pnpm wagmi generate --watch ../contracts/broadcast/
3. Deploy the Foo contract: forge script Deploy --broadcast --rpc-url $FOUNDRY
4. Start app: pnpm -F app dev

Faucet links

Sepolia

• Receive Ether on Sepolia

Taiko

• Receive Ether on Taiko

Common app commands

Start the app locally

pnpm -F app dev

Generate typed ABIs from Foundry contracts

pnpm -F app wagmi-generate

Automatically generate typed ABIs from Foundry deployments

pnpm wagmi generate --watch ../contracts/broadcast/

Common Foundry commands

Install a Foundry package

1. Start by installing the package (example: openzeppelin-contracts):

forge install OpenZeppelin/openzeppelin-contracts

2. Regenerate the remappings for the contract imports (run this from the project root):

forge remappings > remappings.txt

Start local anvil chain from mnemonic

anvil -m $MNEMONIC

Deploy contracts to some chain

Note: some L2s require a --legacy flag if EIP-1559 is not yet supported.

forge script Deploy --broadcast --rpc-url $SEPOLIA

Troubleshooting

• Try resetting account in MetaMask
• Try clearing all browser storage
• Try disconnecting account and reconnecting
• Ensure all env vars are set