@dynamic-labs/ethereum-aa-core 4.14.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,19 @@
+# @dynamic-labs/ethereum-aa-core
+
+Core package for Ethereum Account Abstraction utilities and types.
+
+## Installation
+
+```bash
+npm install @dynamic-labs/ethereum-aa-core
+```
+
+## Usage
+
+```typescript
+import { AccountAbstractionBaseConnector } from '@dynamic-labs/ethereum-aa-core';
+```
+
+## License
+
+MIT

package/package.cjs

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

package/package.js

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@dynamic-labs/ethereum-aa-core",
+  "version": "4.14.0",
+  "description": "Core package for Ethereum Account Abstraction utilities and types",
+  "author": "Dynamic Labs, Inc.",
+  "license": "MIT",
+  "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"
+  },
+  "homepage": "https://www.dynamic.xyz/",
+  "dependencies": {
+    "@dynamic-labs/sdk-api-core": "0.0.658",
+    "@dynamic-labs/assert-package-version": "4.14.0",
+    "@dynamic-labs/ethereum-core": "4.14.0",
+    "@dynamic-labs/types": "4.14.0",
+    "@dynamic-labs/utils": "4.14.0",
+    "@dynamic-labs/wallet-book": "4.14.0",
+    "@dynamic-labs/wallet-connector-core": "4.14.0"
+  },
+  "peerDependencies": {
+    "viem": "^2.21.60"
+  }
+}

package/src/connector/AccountAbstractionBaseConnector.cjs

@@ -0,0 +1,92 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var viem = require('viem');
+var walletConnectorCore = require('@dynamic-labs/wallet-connector-core');
+var utils = require('@dynamic-labs/utils');
+var ethereumCore = require('@dynamic-labs/ethereum-core');
+
+class AccountAbstractionBaseConnector extends walletConnectorCore.WalletConnectorBase {
+    constructor(opts) {
+        super({ walletBook: opts.walletBook });
+        this._isGasSponsorshipDisabled = false;
+        this.evmNetworks = [];
+        this.ChainWallet = ethereumCore.EthereumWallet;
+        this.isEmbeddedWallet = true;
+        this.connectedChain = 'EVM';
+        this.supportedChains = ['ETH', 'EVM'];
+        this._walletUiUtils = opts.walletUiUtils;
+        this.evmNetworks = opts.evmNetworks;
+    }
+    /**
+     * Gets the EOA connector associated with this account abstraction wallet
+     * @deprecated Use getEOAConnector with a specific smart contract wallet address instead
+     */
+    getEOAConnector() {
+        return this.eoaConnector;
+    }
+    /**
+     * Disables gas sponsorship for the next transaction
+     */
+    disableGasSponsorshipOnce() {
+        this._isGasSponsorshipDisabled = true;
+    }
+    /**
+     * Protected method to check if gas sponsorship is disabled
+     */
+    isGasSponsorshipDisabled() {
+        return this._isGasSponsorshipDisabled;
+    }
+    /**
+     * Gets the enabled networks
+     */
+    getEnabledNetworks() {
+        return this.evmNetworks;
+    }
+    /**
+     * Gets the signer for the current wallet
+     */
+    async getSigner() {
+        return this.getWalletClient();
+    }
+    /**
+     * Gets the balance for an address
+     */
+    async getBalance(address) {
+        const publicClient = await this.getPublicClient();
+        if (!publicClient) {
+            throw new utils.DynamicError('No public client available');
+        }
+        const balance = await publicClient.getBalance({ address });
+        return viem.formatEther(balance);
+    }
+    /**
+     * Validates that the expected wallet is active
+     */
+    async validateActiveWallet(expectedAddress) {
+        const currentAddress = await this.getAddress();
+        if (currentAddress?.toLowerCase() !== expectedAddress.toLowerCase()) {
+            throw new utils.DynamicError('Invalid active wallet');
+        }
+    }
+    async createUiTransaction(from) {
+        await this.validateActiveWallet(from);
+        const walletClient = this.getWalletClient();
+        const publicClient = await this.getPublicClient();
+        if (!publicClient || !walletClient) {
+            throw new utils.DynamicError('No public client available');
+        }
+        return ethereumCore.createViemUiTransaction({
+            from,
+            publicClient: publicClient,
+            walletClient: walletClient,
+        });
+    }
+    async getBlockExplorerUrlsForCurrentNetwork() {
+        return this.eoaConnector?.getBlockExplorerUrlsForCurrentNetwork() ?? [];
+    }
+}
+
+exports.AccountAbstractionBaseConnector = AccountAbstractionBaseConnector;

