@0xsequence/connect 5.4.7 → 6.0.0-beta.0

package/dist/cjs/utils/session/createContractPermission.js

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContractPermission = createContractPermission;
+exports.createContractPermissions = createContractPermissions;
+const dapp_client_1 = require("@0xsequence/dapp-client");
+const constants_js_1 = require("./constants.js");
+const operationMap = {
+    EQUAL: constants_js_1.PARAMETER_OPERATIONS.EQUAL,
+    NOT_EQUAL: constants_js_1.PARAMETER_OPERATIONS.NOT_EQUAL,
+    LESS_THAN_OR_EQUAL: constants_js_1.PARAMETER_OPERATIONS.LESS_THAN_OR_EQUAL,
+    GREATER_THAN_OR_EQUAL: constants_js_1.PARAMETER_OPERATIONS.GREATER_THAN_OR_EQUAL
+};
+/**
+ * Creates a permission for a single smart contract function.
+ *
+ * This helper function generates a permission object for a specific contract function,
+ * This is useful when you want to build permissions for individual contracts functions separately.
+ *
+ * @param options The configuration ({@link CreateContractPermissionOptions}) for the single contract permission.
+ * @returns A Permission ({@link Permission}) for the function on the contract.
+ *
+ * @note If no functions are provided, the dApp can call any function on the contract for the user.
+ *
+ * @example
+ *
+ * import { createContractPermission } from '@0xsequence/connect'
+ * import { parseUnits } from 'viem'
+ *
+ * // Allow dApp to transfer up to 1 USDC to any address untill the session expires.
+ * const permission = createContractPermission({
+ *         address: '0x...',
+ *         functionSignature: 'function transfer(address to, uint256 value)',
+ *         rules: [
+ *           {
+ *             param: 'value',
+ *             type: 'uint256',
+ *             condition: 'LESS_THAN_OR_EQUAL',
+ *             value: parseUnits('1', 6),
+ *             cumulative: true
+ *           }
+ *         ]
+ * })
+ *
+ */
+function createContractPermission(options) {
+    if (!options.address) {
+        throw new Error('createContractPermission: Contract address is required.');
+    }
+    // if no functions are provided, dapp can call any function on the contract
+    if (!options.functionSignature) {
+        const builder = dapp_client_1.Utils.PermissionBuilder.for(options.address).allowAll();
+        return builder.build();
+    }
+    let builder = dapp_client_1.Utils.PermissionBuilder.for(options.address);
+    builder = builder.forFunction(options.functionSignature);
+    if (options.onlyOnce === true) {
+        builder = builder.onlyOnce();
+    }
+    if (options.rules) {
+        for (const rule of options.rules) {
+            const isCumulative = rule.cumulative !== false;
+            const operation = operationMap[rule.condition];
+            // Use a switch statement to call the correct type-specific builder method.
+            switch (rule.type) {
+                case 'address':
+                    builder = builder.withAddressParam(rule.param, rule.value, operation, isCumulative);
+                    break;
+                case 'int256':
+                    builder = builder.withIntNParam(rule.param, BigInt(rule.value), 256, operation, isCumulative);
+                    break;
+                case 'int8':
+                    builder = builder.withIntNParam(rule.param, BigInt(rule.value), 8, operation, isCumulative);
+                    break;
+                case 'int16':
+                    builder = builder.withIntNParam(rule.param, BigInt(rule.value), 16, operation, isCumulative);
+                    break;
+                case 'int32':
+                    builder = builder.withIntNParam(rule.param, BigInt(rule.value), 32, operation, isCumulative);
+                    break;
+                case 'int64':
+                    builder = builder.withIntNParam(rule.param, BigInt(rule.value), 64, operation, isCumulative);
+                    break;
+                case 'int128':
+                    builder = builder.withIntNParam(rule.param, BigInt(rule.value), 128, operation, isCumulative);
+                    break;
+                case 'uint256':
+                    builder = builder.withUintNParam(rule.param, BigInt(rule.value), 256, operation, isCumulative);
+                    break;
+                case 'uint8':
+                    builder = builder.withUintNParam(rule.param, BigInt(rule.value), 8, operation, isCumulative);
+                    break;
+                case 'uint16':
+                    builder = builder.withUintNParam(rule.param, BigInt(rule.value), 16, operation, isCumulative);
+                    break;
+                case 'uint32':
+                    builder = builder.withUintNParam(rule.param, BigInt(rule.value), 32, operation, isCumulative);
+                    break;
+                case 'uint64':
+                    builder = builder.withUintNParam(rule.param, BigInt(rule.value), 64, operation, isCumulative);
+                    break;
+                case 'uint128':
+                    builder = builder.withUintNParam(rule.param, BigInt(rule.value), 128, operation, isCumulative);
+                    break;
+                case 'string':
+                    builder = builder.withStringParam(rule.param, rule.value);
+                    break;
+                case 'bool':
+                    builder = builder.withBoolParam(rule.param, rule.value, operation);
+                    break;
+                case 'bytes':
+                    builder = builder.withBytesParam(rule.param, rule.value);
+                    break;
+                case 'bytesN':
+                    builder = builder.withBytesNParam(rule.param, rule.value);
+                    break;
+                default:
+                    throw new Error(`createContractPermission: Unsupported parameter type "${rule.type}".`);
+            }
+        }
+    }
+    // Build and add this function's Permission object
+    return builder.build();
+}
+/**
+ * Creates contract permissions for multiple smart contract functions.
+ *
+ * This helper function generates permission objects that define what functions a dApp can call
+ * on a specific smart contract, with optional parameter constraints and spending limits.
+ *
+ * @param options The configuration ({@link CreateContractPermissionsOptions}) for multiple contract permissions.
+ * @returns An array of Permissions ({@link Permission}).
+ *
+ * @note If no functions are provided, the dApp can call any function on the contract for the user.
+ *
+ * @example
+ * ```typescript
+ * import { createContractPermissions } from '@0xsequence/connect'
+ *
+ * // Allow dApp to approve a DEX contract and transfer up to 10 USDC to any address until the session expires.
+ * const permissions = createContractPermissions({
+ *   address: '0x...',
+ *   functions: [
+ *     {
+ *       functionSignature: 'function transfer(address to, uint256 value)',
+ *       rules: [{
+ *         param: 'value',
+ *         type: 'uint256',
+ *         condition: 'LESS_THAN_OR_EQUAL',
+ *         value: parseUnits('10', 6),
+ *         cumulative: true
+ *       }]
+ *     },
+ *     {
+ *       functionSignature: 'function approve(address spender, uint256 value)',
+ *       rules: [{
+ *         param: 'spender',
+ *         type: 'address',
+ *         condition: 'EQUAL',
+ *         value: '0x...' // Could be a DEX contract address for swaps
+ *       }]
+ *     }
+ *   ]
+ * })
+ * ```
+ */
+function createContractPermissions(options) {
+    if (!options.address) {
+        throw new Error('createContractPermissions: Contract address is required.');
+    }
+    const allPermissions = [];
+    // if no functions are provided, dapp can call any function on the contract
+    if (!options.functions || options.functions.length === 0) {
+        const permission = createContractPermission({
+            address: options.address
+        });
+        allPermissions.push(permission);
+    }
+    // For each function in this contract, create a separate Permission object
+    for (const func of options.functions || []) {
+        if (!func.functionSignature) {
+            throw new Error('createContractPermissions: `signature` is required for each function permission.');
+        }
+        // Use createContractPermission for each individual function
+        const permission = createContractPermission({
+            address: options.address,
+            functionSignature: func.functionSignature,
+            rules: func.rules,
+            onlyOnce: func.onlyOnce
+        });
+        allPermissions.push(permission);
+    }
+    return allPermissions;
+}
+//# sourceMappingURL=createContractPermission.js.map

package/dist/cjs/utils/session/createContractPermission.js.map

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

package/dist/cjs/utils/session/createExplicitSessionParams.d.ts

@@ -0,0 +1,14 @@
+import { type ExplicitSessionConfig } from '@0xsequence/dapp-client';
+import type { ExplicitSessionParams } from './types.js';
+/**
+ * Assembles an Explicit Session Config object, to be used to create an explicit session.
+ *
+ * This helper function creates an explicit session between the dapp and the connected user wallet.
+ *
+ * It automatically includes a permission for the SEQUENCE_VALUE_FORWARDER contract to enable the dApp to pay gas fees using the user's native token.
+ *
+ * @param options The complete configuration for the session.
+ * @returns The final, ready-to-use object that can be used with Sequence V3 connectors.
+ */
+export declare function createExplicitSessionConfig(params: ExplicitSessionParams): ExplicitSessionConfig;
+//# sourceMappingURL=createExplicitSessionParams.d.ts.map

package/dist/cjs/utils/session/createExplicitSessionParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createExplicitSessionParams.d.ts","sourceRoot":"","sources":["../../../../src/utils/session/createExplicitSessionParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAGpE,OAAO,KAAK,EAAE,qBAAqB,EAAc,MAAM,YAAY,CAAA;AAEnE;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,qBAAqB,GAAG,qBAAqB,CA+BhG"}

package/dist/cjs/utils/session/createExplicitSessionParams.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createExplicitSessionConfig = createExplicitSessionConfig;
+/**
+ * Assembles an Explicit Session Config object, to be used to create an explicit session.
+ *
+ * This helper function creates an explicit session between the dapp and the connected user wallet.
+ *
+ * It automatically includes a permission for the SEQUENCE_VALUE_FORWARDER contract to enable the dApp to pay gas fees using the user's native token.
+ *
+ * @param options The complete configuration for the session.
+ * @returns The final, ready-to-use object that can be used with Sequence V3 connectors.
+ */
+function createExplicitSessionConfig(params) {
+    // Calculate the session deadline.
+    const nowInSeconds = BigInt(Math.floor(Date.now() / 1000));
+    const { days = 0, hours = 0, minutes = 0 } = params.expiresIn;
+    const sessionLifetimeSeconds = days * 24 * 60 * 60 + hours * 60 * 60 + minutes * 60;
+    // deadline in seconds
+    const deadline = nowInSeconds + BigInt(sessionLifetimeSeconds);
+    // Ensure we have at least one permission
+    if (params.permissions.length === 0) {
+        throw new Error('createExplicitSessionParams: At least one permission is required.');
+    }
+    const nativeTokenReceivers = [...(params.nativeTokenSpending.allowedRecipients || [])];
+    const nativeTokenSpendingPermissions = nativeTokenReceivers.map(receiver => ({
+        target: receiver,
+        rules: []
+    }));
+    // Assemble and return the final SessionObject.
+    const explicitSessionParams = {
+        chainId: params.chainId,
+        valueLimit: params.nativeTokenSpending.valueLimit,
+        deadline,
+        permissions: [...params.permissions, ...nativeTokenSpendingPermissions]
+    };
+    return explicitSessionParams;
+}
+//# sourceMappingURL=createExplicitSessionParams.js.map

