Skip to content

Conversation

@0xFirekeeper
Copy link
Member

@0xFirekeeper 0xFirekeeper commented Dec 3, 2025

Added a new sidebar entry for Solana Transactions in the wallets section and introduced a comprehensive Solana server wallet documentation page covering wallet management, balances, transactions, signing, swaps, and example API workflows.

Closes BLD-414


PR-Codex overview

This PR focuses on adding support for Solana transactions in the wallet application, including wallet management, transaction capabilities, and detailed API documentation for developers.

Detailed summary

  • Added a new entry for "Solana Transactions" in the sidebar.
  • Created a new page.mdx for "Solana Server Wallets" with metadata.
  • Included sections on wallet management, balance & tokens, message signing, custom transactions, and token swaps.
  • Provided example workflows for creating wallets, checking balances, sending tokens, and executing swaps.
  • Added network identifiers for Solana mainnet and devnet.

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

Summary by CodeRabbit

  • New Features

    • Added a "Solana Transactions" link under Server Wallets for direct access to Solana wallet operations.
  • Documentation

    • New Solana server wallets documentation with getting-started guides, API workflows (create/fund/send/swap), wallet management, balance/transaction views, signing, custom transactions, and mainnet-only swap guidance.

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

@0xFirekeeper 0xFirekeeper requested review from a team as code owners December 3, 2025 18:57
@linear
Copy link

linear bot commented Dec 3, 2025

@changeset-bot
Copy link

changeset-bot bot commented Dec 3, 2025

⚠️ No Changeset found

Latest commit: b27fcd3

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 3, 2025

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

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

@graphite-app
Copy link
Contributor

graphite-app bot commented Dec 3, 2025

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

  • merge-queue - adds this PR to the back of the merge queue
  • hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

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

coderabbitai bot commented Dec 3, 2025

Walkthrough

This PR adds Solana server wallet documentation and a new sidebar link. It introduces apps/portal/src/app/wallets/solana/page.mdx with metadata and structured MDX content, and appends a "Solana Transactions" link to the Server Wallets section in apps/portal/src/app/wallets/sidebar.tsx.

Changes

Cohort / File(s) Summary
Sidebar Navigation
apps/portal/src/app/wallets/sidebar.tsx
Added a new Server Wallets link: { href: ${walletSlug}/solana, name: "Solana Transactions" }.
Solana Documentation
apps/portal/src/app/wallets/solana/page.mdx
New MDX page exporting metadata and providing comprehensive Solana server wallet documentation (wallet management, balances, signing, custom transactions, token swaps), example workflows, OpenApiEndpoint references, and UI components (Callout, Steps, Tabs, etc.).

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

  • Review focus areas:
    • Validate createMetadata export and image/title/description values in page.mdx.
    • Check correctness of OpenApiEndpoint references and example payloads/responses.
    • Verify sidebar link path (${walletSlug}/solana) integrates with routing.

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)
Check name Status Explanation Resolution
Description check ❓ Inconclusive The description provides a good summary of changes and references the linked issue (BLD-414), though it does not follow the template format with title prefix, issue tag, notes for reviewer, or testing instructions. Consider following the repository template more closely by including '[Portal] Feature:' prefix, explicit testing instructions, and reviewer notes for better clarity.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title 'Add Solana wallet docs and sidebar link' is clear, concise, and accurately reflects the two main changes: adding documentation and a sidebar link.
Linked Issues check ✅ Passed The PR references and closes BLD-414 (Portal Documentation), and the changes align with documentation objectives by adding comprehensive Solana wallet documentation and UI integration.
Out of Scope Changes check ✅ Passed All changes are focused on adding Solana wallet documentation and sidebar navigation; no out-of-scope modifications are present.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch firekeeper/solana-docs

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

@0xFirekeeper 0xFirekeeper added the merge-queue Adds the pull request to Graphite's merge queue. label Dec 3, 2025
Copy link
Member Author

0xFirekeeper commented Dec 3, 2025

Merge activity

@codecov
Copy link

codecov bot commented Dec 3, 2025

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 54.66%. Comparing base (c40603f) to head (b27fcd3).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #8489   +/-   ##
=======================================
  Coverage   54.66%   54.66%           
=======================================
  Files         920      920           
  Lines       61106    61106           
  Branches     4143     4143           
=======================================
  Hits        33403    33403           
  Misses      27601    27601           
  Partials      102      102           
Flag Coverage Δ
packages 54.66% <ø> (ø)
🚀 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: 0

🧹 Nitpick comments (1)
apps/portal/src/app/wallets/solana/page.mdx (1)

133-139: Consider renaming tab value for consistency.

The tab value "fund" doesn't match the label "2. Check Balance" or the tab content which demonstrates balance checking. Consider renaming to "balance" for clarity:

-<Tabs defaultValue="create">
+<Tabs defaultValue="create">
   <TabsList>
     <TabsTrigger value="create">1. Create Wallet</TabsTrigger>
