@dynamic-labs/ethereum-gasless-core 0.0.0 → 4.84.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Dynamic Labs, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,7 @@
+# @dynamic-labs/ethereum-gasless-core
+
+Pure (no React, no message-transport) implementation of Dynamic's EVM gasless flows: sponsored transactions and EIP-7702 delegation.
+
+The package mirrors the gasless surface of `@dynamic-labs-sdk/evm` but is wallet-provider-agnostic: every function receives the viem `WalletClient` / `PublicClient` it needs as part of an explicit `deps` argument, so callers wire the package up against any signer (wallet-connector-core, an in-memory account, an EIP-1193 provider, etc.).
+
+It is consumed by `@dynamic-labs/ethereum-gasless-extension` on the React Native host and by `apps/webview-controller`'s `EthereumGaslessController` inside the embedded WebView.

package/package.cjs

@@ -0,0 +1,8 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var version = "4.84.0";
+
+exports.version = version;

package/package.js

@@ -0,0 +1,4 @@
+'use client'
+var version = "4.84.0";
+
+export { version };

package/package.json

@@ -1 +1,23 @@
-{ "name": "@dynamic-labs/ethereum-gasless-core", "version": "0.0.0" }
+{
+  "name": "@dynamic-labs/ethereum-gasless-core",
+  "version": "4.84.0",
+  "main": "./src/index.cjs",
+  "module": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js",
+      "require": "./src/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@dynamic-labs/sdk-api-core": "0.0.985",
+    "@dynamic-labs/assert-package-version": "4.84.0"
+  },
+  "peerDependencies": {
+    "viem": "^2.45.3"
+  }
+}

package/src/index.cjs

