near-safe 0.0.0 → 0.0.2

package/dist/cjs/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./tx-manager";
+export * from "./types";
+export * from "./util";

package/dist/cjs/lib/bundler.d.ts

@@ -0,0 +1,12 @@
+import { ethers } from "ethers";
+import { GasPrices, PaymasterData, UnsignedUserOperation, UserOperation, UserOperationReceipt } from "../types";
+export declare class Erc4337Bundler {
+    provider: ethers.JsonRpcProvider;
+    entryPointAddress: string;
+    constructor(bundlerUrl: string, entryPointAddress: string);
+    getPaymasterData(rawUserOp: UnsignedUserOperation, usePaymaster: boolean, safeNotDeployed: boolean): Promise<PaymasterData>;
+    sendUserOperation(userOp: UserOperation): Promise<string>;
+    getGasPrice(): Promise<GasPrices>;
+    _getUserOpReceiptInner(userOpHash: string): Promise<UserOperationReceipt | null>;
+    getUserOpReceipt(userOpHash: string): Promise<UserOperationReceipt>;
+}

package/dist/cjs/lib/near.d.ts

@@ -0,0 +1,3 @@
+import { ethers } from "ethers";
+import { NearEthAdapter } from "near-ca";
+export declare function getNearSignature(adapter: NearEthAdapter, hash: ethers.BytesLike): Promise<string>;

package/dist/cjs/lib/safe.d.ts

@@ -0,0 +1,24 @@
+import { ethers } from "ethers";
+import { GasPrice, PaymasterData, UnsignedUserOperation, UserOperation } from "../types";
+import { MetaTransaction } from "ethers-multisend";
+/**
+ * All contracts used in account creation & execution
+ */
+export declare class ContractSuite {
+    provider: ethers.JsonRpcProvider;
+    singleton: ethers.Contract;
+    proxyFactory: ethers.Contract;
+    m4337: ethers.Contract;
+    moduleSetup: ethers.Contract;
+    entryPoint: ethers.Contract;
+    constructor(provider: ethers.JsonRpcProvider, singleton: ethers.Contract, proxyFactory: ethers.Contract, m4337: ethers.Contract, moduleSetup: ethers.Contract, entryPoint: ethers.Contract);
+    static init(provider: ethers.JsonRpcProvider): Promise<ContractSuite>;
+    addressForSetup(setup: ethers.BytesLike, saltNonce?: string): Promise<string>;
+    getSetup(owners: string[]): Promise<string>;
+    getOpHash(unsignedUserOp: UserOperation, paymasterData: PaymasterData): Promise<string>;
+    factoryDataForSetup(safeNotDeployed: boolean, setup: string, safeSaltNonce: string): {
+        factory?: ethers.AddressLike;
+        factoryData?: string;
+    };
+    buildUserOp(txData: MetaTransaction, safeAddress: ethers.AddressLike, feeData: GasPrice, setup: string, safeNotDeployed: boolean, safeSaltNonce: string): Promise<UnsignedUserOperation>;
+}

package/dist/cjs/tx-manager.d.ts

@@ -0,0 +1,39 @@
+import { ethers } from "ethers";
+import { NearEthAdapter } from "near-ca";
+import { Erc4337Bundler } from "./lib/bundler";
+import { UserOperation, UserOperationReceipt, UserOptions } from "./types";
+import { MetaTransaction } from "ethers-multisend";
+import { ContractSuite } from "./lib/safe";
+import { Account } from "near-api-js";
+export declare class TransactionManager {
+    readonly provider: ethers.JsonRpcProvider;
+    readonly nearAdapter: NearEthAdapter;
+    private safePack;
+    private bundler;
+    private setup;
+    readonly safeAddress: string;
+    private safeSaltNonce;
+    private _safeNotDeployed;
+    constructor(provider: ethers.JsonRpcProvider, nearAdapter: NearEthAdapter, safePack: ContractSuite, bundler: Erc4337Bundler, setup: string, safeAddress: string, safeSaltNonce: string, safeNotDeployed: boolean);
+    static create(config: {
+        ethRpc: string;
+        erc4337BundlerUrl: string;
+        nearAccount: Account;
+        mpcContractId: string;
+        safeSaltNonce?: string;
+    }): Promise<TransactionManager>;
+    get safeNotDeployed(): boolean;
+    get nearEOA(): `0x${string}`;
+    getSafeBalance(): Promise<bigint>;
+    buildTransaction(args: {
+        transactions: MetaTransaction[];
+        options: UserOptions;
+    }): Promise<{
+        safeOpHash: string;
+        unsignedUserOp: UserOperation;
+    }>;
+    signTransaction(safeOpHash: string): Promise<string>;
+    executeTransaction(userOp: UserOperation): Promise<UserOperationReceipt>;
+    addOwnerTx(address: string): MetaTransaction;
+    safeSufficientlyFunded(transactions: MetaTransaction[], gasCost: bigint): Promise<boolean>;
+}