-    <TabsTrigger value="fund">2. Check Balance</TabsTrigger>
+    <TabsTrigger value="balance">2. Check Balance</TabsTrigger>
     <TabsTrigger value="send">3. Send Tokens</TabsTrigger>
     <TabsTrigger value="swap">4. Swap Tokens</TabsTrigger>
   </TabsList>

And update the corresponding TabsContent:

-<TabsContent value="fund">
+<TabsContent value="balance">
📜 Review details

Configuration used: CodeRabbit 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 c40603f and f64e845.

📒 Files selected for processing (2)
  • apps/portal/src/app/wallets/sidebar.tsx (1 hunks)
  • apps/portal/src/app/wallets/solana/page.mdx (1 hunks)
🧰 Additional context used
📓 Path-based instructions (3)
**/*.{ts,tsx}

📄 CodeRabbit inference engine (CLAUDE.md)

**/*.{ts,tsx}: Write idiomatic TypeScript with explicit function declarations and return types
Limit each TypeScript file to one stateless, single-responsibility function for clarity
Re-use shared types from @/types or local types.ts barrels
Prefer type aliases over interface except for nominal shapes in TypeScript
Avoid any and unknown in TypeScript unless unavoidable; narrow generics when possible
Choose composition over inheritance; leverage utility types (Partial, Pick, etc.) in TypeScript

**/*.{ts,tsx}: Write idiomatic TypeScript with explicit function declarations and return types
Limit each file to one stateless, single-responsibility function for clarity and testability
Re-use shared types from @/types or local types.ts barrel exports
Prefer type aliases over interface except for nominal shapes
Avoid any and unknown unless unavoidable; narrow generics whenever possible
Choose composition over inheritance; leverage utility types (Partial, Pick, etc.)
Comment only ambiguous logic in TypeScript files; avoid restating TypeScript types and signatures in prose

Files:

  • apps/portal/src/app/wallets/sidebar.tsx
**/*.{js,jsx,ts,tsx,json}

📄 CodeRabbit inference engine (AGENTS.md)

Biome governs formatting and linting; its rules live in biome.json. Run pnpm fix & pnpm lint before committing, ensure there are no linting errors

Files:

  • apps/portal/src/app/wallets/sidebar.tsx
**/*.{ts,tsx,js,jsx}

📄 CodeRabbit inference engine (AGENTS.md)

Lazy-import optional features; avoid top-level side-effects

Files:

  • apps/portal/src/app/wallets/sidebar.tsx
⏰ 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). (4)
  • GitHub Check: Lint Packages
  • GitHub Check: Size
  • GitHub Check: Vercel Agent Review
  • GitHub Check: Analyze (javascript)
🔇 Additional comments (4)
apps/portal/src/app/wallets/sidebar.tsx (1)

85-88: LGTM!

The new sidebar entry for "Solana Transactions" follows the existing pattern and correctly links to the new documentation page at /wallets/solana.

apps/portal/src/app/wallets/solana/page.mdx (3)

1-21: LGTM!

The imports and metadata configuration are well-structured and follow the documentation conventions.


57-127: Well-structured API documentation.

The API endpoint sections are comprehensive and logically organized. Good use of callouts to highlight important constraints (funding requirement, mainnet-only swaps).


141-237: LGTM!

The example workflow provides practical curl commands with clear request/response pairs. Appropriate use of placeholder secrets (YOUR_SECRET_KEY) in examples.

@github-actions
Copy link
Contributor

github-actions bot commented Dec 3, 2025

size-limit report 📦

Path Size
@thirdweb-dev/nexus (esm) 104.88 KB (0%)
@thirdweb-dev/nexus (cjs) 316.6 KB (0%)

Added a new sidebar entry for Solana Transactions in the wallets section and introduced a comprehensive Solana server wallet documentation page covering wallet management, balances, transactions, signing, swaps, and example API workflows.

Closes BLD-414

<!-- start pr-codex -->

---

## PR-Codex overview
This PR introduces support for managing Solana transactions in the application, including wallet creation, balance checking, token transfers, and swaps. It enhances the user interface with detailed documentation and examples for developers.

### Detailed summary
- Added a new sidebar entry for `Solana Transactions`.
- Created a detailed `page.mdx` for Solana server wallets.
- Included metadata for the `Solana Server Wallets` page.
- Documented capabilities: wallet management, balance checking, signing, token swaps, and custom transactions.
- Provided example workflows using `curl` commands for various operations.
- Defined network identifiers for `Mainnet` and `Devnet`.

> ✨ 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

* **New Features**
  * Added Solana Transactions link in Server Wallets navigation for streamlined access to Solana wallet operations

* **Documentation**
  * New Solana server wallets documentation page with getting started guides, API workflows for wallet creation, balance retrieval, token transfers, transaction signing, and token swap operations

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

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
@graphite-app graphite-app bot force-pushed the firekeeper/solana-docs branch from f64e845 to b27fcd3 Compare December 3, 2025 19:08
@vercel vercel bot temporarily deployed to Preview – nebula December 3, 2025 19:09 Inactive
@vercel vercel bot temporarily deployed to Preview – thirdweb-www December 3, 2025 19:09 Inactive
@vercel vercel bot temporarily deployed to Preview – thirdweb_playground December 3, 2025 19:09 Inactive
@vercel vercel bot temporarily deployed to Preview – wallet-ui December 3, 2025 19:09 Inactive
@graphite-app graphite-app bot merged commit b27fcd3 into main Dec 3, 2025
23 of 24 checks passed
@graphite-app graphite-app bot deleted the firekeeper/solana-docs branch December 3, 2025 19:11
@vercel vercel bot temporarily deployed to Production – nebula December 3, 2025 19:11 Inactive
@vercel vercel bot temporarily deployed to Production – thirdweb-www December 3, 2025 19:11 Inactive
@vercel vercel bot temporarily deployed to Production – thirdweb_playground December 3, 2025 19:11 Inactive
@vercel vercel bot temporarily deployed to Production – wallet-ui December 3, 2025 19:11 Inactive
@graphite-app graphite-app bot removed the merge-queue Adds the pull request to Graphite's merge queue. label Dec 3, 2025
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: 0

🧹 Nitpick comments (2)
apps/portal/src/app/wallets/sidebar.tsx (1)

85-88: Consider aligning nav label with page title/scope

The href correctly matches /wallets/solana, but the label "Solana Transactions" is narrower than the page’s title/content ("Solana Server Wallets" with management, signing, swaps, etc.). Consider renaming this entry to something like "Solana Server Wallets" for consistency and clearer expectations.

apps/portal/src/app/wallets/solana/page.mdx (1)

1-237: Well-structured Solana server wallets doc; only minor optional tweaks

The page is structurally solid: metadata export, sectioning, endpoint references, and tabbed workflow examples all hang together and match the new /wallets/solana route. The curl snippets use YOUR_SECRET_KEY and public Solana addresses/mints, so there are no actual secrets committed—Gitleaks warnings here are false positives.

If you want to go a step further, you might add a brief note near the first curl example reminding users not to expose x-secret-key in client-side code, but that’s purely an optional hardening/education tweak; the current content is good to ship.

📜 Review details

Configuration used: CodeRabbit 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 f64e845 and b27fcd3.

📒 Files selected for processing (2)
  • apps/portal/src/app/wallets/sidebar.tsx (1 hunks)
  • apps/portal/src/app/wallets/solana/page.mdx (1 hunks)
🧰 Additional context used
📓 Path-based instructions (3)
**/*.{ts,tsx}

