Discoverability basics: llms.txt, canonical and sitemap fixes, footer, metadata, market-maker section

docs/api.mdx

@@ -1,6 +1,6 @@
 ---
 title: API Reference
-description: API reference for BuilderNet.
+description: "BuilderNet API reference: eth_sendBundle, eth_sendRawTransaction, priority updates and the propAMM quote stream, TEE attestation, and the refund methods."
 ---
 
 ## Orderflow

docs/architecture.mdx

@@ -12,7 +12,7 @@ Overview of BuilderNet's system architecture.
 
 The following diagram shows the simplified overall system architecture:
 
-<Image img={imgSystemContextDiagram} class="img-border" />
+<Image img={imgSystemContextDiagram} alt="BuilderNet system context diagram: orderflow providers, builder nodes running in TEEs, and relays" class="img-border" />
 
 <hr class="clean" />
 

docs/encryption-attestations.mdx

@@ -1,6 +1,6 @@
 ---
 title: Orderflow encryption and attestation
-description: coming soon
+description: How orderflow is end-to-end encrypted between users, BuilderNet nodes and Flashbots infrastructure, and which ports use attested TLS.
 ---
 
 This page outlines how orderflow is end-to-end encrypted in BuilderNet.

docs/flashbots-infra.mdx

@@ -14,7 +14,7 @@ In the bootstrapping phase, BuilderNet relies on Flashbots infrastructure for:
 
 This diagram shows the TLS certificate setup and key data flows:
 
-<Image img={require('@site/static/img/flashbots-infra-dataflow.png')} class="img-border" />
+<Image img={require('@site/static/img/flashbots-infra-dataflow.png')} alt="TLS certificate setup and data flows between BuilderNet nodes and Flashbots infrastructure" class="img-border" />
 
 See also ["Encryption and Attestations"](encryption-attestations) for more information about encryption and the use of certificates.
 

docs/historic-measurements.mdx

@@ -1,5 +1,6 @@
 ---
 title: Historic Allowed TEE Measurements
