dequanto 0.0.1 → 0.1.3

package/src/erc4337/Erc4337TxWriter.ts

@@ -0,0 +1,169 @@
+import { Web3Client } from '@dequanto/clients/Web3Client';
+import { IErc4337Info } from './models/IErc4337Info';
+import { EoAccount, Erc4337Account } from '@dequanto/models/TAccount';
+import { Erc4337Service } from './Erc4337Service';
+import { $require } from '@dequanto/utils/$require';
+import { UserOperation } from './models/UserOperation';
+import { IBlockChainExplorer } from '@dequanto/explorer/IBlockChainExplorer';
+import { TAddress } from '@dequanto/models/TAddress';
+import { $is } from '@dequanto/utils/$is';
+import { TxWriter } from '@dequanto/txs/TxWriter';
+import { TEth } from '@dequanto/models/TEth';
+
+export class Erc4337TxWriter {
+    public service: Erc4337Service;
+
+    constructor(public client: Web3Client, public explorer: IBlockChainExplorer, public info: IErc4337Info) {
+        this.service = new Erc4337Service(client, explorer, info);
+    }
+
+    async getAccount (owner: EoAccount) {
+        let service = this.service;
+        let { initCode, initCodeGas } = await service.prepareAccountCreation(owner.address);
+        let senderAddress = await service.getAccountAddress(owner.address, initCode);
+        return <Erc4337Account> {
+            address: senderAddress,
+            type: 'erc4337',
+            provider: 'default',
+            operator: owner
+        };
+    }
+
+    async ensureAccount (params: {
+        owner: EoAccount,
+        submitter?: EoAccount,
+        salt?: bigint
+    }): Promise<{
+        accountAddress: TAddress,
+        op?: UserOperation,
+        opHash?: string
+        writer?: TxWriter,
+    }> {
+        let service = this.service;
+        let { initCode, initCodeGas } = await service.prepareAccountCreation(params.owner.address, params.salt ?? 0n);
+        let erc4337AccountAddress = await service.getAccountAddress(params.owner.address, initCode);
+        if (await service.existsAccount(erc4337AccountAddress)) {
+            return {
+                accountAddress: erc4337AccountAddress,
+                op: null,
+                opHash: null,
+                writer: null
+            };
+        }
+
+        let tx = <TEth.TxLike> {
+            to: erc4337AccountAddress,
+            value: 0,
+            data: '0x'
+        };
+        let result = await this.submitUserOpViaEntryPointWithOwner({
+            tx,
+            ...params
+        });
+        await result.writer.wait();
+        return {
+            accountAddress: erc4337AccountAddress,
+            ...result
+        };
+    }
+
+    async prepareUserOp (params: {
+        erc4337Account?: {
+            address?: TAddress
+            salt?: bigint
+        }
+        tx: TEth.TxLike
+        owner: EoAccount
+        nonceSalt?: bigint
+    }) {
+        let { tx, owner } = params
+        let service = this.service;
+
+        // 1. Prepare ERC4337 contract account via Account Factory
+        let erc4337Address: TAddress;
+        let initCode = '0x';
+        let initCodeGas = 0n;
+
+        if ($is.Address(params.erc4337Account?.address)) {
+            erc4337Address = params.erc4337Account.address;
+
+            let senderExists = await service.existsAccount(erc4337Address);
+            if (senderExists === false) {
+                let salt = params.erc4337Account?.salt ?? 0n;
+                let ownerAddr = owner.address;
+                let result = await service.prepareAccountCreation(ownerAddr, salt);
+                initCode = result.initCode;
+                initCodeGas = result.initCodeGas;
+
+                let address = await service.getAccountAddress(owner.address, initCode);
+                $require.eq(erc4337Address.toLowerCase(), address.toLowerCase(), `Sender address does not match. Wrong owner (${ ownerAddr }) or salt(${ salt })? `);
+            }
+        } else {
+            let result = await service.prepareAccountCreation(owner.address, params.erc4337Account?.salt ?? 0n);
+            initCode = result.initCode;
+            initCodeGas = result.initCodeGas;
+            erc4337Address = await service.getAccountAddress(owner.address, initCode);
+
+            let senderExists = await service.existsAccount(erc4337Address);
+            if (senderExists) {
+                initCode = '0x';
+                initCodeGas = 0n;
+            }
+        }
+
+        // 2. Prepare Target (Demo) contract transaction data
+        let callData = tx.data;
+        let callGas = await this.client.getGasEstimation(erc4337Address, tx);
+
+        // 3. Prepare contract account execution method
+        $require.Address(tx.to);
+        let { callData: accountCallData } = await service.prepareAccountCallData(
+            tx.to,
+            0n,
+            callData
+        );
+
+        let [ gasPrice, erc4337AccountBalance, nonce] = await Promise.all([
+            this.client.getGasPrice(),
+            this.client.getBalance(erc4337Address),
+            service.getNonce(erc4337Address, params.nonceSalt ?? 0n)
+        ]);
+        let maxFeePerGas = erc4337AccountBalance === 0n ? 0n : gasPrice.price;
+
+        let { op, opHash } = await service.getSignedUserOp(<Partial<UserOperation>>{
+            sender: erc4337Address,
+            initCode: initCode,
+            callData: accountCallData.data,
+            callGasLimit: BigInt(callGas),
+            verificationGasLimit: 150000n + BigInt(initCodeGas),
+            nonce: nonce,
+            maxFeePerGas: maxFeePerGas,
+            maxPriorityFeePerGas: 10n**9n,
+        }, owner);
+
+        return { op, opHash }
+    }
+
+    async submitUserOpViaEntryPointWithOwner (params: {
+        erc4337Account?: {
+            address?: TAddress
+            salt?: bigint
+        },
+        tx: TEth.TxLike,
+        owner: EoAccount,
+        submitter?: EoAccount,
+    }) {
+        let { submitter, owner } = params
+        let service = this.service;
+
+        let { op, opHash } = await this.prepareUserOp(params)
+        let writer = await service.submitUserOpViaEntryPoint(submitter ?? owner, op);
+        return { op, opHash, writer };
+    }
+
+    async submitUserOp (submitter: EoAccount, signedOp: UserOperation) {
+        let service = this.service;
+        let writer = await service.submitUserOpViaEntryPoint(submitter, signedOp);
+        return writer;
+    }
+}

