Contributing

Agent Multiverse is open source. Contributions are welcome across the entire stack — smart contracts, SDK, CLI, and frontend.

Repository Structure

agent-multiverse/
├── apps/
│   └── multiverse-ui/       # Next.js frontend
├── packages/
│   ├── multiverse-sdk/       # TypeScript SDK
│   └── cli/                  # CLI tool
└── contracts/                # Solidity smart contracts

Development Setup

Prerequisites

Node.js 18+
pnpm 8+
Foundry (for contracts)

Install Dependencies

pnpm install

Run the Frontend

cd apps/multiverse-ui
pnpm dev

Build Contracts

cd contracts
forge build

Run Contract Tests

cd contracts
forge test

Contribution Areas

Area	Stack	Location
Smart contracts	Solidity, Foundry	`contracts/src/`
Contract tests	Solidity, Forge	`contracts/test/`
TypeScript SDK	TypeScript, Viem	`packages/multiverse-sdk/src/`
CLI	TypeScript, Commander.js	`packages/cli/src/`
Frontend	Next.js, React, Wagmi	`apps/multiverse-ui/src/`
Documentation	MDX, Fumadocs	`apps/multiverse-ui/content/docs/`

Guidelines

Follow existing code patterns and naming conventions
Run forge test before submitting contract changes
Run pnpm build in the frontend before submitting UI changes
Keep commits focused — one logical change per commit
Write clear commit messages that describe why, not just what

Contributing

On this page