@0xsequence/dapp-client 0.0.0-20250910142613

package/dist/types/index.d.ts

@@ -0,0 +1,168 @@
+import { Attestation, Payload } from '@0xsequence/wallet-primitives';
+import { Signers } from '@0xsequence/wallet-core';
+import { Address, Hex } from 'ox';
+import type { TypedData } from 'ox/TypedData';
+export declare const RequestActionType: {
+    readonly CREATE_NEW_SESSION: "createNewSession";
+    readonly ADD_EXPLICIT_SESSION: "addExplicitSession";
+    readonly MODIFY_EXPLICIT_SESSION: "modifyExplicitSession";
+    readonly SIGN_MESSAGE: "signMessage";
+    readonly SIGN_TYPED_DATA: "signTypedData";
+    readonly SEND_WALLET_TRANSACTION: "sendWalletTransaction";
+};
+export type LoginMethod = 'google' | 'apple' | 'email' | 'passkey' | 'mnemonic';
+export interface GuardConfig {
+    url: string;
+    address: Address.Address;
+}
+export interface CreateNewSessionPayload {
+    sessionAddress: Address.Address;
+    origin: string;
+    permissions?: Signers.Session.ExplicitParams;
+    includeImplicitSession?: boolean;
+    preferredLoginMethod?: LoginMethod;
+    email?: string;
+}
+export interface AddExplicitSessionPayload {
+    sessionAddress: Address.Address;
+    permissions: Signers.Session.ExplicitParams;
+    preferredLoginMethod?: LoginMethod;
+    email?: string;
+}
+export interface ModifySessionPayload {
+    walletAddress: Address.Address;
+    sessionAddress: Address.Address;
+    permissions: Signers.Session.ExplicitParams;
+}
+export interface SignMessagePayload {
+    address: Address.Address;
+    message: string;
+    chainId: number;
+}
+export interface SignTypedDataPayload {
+    address: Address.Address;
+    typedData: TypedData;
+    chainId: number;
+}
+export type TransactionRequest = {
+    to: Address.Address;
+    value?: bigint;
+    data?: Hex.Hex;
+    gasLimit?: bigint;
+};
+export interface SendWalletTransactionPayload {
+    address: Address.Address;
+    transactionRequest: TransactionRequest;
+    chainId: number;
+}
+export interface ConnectSuccessResponsePayload {
+    walletAddress: string;
+    attestation?: Attestation.Attestation;
+    signature?: Hex.Hex;
+    userEmail?: string;
+    loginMethod?: LoginMethod;
+    guard?: GuardConfig;
+}
+export interface ModifySessionSuccessResponsePayload {
+    walletAddress: string;
+    sessionAddress: string;
+}
+export interface SignatureSuccessResponse {
+    signature: Hex.Hex;
+    walletAddress: string;
+}
+export interface SendWalletTransactionSuccessResponse {
+    transactionHash: Hex.Hex;
+    walletAddress: string;
+}
+export type WalletActionResponse = SignatureSuccessResponse | SendWalletTransactionSuccessResponse;
+export interface ExplicitSessionResponsePayload {
+    walletAddress: string;
+    sessionAddress: string;
+}
+export type RandomPrivateKeyFn = () => Hex.Hex | Promise<Hex.Hex>;
+type RequiredKeys = 'to' | 'data' | 'value';
+export type Transaction = Pick<Payload.Call, RequiredKeys> & Partial<Omit<Payload.Call, RequiredKeys>>;
+export type Session = {
+    address: Address.Address;
+    isImplicit: boolean;
+    permissions?: Signers.Session.ExplicitParams;
+    chainId?: number;
+};
+export type ChainSessionManagerEvent = 'sessionsUpdated' | 'explicitSessionResponse';
+export type ExplicitSessionEventListener = (data: {
+    action: (typeof RequestActionType)['ADD_EXPLICIT_SESSION' | 'MODIFY_EXPLICIT_SESSION'];
+    response?: ExplicitSessionResponsePayload;
+    error?: any;
+}) => void;
+export type DappClientEventListener = (data?: any) => void;
+export type DappClientWalletActionEventListener = (data: {
+    action: (typeof RequestActionType)['SIGN_MESSAGE' | 'SIGN_TYPED_DATA' | 'SEND_WALLET_TRANSACTION'];
+    response?: WalletActionResponse;
+    error?: any;
+    chainId: number;
+}) => void;
+export type DappClientExplicitSessionEventListener = (data: {
+    action: (typeof RequestActionType)['ADD_EXPLICIT_SESSION' | 'MODIFY_EXPLICIT_SESSION'];
+    response?: ExplicitSessionResponsePayload;
+    error?: any;
+    chainId: number;
+}) => void;
+export interface SequenceSessionStorage {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+    removeItem(key: string): void | Promise<void>;
+}
+export declare enum MessageType {
+    WALLET_OPENED = "WALLET_OPENED",
+    INIT = "INIT",
+    REQUEST = "REQUEST",
+    RESPONSE = "RESPONSE"
+}
+export declare enum TransportMode {
+    POPUP = "popup",
+    REDIRECT = "redirect"
+}
+export interface PopupModeOptions {
+    requestTimeoutMs?: number;
+    handshakeTimeoutMs?: number;
+}
+export interface TransportMessage<T = any> {
+    id: string;
+    type: MessageType;
+    sessionId?: string;
+    action?: string;
+    payload?: T;
+    error?: any;
+}
+export interface BaseRequest {
+    type: string;
+}
+export interface MessageSignatureRequest extends BaseRequest {
+    type: 'message_signature';
+    message: string;
+    address: Address.Address;
+    chainId: number;
+}
+export interface TypedDataSignatureRequest extends BaseRequest {
+    type: 'typed_data_signature';
+    typedData: unknown;
+    address: Address.Address;
+    chainId: number;
+}
+export declare const WalletSize: {
+    width: number;
+    height: number;
+};
+export interface PendingRequest {
+    resolve: (payload: any) => void;
+    reject: (error: any) => void;
+    timer: number;
+    action: string;
+}
+export interface SendRequestOptions {
+    timeout?: number;
+    path?: string;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/types/index.js

@@ -0,0 +1,25 @@
+// --- Public Interfaces and Constants ---
+export const RequestActionType = {
+    CREATE_NEW_SESSION: 'createNewSession',
+    ADD_EXPLICIT_SESSION: 'addExplicitSession',
+    MODIFY_EXPLICIT_SESSION: 'modifyExplicitSession',
+    SIGN_MESSAGE: 'signMessage',
+    SIGN_TYPED_DATA: 'signTypedData',
+    SEND_WALLET_TRANSACTION: 'sendWalletTransaction',
+};
+export var MessageType;
+(function (MessageType) {
+    MessageType["WALLET_OPENED"] = "WALLET_OPENED";
+    MessageType["INIT"] = "INIT";
+    MessageType["REQUEST"] = "REQUEST";
+    MessageType["RESPONSE"] = "RESPONSE";
+})(MessageType || (MessageType = {}));
+export var TransportMode;
+(function (TransportMode) {
+    TransportMode["POPUP"] = "popup";
+    TransportMode["REDIRECT"] = "redirect";
+})(TransportMode || (TransportMode = {}));
+export const WalletSize = {
+    width: 380,
+    height: 600,
+};

package/dist/utils/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const CACHE_DB_NAME = "sequence-cache";
+export declare const NODES_URL = "https://nodes.sequence.app/{network}";
+export declare const RELAYER_URL = "https://dev-{network}-relayer.sequence.app";
+export declare const KEYMACHINE_URL = "https://v3-keymachine.sequence-dev.app";
+export declare const VALUE_FORWARDER_ADDRESS = "0xABAAd93EeE2a569cF0632f39B10A9f5D734777ca";
+//# sourceMappingURL=constants.d.ts.map

package/dist/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,mBAAmB,CAAA;AAC7C,eAAO,MAAM,SAAS,yCAAyC,CAAA;AAC/D,eAAO,MAAM,WAAW,+CAA+C,CAAA;AACvE,eAAO,MAAM,cAAc,2CAA2C,CAAA;AACtE,eAAO,MAAM,uBAAuB,+CAA+C,CAAA"}

package/dist/utils/constants.js

@@ -0,0 +1,5 @@
+export const CACHE_DB_NAME = 'sequence-cache';
+export const NODES_URL = 'https://nodes.sequence.app/{network}';
+export const RELAYER_URL = 'https://dev-{network}-relayer.sequence.app';
+export const KEYMACHINE_URL = 'https://v3-keymachine.sequence-dev.app';
+export const VALUE_FORWARDER_ADDRESS = '0xABAAd93EeE2a569cF0632f39B10A9f5D734777ca';

package/dist/utils/errors.d.ts

@@ -0,0 +1,28 @@
+export declare class InitializationError extends Error {
+    constructor(message: string);
+}
+export declare class SigningError extends Error {
+    constructor(message: string);
+}
+export declare class TransactionError extends Error {
+    constructor(message: string);
+}
+export declare class ModifyExplicitSessionError extends Error {
+    constructor(message: string);
+}
+export declare class ConnectionError extends Error {
+    constructor(message: string);
+}
+export declare class AddExplicitSessionError extends Error {
+    constructor(message: string);
+}
+export declare class FeeOptionError extends Error {
+    constructor(message: string);
+}
+export declare class WalletRedirectError extends Error {
+    constructor(message: string);
+}
+export declare class SessionConfigError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B"}

package/dist/utils/errors.js

@@ -0,0 +1,54 @@
+export class InitializationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InitializationError';
+    }
+}
+export class SigningError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SigningError';
+    }
+}
+export class TransactionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'TransactionError';
+    }
+}
+export class ModifyExplicitSessionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ModifyExplicitSessionError';
+    }
+}
+export class ConnectionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ConnectionError';
+    }
+}
+export class AddExplicitSessionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AddExplicitSessionError';
+    }
+}
+export class FeeOptionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FeeOptionError';
+    }
+}
+export class WalletRedirectError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WalletRedirectError';
+    }
+}
+export class SessionConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SessionConfigError';
+    }
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,11 @@
+import { Network } from '@0xsequence/wallet-primitives';
+type JsonReplacer = (key: string, value: any) => any;
+type JsonReviver = (key: string, value: any) => any;
+export declare const jsonReplacers: JsonReplacer;
+export declare const jsonRevivers: JsonReviver;
+export declare const getNetwork: (chainId: Network.ChainId | bigint | number) => Network.Network;
+export declare const getRpcUrl: (chainId: Network.ChainId | bigint | number, nodesUrl: string, projectAccessKey: string) => string;
+export declare const getRelayerUrl: (chainId: Network.ChainId | bigint | number, relayerUrl: string) => string;
+export declare const getExplorerUrl: (chainId: Network.ChainId | bigint | number, txHash: string) => string;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AAIvD,KAAK,YAAY,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG,CAAA;AACpD,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG,CAAA;AAwFnD,eAAO,MAAM,aAAa,cAAuD,CAAA;AAEjF,eAAO,MAAM,YAAY,aAAoD,CAAA;AAuB7E,eAAO,MAAM,UAAU,GAAI,SAAS,OAAO,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,oBAQpE,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,SAAS,OAAO,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,UAAU,MAAM,EAAE,kBAAkB,MAAM,WAU/G,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,SAAS,OAAO,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,YAAY,MAAM,WAM3F,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,SAAS,OAAO,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,QAAQ,MAAM,WAQxF,CAAA"}

