Skip to content

docs(contracts): refresh docs index and normalize API links#1722

Open
Ser4nu11EN7 wants to merge 1 commit intolifinance:mainfrom
Ser4nu11EN7:docs/contracts-readme-links
Open

docs(contracts): refresh docs index and normalize API links#1722
Ser4nu11EN7 wants to merge 1 commit intolifinance:mainfrom
Ser4nu11EN7:docs/contracts-readme-links

Conversation

@Ser4nu11EN7
Copy link
Copy Markdown

Which Linear task belongs to this PR?

N/A (community contribution)

Why did I implement it this way?

This is a docs-only cleanup. The docs index was out of date, and several references still pointed to the deprecated �pidocs.li.finance hostname. Refreshing the README index and normalizing those links reduces friction for contributors reading the contracts docs.

Checklist before requesting a review

Checklist for reviewer (DO NOT DEPLOY and contracts BEFORE CHECKING THIS!!!)

  • I have checked that any arbitrary calls to external contracts are validated and or restricted
  • I have checked that any privileged calls (i.e. storage modifications) are validated and or restricted
  • I have ensured that any new contracts have had AT A MINIMUM 1 preliminary audit conducted on by <company/auditor>

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Apr 20, 2026

Warning

Rate limit exceeded

@Ser4nu11EN7 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 23 minutes and 19 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 23 minutes and 19 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 1c568b0c-696b-4847-a173-604179bf9957

📥 Commits

Reviewing files that changed from the base of the PR and between 7c4f4fe and e4d2fa5.

📒 Files selected for processing (9)
  • docs/ArbitrumBridgeFacet.md
  • docs/CelerCircleBridgeFacet.md
  • docs/GnosisBridgeFacet.md
  • docs/MegaETHBridgeFacet.md
  • docs/OmniBridgeFacet.md
  • docs/OptimismBridgeFacet.md
  • docs/PolygonBridgeFacet.md
  • docs/README.md
  • docs/StargateFacetV2.md

Walkthrough

Documentation-only updates across multiple bridge facet files, replacing the API documentation domain from apidocs.li.finance to apidocs.li.fi, and expanding the README with new facet and guide index entries. No code logic or functionality changes.

Changes

Cohort / File(s) Summary
Bridge Facet Documentation
docs/ArbitrumBridgeFacet.md, docs/CelerCircleBridgeFacet.md, docs/GnosisBridgeFacet.md, docs/MegaETHBridgeFacet.md, docs/OmniBridgeFacet.md, docs/OptimismBridgeFacet.md, docs/PolygonBridgeFacet.md, docs/StargateFacetV2.md
Updated hyperlinks to LiFi API documentation, changing base domain from apidocs.li.finance to apidocs.li.fi for /quote endpoint and "how-to-transfer-tokens" references.
Documentation Index
docs/README.md
Expanded index with new facet links (Across, Eco, Garden, GasZip, Glacis, LiFi Intent Escrow, MegaETH Bridge, NEAR Intents, Pioneer, Polymer CCTP, Relay Depository, Symbiosis, Unit), periphery/helper links (GasZipPeriphery, ReceiverAcrossV3, ReceiverAcrossV4, ReceiverOIF), corrected DeBridge DLN link format, and added new top-level sections for Governance and Guides.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Suggested labels

AuditNotRequired

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely summarizes the main changes: refreshing the documentation index and normalizing API links from deprecated hostname.
Description check ✅ Passed The description is complete and follows the template structure, providing the Linear task reference, implementation rationale, and marked appropriate checklist items for a documentation-only change.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 4

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
docs/README.md (1)

5-96: ⚠️ Potential issue | 🟠 Major

Fix 10 dead links in docs/README.md.

The following files are referenced but missing from docs/:

  • AmarokFacet.md
  • CircleBridgeFacet.md
  • HyphenFacet.md
  • LIFuelFacet.md
  • RoninBridgeFacet.md
  • StandardizedCallFacet.md
  • StargateFacet.md
  • LiFuelFeeCollector.md
  • Receiver.md
  • RelayerCelerIM.md

