feat(passport): v3

[shineli1984]

Summary

next version of Immutable Passport SDK.
Tasks (all tasks below must keep Passport SDK and Passport sample app working)
Stage 1

• split Passport SDK to wallet and auth packages and make Passport SDK refer to them internally.
• release an alpha version of the above
• make Play use the above version
  Stage 2
• remove the concept of environment from wallet and auth packages.
• create new usage pattern for wallet and auth packages (see below)
• Add default Auth implementation
  • Make UI nice for default auth login workflow
• release 2.x wallet and auth packages
  Stage 3 - not this PR
• make Play use the wallet and auth packages
  Stage 4 - not this PR
• wallet linking
• documentation for wallet and auth interface
• Refactor the internal of wallet and auth packages to make the code more robust

new wallet and auth interface

For apps that only need wallet functionality:

// Old: Required OAuth client setup
import { Auth } from '@imtbl/auth';
import { connectWallet } from '@imtbl/wallet';

const auth = new Auth({ clientId: '...', redirectUri: '...' });
const provider = await connectWallet({ auth });

// New: Wallet-only mode (no OAuth client needed)
import { connectWallet } from '@imtbl/wallet';

const provider = await connectWallet();
// SDK automatically handles authentication with a shared client owned by Immutable

For apps that need user profile access:

// Still works: Provide your own auth client
import { Auth } from '@imtbl/auth';
import { connectWallet } from '@imtbl/wallet';

const auth = new Auth({ 
  clientId: 'your-client-id', 
  redirectUri: 'https://your-app.com/callback',
  scope: 'openid profile email transact', // Full access
});
const provider = await connectWallet({ auth });

---

Note

Splits Passport into new @imtbl/auth and @imtbl/wallet packages, introduces connectWallet API and refactors Passport/SDK and sample app to use them while removing environment-centric configs.

• Architecture:
  • Introduces new packages @imtbl/auth and @imtbl/wallet; Passport now composes these internally.
  • Removes legacy auth manager and environment-centric configuration; adds chain-based configs and presets.
• Wallet:
  • Adds connectWallet with optional default Auth; supports multi-chain ChainConfig, EIP-6963 announcement, session activity updates.
  • Implements GuardianClient, RelayerClient refinements, overlay UI components, and wallet linking helpers (linkExternalWallet, getLinkedAddresses).
• Auth:
  • Provides standalone Auth (OIDC, metrics wrappers, configuration/typing, error handling); exports events/utilities.
• Passport:
  • Refactors to consume @imtbl/auth/@imtbl/wallet, simplifies APIs, re-exports types/errors; IMX workflows moved to ImxGuardianClient.
• SDK/Exports:
  • SDK now exports @imtbl/auth and @imtbl/wallet; updates exports and re-exports across packages.
• Sample App:
  • Updates to use new wallet provider shape (activeZkEvmProvider, connect with defaults), UI tweaks, and event wiring.
• Tooling/Configs:
  • Adds ESLint/Jest/TS configs for new packages; updates deps (uuid, @types/jest, tsup), bumps Husky NODE_OPTIONS.

^{Written by Cursor Bugbot for commit 583b130. This will update automatically on new commits. Configure here.}

[cursor]

This PR is being reviewed by Cursor Bugbot

Details

Your team is on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle for each member of your team.

To receive Bugbot reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 583b130

Command	Status	Duration	Result
nx run-many -p @imtbl/sdk,@imtbl/checkout-widge...	✅ Succeeded	4s	View ↗

---

☁️ Nx Cloud last updated this comment at 2025-12-03 06:18:31 UTC

[haydenfowler]

We need this to track users across the embedded login prompt & the Auth0 login flow, don't we?

[nattb8]

All tests removed. Are they going to be rewritten?

[shineli1984]

added tests