@@ -0,0 +1,53 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var assertPackageVersion = require('@dynamic-labs/assert-package-version');
+var _package = require('../package.cjs');
+var activate7702Delegation = require('./lib/activate7702Delegation/activate7702Delegation.cjs');
+var create7702DelegationRegistry = require('./lib/create7702DelegationRegistry/create7702DelegationRegistry.cjs');
+var generateIntentNonce = require('./lib/generateIntentNonce/generateIntentNonce.cjs');
+var generateRandomNonce = require('./lib/generateRandomNonce/generateRandomNonce.cjs');
+var getAvailableEvmGaslessRelayer = require('./lib/getAvailableEvmGaslessRelayer/getAvailableEvmGaslessRelayer.cjs');
+var getEVMSponsoredTransactionStatus = require('./lib/getEVMSponsoredTransactionStatus/getEVMSponsoredTransactionStatus.cjs');
+var is7702DelegationActive = require('./lib/is7702DelegationActive/is7702DelegationActive.cjs');
+var isEthereumGasSponsorshipEnabled = require('./lib/isEthereumGasSponsorshipEnabled/isEthereumGasSponsorshipEnabled.cjs');
+var relaySponsoredTransaction = require('./lib/relaySponsoredTransaction/relaySponsoredTransaction.cjs');
+var resolveAuthorization = require('./lib/resolveAuthorization/resolveAuthorization.cjs');
+var resolveChainId = require('./lib/resolveChainId/resolveChainId.cjs');
+var sendSponsoredTransaction = require('./lib/sendSponsoredTransaction/sendSponsoredTransaction.cjs');
+var sign7702Authorization = require('./lib/sign7702Authorization/sign7702Authorization.cjs');
+var signSponsoredTransaction = require('./lib/signSponsoredTransaction/signSponsoredTransaction.cjs');
+var toSerializedAuthorization = require('./lib/toSerializedAuthorization/toSerializedAuthorization.cjs');
+var waitForSponsoredTransaction = require('./lib/waitForSponsoredTransaction/waitForSponsoredTransaction.cjs');
+var EthereumGasSponsorshipNotEnabledError = require('./lib/errors/EthereumGasSponsorshipNotEnabledError/EthereumGasSponsorshipNotEnabledError.cjs');
+var SponsorTransactionError = require('./lib/errors/SponsorTransactionError/SponsorTransactionError.cjs');
+var constants = require('./lib/constants.cjs');
+
+assertPackageVersion.assertPackageVersion('@dynamic-labs/ethereum-gasless-core', _package.version);
+
+exports.activate7702Delegation = activate7702Delegation.activate7702Delegation;
+exports.create7702DelegationRegistry = create7702DelegationRegistry.create7702DelegationRegistry;
+exports.generateIntentNonce = generateIntentNonce.generateIntentNonce;
+exports.generateRandomNonce = generateRandomNonce.generateRandomNonce;
+exports.getAvailableEvmGaslessRelayer = getAvailableEvmGaslessRelayer.getAvailableEvmGaslessRelayer;
+exports.getEVMSponsoredTransactionStatus = getEVMSponsoredTransactionStatus.getEVMSponsoredTransactionStatus;
+exports.is7702DelegationActive = is7702DelegationActive.is7702DelegationActive;
+exports.isEthereumGasSponsorshipEnabled = isEthereumGasSponsorshipEnabled.isEthereumGasSponsorshipEnabled;
+exports.relaySponsoredTransaction = relaySponsoredTransaction.relaySponsoredTransaction;
+exports.resolveAuthorization = resolveAuthorization.resolveAuthorization;
+exports.resolveChainId = resolveChainId.resolveChainId;
+exports.sendSponsoredTransaction = sendSponsoredTransaction.sendSponsoredTransaction;
+exports.sign7702Authorization = sign7702Authorization.sign7702Authorization;
+exports.signSponsoredTransaction = signSponsoredTransaction.signSponsoredTransaction;
+exports.toSerializedAuthorization = toSerializedAuthorization.toSerializedAuthorization;
+exports.waitForSponsoredTransaction = waitForSponsoredTransaction.waitForSponsoredTransaction;
+exports.EthereumGasSponsorshipNotEnabledError = EthereumGasSponsorshipNotEnabledError.EthereumGasSponsorshipNotEnabledError;
+exports.SponsorTransactionError = SponsorTransactionError.SponsorTransactionError;
+exports.AUTHORIZED_EXECUTIONS_TYPES = constants.AUTHORIZED_EXECUTIONS_TYPES;
+exports.BATCH_CALL_OPDATA_AUTH_MODE = constants.BATCH_CALL_OPDATA_AUTH_MODE;
+exports.DEFAULT_VALID_FOR_SECONDS = constants.DEFAULT_VALID_FOR_SECONDS;
+exports.DELEGATION_CODE_PREFIX = constants.DELEGATION_CODE_PREFIX;
+exports.DELEGATION_CONTRACT_ADDRESS = constants.DELEGATION_CONTRACT_ADDRESS;
+exports.UGD_ABI = constants.UGD_ABI;

package/src/index.d.ts

