4 chapters · 21 min
Skills
Chapter 4 of 4
Complete Base development playbook.
1 minute · 323 words · 7 sections
Complete playbook for building on Base L2 — network setup, smart contracts, wallet auth, payments, developer tool attribution, and framework migrations.
| Layer | Default |
|---|---|
| Network | Base Mainnet (8453) / Base Sepolia testnet (84532) |
| Contracts | Foundry (forge create + BaseScan verification) |
| Wallet auth | Base Account SDK (@base-org/account) |
| Payments | Base Pay — USDC, gasless, settles in <2s |
| Transactions | wagmi + viem |
| Attribution | Builder Codes — ERC-8021 via ox/erc8021 |
| RPC (prod) | Dedicated node provider or self-hosted Reth |
cast wallet import for Foundry keystoresgetPaymentStatus() server-side and verify sender, amount, recipient; track processed tx IDs to prevent replay attackssame-origin-allow-popups, not same-originRead the reference for your task:
| Task | When to Use | Reference |
|---|---|---|
| Network config | RPC URLs, chain IDs, explorer links, testnet setup | references/network.md (opens in a new tab) |
| Deploy contracts | Foundry deployment, BaseScan verification, faucet | references/deploy-contracts.md (opens in a new tab) |
| Run a Base node | Self-hosted RPC, Reth, hardware requirements | references/run-node.md (opens in a new tab) |
| Builder Codes | Add ERC-8021 attribution to transactions | references/builder-codes/overview.md |
npx skills add base/skills --skill build-on-baseInstall this repository
npx skills add base/skillsSkills install per repository, not per chapter — the CLI has no documented per-skill form, so we do not print one.
Complete Base development playbook. Covers: (1) Network — Base RPC URLs, chain IDs (8453/84532), explorer config, testnet setup, connect to Base, Base Sepolia; (2) Contracts — Foundry deployment, forge create, BaseScan verification, CDP faucet, testnet ETH, deploy contract to Base; (3) Builder Codes — ERC-8021 attribution suffix, referral fees, dataSuffix for Wagmi/Viem/Privy/ ethers.js/window.ethereum, transaction attribution, earn referral fees, append builder code; (4) Base Account SDK — Sign in with Base (SIWB), Base Pay, USDC payments, paymasters, gas sponsorship, sub-accounts, spend permissions, prolinks, batch transactions, smart wallet, payment link, recurring subscription; (5) Agent registration — trading bots, AI agents, automated senders, ERC-8021 attribution wiring, base.dev API, register agent, builder code registration; (6) Node operation — run Base node, Reth setup, hardware requirements, self-hosted RPC, sync; (7) Migrations — migrate OnchainKit, OnchainKitProvider to WagmiProvider, wagmi migration, remove onchainkit dependency, MiniKit to Farcaster SDK, convert miniapp, Farcaster miniapp to regular app, convert Farcaster miniapp.
The verbatim description from this skill’s front matter — the string an agent matches on to decide whether to load it.
master, last pushed 27 July 2026.SKILL.md, not by matching a directory convention. 2 distinct layouts observed: .claude/skills/*/SKILL.md, skills/*/SKILL.md.h1 and no skipped levels:/base/skills.md, and each chapter at its own URL.| Base Account SDK | SIWB, Base Pay, subscriptions, sub-accounts | references/base-account/overview.md (opens in a new tab) |
| Register AI agent/bot | Register wallet, get builder code, wire attribution | references/agents/register.md (opens in a new tab) |
| Migrate from OnchainKit | OnchainKitProvider → wagmi, wallet/tx components | references/migrations/onchainkit/overview.md (opens in a new tab) |
| MiniKit → Farcaster SDK | @coinbase/onchainkit/minikit → @farcaster/miniapp-sdk | references/migrations/minikit-to-farcaster/overview.md (opens in a new tab) |
| Farcaster miniapp → regular app | Remove Mini App host coupling, convert to Base/web app | references/migrations/farcaster-miniapp-to-app.md (opens in a new tab) |
.md35 files · 200 KB
Everything this skill ships beside its prose. All of it is set here, as subchapters of chapter 4.
Documentation the agent loads on demand, rather than up front.
references/agents/1 file · 7 KB
references/base-account/8 files · 52 KBreferences/builder-codes/6 files · 15 KB
references/3 files · 8 KB
references/migrations/1 file · 26 KB
references/migrations/minikit-to-farcaster/8 files · 27 KBreferences/migrations/onchainkit/5 files · 43 KB
Executable code the skill can run.