@imtbl/wallet 2.12.7-alpha.1 → 2.12.7-alpha.10

package/src/types.ts

@@ -2,11 +2,6 @@ import { Flow } from '@imtbl/metrics';
 import { TypedEventEmitter, User } from '@imtbl/auth';
 import { JsonRpcError } from './zkEvm/JsonRpcError';
 
-export enum EvmChain {
-  ZKEVM = 'zkevm',
-  ARBITRUM_ONE = 'arbitrum_one',
-}
-
 /**
  * A viem-compatible signer interface for wallet operations.
  * This replaces ethers' AbstractSigner/Signer.
@@ -206,17 +201,6 @@ export interface ChainConfig {
    * Defaults to 'https://tee.express.magiclabs.com'
    */
   magicTeeBasePath?: string;
-
-  /** Preferred token symbol for relayer fees (default: 'IMX') */
-  feeTokenSymbol?: string;
-
-  /** Sequence RPC node URL TODO: check if this can be removed and only use rpcUrl */
-  nodeUrl?: string;
-
-  /**
-   * Sequence Identity Instrument endpoint (for non-zkEVM chains in prod/sandbox)
-   */
-  sequenceIdentityInstrumentEndpoint?: string;
 }
 
 /**

package/src/zkEvm/types.ts

@@ -1,5 +1,4 @@
 import { JsonRpcError } from './JsonRpcError';
-import type { Provider as ProviderType } from '../types';
 
 export enum RelayerTransactionStatus {
   PENDING = 'PENDING',
@@ -92,9 +91,16 @@ export interface JsonRpcResponsePayload {
   id?: string | number;
 }
 
-export type { Provider } from '../types';
-
-type Provider = ProviderType;
+/**
+ * EIP-1193 Provider Interface
+ * Standard Ethereum provider interface
+ */
+export type Provider = {
+  request: (request: RequestArguments) => Promise<any>;
+  on: (event: string, listener: (...args: any[]) => void) => void;
+  removeListener: (event: string, listener: (...args: any[]) => void) => void;
+  isPassport: boolean;
+};
 
 export enum ProviderEvent {
   ACCOUNTS_CHANGED = 'accountsChanged',

package/dist/types/network/chainRegistry.d.ts

@@ -1,13 +0,0 @@
-import { Environment } from '@imtbl/config';
-import { ChainConfig, EvmChain } from '../types';
-/**
- * Get chain config for non-zkEVM chains
- * @throws Error if chain is not in registry
- */
-export declare function getChainConfig(chain: Exclude<EvmChain, EvmChain.ZKEVM>, environment: Environment): ChainConfig;
-/**
- * Get EvmChain from chainId
- * @param chainId - Chain ID (can be number or string like "eip155:42161")
- * @returns EvmChain enum value, defaults to ZKEVM if not found
- */
-export declare function getEvmChainFromChainId(chainId: string | number): EvmChain;

package/dist/types/sequence/sequenceProvider.d.ts

@@ -1,21 +0,0 @@
-import { MultiRollupApiClients } from '@imtbl/generated-clients';
-import { TypedEventEmitter } from '@imtbl/auth';
-import { Provider, ProviderEventMap, RequestArguments, ChainConfig, GetUserFunction } from '../types';
-import GuardianClient from '../guardian';
-import { SequenceSigner } from './signer';
-export type SequenceProviderInput = {
-    getUser: GetUserFunction;
-    chainConfig: ChainConfig;
-    multiRollupApiClients: MultiRollupApiClients;
-    guardianClient: GuardianClient;
-    ethSigner: SequenceSigner;
-    passportEventEmitter: TypedEventEmitter<ProviderEventMap>;
-};
-export declare class SequenceProvider implements Provider {
-    #private;
-    readonly isPassport: boolean;
-    constructor({ getUser, chainConfig, multiRollupApiClients, guardianClient, ethSigner, passportEventEmitter, }: SequenceProviderInput);
-    request(request: RequestArguments): Promise<any>;
-    on(event: string, listener: (...args: any[]) => void): void;
-    removeListener(event: string, listener: (...args: any[]) => void): void;
-}

package/dist/types/sequence/signer/identityInstrumentSigner.d.ts

@@ -1,15 +0,0 @@
-import { Address } from 'ox';
-import { Payload, Signature as SequenceSignature } from '@0xsequence/wallet-primitives';
-import { SequenceSigner } from './types';
-import { GetUserFunction } from '../../types';
-export interface IdentityInstrumentSignerConfig {
-    /** Sequence Identity Instrument endpoint URL */
-    identityInstrumentEndpoint: string;
-}
-export declare class IdentityInstrumentSigner implements SequenceSigner {
-    #private;
-    constructor(getUser: GetUserFunction, config: IdentityInstrumentSignerConfig);
-    getAddress(): Promise<string>;
-    signPayload(walletAddress: Address.Address, chainId: number, payload: Payload.Parented): Promise<SequenceSignature.SignatureOfSignerLeaf>;
-    signMessage(message: string | Uint8Array): Promise<string>;
-}

package/dist/types/sequence/signer/index.d.ts

@@ -1,21 +0,0 @@
-import { SequenceSigner } from './types';
-import { GetUserFunction } from '../../types';
-export type { SequenceSigner } from './types';
-export { IdentityInstrumentSigner } from './identityInstrumentSigner';
-export type { IdentityInstrumentSignerConfig } from './identityInstrumentSigner';
-export { PrivateKeySigner } from './privateKeySigner';
-export interface CreateSequenceSignerConfig {
-    /** Identity Instrument endpoint (required for prod/sandbox) */
-    identityInstrumentEndpoint?: string;
-    /** Whether this is a dev environment (uses PrivateKeySigner instead of IdentityInstrumentSigner) */
-    isDevEnvironment?: boolean;
-}
-/**
- * Create the appropriate signer based on environment.
- * - Dev environment (behind VPN): uses PrivateKeySigner
- * - Prod/Sandbox: uses IdentityInstrumentSigner
- *
- * @param getUser - Function to get the current user
- * @param config - Signer configuration
- */
-export declare function createSequenceSigner(getUser: GetUserFunction, config?: CreateSequenceSignerConfig): SequenceSigner;

package/dist/types/sequence/signer/privateKeySigner.d.ts

@@ -1,15 +0,0 @@
-import { Payload, Signature as SequenceSignature } from '@0xsequence/wallet-primitives';
-import { SequenceSigner } from './types';
-import { Address } from 'ox';
-import { GetUserFunction } from '../../types';
-/**
- * Private key signer for dev environments (behind VPN).
- * Uses a deterministic private key derived from the user's sub.
- */
-export declare class PrivateKeySigner implements SequenceSigner {
-    #private;
-    constructor(getUser: GetUserFunction);
-    getAddress(): Promise<string>;
-    signPayload(walletAddress: Address.Address, chainId: number, payload: Payload.Parented): Promise<SequenceSignature.SignatureOfSignerLeaf>;
-    signMessage(message: string | Uint8Array): Promise<string>;
-}

package/dist/types/sequence/signer/types.d.ts

@@ -1,14 +0,0 @@
-import { Address } from 'ox';
-import { Payload, Signature as SequenceSignature } from '@0xsequence/wallet-primitives';
-/**
- * Signer interface for Sequence wallet operations.
- * Used by non-zkEVM chains (e.g., Arbitrum).
- */
-export interface SequenceSigner {
-    /** Get the signer's address */
-    getAddress(): Promise<string>;
-    /** Sign a Sequence payload (for transactions) */
-    signPayload(walletAddress: Address.Address, chainId: number, payload: Payload.Parented): Promise<SequenceSignature.SignatureOfSignerLeaf>;
-    /** Sign a message (EIP-191 personal_sign) */
-    signMessage(message: string | Uint8Array): Promise<string>;
-}

package/dist/types/sequence/user/index.d.ts

@@ -1,2 +0,0 @@
-export { registerUser } from './registerUser';
-export type { RegisterUserInput } from './registerUser';

package/dist/types/sequence/user/registerUser.d.ts

@@ -1,18 +0,0 @@
-import { MultiRollupApiClients } from '@imtbl/generated-clients';
-import { Flow } from '@imtbl/metrics';
-import type { PublicClient } from 'viem';
-import { SequenceSigner } from '../signer';
-import { GetUserFunction } from '../../types';
-export type RegisterUserInput = {
-    getUser: GetUserFunction;
-    ethSigner: SequenceSigner;
-    multiRollupApiClients: MultiRollupApiClients;
-    accessToken: string;
-    rpcProvider: PublicClient;
-    flow: Flow;
-};
-/**
- * Register a user for a non-zkEVM chain (e.g., Arbitrum).
- * Creates a counterfactual address for the user on the specified chain.
- */
-export declare function registerUser({ getUser, ethSigner, multiRollupApiClients, accessToken, rpcProvider, flow, }: RegisterUserInput): Promise<string>;

package/src/network/chainRegistry.test.ts

@@ -1,64 +0,0 @@
-import { Environment } from '@imtbl/config';
-import { getChainConfig, getEvmChainFromChainId } from './chainRegistry';
-import { EvmChain } from '../types';
-import { ARBITRUM_ONE_CHAIN, ETHEREUM_SEPOLIA_CHAIN } from './presets';
-
-describe('chainRegistry', () => {
-  describe('getChainConfig', () => {
-    it('returns Arbitrum One mainnet config for PRODUCTION', () => {
-      const config = getChainConfig(EvmChain.ARBITRUM_ONE, Environment.PRODUCTION);
-
-      expect(config).toEqual(ARBITRUM_ONE_CHAIN);
-      expect(config.chainId).toBe(42161);
-      expect(config.name).toBe('Arbitrum One');
-    });
-
-    it('returns Ethereum Sepolia config for SANDBOX', () => {
-      const config = getChainConfig(EvmChain.ARBITRUM_ONE, Environment.SANDBOX);
-
-      expect(config).toEqual(ETHEREUM_SEPOLIA_CHAIN);
-      expect(config.chainId).toBe(11155111);
-      expect(config.name).toBe('Ethereum Sepolia');
-    });
-
-    it('throws error for unsupported chain', () => {
-      expect(() => {
-        getChainConfig('unsupported_chain' as any, Environment.PRODUCTION);
-      }).toThrow('Chain unsupported_chain is not supported');
-    });
-  });
-
-  describe('getEvmChainFromChainId', () => {
-    it('returns ZKEVM for mainnet chainId', () => {
-      expect(getEvmChainFromChainId(13371)).toBe(EvmChain.ZKEVM);
-    });
-
-    it('returns ZKEVM for testnet chainId', () => {
-      expect(getEvmChainFromChainId(13473)).toBe(EvmChain.ZKEVM);
-    });
-
-    it('returns ZKEVM for devnet chainId', () => {
-      expect(getEvmChainFromChainId(15003)).toBe(EvmChain.ZKEVM);
-    });
-
-    it('returns ARBITRUM_ONE for Arbitrum mainnet chainId', () => {
-      expect(getEvmChainFromChainId(42161)).toBe(EvmChain.ARBITRUM_ONE);
-    });
-
-    it('returns ARBITRUM_ONE for Ethereum Sepolia chainId', () => {
-      expect(getEvmChainFromChainId(11155111)).toBe(EvmChain.ARBITRUM_ONE);
-    });
-
-    it('handles string chainId', () => {
-      expect(getEvmChainFromChainId('42161')).toBe(EvmChain.ARBITRUM_ONE);
-    });
-
-    it('handles eip155 format chainId', () => {
-      expect(getEvmChainFromChainId('eip155:42161')).toBe(EvmChain.ARBITRUM_ONE);
-    });
-
-    it('defaults to ZKEVM for unknown chainId', () => {
-      expect(getEvmChainFromChainId(99999)).toBe(EvmChain.ZKEVM);
-    });
-  });
-});

package/src/network/chainRegistry.ts

@@ -1,74 +0,0 @@
-import { Environment } from '@imtbl/config';
-import { ChainConfig, EvmChain } from '../types';
-import {
-  IMMUTABLE_ZKEVM_MAINNET_CHAIN,
-  IMMUTABLE_ZKEVM_TESTNET_CHAIN,
-  ARBITRUM_ONE_CHAIN,
-  ETHEREUM_SEPOLIA_CHAIN,
-} from './presets';
-import { ChainId } from './chains';
-
-/**
- * Registry mapping (EvmChain, Environment) to ChainConfig
- */
-const CHAIN_REGISTRY: Record<EvmChain, Record<Environment, ChainConfig>> = {
-  [EvmChain.ZKEVM]: {
-    [Environment.PRODUCTION]: IMMUTABLE_ZKEVM_MAINNET_CHAIN,
-    [Environment.SANDBOX]: IMMUTABLE_ZKEVM_TESTNET_CHAIN,
-  },
-  [EvmChain.ARBITRUM_ONE]: {
-    [Environment.PRODUCTION]: ARBITRUM_ONE_CHAIN,
-    [Environment.SANDBOX]: ETHEREUM_SEPOLIA_CHAIN,
-  },
-};
-
-/**
- * Build chainId → EvmChain mapping from CHAIN_REGISTRY (derived, not manual)
- */
-function buildChainIdToEvmChainMap(): Record<number, EvmChain> {
-  const map: Record<number, EvmChain> = {};
-  for (const [evmChain, envConfigs] of Object.entries(CHAIN_REGISTRY)) {
-    for (const config of Object.values(envConfigs)) {
-      map[config.chainId] = evmChain as EvmChain;
-    }
-  }
-  // Devnet doesn't have a preset
-  map[ChainId.IMTBL_ZKEVM_DEVNET] = EvmChain.ZKEVM;
-  return map;
-}
-
-const CHAIN_ID_TO_EVM_CHAIN = buildChainIdToEvmChainMap();
-
-/**
- * Get chain config for non-zkEVM chains
- * @throws Error if chain is not in registry
- */
-export function getChainConfig(
-  chain: Exclude<EvmChain, EvmChain.ZKEVM>,
-  environment: Environment,
-): ChainConfig {
-  const envConfigs = CHAIN_REGISTRY[chain];
-  if (!envConfigs) {
-    throw new Error(`Chain ${chain} is not supported`);
-  }
-
-  const config = envConfigs[environment];
-  if (!config) {
-    throw new Error(`Chain ${chain} is not configured for environment ${environment}`);
-  }
-
-  return config;
-}
-
-/**
- * Get EvmChain from chainId
- * @param chainId - Chain ID (can be number or string like "eip155:42161")
- * @returns EvmChain enum value, defaults to ZKEVM if not found
- */
-export function getEvmChainFromChainId(chainId: string | number): EvmChain {
-  const numericChainId = typeof chainId === 'string'
-    ? parseInt(chainId.includes(':') ? chainId.split(':')[1] : chainId, 10)
-    : chainId;
-
-  return CHAIN_ID_TO_EVM_CHAIN[numericChainId] ?? EvmChain.ZKEVM;
-}

package/src/network/presets.ts

@@ -1,185 +0,0 @@
-import { ChainConfig } from '../types';
-import {
-  IMMUTABLE_ZKEVM_MAINNET_CHAIN_ID,
-  IMMUTABLE_ZKEVM_TESTNET_CHAIN_ID,
-  ARBITRUM_ONE_CHAIN_ID,
-  ARBITRUM_SEPOLIA_CHAIN_ID,
-  ETHEREUM_SEPOLIA_CHAIN_ID,
-  MAGIC_CONFIG,
-} from '../constants';
-
-/**
- * Immutable zkEVM Mainnet chain configuration
- */
-export const IMMUTABLE_ZKEVM_MAINNET_CHAIN: ChainConfig = {
-  chainId: IMMUTABLE_ZKEVM_MAINNET_CHAIN_ID,
-  name: 'Immutable zkEVM',
-  rpcUrl: 'https://rpc.immutable.com',
-  relayerUrl: 'https://api.immutable.com/relayer-mr',
-  apiUrl: 'https://api.immutable.com',
-  passportDomain: 'https://passport.immutable.com',
-  magicPublishableApiKey: MAGIC_CONFIG[IMMUTABLE_ZKEVM_MAINNET_CHAIN_ID].magicPublishableApiKey,
-  magicProviderId: MAGIC_CONFIG[IMMUTABLE_ZKEVM_MAINNET_CHAIN_ID].magicProviderId,
-  magicTeeBasePath: 'https://tee.express.magiclabs.com',
-};
-
-/**
- * Immutable zkEVM Testnet chain configuration
- */
-export const IMMUTABLE_ZKEVM_TESTNET_CHAIN: ChainConfig = {
-  chainId: IMMUTABLE_ZKEVM_TESTNET_CHAIN_ID,
-  name: 'Immutable zkEVM Testnet',
-  rpcUrl: 'https://rpc.testnet.immutable.com',
-  relayerUrl: 'https://api.sandbox.immutable.com/relayer-mr',
-  apiUrl: 'https://api.sandbox.immutable.com',
-  passportDomain: 'https://passport.sandbox.immutable.com',
-  magicPublishableApiKey: MAGIC_CONFIG[IMMUTABLE_ZKEVM_TESTNET_CHAIN_ID].magicPublishableApiKey,
-  magicProviderId: MAGIC_CONFIG[IMMUTABLE_ZKEVM_TESTNET_CHAIN_ID].magicProviderId,
-  magicTeeBasePath: 'https://tee.express.magiclabs.com',
-};
-
-/**
- * Arbitrum One Mainnet chain configuration
- */
-export const ARBITRUM_ONE_CHAIN: ChainConfig = {
-  chainId: ARBITRUM_ONE_CHAIN_ID,
-  name: 'Arbitrum One',
-  rpcUrl: 'https://arb1.arbitrum.io/rpc',
-  relayerUrl: 'https://next-arbitrum-one-relayer.sequence.app',
-  nodeUrl: 'https://next-nodes.sequence.app/arbitrum-one',
-  apiUrl: 'https://api.immutable.com',
-  passportDomain: 'https://passport.immutable.com',
-  feeTokenSymbol: 'ETH',
-  sequenceIdentityInstrumentEndpoint: 'https://next-identity.sequence.app',
-};
-
-/**
- * Arbitrum Sepolia Testnet chain configuration
- */
-export const ARBITRUM_SEPOLIA_CHAIN: ChainConfig = {
-  chainId: ARBITRUM_SEPOLIA_CHAIN_ID,
-  name: 'Arbitrum Sepolia',
-  rpcUrl: 'https://sepolia-rollup.arbitrum.io/rpc',
-  relayerUrl: 'https://next-arbitrum-sepolia-relayer.sequence.app',
-  nodeUrl: 'https://next-nodes.sequence.app/arbitrum-sepolia',
-  apiUrl: 'https://api.sandbox.immutable.com',
-  passportDomain: 'https://passport.sandbox.immutable.com',
-  feeTokenSymbol: 'ETH',
-  sequenceIdentityInstrumentEndpoint: 'https://next-identity.sequence-dev.app',
-};
-
-/**
- * Ethereum Sepolia Testnet chain configuration
- */
-export const ETHEREUM_SEPOLIA_CHAIN: ChainConfig = {
-  chainId: ETHEREUM_SEPOLIA_CHAIN_ID,
-  name: 'Ethereum Sepolia',
-  rpcUrl: 'https://rpc.sepolia.org',
-  relayerUrl: 'https://next-sepolia-relayer.sequence.app',
-  nodeUrl: 'https://next-nodes.sequence.app/sepolia',
-  apiUrl: 'https://api.sandbox.immutable.com',
-  passportDomain: 'https://passport.sandbox.immutable.com',
-  feeTokenSymbol: 'ETH',
-  sequenceIdentityInstrumentEndpoint: 'https://next-identity.sequence-dev.app',
-};
-
-/**
- * Default chains (testnet + mainnet)
- * Testnet is first (default initial chain)
- */
-export const DEFAULT_CHAINS: ChainConfig[] = [
-  IMMUTABLE_ZKEVM_TESTNET_CHAIN,
-  IMMUTABLE_ZKEVM_MAINNET_CHAIN,
-];
-
-/**
- * Mainnet only preset
- *
- * @example
- * ```typescript
- * const provider = await connectWallet({
- *   ...IMMUTABLE_ZKEVM_MAINNET,
- *   auth,
- * });
- * ```
- */
-export const IMMUTABLE_ZKEVM_MAINNET = {
-  chains: [IMMUTABLE_ZKEVM_MAINNET_CHAIN],
-};
-
-/**
- * Testnet only preset
- *
- * @example
- * ```typescript
- * const provider = await connectWallet({
- *   ...IMMUTABLE_ZKEVM_TESTNET,
- *   auth,
- * });
- * ```
- */
-export const IMMUTABLE_ZKEVM_TESTNET = {
-  chains: [IMMUTABLE_ZKEVM_TESTNET_CHAIN],
-};
-
-/**
- * Multi-chain preset (testnet + mainnet)
- * Defaults to testnet as initial chain
- *
- * @example
- * ```typescript
- * const provider = await connectWallet({
- *   ...IMMUTABLE_ZKEVM_MULTICHAIN,
- *   auth,
- *   initialChainId: IMMUTABLE_ZKEVM_MAINNET_CHAIN_ID, // Optional: start on mainnet
- * });
- * ```
- */
-export const IMMUTABLE_ZKEVM_MULTICHAIN = {
-  chains: DEFAULT_CHAINS,
-};
-
-/**
- * Arbitrum mainnet only preset
- *
- * @example
- * ```typescript
- * const provider = await connectWallet({
- *   ...ARBITRUM_ONE_MAINNET,
- *   auth,
- * });
- * ```
- */
-export const ARBITRUM_ONE = {
-  chains: [ARBITRUM_ONE_CHAIN],
-};
-
-/**
- * Arbitrum testnet only preset
- *
- * @example
- * ```typescript
- * const provider = await connectWallet({
- *   ...ARBITRUM_SEPOLIA,
- *   auth,
- * });
- * ```
- */
-export const ARBITRUM_SEPOLIA = {
-  chains: [ARBITRUM_SEPOLIA_CHAIN],
-};
-
-/**
- * Ethereum Sepolia testnet only preset
- *
- * @example
- * ```typescript
- * const provider = await connectWallet({
- *   ...ETHEREUM_SEPOLIA,
- *   auth,
- * });
- * ```
- */
-export const ETHEREUM_SEPOLIA = {
-  chains: [ETHEREUM_SEPOLIA_CHAIN],
-};