Either create these documentation files or remove the broken links from the README.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/README.md` around lines 5 - 96, The README links list contains
references to missing docs (entries like "Amarok Facet", "Circle Bridge Facet",
"Hyphen Facet", "LIFuel Facet", "Ronin Bridge Facet", "Standardized Call Facet",
"Stargate Facet", and periphery entries "LiFuelFeeCollector", "Receiver",
"RelayerCelerIM") that cause dead links; to fix, either add the corresponding
markdown files to docs/ (e.g., create AmarokFacet.md, CircleBridgeFacet.md,
HyphenFacet.md, LIFuelFacet.md, RoninBridgeFacet.md, StandardizedCallFacet.md,
StargateFacet.md, LiFuelFeeCollector.md, Receiver.md, RelayerCelerIM.md) with
the appropriate content, or remove the matching list items/links from
docs/README.md (search for the link labels shown in the README like "Amarok
Facet", "Circle Bridge Facet", "Hyphen Facet", "LIFuel Facet", "Ronin Bridge
Facet", "Standardized Call Facet", "Stargate Facet", "LiFuelFeeCollector",
"Receiver", "RelayerCelerIM" and update accordingly).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/ArbitrumBridgeFacet.md`:
- Line 101: The link text "here" is non-descriptive and fails MD059; update the
anchor at the sentence "A detailed explanation on how to use the /quote endpoint
and how to trigger the transaction can be found
[here](https://apidocs.li.fi/reference/how-to-transfer-tokens)." to use a
descriptive label such as "API docs: How to transfer tokens" or "How to transfer
tokens (Li.Fi API)" so the markdown reads e.g. "...can be found [How to transfer
tokens](https://apidocs.li.fi/reference/how-to-transfer-tokens)." to improve
accessibility and clarity.

In `@docs/CelerCircleBridgeFacet.md`:
- Line 64: Replace the ambiguous link text "here" with an accessible,
descriptive label for the URL pointing to
https://apidocs.li.fi/reference/how-to-transfer-tokens (e.g., "API docs: How to
transfer tokens" or "How to transfer tokens (li.fi API docs)") so the sentence
reads: "A detailed explanation on how to use the /quote endpoint and how to
trigger the transaction can be found [How to transfer tokens (li.fi API
docs)](https://apidocs.li.fi/reference/how-to-transfer-tokens)." Ensure the new
text addresses MD059 by providing meaningful link text.

In `@docs/OptimismBridgeFacet.md`:
- Line 94: The markdown link uses the generic anchor "here" which triggers
MD059; update the anchor to descriptive text such as "How to transfer tokens"
(or "API docs: How to transfer tokens") by replacing the text "[here]" in the
sentence "A detailed explanation ... can be found
[here](https://apidocs.li.fi/reference/how-to-transfer-tokens)" with a
descriptive label so the link becomes e.g. "[How to transfer
tokens](https://apidocs.li.fi/reference/how-to-transfer-tokens)"; keep the URL
unchanged and ensure the new anchor satisfies the markdown linter.

In `@docs/PolygonBridgeFacet.md`:
- Line 64: The link text "here" for the URL
https://apidocs.li.fi/reference/how-to-transfer-tokens (referencing the /quote
endpoint and how to trigger the transaction) is non‑descriptive; update the
Markdown so the link text explicitly describes the target (e.g., "li.fi API docs
– How to transfer tokens" or "How to transfer tokens (li.fi API docs)"),
replacing "here" in the PolygonBridgeFacet.md line that references the /quote
endpoint to satisfy MD059.

---

Outside diff comments:
In `@docs/README.md`:
- Around line 5-96: The README links list contains references to missing docs
(entries like "Amarok Facet", "Circle Bridge Facet", "Hyphen Facet", "LIFuel
Facet", "Ronin Bridge Facet", "Standardized Call Facet", "Stargate Facet", and
periphery entries "LiFuelFeeCollector", "Receiver", "RelayerCelerIM") that cause
dead links; to fix, either add the corresponding markdown files to docs/ (e.g.,
create AmarokFacet.md, CircleBridgeFacet.md, HyphenFacet.md, LIFuelFacet.md,
RoninBridgeFacet.md, StandardizedCallFacet.md, StargateFacet.md,
LiFuelFeeCollector.md, Receiver.md, RelayerCelerIM.md) with the appropriate
content, or remove the matching list items/links from docs/README.md (search for
the link labels shown in the README like "Amarok Facet", "Circle Bridge Facet",
"Hyphen Facet", "LIFuel Facet", "Ronin Bridge Facet", "Standardized Call Facet",
"Stargate Facet", "LiFuelFeeCollector", "Receiver", "RelayerCelerIM" and update
accordingly).
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 2541554a-5745-4882-a569-d60399128743

📥 Commits

Reviewing files that changed from the base of the PR and between 4dbbb87 and 7c4f4fe.

📒 Files selected for processing (9)
  • docs/ArbitrumBridgeFacet.md
  • docs/CelerCircleBridgeFacet.md
  • docs/GnosisBridgeFacet.md
  • docs/MegaETHBridgeFacet.md
  • docs/OmniBridgeFacet.md
  • docs/OptimismBridgeFacet.md
  • docs/PolygonBridgeFacet.md
  • docs/README.md
  • docs/StargateFacetV2.md

Comment thread docs/ArbitrumBridgeFacet.md Outdated
Comment thread docs/CelerCircleBridgeFacet.md Outdated
Comment thread docs/OptimismBridgeFacet.md Outdated
Comment thread docs/PolygonBridgeFacet.md Outdated
@Ser4nu11EN7 Ser4nu11EN7 force-pushed the docs/contracts-readme-links branch from 7c4f4fe to 8f0fd7d Compare April 20, 2026 08:26
@Ser4nu11EN7 Ser4nu11EN7 force-pushed the docs/contracts-readme-links branch from 8f0fd7d to e4d2fa5 Compare April 20, 2026 08:43
@Ser4nu11EN7 Ser4nu11EN7 marked this pull request as ready for review April 20, 2026 08:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant