@dynamic-labs/utils 1.0.0-alpha.1 → 1.0.0-alpha.10

package/CHANGELOG.md

@@ -1,4 +1,132 @@
 
+## [1.0.0-alpha.10](https://github.com/dynamic-labs/DynamicAuth/compare/v1.0.0-alpha.9...v1.0.0-alpha.10) (2023-12-08)
+
+
+### Bug Fixes
+
+* allow transaction error to read from viem error ([#4101](https://github.com/dynamic-labs/DynamicAuth/issues/4101)) ([0f46cbe](https://github.com/dynamic-labs/DynamicAuth/commit/0f46cbea1eb260c2efdeee9b62f669fb3cf4ab93))
+* trigger claim flow for unclaimed embedded smart contract wallet signer ([#4108](https://github.com/dynamic-labs/DynamicAuth/issues/4108)) ([37c9013](https://github.com/dynamic-labs/DynamicAuth/commit/37c9013109f2d6a37bde041da9072c5f5fa2df67))
+* WalletConnect v2 connector with non active chains ([#4085](https://github.com/dynamic-labs/DynamicAuth/issues/4085)) ([f69cbe9](https://github.com/dynamic-labs/DynamicAuth/commit/f69cbe96012563f71e89939c96f2a46926e7b394))
+
+## [1.0.0-alpha.9](https://github.com/dynamic-labs/DynamicAuth/compare/v1.0.0-alpha.8...v1.0.0-alpha.9) (2023-12-07)
+
+
+### ⚠ BREAKING CHANGES
+
+* how to migrate
+Whenever you would use the property wallets from the object returned by useDynamicContext, you must now rename it to walletConnectorOptions.
+
+### Features
+
+* add support for eip6963 ([#4064](https://github.com/dynamic-labs/DynamicAuth/issues/4064)) ([3f8cf0e](https://github.com/dynamic-labs/DynamicAuth/commit/3f8cf0e4250945f3a331f701d491a308fab5f7b8))
+* allow AA wallets to access owner features ([#4079](https://github.com/dynamic-labs/DynamicAuth/issues/4079)) ([9efc2be](https://github.com/dynamic-labs/DynamicAuth/commit/9efc2bee87ec9193c3682863d72024b3586de724))
+* introduce UserWalletsContext ([#4083](https://github.com/dynamic-labs/DynamicAuth/issues/4083)) ([b9ca7f6](https://github.com/dynamic-labs/DynamicAuth/commit/b9ca7f6b0aff4b3992325b70cc9a903ece445c7f))
+
+
+### Bug Fixes
+
+* ensure zero dev provider will receive a signer ([#4084](https://github.com/dynamic-labs/DynamicAuth/issues/4084)) ([f02a540](https://github.com/dynamic-labs/DynamicAuth/commit/f02a54036d39bfc5fb0c262f292acf914e4bd653))
+* render recovery section only when turnkey provider is enabled ([#4093](https://github.com/dynamic-labs/DynamicAuth/issues/4093)) ([5f29bd2](https://github.com/dynamic-labs/DynamicAuth/commit/5f29bd23ccca2e307822377be28396edc7ab1fda))
+* reset selected social provider on logout ([#4078](https://github.com/dynamic-labs/DynamicAuth/issues/4078)) ([85dc611](https://github.com/dynamic-labs/DynamicAuth/commit/85dc611d9c0e733bdb9d316b008bdaa35bcc2a91))
+
+
+* rename wallets > walletConnectorOptions ([#4086](https://github.com/dynamic-labs/DynamicAuth/issues/4086)) ([10a7795](https://github.com/dynamic-labs/DynamicAuth/commit/10a779567e751469a667095726da52d78facbd57))
+
+## [1.0.0-alpha.8](https://github.com/dynamic-labs/DynamicAuth/compare/v1.0.0-alpha.7...v1.0.0-alpha.8) (2023-12-05)
+
+
+### ⚠ BREAKING CHANGES
+
+* rename EthereumSmartWalletConnectors to ZeroDevSmartWalletConnectors (#4067)
+
+
+### Features
+
+* add support for pregenerated wallets + securing them ([#3968](https://github.com/dynamic-labs/DynamicAuth/issues/3968)) ([8212b76](https://github.com/dynamic-labs/DynamicAuth/commit/8212b760ba199bd989e0ba2ad3caf97590db4861))
+
+## [1.0.0-alpha.7](https://github.com/dynamic-labs/DynamicAuth/compare/v1.0.0-alpha.6...v1.0.0-alpha.7) (2023-12-05)
+
+
+### Features
+
+* add support for Turnkey HD wallets and backwards compatiblity for private key wallets ([#4011](https://github.com/dynamic-labs/DynamicAuth/issues/4011)) ([75c5258](https://github.com/dynamic-labs/DynamicAuth/commit/75c5258da494d5d4dfa8b96655303dd9645f2269))
+
+
+### Bug Fixes
+
+* add close button to wallets list ([#4036](https://github.com/dynamic-labs/DynamicAuth/issues/4036)) ([a2b988b](https://github.com/dynamic-labs/DynamicAuth/commit/a2b988bdfc662af6f85d37a79ed6666c483aa447))
+* add support for embedded wallets in connect-only ([#4041](https://github.com/dynamic-labs/DynamicAuth/issues/4041)) ([ceea635](https://github.com/dynamic-labs/DynamicAuth/commit/ceea635b69e2a0c2636b47fbd30639d69dba7a1c))
+* embedded wallet invalid stored chain breaking network picker ([#4050](https://github.com/dynamic-labs/DynamicAuth/issues/4050)) ([2e2384b](https://github.com/dynamic-labs/DynamicAuth/commit/2e2384ba37407d9164cce47e23f5d5f469f7e062))
+* handle insufficient funds from AA provider ([#4027](https://github.com/dynamic-labs/DynamicAuth/issues/4027)) ([6b9cc88](https://github.com/dynamic-labs/DynamicAuth/commit/6b9cc886f4f2590094bd50aba195c07a5532dfa4))
+* prevent double logout caused by wagmi sync ([#4048](https://github.com/dynamic-labs/DynamicAuth/issues/4048)) ([c66c81c](https://github.com/dynamic-labs/DynamicAuth/commit/c66c81c80839aa9ce1cfae76f4afce12e34f3513))
+* properly detect network switch for secondary wallets ([#4038](https://github.com/dynamic-labs/DynamicAuth/issues/4038)) ([f87174d](https://github.com/dynamic-labs/DynamicAuth/commit/f87174de0892dd057401eaf3c0bc68d974add0fc))
+* **use-wallets-connected-state:** update state on wallet id change ([#4045](https://github.com/dynamic-labs/DynamicAuth/issues/4045)) ([ca3a835](https://github.com/dynamic-labs/DynamicAuth/commit/ca3a8359eae386bffa758ed646ac14af8360a7f8))
+* user should be able to see the full passkey name on management view ([#4043](https://github.com/dynamic-labs/DynamicAuth/issues/4043)) ([7bc1b70](https://github.com/dynamic-labs/DynamicAuth/commit/7bc1b7043cbc9f0e21df78a57efc3e6938a99db2))
+* users should be able to easily find passkey recovery ([#4058](https://github.com/dynamic-labs/DynamicAuth/issues/4058)) ([0202ae9](https://github.com/dynamic-labs/DynamicAuth/commit/0202ae98c96544dec5ac357dc77000996e32ad33))
+
+## [1.0.0-alpha.6](https://github.com/dynamic-labs/DynamicAuth/compare/v1.0.0-alpha.5...v1.0.0-alpha.6) (2023-11-29)
+
+
+### Bug Fixes
+
+* transaction layout show alert ([#4024](https://github.com/dynamic-labs/DynamicAuth/issues/4024)) ([52057f5](https://github.com/dynamic-labs/DynamicAuth/commit/52057f54ebc32464b2486a2328cb6310caf85208)), closes [#4020](https://github.com/dynamic-labs/DynamicAuth/issues/4020)
+
+## [1.0.0-alpha.5](https://github.com/dynamic-labs/DynamicAuth/compare/v1.0.0-alpha.4...v1.0.0-alpha.5) (2023-11-29)
+
+
+### Features
+
+* gracefully handle uknown wallet ([#3997](https://github.com/dynamic-labs/DynamicAuth/issues/3997)) ([ce7ff6a](https://github.com/dynamic-labs/DynamicAuth/commit/ce7ff6a50a8e8947050734b61587c8cadd041dbe))
+
+
+### Bug Fixes
+
+* remove total on sponsored transactions ([#4019](https://github.com/dynamic-labs/DynamicAuth/issues/4019)) ([d976678](https://github.com/dynamic-labs/DynamicAuth/commit/d9766787b29665fbcd7983c5d61c31a4d97c8257))
+* send balance align information ([#4020](https://github.com/dynamic-labs/DynamicAuth/issues/4020)) ([508dccf](https://github.com/dynamic-labs/DynamicAuth/commit/508dccfa2c6aeaed30616b6a41b30002cccb3b40))
+
+## [1.0.0-alpha.4](https://github.com/dynamic-labs/DynamicAuth/compare/v1.0.0-alpha.3...v1.0.0-alpha.4) (2023-11-28)
+
+
+### Bug Fixes
+
+* update zerodev provider initialization ([#4015](https://github.com/dynamic-labs/DynamicAuth/issues/4015)) ([8faca00](https://github.com/dynamic-labs/DynamicAuth/commit/8faca00d414677adc5fecde451ca01da53fe9641))
+
+## [1.0.0-alpha.3](https://github.com/dynamic-labs/DynamicAuth/compare/v1.0.0-alpha.2...v1.0.0-alpha.3) (2023-11-28)
+
+
+### Bug Fixes
+
+* fix solflare mobile wallet deep linking ([#3998](https://github.com/dynamic-labs/DynamicAuth/issues/3998)) ([10069ae](https://github.com/dynamic-labs/DynamicAuth/commit/10069ae9ed5d8e1978131f57c3e90680e85d2efb))
+* passkey error message when reaching limit of accounts ([#4010](https://github.com/dynamic-labs/DynamicAuth/issues/4010)) ([dabce3b](https://github.com/dynamic-labs/DynamicAuth/commit/dabce3b6ada4bac75903b43d5cb125cfd5619d18))
+
+## [1.0.0-alpha.2](https://github.com/dynamic-labs/DynamicAuth/compare/v1.0.0-alpha.1...v1.0.0-alpha.2) (2023-11-28)
+
+
+### ⚠ BREAKING CHANGES
+
+* rename walletsByChain to bridgeChains (#3954)
+
+### Features
+
+* passkey management and recovery ([#3911](https://github.com/dynamic-labs/DynamicAuth/issues/3911)) ([b692b3a](https://github.com/dynamic-labs/DynamicAuth/commit/b692b3a8697d0ffb441faae97e609b144965695d))
+
+
+### Bug Fixes
+
+* ensure all chain rpc providers are always assigned correctly ([#3981](https://github.com/dynamic-labs/DynamicAuth/issues/3981)) ([cd2e25c](https://github.com/dynamic-labs/DynamicAuth/commit/cd2e25c4eb39791866c1ea283d61fff388cce5df))
+* initialize selected chain with first evm network if no value in ls ([#3999](https://github.com/dynamic-labs/DynamicAuth/issues/3999)) ([bc9e43b](https://github.com/dynamic-labs/DynamicAuth/commit/bc9e43be9d33c75bb1236756589f63f17b230ab1))
+* nextjs issues to show transaction modals ([#3964](https://github.com/dynamic-labs/DynamicAuth/issues/3964)) ([9326ac4](https://github.com/dynamic-labs/DynamicAuth/commit/9326ac49394e067ce38b17faff08b4fabf91bb3f))
+* onEmbeddedWalletCreated not being called ([#3975](https://github.com/dynamic-labs/DynamicAuth/issues/3975)) ([035cebe](https://github.com/dynamic-labs/DynamicAuth/commit/035cebe02891048e62c66a7277ed7f43c27e559d))
+* return linked wallets even when there's no primary wallet ([#3965](https://github.com/dynamic-labs/DynamicAuth/issues/3965)) ([27705de](https://github.com/dynamic-labs/DynamicAuth/commit/27705de4ac7e1584efd1245bb9c6a818b1c20742))
+* transaction modal not throwing viem compatible exception ([#3971](https://github.com/dynamic-labs/DynamicAuth/issues/3971)) ([bedab0c](https://github.com/dynamic-labs/DynamicAuth/commit/bedab0c4448bcca5c3e696ceb276867ce55bbd85))
+* **zero-dev:** ensure the sign typed data is parsed for zero dev to handle ([#3974](https://github.com/dynamic-labs/DynamicAuth/issues/3974)) ([f517738](https://github.com/dynamic-labs/DynamicAuth/commit/f517738e1abc138f882525c128cd1ee5e88b9050))
+* zerodev sign message with ethers ([#3972](https://github.com/dynamic-labs/DynamicAuth/issues/3972)) ([5de3873](https://github.com/dynamic-labs/DynamicAuth/commit/5de3873daa9cbfeef6dd9123b7a319d8e6b412d5))
+* **zerodev:** ensure ECDSAProvider supports sendUserOperation ([#4003](https://github.com/dynamic-labs/DynamicAuth/issues/4003)) ([c8f5886](https://github.com/dynamic-labs/DynamicAuth/commit/c8f58868fcf6912fd11a92940369faf37e3fcdde))
+* **zerodev:** ensure transaction is sponsored before submission ([#3932](https://github.com/dynamic-labs/DynamicAuth/issues/3932)) ([74becb7](https://github.com/dynamic-labs/DynamicAuth/commit/74becb7ec2fd55f8b905a9c9f0bbba44a9d22513))
+
+
+* rename walletsByChain to bridgeChains ([#3954](https://github.com/dynamic-labs/DynamicAuth/issues/3954)) ([a91e8fe](https://github.com/dynamic-labs/DynamicAuth/commit/a91e8fe605694ccd8a00b71aa194c0c5191f156c))
+
 ## [1.0.0-alpha.1](https://github.com/dynamic-labs/DynamicAuth/compare/v1.0.0-alpha.0...v1.0.0-alpha.1) (2023-11-22)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/utils",
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.10",
   "repository": {
     "type": "git",
     "url": "https://github.com/dynamic-labs/DynamicAuth.git",
@@ -29,7 +29,7 @@
     "viem": "^1.5.3"
   },
   "dependencies": {
-    "@dynamic-labs/logger": "1.0.0-alpha.1",
-    "@dynamic-labs/types": "1.0.0-alpha.1"
+    "@dynamic-labs/logger": "1.0.0-alpha.10",
+    "@dynamic-labs/types": "1.0.0-alpha.10"
   }
 }

package/src/DeferredPromise/DeferredPromise.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * A DeferredPromise provides methods to manually resolve or reject a Promise.
+ * This is useful in scenarios where you need to resolve or reject a Promise
+ * outside of the executor function.
+ *
+ * @template T The type of the value with which the promise will be resolved.
+ */
+class DeferredPromise {
+    constructor() {
+        this.promise = new Promise((resolve, reject) => {
+            this.resolve = resolve;
+            this.reject = reject;
+        });
+    }
+}
+
+exports.DeferredPromise = DeferredPromise;

package/src/DeferredPromise/DeferredPromise.d.ts

@@ -0,0 +1,13 @@
+/**
+ * A DeferredPromise provides methods to manually resolve or reject a Promise.
+ * This is useful in scenarios where you need to resolve or reject a Promise
+ * outside of the executor function.
+ *
+ * @template T The type of the value with which the promise will be resolved.
+ */
+export declare class DeferredPromise<T> {
+    promise: Promise<T>;
+    resolve: (value: T | PromiseLike<T>) => void;
+    reject: (reason?: any) => void;
+    constructor();
+}

package/src/DeferredPromise/DeferredPromise.js

@@ -0,0 +1,17 @@
+/**
+ * A DeferredPromise provides methods to manually resolve or reject a Promise.
+ * This is useful in scenarios where you need to resolve or reject a Promise
+ * outside of the executor function.
+ *
+ * @template T The type of the value with which the promise will be resolved.
+ */
+class DeferredPromise {
+    constructor() {
+        this.promise = new Promise((resolve, reject) => {
+            this.resolve = resolve;
+            this.reject = reject;
+        });
+    }
+}
+
+export { DeferredPromise };

package/src/DeferredPromise/index.d.ts

@@ -0,0 +1 @@
+export { DeferredPromise } from './DeferredPromise';

package/src/errors/InsufficientFundsError.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var DynamicError = require('./DynamicError.cjs');
+
+class InsufficientFundsError extends DynamicError.DynamicError {
+    constructor() {
+        super(InsufficientFundsError.message);
+    }
+    static isInstance(err) {
+        var _a;
+        const error = ((_a = err === null || err === void 0 ? void 0 : err.walk) === null || _a === void 0 ? void 0 : _a.call(err)) || err;
+        return error instanceof InsufficientFundsError;
+    }
+    static isErrorMessage(err) {
+        var _a;
+        const errorWithMessage = err;
+        return (((_a = errorWithMessage === null || errorWithMessage === void 0 ? void 0 : errorWithMessage.message) === null || _a === void 0 ? void 0 : _a.includes("AA21 didn't pay prefund")) || false);
+    }
+}
+InsufficientFundsError.message = 'Insufficient funds.';
+
+exports.InsufficientFundsError = InsufficientFundsError;

package/src/errors/InsufficientFundsError.d.ts

@@ -0,0 +1,9 @@
+import { DynamicError } from './DynamicError';
+export declare class InsufficientFundsError extends DynamicError {
+    constructor();
+    static message: string;
+    static isInstance(err: {
+        walk?: () => unknown;
+    } | unknown): err is InsufficientFundsError;
+    static isErrorMessage(err: unknown): boolean;
+}

package/src/errors/InsufficientFundsError.js

@@ -0,0 +1,20 @@
+import { DynamicError } from './DynamicError.js';
+
+class InsufficientFundsError extends DynamicError {
+    constructor() {
+        super(InsufficientFundsError.message);
+    }
+    static isInstance(err) {
+        var _a;
+        const error = ((_a = err === null || err === void 0 ? void 0 : err.walk) === null || _a === void 0 ? void 0 : _a.call(err)) || err;
+        return error instanceof InsufficientFundsError;
+    }
+    static isErrorMessage(err) {
+        var _a;
+        const errorWithMessage = err;
+        return (((_a = errorWithMessage === null || errorWithMessage === void 0 ? void 0 : errorWithMessage.message) === null || _a === void 0 ? void 0 : _a.includes("AA21 didn't pay prefund")) || false);
+    }
+}
+InsufficientFundsError.message = 'Insufficient funds.';
+
+export { InsufficientFundsError };

package/src/errors/PasskeyError.d.ts

@@ -0,0 +1,8 @@
+export type PasskeyError = {
+    cause?: {
+        code: number;
+        name: string;
+        message: string;
+    };
+    code?: number;
+};

package/src/errors/TransactionGasCannotBeSponsoredError.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var DynamicError = require('./DynamicError.cjs');
+
+class TransactionGasCannotBeSponsoredError extends DynamicError.DynamicError {
+    constructor() {
+        super(TransactionGasCannotBeSponsoredError.message);
+    }
+    static isInstance(err) {
+        var _a;
+        const error = ((_a = err === null || err === void 0 ? void 0 : err.walk) === null || _a === void 0 ? void 0 : _a.call(err)) || err;
+        return error instanceof TransactionGasCannotBeSponsoredError;
+    }
+    static isErrorMessage(err) {
+        var _a;
+        const errorWithMessage = err;
+        return (((_a = errorWithMessage === null || errorWithMessage === void 0 ? void 0 : errorWithMessage.message) === null || _a === void 0 ? void 0 : _a.includes('userOp did not match any gas sponsoring policies')) || false);
+    }
+}
+TransactionGasCannotBeSponsoredError.message = 'Transaction gas cannot be sponsored.';
+
+exports.TransactionGasCannotBeSponsoredError = TransactionGasCannotBeSponsoredError;

package/src/errors/TransactionGasCannotBeSponsoredError.d.ts

@@ -0,0 +1,9 @@
+import { DynamicError } from './DynamicError';
+export declare class TransactionGasCannotBeSponsoredError extends DynamicError {
+    constructor();
+    static message: string;
+    static isInstance(err: {
+        walk?: () => unknown;
+    } | unknown): err is TransactionGasCannotBeSponsoredError;
+    static isErrorMessage(err: unknown): boolean;
+}

package/src/errors/TransactionGasCannotBeSponsoredError.js

@@ -0,0 +1,20 @@
+import { DynamicError } from './DynamicError.js';
+
+class TransactionGasCannotBeSponsoredError extends DynamicError {
+    constructor() {
+        super(TransactionGasCannotBeSponsoredError.message);
+    }
+    static isInstance(err) {
+        var _a;
+        const error = ((_a = err === null || err === void 0 ? void 0 : err.walk) === null || _a === void 0 ? void 0 : _a.call(err)) || err;
+        return error instanceof TransactionGasCannotBeSponsoredError;
+    }
+    static isErrorMessage(err) {
+        var _a;
+        const errorWithMessage = err;
+        return (((_a = errorWithMessage === null || errorWithMessage === void 0 ? void 0 : errorWithMessage.message) === null || _a === void 0 ? void 0 : _a.includes('userOp did not match any gas sponsoring policies')) || false);
+    }
+}
+TransactionGasCannotBeSponsoredError.message = 'Transaction gas cannot be sponsored.';
+
+export { TransactionGasCannotBeSponsoredError };

package/src/errors/index.d.ts

@@ -14,3 +14,6 @@ export * from './MissingEnvironmentIdError';
 export * from './GateBlockedError';
 export * from './UserHasAccountWithEmailError';
 export * from './SocialAccountAlreadyExistsError';
+export * from './TransactionGasCannotBeSponsoredError';
+export * from './InsufficientFundsError';
+export * from './PasskeyError';

package/src/index.cjs

@@ -20,6 +20,8 @@ var MissingEnvironmentIdError = require('./errors/MissingEnvironmentIdError.cjs'
 var GateBlockedError = require('./errors/GateBlockedError.cjs');
 var UserHasAccountWithEmailError = require('./errors/UserHasAccountWithEmailError.cjs');
 var SocialAccountAlreadyExistsError = require('./errors/SocialAccountAlreadyExistsError.cjs');
+var TransactionGasCannotBeSponsoredError = require('./errors/TransactionGasCannotBeSponsoredError.cjs');
+var InsufficientFundsError = require('./errors/InsufficientFundsError.cjs');
 var CancellablePromise = require('./CancellablePromise/CancellablePromise.cjs');
 var isFunction = require('./isFunction/isFunction.cjs');
 var isMobile = require('./isMobile.cjs');
@@ -30,6 +32,8 @@ var getProvidersFromWindow = require('./getProvidersFromWindow.cjs');
 var sleep = require('./sleep/sleep.cjs');
 var getOrMapViemChain = require('./getOrMapViemChain.cjs');
 var retryableFn = require('./retryableFn.cjs');
+var wrapMethodWithCallback = require('./wrapMethodWithCallback/wrapMethodWithCallback.cjs');
+var DeferredPromise = require('./DeferredPromise/DeferredPromise.cjs');
 
 
 
@@ -51,6 +55,8 @@ exports.MissingEnvironmentIdError = MissingEnvironmentIdError.MissingEnvironment
 exports.GateBlockedError = GateBlockedError.GateBlockedError;
 exports.UserHasAccountWithEmailError = UserHasAccountWithEmailError.UserHasAccountWithEmailError;
 exports.SocialAccountAlreadyExistsError = SocialAccountAlreadyExistsError.SocialAccountAlreadyExistsError;
+exports.TransactionGasCannotBeSponsoredError = TransactionGasCannotBeSponsoredError.TransactionGasCannotBeSponsoredError;
+exports.InsufficientFundsError = InsufficientFundsError.InsufficientFundsError;
 exports.CancellablePromise = CancellablePromise.CancellablePromise;
 exports.isFunction = isFunction.isFunction;
 exports.getAndroidVersion = isMobile.getAndroidVersion;
@@ -75,3 +81,5 @@ exports.getOrMapViemChain = getOrMapViemChain.getOrMapViemChain;
 exports.mapChain = getOrMapViemChain.mapChain;
 exports.FALLBACK_UNDEFINED = retryableFn.FALLBACK_UNDEFINED;
 exports.retryableFn = retryableFn.retryableFn;
+exports.wrapMethodWithCallback = wrapMethodWithCallback.wrapMethodWithCallback;
+exports.DeferredPromise = DeferredPromise.DeferredPromise;

package/src/index.d.ts

@@ -11,3 +11,5 @@ export * from './getProvidersFromWindow';
 export * from './sleep';
 export * from './getOrMapViemChain';
 export * from './retryableFn';
+export * from './wrapMethodWithCallback';
+export * from './DeferredPromise';

package/src/index.js

@@ -16,6 +16,8 @@ export { MissingEnvironmentIdError } from './errors/MissingEnvironmentIdError.js
 export { GateBlockedError } from './errors/GateBlockedError.js';
 export { UserHasAccountWithEmailError } from './errors/UserHasAccountWithEmailError.js';
 export { SocialAccountAlreadyExistsError } from './errors/SocialAccountAlreadyExistsError.js';
+export { TransactionGasCannotBeSponsoredError } from './errors/TransactionGasCannotBeSponsoredError.js';
+export { InsufficientFundsError } from './errors/InsufficientFundsError.js';
 export { CancellablePromise } from './CancellablePromise/CancellablePromise.js';
 export { isFunction } from './isFunction/isFunction.js';
 export { getAndroidVersion, isAndroid, isIOS, isIPad, isIPhone, isIPhone8OrEarlier, isLegacySafari, isMobile, isSamsungBrowser, isWindows } from './isMobile.js';
@@ -26,3 +28,5 @@ export { getProvidersFromWindow } from './getProvidersFromWindow.js';
 export { sleep } from './sleep/sleep.js';
 export { getChain, getOrMapViemChain, mapChain } from './getOrMapViemChain.js';
 export { FALLBACK_UNDEFINED, retryableFn } from './retryableFn.js';
+export { wrapMethodWithCallback } from './wrapMethodWithCallback/wrapMethodWithCallback.js';
+export { DeferredPromise } from './DeferredPromise/DeferredPromise.js';

package/src/wrapMethodWithCallback/index.d.ts

@@ -0,0 +1 @@
+export { wrapMethodWithCallback } from './wrapMethodWithCallback';

package/src/wrapMethodWithCallback/wrapMethodWithCallback.cjs

@@ -0,0 +1,46 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Wraps an existing method of an object with a callback function. This allows for additional
+ * processing or behavior to be executed around the original method. The original method is
+ * called within the callback, and its parameters and return value can be accessed and/or modified.
+ *
+ * @template T - The type of the object whose method is being wrapped.
+ * @template K - The key type of the method within the object.
+ * @template F - The type of the function, inferred from the method of the object.
+ *
+ * @param {T} obj - The object containing the method to be wrapped.
+ * @param {K} key - The key of the method in the object to be wrapped.
+ * @param {(original: F, ...args: Parameters<F>) => ReturnType<F>} callback - The callback
+ *        function to wrap around the original method. It receive1`s the original method and its
+ *        parameters as arguments.
+ *
+ * @returns {void} - The function does not return a value; it modifies the method of the object in place.
+ *
+ * @example
+ * // Example usage
+ * const myObject = {
+ *   greet(name) {
+ *     return `Hello, ${name}!`;
+ *   }
+ * };
+ *
+ * wrapMethodWithCallback(myObject, 'greet', (original, ...args) => {
+ *   console.log('Greet method called with args:', args);
+ *   return original(...args).toUpperCase();
+ * });
+ *
+ * console.log(myObject.greet('Alice')); // Logs: 'Greet method called with args: ["Alice"]'
+ *                                      // Returns: 'HELLO, ALICE!'
+ */
+const wrapMethodWithCallback = (obj, key, callback) => {
+    const original = obj[key];
+    const boundOriginal = original.bind(obj);
+    Object.assign(obj, {
+        [key]: (...args) => callback(boundOriginal, ...args),
+    });
+};
+
+exports.wrapMethodWithCallback = wrapMethodWithCallback;

package/src/wrapMethodWithCallback/wrapMethodWithCallback.d.ts

@@ -0,0 +1,36 @@
+type Method = (...args: any[]) => any;
+/**
+ * Wraps an existing method of an object with a callback function. This allows for additional
+ * processing or behavior to be executed around the original method. The original method is
+ * called within the callback, and its parameters and return value can be accessed and/or modified.
+ *
+ * @template T - The type of the object whose method is being wrapped.
+ * @template K - The key type of the method within the object.
+ * @template F - The type of the function, inferred from the method of the object.
+ *
+ * @param {T} obj - The object containing the method to be wrapped.
+ * @param {K} key - The key of the method in the object to be wrapped.
+ * @param {(original: F, ...args: Parameters<F>) => ReturnType<F>} callback - The callback
+ *        function to wrap around the original method. It receive1`s the original method and its
+ *        parameters as arguments.
+ *
+ * @returns {void} - The function does not return a value; it modifies the method of the object in place.
+ *
+ * @example
+ * // Example usage
+ * const myObject = {
+ *   greet(name) {
+ *     return `Hello, ${name}!`;
+ *   }
+ * };
+ *
+ * wrapMethodWithCallback(myObject, 'greet', (original, ...args) => {
+ *   console.log('Greet method called with args:', args);
+ *   return original(...args).toUpperCase();
+ * });
+ *
+ * console.log(myObject.greet('Alice')); // Logs: 'Greet method called with args: ["Alice"]'
+ *                                      // Returns: 'HELLO, ALICE!'
+ */
+export declare const wrapMethodWithCallback: <T extends object, K extends { [P in keyof T]: T[P] extends Method ? P : never; }[keyof T], F extends Method = T[K] extends Method ? T[K] : never>(obj: T, key: K, callback: (original: F, ...args: Parameters<F>) => ReturnType<F>) => void;
+export {};

package/src/wrapMethodWithCallback/wrapMethodWithCallback.js

@@ -0,0 +1,42 @@
+/**
+ * Wraps an existing method of an object with a callback function. This allows for additional
+ * processing or behavior to be executed around the original method. The original method is
+ * called within the callback, and its parameters and return value can be accessed and/or modified.
+ *
+ * @template T - The type of the object whose method is being wrapped.
+ * @template K - The key type of the method within the object.
+ * @template F - The type of the function, inferred from the method of the object.
+ *
+ * @param {T} obj - The object containing the method to be wrapped.
+ * @param {K} key - The key of the method in the object to be wrapped.
+ * @param {(original: F, ...args: Parameters<F>) => ReturnType<F>} callback - The callback
+ *        function to wrap around the original method. It receive1`s the original method and its
+ *        parameters as arguments.
+ *
+ * @returns {void} - The function does not return a value; it modifies the method of the object in place.
+ *
+ * @example
+ * // Example usage
+ * const myObject = {
+ *   greet(name) {
+ *     return `Hello, ${name}!`;
+ *   }
+ * };
+ *
+ * wrapMethodWithCallback(myObject, 'greet', (original, ...args) => {
+ *   console.log('Greet method called with args:', args);
+ *   return original(...args).toUpperCase();
+ * });
+ *
+ * console.log(myObject.greet('Alice')); // Logs: 'Greet method called with args: ["Alice"]'
+ *                                      // Returns: 'HELLO, ALICE!'
+ */
+const wrapMethodWithCallback = (obj, key, callback) => {
+    const original = obj[key];
+    const boundOriginal = original.bind(obj);
+    Object.assign(obj, {
+        [key]: (...args) => callback(boundOriginal, ...args),
+    });
+};
+
+export { wrapMethodWithCallback };