package/src/connector/AccountAbstractionBaseConnector.d.ts

@@ -0,0 +1,65 @@
+import { Chain, InternalWalletConnector, WalletConnectorBase } from '@dynamic-labs/wallet-connector-core';
+import { EthereumWallet } from '@dynamic-labs/ethereum-core';
+import { IUITransaction, WalletUiUtils, GenericNetwork } from '@dynamic-labs/types';
+import { SmartWalletProperties } from '@dynamic-labs/sdk-api-core';
+import { AccountAbstractionConnectorProps } from '../types';
+export declare abstract class AccountAbstractionBaseConnector extends WalletConnectorBase<typeof EthereumWallet> {
+    abstract eoaConnector: InternalWalletConnector | undefined;
+    abstract eoaAddress: string | undefined;
+    protected _walletUiUtils: WalletUiUtils<InternalWalletConnector>;
+    private _isGasSponsorshipDisabled;
+    protected evmNetworks: GenericNetwork[];
+    ChainWallet: typeof EthereumWallet;
+    isEmbeddedWallet: boolean;
+    connectedChain: Chain;
+    supportedChains: Chain[];
+    constructor(opts: AccountAbstractionConnectorProps);
+    /**
+     * Gets the EOA connector associated with this account abstraction wallet
+     * @deprecated Use getEOAConnector with a specific smart contract wallet address instead
+     */
+    getEOAConnector(): InternalWalletConnector | undefined;
+    /**
+     * Disables gas sponsorship for the next transaction
+     */
+    disableGasSponsorshipOnce(): void;
+    /**
+     * Protected method to check if gas sponsorship is disabled
+     */
+    protected isGasSponsorshipDisabled(): boolean;
+    /**
+     * Gets the enabled networks
+     */
+    getEnabledNetworks(): GenericNetwork[];
+    /**
+     * Gets the signer for the current wallet
+     */
+    getSigner(): Promise<unknown>;
+    /**
+     * Gets the balance for an address
+     */
+    getBalance(address: string): Promise<string | undefined>;
+    /**
+     * Validates that the expected wallet is active
+     */
+    validateActiveWallet(expectedAddress: string): Promise<void>;
+    abstract canSponsorTransactionGas(transaction: {
+        from: string;
+        to?: string;
+        value?: bigint;
+        data?: string;
+    }): Promise<boolean>;
+    createUiTransaction(from: string): Promise<IUITransaction>;
+    getBlockExplorerUrlsForCurrentNetwork(): Promise<string[]>;
+    abstract getAccountAbstractionProvider<T>({ withSponsorship, }: {
+        withSponsorship: boolean;
+    }): Promise<T>;
+    abstract initialize(params: {
+        smartWalletAddress: string;
+        eoaAddress: string;
+        eoaConnector: InternalWalletConnector;
+        properties?: SmartWalletProperties;
+        shouldSetEoaConnector?: boolean;
+    }): Promise<void>;
+}
+//# sourceMappingURL=AccountAbstractionBaseConnector.d.ts.map

