Skip to content

Conversation

@saminacodes
Copy link
Member

@saminacodes saminacodes commented Dec 18, 2025


PR-Codex overview

This PR introduces new documentation content across several pages, enhancing the information available for building and deploying tokens, creating bridge links, and auditing wallets.

Detailed summary

  • Added a section titled Build with tokens in page.mdx.
  • Updated page.mdx for deploying tokens programmatically, including use cases and an OpenApiEndpoint.
  • Introduced a Bridge Link section in page.mdx with steps for generating and sharing links.
  • Added an audits tab in page.mdx with links to wallet audit reports.

✨ Ask PR-Codex anything about this PR by commenting with /codex {your question}

Summary by CodeRabbit

  • Documentation
    • Added Bridge Link guide with a four-step flow for generating, sharing, and hosting payment links
    • Added Build with Tokens guide (placeholder section)
    • Added Deploying Tokens Programmatically guide with API examples for ERC-20, ERC-721, and ERC-1155
    • Added Wallet Security Audits tab with links to external audit reports

✏️ Tip: You can customize this high-level summary in your review settings.

@saminacodes saminacodes requested review from a team as code owners December 18, 2025 20:09
@changeset-bot
Copy link

changeset-bot bot commented Dec 18, 2025

⚠️ No Changeset found

Latest commit: 6e87b92

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel
Copy link

vercel bot commented Dec 18, 2025

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

Project Deployment Review Updated (UTC)
docs-v2 Ready Ready Preview, Comment Dec 18, 2025 9:10pm
4 Skipped Deployments
Project Deployment Review Updated (UTC)
nebula Skipped Skipped Dec 18, 2025 9:10pm
thirdweb_playground Skipped Skipped Dec 18, 2025 9:10pm
thirdweb-www Skipped Skipped Dec 18, 2025 9:10pm
wallet-ui Skipped Skipped Dec 18, 2025 9:10pm

@github-actions github-actions bot added the Portal Involves changes to the Portal (docs) codebase. label Dec 18, 2025
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Dec 18, 2025

Walkthrough

Adds three new MDX documentation pages under apps/portal (Bridge Link, Build with tokens, Deploy programmatically) and updates the wallet security page to include an "Audits" tab with links to external audit reports.

Changes

Cohort / File(s) Change Summary
Bridge Documentation
apps/portal/src/app/bridge/link/page.mdx
New MDX page adding a Bridge Link guide that renders a four-step UI using Steps / Step components describing link generation, sharing, and hosting.
Token Guides
apps/portal/src/app/tokens/build-tokens/page.mdx, apps/portal/src/app/tokens/deploy-programmatically/page.mdx
Two new MDX pages: "Build with tokens" placeholder page; and "Deploy Programmatically through API" documenting ERC-20/721/1155 deployments and embedding an OpenApiEndpoint POST example for /v1/tokens.
Wallet Documentation Updates
apps/portal/src/app/wallets/security/page.mdx
Modified existing page to add a TabsTrigger with value audits and matching TabsContent that includes a "Wallets Audits" section with external audit links.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Focus review on MDX structure, component imports (Steps, Step, OpenApiEndpoint, Tabs*) and proper rendering.
  • Check for missing trailing newline in apps/portal/src/app/bridge/link/page.mdx.
  • Verify external links in the new "Audits" tab are correct and use safe link attributes.

Pre-merge checks and finishing touches