📄 CodeRabbit inference engine (CLAUDE.md)

**/*.{ts,tsx}: Write idiomatic TypeScript with explicit function declarations and return types
Limit each TypeScript file to one stateless, single-responsibility function for clarity
Re-use shared types from @/types or local types.ts barrels
Prefer type aliases over interface except for nominal shapes in TypeScript
Avoid any and unknown in TypeScript unless unavoidable; narrow generics when possible
Choose composition over inheritance; leverage utility types (Partial, Pick, etc.) in TypeScript

**/*.{ts,tsx}: Write idiomatic TypeScript with explicit function declarations and return types
Limit each file to one stateless, single-responsibility function for clarity and testability
Re-use shared types from @/types or local types.ts barrel exports
Prefer type aliases over interface except for nominal shapes
Avoid any and unknown unless unavoidable; narrow generics whenever possible
Choose composition over inheritance; leverage utility types (Partial, Pick, etc.)
Comment only ambiguous logic in TypeScript files; avoid restating TypeScript types and signatures in prose

Files:

  • apps/portal/src/app/wallets/sidebar.tsx
**/*.{js,jsx,ts,tsx,json}

📄 CodeRabbit inference engine (AGENTS.md)

Biome governs formatting and linting; its rules live in biome.json. Run pnpm fix & pnpm lint before committing, ensure there are no linting errors

Files:

  • apps/portal/src/app/wallets/sidebar.tsx
**/*.{ts,tsx,js,jsx}

📄 CodeRabbit inference engine (AGENTS.md)

Lazy-import optional features; avoid top-level side-effects

Files:

  • apps/portal/src/app/wallets/sidebar.tsx
🪛 Gitleaks (8.30.0)
apps/portal/src/app/wallets/solana/page.mdx

[high] 143-145: Discovered a potential authorization token provided in a curl command header, which could compromise the curl accessed resource.

(curl-auth-header)


[high] 163-164: Discovered a potential authorization token provided in a curl command header, which could compromise the curl accessed resource.

(curl-auth-header)


[high] 181-183: Discovered a potential authorization token provided in a curl command header, which could compromise the curl accessed resource.

(curl-auth-header)


[high] 203-205: Discovered a potential authorization token provided in a curl command header, which could compromise the curl accessed resource.

(curl-auth-header)


[high] 209-209: Detected a Generic API Key, potentially exposing access to various services and sensitive operations.

(generic-api-key)

⏰ 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). (7)
  • GitHub Check: E2E Tests (pnpm, vite)
  • GitHub Check: E2E Tests (pnpm, esbuild)
  • GitHub Check: Size
  • GitHub Check: Unit Tests
  • GitHub Check: Lint Packages
  • GitHub Check: Vercel Agent Review
  • GitHub Check: Analyze (javascript)

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.

2 participants