package/src/erc4337/models/Erc4337Abi.ts

@@ -0,0 +1,7 @@
+import type { TAbiItem } from '@dequanto/types/TAbi';
+
+export const Erc4337Abi = {
+    EntryPoint: <TAbiItem[]>[{ "inputs": [{ "internalType": "uint256", "name": "preOpGas", "type": "uint256" }, { "internalType": "uint256", "name": "paid", "type": "uint256" }, { "internalType": "uint48", "name": "validAfter", "type": "uint48" }, { "internalType": "uint48", "name": "validUntil", "type": "uint48" }, { "internalType": "bool", "name": "targetSuccess", "type": "bool" }, { "internalType": "bytes", "name": "targetResult", "type": "bytes" }], "name": "ExecutionResult", "type": "error" }, { "inputs": [{ "internalType": "uint256", "name": "opIndex", "type": "uint256" }, { "internalType": "string", "name": "reason", "type": "string" }], "name": "FailedOp", "type": "error" }, { "inputs": [{ "internalType": "address", "name": "sender", "type": "address" }], "name": "SenderAddressResult", "type": "error" }, { "inputs": [{ "internalType": "address", "name": "aggregator", "type": "address" }], "name": "SignatureValidationFailed", "type": "error" }, { "inputs": [{ "components": [{ "internalType": "uint256", "name": "preOpGas", "type": "uint256" }, { "internalType": "uint256", "name": "prefund", "type": "uint256" }, { "internalType": "bool", "name": "sigFailed", "type": "bool" }, { "internalType": "uint48", "name": "validAfter", "type": "uint48" }, { "internalType": "uint48", "name": "validUntil", "type": "uint48" }, { "internalType": "bytes", "name": "paymasterContext", "type": "bytes" }], "internalType": "struct IEntryPoint.ReturnInfo", "name": "returnInfo", "type": "tuple" }, { "components": [{ "internalType": "uint256", "name": "stake", "type": "uint256" }, { "internalType": "uint256", "name": "unstakeDelaySec", "type": "uint256" }], "internalType": "struct IStakeManager.StakeInfo", "name": "senderInfo", "type": "tuple" }, { "components": [{ "internalType": "uint256", "name": "stake", "type": "uint256" }, { "internalType": "uint256", "name": "unstakeDelaySec", "type": "uint256" }], "internalType": "struct IStakeManager.StakeInfo", "name": "factoryInfo", "type": "tuple" }, { "components": [{ "internalType": "uint256", "name": "stake", "type": "uint256" }, { "internalType": "uint256", "name": "unstakeDelaySec", "type": "uint256" }], "internalType": "struct IStakeManager.StakeInfo", "name": "paymasterInfo", "type": "tuple" }], "name": "ValidationResult", "type": "error" }, { "inputs": [{ "components": [{ "internalType": "uint256", "name": "preOpGas", "type": "uint256" }, { "internalType": "uint256", "name": "prefund", "type": "uint256" }, { "internalType": "bool", "name": "sigFailed", "type": "bool" }, { "internalType": "uint48", "name": "validAfter", "type": "uint48" }, { "internalType": "uint48", "name": "validUntil", "type": "uint48" }, { "internalType": "bytes", "name": "paymasterContext", "type": "bytes" }], "internalType": "struct IEntryPoint.ReturnInfo", "name": "returnInfo", "type": "tuple" }, { "components": [{ "internalType": "uint256", "name": "stake", "type": "uint256" }, { "internalType": "uint256", "name": "unstakeDelaySec", "type": "uint256" }], "internalType": "struct IStakeManager.StakeInfo", "name": "senderInfo", "type": "tuple" }, { "components": [{ "internalType": "uint256", "name": "stake", "type": "uint256" }, { "internalType": "uint256", "name": "unstakeDelaySec", "type": "uint256" }], "internalType": "struct IStakeManager.StakeInfo", "name": "factoryInfo", "type": "tuple" }, { "components": [{ "internalType": "uint256", "name": "stake", "type": "uint256" }, { "internalType": "uint256", "name": "unstakeDelaySec", "type": "uint256" }], "internalType": "struct IStakeManager.StakeInfo", "name": "paymasterInfo", "type": "tuple" }, { "components": [{ "internalType": "address", "name": "aggregator", "type": "address" }, { "components": [{ "internalType": "uint256", "name": "stake", "type": "uint256" }, { "internalType": "uint256", "name": "unstakeDelaySec", "type": "uint256" }], "internalType": "struct IStakeManager.StakeInfo", "name": "stakeInfo", "type": "tuple" }], "internalType": "struct IEntryPoint.AggregatorStakeInfo", "name": "aggregatorInfo", "type": "tuple" }], "name": "ValidationResultWithAggregation", "type": "error" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "bytes32", "name": "userOpHash", "type": "bytes32" }, { "indexed": true, "internalType": "address", "name": "sender", "type": "address" }, { "indexed": false, "internalType": "address", "name": "factory", "type": "address" }, { "indexed": false, "internalType": "address", "name": "paymaster", "type": "address" }], "name": "AccountDeployed", "type": "event" }, { "anonymous": false, "inputs": [], "name": "BeforeExecution", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "account", "type": "address" }, { "indexed": false, "internalType": "uint256", "name": "totalDeposit", "type": "uint256" }], "name": "Deposited", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "aggregator", "type": "address" }], "name": "SignatureAggregatorChanged", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "account", "type": "address" }, { "indexed": false, "internalType": "uint256", "name": "totalStaked", "type": "uint256" }, { "indexed": false, "internalType": "uint256", "name": "unstakeDelaySec", "type": "uint256" }], "name": "StakeLocked", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "account", "type": "address" }, { "indexed": false, "internalType": "uint256", "name": "withdrawTime", "type": "uint256" }], "name": "StakeUnlocked", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "account", "type": "address" }, { "indexed": false, "internalType": "address", "name": "withdrawAddress", "type": "address" }, { "indexed": false, "internalType": "uint256", "name": "amount", "type": "uint256" }], "name": "StakeWithdrawn", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "bytes32", "name": "userOpHash", "type": "bytes32" }, { "indexed": true, "internalType": "address", "name": "sender", "type": "address" }, { "indexed": true, "internalType": "address", "name": "paymaster", "type": "address" }, { "indexed": false, "internalType": "uint256", "name": "nonce", "type": "uint256" }, { "indexed": false, "internalType": "bool", "name": "success", "type": "bool" }, { "indexed": false, "internalType": "uint256", "name": "actualGasCost", "type": "uint256" }, { "indexed": false, "internalType": "uint256", "name": "actualGasUsed", "type": "uint256" }], "name": "UserOperationEvent", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "bytes32", "name": "userOpHash", "type": "bytes32" }, { "indexed": true, "internalType": "address", "name": "sender", "type": "address" }, { "indexed": false, "internalType": "uint256", "name": "nonce", "type": "uint256" }, { "indexed": false, "internalType": "bytes", "name": "revertReason", "type": "bytes" }], "name": "UserOperationRevertReason", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "account", "type": "address" }, { "indexed": false, "internalType": "address", "name": "withdrawAddress", "type": "address" }, { "indexed": false, "internalType": "uint256", "name": "amount", "type": "uint256" }], "name": "Withdrawn", "type": "event" }, { "inputs": [], "name": "SIG_VALIDATION_FAILED", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "bytes", "name": "initCode", "type": "bytes" }, { "internalType": "address", "name": "sender", "type": "address" }, { "internalType": "bytes", "name": "paymasterAndData", "type": "bytes" }], "name": "_validateSenderAndPaymaster", "outputs": [], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "uint32", "name": "unstakeDelaySec", "type": "uint32" }], "name": "addStake", "outputs": [], "stateMutability": "payable", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "account", "type": "address" }], "name": "balanceOf", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "account", "type": "address" }], "name": "depositTo", "outputs": [], "stateMutability": "payable", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "", "type": "address" }], "name": "deposits", "outputs": [{ "internalType": "uint112", "name": "deposit", "type": "uint112" }, { "internalType": "bool", "name": "staked", "type": "bool" }, { "internalType": "uint112", "name": "stake", "type": "uint112" }, { "internalType": "uint32", "name": "unstakeDelaySec", "type": "uint32" }, { "internalType": "uint48", "name": "withdrawTime", "type": "uint48" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "account", "type": "address" }], "name": "getDepositInfo", "outputs": [{ "components": [{ "internalType": "uint112", "name": "deposit", "type": "uint112" }, { "internalType": "bool", "name": "staked", "type": "bool" }, { "internalType": "uint112", "name": "stake", "type": "uint112" }, { "internalType": "uint32", "name": "unstakeDelaySec", "type": "uint32" }, { "internalType": "uint48", "name": "withdrawTime", "type": "uint48" }], "internalType": "struct IStakeManager.DepositInfo", "name": "info", "type": "tuple" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "sender", "type": "address" }, { "internalType": "uint192", "name": "key", "type": "uint192" }], "name": "getNonce", "outputs": [{ "internalType": "uint256", "name": "nonce", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "bytes", "name": "initCode", "type": "bytes" }], "name": "getSenderAddress", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "components": [{ "internalType": "address", "name": "sender", "type": "address" }, { "internalType": "uint256", "name": "nonce", "type": "uint256" }, { "internalType": "bytes", "name": "initCode", "type": "bytes" }, { "internalType": "bytes", "name": "callData", "type": "bytes" }, { "internalType": "uint256", "name": "callGasLimit", "type": "uint256" }, { "internalType": "uint256", "name": "verificationGasLimit", "type": "uint256" }, { "internalType": "uint256", "name": "preVerificationGas", "type": "uint256" }, { "internalType": "uint256", "name": "maxFeePerGas", "type": "uint256" }, { "internalType": "uint256", "name": "maxPriorityFeePerGas", "type": "uint256" }, { "internalType": "bytes", "name": "paymasterAndData", "type": "bytes" }, { "internalType": "bytes", "name": "signature", "type": "bytes" }], "internalType": "struct UserOperation", "name": "userOp", "type": "tuple" }], "name": "getUserOpHash", "outputs": [{ "internalType": "bytes32", "name": "", "type": "bytes32" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "components": [{ "components": [{ "internalType": "address", "name": "sender", "type": "address" }, { "internalType": "uint256", "name": "nonce", "type": "uint256" }, { "internalType": "bytes", "name": "initCode", "type": "bytes" }, { "internalType": "bytes", "name": "callData", "type": "bytes" }, { "internalType": "uint256", "name": "callGasLimit", "type": "uint256" }, { "internalType": "uint256", "name": "verificationGasLimit", "type": "uint256" }, { "internalType": "uint256", "name": "preVerificationGas", "type": "uint256" }, { "internalType": "uint256", "name": "maxFeePerGas", "type": "uint256" }, { "internalType": "uint256", "name": "maxPriorityFeePerGas", "type": "uint256" }, { "internalType": "bytes", "name": "paymasterAndData", "type": "bytes" }, { "internalType": "bytes", "name": "signature", "type": "bytes" }], "internalType": "struct UserOperation[]", "name": "userOps", "type": "tuple[]" }, { "internalType": "contract IAggregator", "name": "aggregator", "type": "address" }, { "internalType": "bytes", "name": "signature", "type": "bytes" }], "internalType": "struct IEntryPoint.UserOpsPerAggregator[]", "name": "opsPerAggregator", "type": "tuple[]" }, { "internalType": "address payable", "name": "beneficiary", "type": "address" }], "name": "handleAggregatedOps", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "components": [{ "internalType": "address", "name": "sender", "type": "address" }, { "internalType": "uint256", "name": "nonce", "type": "uint256" }, { "internalType": "bytes", "name": "initCode", "type": "bytes" }, { "internalType": "bytes", "name": "callData", "type": "bytes" }, { "internalType": "uint256", "name": "callGasLimit", "type": "uint256" }, { "internalType": "uint256", "name": "verificationGasLimit", "type": "uint256" }, { "internalType": "uint256", "name": "preVerificationGas", "type": "uint256" }, { "internalType": "uint256", "name": "maxFeePerGas", "type": "uint256" }, { "internalType": "uint256", "name": "maxPriorityFeePerGas", "type": "uint256" }, { "internalType": "bytes", "name": "paymasterAndData", "type": "bytes" }, { "internalType": "bytes", "name": "signature", "type": "bytes" }], "internalType": "struct UserOperation[]", "name": "ops", "type": "tuple[]" }, { "internalType": "address payable", "name": "beneficiary", "type": "address" }], "name": "handleOps", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "uint192", "name": "key", "type": "uint192" }], "name": "incrementNonce", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "bytes", "name": "callData", "type": "bytes" }, { "components": [{ "components": [{ "internalType": "address", "name": "sender", "type": "address" }, { "internalType": "uint256", "name": "nonce", "type": "uint256" }, { "internalType": "uint256", "name": "callGasLimit", "type": "uint256" }, { "internalType": "uint256", "name": "verificationGasLimit", "type": "uint256" }, { "internalType": "uint256", "name": "preVerificationGas", "type": "uint256" }, { "internalType": "address", "name": "paymaster", "type": "address" }, { "internalType": "uint256", "name": "maxFeePerGas", "type": "uint256" }, { "internalType": "uint256", "name": "maxPriorityFeePerGas", "type": "uint256" }], "internalType": "struct EntryPoint.MemoryUserOp", "name": "mUserOp", "type": "tuple" }, { "internalType": "bytes32", "name": "userOpHash", "type": "bytes32" }, { "internalType": "uint256", "name": "prefund", "type": "uint256" }, { "internalType": "uint256", "name": "contextOffset", "type": "uint256" }, { "internalType": "uint256", "name": "preOpGas", "type": "uint256" }], "internalType": "struct EntryPoint.UserOpInfo", "name": "opInfo", "type": "tuple" }, { "internalType": "bytes", "name": "context", "type": "bytes" }], "name": "innerHandleOp", "outputs": [{ "internalType": "uint256", "name": "actualGasCost", "type": "uint256" }], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "", "type": "address" }, { "internalType": "uint192", "name": "", "type": "uint192" }], "name": "nonceSequenceNumber", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "components": [{ "internalType": "address", "name": "sender", "type": "address" }, { "internalType": "uint256", "name": "nonce", "type": "uint256" }, { "internalType": "bytes", "name": "initCode", "type": "bytes" }, { "internalType": "bytes", "name": "callData", "type": "bytes" }, { "internalType": "uint256", "name": "callGasLimit", "type": "uint256" }, { "internalType": "uint256", "name": "verificationGasLimit", "type": "uint256" }, { "internalType": "uint256", "name": "preVerificationGas", "type": "uint256" }, { "internalType": "uint256", "name": "maxFeePerGas", "type": "uint256" }, { "internalType": "uint256", "name": "maxPriorityFeePerGas", "type": "uint256" }, { "internalType": "bytes", "name": "paymasterAndData", "type": "bytes" }, { "internalType": "bytes", "name": "signature", "type": "bytes" }], "internalType": "struct UserOperation", "name": "op", "type": "tuple" }, { "internalType": "address", "name": "target", "type": "address" }, { "internalType": "bytes", "name": "targetCallData", "type": "bytes" }], "name": "simulateHandleOp", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "components": [{ "internalType": "address", "name": "sender", "type": "address" }, { "internalType": "uint256", "name": "nonce", "type": "uint256" }, { "internalType": "bytes", "name": "initCode", "type": "bytes" }, { "internalType": "bytes", "name": "callData", "type": "bytes" }, { "internalType": "uint256", "name": "callGasLimit", "type": "uint256" }, { "internalType": "uint256", "name": "verificationGasLimit", "type": "uint256" }, { "internalType": "uint256", "name": "preVerificationGas", "type": "uint256" }, { "internalType": "uint256", "name": "maxFeePerGas", "type": "uint256" }, { "internalType": "uint256", "name": "maxPriorityFeePerGas", "type": "uint256" }, { "internalType": "bytes", "name": "paymasterAndData", "type": "bytes" }, { "internalType": "bytes", "name": "signature", "type": "bytes" }], "internalType": "struct UserOperation", "name": "userOp", "type": "tuple" }], "name": "simulateValidation", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [], "name": "unlockStake", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "address payable", "name": "withdrawAddress", "type": "address" }], "name": "withdrawStake", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "address payable", "name": "withdrawAddress", "type": "address" }, { "internalType": "uint256", "name": "withdrawAmount", "type": "uint256" }], "name": "withdrawTo", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "stateMutability": "payable", "type": "receive" }],
+    AccountFactory: <TAbiItem[]>[{ "inputs": [{ "internalType": "contract IEntryPoint", "name": "_entryPoint", "type": "address" }], "stateMutability": "nonpayable", "type": "constructor" }, { "inputs": [], "name": "accountImplementation", "outputs": [{ "internalType": "contract SimpleAccount", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "owner", "type": "address" }, { "internalType": "uint256", "name": "salt", "type": "uint256" }], "name": "createAccount", "outputs": [{ "internalType": "contract SimpleAccount", "name": "ret", "type": "address" }], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "owner", "type": "address" }, { "internalType": "uint256", "name": "salt", "type": "uint256" }], "name": "getAddress", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" }],
+    Account: <TAbiItem[]>[{ "inputs": [{ "internalType": "contract IEntryPoint", "name": "anEntryPoint", "type": "address" }], "stateMutability": "nonpayable", "type": "constructor" }, { "anonymous": false, "inputs": [{ "indexed": false, "internalType": "address", "name": "previousAdmin", "type": "address" }, { "indexed": false, "internalType": "address", "name": "newAdmin", "type": "address" }], "name": "AdminChanged", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "beacon", "type": "address" }], "name": "BeaconUpgraded", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": false, "internalType": "uint8", "name": "version", "type": "uint8" }], "name": "Initialized", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "contract IEntryPoint", "name": "entryPoint", "type": "address" }, { "indexed": true, "internalType": "address", "name": "owner", "type": "address" }], "name": "SimpleAccountInitialized", "type": "event" }, { "anonymous": false, "inputs": [{ "indexed": true, "internalType": "address", "name": "implementation", "type": "address" }], "name": "Upgraded", "type": "event" }, { "inputs": [], "name": "addDeposit", "outputs": [], "stateMutability": "payable", "type": "function" }, { "inputs": [], "name": "entryPoint", "outputs": [{ "internalType": "contract IEntryPoint", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "dest", "type": "address" }, { "internalType": "uint256", "name": "value", "type": "uint256" }, { "internalType": "bytes", "name": "func", "type": "bytes" }], "name": "execute", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "address[]", "name": "dest", "type": "address[]" }, { "internalType": "bytes[]", "name": "func", "type": "bytes[]" }], "name": "executeBatch", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [], "name": "getDeposit", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "getNonce", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "anOwner", "type": "address" }], "name": "initialize", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "", "type": "address" }, { "internalType": "address", "name": "", "type": "address" }, { "internalType": "uint256[]", "name": "", "type": "uint256[]" }, { "internalType": "uint256[]", "name": "", "type": "uint256[]" }, { "internalType": "bytes", "name": "", "type": "bytes" }], "name": "onERC1155BatchReceived", "outputs": [{ "internalType": "bytes4", "name": "", "type": "bytes4" }], "stateMutability": "pure", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "", "type": "address" }, { "internalType": "address", "name": "", "type": "address" }, { "internalType": "uint256", "name": "", "type": "uint256" }, { "internalType": "uint256", "name": "", "type": "uint256" }, { "internalType": "bytes", "name": "", "type": "bytes" }], "name": "onERC1155Received", "outputs": [{ "internalType": "bytes4", "name": "", "type": "bytes4" }], "stateMutability": "pure", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "", "type": "address" }, { "internalType": "address", "name": "", "type": "address" }, { "internalType": "uint256", "name": "", "type": "uint256" }, { "internalType": "bytes", "name": "", "type": "bytes" }], "name": "onERC721Received", "outputs": [{ "internalType": "bytes4", "name": "", "type": "bytes4" }], "stateMutability": "pure", "type": "function" }, { "inputs": [], "name": "owner", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" }, { "inputs": [], "name": "proxiableUUID", "outputs": [{ "internalType": "bytes32", "name": "", "type": "bytes32" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "bytes4", "name": "interfaceId", "type": "bytes4" }], "name": "supportsInterface", "outputs": [{ "internalType": "bool", "name": "", "type": "bool" }], "stateMutability": "view", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "", "type": "address" }, { "internalType": "address", "name": "", "type": "address" }, { "internalType": "address", "name": "", "type": "address" }, { "internalType": "uint256", "name": "", "type": "uint256" }, { "internalType": "bytes", "name": "", "type": "bytes" }, { "internalType": "bytes", "name": "", "type": "bytes" }], "name": "tokensReceived", "outputs": [], "stateMutability": "pure", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "newImplementation", "type": "address" }], "name": "upgradeTo", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "address", "name": "newImplementation", "type": "address" }, { "internalType": "bytes", "name": "data", "type": "bytes" }], "name": "upgradeToAndCall", "outputs": [], "stateMutability": "payable", "type": "function" }, { "inputs": [{ "components": [{ "internalType": "address", "name": "sender", "type": "address" }, { "internalType": "uint256", "name": "nonce", "type": "uint256" }, { "internalType": "bytes", "name": "initCode", "type": "bytes" }, { "internalType": "bytes", "name": "callData", "type": "bytes" }, { "internalType": "uint256", "name": "callGasLimit", "type": "uint256" }, { "internalType": "uint256", "name": "verificationGasLimit", "type": "uint256" }, { "internalType": "uint256", "name": "preVerificationGas", "type": "uint256" }, { "internalType": "uint256", "name": "maxFeePerGas", "type": "uint256" }, { "internalType": "uint256", "name": "maxPriorityFeePerGas", "type": "uint256" }, { "internalType": "bytes", "name": "paymasterAndData", "type": "bytes" }, { "internalType": "bytes", "name": "signature", "type": "bytes" }], "internalType": "struct UserOperation", "name": "userOp", "type": "tuple" }, { "internalType": "bytes32", "name": "userOpHash", "type": "bytes32" }, { "internalType": "uint256", "name": "missingAccountFunds", "type": "uint256" }], "name": "validateUserOp", "outputs": [{ "internalType": "uint256", "name": "validationData", "type": "uint256" }], "stateMutability": "nonpayable", "type": "function" }, { "inputs": [{ "internalType": "address payable", "name": "withdrawAddress", "type": "address" }, { "internalType": "uint256", "name": "amount", "type": "uint256" }], "name": "withdrawDepositTo", "outputs": [], "stateMutability": "nonpayable", "type": "function" }, { "stateMutability": "payable", "type": "receive" }]
+};