❌ Failed checks (2 inconclusive)
Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'added audits' is only partially related to the changeset. While audits are added to the wallet security page, the PR includes multiple substantial additions (tokens build guide, deploy programmatically docs, bridge link guide) that represent the main changes. Consider a more comprehensive title that captures the primary intent, such as '[Portal] Docs: Add token guides, bridge links, and wallet audits' or clarify if audits is the main focus.
Description check ❓ Inconclusive The PR description includes a PR-Codex auto-generated overview with detailed summaries of changes, but does not follow the required template format (missing explicit title format, Linear issue tag, 'Notes for the reviewer', and 'How to test' sections). Follow the repository template by adding formatted title, Linear issue tag if applicable, dedicated 'Notes for the reviewer' section, and 'How to test' section with testing instructions.
✅ Passed checks (1 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch audit-tab-portal

📜 Recent review details

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 2622883 and 6e87b92.

📒 Files selected for processing (4)
  • apps/portal/src/app/bridge/link/page.mdx (1 hunks)
  • apps/portal/src/app/tokens/build-tokens/page.mdx (1 hunks)
  • apps/portal/src/app/tokens/deploy-programmatically/page.mdx (1 hunks)
  • apps/portal/src/app/wallets/security/page.mdx (2 hunks)
🚧 Files skipped from review as they are similar to previous changes (4)
  • apps/portal/src/app/wallets/security/page.mdx
  • apps/portal/src/app/tokens/build-tokens/page.mdx
  • apps/portal/src/app/tokens/deploy-programmatically/page.mdx
  • apps/portal/src/app/bridge/link/page.mdx
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (8)
  • GitHub Check: E2E Tests (pnpm, webpack)
  • GitHub Check: Unit Tests
  • GitHub Check: E2E Tests (pnpm, vite)
  • GitHub Check: E2E Tests (pnpm, esbuild)
  • GitHub Check: Size
  • GitHub Check: Lint Packages
  • GitHub Check: Build Packages
  • GitHub Check: Analyze (javascript)

Warning

Review ran into problems

🔥 Problems

Errors were encountered while retrieving linked issues.

Errors (4)
  • TEAM-0000: Entity not found: Issue - Could not find referenced Issue.
  • ERC-20: Entity not found: Issue - Could not find referenced Issue.
  • ERC-721: Entity not found: Issue - Could not find referenced Issue.
  • ERC-1155: Entity not found: Issue - Could not find referenced Issue.

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

@codecov
Copy link

codecov bot commented Dec 18, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 54.47%. Comparing base (9383ccd) to head (6e87b92).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #8577   +/-   ##
=======================================
  Coverage   54.47%   54.47%           
=======================================
  Files         922      922           
  Lines       61361    61361           
  Branches     4149     4149           
=======================================
  Hits        33425    33425           
  Misses      27835    27835           
  Partials      101      101           
Flag Coverage Δ
packages 54.47% <ø> (ø)
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Copy link
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: 2

🧹 Nitpick comments (1)
apps/portal/src/app/tokens/deploy-programmatically/page.mdx (1)

17-24: Consider removing trailing empty lines.

The OpenApiEndpoint component usage is correct. However, Lines 21-24 contain excessive trailing whitespace that could be cleaned up for better file hygiene.

🔎 Apply this diff to remove trailing lines:
 ## Deploy ERC-20 Token
 
 <OpenApiEndpoint path="/v1/tokens" method="POST" />
-
-
-
-
📜 Review details

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 9383ccd and 2622883.

📒 Files selected for processing (4)
  • apps/portal/src/app/bridge/link/page.mdx (1 hunks)
  • apps/portal/src/app/tokens/build-tokens/page.mdx (1 hunks)
  • apps/portal/src/app/tokens/deploy-programmatically/page.mdx (1 hunks)
  • apps/portal/src/app/wallets/security/page.mdx (2 hunks)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (8)
  • GitHub Check: E2E Tests (pnpm, vite)
  • GitHub Check: Lint Packages
  • GitHub Check: E2E Tests (pnpm, esbuild)
  • GitHub Check: Build Packages
  • GitHub Check: E2E Tests (pnpm, webpack)
  • GitHub Check: Unit Tests
  • GitHub Check: Size
  • GitHub Check: Analyze (javascript)
🔇 Additional comments (5)
apps/portal/src/app/wallets/security/page.mdx (2)

26-28: LGTM!

The new "Audits" tab trigger follows the same pattern and styling as the existing tabs.


195-203: The audit link to thirdweb-22 may be invalid.

Line 201 references "https://0xmacro.com/library/audits/thirdweb-22", but the 0xMacro audit library appears to only include audits up to thirdweb-17. Verify this link exists or update to the correct audit number. The IPFS link on line 202 may also be subject to gateway availability issues.

apps/portal/src/app/bridge/link/page.mdx (1)

1-2: LGTM!

The component imports are correct and necessary for the Steps UI pattern used in this documentation page.

apps/portal/src/app/tokens/deploy-programmatically/page.mdx (2)

1-6: LGTM!

The import statement and page introduction are clear and appropriate for API documentation.


8-14: LGTM!

The use cases section provides clear examples of when programmatic token deployment is beneficial.

Comment on lines +9 to +22
<Steps>
<Step title="Generate Links">
Generate a link to request a specific amount of tokens from a specific wallet.
</Step>
<Step title="Share payment ">
Host the link on your website
</Step>
<Step title="Host Link">
Host the link on your website
</Step>
<Step title="Host Link">
Host the link on your website
</Step>
</Steps> No newline at end of file
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major

Fix duplicate steps and mismatched content.

The Steps component contains duplicate and incomplete content:

  1. Line 13-15: The "Share payment" step title doesn't match its content ("Host the link on your website").
  2. Lines 16-21: Steps 3 and 4 both have the identical title "Host Link" and identical content, appearing to be copy-paste duplicates.

This creates confusing documentation that doesn't provide distinct, actionable guidance for each step.

🔎 Suggested structure for the steps:
 <Steps>
 <Step title="Generate Links">
 Generate a link to request a specific amount of tokens from a specific wallet.
 </Step>
-<Step title="Share payment ">
-Host the link on your website 
+<Step title="Customize the link">
+[Add content about customizing the bridge link parameters]
 </Step>
 <Step title="Host Link">
 Host the link on your website 
 </Step>
-<Step title="Host Link">
-Host the link on your website 
+<Step title="Share with users">
+[Add content about sharing the link with users]
 </Step>
 </Steps>

Would you like me to help draft appropriate content for each step based on typical bridge link workflows?

🤖 Prompt for AI Agents
In apps/portal/src/app/bridge/link/page.mdx around lines 9 to 22, the Steps
block has a mismatched title/content for "Share payment" (title shows “Share
payment” but content says “Host the link on your website”) and two duplicate
"Host Link" steps; replace the four entries with four distinct steps (e.g.,
"Generate Links" — describe creating a payment link with amount and wallet;
"Share Payment" — explain how to distribute the link to payers via
email/QR/embed/social; "Host Link" — describe embedding or hosting the link on
your website and required config); and "Monitor Payments" or "Confirm Receipt" —
describe how to verify and handle incoming payments; remove the duplicate step
and ensure each Step title matches its content and is concise and actionable.

Comment on lines +1 to +3
# Build with tokens

### No newline at end of file
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Remove the empty heading or add content.

Line 3 contains an empty heading marker (###) with no text. This creates incomplete documentation structure and should either have meaningful content added or be removed entirely.

🔎 Apply this diff to remove the empty heading:
 # Build with tokens
 
-### 

Do you want me to help draft content for this placeholder section?

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
# Build with tokens
###
# Build with tokens
🤖 Prompt for AI Agents
In apps/portal/src/app/tokens/build-tokens/page.mdx around lines 1 to 3, there
is an empty third-level heading marker ("###") on line 3; either delete that
line to remove the empty heading or replace it with a meaningful subheading and
accompanying content (e.g., a short description or list explaining the build
tokens section). Ensure markdown structure remains valid (no stray heading
markers) and update any nearby TOC or references if you add a new subsection
title.

@github-actions
Copy link
Contributor

github-actions bot commented Dec 18, 2025

size-limit report 📦

Path Size
@thirdweb-dev/nexus (esm) 105.66 KB (0%)
@thirdweb-dev/nexus (cjs) 319.47 KB (0%)

@MananTank MananTank added the merge-queue Adds the pull request to Graphite's merge queue. label Dec 18, 2025
Copy link
Member

MananTank commented Dec 18, 2025

Merge activity

<!--

## title your PR with this format: "[SDK/Dashboard/Portal] Feature/Fix: Concise title for the changes"

If you did not copy the branch name from Linear, paste the issue tag here (format is TEAM-0000):

## Notes for the reviewer

Anything important to call out? Be sure to also clarify these in your comments.

## How to test

Unit tests, playground, etc.

-->

<!-- start pr-codex -->

---

## PR-Codex overview
This PR adds documentation for building and deploying tokens programmatically, generating bridge links, and auditing wallets. It enhances the user experience by providing clear instructions and examples for developers.

### Detailed summary
- Added a section titled `Build with tokens` in `page.mdx`.
- Introduced `Deploy Programmatically through API` section with details on ERC-20, ERC-721, and ERC-1155 tokens in `deploy-programmatically/page.mdx`.
- Included a guide on generating bridge links with steps in `link/page.mdx`.
- Added `Wallets Audits` section with links to audit reports in `security/page.mdx`.

> ✨ Ask PR-Codex anything about this PR by commenting with `/codex {your question}`

<!-- end pr-codex -->

<!-- This is an auto-generated comment: release notes by coderabbit.ai -->

## Summary by CodeRabbit

* **Documentation**
  * Added Bridge Link guide with step-by-step instructions for generating payment links and hosting them on websites
  * Added Build with Tokens guide
  * Added Deploying Tokens Programmatically guide with API examples for ERC-20, ERC-721, and ERC-1155 tokens
  * Added Wallet Security Audits section highlighting audit reports

<sub>✏️ Tip: You can customize this high-level summary in your review settings.</sub>

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
@vercel vercel bot temporarily deployed to Preview – wallet-ui December 18, 2025 20:59 Inactive
@vercel vercel bot temporarily deployed to Preview – thirdweb_playground December 18, 2025 20:59 Inactive
@vercel vercel bot temporarily deployed to Preview – nebula December 18, 2025 20:59 Inactive
@vercel vercel bot temporarily deployed to Preview – thirdweb-www December 18, 2025 20:59 Inactive
@graphite-app graphite-app bot merged commit 6e87b92 into main Dec 18, 2025
25 checks passed
@graphite-app graphite-app bot deleted the audit-tab-portal branch December 18, 2025 21:10
@vercel vercel bot temporarily deployed to Production – nebula December 18, 2025 21:10 Inactive
@vercel vercel bot temporarily deployed to Production – wallet-ui December 18, 2025 21:10 Inactive
@vercel vercel bot temporarily deployed to Production – thirdweb_playground December 18, 2025 21:10 Inactive
@vercel vercel bot temporarily deployed to Production – thirdweb-www December 18, 2025 21:10 Inactive
@graphite-app graphite-app bot removed the merge-queue Adds the pull request to Graphite's merge queue. label Dec 18, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Portal Involves changes to the Portal (docs) codebase.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants