Index of every page on this site: llms.txt
All skills
base avatar

/build-on-base

@ef8bcd5 official
by basebase/skills120 stars
130
Run it yourself

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) Agent registration — trading bots, AI agents, automated senders, ERC-8021 attribution wiring, base.dev API, register agent, builder code registration; (5) Node operation — run Base node, Reth setup, hardware requirements, self-hosted RPC, sync.

Use this Skill: https://skilld.dev/gh/base/skills/build-on-base

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesrun-node.md

≈395 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Running a Base Node

For production apps requiring reliable, unlimited RPC access.

Security

  • Restrict RPC access — bind to 127.0.0.1 or a private interface, never expose RPC ports (8545/8546) to the public internet without authentication
  • Firewall rules — only open ports 9222 (Discovery v5) and 30303 (P2P) to the public; block all other inbound traffic
  • Run as a non-root user with minimal filesystem permissions
  • Use TLS termination (reverse proxy with nginx/caddy) if exposing the RPC endpoint to remote clients
  • Monitor for unauthorized access — log and alert on unexpected RPC calls or connection spikes

Hardware Requirements

  • CPU: 8-Core minimum
  • RAM: 16 GB minimum
  • Storage: NVMe SSD, formula: (2 × chain_size) + snapshot_size + 20% buffer

Networking

Required Ports:

  • Port 9222: Critical for Reth Discovery v5
  • Port 30303: P2P Discovery & RLPx

If these ports are blocked, the node will have difficulty finding peers and syncing.

Client Selection

Use Reth for Base nodes. Geth Archive Nodes are no longer supported.

Reth provides:

  • Better performance for high-throughput L2
  • Built-in archive node support

Syncing

  • Initial sync takes days
  • Consumes significant RPC quota if using external providers
  • Use snapshots to accelerate (check Base docs for URLs)

Sync Status

Incomplete sync indicator: Error: nonce has already been used when deploying.

Verify sync:

  • Compare latest block with explorer
  • Check peer connections
  • Monitor logs for progress

Source: SKILL.md on GitHub

Skill behaviors

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

Third-party checks

No alerts1mo3 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The skill is a development playbook for the Base network that includes scripts for project analysis and wallet registration. It contains behavioral instructions that guide the agent through specific workflows and set mandatory rules for transaction attribution.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

Provenance

Signed by skilld at ef8bcd5. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 weeks ago.

Activeupdated last month

Topics

  • base
  • l2
  • ethereum
  • smart-contracts
  • foundry
  • wagmi
  • viem
  • wallet-auth
  • payments
  • usdc
  • erc-8021
  • basescan
  • node-operation

README badge

README badge for base/skills/build-on-base

What it does

Instructs Claude to deploy and build applications on Base L2, covering network setup (RPC/chain IDs), contract deployment with Foundry, wallet authentication via Base Account SDK, USDC payments, ERC-8021 builder code attribution, and migrations from OnchainKit or Farcaster MiniKit. Includes safety guardrails for private keys, payment verification, and transaction attribution.

Generated from the current SKILL.md.

Frequently asked

Does this skill cover both Base Mainnet and testnet setup?
Yes. It includes network configuration for Base Mainnet (chain ID 8453) and Base Sepolia testnet (84532), with RPC URLs, explorer config, and testnet ETH faucet setup.
What contract deployment tools does this skill use?
Foundry — specifically `forge create` for deployment and BaseScan verification. It does not cover Hardhat or other frameworks.
Does this skill include payment and wallet authentication?
Yes. It covers Base Account SDK for Sign in with Base (SIWB), Base Pay for USDC transactions, gasless payments, paymasters, and sub-accounts with spend permissions.
Can this skill help migrate from OnchainKit?
Yes. It includes step-by-step migration paths from OnchainKit to wagmi, and separate guides for migrating MiniKit to Farcaster SDK and converting Farcaster miniapps to regular Base apps.
Does this skill cover AI agent and trading bot registration?
Yes. It includes agent registration with ERC-8021 attribution wiring, builder code registration, and base.dev API integration for automated senders and trading bots.

Generated from the current SKILL.md. These answers refresh after source changes.