lychee.toml

# lychee configuration — https://lychee.cli.rs
# Checks *external* URLs for rot (404s, dead domains) on a schedule. This
# complements `mint broken-links` (which validates internal/relative links) and
# replaces the external half of Mintlify's "Fix broken links" workflow.

# Only check web URLs — relative/internal links are mint's job.
scheme = ["https", "http"]

# Resolve root-relative links (e.g. /evm/foo) against the live site so lychee
# doesn't warn that it can't build a URL for them...
base_url = "https://docs.sei.io"

# Network behavior.
# Deprecated section (SIP-3) — don't check its links.
exclude_path = ["cosmos-sdk"]

max_concurrency = 16
max_retries = 3
retry_wait_time = 2
timeout = 20
# A real browser UA avoids naive bot-blocks.
user_agent = "Mozilla/5.0 (compatible; lychee link checker; +https://github.com/sei-protocol/sei-docs)"

# Treat rate-limiting / bot-challenge responses as OK rather than broken. 405
# (Method Not Allowed) covers JSON-RPC endpoints like evm-rpc.sei-apis.com that
# reject the checker's GET but are very much alive.
accept = ["200..=206", "301", "302", "304", "403", "405", "429"]

# Don't flag these — local/example hosts and domains that hard-block automated
# requests (so a failure here is a false positive, not real rot).
exclude = [
  # ...then skip the docs site itself — `mint broken-links` owns internal links.
  # blog.sei.io, dashboard.sei.io, www.sei.io and all third-party URLs are still checked.
  "^https?://docs\\.sei\\.io",
  "^https?://localhost",
  "^https?://127\\.0\\.0\\.1",
  "^https?://0\\.0\\.0\\.0",
  "^https?://.*\\.local",
  "^https?://example\\.(com|org|net)",
  "^https?://(www\\.)?(twitter|x)\\.com",
  "^https?://(www\\.)?linkedin\\.com",
  "^https?://(www\\.)?reddit\\.com",
  "^https?://(t\\.me|discord\\.gg|discord\\.com)",
  # Live sites that hard-block automated checkers (verified reachable in a browser):
  #   silostaking.io      → 402 Payment Required to bots
  #   dashboard.pimlico.io → 404 to bots (client-rendered app shell)
  #   blog.thirdweb.com   → cert chain rejected by lychee's TLS, fine in browsers
  #   updraft.cyfrin.io   → 404 to bots (Cloudflare challenge), real 200 in browsers
  "^https?://(www\\.)?silostaking\\.io",
  "^https?://dashboard\\.pimlico\\.io",
  "^https?://blog\\.thirdweb\\.com",
  "^https?://(www\\.)?updraft\\.cyfrin\\.io",
  # Sei's own JSON-RPC / REST node endpoints (evm-rpc[-testnet|-arctic-1], rpc
  # [-testnet]) intermittently answer the checker with a transient 503 from
  # gateway rate-limiting, though they serve real traffic and are referenced
  # 140+ times across the docs. Node liveness is monitored elsewhere.
  "^https?://(evm-)?rpc(-testnet|-arctic-1)?\\.sei-apis\\.com",
]

# Don't check mailto: links (this is the default; set explicitly for clarity).
include_mail = false