package/src/erc4337/models/IErc4337Info.ts

@@ -0,0 +1,8 @@
+import { TAddress } from '@dequanto/models/TAddress'
+
+export interface IErc4337Info {
+    addresses: {
+        entryPoint: TAddress
+        accountFactory: TAddress
+    }
+}

package/src/erc4337/models/UserOperation.ts

@@ -0,0 +1,18 @@
+import { EntryPoint } from '@dequanto-contracts/erc4337/EntryPoint/EntryPoint';
+import { $address } from '@dequanto/utils/$address';
+
+export type UserOperation = Parameters<EntryPoint['handleOps']>[1][0];
+
+export const UserOperationDefaults = <UserOperation> {
+    sender: $address.ZERO,
+    nonce: 0n,
+    initCode: '0x',
+    callData: '0x',
+    callGasLimit: 0n,
+    verificationGasLimit: 150000n, // default verification gas. will add create2 cost (3200+200*length) if initCode exists
+    preVerificationGas: 21000n, // should also cover calldata cost.
+    maxFeePerGas: 0n,
+    maxPriorityFeePerGas: 0n,
+    paymasterAndData: '0x',
+    signature: '0x'
+};

package/src/erc4337/utils/$erc4337.ts

@@ -0,0 +1,31 @@
+import { $contract } from '@dequanto/utils/$contract';
+import { UserOperation } from '../models/UserOperation';
+import { $abiUtils } from '@dequanto/utils/$abiUtils';
+import { TAddress } from '@dequanto/models/TAddress';
+
+export namespace $erc4337 {
+    export function hash(userOp: UserOperation, entryPointAddress: TAddress, chainId: number) {
+
+        let packed = $abiUtils.encode([
+            ['address', userOp.sender],
+            ['uint256', userOp.nonce],
+            ['bytes32', $contract.keccak256(userOp.initCode)],
+            ['bytes32', $contract.keccak256(userOp.callData)],
+            ['uint256', userOp.callGasLimit],
+            ['uint256', userOp.verificationGasLimit],
+            ['uint256', userOp.preVerificationGas],
+            ['uint256', userOp.maxFeePerGas],
+            ['uint256', userOp.maxPriorityFeePerGas],
+            ['bytes32', $contract.keccak256(userOp.paymasterAndData)],
+        ]);
+
+        let userOpHash = $contract.keccak256(packed);
+
+        let str = $abiUtils.encode([
+            ['bytes32', userOpHash],
+            ['address', entryPointAddress ],
+            ['uint256', chainId ]
+        ]);
+        return $contract.keccak256(str);
+    }
+}

