docs: sync three docs from fiber main repo

[digi-monkey]

• Add glossary.md: Fiber Network terminology explanations
• Add biscuit-auth.md: Biscuit authentication setup and usage guide
• Add payment-lifecycle.md: Payment session and attempt state machine

All links to fiber main repo code files are updated to absolute GitHub URLs. Navigation updated in meta.json to include new docs.

[vercel]

Someone is attempting to deploy a commit to the cryptape Team on Vercel.

A member of the Team first needs to authorize it.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
fiber-docs	Ready	Preview, Comment	Mar 17, 2026 5:47am

[Copilot]

Pull request overview

This pull request syncs three documentation files from the main Fiber repository to the documentation site. The PR adds comprehensive documentation covering Fiber Network terminology, Biscuit authentication implementation, and payment lifecycle state machines.

Changes:

• Added glossary.mdx with plain-language explanations of 13 key Fiber Network terms
• Added biscuit-auth.mdx documenting the Biscuit token-based authentication system used in Fiber RPC
• Added payment-lifecycle.mdx with a Mermaid diagram visualizing PaymentSession and PaymentAttempt state transitions

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
content/docs/guide/glossary.mdx	New glossary providing non-technical explanations of Fiber Network terminology including channels, HTLCs, routing, and watchtowers
content/docs/guide/biscuit-auth.mdx	New comprehensive guide covering Biscuit authentication configuration, token generation, RPC rules, and test examples with absolute GitHub links
content/docs/tech-explanation/payment-lifecycle.mdx	New technical document with Mermaid flowchart illustrating payment session and attempt state machines
content/docs/meta.json	Updated navigation to include the three new documentation pages in Guide and Tech Explanation sections

Comments suppressed due to low confidence (2)

content/docs/guide/biscuit-auth.mdx:11

• Grammar issue: "is listen to" should be "is listening to". The phrase appears twice in this sentence and should be corrected to "it can be disabled when RPC is listening to a private address, but must be enabled when listening to a public address."

Biscuit is integrated into the Fiber RPC, it can be disabled when RPC is listen to private addr, but must be enabled when listen to public address. When enabled, it protects RPC endpoints by requiring a valid Biscuit token with permission for resources.

content/docs/guide/biscuit-auth.mdx:37

• The comment "// Cch" is unclear and should be expanded to explain what "Cch" stands for. Based on the context and the function names below (send_btc, receive_btc, get_cch_order), this appears to refer to "Cross-chain hub". Consider changing this to "// Cross-chain hub (Cch)" or simply "// Cross-chain hub" for better clarity and consistency with other section comments in this code block.

// Cch 

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

This file is missing required frontmatter metadata. Based on the schema defined in source.config.ts and the convention followed by all other documentation files in this repository, this file should include frontmatter with at least a title and date field. Add a frontmatter section at the top of the file similar to other documentation files.

[Copilot]

This file is missing required frontmatter metadata. Based on the schema defined in source.config.ts and the convention followed by all other documentation files in this repository, this file should include frontmatter with at least a title and date field. Add a frontmatter section at the top of the file similar to other documentation files.

[Copilot]

This file is missing required frontmatter metadata. Based on the schema defined in source.config.ts and the convention followed by all other documentation files in this repository, this file should include frontmatter with at least a title and date field. Add a frontmatter section at the top of the file similar to other documentation files.

[HappySonnyDev]

Hi @digi-monkey ,Thanks for your contribution! I noticed a few issues that need to be fixed before we can merge this PR.

Issues Found

1. Missing Frontmatter
   The following MDX files are missing required YAML frontmatter (title and date):
   content/docs/guide/biscuit-auth.mdx
   content/docs/guide/glossary.mdx
   content/docs/tech-explanation/payment-lifecycle.mdx
   Please add frontmatter at the beginning of each file. Example:

---
title: Biscuit Authentication in Fiber
description: Overview of Biscuit authentication and how it's integrated into Fiber's RPC system
date: 2025-03-17
---

2. Unsupported Code Block Language
   In biscuit-auth.mdx, the datalog language is not supported by Shiki (our syntax highlighter). Please change:

- datalog
+ text

How to Verify
Please run the build locally to ensure everything works:

pnpm build

Once these issues are resolved, I'll be happy to review and merge. Let me know if you have any questions!