@@ -0,0 +1,20 @@
+export { activate7702Delegation } from './lib/activate7702Delegation/activate7702Delegation';
+export { create7702DelegationRegistry } from './lib/create7702DelegationRegistry/create7702DelegationRegistry';
+export { generateIntentNonce } from './lib/generateIntentNonce/generateIntentNonce';
+export { generateRandomNonce } from './lib/generateRandomNonce/generateRandomNonce';
+export { getAvailableEvmGaslessRelayer } from './lib/getAvailableEvmGaslessRelayer/getAvailableEvmGaslessRelayer';
+export { getEVMSponsoredTransactionStatus } from './lib/getEVMSponsoredTransactionStatus/getEVMSponsoredTransactionStatus';
+export { is7702DelegationActive } from './lib/is7702DelegationActive/is7702DelegationActive';
+export { isEthereumGasSponsorshipEnabled } from './lib/isEthereumGasSponsorshipEnabled/isEthereumGasSponsorshipEnabled';
+export { relaySponsoredTransaction } from './lib/relaySponsoredTransaction/relaySponsoredTransaction';
+export { resolveAuthorization } from './lib/resolveAuthorization/resolveAuthorization';
+export { resolveChainId } from './lib/resolveChainId/resolveChainId';
+export { sendSponsoredTransaction } from './lib/sendSponsoredTransaction/sendSponsoredTransaction';
+export { sign7702Authorization } from './lib/sign7702Authorization/sign7702Authorization';
+export { signSponsoredTransaction } from './lib/signSponsoredTransaction/signSponsoredTransaction';
+export { toSerializedAuthorization } from './lib/toSerializedAuthorization/toSerializedAuthorization';
+export { waitForSponsoredTransaction } from './lib/waitForSponsoredTransaction/waitForSponsoredTransaction';
+export { EthereumGasSponsorshipNotEnabledError } from './lib/errors/EthereumGasSponsorshipNotEnabledError/EthereumGasSponsorshipNotEnabledError';
+export { SponsorTransactionError } from './lib/errors/SponsorTransactionError/SponsorTransactionError';
+export { AUTHORIZED_EXECUTIONS_TYPES, BATCH_CALL_OPDATA_AUTH_MODE, DEFAULT_VALID_FOR_SECONDS, DELEGATION_CODE_PREFIX, DELEGATION_CONTRACT_ADDRESS, UGD_ABI, } from './lib/constants';
+export type { Delegation7702Registry, EvmGaslessApiDeps, EvmGaslessChainDeps, SerializedAuthorization, SignedSponsoredTransaction, SponsoredTransactionCall, SponsoredTransactionStatus, SponsoredTransactionStatusResult, } from './lib/types';

package/src/index.js

@@ -0,0 +1,24 @@
+'use client'
+import { assertPackageVersion } from '@dynamic-labs/assert-package-version';
+import { version } from '../package.js';
+export { activate7702Delegation } from './lib/activate7702Delegation/activate7702Delegation.js';
+export { create7702DelegationRegistry } from './lib/create7702DelegationRegistry/create7702DelegationRegistry.js';
+export { generateIntentNonce } from './lib/generateIntentNonce/generateIntentNonce.js';
+export { generateRandomNonce } from './lib/generateRandomNonce/generateRandomNonce.js';
+export { getAvailableEvmGaslessRelayer } from './lib/getAvailableEvmGaslessRelayer/getAvailableEvmGaslessRelayer.js';
+export { getEVMSponsoredTransactionStatus } from './lib/getEVMSponsoredTransactionStatus/getEVMSponsoredTransactionStatus.js';
+export { is7702DelegationActive } from './lib/is7702DelegationActive/is7702DelegationActive.js';
+export { isEthereumGasSponsorshipEnabled } from './lib/isEthereumGasSponsorshipEnabled/isEthereumGasSponsorshipEnabled.js';
+export { relaySponsoredTransaction } from './lib/relaySponsoredTransaction/relaySponsoredTransaction.js';
+export { resolveAuthorization } from './lib/resolveAuthorization/resolveAuthorization.js';
+export { resolveChainId } from './lib/resolveChainId/resolveChainId.js';
+export { sendSponsoredTransaction } from './lib/sendSponsoredTransaction/sendSponsoredTransaction.js';
+export { sign7702Authorization } from './lib/sign7702Authorization/sign7702Authorization.js';
+export { signSponsoredTransaction } from './lib/signSponsoredTransaction/signSponsoredTransaction.js';
+export { toSerializedAuthorization } from './lib/toSerializedAuthorization/toSerializedAuthorization.js';
+export { waitForSponsoredTransaction } from './lib/waitForSponsoredTransaction/waitForSponsoredTransaction.js';
+export { EthereumGasSponsorshipNotEnabledError } from './lib/errors/EthereumGasSponsorshipNotEnabledError/EthereumGasSponsorshipNotEnabledError.js';
+export { SponsorTransactionError } from './lib/errors/SponsorTransactionError/SponsorTransactionError.js';
+export { AUTHORIZED_EXECUTIONS_TYPES, BATCH_CALL_OPDATA_AUTH_MODE, DEFAULT_VALID_FOR_SECONDS, DELEGATION_CODE_PREFIX, DELEGATION_CONTRACT_ADDRESS, UGD_ABI } from './lib/constants.js';
+
+assertPackageVersion('@dynamic-labs/ethereum-gasless-core', version);