package/dist/utils/index.js

@@ -0,0 +1,135 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { Network } from '@0xsequence/wallet-primitives';
+import { Bytes, Hex } from 'ox';
+/**
+ * Creates a single JSON replacer by chaining multiple replacers.
+ * The first replacer to transform a value wins.
+ */
+function chainReplacers(replacers) {
+    return function (key, value) {
+        for (const replacer of replacers) {
+            const replacedValue = replacer(key, value);
+            if (replacedValue !== value) {
+                return replacedValue;
+            }
+        }
+        return value;
+    };
+}
+/**
+ * Creates a single JSON reviver by chaining multiple revivers.
+ * The output of one reviver becomes the input for the next.
+ */
+function chainRevivers(revivers) {
+    return function (key, value) {
+        let currentValue = value;
+        for (const reviver of revivers) {
+            currentValue = reviver(key, currentValue);
+        }
+        return currentValue;
+    };
+}
+/**
+ * A JSON replacer that serializes BigInt values into a structured object.
+ */
+const bigIntReplacer = (_key, value) => {
+    if (typeof value === 'bigint') {
+        return {
+            _isBigInt: true,
+            data: value.toString(),
+        };
+    }
+    return value;
+};
+/**
+ * A JSON replacer that serializes Uint8Array values into a structured object.
+ */
+const uint8ArrayReplacer = (_key, value) => {
+    if (value instanceof Uint8Array) {
+        return {
+            _isUint8Array: true,
+            data: Hex.from(value),
+        };
+    }
+    return value;
+};
+/**
+ * A JSON reviver that deserializes a structured object back into a BigInt.
+ */
+const bigIntReviver = (key, value) => {
+    if (value !== null && typeof value === 'object' && value._isBigInt === true && typeof value.data === 'string') {
+        try {
+            return BigInt(value.data);
+        }
+        catch (e) {
+            console.error(`Failed to revive BigInt for key "${key}":`, e);
+            return value; // Return original object if revival fails
+        }
+    }
+    return value;
+};
+/**
+ * A JSON reviver that deserializes a structured object back into a Uint8Array.
+ */
+const uint8ArrayReviver = (key, value) => {
+    if (value !== null && typeof value === 'object' && value._isUint8Array === true && typeof value.data === 'string') {
+        try {
+            return Bytes.from(value.data);
+        }
+        catch (e) {
+            console.error(`Failed to revive Uint8Array for key "${key}":`, e);
+            return value; // Return original object if revival fails
+        }
+    }
+    return value;
+};
+export const jsonReplacers = chainReplacers([bigIntReplacer, uint8ArrayReplacer]);
+export const jsonRevivers = chainRevivers([bigIntReviver, uint8ArrayReviver]);
+/**
+ * Apply a template to a string.
+ *
+ * Example:
+ * applyTemplate('https://v3-{network}-relayer.sequence.app', { network: 'arbitrum' })
+ * returns 'https://v3-arbitrum-relayer.sequence.app'
+ *
+ * @param template - The template to apply.
+ * @param values - The values to apply to the template.
+ * @returns The template with the values applied.
+ */
+function applyTemplate(template, values) {
+    return template.replace(/{(.*?)}/g, (_, key) => {
+        const value = values[key];
+        if (value === undefined) {
+            throw new Error(`Missing template value for ${template}: ${key}`);
+        }
+        return value;
+    });
+}
+export const getNetwork = (chainId) => {
+    const network = Network.getNetworkFromChainId(chainId);
+    if (!network) {
+        throw new Error(`Network with chainId ${chainId} not found`);
+    }
+    return network;
+};
+export const getRpcUrl = (chainId, nodesUrl, projectAccessKey) => {
+    const network = getNetwork(chainId);
+    let url = applyTemplate(nodesUrl, { network: network.name });
+    if (nodesUrl.includes('sequence')) {
+        url = `${url}/${projectAccessKey}`;
+    }
+    return url;
+};
+export const getRelayerUrl = (chainId, relayerUrl) => {
+    const network = getNetwork(chainId);
+    const url = applyTemplate(relayerUrl, { network: network.name });
+    return url;
+};
+export const getExplorerUrl = (chainId, txHash) => {
+    const network = getNetwork(chainId);
+    const explorerUrl = network.blockExplorer?.url;
+    if (!explorerUrl) {
+        throw new Error(`Explorer URL not found for chainId ${chainId}`);
+    }
+    return `${explorerUrl}/tx/${txHash}`;
+};

