Skip to content

Commit 16a43ab

Browse files
committed
update all llm files
1 parent 4d7e805 commit 16a43ab

14 files changed

Lines changed: 243 additions & 139 deletions

File tree

docs/ai-agents/llms-full.txt

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
# https://docs.base.org/ai-agents/llms-full.txt
2+
3+
## AI Agents — Deep Guide for LLMs
4+
5+
> 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.
6+
7+
### What you can do here
8+
- Choose a framework (Agent SDK, OpenClaw, BANKR) to build and run your agent
9+
- Give your agent a wallet to hold stablecoins and sign transactions
10+
- Enable your agent to pay for services automatically using the x402 protocol
11+
- Register and verify agent identity for agent-to-agent trust
12+
- Build agent apps — services designed for agents as the primary user
13+
- Apply Base-specific patterns for trading agents using Flashblocks
14+
15+
## Navigation (with brief descriptions)
16+
17+
### Introduction
18+
- [AI Agents on Base](https://docs.base.org/ai-agents/index.md) — Overview and how pieces fit together
19+
20+
### Core Concepts
21+
- [Frameworks](https://docs.base.org/ai-agents/core-concepts/agent-frameworks.md) — Agent SDK, OpenClaw, BANKR comparison
22+
- [Wallets](https://docs.base.org/ai-agents/core-concepts/wallets.md) — Wallet options and setup
23+
- [Payments & Transactions](https://docs.base.org/ai-agents/core-concepts/payments-and-transactions.md) — x402 and skills
24+
- [Identity, Verification & Auth](https://docs.base.org/ai-agents/core-concepts/identity-verification-auth.md) — Agent identity and trust
25+
- [Agent Apps](https://docs.base.org/ai-agents/core-concepts/agent-apps.md) — Build agent-first services
26+
27+
### Advanced
28+
- [Trading on Base](https://docs.base.org/ai-agents/trading.md) — Flashblocks, fee calibration, trading signals
29+
30+
31+
## Key Concepts (excerpts)
32+
33+
Source: `https://docs.base.org/ai-agents/index.md`
34+
35+
Base gives your AI agent the tools to operate as an independent economic actor:
36+
- **Framework**: Self-hosted SDK, open-source assistant (OpenClaw), or managed API (BANKR)
37+
- **Wallet**: Hold stablecoins, send payments, and sign transactions onchain
38+
- **Payments**: Pay for API access with stablecoins using the x402 pay-per-request protocol
39+
- **Identity**: Register your agent in a public directory so other agents and services can discover and verify it
40+
- **Agent Apps**: Create services designed for agents, exposing structured endpoints agents can call programmatically
41+
42+
Source: `https://docs.base.org/ai-agents/core-concepts/agent-frameworks.md`
43+
44+
Framework comparison:
45+
- **BANKR** — Managed Agent API with skill and wallet plugins; best for fast deployment
46+
- **OpenClaw** — Open-source personal AI assistant (Discord, Telegram, web); best for multi-channel agents
47+
- **Agent SDK** — Developer toolkit for custom agents with full control over behavior and integrations
48+
49+
Source: `https://docs.base.org/ai-agents/core-concepts/wallets.md`
50+
51+
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.
52+
53+
Source: `https://docs.base.org/ai-agents/core-concepts/payments-and-transactions.md`
54+
55+
- **x402 protocol**: Agents pay for services automatically with stablecoins on a per-request basis, no human approval required
56+
- **Skills**: Pre-built onchain actions (swaps, transfers, contract calls) that your agent can perform through a structured API
57+
58+
Source: `https://docs.base.org/ai-agents/core-concepts/identity-verification-auth.md`
59+
60+
- Agents register in a public directory with verifiable credentials
61+
- Other agents and services can look up and verify identity before trusting
62+
- Authentication flows designed for machine-to-machine (no human in the loop)
63+
64+
Source: `https://docs.base.org/ai-agents/core-concepts/agent-apps.md`
65+
66+
- Agent apps expose structured endpoints (not visual UIs) that agents can discover and call
67+
- Make your service discoverable by registering it in the agent directory
68+
- Design APIs with explicit schemas so agents can reason about inputs and outputs
69+
70+
71+
## Trading Agents (excerpts)
72+
73+
Source: `https://docs.base.org/ai-agents/trading.md`
74+
75+
Base offers two structural advantages for trading agents:
76+
- **Flashblocks**: 200ms preconfirmed block state, 10× faster than the 2-second block
77+
- **Exposed L1/L2 fee structure**: Enables explicit cost-vs-speed tradeoffs
78+
79+
Key patterns:
80+
- Connect to `mainnet-preconf.base.org` for all reads and submissions to access Flashblocks pending state
81+
- Simulate with `eth_simulateV1` against preconfirmed state before signing any transaction
82+
- Poll `base_transactionStatus` (not `eth_getTransactionReceipt`) for low-latency inclusion status (~200ms)
83+
- Use `eth_feeHistory` over last 5–10 blocks with reward percentiles `[50, 90]` for fee calibration
84+
85+
Fee calibration:
86+
```
87+
maxFeePerGas = nextBaseFee * 2 + maxPriorityFeePerGas
88+
```
89+
90+
L1 fee decision rule — if this ratio exceeds 0.8, L1 fee dominates; consider deferring small trades:
91+
```
92+
l1FeeUpperBound / (gasLimit × maxFeePerGas + l1FeeUpperBound) > 0.8
93+
```
94+
95+
Key Flashblocks signals for trading:
96+
- `eth_getBlockByNumber("pending")` on preconf endpoint — preconfirmed pending block state (200ms early)
97+
- `eth_subscribe("newFlashblockTransactions")` — first-mover on large trades entering the block
98+
- `eth_subscribe("pendingLogs", { address, topics })` — detect liquidation thresholds and oracle updates before finality

docs/ai-agents/llms.txt

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# https://docs.base.org/ai-agents/llms.txt
2+
3+
## AI Agents Documentation
4+
5+
> Build AI agents that operate as independent economic actors on Base — with wallets, payments, identity, and agent-to-agent discovery built in.
6+
7+
## Introduction
8+
- [AI Agents on Base](https://docs.base.org/ai-agents/index.md) — What you can build and how the pieces fit together
9+
10+
## Core Concepts
11+
- [Frameworks](https://docs.base.org/ai-agents/core-concepts/agent-frameworks.md) — Choose between Agent SDK, OpenClaw, and BANKR
12+
- [Wallets](https://docs.base.org/ai-agents/core-concepts/wallets.md) — Give your agent the ability to hold funds and sign transactions
13+
- [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
14+
- [Identity, Verification & Auth](https://docs.base.org/ai-agents/core-concepts/identity-verification-auth.md) — Register, discover, and verify agents
15+
- [Agent Apps](https://docs.base.org/ai-agents/core-concepts/agent-apps.md) — Build services with agents as the primary user
16+
17+
## Advanced
18+
- [Trading on Base](https://docs.base.org/ai-agents/trading.md) — Flashblocks patterns, fee calibration, and onchain signals for trading agents
19+

docs/base-account/llms-full.txt

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,8 +47,13 @@ const { status } = await getPaymentStatus({ id })
4747
- [Wagmi Base Pay](https://docs.base.org/base-account/framework-integrations/wagmi/base-pay.md) — Payments
4848
- [Wagmi Other Use Cases](https://docs.base.org/base-account/framework-integrations/wagmi/other-use-cases.md) — Patterns
4949
- [Privy Setup](https://docs.base.org/base-account/framework-integrations/privy/setup.md) — Privy
50+
- [Privy Authentication](https://docs.base.org/base-account/framework-integrations/privy/authentication.md) — Privy auth
5051
- [Privy Sub‑Accounts](https://docs.base.org/base-account/framework-integrations/privy/sub-accounts.md) — Privy sub‑accounts
51-
- [Dynamic](https://docs.base.org/base-account/framework-integrations/nextjs-with-dynamic.md) — Dynamic integration
52+
- [Privy Spend Permissions](https://docs.base.org/base-account/framework-integrations/privy/spend-permissions.md) — Privy spend permissions
53+
- [RainbowKit](https://docs.base.org/base-account/framework-integrations/rainbowkit.md) — RainbowKit integration
54+
- [Reown](https://docs.base.org/base-account/framework-integrations/reown.md) — Reown integration
55+
- [Thirdweb](https://docs.base.org/base-account/framework-integrations/thirdweb.md) — Thirdweb integration
56+
- [CDP](https://docs.base.org/base-account/framework-integrations/cdp.md) — CDP integration
5257

5358
### Reference (selected)
5459
- [SDK: createBaseAccount](https://docs.base.org/base-account/reference/core/createBaseAccount.md)

docs/base-account/llms.txt

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,10 +14,14 @@
1414
## Guides
1515
- [Authenticate Users](https://docs.base.org/base-account/guides/authenticate-users.md) — SIWE with ERC‑6492 signatures
1616
- [Accept Payments](https://docs.base.org/base-account/guides/accept-payments.md) — One‑tap USDC payments with Base Pay
17+
- [Accept Recurring Payments](https://docs.base.org/base-account/guides/accept-recurring-payments.md) — Subscription payments with Base Pay
1718

1819
## Framework Integrations
1920
- [Wagmi: Setup](https://docs.base.org/base-account/framework-integrations/wagmi/setup.md) — Configure connectors and chains
2021
- [Privy: Setup](https://docs.base.org/base-account/framework-integrations/privy/setup.md) — Authentication + sub‑accounts
22+
- [RainbowKit](https://docs.base.org/base-account/framework-integrations/rainbowkit.md) — RainbowKit integration
23+
- [Reown](https://docs.base.org/base-account/framework-integrations/reown.md) — Reown integration
24+
- [CDP](https://docs.base.org/base-account/framework-integrations/cdp.md) — CDP integration
2125

2226
## Reference
2327
- [Account SDK: createBaseAccount](https://docs.base.org/base-account/reference/core/createBaseAccount.md) — Initialize SDK and provider

docs/base-chain/llms-full.txt

Lines changed: 11 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -19,20 +19,23 @@
1919
- [Why Base](https://docs.base.org/base-chain/quickstart/why-base.md) — Platform value prop
2020
- [Deploy on Base](https://docs.base.org/base-chain/quickstart/deploy-on-base.md) — Deploy contracts (Foundry)
2121
- [Connecting to Base](https://docs.base.org/base-chain/quickstart/connecting-to-base.md) — App connectivity
22-
- [Bridge Token](https://docs.base.org/base-chain/quickstart/bridge-token.md) — Transfer assets to Base
22+
- [Base-Solana Bridge](https://docs.base.org/base-chain/quickstart/base-solana-bridge.md) — Bridge between Base and Solana
2323

2424
### Network Information
2525
- [Base Contracts](https://docs.base.org/base-chain/network-information/base-contracts.md) — Canonical addresses
2626
- [Network Fees](https://docs.base.org/base-chain/network-information/network-fees.md) — Fee model
2727
- [Ecosystem Contracts](https://docs.base.org/base-chain/network-information/ecosystem-contracts.md) — Third‑party addresses
2828
- [Block Building](https://docs.base.org/base-chain/network-information/block-building.md) — Block production
2929
- [Diffs vs Ethereum](https://docs.base.org/base-chain/network-information/diffs-ethereum-base.md) — Differences from L1
30-
- [Bridges (Mainnet)](https://docs.base.org/base-chain/network-information/bridges-mainnet.md) — Bridges
30+
- [Bridges](https://docs.base.org/base-chain/network-information/bridges.md) — Bridges
31+
- [Transaction Finality](https://docs.base.org/base-chain/network-information/transaction-finality.md) — Finality model
32+
- [Configuration Changelog](https://docs.base.org/base-chain/network-information/configuration-changelog.md) — Network config changes
3133

3234
### Flashblocks
3335
- [Apps](https://docs.base.org/base-chain/flashblocks/apps.md) — Apps using Flashblocks
3436
- [Node Providers](https://docs.base.org/base-chain/flashblocks/node-providers.md) — Infra providers
3537
- [Docs](https://docs.base.org/base-chain/flashblocks/docs.md) — Documentation
38+
- [API Reference](https://docs.base.org/base-chain/flashblocks/api-reference.md) — Flashblocks API reference
3639

3740
### Node Operators
3841
- [Run a Base Node](https://docs.base.org/base-chain/node-operators/run-a-base-node.md) — Node setup
@@ -54,10 +57,14 @@
5457
- [Oracles](https://docs.base.org/base-chain/tools/oracles.md) — Oracle providers
5558
- [Tokens in Wallet](https://docs.base.org/base-chain/tools/tokens-in-wallet.md) — Token inclusion
5659

60+
### Reference
61+
- [JSON-RPC API](https://docs.base.org/base-chain/reference/json-rpc-api.md) — Base JSON-RPC API reference
62+
5763
### Security
5864
- [Security Council](https://docs.base.org/base-chain/security/security-council.md) — Security governance
5965
- [Avoid Malicious Flags](https://docs.base.org/base-chain/security/avoid-malicious-flags.md) — App‑blocklist
6066
- [Report a Vulnerability](https://docs.base.org/base-chain/security/report-vulnerability.md) — Reporting
67+
- [Bug Bounty](https://docs.base.org/base-chain/security/bug-bounty.md) — Bug bounty program
6168

6269

6370
## Quickstart (excerpts)
@@ -95,7 +102,7 @@ Source: `https://docs.base.org/base-chain/network-information/diffs-ethereum-bas
95102
- Canonical contracts: Use published address lists for bridges, system contracts, and registry.
96103
- Source: `https://docs.base.org/base-chain/network-information/base-contracts.md`
97104
- Bridges: Official and third‑party bridge options for moving assets to/from Base.
98-
- Source: `https://docs.base.org/base-chain/network-information/bridges-mainnet.md`
105+
- Source: `https://docs.base.org/base-chain/network-information/bridges.md`
99106

100107

101108
## APIs and Tooling (pruned)
@@ -141,6 +148,7 @@ Sources:
141148
- `https://docs.base.org/base-chain/flashblocks/docs.md`
142149
- `https://docs.base.org/base-chain/flashblocks/apps.md`
143150
- `https://docs.base.org/base-chain/flashblocks/node-providers.md`
151+
- `https://docs.base.org/base-chain/flashblocks/api-reference.md`
144152

145153
- Overview: Flashblocks resources aggregate information for builders and infra partners who need reliable, low‑latency access patterns on Base.
146154
- Ecosystem: Review apps that make use of Flashblocks‑related infra and the node providers who support relevant capabilities.
@@ -159,17 +167,6 @@ console.log('latencyMs', Date.now() - t0, 'number', block.number)
159167

160168
## Examples (common flows)
161169

162-
Example: Bridge a token to Base (conceptual)
163-
164-
Source: `https://docs.base.org/base-chain/quickstart/bridge-token.md`
165-
166-
```text
167-
1) Visit the official bridge UI
168-
2) Select network (Ethereum → Base)
169-
3) Choose asset and amount
170-
4) Review fees and confirm
171-
```
172-
173170
Example: Read a contract on Base with Viem
174171

175172
Source: `https://docs.base.org/base-chain/quickstart/connecting-to-base.md`
@@ -181,4 +178,3 @@ import { base } from 'viem/chains'
181178
const client = createPublicClient({ chain: base, transport: http() })
182179
const totalSupply = await client.readContract({ address: USDC, abi, functionName: 'totalSupply' })
183180
```
184-

docs/base-chain/llms.txt

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,14 +7,17 @@
77
## Quickstart
88
- [Deploy on Base](https://docs.base.org/base-chain/quickstart/deploy-on-base.md) — Set up Foundry, configure RPCs, and deploy your first contract
99
- [Connecting to Base](https://docs.base.org/base-chain/quickstart/connecting-to-base.md) — Configure providers and clients to read/write on Base
10+
- [Base-Solana Bridge](https://docs.base.org/base-chain/quickstart/base-solana-bridge.md) — Bridge assets between Base and Solana
1011

1112
## Network Information
1213
- [Network Fees](https://docs.base.org/base-chain/network-information/network-fees.md) — L2 execution and L1 data costs on Base
1314
- [Base Contracts](https://docs.base.org/base-chain/network-information/base-contracts.md) — Core contracts and addresses
15+
- [Bridges](https://docs.base.org/base-chain/network-information/bridges.md) — Official and third-party bridge options
1416

1517
## Flashblocks
1618
- [FAQ](https://docs.base.org/base-chain/flashblocks/docs.md) — Frequently asked questions about Flashblocks
1719
- [Apps](https://docs.base.org/base-chain/flashblocks/apps.md) — How apps integrate with Flashblocks
20+
- [API Reference](https://docs.base.org/base-chain/flashblocks/api-reference.md) — Flashblocks API reference
1821

1922
## Node Operators
2023
- [Run a Base Node](https://docs.base.org/base-chain/node-operators/run-a-base-node.md) — Setup and operations guide
@@ -31,5 +34,5 @@
3134
## Optional
3235
- [Block Explorers](https://docs.base.org/base-chain/tools/block-explorers.md) — Inspect contracts and transactions on Base
3336
- [Ecosystem Contracts](https://docs.base.org/base-chain/network-information/ecosystem-contracts.md) — Common ecosystem contract addresses
34-
37+
- [JSON-RPC API](https://docs.base.org/base-chain/reference/json-rpc-api.md) — Base JSON-RPC API reference
3538

docs/get-started/llms-full.txt

Lines changed: 8 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,40 +2,37 @@
22

33
## Get Started — Deep Guide for LLMs
44

5-
> Orientation hub for Base: what Base is, how to browse products and use cases, and quickstarts to build apps, tokens, chains, and contracts.
5+
> Orientation hub for Base: what Base is, how to browse products and use cases, and quickstarts to build apps, tokens, and contracts.
66

77
### What you can do here
8-
- Understand Bases value prop and ecosystem
9-
- Explore products and use cases
10-
- Follow quickstarts to build app/token/chain/contracts
8+
- Understand Base's value prop and ecosystem
9+
- Explore core concepts
10+
- Follow quickstarts to build app/token/contracts
1111
- Find funding, services, and community support
1212
- Use AI prompting resources and prompt library
1313

1414
## Navigation (with brief descriptions)
1515

1616
### Introduction
1717
- [Base](https://docs.base.org/get-started/base.md) — Why Base, platform overview
18-
19-
### Browse by
20-
- [Products](https://docs.base.org/get-started/products.md) — Product index and entry points
21-
- [Use Cases](https://docs.base.org/get-started/use-cases.md) — Scenario‑based navigation
18+
- [Concepts](https://docs.base.org/get-started/concepts.md) — Core concepts and terminology
2219

2320
### Quickstart
2421
- [Build an App](https://docs.base.org/get-started/build-app.md) — Ship an app on Base
2522
- [Launch a Token](https://docs.base.org/get-started/launch-token.md) — Token planning and launch
26-
- [Deploy a Chain](https://docs.base.org/get-started/deploy-chain.md) — OP Stack chain
2723
- [Deploy Smart Contracts](https://docs.base.org/get-started/deploy-smart-contracts.md) — Contracts
2824

2925
### Builder Support
3026
- [Get Funded](https://docs.base.org/get-started/get-funded.md) — Grants and programs
3127
- [Base Services Hub](https://docs.base.org/get-started/base-services-hub.md) — Official services/tools
3228
- [Country Leads & Ambassadors](https://docs.base.org/get-started/country-leads-and-ambassadors.md) — Community
29+
- [Learning Resources](https://docs.base.org/get-started/learning-resources.md) — Tutorials and guides
3330

3431
### Build with AI
35-
- [AI Prompting](https://docs.base.org/get-started/ai-prompting.md) — AI productivity patterns
32+
- [Docs LLMs](https://docs.base.org/get-started/docs-llms.md) — How to use these docs with AI tools
33+
- [Docs MCP](https://docs.base.org/get-started/docs-mcp.md) — Model Context Protocol integration
3634
- [Prompt Library](https://docs.base.org/get-started/prompt-library.md) — Reusable prompts
3735

3836
## Minimal Critical Code
3937
None — this section is orientation and navigation. See product sections for code.
4038

41-

0 commit comments

Comments
 (0)