package/src/connector/AccountAbstractionBaseConnector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountAbstractionBaseConnector.d.ts","sourceRoot":"","sources":["../../../../../packages/ethereum-aa-core/src/connector/AccountAbstractionBaseConnector.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,EACL,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAEL,cAAc,EACf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,cAAc,EACd,aAAa,EACb,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EAAE,gCAAgC,EAAE,MAAM,UAAU,CAAC;AAE5D,8BAAsB,+BAAgC,SAAQ,mBAAmB,CAC/E,OAAO,cAAc,CACtB;IACC,QAAQ,CAAC,YAAY,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAExC,SAAS,CAAC,cAAc,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IACjE,OAAO,CAAC,yBAAyB,CAAS;IAC1C,SAAS,CAAC,WAAW,EAAE,cAAc,EAAE,CAAM;IAEpC,WAAW,wBAAkB;IAC7B,gBAAgB,UAAQ;IACjC,cAAc,EAAE,KAAK,CAAS;IAC9B,eAAe,EAAE,KAAK,EAAE,CAAkB;gBAE9B,IAAI,EAAE,gCAAgC;IAMlD;;;OAGG;IACH,eAAe,IAAI,uBAAuB,GAAG,SAAS;IAItD;;OAEG;IACH,yBAAyB,IAAI,IAAI;IAIjC;;OAEG;IACH,SAAS,CAAC,wBAAwB,IAAI,OAAO;IAI7C;;OAEG;IACM,kBAAkB,IAAI,cAAc,EAAE;IAI/C;;OAEG;IACY,SAAS;IAIxB;;OAEG;IACY,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAUvE;;OAEG;IACY,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3E,QAAQ,CAAC,wBAAwB,CAAC,WAAW,EAAE;QAC7C,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,OAAO,CAAC;IAEd,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAgBjD,qCAAqC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAIzE,QAAQ,CAAC,6BAA6B,CAAC,CAAC,EAAE,EACxC,eAAe,GAChB,EAAE;QACD,eAAe,EAAE,OAAO,CAAC;KAC1B,GAAG,OAAO,CAAC,CAAC,CAAC;IAEd,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE;QAC1B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,uBAAuB,CAAC;QACtC,UAAU,CAAC,EAAE,qBAAqB,CAAC;QACnC,qBAAqB,CAAC,EAAE,OAAO,CAAC;KACjC,GAAG,OAAO,CAAC,IAAI,CAAC;CAClB"}

package/src/connector/AccountAbstractionBaseConnector.js

@@ -0,0 +1,88 @@
+'use client'
+import { formatEther } from 'viem';
+import { WalletConnectorBase } from '@dynamic-labs/wallet-connector-core';
+import { DynamicError } from '@dynamic-labs/utils';
+import { EthereumWallet, createViemUiTransaction } from '@dynamic-labs/ethereum-core';
+
+class AccountAbstractionBaseConnector extends WalletConnectorBase {
+    constructor(opts) {
+        super({ walletBook: opts.walletBook });
+        this._isGasSponsorshipDisabled = false;
+        this.evmNetworks = [];
+        this.ChainWallet = EthereumWallet;
+        this.isEmbeddedWallet = true;
+        this.connectedChain = 'EVM';
+        this.supportedChains = ['ETH', 'EVM'];
+        this._walletUiUtils = opts.walletUiUtils;
+        this.evmNetworks = opts.evmNetworks;
+    }
+    /**
+     * Gets the EOA connector associated with this account abstraction wallet
+     * @deprecated Use getEOAConnector with a specific smart contract wallet address instead
+     */
+    getEOAConnector() {
+        return this.eoaConnector;
+    }
+    /**
+     * Disables gas sponsorship for the next transaction
+     */
+    disableGasSponsorshipOnce() {
+        this._isGasSponsorshipDisabled = true;
+    }
+    /**
+     * Protected method to check if gas sponsorship is disabled
+     */
+    isGasSponsorshipDisabled() {
+        return this._isGasSponsorshipDisabled;
+    }
+    /**
+     * Gets the enabled networks
+     */
+    getEnabledNetworks() {
+        return this.evmNetworks;
+    }
+    /**
+     * Gets the signer for the current wallet
+     */
+    async getSigner() {
+        return this.getWalletClient();
+    }
+    /**
+     * Gets the balance for an address
+     */
+    async getBalance(address) {
+        const publicClient = await this.getPublicClient();
+        if (!publicClient) {
+            throw new DynamicError('No public client available');
+        }
+        const balance = await publicClient.getBalance({ address });
+        return formatEther(balance);
+    }
+    /**
+     * Validates that the expected wallet is active
+     */
+    async validateActiveWallet(expectedAddress) {
+        const currentAddress = await this.getAddress();
+        if (currentAddress?.toLowerCase() !== expectedAddress.toLowerCase()) {
+            throw new DynamicError('Invalid active wallet');
+        }
+    }
+    async createUiTransaction(from) {
+        await this.validateActiveWallet(from);
+        const walletClient = this.getWalletClient();
+        const publicClient = await this.getPublicClient();
+        if (!publicClient || !walletClient) {
+            throw new DynamicError('No public client available');
+        }
+        return createViemUiTransaction({
+            from,
+            publicClient: publicClient,
+            walletClient: walletClient,
+        });
+    }
+    async getBlockExplorerUrlsForCurrentNetwork() {
+        return this.eoaConnector?.getBlockExplorerUrlsForCurrentNetwork() ?? [];
+    }
+}
+
+export { AccountAbstractionBaseConnector };