package/dist/utils/storage.d.ts

@@ -0,0 +1,64 @@
+import { Attestation } from '@0xsequence/wallet-primitives';
+import { Address, Hex } from 'ox';
+import { AddExplicitSessionPayload, CreateNewSessionPayload, ModifySessionPayload, LoginMethod, SignMessagePayload, SignTypedDataPayload, GuardConfig, SendWalletTransactionPayload } from '../types/index.js';
+export interface ExplicitSessionData {
+    pk: Hex.Hex;
+    walletAddress: Address.Address;
+    chainId: number;
+    loginMethod?: LoginMethod;
+    userEmail?: string;
+    guard?: GuardConfig;
+}
+export interface ImplicitSessionData {
+    pk: Hex.Hex;
+    walletAddress: Address.Address;
+    attestation: Attestation.Attestation;
+    identitySignature: Hex.Hex;
+    chainId: number;
+    loginMethod?: LoginMethod;
+    userEmail?: string;
+    guard?: GuardConfig;
+}
+export type PendingPayload = CreateNewSessionPayload | AddExplicitSessionPayload | ModifySessionPayload | SignMessagePayload | SignTypedDataPayload | SendWalletTransactionPayload;
+export interface PendingRequestContext {
+    chainId: number;
+    action: string;
+    payload: PendingPayload;
+}
+export interface SequenceStorage {
+    setPendingRedirectRequest(isPending: boolean): Promise<void>;
+    isRedirectRequestPending(): Promise<boolean>;
+    saveTempSessionPk(pk: Hex.Hex): Promise<void>;
+    getAndClearTempSessionPk(): Promise<Hex.Hex | null>;
+    savePendingRequest(context: PendingRequestContext): Promise<void>;
+    getAndClearPendingRequest(): Promise<PendingRequestContext | null>;
+    peekPendingRequest(): Promise<PendingRequestContext | null>;
+    saveExplicitSession(sessionData: ExplicitSessionData): Promise<void>;
+    getExplicitSessions(): Promise<ExplicitSessionData[]>;
+    clearExplicitSessions(): Promise<void>;
+    saveImplicitSession(sessionData: ImplicitSessionData): Promise<void>;
+    getImplicitSession(): Promise<ImplicitSessionData | null>;
+    clearImplicitSession(): Promise<void>;
+    clearAllData(): Promise<void>;
+}
+export declare class WebStorage implements SequenceStorage {
+    private openDB;
+    private getIDBItem;
+    private setIDBItem;
+    private deleteIDBItem;
+    setPendingRedirectRequest(isPending: boolean): Promise<void>;
+    isRedirectRequestPending(): Promise<boolean>;
+    saveTempSessionPk(pk: Hex.Hex): Promise<void>;
+    getAndClearTempSessionPk(): Promise<Hex.Hex | null>;
+    savePendingRequest(context: PendingRequestContext): Promise<void>;
+    getAndClearPendingRequest(): Promise<PendingRequestContext | null>;
+    peekPendingRequest(): Promise<PendingRequestContext | null>;
+    saveExplicitSession(sessionData: ExplicitSessionData): Promise<void>;
+    getExplicitSessions(): Promise<ExplicitSessionData[]>;
+    clearExplicitSessions(): Promise<void>;
+    saveImplicitSession(sessionData: ImplicitSessionData): Promise<void>;
+    getImplicitSession(): Promise<ImplicitSessionData | null>;
+    clearImplicitSession(): Promise<void>;
+    clearAllData(): Promise<void>;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/utils/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":"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"}