✨ app: add support for multi-chain asset recovery

[dieguezguille]

closes #854 , closes #649, closes #747

Summary by CodeRabbit

• New Features

  • Cross-chain account support, multi-chain balance fetching, and non-collateral/external assets views; recovery flow for assets on unsupported networks; portfolio pending-state UI.

• Bug Fixes

  • Improved error status extraction, USD display for very small balances, swap/transfer validation, provider access behavior, and proposal timing; aligned close buttons.

• Refactors

  • Bridge/source fetching and query exclusion logic simplified.

• Localization

  • Spanish and Portuguese strings added/updated for new UX.

[changeset-bot]

🦋 Changeset detected

Latest commit: 9be0067

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

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

[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

Walkthrough

Adds cross-chain asset discovery and execution, portfolio restructuring, new UI sheets for external/collateral/unsupported networks, cross-chain account client routing, multiple query helpers for deployed/wallet balances, i18n updates, and assorted UI/layout tweaks. Includes many small changesets for patch releases.

Changes

Cohort / File(s)	Summary
Changeset Metadata .changeset/better-feet-arrive.md, .changeset/brisk-otters-sing.md, .changeset/easy-rockets-reply.md, .changeset/fuzzy-icons-push.md, .changeset/open-coats-battle.md, .changeset/smooth-plants-grab.md, .changeset/solid-snails-add.md, .changeset/tough-ducks-end.md, .changeset/wicked-buses-go.md, .changeset/wide-laws-travel.md, .changeset/wild-geckos-remain.md, .changeset/soft-ferrets-tap.md, .changeset/strong-kings-pay.md, .changeset/twelve-points-sniff.md	Added multiple patch-level changeset entries for @exactly/mobile documenting fixes, refactors, and small features.
Bridge & Add-Funds src/components/add-funds/Bridge.tsx	Switched to useLocalSearchParams, introduced sender/transfer/swap/recovery classification, replaced markets with portfolio query helpers, adjusted quote/simulation gating to isTransfer, changed execution branching for cross-chain/native flows, removed shared handleError, and updated UI/deployment gating.
Home: Assets & Sheets src/components/home/Home.tsx, src/components/home/AssetList.tsx, src/components/home/Portfolio.tsx, src/components/home/PortfolioSummary.tsx, src/components/home/CollateralAssetsSheet.tsx, src/components/home/ExternalAssets.tsx, src/components/home/ExternalAssetsSheet.tsx, src/components/home/UnsupportedNetworksSheet.tsx	Refactored portfolio to expose allAssets, added ExternalAssets and sheets (CollateralAssetsSheet, ExternalAssetsSheet, UnsupportedNetworksSheet) for non-collateral/cross-chain UX, added pending skeletons, asset grouping by chain, deployment checks, Intercom recovery flow, and small UI/press adjustments.
Portfolio Hook & LiFi / Balances src/utils/usePortfolio.ts, src/utils/lifi.ts, src/utils/deployedOptions.ts	Split same-chain vs cross-chain balance queries, added walletBalancesOptions and bridgeSourcesOptions, introduced deployedOptions, added OwnerAsset + tokenAmountsToAssets, added protocolSymbols, added allAssets/crossChainAssets and updated USD totals and pending flags.
Account Client & Cross-Chain Routing src/utils/accountClient.ts, src/utils/alchemyChains.ts	Extracted signUserOperationHash, added shared dummySignatureMiddleware, implemented cached getCrossChainClient(targetChainId), adjusted wallet_sendCalls to route UserOperations via cross-chain client with composite ids, and updated wallet_getCallsStatus to decode chain from ids.
Connector & Wagmi Config src/utils/alchemyConnector.ts, src/utils/wagmi/exa.ts	Removed optional chainId param/validation from getProvider(), expanded Wagmi config to include multiple viem chains with per-chain transports, and added alchemyChains map file.
UI Consistency & Small Components src/components/shared/Failure.tsx, src/components/shared/Pending.tsx, src/components/shared/Success.tsx, src/components/send-funds/Amount.tsx, src/components/loans/Review.tsx, src/components/swaps/Failure.tsx, src/components/swaps/Pending.tsx, src/components/swaps/Success.tsx, src/components/shared/AmountSelector.tsx, src/components/shared/AssetSelector.tsx, src/components/home/CollateralAssetsSheet.tsx, src/components/defi/ConnectionSheet.tsx, src/components/defi/IntroSheet.tsx	Applied alignSelf="flex-start" to various close buttons, adjusted flex/shrink behavior in some sheets, changed AmountSelector to store formatted USD string directly, added isSameChainPending gating in AssetSelector, and minor swaps/insufficient-balance logic tweaks.
Error Handling & Query Utilities src/utils/reportError.ts, src/utils/queryClient.ts, src/utils/useSimulateProposal.ts	Refined passkey error classification to use codes and regexes, changed status extraction to traverse error cause chain for numeric codes, consolidated excluded query keys and suppressed messages into Sets, and bumped simulation block override timestamps by +1 unit.
Internationalization src/i18n/es.json, src/i18n/pt.json	Added Spanish and Portuguese strings for collateral vs non-collateral guidance, unsupported-network recovery templates (with placeholders), swap CTA, support contact prompt; renamed "Collateral Assets" → "Collateral assets" and removed "Other Assets".
Config Typing tamagui.config.ts	Added portfolio pseudo-group to Tamagui config and extended type augmentation to include "portfolio" in group names.

Sequence Diagram

sequenceDiagram
    participant User
    participant Bridge as Bridge Component
    participant Portfolio as Portfolio Screen
    participant QueryClient as Query Client
    participant LiFi as LiFi API
    participant Deployed as Deployed Check

    User->>Portfolio: Open portfolio
    Portfolio->>QueryClient: fetch markets, same-chain & wallet balances
    QueryClient->>LiFi: request tokenBalances & walletBalances
    LiFi-->>QueryClient: return balances per chain
    QueryClient->>Deployed: check contract bytecode per chain
    Deployed-->>Portfolio: deployed status
    Portfolio->>User: render collateral + external assets grouped by chain
    User->>Bridge: select external asset -> navigate with sender, sourceChain, sourceToken
    Bridge->>Bridge: classify mode (isTransfer/isSwap/isRecovery)
    alt isTransfer (same-chain)
        Bridge->>Wallet: send native transaction
        Wallet->>Network: broadcast tx
    else cross-chain / recovery
        Bridge->>AccountClient: request cross-chain client for targetChain
        AccountClient->>CrossChainClient: build/sign UserOperation
        CrossChainClient->>Network: submit UserOperation
        Network-->>CrossChainClient: execution/result
        CrossChainClient-->>Bridge: return composite id/result
    end
    Bridge->>User: show success/failure

Loading

sequenceDiagram
    participant User
    participant ExternalAssets as ExternalAssets Component
    participant QueryClient as Query Client
    participant Deployed as Deployed Check
    participant Unsupported as UnsupportedNetworksSheet

    User->>ExternalAssets: Tap non-collateral asset
    ExternalAssets->>QueryClient: ensure deployedOptions(account, chainId) queries
    QueryClient->>Deployed: return deployed/not-deployed
    alt not supported or not deployed
        ExternalAssets->>Unsupported: open UnsupportedNetworksSheet with formatted recovery message
        Unsupported->>User: show contact support flow (Intercom)
    else supported & deployed
        ExternalAssets->>Bridge: navigate to Bridge with asset params
    end

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~75 minutes

🚥 Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main change: adding multi-chain asset recovery support with clear scope and specificity.
Linked Issues check	✅ Passed	The PR implements cross-chain asset recovery by adding external asset display, bridging support, and unsupported network handling as required by #649 and #854.
Out of Scope Changes check	✅ Passed	All changes align with multi-chain recovery objectives: UI for external assets, bridge support, cross-chain queries, error handling, and layout refinements for the new features.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

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

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch recover

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[sentry]

❌ 1 Tests Failed:

Tests completed	Failed	Passed	Skipped
727	1	726	1

View the full list of 1 ❄️ flaky test(s)

local::local

Flake rate in main: 100.00% (Passed 0 times, Failed 1 times)

Stack Traces | 343s run time

No visible element found: "Credit limit"

To view more test analytics, go to the Prevent Tests Dashboard

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 003024cc80

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[devin-ai-integration]

Devin Review found 2 new potential issues.

View 12 additional findings in Devin Review.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d4a5dcfbdd

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0beea35502

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".