From 3c2803c14e1a96233cde3314be425b6130b5cc9c Mon Sep 17 00:00:00 2001 From: sohey Date: Mon, 17 Aug 2026 21:05:38 +0200 Subject: [PATCH 1/8] added temp changelog tab --- docs/AGENTS.md | 4 +- docs/base-chain/changelog.mdx | 14 +++++++ docs/base-chain/changelog/beryl.mdx | 14 +++++++ docs/base-chain/changelog/cobalt/b20.mdx | 49 ++++++++++++++++++++++++ docs/base-chain/changelog/denim.mdx | 8 ++++ docs/docs.json | 29 ++++++++++++++ docs/llms-full.txt | 4 ++ docs/llms.txt | 4 ++ 8 files changed, 125 insertions(+), 1 deletion(-) create mode 100644 docs/base-chain/changelog.mdx create mode 100644 docs/base-chain/changelog/beryl.mdx create mode 100644 docs/base-chain/changelog/cobalt/b20.mdx create mode 100644 docs/base-chain/changelog/denim.mdx diff --git a/docs/AGENTS.md b/docs/AGENTS.md index a1044b1f4..95fb0b671 100644 --- a/docs/AGENTS.md +++ b/docs/AGENTS.md @@ -74,11 +74,13 @@ npx skills add base/base-skills |base-account/reference/prolink-utilities:createProlinkUrl,decodeProlink,encodeProlink |base-account/reference/spend-permission-utilities:fetchPermission,fetchPermissions,getPermissionStatus,prepareRevokeCallData,prepareSpendCallData,requestRevoke,requestSpendPermission |base-account/reference/ui-elements:base-pay-button,brand-guidelines,sign-in-with-base-button -|base-chain:overview +|base-chain:changelog,overview |base-chain/api-reference:rpc-overview |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/changelog:beryl,denim +|base-chain/changelog/cobalt:b20 |base-chain/flashblocks:faq |base-chain/network-information:base-contracts,base-solana-bridge,bridging-and-withdrawals,configuration-changelog,ecosystem-bridges,network-faucets,network-fees,throughput-and-limits,transaction-finality,transaction-ordering,troubleshooting-transactions |base-chain/node-operators:node-providers,performance-tuning,run-a-base-node,snapshots,troubleshooting diff --git a/docs/base-chain/changelog.mdx b/docs/base-chain/changelog.mdx new file mode 100644 index 000000000..26c6ccd50 --- /dev/null +++ b/docs/base-chain/changelog.mdx @@ -0,0 +1,14 @@ +--- +title: "Changelog" +description: "Changes introduced by Base protocol upgrades." +--- + +This changelog tracks developer-facing changes introduced by Base protocol upgrades. + +## Upgrade changelogs + +Select an upgrade in the sidebar to view its changes: + +- [Beryl](/base-chain/changelog/beryl) +- [Cobalt: B20](/base-chain/changelog/cobalt/b20) +- [Denim](/base-chain/changelog/denim) diff --git a/docs/base-chain/changelog/beryl.mdx b/docs/base-chain/changelog/beryl.mdx new file mode 100644 index 000000000..4f9863dbb --- /dev/null +++ b/docs/base-chain/changelog/beryl.mdx @@ -0,0 +1,14 @@ +--- +title: "Beryl" +description: "Developer-facing changes introduced by the Beryl upgrade." +--- + +The Beryl upgrade introduces [B20](/base-chain/specs/upgrades/beryl/b20/specification), Base's +native token standard for stablecoins, real-world assets, and long-tail tokens. It also reduces +the single-proof withdrawal finalization period from seven days to five days and introduces Reth +V2 improvements. + +## More about Beryl + +See the [Beryl overview](/base-chain/specs/upgrades/beryl/overview) for activation dates, +required software versions, and the complete upgrade summary. diff --git a/docs/base-chain/changelog/cobalt/b20.mdx b/docs/base-chain/changelog/cobalt/b20.mdx new file mode 100644 index 000000000..5deedde44 --- /dev/null +++ b/docs/base-chain/changelog/cobalt/b20.mdx @@ -0,0 +1,49 @@ +--- +title: "B20" +description: "B20 changes introduced by the Cobalt upgrade." +--- + +# Cobalt: B20 changes + +Cobalt is additive-only. It does not change or remove any Beryl selector, event topic, or error +selector. Symbols that supersede Beryl symbols are deprecated rather than deleted, so existing +integrations remain callable. + + +Cobalt has not activated yet. The changes below are not callable until Cobalt activates. + + +## B20 Asset: scheduled multiplier updates + +The B20 Asset multiplier surface becomes conformant with [ERC-8056](https://eips.ethereum.org/EIPS/eip-8056): + +- Adds `uiMultiplier`, `toUIAmount`, `fromUIAmount`, `balanceOfUI`, and `totalSupplyUI`. +- Adds `updateUIMultiplier(uint256,uint256)` for scheduling corporate-action multiplier updates. +- Retains `updateMultiplier(uint256)` as an instant administrative failsafe. + +Applications should use the ERC-8056 names and move routine multiplier changes to the scheduled +`updateUIMultiplier` function. + +## B20 Asset and Stablecoin: seize surface + +Cobalt adds `seizeWithMemo`, an administrative balance-reassignment operation gated by +`SEIZE_ROLE`. It also adds a `SEIZE` pause vector and two policy slots. `burnBlocked` is deprecated +in favor of `seizeWithMemo`, but remains callable and unchanged for compatibility. + +Seize is opt-in per token and has no effect until the issuer sets `SEIZE_HOLDER_POLICY`. To destroy +supply after a seizure, call `burn(uint256)` separately. + +## PolicyRegistry: composite policies + +PolicyRegistry adds composite policies that combine two to four existing simple policies using an +OR (`UNION`) or AND (`INTERSECT`) gate. Integrators can create and update them with +`createCompositePolicy` and `updateComposite` instead of duplicating policy logic off-chain. + +Existing `createPolicy` and `createPolicyWithAccounts` integrations do not otherwise change; they +only gain a new revert path for the previously unreachable composite `policyType`. + +## Full Base Standard changelog + +For selector-level details, including exact function selectors, event topics, error codes, and +edge-case behavior, see the [Base Standard changelog](https://github.com/base/base-std/blob/main/CHANGELOG.md). + diff --git a/docs/base-chain/changelog/denim.mdx b/docs/base-chain/changelog/denim.mdx new file mode 100644 index 000000000..8e359b544 --- /dev/null +++ b/docs/base-chain/changelog/denim.mdx @@ -0,0 +1,8 @@ +--- +title: "Denim" +description: "Developer-facing changes introduced by the Denim upgrade." +--- + +## Status + +No Denim changes have been published yet. diff --git a/docs/docs.json b/docs/docs.json index c837b0656..f1af5df73 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -105,6 +105,35 @@ "base-chain/specs/upgrades/beryl/overview" ] }, + { + "group": "Changelog", + "pages": [ + "base-chain/changelog", + { + "group": "Beryl", + "pages": [ + "base-chain/changelog/beryl" + ] + }, + { + "group": "Cobalt", + "pages": [ + { + "group": "B20", + "pages": [ + "base-chain/changelog/cobalt/b20" + ] + } + ] + }, + { + "group": "Denim", + "pages": [ + "base-chain/changelog/denim" + ] + } + ] + }, { "group": "Introduction", "pages": [ diff --git a/docs/llms-full.txt b/docs/llms-full.txt index 54fb9024a..fe7ee013e 100644 --- a/docs/llms-full.txt +++ b/docs/llms-full.txt @@ -163,6 +163,10 @@ const client = createPublicClient({ chain: base, transport: http() }) - [newFlashblockTransactions](https://docs.base.org/base-chain/api-reference/flashblocks-api/newFlashblockTransactions): Subscribe to receive each transaction as it is pre-confirmed into a Flashblock. Only available on Flashblocks WebSocket endpoints. - [pendingLogs](https://docs.base.org/base-chain/api-reference/flashblocks-api/pendingLogs): Subscribe to logs from pre-confirmed transactions matching an optional filter. Only available on Flashblocks WebSocket endpoints. - [Base RPC Overview](https://docs.base.org/base-chain/api-reference/rpc-overview): Complete reference for all JSON-RPC and Flashblocks methods available on Base nodes. +- [Changelog](https://docs.base.org/base-chain/changelog): Changes introduced by Base protocol upgrades. +- [Beryl](https://docs.base.org/base-chain/changelog/beryl): Developer-facing changes introduced by the Beryl upgrade. +- [B20](https://docs.base.org/base-chain/changelog/cobalt/b20): B20 changes introduced by the Cobalt upgrade. +- [Denim](https://docs.base.org/base-chain/changelog/denim): Developer-facing changes introduced by the Denim upgrade. - [Flashblocks Reference](https://docs.base.org/base-chain/flashblocks/faq): Reference for Flashblocks on Base — key concepts, architecture, and frequently asked questions about block building, WebSocket data, RPC usage, and node setup. - [Contract Addresses](https://docs.base.org/base-chain/network-information/base-contracts): A comprehensive list of contract addresses for Base Mainnet and Base Testnet, including links to their respective blockchain explorers. - [Base-Solana Bridge](https://docs.base.org/base-chain/network-information/base-solana-bridge): Bridge tokens and messages between Base and Solana Mainnet diff --git a/docs/llms.txt b/docs/llms.txt index 6a0a726ce..fd108484c 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -75,6 +75,10 @@ - [newFlashblockTransactions](https://docs.base.org/base-chain/api-reference/flashblocks-api/newFlashblockTransactions): Subscribe to receive each transaction as it is pre-confirmed into a Flashblock. Only available on Flashblocks WebSocket endpoints. - [pendingLogs](https://docs.base.org/base-chain/api-reference/flashblocks-api/pendingLogs): Subscribe to logs from pre-confirmed transactions matching an optional filter. Only available on Flashblocks WebSocket endpoints. - [Base RPC Overview](https://docs.base.org/base-chain/api-reference/rpc-overview): Complete reference for all JSON-RPC and Flashblocks methods available on Base nodes. +- [Changelog](https://docs.base.org/base-chain/changelog): Changes introduced by Base protocol upgrades. +- [Beryl](https://docs.base.org/base-chain/changelog/beryl): Developer-facing changes introduced by the Beryl upgrade. +- [B20](https://docs.base.org/base-chain/changelog/cobalt/b20): B20 changes introduced by the Cobalt upgrade. +- [Denim](https://docs.base.org/base-chain/changelog/denim): Developer-facing changes introduced by the Denim upgrade. - [Flashblocks Reference](https://docs.base.org/base-chain/flashblocks/faq): Reference for Flashblocks on Base — key concepts, architecture, and frequently asked questions about block building, WebSocket data, RPC usage, and node setup. - [Contract Addresses](https://docs.base.org/base-chain/network-information/base-contracts): A comprehensive list of contract addresses for Base Mainnet and Base Testnet, including links to their respective blockchain explorers. - [Base-Solana Bridge](https://docs.base.org/base-chain/network-information/base-solana-bridge): Bridge tokens and messages between Base and Solana Mainnet From ba3b20eb82dac9c1e164e360f6c84b2dace29223 Mon Sep 17 00:00:00 2001 From: sohey Date: Mon, 17 Aug 2026 21:11:05 +0200 Subject: [PATCH 2/8] docs: move changelog after protocol specifications --- docs/docs.json | 58 +++++++++++++++++++++++++------------------------- 1 file changed, 29 insertions(+), 29 deletions(-) diff --git a/docs/docs.json b/docs/docs.json index f1af5df73..b68f1495e 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -105,35 +105,6 @@ "base-chain/specs/upgrades/beryl/overview" ] }, - { - "group": "Changelog", - "pages": [ - "base-chain/changelog", - { - "group": "Beryl", - "pages": [ - "base-chain/changelog/beryl" - ] - }, - { - "group": "Cobalt", - "pages": [ - { - "group": "B20", - "pages": [ - "base-chain/changelog/cobalt/b20" - ] - } - ] - }, - { - "group": "Denim", - "pages": [ - "base-chain/changelog/denim" - ] - } - ] - }, { "group": "Introduction", "pages": [ @@ -413,6 +384,35 @@ } ] }, + { + "group": "Changelog", + "pages": [ + "base-chain/changelog", + { + "group": "Beryl", + "pages": [ + "base-chain/changelog/beryl" + ] + }, + { + "group": "Cobalt", + "pages": [ + { + "group": "B20", + "pages": [ + "base-chain/changelog/cobalt/b20" + ] + } + ] + }, + { + "group": "Denim", + "pages": [ + "base-chain/changelog/denim" + ] + } + ] + }, { "group": "Security", "pages": [ From 49ed0f9e13034526fab8f51dac9bd8d3e1f8802e Mon Sep 17 00:00:00 2001 From: sohey Date: Mon, 17 Aug 2026 21:34:12 +0200 Subject: [PATCH 3/8] docs: link Cobalt B20 changelog details --- docs/base-chain/changelog/cobalt/b20.mdx | 29 +++++++++++++----------- 1 file changed, 16 insertions(+), 13 deletions(-) diff --git a/docs/base-chain/changelog/cobalt/b20.mdx b/docs/base-chain/changelog/cobalt/b20.mdx index 5deedde44..33867113d 100644 --- a/docs/base-chain/changelog/cobalt/b20.mdx +++ b/docs/base-chain/changelog/cobalt/b20.mdx @@ -3,8 +3,6 @@ title: "B20" description: "B20 changes introduced by the Cobalt upgrade." --- -# Cobalt: B20 changes - Cobalt is additive-only. It does not change or remove any Beryl selector, event topic, or error selector. Symbols that supersede Beryl symbols are deprecated rather than deleted, so existing integrations remain callable. @@ -15,29 +13,35 @@ Cobalt has not activated yet. The changes below are not callable until Cobalt ac ## B20 Asset: scheduled multiplier updates -The B20 Asset multiplier surface becomes conformant with [ERC-8056](https://eips.ethereum.org/EIPS/eip-8056): +The B20 Asset multiplier surface becomes conformant with [ERC-8056](https://eips.ethereum.org/EIPS/eip-8056) +and the [Base Standard changelog](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes): -- Adds `uiMultiplier`, `toUIAmount`, `fromUIAmount`, `balanceOfUI`, and `totalSupplyUI`. -- Adds `updateUIMultiplier(uint256,uint256)` for scheduling corporate-action multiplier updates. -- Retains `updateMultiplier(uint256)` as an instant administrative failsafe. +- Adds [`uiMultiplier`, `toUIAmount`, `fromUIAmount`, `balanceOfUI`, and `totalSupplyUI`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes). +- Adds [`updateUIMultiplier(uint256,uint256)`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes) for scheduling corporate-action multiplier updates. +- Retains [`updateMultiplier(uint256)`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes) as an instant administrative failsafe. Applications should use the ERC-8056 names and move routine multiplier changes to the scheduled `updateUIMultiplier` function. ## B20 Asset and Stablecoin: seize surface -Cobalt adds `seizeWithMemo`, an administrative balance-reassignment operation gated by -`SEIZE_ROLE`. It also adds a `SEIZE` pause vector and two policy slots. `burnBlocked` is deprecated -in favor of `seizeWithMemo`, but remains callable and unchanged for compatibility. +Cobalt adds [`seizeWithMemo`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes), +an administrative balance-reassignment operation gated by [`SEIZE_ROLE`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes). +It also adds a [`SEIZE`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes) +pause vector and two policy slots. [`burnBlocked`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes) +is deprecated in favor of `seizeWithMemo`, but remains callable and unchanged for compatibility. -Seize is opt-in per token and has no effect until the issuer sets `SEIZE_HOLDER_POLICY`. To destroy -supply after a seizure, call `burn(uint256)` separately. +Seize is opt-in per token and has no effect until the issuer sets +[`SEIZE_HOLDER_POLICY`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes). +To destroy supply after a seizure, call `burn(uint256)` separately. ## PolicyRegistry: composite policies PolicyRegistry adds composite policies that combine two to four existing simple policies using an OR (`UNION`) or AND (`INTERSECT`) gate. Integrators can create and update them with -`createCompositePolicy` and `updateComposite` instead of duplicating policy logic off-chain. +[`createCompositePolicy`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes) +and [`updateComposite`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes) +instead of duplicating policy logic off-chain. Existing `createPolicy` and `createPolicyWithAccounts` integrations do not otherwise change; they only gain a new revert path for the previously unreachable composite `policyType`. @@ -46,4 +50,3 @@ only gain a new revert path for the previously unreachable composite `policyType For selector-level details, including exact function selectors, event topics, error codes, and edge-case behavior, see the [Base Standard changelog](https://github.com/base/base-std/blob/main/CHANGELOG.md). - From 95c7c80d571968e5f24cf5d9d01b50cf2005cc0b Mon Sep 17 00:00:00 2001 From: sohey Date: Mon, 17 Aug 2026 21:43:58 +0200 Subject: [PATCH 4/8] docs: link B20 changes to detailed changelogs --- docs/base-chain/changelog/cobalt/b20.mdx | 29 ++++++++++++------------ 1 file changed, 15 insertions(+), 14 deletions(-) diff --git a/docs/base-chain/changelog/cobalt/b20.mdx b/docs/base-chain/changelog/cobalt/b20.mdx index 33867113d..61e3800de 100644 --- a/docs/base-chain/changelog/cobalt/b20.mdx +++ b/docs/base-chain/changelog/cobalt/b20.mdx @@ -14,33 +14,34 @@ Cobalt has not activated yet. The changes below are not callable until Cobalt ac ## B20 Asset: scheduled multiplier updates The B20 Asset multiplier surface becomes conformant with [ERC-8056](https://eips.ethereum.org/EIPS/eip-8056) -and the [Base Standard changelog](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes): +and the [B20 Asset multiplier migration details](https://github.com/base/base-std/blob/main/changelog/02_Cobalt_B20Asset_multiplier.md): -- Adds [`uiMultiplier`, `toUIAmount`, `fromUIAmount`, `balanceOfUI`, and `totalSupplyUI`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes). -- Adds [`updateUIMultiplier(uint256,uint256)`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes) for scheduling corporate-action multiplier updates. -- Retains [`updateMultiplier(uint256)`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes) as an instant administrative failsafe. +- Adds [`uiMultiplier`, `toUIAmount`, `fromUIAmount`, `balanceOfUI`, and `totalSupplyUI`](https://github.com/base/base-std/blob/main/changelog/02_Cobalt_B20Asset_multiplier.md#functions). +- Adds [`updateUIMultiplier(uint256,uint256)`](https://github.com/base/base-std/blob/main/changelog/02_Cobalt_B20Asset_multiplier.md#scheduled-update-lifecycle) for scheduling corporate-action multiplier updates. +- Retains [`updateMultiplier(uint256)`](https://github.com/base/base-std/blob/main/changelog/02_Cobalt_B20Asset_multiplier.md#updatemultiplieruint256-remains-as-an-instant-admin-failsafe) as an instant administrative failsafe. Applications should use the ERC-8056 names and move routine multiplier changes to the scheduled -`updateUIMultiplier` function. +[`updateUIMultiplier`](https://github.com/base/base-std/blob/main/changelog/02_Cobalt_B20Asset_multiplier.md#scheduled-update-lifecycle) function. ## B20 Asset and Stablecoin: seize surface -Cobalt adds [`seizeWithMemo`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes), -an administrative balance-reassignment operation gated by [`SEIZE_ROLE`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes). -It also adds a [`SEIZE`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes) -pause vector and two policy slots. [`burnBlocked`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes) +Cobalt adds [`seizeWithMemo`](https://github.com/base/base-std/blob/main/changelog/02_Cobalt_B20_seize.md#new-at-cobalt-adopt-these), +an administrative balance-reassignment operation gated by [`SEIZE_ROLE`](https://github.com/base/base-std/blob/main/changelog/02_Cobalt_B20_seize.md#functions). +It also adds a [`SEIZE`](https://github.com/base/base-std/blob/main/changelog/02_Cobalt_B20_seize.md#pause-features) +pause vector and two policy slots. [`burnBlocked`](https://github.com/base/base-std/blob/main/changelog/02_Cobalt_B20_seize.md#burnblocked-is-deprecated-but-unchanged-and-still-dialable) is deprecated in favor of `seizeWithMemo`, but remains callable and unchanged for compatibility. Seize is opt-in per token and has no effect until the issuer sets -[`SEIZE_HOLDER_POLICY`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes). -To destroy supply after a seizure, call `burn(uint256)` separately. +[`SEIZE_HOLDER_POLICY`](https://github.com/base/base-std/blob/main/changelog/02_Cobalt_B20_seize.md#functions). +To destroy supply after a seizure, call [`burn(uint256)`](https://github.com/base/base-std/blob/main/changelog/02_Cobalt_B20_seize.md#burnblocked-is-deprecated-but-unchanged-and-still-dialable) separately. ## PolicyRegistry: composite policies PolicyRegistry adds composite policies that combine two to four existing simple policies using an -OR (`UNION`) or AND (`INTERSECT`) gate. Integrators can create and update them with -[`createCompositePolicy`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes) -and [`updateComposite`](https://github.com/base/base-std/blob/main/CHANGELOG.md#summary-of-changes) +OR (`UNION`) or AND (`INTERSECT`) gate. See the [composite policy details](https://github.com/base/base-std/blob/main/changelog/02_Cobalt_PolicyRegistry_composite_policy.md) +for the selector mapping and edge cases. Integrators can create and update them with +[`createCompositePolicy`](https://github.com/base/base-std/blob/main/changelog/02_Cobalt_PolicyRegistry_composite_policy.md#new-at-cobalt-adopt-these) +and [`updateComposite`](https://github.com/base/base-std/blob/main/changelog/02_Cobalt_PolicyRegistry_composite_policy.md#new-at-cobalt-adopt-these) instead of duplicating policy logic off-chain. Existing `createPolicy` and `createPolicyWithAccounts` integrations do not otherwise change; they From f34df0c040863aafb0e89d1437ba1f05a25cbc9f Mon Sep 17 00:00:00 2001 From: sohey Date: Tue, 18 Aug 2026 14:42:09 +0200 Subject: [PATCH 5/8] docs: flatten B20 changelog navigation --- docs/AGENTS.md | 2 +- docs/base-chain/changelog.mdx | 2 +- docs/base-chain/changelog/{cobalt => }/b20.mdx | 0 docs/docs.json | 12 +----------- docs/llms-full.txt | 2 +- docs/llms.txt | 2 +- 6 files changed, 5 insertions(+), 15 deletions(-) rename docs/base-chain/changelog/{cobalt => }/b20.mdx (100%) diff --git a/docs/AGENTS.md b/docs/AGENTS.md index 95fb0b671..5c8774171 100644 --- a/docs/AGENTS.md +++ b/docs/AGENTS.md @@ -80,7 +80,7 @@ npx skills add base/base-skills |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/changelog:beryl,denim -|base-chain/changelog/cobalt:b20 +|base-chain/changelog:b20 |base-chain/flashblocks:faq |base-chain/network-information:base-contracts,base-solana-bridge,bridging-and-withdrawals,configuration-changelog,ecosystem-bridges,network-faucets,network-fees,throughput-and-limits,transaction-finality,transaction-ordering,troubleshooting-transactions |base-chain/node-operators:node-providers,performance-tuning,run-a-base-node,snapshots,troubleshooting diff --git a/docs/base-chain/changelog.mdx b/docs/base-chain/changelog.mdx index 26c6ccd50..eda34bc08 100644 --- a/docs/base-chain/changelog.mdx +++ b/docs/base-chain/changelog.mdx @@ -10,5 +10,5 @@ This changelog tracks developer-facing changes introduced by Base protocol upgra Select an upgrade in the sidebar to view its changes: - [Beryl](/base-chain/changelog/beryl) -- [Cobalt: B20](/base-chain/changelog/cobalt/b20) +- [B20](/base-chain/changelog/b20) - [Denim](/base-chain/changelog/denim) diff --git a/docs/base-chain/changelog/cobalt/b20.mdx b/docs/base-chain/changelog/b20.mdx similarity index 100% rename from docs/base-chain/changelog/cobalt/b20.mdx rename to docs/base-chain/changelog/b20.mdx diff --git a/docs/docs.json b/docs/docs.json index b68f1495e..6a52cbf14 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -394,17 +394,7 @@ "base-chain/changelog/beryl" ] }, - { - "group": "Cobalt", - "pages": [ - { - "group": "B20", - "pages": [ - "base-chain/changelog/cobalt/b20" - ] - } - ] - }, + "base-chain/changelog/b20", { "group": "Denim", "pages": [ diff --git a/docs/llms-full.txt b/docs/llms-full.txt index fe7ee013e..30834f2c7 100644 --- a/docs/llms-full.txt +++ b/docs/llms-full.txt @@ -165,7 +165,7 @@ const client = createPublicClient({ chain: base, transport: http() }) - [Base RPC Overview](https://docs.base.org/base-chain/api-reference/rpc-overview): Complete reference for all JSON-RPC and Flashblocks methods available on Base nodes. - [Changelog](https://docs.base.org/base-chain/changelog): Changes introduced by Base protocol upgrades. - [Beryl](https://docs.base.org/base-chain/changelog/beryl): Developer-facing changes introduced by the Beryl upgrade. -- [B20](https://docs.base.org/base-chain/changelog/cobalt/b20): B20 changes introduced by the Cobalt upgrade. +- [B20](https://docs.base.org/base-chain/changelog/b20): B20 changes introduced by the Cobalt upgrade. - [Denim](https://docs.base.org/base-chain/changelog/denim): Developer-facing changes introduced by the Denim upgrade. - [Flashblocks Reference](https://docs.base.org/base-chain/flashblocks/faq): Reference for Flashblocks on Base — key concepts, architecture, and frequently asked questions about block building, WebSocket data, RPC usage, and node setup. - [Contract Addresses](https://docs.base.org/base-chain/network-information/base-contracts): A comprehensive list of contract addresses for Base Mainnet and Base Testnet, including links to their respective blockchain explorers. diff --git a/docs/llms.txt b/docs/llms.txt index fd108484c..16754de46 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -77,7 +77,7 @@ - [Base RPC Overview](https://docs.base.org/base-chain/api-reference/rpc-overview): Complete reference for all JSON-RPC and Flashblocks methods available on Base nodes. - [Changelog](https://docs.base.org/base-chain/changelog): Changes introduced by Base protocol upgrades. - [Beryl](https://docs.base.org/base-chain/changelog/beryl): Developer-facing changes introduced by the Beryl upgrade. -- [B20](https://docs.base.org/base-chain/changelog/cobalt/b20): B20 changes introduced by the Cobalt upgrade. +- [B20](https://docs.base.org/base-chain/changelog/b20): B20 changes introduced by the Cobalt upgrade. - [Denim](https://docs.base.org/base-chain/changelog/denim): Developer-facing changes introduced by the Denim upgrade. - [Flashblocks Reference](https://docs.base.org/base-chain/flashblocks/faq): Reference for Flashblocks on Base — key concepts, architecture, and frequently asked questions about block building, WebSocket data, RPC usage, and node setup. - [Contract Addresses](https://docs.base.org/base-chain/network-information/base-contracts): A comprehensive list of contract addresses for Base Mainnet and Base Testnet, including links to their respective blockchain explorers. From fad0bee72087e808d9a911e32e95dced2256c6ff Mon Sep 17 00:00:00 2001 From: sohey Date: Tue, 18 Aug 2026 14:42:09 +0200 Subject: [PATCH 6/8] chore: regenerate docs/AGENTS.md, docs/llms-full.txt, docs/llms.txt (post-commit of f34df0c) --- docs/AGENTS.md | 3 +-- docs/llms-full.txt | 2 +- docs/llms.txt | 2 +- 3 files changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/AGENTS.md b/docs/AGENTS.md index 5c8774171..490d99dd4 100644 --- a/docs/AGENTS.md +++ b/docs/AGENTS.md @@ -79,8 +79,7 @@ npx skills add base/base-skills |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/changelog:beryl,denim -|base-chain/changelog:b20 +|base-chain/changelog:b20,beryl,denim |base-chain/flashblocks:faq |base-chain/network-information:base-contracts,base-solana-bridge,bridging-and-withdrawals,configuration-changelog,ecosystem-bridges,network-faucets,network-fees,throughput-and-limits,transaction-finality,transaction-ordering,troubleshooting-transactions |base-chain/node-operators:node-providers,performance-tuning,run-a-base-node,snapshots,troubleshooting diff --git a/docs/llms-full.txt b/docs/llms-full.txt index 30834f2c7..09257b99c 100644 --- a/docs/llms-full.txt +++ b/docs/llms-full.txt @@ -164,8 +164,8 @@ const client = createPublicClient({ chain: base, transport: http() }) - [pendingLogs](https://docs.base.org/base-chain/api-reference/flashblocks-api/pendingLogs): Subscribe to logs from pre-confirmed transactions matching an optional filter. Only available on Flashblocks WebSocket endpoints. - [Base RPC Overview](https://docs.base.org/base-chain/api-reference/rpc-overview): Complete reference for all JSON-RPC and Flashblocks methods available on Base nodes. - [Changelog](https://docs.base.org/base-chain/changelog): Changes introduced by Base protocol upgrades. -- [Beryl](https://docs.base.org/base-chain/changelog/beryl): Developer-facing changes introduced by the Beryl upgrade. - [B20](https://docs.base.org/base-chain/changelog/b20): B20 changes introduced by the Cobalt upgrade. +- [Beryl](https://docs.base.org/base-chain/changelog/beryl): Developer-facing changes introduced by the Beryl upgrade. - [Denim](https://docs.base.org/base-chain/changelog/denim): Developer-facing changes introduced by the Denim upgrade. - [Flashblocks Reference](https://docs.base.org/base-chain/flashblocks/faq): Reference for Flashblocks on Base — key concepts, architecture, and frequently asked questions about block building, WebSocket data, RPC usage, and node setup. - [Contract Addresses](https://docs.base.org/base-chain/network-information/base-contracts): A comprehensive list of contract addresses for Base Mainnet and Base Testnet, including links to their respective blockchain explorers. diff --git a/docs/llms.txt b/docs/llms.txt index 16754de46..8798cc312 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -76,8 +76,8 @@ - [pendingLogs](https://docs.base.org/base-chain/api-reference/flashblocks-api/pendingLogs): Subscribe to logs from pre-confirmed transactions matching an optional filter. Only available on Flashblocks WebSocket endpoints. - [Base RPC Overview](https://docs.base.org/base-chain/api-reference/rpc-overview): Complete reference for all JSON-RPC and Flashblocks methods available on Base nodes. - [Changelog](https://docs.base.org/base-chain/changelog): Changes introduced by Base protocol upgrades. -- [Beryl](https://docs.base.org/base-chain/changelog/beryl): Developer-facing changes introduced by the Beryl upgrade. - [B20](https://docs.base.org/base-chain/changelog/b20): B20 changes introduced by the Cobalt upgrade. +- [Beryl](https://docs.base.org/base-chain/changelog/beryl): Developer-facing changes introduced by the Beryl upgrade. - [Denim](https://docs.base.org/base-chain/changelog/denim): Developer-facing changes introduced by the Denim upgrade. - [Flashblocks Reference](https://docs.base.org/base-chain/flashblocks/faq): Reference for Flashblocks on Base — key concepts, architecture, and frequently asked questions about block building, WebSocket data, RPC usage, and node setup. - [Contract Addresses](https://docs.base.org/base-chain/network-information/base-contracts): A comprehensive list of contract addresses for Base Mainnet and Base Testnet, including links to their respective blockchain explorers. From 3afd7b0e3bfcf16332743db98526b15d3062c7a2 Mon Sep 17 00:00:00 2001 From: sohey Date: Tue, 18 Aug 2026 15:27:42 +0200 Subject: [PATCH 7/8] docs: keep B20 as a Cobalt changelog page --- docs/AGENTS.md | 2 +- docs/base-chain/changelog.mdx | 2 +- docs/base-chain/changelog/{ => cobalt}/b20.mdx | 0 docs/docs.json | 7 ++++++- docs/llms-full.txt | 2 +- docs/llms.txt | 2 +- 6 files changed, 10 insertions(+), 5 deletions(-) rename docs/base-chain/changelog/{ => cobalt}/b20.mdx (100%) diff --git a/docs/AGENTS.md b/docs/AGENTS.md index 490d99dd4..88182693f 100644 --- a/docs/AGENTS.md +++ b/docs/AGENTS.md @@ -79,7 +79,7 @@ npx skills add base/base-skills |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/changelog:b20,beryl,denim +|base-chain/changelog/cobalt:b20,beryl,denim |base-chain/flashblocks:faq |base-chain/network-information:base-contracts,base-solana-bridge,bridging-and-withdrawals,configuration-changelog,ecosystem-bridges,network-faucets,network-fees,throughput-and-limits,transaction-finality,transaction-ordering,troubleshooting-transactions |base-chain/node-operators:node-providers,performance-tuning,run-a-base-node,snapshots,troubleshooting diff --git a/docs/base-chain/changelog.mdx b/docs/base-chain/changelog.mdx index eda34bc08..26c6ccd50 100644 --- a/docs/base-chain/changelog.mdx +++ b/docs/base-chain/changelog.mdx @@ -10,5 +10,5 @@ This changelog tracks developer-facing changes introduced by Base protocol upgra Select an upgrade in the sidebar to view its changes: - [Beryl](/base-chain/changelog/beryl) -- [B20](/base-chain/changelog/b20) +- [Cobalt: B20](/base-chain/changelog/cobalt/b20) - [Denim](/base-chain/changelog/denim) diff --git a/docs/base-chain/changelog/b20.mdx b/docs/base-chain/changelog/cobalt/b20.mdx similarity index 100% rename from docs/base-chain/changelog/b20.mdx rename to docs/base-chain/changelog/cobalt/b20.mdx diff --git a/docs/docs.json b/docs/docs.json index 6a52cbf14..7f2bb1803 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -394,7 +394,12 @@ "base-chain/changelog/beryl" ] }, - "base-chain/changelog/b20", + { + "group": "Cobalt", + "pages": [ + "base-chain/changelog/cobalt/b20" + ] + }, { "group": "Denim", "pages": [ diff --git a/docs/llms-full.txt b/docs/llms-full.txt index 09257b99c..0246f8a15 100644 --- a/docs/llms-full.txt +++ b/docs/llms-full.txt @@ -164,7 +164,7 @@ const client = createPublicClient({ chain: base, transport: http() }) - [pendingLogs](https://docs.base.org/base-chain/api-reference/flashblocks-api/pendingLogs): Subscribe to logs from pre-confirmed transactions matching an optional filter. Only available on Flashblocks WebSocket endpoints. - [Base RPC Overview](https://docs.base.org/base-chain/api-reference/rpc-overview): Complete reference for all JSON-RPC and Flashblocks methods available on Base nodes. - [Changelog](https://docs.base.org/base-chain/changelog): Changes introduced by Base protocol upgrades. -- [B20](https://docs.base.org/base-chain/changelog/b20): B20 changes introduced by the Cobalt upgrade. +- [B20](https://docs.base.org/base-chain/changelog/cobalt/b20): B20 changes introduced by the Cobalt upgrade. - [Beryl](https://docs.base.org/base-chain/changelog/beryl): Developer-facing changes introduced by the Beryl upgrade. - [Denim](https://docs.base.org/base-chain/changelog/denim): Developer-facing changes introduced by the Denim upgrade. - [Flashblocks Reference](https://docs.base.org/base-chain/flashblocks/faq): Reference for Flashblocks on Base — key concepts, architecture, and frequently asked questions about block building, WebSocket data, RPC usage, and node setup. diff --git a/docs/llms.txt b/docs/llms.txt index 8798cc312..d2e29d520 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -76,7 +76,7 @@ - [pendingLogs](https://docs.base.org/base-chain/api-reference/flashblocks-api/pendingLogs): Subscribe to logs from pre-confirmed transactions matching an optional filter. Only available on Flashblocks WebSocket endpoints. - [Base RPC Overview](https://docs.base.org/base-chain/api-reference/rpc-overview): Complete reference for all JSON-RPC and Flashblocks methods available on Base nodes. - [Changelog](https://docs.base.org/base-chain/changelog): Changes introduced by Base protocol upgrades. -- [B20](https://docs.base.org/base-chain/changelog/b20): B20 changes introduced by the Cobalt upgrade. +- [B20](https://docs.base.org/base-chain/changelog/cobalt/b20): B20 changes introduced by the Cobalt upgrade. - [Beryl](https://docs.base.org/base-chain/changelog/beryl): Developer-facing changes introduced by the Beryl upgrade. - [Denim](https://docs.base.org/base-chain/changelog/denim): Developer-facing changes introduced by the Denim upgrade. - [Flashblocks Reference](https://docs.base.org/base-chain/flashblocks/faq): Reference for Flashblocks on Base — key concepts, architecture, and frequently asked questions about block building, WebSocket data, RPC usage, and node setup. From d668339eeaa9e38abbdc3c494005d8861fc90eae Mon Sep 17 00:00:00 2001 From: sohey Date: Tue, 18 Aug 2026 15:27:42 +0200 Subject: [PATCH 8/8] chore: regenerate docs/AGENTS.md, docs/llms-full.txt, docs/llms.txt (post-commit of 3afd7b0) --- docs/AGENTS.md | 3 ++- docs/llms-full.txt | 2 +- docs/llms.txt | 2 +- 3 files changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/AGENTS.md b/docs/AGENTS.md index 88182693f..95fb0b671 100644 --- a/docs/AGENTS.md +++ b/docs/AGENTS.md @@ -79,7 +79,8 @@ npx skills add base/base-skills |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/changelog/cobalt:b20,beryl,denim +|base-chain/changelog:beryl,denim +|base-chain/changelog/cobalt:b20 |base-chain/flashblocks:faq |base-chain/network-information:base-contracts,base-solana-bridge,bridging-and-withdrawals,configuration-changelog,ecosystem-bridges,network-faucets,network-fees,throughput-and-limits,transaction-finality,transaction-ordering,troubleshooting-transactions |base-chain/node-operators:node-providers,performance-tuning,run-a-base-node,snapshots,troubleshooting diff --git a/docs/llms-full.txt b/docs/llms-full.txt index 0246f8a15..fe7ee013e 100644 --- a/docs/llms-full.txt +++ b/docs/llms-full.txt @@ -164,8 +164,8 @@ const client = createPublicClient({ chain: base, transport: http() }) - [pendingLogs](https://docs.base.org/base-chain/api-reference/flashblocks-api/pendingLogs): Subscribe to logs from pre-confirmed transactions matching an optional filter. Only available on Flashblocks WebSocket endpoints. - [Base RPC Overview](https://docs.base.org/base-chain/api-reference/rpc-overview): Complete reference for all JSON-RPC and Flashblocks methods available on Base nodes. - [Changelog](https://docs.base.org/base-chain/changelog): Changes introduced by Base protocol upgrades. -- [B20](https://docs.base.org/base-chain/changelog/cobalt/b20): B20 changes introduced by the Cobalt upgrade. - [Beryl](https://docs.base.org/base-chain/changelog/beryl): Developer-facing changes introduced by the Beryl upgrade. +- [B20](https://docs.base.org/base-chain/changelog/cobalt/b20): B20 changes introduced by the Cobalt upgrade. - [Denim](https://docs.base.org/base-chain/changelog/denim): Developer-facing changes introduced by the Denim upgrade. - [Flashblocks Reference](https://docs.base.org/base-chain/flashblocks/faq): Reference for Flashblocks on Base — key concepts, architecture, and frequently asked questions about block building, WebSocket data, RPC usage, and node setup. - [Contract Addresses](https://docs.base.org/base-chain/network-information/base-contracts): A comprehensive list of contract addresses for Base Mainnet and Base Testnet, including links to their respective blockchain explorers. diff --git a/docs/llms.txt b/docs/llms.txt index d2e29d520..fd108484c 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -76,8 +76,8 @@ - [pendingLogs](https://docs.base.org/base-chain/api-reference/flashblocks-api/pendingLogs): Subscribe to logs from pre-confirmed transactions matching an optional filter. Only available on Flashblocks WebSocket endpoints. - [Base RPC Overview](https://docs.base.org/base-chain/api-reference/rpc-overview): Complete reference for all JSON-RPC and Flashblocks methods available on Base nodes. - [Changelog](https://docs.base.org/base-chain/changelog): Changes introduced by Base protocol upgrades. -- [B20](https://docs.base.org/base-chain/changelog/cobalt/b20): B20 changes introduced by the Cobalt upgrade. - [Beryl](https://docs.base.org/base-chain/changelog/beryl): Developer-facing changes introduced by the Beryl upgrade. +- [B20](https://docs.base.org/base-chain/changelog/cobalt/b20): B20 changes introduced by the Cobalt upgrade. - [Denim](https://docs.base.org/base-chain/changelog/denim): Developer-facing changes introduced by the Denim upgrade. - [Flashblocks Reference](https://docs.base.org/base-chain/flashblocks/faq): Reference for Flashblocks on Base — key concepts, architecture, and frequently asked questions about block building, WebSocket data, RPC usage, and node setup. - [Contract Addresses](https://docs.base.org/base-chain/network-information/base-contracts): A comprehensive list of contract addresses for Base Mainnet and Base Testnet, including links to their respective blockchain explorers.