package/dist/cjs/utils/session/createExplicitSessionParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createExplicitSessionParams.js","sourceRoot":"","sources":["../../../../src/utils/session/createExplicitSessionParams.ts"],"names":[],"mappings":";;AAeA,kEA+BC;AAzCD;;;;;;;;;GASG;AACH,SAAgB,2BAA2B,CAAC,MAA6B;IACvE,kCAAkC;IAClC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAA;IAE1D,MAAM,EAAE,IAAI,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,SAAS,CAAA;IAC7D,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,OAAO,GAAG,EAAE,CAAA;IAEnF,sBAAsB;IACtB,MAAM,QAAQ,GAAG,YAAY,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAA;IAE9D,yCAAyC;IACzC,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAA;IACtF,CAAC;IAED,MAAM,oBAAoB,GAAc,CAAC,GAAG,CAAC,MAAM,CAAC,mBAAmB,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,CAAA;IAEjG,MAAM,8BAA8B,GAAG,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC3E,MAAM,EAAE,QAAmB;QAC3B,KAAK,EAAE,EAAE;KACV,CAAC,CAAC,CAAA;IAEH,+CAA+C;IAC/C,MAAM,qBAAqB,GAA0B;QACnD,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,MAAM,CAAC,mBAAmB,CAAC,UAAU;QACjD,QAAQ;QACR,WAAW,EAAE,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,GAAG,8BAA8B,CAAiB;KACxF,CAAA;IAED,OAAO,qBAAqB,CAAA;AAC9B,CAAC"}

package/dist/cjs/utils/session/index.d.ts

@@ -0,0 +1,5 @@
+export * from './createExplicitSessionParams.js';
+export * from './createContractPermission.js';
+export * from './types.js';
+export * from './constants.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/session/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}

package/dist/cjs/{connectors/twitch → utils/session}/index.js

@@ -14,5 +14,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./twitch.js"), exports);
+__exportStar(require("./createExplicitSessionParams.js"), exports);
+__exportStar(require("./createContractPermission.js"), exports);
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./constants.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/utils/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/utils/session/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mEAAgD;AAChD,gEAA6C;AAC7C,6CAA0B;AAC1B,iDAA8B"}

package/dist/cjs/utils/session/types.d.ts