package/src/evm/EvmBytecode.ts

@@ -0,0 +1,298 @@
+import alot from 'alot';
+import type { TAbiItem } from '@dequanto/types/TAbi';
+import { OpcodesInfo } from './OpcodesInfo';
+import { JsonObjectStore } from '@dequanto/json/JsonObjectStore';
+import { $path } from '@dequanto/utils/$path';
+import { $abiParser } from '@dequanto/utils/$abiParser';
+import Opcode from './interfaces/IOpcode';
+import IMemory from './interfaces/IMemory';
+import IJumps from './interfaces/IJumps';
+import Stack from './Stack';
+import IStorage from './interfaces/IStorage';
+import { OpcodesWalker } from './OpcodesWalker';
+import { $logger } from '@dequanto/utils/$logger';
+import IOpcode from './interfaces/IOpcode';
+import { $abiUtils } from '@dequanto/utils/$abiUtils';
+import { $bytecode } from './utils/$bytecode';
+import { $buffer } from '@dequanto/utils/$buffer';
+import { $array } from '@dequanto/utils/$array';
+import { TEth } from '@dequanto/models/TEth';
+import opcodeFunctions from './utils/opcodes';
+
+/**
+ * Functions to SKIP
+ * 08c379a0 - Error(string)
+ * 4e487b71 - Panic(uint256)
+ * ffffffff -
+ */
+
+
+class Stores {
+    functions = new JsonObjectStore<Record<string, string>>({
+        path: $path.resolve(`/data/evm/functionHashes.json`)
+    })
+    functionHashes: Record<string, string>;
+
+    events = new JsonObjectStore<Record<string, string>>({
+        path: $path.resolve(`/data/evm/eventHashes.json`)
+    })
+    eventHashes: Record<string, string>;
+
+    async readAll () {
+        let [ functions, events ] = await Promise.all([
+            this.functions.get(),
+            this.events.get(),
+        ]);
+        this.functionHashes = functions;
+        this.eventHashes = events;
+    }
+}
+
+
+export class EvmBytecode {
+    pc: number = 0;
+    stack = new Stack();
+    memory: IMemory = {}
+
+    instructions: any = [];
+    storage: IStorage = {};
+    jumps: IJumps = {};
+
+    mappings: any = {};
+    layer: number = 0
+    halted: boolean = false;
+    functions: any = {};
+    variables: any = {};
+    events: any = {};
+    gasUsed: number = 0;
+
+    private opcodes: Opcode[] = [];
+    private code: Uint8Array;
+
+    public store = new Stores();
+
+    constructor(code: TEth.Hex | Uint8Array, opts?: { withConstructorCode?: boolean }) {
+        if (code instanceof Uint8Array) {
+            this.code = code;
+        } else {
+            if (opts?.withConstructorCode !== true) {
+                // remove the constructor code, leave the runtime bytecode only;
+                code = $bytecode.trimConstructorCode(code);
+            }
+            this.code = $buffer.fromHex(code.replace('0x', ''));
+        }
+    }
+
+    public getOpcodes(): Opcode[] {
+        if (this.opcodes.length === 0) {
+            for (let index = 0; index < this.code.length; index++) {
+                const currentOp = OpcodesInfo.get(this.code[index], true);
+                currentOp.pc = index;
+                this.opcodes.push(currentOp);
+                if (currentOp.name.startsWith('PUSH')) {
+                    const pushDataLength = this.code[index] - 0x5f;
+                    const pushData = this.code.slice(index + 1, index + pushDataLength + 1);
+                    currentOp.pushData = pushData;
+                    index += pushDataLength;
+                }
+            }
+        }
+        return this.opcodes;
+    }
+
+    public getInstructions () {
+        if (this.instructions.length === 0) {
+            const opcodes = this.getOpcodes();
+            for (this.pc; this.pc < opcodes.length && !this.halted; this.pc++) {
+                const opcode = opcodes[this.pc];
+                this.gasUsed += opcode.fee;
+                if (opcode.name in opcodeFunctions === false) {
+                    throw new Error('Unknown OPCODE: ' + opcode.name);
+                }
+                opcodeFunctions[opcode.name](opcode, this);
+            }
+        }
+        return this.instructions;
+    }
+
+    async getAbi(opts?: { parseStateMutability?: boolean }): Promise<TAbiItem[]> {
+        await this.prepare();
+
+        let [functions, events] = await Promise.all([
+            this.getFunctions(),
+            this.getEvents(),
+        ]);
+
+        let fnsAbi = await alot(functions).mapAsync(async entry => {
+            let str = entry.name ?? `_${entry.signature}()`;
+            let abi = $abiParser.parseMethod(str);
+
+            try {
+                if (opts?.parseStateMutability !== false) {
+                    let { opcodes } = this.getMethodOpcodes({ sig: entry.signature })
+                    let isReadOnly = $opcodes.isReadOnly(opcodes);
+                    if (isReadOnly) {
+                        abi.stateMutability = 'view';
+                    }
+                }
+            } catch (error) {
+                $logger.error(`Getting method ${str} opcodes failed: ${error.message}`);
+            }
+            return abi;
+        }).toArrayAsync();
+        let eventsAbi = events.map(entry => {
+            if (entry.name == null) {
+                return null;
+            }
+            let str = `event ${entry.name}`;
+            return $abiParser.parseMethod(str);
+        }).filter(Boolean);
+        return [
+            ...fnsAbi,
+            ...eventsAbi,
+        ];
+    }
+
+    async getFunctions(): Promise<{ signature, name }[]> {
+        let SKIP = [
+            null,
+            '08c379a0', // Error(string)
+            '4e487b71', // Panic(uint256)
+            'ffffffff'
+        ];
+        let opcodes = this.getOpcodes();
+
+        /** Select PUSH4 opcodes in first calldataload block to filter any other method calls within the bytecode */
+        let opcodeCalldataLoadIdx = $array.findIndex(opcodes, x => x.name === 'CALLDATALOAD');
+        let opcodeCalldataLoad = opcodes[opcodeCalldataLoadIdx];
+        let jumpDestIdx = $array.findIndex(opcodes, x => x?.name === 'JUMPDEST', opcodeCalldataLoadIdx);
+        let jumpDest = opcodes[jumpDestIdx];
+        let rangeStart = opcodeCalldataLoadIdx === -1 ? 0 : opcodeCalldataLoad.pc;
+        let rangeEnd = opcodeCalldataLoadIdx === -1 ? Infinity : (jumpDest?.pc ?? Infinity);
+
+        let hashes = opcodes
+            .filter(opcode => opcode.name === 'PUSH4')
+            .map((opcode, i) => {
+                if (opcode.pc < rangeStart || opcode.pc > rangeEnd) {
+                    return null;
+                }
+                return opcode.pushData?.toString('hex') ?? null
+            })
+            .filter(x => SKIP.includes(x) === false);
+
+        let fns = await this.resolveFunctions(hashes);
+        return fns;
+    }
+
+    async checkInterfaceOf (iface: (TAbiItem | string)[]): Promise<{ ok: boolean, missing?: string }> {
+        if (iface == null || iface.length === 0) {
+            return { ok: false };
+        }
+        let methods = await this.getFunctions();
+        for (let item of iface) {
+            if (typeof item === 'string') {
+                item = $abiParser.parseMethod(item);
+            }
+            if (item.type !== 'function') {
+                continue;
+            }
+            let inAbi = methods.some(x => x.signature === $abiUtils.getMethodSignature(item));
+            if (inAbi === false) {
+                return { ok: false, missing: item.name };
+            }
+        }
+        return { ok: true };
+    }
+
+    private async resolveFunctions(hashes: string[]) {
+        let fns = await this.store.functions.get();
+        return alot(hashes)
+            .distinct()
+            .map(hash => {
+                return {
+                    signature: `0x` + hash,
+                    name: fns[hash] ?? null
+                };
+            })
+            .toArray();
+    }
+
+    async getEvents(): Promise<{ signature, name }[]> {
+        let hashes = this.getOpcodes()
+            .filter(opcode => opcode.name === 'PUSH32')
+            .map(opcode => opcode.pushData?.toString('hex') ?? null)
+            .filter(x => x != null);
+
+        let events = await this.resolveEvents(hashes);
+        return events;
+    }
+
+    clone(): EvmBytecode {
+        const clone = new EvmBytecode(this.code);
+        clone.pc = this.pc;
+        clone.opcodes = this.opcodes;
+        clone.stack = this.stack.clone();
+        clone.memory = { ...this.memory };
+        clone.storage = this.storage;
+        clone.jumps = { ...this.jumps };
+        clone.mappings = this.mappings;
+        clone.layer = this.layer + 1;
+        clone.functions = this.functions;
+        clone.variables = this.variables;
+        clone.events = this.events;
+        clone.gasUsed = this.gasUsed;
+        clone.store = this.store;
+        return clone;
+    }
+
+
+    async prepare (): Promise<this> {
+        await this.store.readAll();
+        return this;
+    }
+
+    getMethodOpcodes (abi: string)
+    getMethodOpcodes (opts: { sig: string })
+    getMethodOpcodes (mix: string | { sig: string }): { opcodes: IOpcode[], exit } {
+        this.stack.reset();
+
+        let opcodes = this.getOpcodes();
+        let walker = new OpcodesWalker(this, opcodes);
+        return walker.getMethodOpcodes(mix);
+    }
+
+    private async resolveEvents(hashes: string[]) {
+        let events = await this.store.events.get();
+        return alot(hashes)
+            .distinct()
+            .map(hash => {
+                return {
+                    signature: `0x` + hash,
+                    name: events[hash] ?? null
+                };
+            })
+            .toArray();
+    }
+
+}
+
+
+namespace $opcodes {
+    export function isReadOnly(opcodes: IOpcode[]) {
+        let writes = [
+            'SSTORE',
+            'LOG'
+        ];
+        let hasWrite = opcodes.some(opcode => writes.includes(opcode.name));
+        if (hasWrite) {
+            return false;
+        }
+
+        // Read methods usually have RETURN code
+        let hasStop = opcodes.some(opcode => 'STOP' === opcode.name);
+        if (hasStop) {
+            return false;
+        }
+        return true;
+    }
+}