package/src/lib/activate7702Delegation/activate7702Delegation.cjs

@@ -0,0 +1,17 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var sendSponsoredTransaction = require('../sendSponsoredTransaction/sendSponsoredTransaction.cjs');
+
+/**
+ * Activates EIP-7702 delegation for the wallet by sending a sponsored
+ * transaction whose only payload is the 7702 authorization itself.
+ *
+ * After activation the delegation is persisted on-chain and subsequent
+ * sponsored transactions can omit the authorization.
+ */
+const activate7702Delegation = ({ authorization }, deps) => sendSponsoredTransaction.sendSponsoredTransaction({ authorization, calls: [] }, deps);
+
+exports.activate7702Delegation = activate7702Delegation;

package/src/lib/activate7702Delegation/activate7702Delegation.d.ts

@@ -0,0 +1,18 @@
+import type { Hex } from 'viem';
+import type { SignAuthorizationReturnType } from 'viem/accounts';
+import type { EvmGaslessChainDeps } from '../types';
+type Activate7702DelegationParams = {
+    /** Pre-signed EIP-7702 authorization. If omitted, one will be signed automatically. */
+    authorization?: SignAuthorizationReturnType;
+};
+/**
+ * Activates EIP-7702 delegation for the wallet by sending a sponsored
+ * transaction whose only payload is the 7702 authorization itself.
+ *
+ * After activation the delegation is persisted on-chain and subsequent
+ * sponsored transactions can omit the authorization.
+ */
+export declare const activate7702Delegation: ({ authorization }: Activate7702DelegationParams, deps: EvmGaslessChainDeps) => Promise<{
+    transactionHash: Hex;
+}>;
+export {};

package/src/lib/activate7702Delegation/activate7702Delegation.js

@@ -0,0 +1,13 @@
+'use client'
+import { sendSponsoredTransaction } from '../sendSponsoredTransaction/sendSponsoredTransaction.js';
+
+/**
+ * Activates EIP-7702 delegation for the wallet by sending a sponsored
+ * transaction whose only payload is the 7702 authorization itself.
+ *
+ * After activation the delegation is persisted on-chain and subsequent
+ * sponsored transactions can omit the authorization.
+ */
+const activate7702Delegation = ({ authorization }, deps) => sendSponsoredTransaction({ authorization, calls: [] }, deps);
+
+export { activate7702Delegation };

package/src/lib/constants.cjs

