Update LLMs files (#1264)

* update llms.txt files

* update LLMs files

* remove double bar

Author: youssefea

docs/ai-agents/llms-full.txt

@@ -2,86 +2,94 @@
 
 ## AI Agents — Deep Guide for LLMs
 
-> Build AI agents that operate as independent economic actors on Base: a wallet to hold and spend funds, identity standards so other agents can trust it, a payment protocol for pay-per-request APIs, and a discovery layer so agents can find each other.
+> Build AI agents that trade, earn, and transact autonomously on Base: a wallet to hold and spend funds, identity standards so other agents can trust it, payment protocols for per-request API access, and skills that give AI coding assistants deep context on Base APIs.
 
 ### What you can do here
-- Choose a framework (Agent SDK, OpenClaw, BANKR) to build and run your agent
-- Give your agent a wallet to hold stablecoins and sign transactions
+- Give your agent a wallet to hold stablecoins and sign transactions (Bankr, CDP Agentic Wallet, Sponge Wallet)
 - Enable your agent to pay for services automatically using the x402 protocol
-- Register and verify agent identity for agent-to-agent trust
-- Build agent apps — services designed for agents as the primary user
-- Apply Base-specific patterns for trading agents using Flashblocks
+- Gate your own endpoints to charge other agents per request
+- Register and verify agent identity onchain via ERC-8004
+- Fetch live market data and execute token swaps using Flashblocks
+- Install Base Skills so your AI coding assistant can build and migrate Base apps
 
 ## Navigation (with brief descriptions)
 
-### Introduction
-- [AI Agents on Base](https://docs.base.org/ai-agents/index.md) — Overview and how pieces fit together
+### Overview
+- [AI Agents on Base](https://docs.base.org/ai-agents/index.md) — Overview, high-level flow diagram, and section index
 
-### Core Concepts
-- [Frameworks](https://docs.base.org/ai-agents/core-concepts/agent-frameworks.md) — Agent SDK, OpenClaw, BANKR comparison
-- [Wallets](https://docs.base.org/ai-agents/core-concepts/wallets.md) — Wallet options and setup
-- [Payments & Transactions](https://docs.base.org/ai-agents/core-concepts/payments-and-transactions.md) — x402 and skills
-- [Identity, Verification & Auth](https://docs.base.org/ai-agents/core-concepts/identity-verification-auth.md) — Agent identity and trust
-- [Agent Apps](https://docs.base.org/ai-agents/core-concepts/agent-apps.md) — Build agent-first services
+### Quickstart
+- [Get Started with Payments](https://docs.base.org/ai-agents/quickstart/payments.md) — Zero to a working agent that makes and accepts x402 payments in under 10 minutes (uses OpenClaw)
+- [Build a Trading Agent](https://docs.base.org/ai-agents/quickstart/trading.md) — Fetch live market data and execute swaps automatically on Base
 
-### Advanced
-- [Trading on Base](https://docs.base.org/ai-agents/trading.md) — Flashblocks, fee calibration, trading signals
+### Setup
+- [Wallet Setup](https://docs.base.org/ai-agents/setup/wallet-setup.md) — Compare Bankr, CDP Agentic Wallet, and Sponge Wallet; choose the right one for your agent
+- [Agent Builder Codes](https://docs.base.org/ai-agents/setup/agent-builder-codes.md) — Register for onchain attribution with builder codes
+- [Agent Registration](https://docs.base.org/ai-agents/setup/agent-registration.md) — Publish your agent's identity to the ERC-8004 registry with a Basename
 
+### Payments
+- [Pay for Services with x402](https://docs.base.org/ai-agents/payments/pay-for-services-with-x402.md) — Client-side x402: automatic stablecoin payment on 402 response, no subscriptions or API keys
+- [Accepting Payments (x402)](https://docs.base.org/ai-agents/payments/accepting-payments.md) — Server-side x402: gate endpoints with OpenClaw monetize-service skill, Sponge payment links, or x402-express
 
-## Key Concepts (excerpts)
+### Trading
+- [Data Fetching](https://docs.base.org/ai-agents/trading/data-fetching.md) — Fetch live market data from onchain and offchain sources using Flashblocks pending state
+- [Trade Execution](https://docs.base.org/ai-agents/trading/trade-execution.md) — Execute swaps with wallet-native tools; Flashblocks patterns, fee calibration, and onchain signals
 
-Source: `https://docs.base.org/ai-agents/index.md`
+### Skills
+- [Skills Overview](https://docs.base.org/ai-agents/skills/index.md) — Install with `npx skills add base/base-skills`; agent picks the right skill automatically
+- [Building with Base Account](https://docs.base.org/ai-agents/skills/base-account/building-with-base-account.md) — Auth, payments, subscriptions, sub-accounts, and gas sponsorship via Base Account SDK
+- [Adding Builder Codes](https://docs.base.org/ai-agents/skills/base-chain/adding-builder-codes.md) — Append ERC-8021 attribution data across Privy, Wagmi, Viem, and standard RPC
+- [Connecting to Base Network](https://docs.base.org/ai-agents/skills/base-chain/connecting-to-base-network.md) — Chain IDs, RPC endpoints, and explorer URLs for Base Mainnet and Sepolia
+- [Deploying Contracts](https://docs.base.org/ai-agents/skills/base-chain/deploying-contracts.md) — Deploy and verify contracts on Base using Foundry, with troubleshooting guidance
+- [Running a Base Node](https://docs.base.org/ai-agents/skills/base-chain/running-a-base-node.md) — Production node setup, hardware requirements, networking ports, and syncing guidance
+- [Convert Farcaster Mini App to App](https://docs.base.org/ai-agents/skills/migrations/convert-farcaster-miniapp-to-app.md) — Automated migration from Farcaster mini app to standard web app
+- [Converting MiniKit to Farcaster](https://docs.base.org/ai-agents/skills/migrations/converting-minikit-to-farcaster.md) — MiniKit to Farcaster migration
+- [Migrating an OnchainKit App](https://docs.base.org/ai-agents/skills/migrations/migrating-an-onchainkit-app.md) — OnchainKit app migration
 
-Base gives your AI agent the tools to operate as an independent economic actor:
-- **Framework**: Self-hosted SDK, open-source assistant (OpenClaw), or managed API (BANKR)
-- **Wallet**: Hold stablecoins, send payments, and sign transactions onchain
-- **Payments**: Pay for API access with stablecoins using the x402 pay-per-request protocol
-- **Identity**: Register your agent in a public directory so other agents and services can discover and verify it
-- **Agent Apps**: Create services designed for agents, exposing structured endpoints agents can call programmatically
 
-Source: `https://docs.base.org/ai-agents/core-concepts/agent-frameworks.md`
-
-Framework comparison:
-- **BANKR** — Managed Agent API with skill and wallet plugins; best for fast deployment
-- **OpenClaw** — Open-source personal AI assistant (Discord, Telegram, web); best for multi-channel agents
-- **Agent SDK** — Developer toolkit for custom agents with full control over behavior and integrations
+## Key Concepts (excerpts)
 
-Source: `https://docs.base.org/ai-agents/core-concepts/wallets.md`
+Source: `https://docs.base.org/ai-agents/index.md`
 
-An onchain wallet gives your agent the ability to hold funds, authorize transactions, and sign messages. Without one, your agent can read data but can't pay for services, receive payments, or prove its identity.
+Base gives your AI agent the tools to operate as an independent economic actor:
+- **Wallet**: Hold stablecoins, send payments, and sign transactions onchain — without exposing private keys in the agent's prompt context
+- **Payments**: Pay for API access automatically with stablecoins using the x402 pay-per-request protocol
+- **Identity**: Register in the ERC-8004 public directory so other agents and services can discover and verify your agent
+- **Trading**: Use Flashblocks for 200ms preconfirmed state and exposed L1/L2 fees for cost-vs-speed tradeoffs
+- **Skills**: Install structured knowledge packs to give your AI coding assistant deep context on Base APIs
 
-Source: `https://docs.base.org/ai-agents/core-concepts/payments-and-transactions.md`
+Source: `https://docs.base.org/ai-agents/setup/wallet-setup.md`
 
-- **x402 protocol**: Agents pay for services automatically with stablecoins on a per-request basis, no human approval required
-- **Skills**: Pre-built onchain actions (swaps, transfers, contract calls) that your agent can perform through a structured API
+An onchain wallet gives your agent the ability to hold funds, authorize transactions, and sign messages. Never generate a wallet by prompting the agent to create a random private key — the key will appear in conversation context where it can be logged or leaked.
 
-Source: `https://docs.base.org/ai-agents/core-concepts/identity-verification-auth.md`
+Wallet options:
+- **Bankr** — Cross-chain wallet (Base, Ethereum, Solana, Polygon, Unichain); built-in swap tools; gas sponsored on supported chains. Install: `install the bankr skill from https://github.com/BankrBot/skills`
+- **CDP Agentic Wallet** — Email OTP auth, no API keys in agent; native x402 support. Install: `npx skills add coinbase/agentic-wallet-skills`
+- **Sponge Wallet** — REST API for wallet operations; built-in swap and x402 payment links. API at `https://api.wallet.paysponge.com`
 
-- Agents register in a public directory with verifiable credentials
-- Other agents and services can look up and verify identity before trusting
-- Authentication flows designed for machine-to-machine (no human in the loop)
+Source: `https://docs.base.org/ai-agents/payments/pay-for-services-with-x402.md`
 
-Source: `https://docs.base.org/ai-agents/core-concepts/agent-apps.md`
+The x402 protocol lets agents pay for API access automatically:
+1. Agent sends HTTP request to a paid endpoint
+2. Server responds with `402 Payment Required` and payment requirements
+3. Agent signs a payment payload and retries with `PAYMENT-SIGNATURE` header
+4. Facilitator verifies and settles the payment onchain
+5. Server delivers the response
 
-- Agent apps expose structured endpoints (not visual UIs) that agents can discover and call
-- Make your service discoverable by registering it in the agent directory
-- Design APIs with explicit schemas so agents can reason about inputs and outputs
+Source: `https://docs.base.org/ai-agents/payments/accepting-payments.md`
 
+Gate your endpoints with x402 to charge other agents:
+- **OpenClaw monetize-service skill** — Simplest option; single prompt to expose a paid endpoint: `Set up a paid endpoint for my market data at $0.01 per request`
+- **Sponge Wallet payment links** — Reusable payment links via REST API
+- **x402-express** — `npm install x402-express express` for custom Express middleware
 
-## Trading Agents (excerpts)
+Host a `SKILL.md` at `/.well-known/SKILL.md` to make your endpoint discoverable by agents.
 
-Source: `https://docs.base.org/ai-agents/trading.md`
+Source: `https://docs.base.org/ai-agents/trading/trade-execution.md`
 
-Base offers two structural advantages for trading agents:
+Base-specific trading advantages:
 - **Flashblocks**: 200ms preconfirmed block state, 10× faster than the 2-second block
 - **Exposed L1/L2 fee structure**: Enables explicit cost-vs-speed tradeoffs
 
-Key patterns:
-- Connect to `mainnet-preconf.base.org` for all reads and submissions to access Flashblocks pending state
-- Simulate with `eth_simulateV1` against preconfirmed state before signing any transaction
-- Poll `base_transactionStatus` (not `eth_getTransactionReceipt`) for low-latency inclusion status (~200ms)
-- Use `eth_feeHistory` over last 5–10 blocks with reward percentiles `[50, 90]` for fee calibration
-
 Fee calibration:
 ```
 maxFeePerGas = nextBaseFee * 2 + maxPriorityFeePerGas
@@ -92,7 +100,21 @@ L1 fee decision rule — if this ratio exceeds 0.8, L1 fee dominates; consider d
 l1FeeUpperBound / (gasLimit × maxFeePerGas + l1FeeUpperBound) > 0.8
 ```
 
-Key Flashblocks signals for trading:
-- `eth_getBlockByNumber("pending")` on preconf endpoint — preconfirmed pending block state (200ms early)
-- `eth_subscribe("newFlashblockTransactions")` — first-mover on large trades entering the block
-- `eth_subscribe("pendingLogs", { address, topics })` — detect liquidation thresholds and oracle updates before finality
+Key patterns:
+- Connect to `mainnet-preconf.base.org` for all reads and submissions
+- Simulate with `eth_simulateV1` against preconfirmed state before signing
+- Poll `base_transactionStatus` (not `eth_getTransactionReceipt`) for ~200ms inclusion status
+- Use `eth_feeHistory` over last 5–10 blocks with reward percentiles `[50, 90]` for fee calibration
+
+
+## Skills (excerpts)
+
+Source: `https://docs.base.org/ai-agents/skills/index.md`
+
+Install all Base Skills:
+
+```bash
+npx skills add base/base-skills
+```
+
+Skills plug into Claude Code, Cursor, Windsurf, and other AI coding assistants. The agent picks the right skill automatically based on what you're building — no prompting required.

docs/ai-agents/llms.txt

@@ -2,18 +2,35 @@
 
 ## AI Agents Documentation
 
-> Build AI agents that operate as independent economic actors on Base — with wallets, payments, identity, and agent-to-agent discovery built in.
+> Build AI agents that trade, earn, and transact autonomously on Base — with wallets, payments, identity, and skills built in.
 
-## Introduction
+## Overview
 - [AI Agents on Base](https://docs.base.org/ai-agents/index.md) — What you can build and how the pieces fit together
 
-## Core Concepts
-- [Frameworks](https://docs.base.org/ai-agents/core-concepts/agent-frameworks.md) — Choose between Agent SDK, OpenClaw, and BANKR
-- [Wallets](https://docs.base.org/ai-agents/core-concepts/wallets.md) — Give your agent the ability to hold funds and sign transactions
-- [Payments & Transactions](https://docs.base.org/ai-agents/core-concepts/payments-and-transactions.md) — Pay for services with x402 and execute onchain actions via skills
-- [Identity, Verification & Auth](https://docs.base.org/ai-agents/core-concepts/identity-verification-auth.md) — Register, discover, and verify agents
-- [Agent Apps](https://docs.base.org/ai-agents/core-concepts/agent-apps.md) — Build services with agents as the primary user
+## Quickstart
+- [Get Started with Payments](https://docs.base.org/ai-agents/quickstart/payments.md) — Build an agent that makes and accepts x402 payments in under 10 minutes
+- [Build a Trading Agent](https://docs.base.org/ai-agents/quickstart/trading.md) — Fetch live market data and execute token swaps on Base
 
-## Advanced
-- [Trading on Base](https://docs.base.org/ai-agents/trading.md) — Flashblocks patterns, fee calibration, and onchain signals for trading agents
+## Setup
+- [Wallet Setup](https://docs.base.org/ai-agents/setup/wallet-setup.md) — Give your agent a wallet to hold funds and sign transactions (Bankr, CDP, Sponge)
+- [Agent Builder Codes](https://docs.base.org/ai-agents/setup/agent-builder-codes.md) — Register your agent with builder codes for onchain attribution
+- [Agent Registration](https://docs.base.org/ai-agents/setup/agent-registration.md) — Register and verify your agent's identity onchain via ERC-8004
 
+## Payments
+- [Pay for Services with x402](https://docs.base.org/ai-agents/payments/pay-for-services-with-x402.md) — Use x402 to pay for API access per-request in stablecoins, no API keys required
+- [Accepting Payments (x402)](https://docs.base.org/ai-agents/payments/accepting-payments.md) — Gate your agent's endpoints to charge other agents per request
+
+## Trading
+- [Data Fetching](https://docs.base.org/ai-agents/trading/data-fetching.md) — Fetch live market data from onchain and offchain sources
+- [Trade Execution](https://docs.base.org/ai-agents/trading/trade-execution.md) — Execute token swaps using Flashblocks and Base-specific onchain signals
+
+## Skills
+- [Skills Overview](https://docs.base.org/ai-agents/skills/index.md) — Installable knowledge packs that give AI coding assistants deep context on Base APIs
+- [Building with Base Account](https://docs.base.org/ai-agents/skills/base-account/building-with-base-account.md) — Auth, payments, subscriptions, sub-accounts, and gas sponsorship
+- [Adding Builder Codes](https://docs.base.org/ai-agents/skills/base-chain/adding-builder-codes.md) — Append ERC-8021 attribution data to transactions
+- [Connecting to Base Network](https://docs.base.org/ai-agents/skills/base-chain/connecting-to-base-network.md) — Chain IDs, RPC endpoints, and explorer URLs
+- [Deploying Contracts](https://docs.base.org/ai-agents/skills/base-chain/deploying-contracts.md) — Deploy and verify contracts on Base using Foundry
+- [Running a Base Node](https://docs.base.org/ai-agents/skills/base-chain/running-a-base-node.md) — Production node setup, hardware requirements, and syncing guidance
+- [Convert Farcaster Mini App to App](https://docs.base.org/ai-agents/skills/migrations/convert-farcaster-miniapp-to-app.md) — Migrate Farcaster mini apps to standard web apps
+- [Converting MiniKit to Farcaster](https://docs.base.org/ai-agents/skills/migrations/converting-minikit-to-farcaster.md) — MiniKit to Farcaster migration skill
+- [Migrating an OnchainKit App](https://docs.base.org/ai-agents/skills/migrations/migrating-an-onchainkit-app.md) — OnchainKit migration guidance

docs/base-account/llms-full.txt

@@ -52,6 +52,7 @@ const { status } = await getPaymentStatus({ id })
 - [Privy Authentication](https://docs.base.org/base-account/framework-integrations/privy/authentication.md) — Privy auth
 - [Privy Sub‑Accounts](https://docs.base.org/base-account/framework-integrations/privy/sub-accounts.md) — Privy sub‑accounts
 - [Privy Spend Permissions](https://docs.base.org/base-account/framework-integrations/privy/spend-permissions.md) — Privy spend permissions
+- [Privy Wallet Actions](https://docs.base.org/base-account/framework-integrations/privy/wallet-actions.md) — Privy wallet action patterns
 - [RainbowKit](https://docs.base.org/base-account/framework-integrations/rainbowkit.md) — RainbowKit integration
 - [Reown](https://docs.base.org/base-account/framework-integrations/reown.md) — Reown integration
 - [Thirdweb](https://docs.base.org/base-account/framework-integrations/thirdweb.md) — Thirdweb integration

docs/base-account/llms.txt

@@ -24,6 +24,7 @@
 - [Privy: Setup](https://docs.base.org/base-account/framework-integrations/privy/setup.md) — Authentication + sub‑accounts
 - [RainbowKit](https://docs.base.org/base-account/framework-integrations/rainbowkit.md) — RainbowKit integration
 - [Reown](https://docs.base.org/base-account/framework-integrations/reown.md) — Reown integration
+- [Thirdweb](https://docs.base.org/base-account/framework-integrations/thirdweb.md) — Thirdweb integration
 - [CDP](https://docs.base.org/base-account/framework-integrations/cdp.md) — CDP integration
 
 ## Reference

docs/base-chain/llms-full.txt

@@ -58,6 +58,7 @@
 - [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
 
 ### Security
 - [Security Council](https://docs.base.org/base-chain/security/security-council.md) — Security governance

docs/base-chain/llms.txt

@@ -38,5 +38,11 @@
 - [Report a Vulnerability](https://docs.base.org/base-chain/security/report-vulnerability.md) — Security contact and disclosure
 - [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
+
 ## Optional
 - [Ecosystem Contracts](https://docs.base.org/base-chain/network-information/ecosystem-contracts.md) — Common ecosystem contract addresses