Skip to content

Commit b345634

Browse files
committed
docs(llms): append .md to absolute internal docs URLs in llms-full shards; keep .txt links unchanged
1 parent 2d2f1fd commit b345634

6 files changed

Lines changed: 85 additions & 85 deletions

File tree

docs/base-account/llms-full.txt

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,7 @@ const { status } = await getPaymentStatus({ id })
7777

7878
## Quickstart (excerpts)
7979

80-
Source: `https://docs.base.org/base-account/quickstart/web`
80+
Source: `https://docs.base.org/base-account/quickstart/web.md`
8181

8282
Base Account lets you add a passkey‑secured ERC‑4337 smart account to your app, with sponsored gas, batch transactions, spend permissions, and sub‑accounts.
8383

@@ -122,13 +122,13 @@ const result = await account.provider.request({
122122
Expected result: a single ERC‑4337 userOp executes both calls atomically. Combine with a paymaster to sponsor user gas.
123123

124124
Additional sources:
125-
- `https://docs.base.org/base-account/quickstart/mobile-integration`
126-
- `https://docs.base.org/base-account/framework-integrations/wagmi/setup`
125+
- `https://docs.base.org/base-account/quickstart/mobile-integration.md`
126+
- `https://docs.base.org/base-account/framework-integrations/wagmi/setup.md`
127127

128128

129129
## Key Concepts (excerpts)
130130

131-
Source: `https://docs.base.org/base-account/overview/what-is-base-account`
131+
Source: `https://docs.base.org/base-account/overview/what-is-base-account.md`
132132

133133
- Ownership model: A Base Account is owned by an EOA or another smart wallet. Ownership can be rotated via recovery flows, and sub‑accounts can be created for app‑scoped spend.
134134
- Recovery: Supports social/device delegates with threshold approval. Ownership only changes after quorum is met and verification passes.
@@ -139,31 +139,31 @@ Source: `https://docs.base.org/base-account/overview/what-is-base-account`
139139
- Security assumptions: Only configured owner(s) can authorize changes. Recovery requires meeting your policy’s threshold.
140140

141141
Additional sources:
142-
- `https://docs.base.org/base-account/overview/architecture`
143-
- `https://docs.base.org/base-account/improve-ux/spend-permissions`
144-
- `https://docs.base.org/base-account/improve-ux/sponsor-gas/paymasters`
145-
- `https://docs.base.org/base-account/improve-ux/batch-transactions`
142+
- `https://docs.base.org/base-account/overview/architecture.md`
143+
- `https://docs.base.org/base-account/improve-ux/spend-permissions.md`
144+
- `https://docs.base.org/base-account/improve-ux/sponsor-gas/paymasters.md`
145+
- `https://docs.base.org/base-account/improve-ux/batch-transactions.md`
146146

147147

148148
## API Reference (selected, pruned)
149149

150150
Provider RPC methods (subset)
151151

152152
- `wallet_sendCalls(params)` — Execute one or more calls in a single ERC‑4337 user operation. Returns a user operation hash.
153-
- Source: `https://docs.base.org/base-account/reference/core/provider-rpc-methods/wallet_sendCalls`
153+
- Source: `https://docs.base.org/base-account/reference/core/provider-rpc-methods/wallet_sendCalls.md`
154154
- `wallet_getCapabilities()` — Return wallet features and limits supported by the provider.
155-
- Source: `https://docs.base.org/base-account/reference/core/provider-rpc-methods/request-overview`
155+
- Source: `https://docs.base.org/base-account/reference/core/provider-rpc-methods/request-overview.md`
156156

157157
SDK helpers (subset)
158158

159159
- `createBaseAccount(options)` — Initialize SDK and get a configured provider and helpers
160-
- Source: `https://docs.base.org/base-account/reference/core/createBaseAccount`
160+
- Source: `https://docs.base.org/base-account/reference/core/createBaseAccount.md`
161161
- `getProvider()` — Access the EIP‑1193 provider wired to Base Account
162-
- Source: `https://docs.base.org/base-account/reference/core/getProvider`
162+
- Source: `https://docs.base.org/base-account/reference/core/getProvider.md`
163163
- `createSubAccount({ label })` — Create an app‑scoped sub‑account
164-
- Source: `https://docs.base.org/base-account/reference/core/capabilities/overview`
164+
- Source: `https://docs.base.org/base-account/reference/core/capabilities/overview.md`
165165
- `pay({ amount, to, testnet })` and `getPaymentStatus({ id })` — Base Pay helpers for USDC flows
166-
- Source: `https://docs.base.org/base-account/guides/accept-payments`
166+
- Source: `https://docs.base.org/base-account/guides/accept-payments.md`
167167

168168
Minimal request example for `wallet_sendCalls`:
169169

@@ -187,7 +187,7 @@ Minimal request example for `wallet_sendCalls`:
187187

188188
Example: Authenticate user with SIWE + ERC‑6492
189189

190-
Source: `https://docs.base.org/base-account/guides/authenticate-users`
190+
Source: `https://docs.base.org/base-account/guides/authenticate-users.md`
191191

192192
```ts
193193
// Sign‑in with Ethereum using a 6492‑compatible signature
@@ -199,8 +199,8 @@ const signature = await provider.request({ method: 'personal_sign', params: [mes
199199
Example: USDC checkout with paymaster sponsorship
200200

201201
Sources:
202-
- `https://docs.base.org/base-account/guides/accept-payments`
203-
- `https://docs.base.org/base-account/improve-ux/sponsor-gas/paymasters`
202+
- `https://docs.base.org/base-account/guides/accept-payments.md`
203+
- `https://docs.base.org/base-account/improve-ux/sponsor-gas/paymasters.md`
204204

205205
```ts
206206
await provider.request({
@@ -217,7 +217,7 @@ await provider.request({
217217

218218
Example: Create and use a sub‑account for scoped spend
219219

220-
Source: `https://docs.base.org/base-account/improve-ux/sub-accounts`
220+
Source: `https://docs.base.org/base-account/improve-ux/sub-accounts.md`
221221

222222
```ts
223223
const sub = await account.createSubAccount({ label: 'checkout' })

docs/base-app/llms-full.txt

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ for await (const msg of await client.conversations.streamAllMessages()) {
4343

4444
## Quickstart (excerpts)
4545

46-
Source: `https://docs.base.org/base-app/agents/getting-started`
46+
Source: `https://docs.base.org/base-app/agents/getting-started.md`
4747

4848
Create an XMTP agent that can receive messages and reply, then evolve it to surface transaction trays for safe onchain actions.
4949

@@ -65,28 +65,28 @@ for await (const msg of await client.conversations.streamAllMessages()) {
6565
}
6666
```
6767

68-
Source: `https://docs.base.org/base-app/agents/transaction-trays`
68+
Source: `https://docs.base.org/base-app/agents/transaction-trays.md`
6969

7070
Transaction trays let you surface predefined, safe actions. Users approve in‑app; your agent never holds keys.
7171

7272

7373
## Key Concepts (excerpts)
7474

75-
Source: `https://docs.base.org/base-app/agents/why-agents`
75+
Source: `https://docs.base.org/base-app/agents/why-agents.md`
7676

7777
- Safety: Agents propose actions; users approve in Base App with a smart wallet. No private keys leave the client.
7878
- UX: Transaction trays standardize onchain actions, reduce phishing, and help users understand intent.
7979
- Content types: Structured messages ensure predictable parsing and rendering across clients.
80-
- Source: `https://docs.base.org/base-app/agents/content-types`
80+
- Source: `https://docs.base.org/base-app/agents/content-types.md`
8181
- Distribution: Follow the featuring checklist to maximize discovery.
82-
- Source: `https://docs.base.org/base-app/agents/getting-featured`
82+
- Source: `https://docs.base.org/base-app/agents/getting-featured.md`
8383

8484

8585
## API and Schemas (pruned)
8686

8787
Message content types (subset):
8888
- Text, Button, Form, Transaction Tray
89-
- Source: `https://docs.base.org/base-app/agents/content-types`
89+
- Source: `https://docs.base.org/base-app/agents/content-types.md`
9090

9191
Transaction tray schema (conceptual):
9292

@@ -105,7 +105,7 @@ Transaction tray schema (conceptual):
105105

106106
Example: Simple echo agent with guardrails
107107

108-
Source: `https://docs.base.org/base-app/agents/best-practices`
108+
Source: `https://docs.base.org/base-app/agents/best-practices.md`
109109

110110
```ts
111111
if (!isSupportedContentType(msg)) return
@@ -116,7 +116,7 @@ await convo.send(text)
116116

117117
Example: Surface a checkout action as a transaction tray
118118

119-
Source: `https://docs.base.org/base-app/agents/transaction-trays`
119+
Source: `https://docs.base.org/base-app/agents/transaction-trays.md`
120120

121121
```ts
122122
await convo.send({

docs/base-chain/llms-full.txt

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@
6262

6363
## Quickstart (excerpts)
6464

65-
Source: `https://docs.base.org/base-chain/quickstart/deploy-on-base`
65+
Source: `https://docs.base.org/base-chain/quickstart/deploy-on-base.md`
6666

6767
Deploy with Foundry to Base Sepolia:
6868

@@ -73,7 +73,7 @@ forge create src/Contract.sol:Contract \
7373
--verify --verifier blockscout --verifier-url https://base-sepolia.blockscout.com/api
7474
```
7575

76-
Source: `https://docs.base.org/base-chain/quickstart/connecting-to-base`
76+
Source: `https://docs.base.org/base-chain/quickstart/connecting-to-base.md`
7777

7878
Connect a client to Base:
7979

@@ -87,36 +87,36 @@ const client = createPublicClient({ chain: base, transport: http() })
8787

8888
## Key Concepts (excerpts)
8989

90-
Source: `https://docs.base.org/base-chain/network-information/diffs-ethereum-base`
90+
Source: `https://docs.base.org/base-chain/network-information/diffs-ethereum-base.md`
9191

9292
- OP Stack rollup: Base batches L2 transactions and posts data to Ethereum L1, inheriting L1 security.
9393
- Fees: Total includes L2 execution and L1 data costs. See fee breakdown and estimator.
94-
- Source: `https://docs.base.org/base-chain/network-information/network-fees`
94+
- Source: `https://docs.base.org/base-chain/network-information/network-fees.md`
9595
- Canonical contracts: Use published address lists for bridges, system contracts, and registry.
96-
- Source: `https://docs.base.org/base-chain/network-information/base-contracts`
96+
- Source: `https://docs.base.org/base-chain/network-information/base-contracts.md`
9797
- 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`
98+
- Source: `https://docs.base.org/base-chain/network-information/bridges-mainnet.md`
9999

100100

101101
## APIs and Tooling (pruned)
102102

103103
- Onchain Registry API — discover verified projects and data on Base
104-
- Source: `https://docs.base.org/base-chain/tools/onchain-registry-api`
104+
- Source: `https://docs.base.org/base-chain/tools/onchain-registry-api.md`
105105
- Node Providers — RPC endpoints for Base and Base Sepolia
106-
- Source: `https://docs.base.org/base-chain/tools/node-providers`
106+
- Source: `https://docs.base.org/base-chain/tools/node-providers.md`
107107
- Block Explorers — Basescan and Blockscout URLs
108-
- Source: `https://docs.base.org/base-chain/tools/block-explorers`
108+
- Source: `https://docs.base.org/base-chain/tools/block-explorers.md`
109109
- Faucets — Get test ETH for Base Sepolia
110-
- Source: `https://docs.base.org/base-chain/tools/network-faucets`
110+
- Source: `https://docs.base.org/base-chain/tools/network-faucets.md`
111111

112112

113113
## Node Operations (excerpts)
114114

115115
Sources:
116-
- `https://docs.base.org/base-chain/node-operators/run-a-base-node`
117-
- `https://docs.base.org/base-chain/node-operators/performance-tuning`
118-
- `https://docs.base.org/base-chain/node-operators/snapshots`
119-
- `https://docs.base.org/base-chain/node-operators/troubleshooting`
116+
- `https://docs.base.org/base-chain/node-operators/run-a-base-node.md`
117+
- `https://docs.base.org/base-chain/node-operators/performance-tuning.md`
118+
- `https://docs.base.org/base-chain/node-operators/snapshots.md`
119+
- `https://docs.base.org/base-chain/node-operators/troubleshooting.md`
120120

121121
- Architecture: Operate a rollup (consensus) node paired with an execution client. Ensure both services are healthy and in sync.
122122
- Provisioning: Use SSD storage, reliable network, and adhere to the current requirements listed in the run‑a‑node guide. Prefer containerized or systemd‑managed services for resilience.
@@ -138,9 +138,9 @@ curl -s -X POST "$BASE_RPC" -H 'content-type: application/json' \
138138
## Flashblocks (excerpts)
139139

140140
Sources:
141-
- `https://docs.base.org/base-chain/flashblocks/docs`
142-
- `https://docs.base.org/base-chain/flashblocks/apps`
143-
- `https://docs.base.org/base-chain/flashblocks/node-providers`
141+
- `https://docs.base.org/base-chain/flashblocks/docs.md`
142+
- `https://docs.base.org/base-chain/flashblocks/apps.md`
143+
- `https://docs.base.org/base-chain/flashblocks/node-providers.md`
144144

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

162162
Example: Bridge a token to Base (conceptual)
163163

164-
Source: `https://docs.base.org/base-chain/quickstart/bridge-token`
164+
Source: `https://docs.base.org/base-chain/quickstart/bridge-token.md`
165165

166166
```text
167167
1) Visit the official bridge UI
@@ -172,7 +172,7 @@ Source: `https://docs.base.org/base-chain/quickstart/bridge-token`
172172

173173
Example: Read a contract on Base with Viem
174174

175-
Source: `https://docs.base.org/base-chain/quickstart/connecting-to-base`
175+
Source: `https://docs.base.org/base-chain/quickstart/connecting-to-base.md`
176176

177177
```ts
178178
import { createPublicClient, http } from 'viem'

docs/llms-full.txt

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -12,31 +12,31 @@
1212

1313
### Networks and environments
1414
Sources:
15-
- `https://docs.base.org/base-chain/quickstart/connecting-to-base`
16-
- `https://docs.base.org/base-chain/network-information/diffs-ethereum-base`
17-
- `https://docs.base.org/base-chain/tools/node-providers`
15+
- `https://docs.base.org/base-chain/quickstart/connecting-to-base.md`
16+
- `https://docs.base.org/base-chain/network-information/diffs-ethereum-base.md`
17+
- `https://docs.base.org/base-chain/tools/node-providers.md`
1818

1919
> Base runs on Ethereum L2 with mainnet and Base Sepolia testnet. Use official RPCs from trusted node providers. Typical chain IDs: Base mainnet (8453), Base Sepolia (84532). Prefer HTTPS RPCs behind TLS, pin to provider domains, and handle occasional reorgs. For clients (e.g., Viem), configure the chain and transport explicitly; avoid relying on window-injected providers in server contexts.
2020

2121
### Authentication and API usage
2222
Sources:
23-
- `https://docs.base.org/base-account/guides/authenticate-users`
24-
- `https://docs.base.org/mini-apps/features/Authentication`
25-
- `https://docs.base.org/onchainkit/config/onchainkit-provider`
23+
- `https://docs.base.org/base-account/guides/authenticate-users.md`
24+
- `https://docs.base.org/mini-apps/features/Authentication.md`
25+
- `https://docs.base.org/onchainkit/config/onchainkit-provider.md`
2626

2727
> Auth patterns vary by product. Use SIWE (ERC‑6492 compatible) for user sign-in where smart wallets may not yet exist. In Mini Apps, defer auth until needed; prefer scoped, revocable permissions and transaction trays for intent. For SDK/server APIs (e.g., OnchainKit), supply API keys via environment variables, rotate regularly, and verify server-side signatures or webhooks. Never store user passkeys or raw private keys server-side.
2828

2929
### Errors and retries
3030
Sources:
31-
- `https://docs.base.org/onchainkit/api/get-swap-quote`
32-
- `https://docs.base.org/base-chain/node-operators/troubleshooting`
31+
- `https://docs.base.org/onchainkit/api/get-swap-quote.md`
32+
- `https://docs.base.org/base-chain/node-operators/troubleshooting.md`
3333

3434
> Expect standard JSON error envelopes with `code`, `message`, and optional `details`. Treat 429 as rate-limited: respect `Retry-After` and apply exponential backoff with jitter. For idempotent operations (payments, tx-build), include an idempotency key if supported. Distinguish user-declined actions from transport or server errors and surface clear recovery guidance to users.
3535

3636
### Rate limits
3737
Sources:
38-
- `https://docs.base.org/onchainkit/api/get-tokens`
39-
- `https://docs.base.org/base-chain/tools/node-providers`
38+
- `https://docs.base.org/onchainkit/api/get-tokens.md`
39+
- `https://docs.base.org/base-chain/tools/node-providers.md`
4040

4141
> Rate limits vary by provider and endpoint. Batch reads when possible, cache static metadata, and use conditional requests. On 429, back off and retry after the indicated window. Avoid concurrent duplicate builds/quotes; fan out only when necessary.
4242

0 commit comments

Comments
 (0)