Deployment

This guide walks through deploying the core smart contracts to Arbitrum Sepolia using Foundry.

Prerequisites

Create a .env file in the contracts/ directory:

PRIVATE_KEY=your_private_key_here
RPC_URL=https://arb-sepolia.g.alchemy.com/v2/your_api_key
ETHERSCAN_API_KEY=your_arbiscan_api_key_here

cd contracts
forge build

Deploys all three contracts and links them automatically:

forge script script/Deploy.s.sol:DeployMultiverse \
  --rpc-url $RPC_URL \
  --broadcast \
  --verify \
  -vvvv

Use this to update a specific contract.

Deploy Passport:

forge script script/DeployPassport.s.sol:DeployPassport \
  --rpc-url $RPC_URL \
  --broadcast \
  --verify

Deploy Registry:

forge script script/DeployRegistry.s.sol:DeployRegistry \
  --rpc-url $RPC_URL \
  --broadcast \
  --verify

Deploy Bounty (requires REGISTRY_ADDRESS in .env):

forge script script/DeployBounty.s.sol:DeployBounty \
  --rpc-url $RPC_URL \
  --broadcast \
  --verify

Copy the three contract addresses from the deployment output.

Update apps/multiverse-ui/src/config/contracts.ts:

export const REGISTRY_ADDRESS = "0x...";
export const PASSPORT_ADDRESS = "0x...";
export const BOUNTY_ADDRESS   = "0x...";

Copy the JSON ABI files from contracts/out/ into the frontend config so Wagmi can interact with the contracts.

Issue	Solution
Insufficient funds	Ensure your account has at least 0.1 Sepolia ETH
Remappings error	Run `forge remappings > remappings.txt`
Verification failed	Verify manually: `forge verify-contract <address> <ContractName>`