@@ -0,0 +1,69 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Address of the Dynamic gasless EIP-7702 delegation contract.
+ *
+ * When a wallet has 7702 delegation active, its on-chain bytecode is
+ * `DELEGATION_CODE_PREFIX + this address` (minus the leading "0x").
+ */
+const DELEGATION_CONTRACT_ADDRESS = '0x0000Fb7702036ff9f76044a501ac1aA74cbab16b';
+/**
+ * Default lifetime of a signed sponsored-transaction intent, in seconds.
+ */
+const DEFAULT_VALID_FOR_SECONDS = 600;
+/**
+ * EIP-7702 delegation code prefix (`0xef0100`). When a wallet is delegated,
+ * its code is this prefix followed by the lowercase delegate address.
+ */
+const DELEGATION_CODE_PREFIX = '0xef0100';
+/**
+ * UGD authorization mode bytes for a batch-call OpData EIP-712 intent.
+ */
+const BATCH_CALL_OPDATA_AUTH_MODE = '0x0100000000007821000100000000000000000000000000000000000000000000';
+/**
+ * EIP-712 typed-data definitions for the UGD `AuthorizedExecutions` primary
+ * type. Used by `signTypedData` when signing a sponsored intent.
+ *
+ * Struct name `Execution` and field order are part of the on-chain typehash
+ * (`keccak256("AuthorizedExecutions(...)Execution(...)")`). Any divergence
+ * produces a different digest, the delegate's `ecrecover` returns a different
+ * address, and the call reverts with `UnauthorizedExecution()` (`0x7daadde3`).
+ */
+const AUTHORIZED_EXECUTIONS_TYPES = {
+    AuthorizedExecutions: [
+        { name: 'calls', type: 'Execution[]' },
+        { name: 'deadline', type: 'uint256' },
+        { name: 'mode', type: 'bytes32' },
+        { name: 'nonce', type: 'uint256' },
+        { name: 'relayer', type: 'address' },
+    ],
+    Execution: [
+        { name: 'target', type: 'address' },
+        { name: 'value', type: 'uint256' },
+        { name: 'data', type: 'bytes' },
+    ],
+};
+/**
+ * Minimal ABI fragment for the UGD `isNonceUsed(uint256)` view, used to
+ * sanity-check randomly-generated intent nonces against the delegation
+ * contract's bitmap.
+ */
+const UGD_ABI = [
+    {
+        inputs: [{ name: 'nonce', type: 'uint256' }],
+        name: 'isNonceUsed',
+        outputs: [{ name: '', type: 'bool' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+];
+
+exports.AUTHORIZED_EXECUTIONS_TYPES = AUTHORIZED_EXECUTIONS_TYPES;
+exports.BATCH_CALL_OPDATA_AUTH_MODE = BATCH_CALL_OPDATA_AUTH_MODE;
+exports.DEFAULT_VALID_FOR_SECONDS = DEFAULT_VALID_FOR_SECONDS;
+exports.DELEGATION_CODE_PREFIX = DELEGATION_CODE_PREFIX;
+exports.DELEGATION_CONTRACT_ADDRESS = DELEGATION_CONTRACT_ADDRESS;
+exports.UGD_ABI = UGD_ABI;

package/src/lib/constants.d.ts

@@ -0,0 +1,76 @@
+import type { Hex } from 'viem';
+/**
+ * Address of the Dynamic gasless EIP-7702 delegation contract.
+ *
+ * When a wallet has 7702 delegation active, its on-chain bytecode is
+ * `DELEGATION_CODE_PREFIX + this address` (minus the leading "0x").
+ */
+export declare const DELEGATION_CONTRACT_ADDRESS: Hex;
+/**
+ * Default lifetime of a signed sponsored-transaction intent, in seconds.
+ */
+export declare const DEFAULT_VALID_FOR_SECONDS = 600;
+/**
+ * EIP-7702 delegation code prefix (`0xef0100`). When a wallet is delegated,
+ * its code is this prefix followed by the lowercase delegate address.
+ */
+export declare const DELEGATION_CODE_PREFIX = "0xef0100";
+/**
+ * UGD authorization mode bytes for a batch-call OpData EIP-712 intent.
+ */
+export declare const BATCH_CALL_OPDATA_AUTH_MODE: Hex;
+/**
+ * EIP-712 typed-data definitions for the UGD `AuthorizedExecutions` primary
+ * type. Used by `signTypedData` when signing a sponsored intent.
+ *
+ * Struct name `Execution` and field order are part of the on-chain typehash
+ * (`keccak256("AuthorizedExecutions(...)Execution(...)")`). Any divergence
+ * produces a different digest, the delegate's `ecrecover` returns a different
+ * address, and the call reverts with `UnauthorizedExecution()` (`0x7daadde3`).
+ */
+export declare const AUTHORIZED_EXECUTIONS_TYPES: {
+    readonly AuthorizedExecutions: readonly [{
+        readonly name: "calls";
+        readonly type: "Execution[]";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }, {
+        readonly name: "mode";
+        readonly type: "bytes32";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }, {
+        readonly name: "relayer";
+        readonly type: "address";
+    }];
+    readonly Execution: readonly [{
+        readonly name: "target";
+        readonly type: "address";
+    }, {
+        readonly name: "value";
+        readonly type: "uint256";
+    }, {
+        readonly name: "data";
+        readonly type: "bytes";
+    }];
+};
+/**
+ * Minimal ABI fragment for the UGD `isNonceUsed(uint256)` view, used to
+ * sanity-check randomly-generated intent nonces against the delegation
+ * contract's bitmap.
+ */
+export declare const UGD_ABI: readonly [{
+    readonly inputs: readonly [{
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }];
+    readonly name: "isNonceUsed";
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+    readonly stateMutability: "view";
+    readonly type: "function";
+}];

package/src/lib/constants.js

@@ -0,0 +1,60 @@
+'use client'
+/**
+ * Address of the Dynamic gasless EIP-7702 delegation contract.
+ *
+ * When a wallet has 7702 delegation active, its on-chain bytecode is
+ * `DELEGATION_CODE_PREFIX + this address` (minus the leading "0x").
+ */
+const DELEGATION_CONTRACT_ADDRESS = '0x0000Fb7702036ff9f76044a501ac1aA74cbab16b';
+/**
+ * Default lifetime of a signed sponsored-transaction intent, in seconds.
+ */
+const DEFAULT_VALID_FOR_SECONDS = 600;
+/**
+ * EIP-7702 delegation code prefix (`0xef0100`). When a wallet is delegated,
+ * its code is this prefix followed by the lowercase delegate address.
+ */
+const DELEGATION_CODE_PREFIX = '0xef0100';
+/**
+ * UGD authorization mode bytes for a batch-call OpData EIP-712 intent.
+ */
+const BATCH_CALL_OPDATA_AUTH_MODE = '0x0100000000007821000100000000000000000000000000000000000000000000';
+/**
+ * EIP-712 typed-data definitions for the UGD `AuthorizedExecutions` primary
+ * type. Used by `signTypedData` when signing a sponsored intent.
+ *
+ * Struct name `Execution` and field order are part of the on-chain typehash
+ * (`keccak256("AuthorizedExecutions(...)Execution(...)")`). Any divergence
+ * produces a different digest, the delegate's `ecrecover` returns a different
+ * address, and the call reverts with `UnauthorizedExecution()` (`0x7daadde3`).
+ */
+const AUTHORIZED_EXECUTIONS_TYPES = {
+    AuthorizedExecutions: [
+        { name: 'calls', type: 'Execution[]' },
+        { name: 'deadline', type: 'uint256' },
+        { name: 'mode', type: 'bytes32' },
+        { name: 'nonce', type: 'uint256' },
+        { name: 'relayer', type: 'address' },
+    ],
+    Execution: [
+        { name: 'target', type: 'address' },
+        { name: 'value', type: 'uint256' },
+        { name: 'data', type: 'bytes' },
+    ],
+};
+/**
+ * Minimal ABI fragment for the UGD `isNonceUsed(uint256)` view, used to
+ * sanity-check randomly-generated intent nonces against the delegation
+ * contract's bitmap.
+ */
+const UGD_ABI = [
+    {
+        inputs: [{ name: 'nonce', type: 'uint256' }],
+        name: 'isNonceUsed',
+        outputs: [{ name: '', type: 'bool' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+];
+
+export { AUTHORIZED_EXECUTIONS_TYPES, BATCH_CALL_OPDATA_AUTH_MODE, DEFAULT_VALID_FOR_SECONDS, DELEGATION_CODE_PREFIX, DELEGATION_CONTRACT_ADDRESS, UGD_ABI };

package/src/lib/create7702DelegationRegistry/create7702DelegationRegistry.cjs

@@ -0,0 +1,22 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const buildKey = ({ chainId, walletAddress, }) => `${walletAddress.toLowerCase()}:${chainId}`;
+/**
+ * Creates an in-memory registry that tracks which wallet+chain combinations
+ * have active EIP-7702 delegation. Only positive delegations are cached — a
+ * missing entry means the status is unknown and should be checked via RPC.
+ */
+const create7702DelegationRegistry = () => {
+    const delegated = new Map();
+    return {
+        isDelegated: (params) => delegated.has(buildKey(params)),
+        markDelegated: (params) => {
+            delegated.set(buildKey(params), true);
+        },
+    };
+};
+
+exports.create7702DelegationRegistry = create7702DelegationRegistry;

package/src/lib/create7702DelegationRegistry/create7702DelegationRegistry.d.ts

@@ -0,0 +1,7 @@
+import type { Delegation7702Registry } from '../types';
+/**
+ * Creates an in-memory registry that tracks which wallet+chain combinations
+ * have active EIP-7702 delegation. Only positive delegations are cached — a
+ * missing entry means the status is unknown and should be checked via RPC.
+ */
+export declare const create7702DelegationRegistry: () => Delegation7702Registry;

package/src/lib/create7702DelegationRegistry/create7702DelegationRegistry.js

@@ -0,0 +1,18 @@
+'use client'
+const buildKey = ({ chainId, walletAddress, }) => `${walletAddress.toLowerCase()}:${chainId}`;
+/**
+ * Creates an in-memory registry that tracks which wallet+chain combinations
+ * have active EIP-7702 delegation. Only positive delegations are cached — a
+ * missing entry means the status is unknown and should be checked via RPC.
+ */
+const create7702DelegationRegistry = () => {
+    const delegated = new Map();
+    return {
+        isDelegated: (params) => delegated.has(buildKey(params)),
+        markDelegated: (params) => {
+            delegated.set(buildKey(params), true);
+        },
+    };
+};
+
+export { create7702DelegationRegistry };

package/src/lib/errors/EthereumGasSponsorshipNotEnabledError/EthereumGasSponsorshipNotEnabledError.cjs

@@ -0,0 +1,18 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Error thrown when a caller attempts to use sponsored transactions or 7702
+ * delegation while EVM gas sponsorship is disabled for the project.
+ */
+class EthereumGasSponsorshipNotEnabledError extends Error {
+    constructor() {
+        super('EVM gas sponsorship is not enabled for this project');
+        this.code = 'evm_gas_sponsorship_not_enabled_error';
+        this.name = 'EthereumGasSponsorshipNotEnabledError';
+    }
+}
+
+exports.EthereumGasSponsorshipNotEnabledError = EthereumGasSponsorshipNotEnabledError;

package/src/lib/errors/EthereumGasSponsorshipNotEnabledError/EthereumGasSponsorshipNotEnabledError.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Error thrown when a caller attempts to use sponsored transactions or 7702
+ * delegation while EVM gas sponsorship is disabled for the project.
+ */
+export declare class EthereumGasSponsorshipNotEnabledError extends Error {
+    readonly code = "evm_gas_sponsorship_not_enabled_error";
+    constructor();
+}

package/src/lib/errors/EthereumGasSponsorshipNotEnabledError/EthereumGasSponsorshipNotEnabledError.js

@@ -0,0 +1,14 @@
+'use client'
+/**
+ * Error thrown when a caller attempts to use sponsored transactions or 7702
+ * delegation while EVM gas sponsorship is disabled for the project.
+ */
+class EthereumGasSponsorshipNotEnabledError extends Error {
+    constructor() {
+        super('EVM gas sponsorship is not enabled for this project');
+        this.code = 'evm_gas_sponsorship_not_enabled_error';
+        this.name = 'EthereumGasSponsorshipNotEnabledError';
+    }
+}
+
+export { EthereumGasSponsorshipNotEnabledError };

package/src/lib/errors/SponsorTransactionError/SponsorTransactionError.cjs

@@ -0,0 +1,23 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Error thrown when the sponsored-transaction relay flow fails. Wraps an
+ * optional underlying cause and an optional terminal-failure message returned
+ * by the relay.
+ */
+class SponsorTransactionError extends Error {
+    constructor(cause, details) {
+        super(details ?? 'Failed to sponsor EVM transaction');
+        this.code = 'sponsor_transaction_error';
+        this.name = 'SponsorTransactionError';
+        this.details = details;
+        if (cause) {
+            this.cause = cause;
+        }
+    }
+}
+
+exports.SponsorTransactionError = SponsorTransactionError;

package/src/lib/errors/SponsorTransactionError/SponsorTransactionError.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Error thrown when the sponsored-transaction relay flow fails. Wraps an
+ * optional underlying cause and an optional terminal-failure message returned
+ * by the relay.
+ */
+export declare class SponsorTransactionError extends Error {
+    readonly code = "sponsor_transaction_error";
+    readonly details?: string;
+    constructor(cause?: Error | null, details?: string);
+}

package/src/lib/errors/SponsorTransactionError/SponsorTransactionError.js

@@ -0,0 +1,19 @@
+'use client'
+/**
+ * Error thrown when the sponsored-transaction relay flow fails. Wraps an
+ * optional underlying cause and an optional terminal-failure message returned
+ * by the relay.
+ */
+class SponsorTransactionError extends Error {
+    constructor(cause, details) {
+        super(details ?? 'Failed to sponsor EVM transaction');
+        this.code = 'sponsor_transaction_error';
+        this.name = 'SponsorTransactionError';
+        this.details = details;
+        if (cause) {
+            this.cause = cause;
+        }
+    }
+}
+
+export { SponsorTransactionError };

package/src/lib/generateIntentNonce/generateIntentNonce.cjs

@@ -0,0 +1,39 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var constants = require('../constants.cjs');
+var generateRandomNonce = require('../generateRandomNonce/generateRandomNonce.cjs');
+
+/**
+ * Generates a random 256-bit bitmap nonce for UGD `AuthorizedExecutions`
+ * signing.
+ *
+ * Uses `crypto.getRandomValues` for entropy; collisions are essentially
+ * impossible at 256 bits. As a safety check the freshly-generated nonce is
+ * validated against the on-chain `isNonceUsed` view — if the contract call
+ * fails (e.g. delegation not yet active), the random nonce is still safe to
+ * use because it was generated locally with 256 bits of entropy.
+ */
+const generateIntentNonce = async ({ walletAddress }, { publicClient }) => {
+    const nonce = generateRandomNonce.generateRandomNonce();
+    try {
+        const isUsed = await publicClient.readContract({
+            abi: constants.UGD_ABI,
+            address: walletAddress,
+            args: [nonce],
+            functionName: 'isNonceUsed',
+        });
+        if (isUsed) {
+            return generateRandomNonce.generateRandomNonce();
+        }
+    }
+    catch {
+        // Contract call may fail if delegation is not yet active — the nonce is
+        // still safe to use since it was randomly generated.
+    }
+    return nonce;
+};
+
+exports.generateIntentNonce = generateIntentNonce;

package/src/lib/generateIntentNonce/generateIntentNonce.d.ts

@@ -0,0 +1,20 @@
+import type { Chain, Hex, PublicClient, Transport } from 'viem';
+type GenerateIntentNonceParams = {
+    /** The wallet address whose delegation contract is queried for `isNonceUsed`. */
+    walletAddress: Hex;
+};
+type GenerateIntentNonceDeps = {
+    publicClient: PublicClient<Transport, Chain>;
+};
+/**
+ * Generates a random 256-bit bitmap nonce for UGD `AuthorizedExecutions`
+ * signing.
+ *
+ * Uses `crypto.getRandomValues` for entropy; collisions are essentially
+ * impossible at 256 bits. As a safety check the freshly-generated nonce is
+ * validated against the on-chain `isNonceUsed` view — if the contract call
+ * fails (e.g. delegation not yet active), the random nonce is still safe to
+ * use because it was generated locally with 256 bits of entropy.
+ */
+export declare const generateIntentNonce: ({ walletAddress }: GenerateIntentNonceParams, { publicClient }: GenerateIntentNonceDeps) => Promise<bigint>;
+export {};