Développement sur Base
Playbook complet pour construire sur Base L2 — configuration réseau, smart contracts, authentification wallet, paiements, attribution d'outils développeur, et migrations de framework.
Stack par défaut
| Couche | Par défaut |
|---|---|
| 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 |
Garde-fous de sécurité
- Ne commettez jamais de clés privées — utilisez
cast wallet importpour les keystores Foundry - N'exposez jamais les clés API RPC ou les credentials CDP côté client — passez par un backend
- Ne sautez jamais la vérification côté serveur des paiements — appelez toujours
getPaymentStatus()côté serveur et vérifiezsender,amount,recipient; tracez les IDs de transactions traitées pour éviter les attaques par rejeu - Ne transmettre jamais une transaction sans attribution Builder Code — perte de données silencieuse, pas d'erreurs, pas d'avertissements
- Validez tous les inputs shell fournis par l'utilisateur avant de construire des commandes forge/cast (pas d'espaces, points-virgules, pipes)
- Headers COOP pour les popups Base Account — utilisez
same-origin-allow-popups, passame-origin
Routage des tâches
Consultez la référence pour votre tâche :
| Tâche | Quand l'utiliser | Référence |
|---|---|---|
| Config réseau | URLs RPC, chain IDs, liens explorateur, setup testnet | references/network.md |
| Déployer des contracts | Déploiement Foundry, vérification BaseScan, faucet | references/deploy-contracts.md |
| Exécuter un nœud Base | RPC self-hosted, Reth, requirements matériel | references/run-node.md |
| Builder Codes | Ajouter l'attribution ERC-8021 aux transactions | references/builder-codes/overview.md |
| Base Account SDK | SIWB, Base Pay, subscriptions, sub-accounts | references/base-account/overview.md |
| Enregistrer un agent IA/bot | Enregistrer un wallet, obtenir builder code, câbler l'attribution | references/agents/register.md |
| Migrer depuis OnchainKit | OnchainKitProvider → wagmi, composants wallet/tx | references/migrations/onchainkit/overview.md |
| MiniKit → Farcaster SDK | @coinbase/onchainkit/minikit → @farcaster/miniapp-sdk |
references/migrations/minikit-to-farcaster/overview.md |
| Farcaster miniapp → app classique | Supprimer le couplage Mini App host, convertir en Base/web app | references/migrations/farcaster-miniapp-to-app.md |
Procédure opérationnelle
- Classifiez la tâche en utilisant le tableau ci-dessus
- Lisez la référence pertinente avant l'implémentation
- Confirmez le framework avec l'utilisateur quand plusieurs options existent (ex. Privy vs wagmi pour Builder Codes)
- Implémentez avec un chain ID explicite, les requirements de sécurité, et toutes les validations requises
- Livrez diffs, commandes d'installation, et toute étape manuelle (env vars, setup clé API, enregistrement wallet)
Pour les cas limites et derniers changements d'API
- Docs optimisées pour IA : docs.base.org/llms.txt
- Référence Base Account : docs.base.org/base-account
- Docs chaîne Base : docs.base.org
Installation
npx skills add base/skills --skill build-on-base