@@ -0,0 +1,108 @@
+import type { Permission } from '@0xsequence/dapp-client';
+import type { Address } from 'viem';
+export type Permission = Permission.Permission;
+export type ParameterOperation = Permission.ParameterOperation;
+export type ParameterRule = Permission.ParameterRule;
+/**
+ * The condition to apply when evaluating a rule against a parameter's value.
+ */
+export type RuleCondition = 'EQUAL' | 'NOT_EQUAL' | 'LESS_THAN_OR_EQUAL' | 'GREATER_THAN_OR_EQUAL';
+/**
+ * The supported ABI types for a rule's parameter.
+ */
+export type ParamType = 'address' | 'uint256' | 'uint8' | 'uint16' | 'uint32' | 'uint64' | 'uint128' | 'uint256' | 'string' | 'bool' | 'bytes' | 'bytesN' | 'int256' | 'int8' | 'int16' | 'int32' | 'int64' | 'int128';
+/**
+ * A rule that defines a constraint on a single parameter of a function.
+ */
+export type Rule = {
+    /** The name of the parameter from the function signature (e.g., 'to', 'amount'). */
+    param: string;
+    /** The ABI type of the parameter. This is required to use the correct builder method. */
+    type: ParamType;
+    /** The comparison to perform on the parameter. */
+    condition: RuleCondition;
+    /** The value to compare against. Must match the `type`. */
+    value: string | number | bigint | boolean;
+    /**
+     * Determines if the rule's value is a cumulative total across all calls to this function.
+     * @default true - This is a safer default.
+     */
+    cumulative?: boolean;
+};
+/**
+ * Defines the permissions for a single function on a contract.
+ */
+export type FunctionPermission = {
+    /**
+     * The human-readable function signature.
+     * Example: 'function transfer(address to, uint256 amount)'
+     */
+    functionSignature: string;
+    /** An array of rules to apply to the function's arguments. */
+    rules?: Rule[];
+    /**
+     * If true, this function can only be successfully called once during the session.
+     * @default false
+     */
+    onlyOnce?: boolean;
+};
+/**
+ * The options object for creating permissions for multiple smart contract functions.
+ */
+export type CreateContractPermissionsOptions = {
+    /** The address of the target contract. */
+    address: Address;
+    /** An array of permissions for one or more functions on this contract. */
+    functions?: FunctionPermission[] | undefined | null;
+};
+/**
+ * The options object for creating a permission.
+ */
+export type CreateContractPermissionOptions = {
+    /** The address of the target contract. */
+    address: Address;
+    /**
+     * The human-readable function signature.
+     * Example: 'function transfer(address to, uint256 amount)'
+     */
+    functionSignature?: string;
+    /** An array of rules to apply to the function's arguments. */
+    rules?: Rule[];
+    /**
+     * If true, this function can only be successfully called once during the session.
+     * @default false
+     */
+    onlyOnce?: boolean;
+};
+/**
+ * The options for specifying the duration of a session.
+ */
+export type SessionDuration = {
+    days?: number;
+    hours?: number;
+    minutes?: number;
+};
+export type NativeTokenSpending = {
+    valueLimit: bigint;
+    allowedRecipients?: Address[];
+};
+/**
+ * The parameters needed to create an explicit session.
+ */
+export type ExplicitSessionParams = {
+    /** The chain ID for which the session will be valid. */
+    chainId: number;
+    /**
+     * An object ({@link NativeTokenSpending}) that defines the maximum amount of native currency that can be spent during the session and allowed recipients for the native currency.
+     */
+    nativeTokenSpending: NativeTokenSpending;
+    /**
+     * The desired duration of the session. {@link SessionDuration}
+     */
+    expiresIn: SessionDuration;
+    /**
+     * An array of fully-built permission objects. {@link Permission}
+     */
+    permissions: Permission[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/utils/session/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/utils/session/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,CAAA;AAE9C,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,kBAAkB,CAAA;AAE9D,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,aAAa,CAAA;AAEpD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,WAAW,GAAG,oBAAoB,GAAG,uBAAuB,CAAA;AAElG;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,SAAS,GACT,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,SAAS,GACT,QAAQ,GACR,MAAM,GACN,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,OAAO,GACP,OAAO,GACP,OAAO,GACP,QAAQ,CAAA;AAEZ;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG;IACjB,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAA;IAEb,yFAAyF;IACzF,IAAI,EAAE,SAAS,CAAA;IAEf,kDAAkD;IAClD,SAAS,EAAE,aAAa,CAAA;IAExB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;IAEzC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAA;IAEzB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,IAAI,EAAE,CAAA;IAEd;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAA;IAEhB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,kBAAkB,EAAE,GAAG,SAAS,GAAG,IAAI,CAAA;CACpD,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAA;IAEhB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,IAAI,EAAE,CAAA;IAEd;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAA;CAC9B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAA;IAEf;;OAEG;IACH,mBAAmB,EAAE,mBAAmB,CAAA;IAExC;;OAEG;IACH,SAAS,EAAE,eAAe,CAAA;IAE1B;;OAEG;IACH,WAAW,EAAE,UAAU,EAAE,CAAA;CAC1B,CAAA"}

package/dist/cjs/utils/session/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/utils/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/utils/session/types.ts"],"names":[],"mappings":""}

package/dist/cjs/utils/setChains.d.ts

@@ -0,0 +1,22 @@
+import { type Chain, type Transport } from 'viem';
+import { type Config } from 'wagmi';
+/**
+ * Dynamically updates the chains and transports in a wagmi config at runtime.
+ *
+ * **Important**: This function accesses wagmi's internal `_internal` API which is
+ * not part of the public interface. This was tested against wagmi v3.x and may
+ * break in future wagmi versions if the internal structure changes.
+ *
+ * @param config - The wagmi Config instance to modify
+ * @param options.chains - The new chain configuration (must have at least one chain)
+ * @param options.transports - Optional transport overrides for specific chain IDs
+ *
+ * @throws Logs a warning and skips the update if the internal API structure is not as expected
+ *
+ * @see WAGMI_MIN_TESTED_VERSION for the minimum wagmi version this was tested against
+ */
+export declare function setChains(config: Config, { chains, transports }: {
+    chains: readonly [Chain, ...Chain[]];
+    transports?: Record<number, Transport>;
+}): void;
+//# sourceMappingURL=setChains.d.ts.map

package/dist/cjs/utils/setChains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setChains.d.ts","sourceRoot":"","sources":["../../../src/utils/setChains.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,MAAM,CAAA;AACjD,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,OAAO,CAAA;AAInC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,EACE,MAAM,EACN,UAAU,EACX,EAAE;IACD,MAAM,EAAE,SAAS,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAA;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CACvC,QAoCF"}

package/dist/cjs/utils/setChains.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setChains = setChains;
+const constants_js_1 = require("../constants.js");
+/**
+ * Dynamically updates the chains and transports in a wagmi config at runtime.
+ *
+ * **Important**: This function accesses wagmi's internal `_internal` API which is
+ * not part of the public interface. This was tested against wagmi v3.x and may
+ * break in future wagmi versions if the internal structure changes.
+ *
+ * @param config - The wagmi Config instance to modify
+ * @param options.chains - The new chain configuration (must have at least one chain)
+ * @param options.transports - Optional transport overrides for specific chain IDs
+ *
+ * @throws Logs a warning and skips the update if the internal API structure is not as expected
+ *
+ * @see WAGMI_MIN_TESTED_VERSION for the minimum wagmi version this was tested against
+ */
+function setChains(config, { chains, transports }) {
+    try {
+        const internalConfig = config;
+        // Version guard: verify the internal API structure exists before accessing it
+        if (!internalConfig._internal) {
+            console.warn(`[setChains] wagmi config._internal not found. This utility requires wagmi >= ${constants_js_1.WAGMI_MIN_TESTED_VERSION}. Chains were not updated.`);
+            return;
+        }
+        if (!internalConfig._internal.chains?.setState) {
+            console.warn(`[setChains] wagmi config._internal.chains.setState not found. The wagmi internal API may have changed. Chains were not updated.`);
+            return;
+        }
+        // 1. Update transports mapping
+        if (transports && internalConfig._internal.transports) {
+            for (const chain of chains) {
+                const transport = transports[chain.id];
+                if (transport) {
+                    internalConfig._internal.transports[chain.id] = transport;
+                }
+            }
+        }
+        // 2. Update chains state
+        // This will trigger subscribers (like WagmiProvider and hooks) to re-render
+        internalConfig._internal.chains.setState(chains);
+    }
+    catch (error) {
+        console.warn('[setChains] Failed to update wagmi chains dynamically:', error);
+    }
+}
+//# sourceMappingURL=setChains.js.map

package/dist/cjs/utils/setChains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setChains.js","sourceRoot":"","sources":["../../../src/utils/setChains.ts"],"names":[],"mappings":";;AAoBA,8BA4CC;AA7DD,kDAA0D;AAE1D;;;;;;;;;;;;;;GAcG;AACH,SAAgB,SAAS,CACvB,MAAc,EACd,EACE,MAAM,EACN,UAAU,EAIX;IAED,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,MAAa,CAAA;QAEpC,8EAA8E;QAC9E,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CACV,gFAAgF,uCAAwB,4BAA4B,CACrI,CAAA;YACD,OAAM;QACR,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;YAC/C,OAAO,CAAC,IAAI,CACV,iIAAiI,CAClI,CAAA;YACD,OAAM;QACR,CAAC;QAED,+BAA+B;QAC/B,IAAI,UAAU,IAAI,cAAc,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;YACtD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;gBACtC,IAAI,SAAS,EAAE,CAAC;oBACd,cAAc,CAAC,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,SAAS,CAAA;gBAC3D,CAAC;YACH,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,4EAA4E;QAC5E,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,wDAAwD,EAAE,KAAK,CAAC,CAAA;IAC/E,CAAC;AACH,CAAC"}

package/dist/cjs/utils/walletConfiguration.d.ts

@@ -0,0 +1,47 @@
+import type { ConnectConfig } from '../types.js';
+export type WalletConfigurationProvider = 'EMAIL' | 'GOOGLE' | 'APPLE' | 'PASSKEY';
+type WalletConfigurationMetaTags = {
+    title?: string;
+    description?: string;
+    url?: string;
+    previewImage?: string;
+    favicon?: string;
+};
+type WalletConfigurationThemeAsset = {
+    src?: string | null;
+    width?: string | null;
+    height?: string | null;
+    alt?: string | null;
+};
+type WalletConfigurationTheme = {
+    fileHeaderLogo?: WalletConfigurationThemeAsset;
+    fileAuthLogo?: WalletConfigurationThemeAsset;
+    fileAuthCover?: WalletConfigurationThemeAsset;
+    fileBackgroundImage?: WalletConfigurationThemeAsset;
+};
+type WalletConfigurationResponse = {
+    name?: string;
+    description?: string;
+    url?: string;
+    metaTags?: WalletConfigurationMetaTags;
+    defaultTheme?: string;
+    themes?: Record<string, WalletConfigurationTheme>;
+    enabledProviders?: string[];
+    supportedChains?: number[];
+};
+export type WalletConfigurationOverrides = {
+    signIn?: {
+        projectName?: string;
+        logoUrl?: string;
+    };
+    chainIds?: number[];
+    enabledProviders?: WalletConfigurationProvider[];
+};
+export declare const normalizeWalletUrl: (walletUrl: string) => string;
+export declare const fetchWalletConfiguration: (walletUrl: string) => Promise<WalletConfigurationResponse>;
+export declare const getCachedProjectName: (walletUrl: string) => string | undefined;
+export declare const cacheProjectName: (walletUrl: string, projectName: string) => void;
+export declare const mapWalletConfigurationToOverrides: (config: WalletConfigurationResponse) => WalletConfigurationOverrides;
+export declare const mergeConnectConfigWithWalletConfiguration: (config: ConnectConfig, overrides?: WalletConfigurationOverrides) => ConnectConfig;
+export {};
+//# sourceMappingURL=walletConfiguration.d.ts.map

package/dist/cjs/utils/walletConfiguration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletConfiguration.d.ts","sourceRoot":"","sources":["../../../src/utils/walletConfiguration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,MAAM,MAAM,2BAA2B,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAA;AAElF,KAAK,2BAA2B,GAAG;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,KAAK,6BAA6B,GAAG;IACnC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB,CAAA;AAED,KAAK,wBAAwB,GAAG;IAC9B,cAAc,CAAC,EAAE,6BAA6B,CAAA;IAC9C,YAAY,CAAC,EAAE,6BAA6B,CAAA;IAC5C,aAAa,CAAC,EAAE,6BAA6B,CAAA;IAC7C,mBAAmB,CAAC,EAAE,6BAA6B,CAAA;CACpD,CAAA;AAED,KAAK,2BAA2B,GAAG;IACjC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,2BAA2B,CAAA;IACtC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;IACjD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,gBAAgB,CAAC,EAAE,2BAA2B,EAAE,CAAA;CACjD,CAAA;AAaD,eAAO,MAAM,kBAAkB,GAAI,WAAW,MAAM,KAAG,MAQtD,CAAA;AAiBD,eAAO,MAAM,wBAAwB,GAAU,WAAW,MAAM,KAAG,OAAO,CAAC,2BAA2B,CA6CrG,CAAA;AAqCD,eAAO,MAAM,oBAAoB,GAAI,WAAW,MAAM,KAAG,MAAM,GAAG,SAWjE,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,WAAW,MAAM,EAAE,aAAa,MAAM,SAUtE,CAAA;AAED,eAAO,MAAM,iCAAiC,GAAI,QAAQ,2BAA2B,KAAG,4BAmBvF,CAAA;AAED,eAAO,MAAM,yCAAyC,GACpD,QAAQ,aAAa,EACrB,YAAY,4BAA4B,KACvC,aAcF,CAAA"}