+description: Archive of previously allowed TEE measurements for BuilderNet node images.
 ---
 
 ```json

docs/how-to-participate.mdx

@@ -1,6 +1,6 @@
 ---
 title: How to participate
-description: How to participate in BuilderNet
+description: Ways to participate in BuilderNet as a wallet, searcher, propAMM market maker, developer, node operator or researcher.
 ---
 
 ### Users, Wallets, and Apps
@@ -17,6 +17,14 @@ Submit to the Flashbots Bundle Relay or [register](https://www.notion.so/flashbo
 
 ---
 
+### Market makers (propAMMs)
+
+If you operate a proprietary AMM (propAMM), stream your quote updates to BuilderNet as [priority updates](api#priority-updates). Depending on the mode set for your API key, the builder places an update at the top of the block or includes it only when another transaction in the block reads it. Updates are sent over WebSocket and go through the [Priority Update Registry](https://github.com/flashbots/priority-update-registry). API keys are issued on request; message the team on Telegram (see below).
+
+Aggregators and solvers that route against propAMM liquidity can read the pending quote state from the [quote stream](api#priority-updates). No key is needed.
+
+---
+
 ### Developers
 
 Contribute to [rbuilder](https://github.com/flashbots/rbuilder), the open source block builder that powers BuilderNet. Join the conversation in the [Telegram group](https://t.me/flashbots_rbuilder).

docs/open-source.mdx

@@ -3,7 +3,7 @@ title: Open-source software
 description: Overview of the open-source software and infrastructure used in BuilderNet.
 ---
 
-BuilderNet is running open source software and infrastructure.
+BuilderNet is based on open source software and infrastructure.
 
 ---
 

docs/operating-a-node.mdx

@@ -103,11 +103,11 @@ Grafana dashboard downloads:
 
 #### Dashboard screenshots for Orderflow Proxy
 
-<Image img={require('@site/static/img/dashboards/grafana-orderflow-proxy.jpg')} />
+<Image img={require('@site/static/img/dashboards/grafana-orderflow-proxy.jpg')} alt="Grafana dashboard for the BuilderNet orderflow proxy" />
 
 ---
 
 #### Dashboard screenshots for rbuilder
 
-<Image img={require('@site/static/img/dashboards/grafana-rbuilder-1.jpg')} />
-<Image img={require('@site/static/img/dashboards/grafana-rbuilder-2.jpg')} />
+<Image img={require('@site/static/img/dashboards/grafana-rbuilder-1.jpg')} alt="Grafana dashboard for rbuilder, part 1" />
+<Image img={require('@site/static/img/dashboards/grafana-rbuilder-2.jpg')} alt="Grafana dashboard for rbuilder, part 2" />

docs/refunds.mdx

@@ -1,6 +1,6 @@
 ---
 title: Refunds
-description: BuilderNet shares MEV value with the parties who contribute to its blocks.
+description: How BuilderNet refunds MEV to the parties who contribute to its blocks, and how to look up refunds.
 ---
 
 BuilderNet refunds MEV value to the parties who contribute orderflow to its blocks. The goal of this mechanism is to create an efficient, transparent way for orderflow providers to internalize their MEV, and to sustain the ongoing operations of the network.

docs/resources.mdx

@@ -8,6 +8,7 @@ Important articles, forum posts, and technical discussions about BuilderNet's ar
 
 | Resource                                                                                                                                                                                        | Date           |
 | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
+| [Priority Update Registry (GitHub)](https://github.com/flashbots/priority-update-registry)                                                                                                    | March 2026     |
 | [The Evolution of Remote Attested TLS - TEE - Trusted Execution Environment](https://collective.flashbots.net/t/the-evolution-of-remote-attested-tls/5383)                                      | November 2025  |
 | [Combined refunds](https://collective.flashbots.net/t/combined-refunds/5270)                                                                                                                    | September 2025 |
 | [Moving away from aTLS](https://collective.flashbots.net/t/moving-away-from-atls/5176)                                                                                                          | August 2025    |

docs/roadmap.mdx

@@ -18,4 +18,4 @@ BuilderNet is a work in progress. We intend to incrementally upgrade the network
 
 ## Milestones
 
-<Image img={imgRoadmap} class="img-border" />
+<Image img={imgRoadmap} alt="BuilderNet roadmap milestones" class="img-border" />

docs/send-orderflow.mdx

@@ -1,6 +1,6 @@
 ---
 title: How to send orderflow
-description: How to send orderflow securely to a BuilderNet node.
+description: Endpoints and methods for sending bundles, transactions and propAMM quote updates directly to BuilderNet nodes, and how to verify a node's TEE attestation.
 ---
 
 Orderflow sent to [Flashbots Protect](https://protect.flashbots.net) and [Flashbots Bundle Relay](https://docs.flashbots.net/flashbots-auction/advanced/rpc-endpoint) is automatically shared with BuilderNet. Advanced users can send orderflow directly to BuilderNet nodes and optionally validate TEE proofs.
@@ -39,7 +39,8 @@ See [TEE proof validation](#tee-attestation) for details.
 
 1. [`eth_sendBundle`](https://docs.flashbots.net/flashbots-auction/advanced/rpc-endpoint#eth_sendbundle)
 2. [`eth_sendRawTransaction`](https://docs.metamask.io/wallet/reference/json-rpc-methods/eth_sendrawtransaction/)
-3. [Priority updates](api#priority-updates) — for operators of proprietary AMMs (WebSocket, requires an API key)
+3. [Priority updates](api#priority-updates) — quote updates from propAMM market makers (WebSocket, API key required)
+4. [Quote stream](api#priority-updates) — read-only WebSocket with the pending propAMM quote state (no key required)
 
 See also the [API reference](api) for more details on the API methods.
 

docs/sidebars.js

@@ -55,6 +55,7 @@ module.exports = {
             'operating-a-node',
             'staging-instance-handbook',
             'downloads-measurements',
+            'historic-measurements',
           ]
         }
         ,

docs/what-is-buildernet.mdx

@@ -2,7 +2,7 @@
 title: What is BuilderNet
 slug: /
 hide_title: true
-description: BuilderNet is a decentralized block building network for Ethereum.
+description: BuilderNet is a TEE-based block building network for Ethereum. Refunds minimise execution costs for the end users, market makers, traders and searchers who send it orderflow.
 ---
 
 # Welcome to BuilderNet

docusaurus.config.js

@@ -18,6 +18,8 @@ module.exports = async function createConfigAsync() {
     baseUrl: process.env.BASE_URL || '/',
     onBrokenLinks: 'throw',
     onBrokenMarkdownLinks: 'warn',
+    // Match vercel.json (trailingSlash: false) so canonical URLs and the sitemap use the same form.
+    trailingSlash: false,
     favicon: 'img/favicon.ico',
     organizationName: 'BuilderNet',
     projectName: 'docs',
@@ -26,6 +28,25 @@ module.exports = async function createConfigAsync() {
       mermaid: true,
     },
     themes: ['@docusaurus/theme-mermaid'],
+    headTags: [
+      {
+        tagName: 'script',
+        attributes: { type: 'application/ld+json' },
+        innerHTML: JSON.stringify({
+          '@context': 'https://schema.org',
+          '@type': 'Organization',
+          name: 'BuilderNet',
+          url: 'https://buildernet.org',
+          logo: 'https://buildernet.org/img/logo.png',
+          sameAs: [
+            'https://collective.flashbots.net/c/buildernet/31',
+            'https://t.me/buildernet_general',
+            'https://github.com/BuilderNet',
+            'https://github.com/flashbots/rbuilder',
+          ],
+        }),
+      },
+    ],
     stylesheets: [
       {
         href: 'https://cdn.jsdelivr.net/npm/katex@0.13.24/dist/katex.min.css',
@@ -79,6 +100,43 @@ module.exports = async function createConfigAsync() {
           ],
         },
         image: 'img/buildernet-cover-photo-m.jpg',
+        footer: {
+          style: 'dark',
+          links: [
+            {
+              title: 'Send orderflow',
+              items: [
+                { label: 'Send bundles', to: '/docs/send-orderflow' },
+                { label: 'Priority updates (propAMM)', to: '/docs/api#priority-updates' },
+                { label: 'Wallets and apps', to: '/docs/how-to-participate' },
+                { label: 'Refunds', to: '/docs/refunds' },
+                { label: 'API reference', to: '/docs/api' },
+              ],
+            },
+            {
+              title: 'Network',
+              items: [
+                { label: 'What is BuilderNet', to: '/docs' },
+                { label: 'Architecture', to: '/docs/architecture' },
+                { label: 'Verifiable system integrity', to: '/docs/verifiable-system-integrity' },
+                { label: 'Operate a node', to: '/docs/operating-a-node' },
+                { label: 'Dune dashboard', href: 'https://dune.com/flashbots/buildernet' },
+              ],
+            },
+            {
+              title: 'Community',
+              items: [
+                { label: 'Blog', to: '/blog' },
+                { label: 'Forum', href: 'https://collective.flashbots.net/c/buildernet/31' },
+                { label: 'Telegram', href: 'https://t.me/buildernet_general' },
+                { label: 'GitHub', href: 'https://github.com/BuilderNet' },
+                { label: 'rbuilder', href: 'https://github.com/flashbots/rbuilder' },
+                { label: 'Flashbots', href: 'https://www.flashbots.net' },
+              ],
+            },
+          ],
+          copyright: `Copyright © ${new Date().getFullYear()} Flashbots.`,
+        },
       }),
     presets: [
       [
@@ -102,7 +160,7 @@ module.exports = async function createConfigAsync() {
             // editUrl: 'https://github.com/BuilderNet/website/edit/main/',
             editLocalizedFiles: false,
             blogTitle: 'BuilderNet Blog',
-            blogDescription: 'Blog',
+            blogDescription: 'BuilderNet release notes and announcements.',
             blogSidebarCount: 0,
             blogSidebarTitle: 'All our posts',
             routeBasePath: 'blog',
@@ -129,7 +187,7 @@ module.exports = async function createConfigAsync() {
             lastmod: 'date',
             changefreq: 'weekly',
             priority: 0.5,
-            ignorePatterns: ['/tags/**'],
+            ignorePatterns: ['/tags/**', '/search'],
             filename: 'sitemap.xml',
             createSitemapItems: async (params) => {
               const { defaultCreateSitemapItems, ...rest } = params;
@@ -143,6 +201,23 @@ module.exports = async function createConfigAsync() {
     plugins: [
       // eslint-disable-next-line @typescript-eslint/no-unused-vars
       '@docusaurus/plugin-ideal-image',
+      [
+        // Generates /llms.txt (index) and /llms-full.txt (all docs + blog posts) at build time,
+        // so LLM-based assistants can ingest the documentation directly. https://llmstxt.org
+        'docusaurus-plugin-llms',
+        {
+          title: 'BuilderNet documentation',
+          description:
+            'BuilderNet is a TEE-based block building network for Ethereum. Refunds minimise execution costs; private transactions, bundles and propAMM quote updates go directly to the builder.',
+          rootContent:
+            'BuilderNet is a TEE-based block building network for Ethereum. It pays refunds to minimise execution costs, and gives end users, market makers, traders and searchers the tools for efficient execution: private transactions, bundles and propAMM quote updates (priority updates), sent directly to the builder. These docs cover how to send orderflow, how refunds work, and how to operate a node. Site: https://buildernet.org. Send orderflow: https://buildernet.org/docs/send-orderflow. API reference: https://buildernet.org/docs/api. Refunds: https://buildernet.org/docs/refunds.',
+          includeBlog: true,
+          ignoreFiles: ['_*', '**/_*'],
+          excludeImports: true,
+          removeDuplicateHeadings: true,
+          generateMarkdownFiles: false,
+        },
+      ],
     ],
   };
 };

package.json

@@ -65,6 +65,7 @@
     "@typescript-eslint/parser": "^6.7.3",
     "cspell": "^6.31.2",
     "debug": "^4.3.4",
+    "docusaurus-plugin-llms": "0.6.0",
     "eslint": "^8.48.0",
     "eslint-config-airbnb": "^19.0.4",
     "eslint-config-airbnb-typescript": "^17.1.0",

project-words.txt

@@ -113,4 +113,5 @@ txns
 upstreamed
 usermod
 viem
-waivable
+waivable
+llms

src/pages/index.md

@@ -1,11 +1,13 @@
 ---
-description: BuilderNet is a decentralized block building network for Ethereum.
+description: BuilderNet is a TEE-based block building network for Ethereum. Refunds minimise execution costs; end users, market makers, traders and searchers send private transactions, bundles and propAMM quote updates directly to the builder.
 ---
 
 import Image from '@theme/IdealImage';
 
 # Welcome to BuilderNet
 
+BuilderNet is a TEE-based block building network for Ethereum. It pays refunds to minimise execution costs, and gives end users, market makers, traders and searchers the tools for efficient execution: private transactions, bundles and propAMM quote updates, sent directly to the builder.
+
 <br />
 
 
@@ -16,7 +18,7 @@ import Image from '@theme/IdealImage';
     </div>
     <div className="intro-text">
       <div className="intro-heading">Introducing BuilderNet</div>
-      <div className="intro-desc">A decentralized block building network for Ethereum that runs on TEEs and shares MEV with the community.</div>
+      <div className="intro-desc">A TEE-based block building network for Ethereum that shares MEV with the community.</div>
     </div>
   </div>
 </a>
@@ -116,6 +118,69 @@ import Image from '@theme/IdealImage';
 
 </div>
 
+<br />
+
+---
+
+<br />
+<br />
+
+### Get started
+
+<div className="intro-grid">
+  <a href="/docs/send-orderflow" className="intro-link">
+    <div className="intro-block">
+      <div className="intro-image">
+<svg xmlns="http://www.w3.org/2000/svg" width="30" height="30" viewBox="0 0 16 16">
+  <path d="M0 4a2 2 0 0 1 2-2h12a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2H2a2 2 0 0 1-2-2zm2-1a1 1 0 0 0-1 1v.217l7 4.2 7-4.2V4a1 1 0 0 0-1-1zm13 2.383-4.708 2.825L15 11.105zm-.034 6.876-5.64-3.471L8 9.583l-1.326-.795-5.64 3.47A1 1 0 0 0 2 13h12a1 1 0 0 0 .966-.741M1 11.105l4.708-2.897L1 5.383z"/>
+</svg>
+      </div>
+      <div className="intro-text">
+        <div className="intro-heading">Searchers and solvers</div>
+        <div className="intro-desc">Submit bundles and get refunds</div>
+      </div>
+    </div>
+  </a>
+
+  <a href="/docs/how-to-participate" className="intro-link">
+    <div className="intro-block">
+      <div className="intro-image">
+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24"><path d="M9 20h6v2H9zm7.906-6.288C17.936 12.506 19 11.259 19 9c0-3.859-3.141-7-7-7S5 5.141 5 9c0 2.285 1.067 3.528 2.101 4.73.358.418.729.851 1.084 1.349.144.206.38.996.591 1.921H8v2h8v-2h-.774c.213-.927.45-1.719.593-1.925.352-.503.726-.94 1.087-1.363zm-2.724.213c-.434.617-.796 2.075-1.006 3.075h-2.351c-.209-1.002-.572-2.463-1.011-3.08a20.502 20.502 0 0 0-1.196-1.492C7.644 11.294 7 10.544 7 9c0-2.757 2.243-5 5-5s5 2.243 5 5c0 1.521-.643 2.274-1.615 3.413-.373.438-.796.933-1.203 1.512z"></path></svg>
+      </div>
+      <div className="intro-text">
+        <div className="intro-heading">Wallets and apps</div>
+        <div className="intro-desc">Private transactions and refunds, via Protect or directly</div>
+      </div>
+    </div>
+  </a>
+
+  <a href="/docs/api#priority-updates" className="intro-link">
+    <div className="intro-block">
+      <div className="intro-image">
+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32"  viewBox="0 0 16 16">
+  <path fill-rule="evenodd" d="M6 3.5A1.5 1.5 0 0 1 7.5 2h1A1.5 1.5 0 0 1 10 3.5v1A1.5 1.5 0 0 1 8.5 6v1H14a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-1 0V8h-5v.5a.5.5 0 0 1-1 0V8h-5v.5a.5.5 0 0 1-1 0v-1A.5.5 0 0 1 2 7h5.5V6A1.5 1.5 0 0 1 6 4.5zM8.5 5a.5.5 0 0 0 .5-.5v-1a.5.5 0 0 0-.5-.5h-1a.5.5 0 0 0-.5.5v1a.5.5 0 0 0 .5.5zM0 11.5A1.5 1.5 0 0 1 1.5 10h1A1.5 1.5 0 0 1 4 11.5v1A1.5 1.5 0 0 1 2.5 14h-1A1.5 1.5 0 0 1 0 12.5zm1.5-.5a.5.5 0 0 0-.5.5v1a.5.5 0 0 0 .5.5h1a.5.5 0 0 0 .5-.5v-1a.5.5 0 0 0-.5-.5zm4.5.5A1.5 1.5 0 0 1 7.5 10h1a1.5 1.5 0 0 1 1.5 1.5v1A1.5 1.5 0 0 1 8.5 14h-1A1.5 1.5 0 0 1 6 12.5zm1.5-.5a.5.5 0 0 0-.5.5v1a.5.5 0 0 0 .5.5h1a.5.5 0 0 0 .5-.5v-1a.5.5 0 0 0-.5-.5zm4.5.5a1.5 1.5 0 0 1 1.5-1.5h1a1.5 1.5 0 0 1 1.5 1.5v1a1.5 1.5 0 0 1-1.5 1.5h-1a1.5 1.5 0 0 1-1.5-1.5zm1.5-.5a.5.5 0 0 0-.5.5v1a.5.5 0 0 0 .5.5h1a.5.5 0 0 0 .5-.5v-1a.5.5 0 0 0-.5-.5z"/>
+</svg>
+      </div>
+      <div className="intro-text">
+        <div className="intro-heading">propAMM market makers</div>
+        <div className="intro-desc">Stream quote updates to the builder</div>
+      </div>
+    </div>
+  </a>
+
+  <a href="/docs/operating-a-node" className="intro-link">
+    <div className="intro-block">
+      <div className="intro-image">
+<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 24 24"><path d="M6 22h15v-2H6.012C5.55 19.988 5 19.805 5 19s.55-.988 1.012-1H21V4c0-1.103-.897-2-2-2H6c-1.206 0-3 .799-3 3v14c0 2.201 1.794 3 3 3zM5 8V5c0-.805.55-.988 1-1h13v12H5V8z"></path><path d="M8 6h9v2H8z"></path></svg>
+      </div>
+      <div className="intro-text">
+        <div className="intro-heading">Node operators</div>
+        <div className="intro-desc">Run a builder node</div>
+      </div>
+    </div>
+  </a>
+</div>
+
 
 <br />
 

static/robots.txt

@@ -1 +1,4 @@
+User-agent: *
+Allow: /
+
 Sitemap: https://buildernet.org/sitemap.xml