adding-builder-codes

Integrate Base Builder Codes (ERC-8021) into web3 applications for transaction attribution.

104|114|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/base/skills --skill adding-builder-codes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adding-builder-codes
Source: https://github.com/base/skills/tree/main/skills/adding-builder-codes
Command: npx skills add https://github.com/base/skills --skill adding-builder-codes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ox, and includes references (resource) components.

What problem does it solve?

This Skill helps developers integrate Base Builder Codes (ERC-8021) into their web3 applications, enabling onchain transaction attribution and the earning of referral fees on the Base network.

Core Features & Use Cases

  • Automated Attribution: Appends a unique builder code to transactions, allowing Base to track and attribute activity to your application.
  • Referral Fee Earning: Facilitates earning referral fees based on onchain activity generated through your app.
  • Framework Agnostic: Supports integration across various popular web3 development frameworks including Wagmi, Viem, Privy, ethers.js, and raw Ethereum RPC.
  • Use Case: A dApp developer wants to ensure all transactions initiated by their users on Base are attributed to their platform so they can earn referral fees. This skill guides them through detecting their framework and applying the correct integration pattern.

Quick Start

Use the adding-builder-codes skill to integrate builder codes into your Wagmi application.

Frequently Asked Questions about adding-builder-codes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate Base Builder Codes into my Wagmi application?

To integrate Base Builder Codes into a Wagmi application, you append a generated dataSuffix to your Base L2 transactions. This skill detects your Wagmi framework and applies the correct integration pattern for transaction attribution.

What are Base Builder Codes used for in web3 transactions?

Base Builder Codes are used for onchain transaction attribution on the Base network. By appending a unique code to transactions, Base tracks your application's activity, enabling you to earn referral fees.

Does the Base Builder Codes integration work with Privy and Viem?

Yes, the Base Builder Codes integration works with Privy, Viem, Wagmi, ethers.js, and raw Ethereum RPC. It detects your project framework and applies the appropriate pattern to append the dataSuffix.

Do I need the ox library to generate builder code suffixes?

Yes, you need the 'ox' library to generate the transaction suffix for Base Builder Codes. Additionally, you may optionally require 'viem' for specific framework integrations like Wagmi.

How do I earn referral fees on the Base L2 network?

You earn referral fees on the Base L2 network by attributing user transactions to your application using Base Builder Codes. This skill helps append the necessary dataSuffix to your transactions for tracking.