{/* Content panel — white bg, rounded corners */}
diff --git a/src/app/(home)/privacy/page.tsx b/src/app/(home)/privacy/page.tsx
new file mode 100644
index 0000000..235b61a
--- /dev/null
+++ b/src/app/(home)/privacy/page.tsx
@@ -0,0 +1,99 @@
+import { InfoPage, InfoSection } from "@/components/info/info-page";
+import { SITE_URL } from "@/lib/structured-data";
+
+export const metadata = {
+ title: "Privacy",
+ description:
+ "What the Avail documentation site collects — analytics, stored preferences, optional wallet connections, and page feedback — and how to opt out.",
+ alternates: { canonical: `${SITE_URL}/privacy` },
+};
+
+export default function PrivacyPage() {
+ return (
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ );
+}
diff --git a/src/app/api/markdown/[...slug]/route.ts b/src/app/api/markdown/[...slug]/route.ts
index edac7dc..49f06e9 100644
--- a/src/app/api/markdown/[...slug]/route.ts
+++ b/src/app/api/markdown/[...slug]/route.ts
@@ -1,5 +1,6 @@
import { type NextRequest, NextResponse } from "next/server";
import { AGENT_HEADERS } from "@/lib/agent-headers";
+import { agentNotFoundResponse } from "@/lib/agent-not-found";
import { trackAgentRequest } from "@/lib/analytics/agent-tracking";
import { getPageMarkdownOverride } from "@/lib/llms";
import { cleanMarkdownForAgents } from "@/lib/markdown-clean";
@@ -11,10 +12,10 @@ function getPageFromSlug(slug: string[]) {
return directMatch;
}
- // DA content is canonicalized under /docs/DA/* while many links and
- // users request /docs/da/*. Support both casings for API consumers.
+ // DA content is canonicalized under /docs/da/* but older links and some
+ // agents request /docs/DA/*. Support both casings for API consumers.
if (slug.length > 0 && slug[0].toLowerCase() === "da") {
- return source.getPage(["DA", ...slug.slice(1)]);
+ return source.getPage(["da", ...slug.slice(1)]);
}
return null;
@@ -28,7 +29,7 @@ export async function GET(
const page = getPageFromSlug(slug);
if (!page) {
- return NextResponse.json({ error: "Page not found" }, { status: 404 });
+ return agentNotFoundResponse(`/docs/${slug.join("/")}`);
}
try {
diff --git a/src/app/api/markdown/markdown-api.test.ts b/src/app/api/markdown/markdown-api.test.ts
index fa1d594..dfc89e7 100644
--- a/src/app/api/markdown/markdown-api.test.ts
+++ b/src/app/api/markdown/markdown-api.test.ts
@@ -1,5 +1,6 @@
import { NextRequest } from "next/server";
import { describe, expect, it, vi } from "vitest";
+import { MARKDOWN_VARY } from "@/lib/agent-headers";
const FAKE_CONTENT = "# Test Page\n\nSome markdown content here for testing.";
// cleanMarkdownForAgents adds a trailing newline to plain markdown
@@ -8,10 +9,10 @@ const CLEANED_CONTENT = `${FAKE_CONTENT}\n`;
vi.mock("@/lib/source", () => ({
source: {
getPage: (slug: string[]) => {
- if (slug.length === 0 || (slug[0] === "DA" && slug[1] === "build")) {
+ if (slug.length === 0 || (slug[0] === "da" && slug[1] === "build")) {
return {
url:
- slug.length === 0 ? "/docs" : `/docs/DA/${slug.slice(1).join("/")}`,
+ slug.length === 0 ? "/docs" : `/docs/da/${slug.slice(1).join("/")}`,
data: {
title: "Test Page",
description: "A test page",
@@ -62,9 +63,11 @@ describe("markdown API - root route", () => {
);
});
- it("has Vary: accept header", async () => {
+ it("has a merged Vary header including Accept", async () => {
const res = await rootGET(makeRequest("/api/markdown"));
- expect(res.headers.get("Vary")).toBe("accept");
+ const vary = res.headers.get("Vary") ?? "";
+ expect(vary).toBe(MARKDOWN_VARY);
+ expect(vary).toContain("Accept");
});
it("returns JSON when format=json", async () => {
diff --git a/src/app/api/markdown/route.ts b/src/app/api/markdown/route.ts
index 445eb80..b02efae 100644
--- a/src/app/api/markdown/route.ts
+++ b/src/app/api/markdown/route.ts
@@ -1,5 +1,6 @@
import { type NextRequest, NextResponse } from "next/server";
import { AGENT_HEADERS } from "@/lib/agent-headers";
+import { agentNotFoundResponse } from "@/lib/agent-not-found";
import { trackAgentRequest } from "@/lib/analytics/agent-tracking";
import { cleanMarkdownForAgents } from "@/lib/markdown-clean";
import { source } from "@/lib/source";
@@ -9,7 +10,7 @@ export async function GET(request: NextRequest) {
const page = source.getPage([]);
if (!page) {
- return NextResponse.json({ error: "Page not found" }, { status: 404 });
+ return agentNotFoundResponse("/docs");
}
try {
diff --git a/src/app/docs/[[...slug]]/page.tsx b/src/app/docs/[[...slug]]/page.tsx
index 42e7134..6097827 100644
--- a/src/app/docs/[[...slug]]/page.tsx
+++ b/src/app/docs/[[...slug]]/page.tsx
@@ -11,6 +11,7 @@ import { PageFooter } from "@/components/mdx/page-footer";
import { Badge } from "@/components/ui/badge";
import { getProductTree } from "@/lib/page-tree-utils";
import { source } from "@/lib/source";
+import { organizationLd } from "@/lib/structured-data";
export const revalidate = false;
export const dynamic = "force-static";
@@ -159,11 +160,15 @@ export default async function Page(props: {
headline: doc.title,
description: doc.description || "",
url: pageUrl,
- publisher: {
- "@type": "Organization",
- name: "Avail",
+ mainEntityOfPage: pageUrl,
+ inLanguage: "en",
+ isPartOf: {
+ "@type": "WebSite",
+ "@id": `${baseUrl}/#website`,
+ name: "Avail Documentation",
url: baseUrl,
},
+ publisher: organizationLd,
};
return (
diff --git a/src/app/not-found.tsx b/src/app/not-found.tsx
index e6840a8..a631bbb 100644
--- a/src/app/not-found.tsx
+++ b/src/app/not-found.tsx
@@ -1,5 +1,6 @@
import { headers } from "next/headers";
import { redirect } from "next/navigation";
+import { AGENT_RECOVERY_LINKS } from "@/lib/agent-not-found";
function isAgentRequest(headersList: Headers): boolean {
const accept = headersList.get("accept") ?? "";
@@ -20,7 +21,22 @@ export default async function NotFound() {
+
+ );
+}
+
+/** A titled block within an {@link InfoPage}. */
+export function InfoSection({
+ heading,
+ children,
+}: {
+ heading: string;
+ children: React.ReactNode;
+}) {
+ return (
+
+
+ );
+}
diff --git a/src/lib/agent-headers.ts b/src/lib/agent-headers.ts
index 74c8243..d4ffcc2 100644
--- a/src/lib/agent-headers.ts
+++ b/src/lib/agent-headers.ts
@@ -1,5 +1,15 @@
+/**
+ * Next adds its own `Vary` for RSC negotiation. Emitting a bare
+ * `Vary: Accept` alongside it produces two separate `Vary` header lines,
+ * and CDNs (and agent-readiness scanners) commonly read only the first —
+ * which risks serving an HTML response from a markdown cache entry.
+ * Carry every token in one merged value instead.
+ */
+export const MARKDOWN_VARY =
+ "Accept, RSC, Next-Router-State-Tree, Next-Router-Prefetch, Next-Router-Segment-Prefetch";
+
export const AGENT_HEADERS = {
"Content-Signal": "ai-train=yes, search=yes, ai-input=yes",
"X-Robots-Tag": "noindex",
- Vary: "accept",
+ Vary: MARKDOWN_VARY,
};
diff --git a/src/lib/agent-not-found.ts b/src/lib/agent-not-found.ts
new file mode 100644
index 0000000..90fff89
--- /dev/null
+++ b/src/lib/agent-not-found.ts
@@ -0,0 +1,49 @@
+import { NextResponse } from "next/server";
+import { AGENT_HEADERS } from "@/lib/agent-headers";
+
+/**
+ * Recovery pointers for an agent that requested a page that does not exist.
+ * A dead end costs an agent a whole turn, so every 404 names the indexes it
+ * can use to find the right URL instead.
+ */
+export const AGENT_RECOVERY_LINKS = [
+ ["/llms.txt", "Intent-based index of every documented task"],
+ ["/llms-da.txt", "Avail DA documentation (single file)"],
+ ["/llms-nexus.txt", "Avail Nexus documentation (single file)"],
+ ["/llms-full.txt", "Complete documentation dump"],
+ ["/sitemap.xml", "Every canonical page URL"],
+ ["/api/reference.json", "Structured reference data (JSON)"],
+] as const;
+
+function recoveryList(): string {
+ return AGENT_RECOVERY_LINKS.map(
+ ([href, label]) => `- [${href}](${href}): ${label}`,
+ ).join("\n");
+}
+
+/** Markdown 404 body pointing an agent at the discovery indexes. */
+export function agentNotFoundMarkdown(requestedPath?: string): string {
+ const requested = requestedPath ? `\n\nRequested: \`${requestedPath}\`` : "";
+ return `# 404 — Page Not Found
+
+This page does not exist in the Avail documentation.${requested}
+
+## Where to look instead
+
+${recoveryList()}
+
+Any \`/docs/*\` URL also returns markdown when requested with
+\`Accept: text/markdown\`, or by appending \`.md\` to the path.
+`;
+}
+
+/** A 404 whose body is markdown rather than an opaque JSON error. */
+export function agentNotFoundResponse(requestedPath?: string) {
+ return new NextResponse(agentNotFoundMarkdown(requestedPath), {
+ status: 404,
+ headers: {
+ "Content-Type": "text/markdown; charset=utf-8",
+ ...AGENT_HEADERS,
+ },
+ });
+}
diff --git a/src/lib/footer-links.ts b/src/lib/footer-links.ts
index 70b2d0a..26d7e7e 100644
--- a/src/lib/footer-links.ts
+++ b/src/lib/footer-links.ts
@@ -22,6 +22,8 @@ export const pagesColumn1: FooterLink[] = [
export const pagesColumn2: FooterLink[] = [
{ label: "Blog", href: "https://blog.availproject.org", external: true },
+ { label: "About these docs", href: "/about" },
+ { label: "Privacy", href: "/privacy" },
{
label: "Ecosystem",
href: "https://www.availproject.org/ecosystem",
@@ -41,6 +43,7 @@ export const pagesColumn2: FooterLink[] = [
export const supportLinks: FooterLink[] = [
{ label: "Docs", href: "/docs/da/get-started" },
+ { label: "Contact", href: "/contact" },
{
label: "Discord",
href: "https://discord.com/invite/AvailProject",
diff --git a/src/lib/llms.ts b/src/lib/llms.ts
index 5199d47..de8e801 100644
--- a/src/lib/llms.ts
+++ b/src/lib/llms.ts
@@ -71,6 +71,23 @@ export function generateLlmsTxt(): string {
"| [/llms-nexus.txt](/llms-nexus.txt) | Avail Nexus — cross-chain unification (SDK, concepts, contracts, UI elements) |",
"| [/llms-full.txt](/llms-full.txt) | Complete documentation dump (all pages) |",
"",
+ "## Agent Endpoints",
+ "",
+ "Machine-readable entry points for this site:",
+ "",
+ "| Endpoint | Returns |",
+ "|----------|---------|",
+ "| `/llms.txt` | This index |",
+ "| `/llms-da.txt`, `/llms-nexus.txt`, `/llms-full.txt` | Section and full-corpus dumps |",
+ "| `/api/reference.json` | Structured reference data (networks, endpoints, contracts) |",
+ "| `/api/markdown/{slug}` | Clean markdown for one page (add `?format=json` for metadata) |",
+ "| `/docs/{slug}.md` | Same markdown, via URL suffix |",
+ "| `/api/search?query={term}` | Full-text search over all pages |",
+ "| `/sitemap.xml` | Every canonical page URL |",
+ "",
+ "Any `/docs/*` URL returns markdown instead of HTML when requested with",
+ "the header `Accept: text/markdown`.",
+ "",
"## Quick Reference",
"",
"- Mainnet RPC: https://mainnet-rpc.avail.so/rpc",
diff --git a/src/lib/structured-data.ts b/src/lib/structured-data.ts
new file mode 100644
index 0000000..5d1a2f9
--- /dev/null
+++ b/src/lib/structured-data.ts
@@ -0,0 +1,92 @@
+/**
+ * Shared schema.org identity for the docs site.
+ *
+ * These objects are emitted as JSON-LD so agents can establish who publishes
+ * this documentation without scraping the rendered page. Every value here is
+ * sourced from content already present on the site — nothing is asserted that
+ * cannot be verified from an official Avail property.
+ */
+
+export const SITE_URL =
+ process.env.NEXT_PUBLIC_SITE_URL || "https://docs.availproject.org";
+
+const AVAIL_HOME = "https://www.availproject.org";
+
+export const AVAIL_SOCIAL_PROFILES = [
+ "https://x.com/AvailProject",
+ "https://github.com/availproject",
+ "https://discord.com/invite/AvailProject",
+ "https://t.me/AvailCommunity",
+];
+
+export const organizationLd = {
+ "@type": "Organization",
+ "@id": `${AVAIL_HOME}/#organization`,
+ name: "Avail",
+ alternateName: "Avail Project",
+ url: AVAIL_HOME,
+ logo: `${SITE_URL}/avail_logo.png`,
+ description:
+ "Avail is a modular blockchain stack providing data availability (Avail DA) and cross-chain unification (Avail Nexus).",
+ sameAs: AVAIL_SOCIAL_PROFILES,
+ contactPoint: [
+ {
+ "@type": "ContactPoint",
+ contactType: "technical support",
+ url: "https://discord.com/invite/AvailProject",
+ availableLanguage: "en",
+ },
+ {
+ "@type": "ContactPoint",
+ contactType: "sales",
+ email: "business@availproject.org",
+ availableLanguage: "en",
+ },
+ {
+ "@type": "ContactPoint",
+ contactType: "security",
+ email: "security@availproject.org",
+ availableLanguage: "en",
+ },
+ ],
+};
+
+export const websiteLd = {
+ "@context": "https://schema.org",
+ "@graph": [
+ organizationLd,
+ {
+ "@type": "WebSite",
+ "@id": `${SITE_URL}/#website`,
+ url: SITE_URL,
+ name: "Avail Documentation",
+ description:
+ "Documentation for Avail DA (data availability) and Avail Nexus (cross-chain unification).",
+ inLanguage: "en",
+ publisher: { "@id": `${AVAIL_HOME}/#organization` },
+ potentialAction: {
+ "@type": "SearchAction",
+ target: {
+ "@type": "EntryPoint",
+ urlTemplate: `${SITE_URL}/api/search?query={search_term_string}`,
+ },
+ "query-input": "required name=search_term_string",
+ },
+ },
+ {
+ "@type": "SoftwareApplication",
+ "@id": `${SITE_URL}/#software`,
+ name: "Avail",
+ applicationCategory: "DeveloperApplication",
+ operatingSystem: "Linux, macOS, Windows",
+ url: AVAIL_HOME,
+ softwareHelp: SITE_URL,
+ publisher: { "@id": `${AVAIL_HOME}/#organization` },
+ offers: {
+ "@type": "Offer",
+ price: "0",
+ priceCurrency: "USD",
+ },
+ },
+ ],
+};
diff --git a/src/middleware.test.ts b/src/middleware.test.ts
index 0b85e87..70b0a89 100644
--- a/src/middleware.test.ts
+++ b/src/middleware.test.ts
@@ -1,5 +1,6 @@
import { NextRequest } from "next/server";
import { describe, expect, it } from "vitest";
+import { MARKDOWN_VARY } from "@/lib/agent-headers";
import { middleware } from "./middleware";
function makeRequest(
@@ -36,7 +37,7 @@ describe("middleware", () => {
);
const rewrite = res.headers.get("x-middleware-rewrite");
expect(rewrite).not.toBeNull();
- expect(new URL(rewrite!).pathname).toBe("/api/markdown/DA/build/networks");
+ expect(new URL(rewrite!).pathname).toBe("/api/markdown/da/build/networks");
});
it("maps root /docs URL to /api/markdown", () => {
@@ -58,13 +59,42 @@ describe("middleware", () => {
makeRequest("/docs/da/build", "text/markdown", { format: "json" }),
);
const rewrite = new URL(res.headers.get("x-middleware-rewrite")!);
- expect(rewrite.pathname).toBe("/api/markdown/DA/build");
+ expect(rewrite.pathname).toBe("/api/markdown/da/build");
expect(rewrite.searchParams.get("format")).toBe("json");
});
- it("sets Vary: accept header", () => {
+ it("sets a single merged Vary header including Accept", () => {
const res = middleware(makeRequest("/docs/da/build", "text/markdown"));
- expect(res.headers.get("vary")).toBe("accept");
+ expect(res.headers.get("vary")).toBe(MARKDOWN_VARY);
+ });
+
+ it("preserves DA slug casing rather than uppercasing it", () => {
+ // Regression: the slug used to be rewritten to /api/markdown/DA/*, which
+ // 404'd for every Avail DA page because content is canonicalized as `da`.
+ const res = middleware(
+ makeRequest("/docs/da/get-started", "text/markdown"),
+ );
+ const rewrite = new URL(res.headers.get("x-middleware-rewrite")!);
+ expect(rewrite.pathname).toBe("/api/markdown/da/get-started");
+ });
+
+ it("serves the docs index as markdown for the homepage", () => {
+ // The agentic scanner negotiates on the site root, not a docs URL.
+ const res = middleware(makeRequest("/", "text/markdown"));
+ const rewrite = new URL(res.headers.get("x-middleware-rewrite")!);
+ expect(rewrite.pathname).toBe("/api/markdown");
+ expect(res.headers.get("vary")).toBe(MARKDOWN_VARY);
+ });
+
+ it("leaves the homepage untouched for browsers", () => {
+ const res = middleware(makeRequest("/", "text/html"));
+ expect(res.headers.get("x-middleware-rewrite")).toBeNull();
+ });
+
+ it("rewrites .md suffix URLs to the markdown API", () => {
+ const res = middleware(makeRequest("/docs/da/get-started.md"));
+ const rewrite = new URL(res.headers.get("x-middleware-rewrite")!);
+ expect(rewrite.pathname).toBe("/api/markdown/da/get-started");
});
it("rewrites when text/markdown is among multiple accept types", () => {
@@ -73,6 +103,6 @@ describe("middleware", () => {
);
const rewrite = res.headers.get("x-middleware-rewrite");
expect(rewrite).not.toBeNull();
- expect(new URL(rewrite!).pathname).toBe("/api/markdown/DA/build");
+ expect(new URL(rewrite!).pathname).toBe("/api/markdown/da/build");
});
});
diff --git a/src/middleware.ts b/src/middleware.ts
index aa3be20..dcdadd2 100644
--- a/src/middleware.ts
+++ b/src/middleware.ts
@@ -1,4 +1,5 @@
import { type NextRequest, NextResponse } from "next/server";
+import { MARKDOWN_VARY } from "@/lib/agent-headers";
import { applyRedirects } from "./redirect-middleware";
/**
@@ -12,12 +13,14 @@ import { applyRedirects } from "./redirect-middleware";
* - Content-Type: text/markdown
* - x-markdown-tokens: estimated token count (chars / 4)
* - Content-Signal: ai-train=yes, search=yes, ai-input=yes
- * - Vary: accept (so CDN caches both representations)
+ * - Vary: Accept (so CDN caches both representations)
*/
export const config = {
// Run on docs URLs (for markdown rewrites) and on legacy paths that need redirects.
matcher: [
+ // The homepage participates in markdown negotiation only (see below).
+ "/",
"/docs/:path*",
"/da/:path*",
"/nexus/:path*",
@@ -25,19 +28,13 @@ export const config = {
],
};
-function normalizeDocsSlugForMarkdownApi(slug: string): string {
- if (!slug) {
- return slug;
- }
-
- const [section, ...rest] = slug.split("/");
- // DA docs are canonicalized as /docs/DA/* in the content source.
- // Normalize lowercase incoming URLs so markdown API lookups succeed.
- if (section.toLowerCase() === "da") {
- return ["DA", ...rest].join("/");
- }
-
- return slug;
+function rewriteToMarkdown(markdownUrl: URL) {
+ const response = NextResponse.rewrite(markdownUrl);
+ // Set (not append) so the response carries one merged Vary. A separate
+ // `Vary: accept` line is easy for CDNs and scanners to miss, which lets
+ // an HTML response get served from an agent's markdown cache entry.
+ response.headers.set("Vary", MARKDOWN_VARY);
+ return response;
}
function acceptsMarkdown(request: NextRequest): boolean {
@@ -48,7 +45,17 @@ function acceptsMarkdown(request: NextRequest): boolean {
}
export function middleware(request: NextRequest) {
- // First, try to apply redirect rules for legacy URLs.
+ // Homepage. Agents asking for the site as markdown get the docs index
+ // rather than an HTML shell. Redirect rules deliberately do not run here:
+ // the matcher covers "/" solely for content negotiation, and running them
+ // would change behaviour for a path middleware previously never saw.
+ if (request.nextUrl.pathname === "/") {
+ return acceptsMarkdown(request)
+ ? rewriteToMarkdown(new URL("/api/markdown", request.url))
+ : NextResponse.next();
+ }
+
+ // Then, try to apply redirect rules for legacy URLs.
const redirectResponse = applyRedirects(request);
if (redirectResponse) {
return redirectResponse;
@@ -62,10 +69,9 @@ export function middleware(request: NextRequest) {
// .md suffix → rewrite to markdown API
// e.g. /docs/nexus/get-started.md → /api/markdown/nexus/get-started
if (request.nextUrl.pathname.endsWith(".md")) {
- const rawSlug = request.nextUrl.pathname
+ const slug = request.nextUrl.pathname
.replace(/\.md$/, "")
.replace(/^\/docs\/?/, "");
- const slug = normalizeDocsSlugForMarkdownApi(rawSlug);
const markdownUrl = new URL(
slug ? `/api/markdown/${slug}` : "/api/markdown",
request.url,
@@ -73,9 +79,7 @@ export function middleware(request: NextRequest) {
request.nextUrl.searchParams.forEach((value, key) => {
markdownUrl.searchParams.set(key, value);
});
- return NextResponse.rewrite(markdownUrl, {
- headers: { Vary: "accept" },
- });
+ return rewriteToMarkdown(markdownUrl);
}
if (!acceptsMarkdown(request)) {
@@ -83,9 +87,8 @@ export function middleware(request: NextRequest) {
}
// Strip the /docs prefix to get the slug for the markdown API.
- // /docs/da/build/networks → /api/markdown/DA/build/networks
- const rawSlug = request.nextUrl.pathname.replace(/^\/docs\/?/, "");
- const slug = normalizeDocsSlugForMarkdownApi(rawSlug);
+ // /docs/da/build/networks → /api/markdown/da/build/networks
+ const slug = request.nextUrl.pathname.replace(/^\/docs\/?/, "");
const markdownUrl = new URL(
slug ? `/api/markdown/${slug}` : "/api/markdown",
request.url,
@@ -96,9 +99,5 @@ export function middleware(request: NextRequest) {
markdownUrl.searchParams.set(key, value);
});
- return NextResponse.rewrite(markdownUrl, {
- headers: {
- Vary: "accept",
- },
- });
+ return rewriteToMarkdown(markdownUrl);
}
diff --git a/src/providers/Web3Provider.tsx b/src/providers/Web3Provider.tsx
index e8cf4e3..3bd721a 100644
--- a/src/providers/Web3Provider.tsx
+++ b/src/providers/Web3Provider.tsx
@@ -130,8 +130,11 @@ const defaultConfig = getDefaultConfig({
const wagmiConfig = createConfig(defaultConfig);
function NexusContainer({ children }: Readonly<{ children: React.ReactNode }>) {
+ // Render with the default network on the server and on the first client
+ // render so page content is present in the initial HTML. `NexusProvider`
+ // builds its client inside an effect keyed on `config` (destroying the
+ // previous one), so switching to a stored network below is handled safely.
const [network, setNetwork] = useState<"mainnet" | "testnet">("mainnet");
- const [isInitialized, setIsInitialized] = useState(false);
useEffect(() => {
// Initialize network from localStorage on client side
@@ -147,8 +150,6 @@ function NexusContainer({ children }: Readonly<{ children: React.ReactNode }>) {
setNetwork("mainnet");
setItem(NETWORK_KEY, "mainnet");
}
-
- setIsInitialized(true);
}, []);
const nexusConfig = useMemo(
@@ -156,11 +157,6 @@ function NexusContainer({ children }: Readonly<{ children: React.ReactNode }>) {
[network],
);
- // Don't render until we've initialized from localStorage
- if (!isInitialized) {
- return
+ We use PostHog to understand which pages are useful and where people + get stuck. It records page views, how far down a page you scroll, how + long you stay, and clicks on links, buttons and forms. Analytics + requests are proxied through this domain rather than sent to a + third-party domain directly. +
++ Where session recordings are captured, all text inputs are masked + before anything leaves your browser, so what you type is not recorded. + Analytics state is kept in your browser’s local storage and a + cookie. +
+
+ If your browser sends a Do Not Track signal, analytics
+ are disabled automatically. Blocking the analytics script does not
+ affect any documentation content.
+
+ Two settings are saved locally so the site behaves consistently + between visits: the network you have selected (mainnet or testnet) and + your light or dark theme choice. These stay in your browser and are + not sent to us. Clearing site data removes them. +
++ Some Avail Nexus pages include live demo widgets that you can connect + a wallet to. Connecting is entirely optional, and no documentation + requires it. When you connect, the site reads your public address and + the balances needed to render the demo. We never receive your private + keys or seed phrase, and every transaction is signed in your own + wallet. +
++ Each page has a feedback control. When you submit it, we receive your + rating, the path of the page you were on, and anything you chose to + add — a comment, contact details, or a screenshot. +
++ Please note that feedback is filed as an issue in a{" "} + + public GitHub repository + + . Anything you include, including contact details and screenshots, + will be publicly visible. Leave out anything you would not want + published, and use the channels on the Contact{" "} + page for private matters. +
++ The site is hosted on Vercel, which processes standard request data + such as IP address and user agent in order to serve pages and protect + the service. Uploaded feedback screenshots are stored in Vercel Blob + storage. +
++ For questions about this page, or to ask us to remove something you + submitted, email{" "} + info@availproject.org. + Security issues should go to{" "} + + security@availproject.org + {" "} + instead — see Contact. +
+404 - Page Not Found
-This page does not exist. See /llms.txt for a full page index.
++ This page does not exist in the Avail documentation. Use one of the + indexes below to find the correct URL. +
+-
+ {AGENT_RECOVERY_LINKS.map(([href, label]) => (
+
- + {href} — {label} + + ))} +
+ Any /docs/* URL also returns markdown when requested
+ with Accept: text/markdown, or by appending
+ .md to the path.
+
+
+
+
+
+
+
+ + {title} +
+{lede}
+{children}
+
+
+ {heading}
+
+ {children}
+
+