diff --git a/docs/ai-agents/setup/agent-builder-codes.mdx b/docs/ai-agents/setup/agent-builder-codes.mdx
index cda0478b6..89ff1f0fa 100644
--- a/docs/ai-agents/setup/agent-builder-codes.mdx
+++ b/docs/ai-agents/setup/agent-builder-codes.mdx
@@ -109,5 +109,5 @@ No authentication required.
Returns the builder code for the given wallet. The same wallet address always returns the same code and is safe to call multiple times.
## Further reading
-- [Builder Codes Overview](/base-chain/builder-codes/builder-codes) - What Builder Codes are, how ERC-8021 attribution works, and FAQs on gas, identity, and wallet support
-- [Builder Codes for Agent Developers](/base-chain/builder-codes/agent-developers) - API reference, skill reference, and overview
+- [Builder Codes Overview](/apps/builder-codes/builder-codes) - What Builder Codes are, how ERC-8021 attribution works, and FAQs on gas, identity, and wallet support
+- [Builder Codes for Agent Developers](/apps/builder-codes/agent-developers) - API reference, skill reference, and overview
diff --git a/docs/base-chain/builder-codes/agent-developers.mdx b/docs/apps/builder-codes/agent-developers.mdx
similarity index 100%
rename from docs/base-chain/builder-codes/agent-developers.mdx
rename to docs/apps/builder-codes/agent-developers.mdx
diff --git a/docs/base-chain/builder-codes/app-developers.mdx b/docs/apps/builder-codes/app-developers.mdx
similarity index 100%
rename from docs/base-chain/builder-codes/app-developers.mdx
rename to docs/apps/builder-codes/app-developers.mdx
diff --git a/docs/base-chain/builder-codes/builder-codes.mdx b/docs/apps/builder-codes/builder-codes.mdx
similarity index 92%
rename from docs/base-chain/builder-codes/builder-codes.mdx
rename to docs/apps/builder-codes/builder-codes.mdx
index 80c857273..2992079d5 100644
--- a/docs/base-chain/builder-codes/builder-codes.mdx
+++ b/docs/apps/builder-codes/builder-codes.mdx
@@ -16,13 +16,13 @@ Each code has associated metadata. Onchain metadata primarily includes a "payout
## Integration Guides
-
+
Integrate Builder Codes using Wagmi or Viem
-
+
Implement the dataSuffix capability
-
+
Attribute your AI agent's transactions via the API
diff --git a/docs/base-chain/builder-codes/wallet-developers.mdx b/docs/apps/builder-codes/wallet-developers.mdx
similarity index 100%
rename from docs/base-chain/builder-codes/wallet-developers.mdx
rename to docs/apps/builder-codes/wallet-developers.mdx
diff --git a/docs/apps/quickstart/migrate-to-standard-web-app.mdx b/docs/apps/quickstart/migrate-to-standard-web-app.mdx
index f5e49fc5f..e4796ea30 100644
--- a/docs/apps/quickstart/migrate-to-standard-web-app.mdx
+++ b/docs/apps/quickstart/migrate-to-standard-web-app.mdx
@@ -22,7 +22,7 @@ The Base App is moving from the Farcaster mini-app spec to a single model: **sta
| Neynar webhooks for add/remove events | Base-owned backends (Base Account / address preferences) |
| FID-based notifications via Neynar | Wallet-address notifications via Base.dev notifications API *(coming soon)* |
| Farcaster SDK for auth and actions | wagmi + viem + Sign-In with Ethereum (SIWE) |
-| Search and discovery via Farcaster | Base.dev app metadata + [builder codes](https://docs.base.org/base-chain/builder-codes/builder-codes) |
+| Search and discovery via Farcaster | Base.dev app metadata + [builder codes](https://docs.base.org/apps/builder-codes/builder-codes) |
---
@@ -173,7 +173,7 @@ Your app uses the Farcaster SDK. The migration replaces Farcaster-specific auth,
- If you haven't registered yet, create a project at [Base.dev](https://www.base.dev) and complete your app metadata: name, icon, tagline, description, screenshots, category, primary URL, and [builder code](/base-chain/builder-codes/builder-codes). Already registered apps do not need to re-register or update metadata.
+ If you haven't registered yet, create a project at [Base.dev](https://www.base.dev) and complete your app metadata: name, icon, tagline, description, screenshots, category, primary URL, and [builder code](/apps/builder-codes/builder-codes). Already registered apps do not need to re-register or update metadata.
@@ -193,7 +193,7 @@ Your app is already a standard web app. You're mostly done — just verify your
- If you haven't registered yet, create a project at [Base.dev](https://www.base.dev) and complete your app metadata: name, icon, tagline, description, screenshots, category, primary URL, and [builder code](/base-chain/builder-codes/builder-codes). Already registered apps do not need to re-register or update metadata.
+ If you haven't registered yet, create a project at [Base.dev](https://www.base.dev) and complete your app metadata: name, icon, tagline, description, screenshots, category, primary URL, and [builder code](/apps/builder-codes/builder-codes). Already registered apps do not need to re-register or update metadata.
@@ -246,7 +246,7 @@ Before considering your app migrated, verify the following:
- Project is registered on [Base.dev](https://www.base.dev) with primary URL set. Name, icon, tagline, screenshots, category, description, and [builder code](/base-chain/builder-codes/builder-codes) are all filled in.
+ Project is registered on [Base.dev](https://www.base.dev) with primary URL set. Name, icon, tagline, screenshots, category, description, and [builder code](/apps/builder-codes/builder-codes) are all filled in.
diff --git a/docs/base-account/reference/core/capabilities/dataSuffix.mdx b/docs/base-account/reference/core/capabilities/dataSuffix.mdx
index c48d4c3dd..ad8324240 100644
--- a/docs/base-account/reference/core/capabilities/dataSuffix.mdx
+++ b/docs/base-account/reference/core/capabilities/dataSuffix.mdx
@@ -103,7 +103,7 @@ When a wallet receives a `dataSuffix` capability, the suffix is appended to `use
### Builder Codes Attribution
-The primary use case for `dataSuffix` is [Builder Codes](/base-chain/builder-codes/builder-codes) attribution. Builder Codes are unique identifiers that allow apps to receive attribution for onchain activity they generate.
+The primary use case for `dataSuffix` is [Builder Codes](/apps/builder-codes/builder-codes) attribution. Builder Codes are unique identifiers that allow apps to receive attribution for onchain activity they generate.
```typescript
import { Attribution } from "ox/erc8021";
@@ -144,7 +144,7 @@ Register on [base.dev](https://base.dev) to get your Builder Code for proper att
3. **Keep suffixes small**: Larger suffixes increase gas costs
-For wallet developers implementing dataSuffix support, see the [For Wallet Developers](/base-chain/builder-codes/builder-codes#for-wallet-developers) section in the Builder Codes guide.
+For wallet developers implementing dataSuffix support, see the [For Wallet Developers](/apps/builder-codes/builder-codes#for-wallet-developers) section in the Builder Codes guide.
## Related Capabilities
diff --git a/docs/base-chain/llms-full.txt b/docs/base-chain/llms-full.txt
index 1cd95b49b..9ca1898fb 100644
--- a/docs/base-chain/llms-full.txt
+++ b/docs/base-chain/llms-full.txt
@@ -54,10 +54,10 @@
- [Node Providers](https://docs.base.org/base-chain/node-operators/node-providers.md) — RPC node providers for Base
### Builder Codes
-- [Builder Codes](https://docs.base.org/base-chain/builder-codes/builder-codes.md) — Overview of the Builder Codes program
-- [App Developers](https://docs.base.org/base-chain/builder-codes/app-developers.md) — Builder Codes for app developers
-- [Wallet Developers](https://docs.base.org/base-chain/builder-codes/wallet-developers.md) — Builder Codes for wallet developers
-- [Agent Developers](https://docs.base.org/base-chain/builder-codes/agent-developers.md) — Attribute AI agent transactions to your identity on Base
+- [Builder Codes](https://docs.base.org/apps/builder-codes/builder-codes.md) — Overview of the Builder Codes program
+- [App Developers](https://docs.base.org/apps/builder-codes/app-developers.md) — Builder Codes for app developers
+- [Wallet Developers](https://docs.base.org/apps/builder-codes/wallet-developers.md) — Builder Codes for wallet developers
+- [Agent Developers](https://docs.base.org/apps/builder-codes/agent-developers.md) — Attribute AI agent transactions to your identity on Base
### Security
- [Security Council](https://docs.base.org/base-chain/security/security-council.md) — Security governance
diff --git a/docs/base-chain/llms.txt b/docs/base-chain/llms.txt
index 47aa39bb3..fc8ca545e 100644
--- a/docs/base-chain/llms.txt
+++ b/docs/base-chain/llms.txt
@@ -38,10 +38,10 @@
- [Security Council](https://docs.base.org/base-chain/security/security-council.md) — Governance and process overview
## Builder Codes
-- [Builder Codes](https://docs.base.org/base-chain/builder-codes/builder-codes.md) — Overview of the Builder Codes program
-- [App Developers](https://docs.base.org/base-chain/builder-codes/app-developers.md) — Builder Codes for app developers
-- [Wallet Developers](https://docs.base.org/base-chain/builder-codes/wallet-developers.md) — Builder Codes for wallet developers
-- [Agent Developers](https://docs.base.org/base-chain/builder-codes/agent-developers.md) — Attribute AI agent transactions to your identity on Base
+- [Builder Codes](https://docs.base.org/apps/builder-codes/builder-codes.md) — Overview of the Builder Codes program
+- [App Developers](https://docs.base.org/apps/builder-codes/app-developers.md) — Builder Codes for app developers
+- [Wallet Developers](https://docs.base.org/apps/builder-codes/wallet-developers.md) — Builder Codes for wallet developers
+- [Agent Developers](https://docs.base.org/apps/builder-codes/agent-developers.md) — Attribute AI agent transactions to your identity on Base
## Optional
- [Ecosystem Contracts](https://docs.base.org/base-chain/network-information/ecosystem-contracts.md) — Common ecosystem contract addresses
diff --git a/docs/docs.json b/docs/docs.json
index c7a02f009..326c27bde 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -149,15 +149,6 @@
"base-chain/node-operators/troubleshooting"
]
},
- {
- "group": "Builder Codes",
- "pages": [
- "base-chain/builder-codes/builder-codes",
- "base-chain/builder-codes/app-developers",
- "base-chain/builder-codes/wallet-developers",
- "base-chain/builder-codes/agent-developers"
- ]
- },
{
"group": "API Reference",
"pages": [
@@ -587,6 +578,15 @@
"pages": [
"apps/technical-guides/base-notifications"
]
+ },
+ {
+ "group": "Builder Codes",
+ "pages": [
+ "apps/builder-codes/builder-codes",
+ "apps/builder-codes/app-developers",
+ "apps/builder-codes/wallet-developers",
+ "apps/builder-codes/agent-developers"
+ ]
}
]
},
@@ -1563,28 +1563,28 @@
"destination": "/base-chain/network-information/bridges"
},
{
- "source": "/base-chain/builder-codes/builder-codes-faq",
- "destination": "/base-chain/builder-codes/builder-codes"
+ "source": "/apps/builder-codes/builder-codes-faq",
+ "destination": "/apps/builder-codes/builder-codes"
},
{
"source": "/base-chain/quickstart/builder-codes",
- "destination": "/base-chain/builder-codes/builder-codes"
+ "destination": "/apps/builder-codes/builder-codes"
},
{
- "source": "/base-chain/builder-codes/builder-codes-app-developers",
- "destination": "/base-chain/builder-codes/app-developers"
+ "source": "/apps/builder-codes/builder-codes-app-developers",
+ "destination": "/apps/builder-codes/app-developers"
},
{
- "source": "/base-chain/builder-codes/builder-codes-wallet-developers",
- "destination": "/base-chain/builder-codes/wallet-developers"
+ "source": "/apps/builder-codes/builder-codes-wallet-developers",
+ "destination": "/apps/builder-codes/wallet-developers"
},
{
- "source": "/base-chain/builder-codes/builder-codes-bridge-developers",
- "destination": "/base-chain/builder-codes/builder-codes"
+ "source": "/apps/builder-codes/builder-codes-bridge-developers",
+ "destination": "/apps/builder-codes/builder-codes"
},
{
- "source": "/base-chain/builder-codes/bridge-developers",
- "destination": "/base-chain/builder-codes/builder-codes"
+ "source": "/apps/builder-codes/bridge-developers",
+ "destination": "/apps/builder-codes/builder-codes"
},
{
"source": "/get-started/ai-prompting",
@@ -2913,6 +2913,26 @@
{
"source": "/mini-apps/:slug*",
"destination": "/apps/:slug*"
+ },
+ {
+ "source": "/base-chain/builder-codes/builder-codes",
+ "destination": "/apps/builder-codes/builder-codes"
+ },
+ {
+ "source": "/base-chain/builder-codes/app-developers",
+ "destination": "/apps/builder-codes/app-developers"
+ },
+ {
+ "source": "/base-chain/builder-codes/wallet-developers",
+ "destination": "/apps/builder-codes/wallet-developers"
+ },
+ {
+ "source": "/base-chain/builder-codes/agent-developers",
+ "destination": "/apps/builder-codes/agent-developers"
+ },
+ {
+ "source": "/base-chain/builder-codes",
+ "destination": "/apps/builder-codes/builder-codes"
}
],
"integrations": {
@@ -2920,4 +2940,4 @@
"measurementId": "G-TKCM02YFWN"
}
}
-}
+}
\ No newline at end of file
diff --git a/docs/llms.txt b/docs/llms.txt
index dc5a131d2..2e2770933 100644
--- a/docs/llms.txt
+++ b/docs/llms.txt
@@ -87,7 +87,7 @@ Base is an Ethereum L2 by Coinbase. Docs for: Base Chain, Smart Wallet, OnchainK
|base-chain/api-reference/debug-api:debug_traceBlockByHash,debug_traceBlockByNumber,debug_traceTransaction
|base-chain/api-reference/ethereum-json-rpc-api:eth_blockNumber,eth_call,eth_chainId,eth_estimateGas,eth_feeHistory,eth_gasPrice,eth_getBalance,eth_getBlockByHash,eth_getBlockByNumber,eth_getBlockReceipts,eth_getBlockTransactionCountByHash,eth_getBlockTransactionCountByNumber,eth_getCode,eth_getLogs,eth_getStorageAt,eth_getTransactionByBlockHashAndIndex,eth_getTransactionByBlockNumberAndIndex,eth_getTransactionByHash,eth_getTransactionCount,eth_getTransactionReceipt,eth_maxPriorityFeePerGas,eth_sendRawTransaction,eth_subscribe,eth_syncing,eth_unsubscribe,net_version,web3_clientVersion
|base-chain/api-reference/flashblocks-api:base_transactionStatus,eth_simulateV1,flashblocks-api-overview,newFlashblockTransactions,newFlashblocks,pendingLogs
-|base-chain/builder-codes:agent-developers,app-developers,builder-codes,wallet-developers
+|apps/builder-codes:agent-developers,app-developers,builder-codes,wallet-developers
|base-chain/flashblocks:app-integration,architecture,faq,overview
|base-chain/network-information:base-contracts,block-building,bridges,configuration-changelog,diffs-ethereum-base,ecosystem-contracts,network-faucets,network-fees,transaction-finality,troubleshooting-transactions
|base-chain/node-operators:node-providers,performance-tuning,run-a-base-node,snapshots,troubleshooting