wallets: throw error for testnet in prod, auto-convert mainnet in staging

[albertoelias-crossmint]

Description

Upgrades chain environment validation from warning-only to enforcing behavior:

• Testnet in production: Now throws InvalidEnvironmentError instead of logging a warning. This is a breaking change for any consumers currently passing testnet chains with production API keys.
• Mainnet in non-production (staging/dev): Automatically converts to the testnet equivalent using a new MAINNET_TO_TESTNET_MAP (15 chains mapped). Logs a warning about the conversion. If no testnet mapping exists, falls back to a warning without conversion.

validateChainEnvironment now returns the (potentially converted) chain, and all three callers (getOrCreateWallet, getWallet, createWallet) apply the returned value.

Things for reviewer to verify

• Type cast: return testnetEquivalent as unknown as C — the generic C will still reflect the original mainnet type at the call site even though the runtime value is now a testnet chain. Confirm this doesn't cause issues downstream.
• Map completeness: 15 mainnet→testnet mappings are included. Verify no expected AA chains are missing (e.g., ethereum is absent — confirm it's not in PRODUCTION_AA_CHAINS).

Test plan

• Unit tests updated: testnet-in-prod tests now expect InvalidEnvironmentError thrown; mainnet-in-staging/dev tests expect auto-conversion with warning log; new test for mainnet with no testnet equivalent (arbitrumnova)
• All 33 wallet-factory tests pass
• Lint passes (biome check)

Package updates

Changeset still needs to be added via pnpm change:add.

---

Link to Devin run | Requested by @albertoelias-crossmint

---

[devin-ai-integration]

Original prompt from Alberto Elias

in these 2 prs:

https://github.com/Crossmint/crossmint-sdk/pull/1565/changes#diff-cc1f073b7b2d8ca4905b2faca08758f53d88122ef1b721dae9c6098cf852b9d1

https://github.com/Paella-Labs/crossbit-main/pull/23183/changes

i added some logs when developers use the wrong chain for that environment. I now want to make a pr that:

- when using a testnet in production, it throws an error
- when using a mainnet in staging, it automatically converts it to the mainnet equivalent

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR that start with 'DevinAI' or '@devin'.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring

[changeset-bot]

🦋 Changeset detected

Latest commit: 35985ba

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

This PR includes changesets to release 9 packages

Name	Type
@crossmint/wallets-sdk	Minor
expo-demo	Patch
@crossmint/client-sdk-react-base	Patch
@crossmint/client-sdk-react-native-ui	Patch
@crossmint/client-sdk-react-ui	Patch
@crossmint/auth-ssr-nextjs-demo	Patch
@crossmint/client-sdk-nextjs-starter	Patch
@crossmint/wallets-quickstart-devkit	Patch
@crossmint/client-sdk-smart-wallet-next-starter	Patch

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

[greptile-apps]

_{3 files reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 5 additional findings.

[greptile-apps]

_{4 files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}

[github-actions]

🔥 Smoke Test Results

✅ Status: Passed

Statistics

• Total Tests: 5
• Passed: 5 ✅
• Failed: 0
• Skipped: 0
• Duration: 4.68 min

✅ All smoke tests passed!

All critical flows are working correctly.

---

This is a non-blocking smoke test. Full regression tests run separately.

[greptile-apps]

_{4 files reviewed, 2 comments}

_{Edit Code Review Agent Settings | Greptile}

[greptile-apps]

Additional Comments (1)

packages/wallets/src/wallets/wallet-factory.test.ts
tests spy on warn but implementation uses debug on lines 419 and 427 of wallet-factory.ts

        warnSpy = vi.spyOn(walletsLogger, "debug");

Prompt To Fix With AI

This is a comment left during a code review.
Path: packages/wallets/src/wallets/wallet-factory.test.ts
Line: 656

Comment:
tests spy on `warn` but implementation uses `debug` on lines 419 and 427 of wallet-factory.ts

```suggestion
        warnSpy = vi.spyOn(walletsLogger, "debug");
```

How can I resolve this? If you propose a fix, please make it concise.

[greptile-apps]

_{4 files reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}

[devin-ai-integration]

Devin Review found 1 new potential issue.

View 8 additional findings in Devin Review.

[greptile-apps]

_{5 files reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}