package/dist/cjs/types.d.ts

@@ -0,0 +1,85 @@
+import { ethers } from "ethers";
+export interface UnsignedUserOperation {
+    sender: ethers.AddressLike;
+    nonce: string;
+    factory?: ethers.AddressLike;
+    factoryData?: ethers.BytesLike;
+    callData: string;
+    maxPriorityFeePerGas: string;
+    maxFeePerGas: string;
+}
+/**
+ * Supported Representation of UserOperation for EntryPoint v0.7
+ */
+export interface UserOperation extends UnsignedUserOperation {
+    verificationGasLimit: string;
+    callGasLimit: string;
+    preVerificationGas: string;
+    signature?: string;
+}
+export interface PaymasterData {
+    paymaster?: string;
+    paymasterData?: string;
+    paymasterVerificationGasLimit?: string;
+    paymasterPostOpGasLimit?: string;
+    verificationGasLimit: string;
+    callGasLimit: string;
+    preVerificationGas: string;
+}
+export interface UserOptions {
+    usePaymaster: boolean;
+    safeSaltNonce: string;
+    mpcContractId: string;
+    recoveryAddress?: string;
+}
+export type TStatus = "success" | "reverted";
+export type Address = ethers.AddressLike;
+export type Hex = `0x${string}`;
+export type Hash = `0x${string}`;
+interface Log {
+    logIndex: string;
+    transactionIndex: string;
+    transactionHash: string;
+    blockHash: string;
+    blockNumber: string;
+    address: string;
+    data: string;
+    topics: string[];
+}
+interface Receipt {
+    transactionHash: Hex;
+    transactionIndex: bigint;
+    blockHash: Hash;
+    blockNumber: bigint;
+    from: Address;
+    to: Address | null;
+    cumulativeGasUsed: bigint;
+    status: TStatus;
+    gasUsed: bigint;
+    contractAddress: Address | null;
+    logsBloom: Hex;
+    effectiveGasPrice: bigint;
+}
+export type UserOperationReceipt = {
+    userOpHash: Hash;
+    entryPoint: Address;
+    sender: Address;
+    nonce: bigint;
+    paymaster?: Address;
+    actualGasUsed: bigint;
+    actualGasCost: bigint;
+    success: boolean;
+    reason?: string;
+    receipt: Receipt;
+    logs: Log[];
+};
+export interface GasPrices {
+    slow: GasPrice;
+    standard: GasPrice;
+    fast: GasPrice;
+}
+export interface GasPrice {
+    maxFeePerGas: Hex;
+    maxPriorityFeePerGas: Hex;
+}
+export {};

package/dist/cjs/util.d.ts

@@ -0,0 +1,8 @@
+import { ethers } from "ethers";
+import { PaymasterData } from "./types";
+import { MetaTransaction } from "ethers-multisend";
+export declare const PLACEHOLDER_SIG: string;
+export declare const packGas: (hi: ethers.BigNumberish, lo: ethers.BigNumberish) => string;
+export declare function packSignature(signature: string, validFrom?: number, validTo?: number): string;
+export declare function packPaymasterData(data: PaymasterData): string;
+export declare function containsValue(transactions: MetaTransaction[]): boolean;

package/package.json

@@ -1,9 +1,29 @@
 {
   "name": "near-safe",
-  "version": "0.0.0",
+  "version": "0.0.2",
   "license": "MIT",
+  "description": "An SDK for controlling Ethereum Smart Accounts via ERC4337 from a Near Account.",
+  "author": "bh2smith",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mintbase/near-safe.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mintbase/near-safe/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "near",
+    "ethereum",
+    "safe",
+    "account-abstraction",
+    "erc4337",
+    "chain-signatures"
+  ],
   "main": "dist/cjs/index.js",
-  "module": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
   "types": "dist/esm/index.d.ts",
   "files": [
     "dist/**/*"