feat(mosaic): wire up user profile Web3 wallets

[austincalvelage]

Description

Wire the Mosaic Web3 wallets section to the signed-in Clerk user. Connect Ethereum and Solana wallets through the signature flow, set a verified wallet as primary, and confirm removal. Retry a rejected signature on the existing unverified wallet. Respect immutable wallet settings for Connect and Remove while allowing primary-wallet changes.

Read configured providers and current wallet state. Include a live Swingset page and use the profile panel's web3WalletsSlot for composition. The section is hidden when there are no wallets and wallet creation is unavailable. Removal confirmation uses a shortened address and does not show a success toast.

Session reverification UI is deferred. Requests that require reverification surface the API error.

Checklist

• pnpm test runs as expected.
• pnpm build runs as expected.
• (If applicable) JSDoc comments have been added or updated for any package exports
• (If applicable) Documentation has been updated

Type of change

• 🐛 Bug fix
• 🌟 New feature
• 🔨 Breaking change
• 📖 Refactoring / dependency upgrade / documentation
• other:

[changeset-bot]

🦋 Changeset detected

Latest commit: abb4d7b

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

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

Not sure what this means? Click here to learn what changesets are.

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

[vercel]

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

Project	Deployment	Actions	Updated
swingset	Ready	Preview	Oct 7, 2026 11:34pm UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
clerk-js-sandbox	Skipped		Oct 7, 2026 11:34pm UTC

[coderabbitai]

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

• @coderabbitai resume to resume automatic reviews.
• @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

• ▶️ Resume reviews
• 🔍 Trigger review

ℹ️ Recent review info

⚙️ Run configuration

• Configuration used: Repository YAML (base), Organization UI (inherited)
• Review profile: ASSERTIVE
• Plan: Team
• Run ID: 35dd6997-2734-4e91-96ab-b37bff25b725

📥 Commits

Reviewing files that changed from the base of the PR and between b8bfc0b and 7f58b7c.

⛔ Files ignored due to path filters (1)

• pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml

📒 Files selected for processing (46)

• .changeset/web3-wallets-wire-up.md
• packages/mosaic/package.json
• packages/mosaic/src/__tests__/feature/fake-fapi-user.feature.test.tsx
• packages/mosaic/src/__tests__/feature/fake-fapi.ts
• packages/mosaic/src/__tests__/feature/fapi.ts
• packages/mosaic/src/components/action-menu/action-menu.test.tsx
• packages/mosaic/src/components/action-menu/action-menu.tsx
• packages/mosaic/src/features/user-profile/__tests__/user-profile-web3-actions.test.tsx
• packages/mosaic/src/features/user-profile/__tests__/user-profile-web3-wallets-section.feature.test.tsx
• packages/mosaic/src/features/user-profile/__tests__/user-profile-web3-wallets-section.view.test.tsx
• packages/mosaic/src/features/user-profile/user-profile-connected-accounts-section/user-profile-connected-accounts-section.controller.ts
• packages/mosaic/src/features/user-profile/user-profile-web3-wallet-row.view.tsx
• packages/mosaic/src/features/user-profile/user-profile-web3-wallets-section.view.tsx
• packages/mosaic/src/features/user-profile/user-profile-web3-wallets-section/user-profile-solana-wallet.dialog.tsx
• packages/mosaic/src/features/user-profile/user-profile-web3-wallets-section/user-profile-web3-wallets-feedback.ts
• packages/mosaic/src/features/user-profile/user-profile-web3-wallets-section/user-profile-web3-wallets-section.controller.ts
• packages/mosaic/src/features/user-profile/user-profile-web3-wallets-section/user-profile-web3-wallets-section.model.test.ts
• packages/mosaic/src/features/user-profile/user-profile-web3-wallets-section/user-profile-web3-wallets-section.model.ts
• packages/mosaic/src/features/user-profile/user-profile-web3-wallets-section/user-profile-web3-wallets-section.tsx
• packages/mosaic/src/features/user-profile/user-profile-web3-wallets-section/user-profile-web3-wallets-section.types.ts
• packages/mosaic/src/features/user-profile/user-profile-web3-wallets.messages.ts
• packages/mosaic/src/hooks/use-pending-action.ts
• packages/mosaic/vitest.config.mts
• packages/shared/src/__tests__/web3.spec.ts
• packages/shared/src/react/hooks/__tests__/useInstalledSolanaWallets.spec.tsx
• packages/shared/src/react/hooks/useInstalledSolanaWallets.ts
• packages/shared/src/utils/__tests__/sortIdentificationBasedOnVerification.test.ts
• packages/shared/src/utils/sortIdentificationBasedOnVerification.ts
• packages/shared/src/web3.ts
• packages/shared/tsdown.config.mts
• packages/swingset/src/app/(clerk)/live/web3-wallets/page.tsx
• packages/swingset/src/lib/live-navigation.ts
• packages/swingset/src/stories/fixtures/user-profile-web3-wallets.ts
• packages/swingset/src/stories/user-profile-web3-wallets-section.stories.tsx
• packages/ui/rspack.config.js
• packages/ui/src/components/SignIn/SignInFactorOneSolanaWalletsCard.tsx
• packages/ui/src/components/SignIn/__tests__/SignInFactorOneSolanaWalletsCard.test.tsx
• packages/ui/src/components/SignUp/SignUpStartSolanaWalletsCard.tsx
• packages/ui/src/components/UserProfile/EmailsSection.tsx
• packages/ui/src/components/UserProfile/PhoneSection.tsx
• packages/ui/src/components/UserProfile/Web3Section.tsx
• packages/ui/src/components/UserProfile/Web3SelectSolanaWalletScreen.tsx
• packages/ui/src/components/UserProfile/__tests__/utils.test.ts
• packages/ui/src/components/UserProfile/utils.ts
• packages/ui/src/components/Web3SolanaWalletButtons.tsx
• packages/ui/src/components/__tests__/Web3SolanaWalletButtons.test.tsx

Disabled knowledge base sources:

• Linear integration is disabled

You can enable these sources in your CodeRabbit configuration.

---

📝 Walkthrough

Walkthrough

Adds Web3 wallet management to Mosaic, including wallet projection, connection and removal actions, primary-wallet updates, localized feedback, and Solana wallet selection. Adds shared Solana wallet discovery and identification sorting, and updates UI components to use those utilities. Adds a Swingset live page and route for wallet management, plus supporting tests and changesets.

Estimated code review effort: 4 (Complex) | ~45 minutes

Priority: ⬇️ Low

Possibly related PRs

• clerk/javascript#9754: Adds wallet-removal confirmation and per-wallet removal state in the UI Web3 wallet row; this PR adds wallet-removal confirmation in the Mosaic profile section.

Merge Risk: 🔵 Low · up to 7f58b

A rejected wallet signature blocks an immediate retry because the existing unverified wallet is not reused. The issue is localized, but the retry flow should be fixed before relying on it.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 38 functions across 49 files.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main change: wiring up user-profile Web3 wallets in Mosaic.
Description check	✅ Passed	The description covers the Web3 wallet connection, primary-wallet, removal, settings, and live-page changes in the pull request.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Autopilot is currently an internal CodeRabbit preview.

---

_{Comment @coderabbitai help to get the list of available commands.}