arbitrum-dapp-skill

# Arbitrum dApp Development

## Stack

| Layer | Tool | Notes |
|-------|------|-------|
| Smart contracts (Rust) | `stylus-sdk` v0.10+ | Compiled to WASM, runs on Stylus VM |
| Smart contracts (Solidity) | Solidity 0.8.x + Foundry | Standard EVM path on Arbitrum |
| Local node | `nitro-devnode` | Docker-based local Arbitrum chain |
| Contract CLI | `cargo-stylus` | Check, deploy, export-abi for Stylus |
| Contract toolchain | Foundry (`forge`, `cast`, `anvil`) | Build, test, deploy, interact for Solidity |
| Frontend | React / Next.js + viem + wagmi | viem for all chain interaction |
| Package manager | pnpm | Workspace-friendly, fast |

## Decision Flow

When starting a new contract:

1. **Need max performance / lower gas?** → Stylus Rust. See `references/stylus-rust-contracts.md`.
2. **Need broad tooling compatibility / rapid prototyping?** → Solidity. See `references/solidity-contracts.md`.
3. **Hybrid?** → Use both. Stylus and Solidity contracts are fully interoperable on Arbitrum.

## Project Scaffolding

### Monorepo layout (recommended)

```
my-arbitrum-dapp/
├── apps/
│   ├── frontend/            # React / Next.js app
│   ├── contracts-stylus/    # Rust Stylus contracts
│   ├── contracts-solidity/  # Foundry Solidity contracts
│   └── nitro-devnode/       # Local dev chain (git submodule)
├── pnpm-workspace.yaml
└── package.json
```

### Bootstrap steps

```bash
# 1. Create workspace
mkdir my-arbitrum-dapp && cd my-arbitrum-dapp
pnpm init
printf "packages:\n  - 'apps/*'\n" > pnpm-workspace.yaml

# 2. Local devnode
git clone https://github.com/OffchainLabs/nitro-devnode.git apps/nitro-devnode
cd apps/nitro-devnode && ./run-dev-node.sh && cd ../..

# 3a. Stylus contract
cargo stylus new apps/contracts-stylus

# 3b. Solidity contract
cd apps && forge init contracts-solidity && cd ..

# 4. Frontend
pnpm create next-app apps/frontend --typescript
cd apps/frontend
pnpm add viem wagmi @tanstack/react-query
```

## Core Workflow

### Stylus Rust

```bash
# Validate...

<p align="center">
  <img src=".github/banner.svg" alt="arbitrum-dapp-skill" width="100%">
</p>

<p align="center">
  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square" alt="License: MIT"></a>
  <a href="https://www.rust-lang.org"><img src="https://img.shields.io/badge/Rust-1.81+-orange.svg?style=flat-square&logo=rust" alt="Rust"></a>
  <a href="https://soliditylang.org/"><img src="https://img.shields.io/badge/Solidity-0.8+-363636.svg?style=flat-square&logo=solidity" alt="Solidity"></a>
  <a href="https://arbitrum.io"><img src="https://img.shields.io/badge/Arbitrum-Stylus-28A0F0.svg?style=flat-square" alt="Arbitrum Stylus"></a>
  <a href="https://book.getfoundry.sh/"><img src="https://img.shields.io/badge/Built%20with-Foundry-FFDB1C.svg?style=flat-square" alt="Foundry"></a>
  <a href="http://makeapullrequest.com"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square" alt="PRs Welcome"></a>
  <a href="https://clawhub.ai/hummusonrails/arbitrum-dapp-skill"><img src="https://img.shields.io/badge/ClawHub-arbitrum--dapp--skill-FF6B4A.svg?style=flat-square" alt="ClawHub"></a>
</p>

<p align="center">
  <strong>A <a href="https://github.com/anthropics/skills">Claude Code skill</a> for building high-performance dApps on Arbitrum with Stylus Rust and Solidity.</strong>
  <br>
  <a href="https://www.youtube.com/watch?v=vsejiaOTmJA">Demo</a> · <a href="https://hummusonrails.github.io/arbitrum-dapp-skill?ref=github-readme">Documentation</a> · <a href="#quick-start">Quick Start</a> · <a href="https://github.com/hummusonrails/arbitrum-dapp-skill/issues">Report a Bug</a>
</p>

<p align="center">
  <a href="https://www.youtube.com/watch?v=vsejiaOTmJA">
    <img src=".github/video-thumbnail.png" alt="Watch the demo on YouTube" width="600">
  </a>
</p>

## What it does

This skill gives Claude Code deep knowledge of the Arbitrum development stack so it can help you:

- **Scaffold...