package/src/connector/AccountAbstractionBaseConnector.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AccountAbstractionBaseConnector.spec.d.ts.map

package/src/connector/AccountAbstractionBaseConnector.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountAbstractionBaseConnector.spec.d.ts","sourceRoot":"","sources":["../../../../../packages/ethereum-aa-core/src/connector/AccountAbstractionBaseConnector.spec.ts"],"names":[],"mappings":""}

package/src/connector/index.d.ts

@@ -0,0 +1,2 @@
+export { AccountAbstractionBaseConnector } from './AccountAbstractionBaseConnector';
+//# sourceMappingURL=index.d.ts.map

package/src/connector/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/ethereum-aa-core/src/connector/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC"}

package/src/index.cjs

@@ -0,0 +1,12 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var assertPackageVersion = require('@dynamic-labs/assert-package-version');
+var _package = require('../package.cjs');
+var AccountAbstractionBaseConnector = require('./connector/AccountAbstractionBaseConnector.cjs');
+
+assertPackageVersion.assertPackageVersion('@dynamic-labs/ethereum-aa-core', _package.version);
+
+exports.AccountAbstractionBaseConnector = AccountAbstractionBaseConnector.AccountAbstractionBaseConnector;

package/src/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './connector';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/ethereum-aa-core/src/index.ts"],"names":[],"mappings":"AAOA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/src/index.js

@@ -0,0 +1,6 @@
+'use client'
+import { assertPackageVersion } from '@dynamic-labs/assert-package-version';
+import { version } from '../package.js';
+export { AccountAbstractionBaseConnector } from './connector/AccountAbstractionBaseConnector.js';
+
+assertPackageVersion('@dynamic-labs/ethereum-aa-core', version);

package/src/types/index.d.ts

@@ -0,0 +1,9 @@
+import { GenericNetwork, WalletUiUtils } from '@dynamic-labs/types';
+import { WalletBookSchema } from '@dynamic-labs/wallet-book';
+import { InternalWalletConnector } from '@dynamic-labs/wallet-connector-core';
+export type AccountAbstractionConnectorProps = {
+    walletUiUtils: WalletUiUtils<InternalWalletConnector>;
+    walletBook: WalletBookSchema;
+    evmNetworks: GenericNetwork[];
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/ethereum-aa-core/src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE9E,MAAM,MAAM,gCAAgC,GAAG;IAC7C,aAAa,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IACtD,UAAU,EAAE,gBAAgB,CAAC;IAC7B,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B,CAAC"}