@startale/app-sdk 1.0.0

package/dist/browser-entry.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Browser entry point for Base Account SDK
+ * This file exposes the account interface to the global window object
+ */
+import { base } from './interface/payment/base.js';
+import { CHAIN_IDS, TOKENS } from './interface/payment/constants.js';
+import { getPaymentStatus } from './interface/payment/getPaymentStatus.js';
+import { pay } from './interface/payment/pay.js';
+import type { InfoRequest, PayerInfo, PaymentOptions, PaymentResult, PaymentStatus, PaymentStatusOptions } from './interface/payment/types.js';
+export type { AppMetadata, Preference, ProviderInterface, } from './core/provider/interface.js';
+export { createBaseAccountSDK } from './interface/builder/core/createBaseAccountSDK.js';
+export { getCryptoKeyAccount, removeCryptoKey } from './kms/crypto-key/index.js';
+export { base, CHAIN_IDS, getPaymentStatus, pay, TOKENS };
+export type { InfoRequest, PayerInfo, PaymentOptions, PaymentResult, PaymentStatus, PaymentStatusOptions, };
+//# sourceMappingURL=browser-entry.d.ts.map

package/dist/browser-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-entry.d.ts","sourceRoot":"","sources":["../src/browser-entry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAA;AAC1E,OAAO,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAA;AAChD,OAAO,KAAK,EACX,WAAW,EACX,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,MAAM,8BAA8B,CAAA;AASrC,YAAY,EACX,WAAW,EACX,UAAU,EACV,iBAAiB,GACjB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAA;AACvF,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,EAAE,CAAA;AACzD,YAAY,EACX,WAAW,EACX,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,EACb,oBAAoB,GACpB,CAAA"}

package/dist/browser-entry.js

@@ -0,0 +1,19 @@
+/**
+ * Browser entry point for Base Account SDK
+ * This file exposes the account interface to the global window object
+ */
+import { createBaseAccountSDK } from './interface/builder/core/createBaseAccountSDK.js';
+import { base } from './interface/payment/base.js';
+import { CHAIN_IDS, TOKENS } from './interface/payment/constants.js';
+import { getPaymentStatus } from './interface/payment/getPaymentStatus.js';
+import { pay } from './interface/payment/pay.js';
+// Expose to global window object
+if (typeof window !== 'undefined') {
+    ;
+    window.base = base;
+    window.createBaseAccountSDK = createBaseAccountSDK;
+}
+export { createBaseAccountSDK } from './interface/builder/core/createBaseAccountSDK.js';
+export { getCryptoKeyAccount, removeCryptoKey } from './kms/crypto-key/index.js';
+export { base, CHAIN_IDS, getPaymentStatus, pay, TOKENS };
+//# sourceMappingURL=browser-entry.js.map

package/dist/browser-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-entry.js","sourceRoot":"","sources":["../src/browser-entry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAA;AACvF,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAA;AAC1E,OAAO,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAA;AAUhD,iCAAiC;AACjC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;IACnC,CAAC;IAAC,MAAc,CAAC,IAAI,GAAG,IAAI,CAC3B;IAAC,MAAc,CAAC,oBAAoB,GAAG,oBAAoB,CAAA;AAC7D,CAAC;AAQD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAA;AACvF,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,EAAE,CAAA"}

package/dist/core/communicator/Communicator.d.ts

@@ -0,0 +1,47 @@
+import { AppMetadata, Preference } from '../provider/interface.js';
+import { Message, MessageID } from '../message/Message.js';
+export type CommunicatorOptions = {
+    url?: string;
+    metadata: AppMetadata;
+    preference: Preference;
+};
+/**
+ * Communicates with a popup window for specific Base Account environment
+ * to send and receive messages.
+ *
+ * This class is responsible for opening a popup window, posting messages to it,
+ * and listening for responses.
+ *
+ * It also handles cleanup of event listeners and the popup window itself when necessary.
+ */
+export declare class Communicator {
+    private readonly metadata;
+    private readonly preference;
+    private readonly url;
+    private popup;
+    private listeners;
+    constructor({ url, metadata, preference, }: CommunicatorOptions);
+    /**
+     * Posts a message to the popup window
+     */
+    postMessage: (message: Message) => Promise<void>;
+    /**
+     * Posts a request to the popup window and waits for a response
+     */
+    postRequestAndWaitForResponse: <M extends Message>(request: Message & {
+        id: MessageID;
+    }) => Promise<M>;
+    /**
+     * Listens for messages from the popup window that match a given predicate.
+     */
+    onMessage: <M extends Message>(predicate: (_: Partial<M>) => boolean) => Promise<M>;
+    /**
+     * Closes the popup, rejects all requests and clears the listeners
+     */
+    private disconnect;
+    /**
+     * Waits for the popup window to fully load and then sends a version message.
+     */
+    waitForPopupLoaded: () => Promise<Window>;
+}
+//# sourceMappingURL=Communicator.d.ts.map

package/dist/core/communicator/Communicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Communicator.d.ts","sourceRoot":"","sources":["../../../src/core/communicator/Communicator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AASrE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAE1D,MAAM,MAAM,mBAAmB,GAAG;IACjC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,WAAW,CAAA;IACrB,UAAU,EAAE,UAAU,CAAA;CACtB,CAAA;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAK;IACzB,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,SAAS,CAGd;gBAES,EACX,GAAiB,EACjB,QAAQ,EACR,UAAU,GACV,EAAE,mBAAmB;IAMtB;;OAEG;IACH,WAAW,GAAU,SAAS,OAAO,mBAGpC;IAED;;OAEG;IACH,6BAA6B,GAAU,CAAC,SAAS,OAAO,EACvD,SAAS,OAAO,GAAG;QAAE,EAAE,EAAE,SAAS,CAAA;KAAE,KAClC,OAAO,CAAC,CAAC,CAAC,CAMZ;IAED;;OAEG;IACH,SAAS,GAAU,CAAC,SAAS,OAAO,EACnC,WAAW,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,KACnC,OAAO,CAAC,CAAC,CAAC,CAgBZ;IAED;;OAEG;IACH,OAAO,CAAC,UAAU,CAUjB;IAED;;OAEG;IACH,kBAAkB,QAAa,OAAO,CAAC,MAAM,CAAC,CAqC7C;CACD"}

package/dist/core/communicator/Communicator.js

@@ -0,0 +1,107 @@
+import { CB_KEYS_URL, PACKAGE_NAME, PACKAGE_VERSION } from '../constants.js';
+import { standardErrors } from '../error/errors.js';
+import { logPopupSetupCompleted, logPopupSetupStarted, logPopupUnloadReceived, } from '../telemetry/events/communicator.js';
+import { closePopup, openPopup } from '../../util/web.js';
+/**
+ * Communicates with a popup window for specific Base Account environment
+ * to send and receive messages.
+ *
+ * This class is responsible for opening a popup window, posting messages to it,
+ * and listening for responses.
+ *
+ * It also handles cleanup of event listeners and the popup window itself when necessary.
+ */
+export class Communicator {
+    constructor({ url = CB_KEYS_URL, metadata, preference, }) {
+        this.popup = null;
+        this.listeners = new Map();
+        /**
+         * Posts a message to the popup window
+         */
+        this.postMessage = async (message) => {
+            const popup = await this.waitForPopupLoaded();
+            popup.postMessage(message, this.url.origin);
+        };
+        /**
+         * Posts a request to the popup window and waits for a response
+         */
+        this.postRequestAndWaitForResponse = async (request) => {
+            const responsePromise = this.onMessage(({ requestId }) => requestId === request.id);
+            this.postMessage(request);
+            return await responsePromise;
+        };
+        /**
+         * Listens for messages from the popup window that match a given predicate.
+         */
+        this.onMessage = async (predicate) => {
+            return new Promise((resolve, reject) => {
+                const listener = (event) => {
+                    if (event.origin !== this.url.origin)
+                        return; // origin validation
+                    const message = event.data;
+                    if (predicate(message)) {
+                        resolve(message);
+                        window.removeEventListener('message', listener);
+                        this.listeners.delete(listener);
+                    }
+                };
+                window.addEventListener('message', listener);
+                this.listeners.set(listener, { reject });
+            });
+        };
+        /**
+         * Closes the popup, rejects all requests and clears the listeners
+         */
+        this.disconnect = () => {
+            // Note: keys popup handles closing itself. this is a fallback.
+            closePopup(this.popup);
+            this.popup = null;
+            this.listeners.forEach(({ reject }, listener) => {
+                reject(standardErrors.provider.userRejectedRequest('Request rejected'));
+                window.removeEventListener('message', listener);
+            });
+            this.listeners.clear();
+        };
+        /**
+         * Waits for the popup window to fully load and then sends a version message.
+         */
+        this.waitForPopupLoaded = async () => {
+            if (this.popup && !this.popup.closed) {
+                // In case the user un-focused the popup between requests, focus it again
+                this.popup.focus();
+                return this.popup;
+            }
+            logPopupSetupStarted();
+            this.popup = await openPopup(this.url);
+            this.onMessage(({ event }) => event === 'PopupUnload')
+                .then(() => {
+                this.disconnect();
+                logPopupUnloadReceived();
+            })
+                .catch(() => { });
+            return this.onMessage(({ event }) => event === 'PopupLoaded')
+                .then((message) => {
+                this.postMessage({
+                    requestId: message.id,
+                    data: {
+                        version: PACKAGE_VERSION,
+                        sdkName: PACKAGE_NAME,
+                        metadata: this.metadata,
+                        preference: this.preference,
+                        location: window.location.toString(),
+                    },
+                });
+            })
+                .then(() => {
+                if (!this.popup)
+                    throw standardErrors.rpc.internal();
+                logPopupSetupCompleted();
+                return this.popup;
+            });
+        };
+        this.url = new URL(url);
+        this.metadata = metadata;
+        this.preference = preference;
+    }
+}
+//# sourceMappingURL=Communicator.js.map

package/dist/core/communicator/Communicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Communicator.js","sourceRoot":"","sources":["../../../src/core/communicator/Communicator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD,OAAO,EACN,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,GACtB,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAWpD;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAY;IAUxB,YAAY,EACX,GAAG,GAAG,WAAW,EACjB,QAAQ,EACR,UAAU,GACW;QAVd,UAAK,GAAkB,IAAI,CAAA;QAC3B,cAAS,GAAG,IAAI,GAAG,EAGxB,CAAA;QAYH;;WAEG;QACH,gBAAW,GAAG,KAAK,EAAE,OAAgB,EAAE,EAAE;YACxC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAA;YAC7C,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAC5C,CAAC,CAAA;QAED;;WAEG;QACH,kCAA6B,GAAG,KAAK,EACpC,OAAoC,EACvB,EAAE;YACf,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CACrC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,KAAK,OAAO,CAAC,EAAE,CAC3C,CAAA;YACD,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;YACzB,OAAO,MAAM,eAAe,CAAA;QAC7B,CAAC,CAAA;QAED;;WAEG;QACH,cAAS,GAAG,KAAK,EAChB,SAAqC,EACxB,EAAE;YACf,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACtC,MAAM,QAAQ,GAAG,CAAC,KAAsB,EAAE,EAAE;oBAC3C,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM;wBAAE,OAAM,CAAC,oBAAoB;oBAEjE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAA;oBAC1B,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;wBACxB,OAAO,CAAC,OAAO,CAAC,CAAA;wBAChB,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;wBAC/C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;oBAChC,CAAC;gBACF,CAAC,CAAA;gBAED,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;gBAC5C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;YACzC,CAAC,CAAC,CAAA;QACH,CAAC,CAAA;QAED;;WAEG;QACK,eAAU,GAAG,GAAG,EAAE;YACzB,+DAA+D;YAC/D,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;YAEjB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE;gBAC/C,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,CAAC,CAAA;gBACvE,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;YAChD,CAAC,CAAC,CAAA;YACF,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;QACvB,CAAC,CAAA;QAED;;WAEG;QACH,uBAAkB,GAAG,KAAK,IAAqB,EAAE;YAChD,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBACtC,yEAAyE;gBACzE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;gBAClB,OAAO,IAAI,CAAC,KAAK,CAAA;YAClB,CAAC;YAED,oBAAoB,EAAE,CAAA;YACtB,IAAI,CAAC,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAEtC,IAAI,CAAC,SAAS,CAAgB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,aAAa,CAAC;iBACnE,IAAI,CAAC,GAAG,EAAE;gBACV,IAAI,CAAC,UAAU,EAAE,CAAA;gBACjB,sBAAsB,EAAE,CAAA;YACzB,CAAC,CAAC;iBACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YAEjB,OAAO,IAAI,CAAC,SAAS,CACpB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,aAAa,CACtC;iBACC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;gBACjB,IAAI,CAAC,WAAW,CAAC;oBAChB,SAAS,EAAE,OAAO,CAAC,EAAE;oBACrB,IAAI,EAAE;wBACL,OAAO,EAAE,eAAe;wBACxB,OAAO,EAAE,YAAY;wBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,UAAU,EAAE,IAAI,CAAC,UAAU;wBAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE;qBACpC;iBACD,CAAC,CAAA;YACH,CAAC,CAAC;iBACD,IAAI,CAAC,GAAG,EAAE;gBACV,IAAI,CAAC,IAAI,CAAC,KAAK;oBAAE,MAAM,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;gBACpD,sBAAsB,EAAE,CAAA;gBACxB,OAAO,IAAI,CAAC,KAAK,CAAA;YAClB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAA;QAxGA,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC7B,CAAC;CAsGD"}

package/dist/core/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const CB_KEYS_URL = "https://keys.coinbase.com/connect";
+export declare const CB_WALLET_RPC_URL = "https://rpc.wallet.coinbase.com";
+export declare const PACKAGE_NAME: string;
+export declare const PACKAGE_VERSION: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,sCAAsC,CAAA;AAC9D,eAAO,MAAM,iBAAiB,oCAAoC,CAAA;AAElE,eAAO,MAAM,YAAY,QAAW,CAAA;AACpC,eAAO,MAAM,eAAe,QAAc,CAAA"}

package/dist/core/constants.js

@@ -0,0 +1,6 @@
+import pkg from '../../package.json' with { type: 'json' };
+export const CB_KEYS_URL = 'https://keys.coinbase.com/connect';
+export const CB_WALLET_RPC_URL = 'https://rpc.wallet.coinbase.com';
+export const PACKAGE_NAME = pkg.name;
+export const PACKAGE_VERSION = pkg.version;
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAE1D,MAAM,CAAC,MAAM,WAAW,GAAG,mCAAmC,CAAA;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,iCAAiC,CAAA;AAElE,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,CAAA;AACpC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC,OAAO,CAAA"}

package/dist/core/error/constants.d.ts

@@ -0,0 +1,96 @@
+interface ErrorCodes {
+    readonly rpc: {
+        readonly invalidInput: -32000;
+        readonly resourceNotFound: -32001;
+        readonly resourceUnavailable: -32002;
+        readonly transactionRejected: -32003;
+        readonly methodNotSupported: -32004;
+        readonly limitExceeded: -32005;
+        readonly parse: -32700;
+        readonly invalidRequest: -32600;
+        readonly methodNotFound: -32601;
+        readonly invalidParams: -32602;
+        readonly internal: -32603;
+    };
+    readonly provider: {
+        readonly userRejectedRequest: 4001;
+        readonly unauthorized: 4100;
+        readonly unsupportedMethod: 4200;
+        readonly disconnected: 4900;
+        readonly chainDisconnected: 4901;
+        readonly unsupportedChain: 4902;
+    };
+}
+export declare const standardErrorCodes: ErrorCodes;
+export declare const errorValues: {
+    '-32700': {
+        standard: string;
+        message: string;
+    };
+    '-32600': {
+        standard: string;
+        message: string;
+    };
+    '-32601': {
+        standard: string;
+        message: string;
+    };
+    '-32602': {
+        standard: string;
+        message: string;
+    };
+    '-32603': {
+        standard: string;
+        message: string;
+    };
+    '-32000': {
+        standard: string;
+        message: string;
+    };
+    '-32001': {
+        standard: string;
+        message: string;
+    };
+    '-32002': {
+        standard: string;
+        message: string;
+    };
+    '-32003': {
+        standard: string;
+        message: string;
+    };
+    '-32004': {
+        standard: string;
+        message: string;
+    };
+    '-32005': {
+        standard: string;
+        message: string;
+    };
+    '4001': {
+        standard: string;
+        message: string;
+    };
+    '4100': {
+        standard: string;
+        message: string;
+    };
+    '4200': {
+        standard: string;
+        message: string;
+    };
+    '4900': {
+        standard: string;
+        message: string;
+    };
+    '4901': {
+        standard: string;
+        message: string;
+    };
+    '4902': {
+        standard: string;
+        message: string;
+    };
+};
+export {};
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/error/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/core/error/constants.ts"],"names":[],"mappings":"AAAA,UAAU,UAAU;IACnB,QAAQ,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,YAAY,EAAE,CAAC,KAAK,CAAA;QAC7B,QAAQ,CAAC,gBAAgB,EAAE,CAAC,KAAK,CAAA;QACjC,QAAQ,CAAC,mBAAmB,EAAE,CAAC,KAAK,CAAA;QACpC,QAAQ,CAAC,mBAAmB,EAAE,CAAC,KAAK,CAAA;QACpC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,KAAK,CAAA;QACnC,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,CAAA;QAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,CAAA;QACtB,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,CAAA;QAC/B,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,CAAA;QAC/B,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,CAAA;QAC9B,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAA;KACzB,CAAA;IACD,QAAQ,CAAC,QAAQ,EAAE;QAClB,QAAQ,CAAC,mBAAmB,EAAE,IAAI,CAAA;QAClC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAA;QAC3B,QAAQ,CAAC,iBAAiB,EAAE,IAAI,CAAA;QAChC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAA;QAC3B,QAAQ,CAAC,iBAAiB,EAAE,IAAI,CAAA;QAChC,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAA;KAC/B,CAAA;CACD;AAED,eAAO,MAAM,kBAAkB,EAAE,UAsBhC,CAAA;AAED,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwEvB,CAAA"}

package/dist/core/error/constants.js

@@ -0,0 +1,94 @@
+export const standardErrorCodes = {
+    rpc: {
+        invalidInput: -32000,
+        resourceNotFound: -32001,
+        resourceUnavailable: -32002,
+        transactionRejected: -32003,
+        methodNotSupported: -32004,
+        limitExceeded: -32005,
+        parse: -32700,
+        invalidRequest: -32600,
+        methodNotFound: -32601,
+        invalidParams: -32602,
+        internal: -32603,
+    },
+    provider: {
+        userRejectedRequest: 4001,
+        unauthorized: 4100,
+        unsupportedMethod: 4200,
+        disconnected: 4900,
+        chainDisconnected: 4901,
+        unsupportedChain: 4902,
+    },
+};
+export const errorValues = {
+    '-32700': {
+        standard: 'JSON RPC 2.0',
+        message: 'Invalid JSON was received by the server. An error occurred on the server while parsing the JSON text.',
+    },
+    '-32600': {
+        standard: 'JSON RPC 2.0',
+        message: 'The JSON sent is not a valid Request object.',
+    },
+    '-32601': {
+        standard: 'JSON RPC 2.0',
+        message: 'The method does not exist / is not available.',
+    },
+    '-32602': {
+        standard: 'JSON RPC 2.0',
+        message: 'Invalid method parameter(s).',
+    },
+    '-32603': {
+        standard: 'JSON RPC 2.0',
+        message: 'Internal JSON-RPC error.',
+    },
+    '-32000': {
+        standard: 'EIP-1474',
+        message: 'Invalid input.',
+    },
+    '-32001': {
+        standard: 'EIP-1474',
+        message: 'Resource not found.',
+    },
+    '-32002': {
+        standard: 'EIP-1474',
+        message: 'Resource unavailable.',
+    },
+    '-32003': {
+        standard: 'EIP-1474',
+        message: 'Transaction rejected.',
+    },
+    '-32004': {
+        standard: 'EIP-1474',
+        message: 'Method not supported.',
+    },
+    '-32005': {
+        standard: 'EIP-1474',
+        message: 'Request limit exceeded.',
+    },
+    '4001': {
+        standard: 'EIP-1193',
+        message: 'User rejected the request.',
+    },
+    '4100': {
+        standard: 'EIP-1193',
+        message: 'The requested account and/or method has not been authorized by the user.',
+    },
+    '4200': {
+        standard: 'EIP-1193',
+        message: 'The requested method is not supported by this Ethereum provider.',
+    },
+    '4900': {
+        standard: 'EIP-1193',
+        message: 'The provider is disconnected from all chains.',
+    },
+    '4901': {
+        standard: 'EIP-1193',
+        message: 'The provider is disconnected from the specified chain.',
+    },
+    '4902': {
+        standard: 'EIP-3085',
+        message: 'Unrecognized chain ID.',
+    },
+};
+//# sourceMappingURL=constants.js.map

package/dist/core/error/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/core/error/constants.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC7C,GAAG,EAAE;QACJ,YAAY,EAAE,CAAC,KAAK;QACpB,gBAAgB,EAAE,CAAC,KAAK;QACxB,mBAAmB,EAAE,CAAC,KAAK;QAC3B,mBAAmB,EAAE,CAAC,KAAK;QAC3B,kBAAkB,EAAE,CAAC,KAAK;QAC1B,aAAa,EAAE,CAAC,KAAK;QACrB,KAAK,EAAE,CAAC,KAAK;QACb,cAAc,EAAE,CAAC,KAAK;QACtB,cAAc,EAAE,CAAC,KAAK;QACtB,aAAa,EAAE,CAAC,KAAK;QACrB,QAAQ,EAAE,CAAC,KAAK;KAChB;IACD,QAAQ,EAAE;QACT,mBAAmB,EAAE,IAAI;QACzB,YAAY,EAAE,IAAI;QAClB,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;QAClB,iBAAiB,EAAE,IAAI;QACvB,gBAAgB,EAAE,IAAI;KACtB;CACD,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IAC1B,QAAQ,EAAE;QACT,QAAQ,EAAE,cAAc;QACxB,OAAO,EACN,uGAAuG;KACxG;IACD,QAAQ,EAAE;QACT,QAAQ,EAAE,cAAc;QACxB,OAAO,EAAE,8CAA8C;KACvD;IACD,QAAQ,EAAE;QACT,QAAQ,EAAE,cAAc;QACxB,OAAO,EAAE,+CAA+C;KACxD;IACD,QAAQ,EAAE;QACT,QAAQ,EAAE,cAAc;QACxB,OAAO,EAAE,8BAA8B;KACvC;IACD,QAAQ,EAAE;QACT,QAAQ,EAAE,cAAc;QACxB,OAAO,EAAE,0BAA0B;KACnC;IACD,QAAQ,EAAE;QACT,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,gBAAgB;KACzB;IACD,QAAQ,EAAE;QACT,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,qBAAqB;KAC9B;IACD,QAAQ,EAAE;QACT,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,uBAAuB;KAChC;IACD,QAAQ,EAAE;QACT,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,uBAAuB;KAChC;IACD,QAAQ,EAAE;QACT,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,uBAAuB;KAChC;IACD,QAAQ,EAAE;QACT,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,yBAAyB;KAClC;IACD,MAAM,EAAE;QACP,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,4BAA4B;KACrC;IACD,MAAM,EAAE;QACP,QAAQ,EAAE,UAAU;QACpB,OAAO,EACN,0EAA0E;KAC3E;IACD,MAAM,EAAE;QACP,QAAQ,EAAE,UAAU;QACpB,OAAO,EACN,kEAAkE;KACnE;IACD,MAAM,EAAE;QACP,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,+CAA+C;KACxD;IACD,MAAM,EAAE;QACP,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,wDAAwD;KACjE;IACD,MAAM,EAAE;QACP,QAAQ,EAAE,UAAU;QACpB,OAAO,EAAE,wBAAwB;KACjC;CACD,CAAA"}

package/dist/core/error/errors.d.ts

@@ -0,0 +1,74 @@
+import { Address, HttpRequestError } from 'viem';
+export declare const standardErrors: {
+    rpc: {
+        parse: <T>(arg?: EthErrorsArg<T>) => EthereumRpcError<T>;
+        invalidRequest: <T>(arg?: EthErrorsArg<T>) => EthereumRpcError<T>;
+        invalidParams: <T>(arg?: EthErrorsArg<T>) => EthereumRpcError<T>;
+        methodNotFound: <T>(arg?: EthErrorsArg<T>) => EthereumRpcError<T>;
+        internal: <T>(arg?: EthErrorsArg<T>) => EthereumRpcError<T>;
+        server: <T>(opts: ServerErrorOptions<T>) => EthereumRpcError<T>;
+        invalidInput: <T>(arg?: EthErrorsArg<T>) => EthereumRpcError<T>;
+        resourceNotFound: <T>(arg?: EthErrorsArg<T>) => EthereumRpcError<T>;
+        resourceUnavailable: <T>(arg?: EthErrorsArg<T>) => EthereumRpcError<T>;
+        transactionRejected: <T>(arg?: EthErrorsArg<T>) => EthereumRpcError<T>;
+        methodNotSupported: <T>(arg?: EthErrorsArg<T>) => EthereumRpcError<T>;
+        limitExceeded: <T>(arg?: EthErrorsArg<T>) => EthereumRpcError<T>;
+    };
+    provider: {
+        userRejectedRequest: <T>(arg?: EthErrorsArg<T>) => EthereumProviderError<T>;
+        unauthorized: <T>(arg?: EthErrorsArg<T>) => EthereumProviderError<T>;
+        unsupportedMethod: <T>(arg?: EthErrorsArg<T>) => EthereumProviderError<T>;
+        disconnected: <T>(arg?: EthErrorsArg<T>) => EthereumProviderError<T>;
+        chainDisconnected: <T>(arg?: EthErrorsArg<T>) => EthereumProviderError<T>;
+        unsupportedChain: <T>(arg?: EthErrorsArg<T>) => EthereumProviderError<T>;
+        custom: <T>(opts: CustomErrorArg<T>) => EthereumProviderError<T>;
+    };
+};
+interface EthereumErrorOptions<T> {
+    message?: string;
+    data?: T;
+}
+interface ServerErrorOptions<T> extends EthereumErrorOptions<T> {
+    code: number;
+}
+type CustomErrorArg<T> = ServerErrorOptions<T>;
+type EthErrorsArg<T> = EthereumErrorOptions<T> | string;
+declare class EthereumRpcError<T> extends Error {
+    code: number;
+    data?: T;
+    constructor(code: number, message: string, data?: T);
+}
+declare class EthereumProviderError<T> extends EthereumRpcError<T> {
+    /**
+     * Create an Ethereum Provider JSON-RPC error.
+     * `code` must be an integer in the 1000 <= 4999 range.
+     */
+    constructor(code: number, message: string, data?: T);
+}
+export type InsufficientBalanceErrorData = {
+    type: 'INSUFFICIENT_FUNDS';
+    reason: 'NO_SUITABLE_SPEND_PERMISSION_FOUND' | 'SPEND_PERMISSION_ALLOWANCE_EXCEEDED';
+    account: {
+        address: Address;
+    };
+    /**
+     * The amount of each token that is required to send the transaction.
+     */
+    required: Record<Address, {
+        amount: `0x${string}`;
+        /**
+         * Sources of funds available to the account with sufficient balance to cover the required amount
+         */
+        sources: {
+            address: Address;
+            balance: `0x${string}`;
+        }[];
+    }>;
+};
+declare class ActionableInsufficientBalanceError extends EthereumRpcError<InsufficientBalanceErrorData> {
+}
+export declare function isActionableHttpRequestError(errorObject: unknown): errorObject is ActionableInsufficientBalanceError;
+export declare function isViemError(error: unknown): error is HttpRequestError;
+export declare function viemHttpErrorToProviderError(error: HttpRequestError): EthereumRpcError<any> | null;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/error/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/error/errors.ts"],"names":[],"mappings":"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"}

package/dist/core/error/errors.js

@@ -0,0 +1,138 @@
+import { standardErrorCodes } from './constants.js';
+import { getMessageFromCode } from './utils.js';
+export const standardErrors = {
+    rpc: {
+        parse: (arg) => getEthJsonRpcError(standardErrorCodes.rpc.parse, arg),
+        invalidRequest: (arg) => getEthJsonRpcError(standardErrorCodes.rpc.invalidRequest, arg),
+        invalidParams: (arg) => getEthJsonRpcError(standardErrorCodes.rpc.invalidParams, arg),
+        methodNotFound: (arg) => getEthJsonRpcError(standardErrorCodes.rpc.methodNotFound, arg),
+        internal: (arg) => getEthJsonRpcError(standardErrorCodes.rpc.internal, arg),
+        server: (opts) => {
+            if (!opts || typeof opts !== 'object' || Array.isArray(opts)) {
+                throw new Error('Ethereum RPC Server errors must provide single object argument.');
+            }
+            const { code } = opts;
+            if (!Number.isInteger(code) || code > -32005 || code < -32099) {
+                throw new Error('"code" must be an integer such that: -32099 <= code <= -32005');
+            }
+            return getEthJsonRpcError(code, opts);
+        },
+        invalidInput: (arg) => getEthJsonRpcError(standardErrorCodes.rpc.invalidInput, arg),
+        resourceNotFound: (arg) => getEthJsonRpcError(standardErrorCodes.rpc.resourceNotFound, arg),
+        resourceUnavailable: (arg) => getEthJsonRpcError(standardErrorCodes.rpc.resourceUnavailable, arg),
+        transactionRejected: (arg) => getEthJsonRpcError(standardErrorCodes.rpc.transactionRejected, arg),
+        methodNotSupported: (arg) => getEthJsonRpcError(standardErrorCodes.rpc.methodNotSupported, arg),
+        limitExceeded: (arg) => getEthJsonRpcError(standardErrorCodes.rpc.limitExceeded, arg),
+    },
+    provider: {
+        userRejectedRequest: (arg) => {
+            return getEthProviderError(standardErrorCodes.provider.userRejectedRequest, arg);
+        },
+        unauthorized: (arg) => {
+            return getEthProviderError(standardErrorCodes.provider.unauthorized, arg);
+        },
+        unsupportedMethod: (arg) => {
+            return getEthProviderError(standardErrorCodes.provider.unsupportedMethod, arg);
+        },
+        disconnected: (arg) => {
+            return getEthProviderError(standardErrorCodes.provider.disconnected, arg);
+        },
+        chainDisconnected: (arg) => {
+            return getEthProviderError(standardErrorCodes.provider.chainDisconnected, arg);
+        },
+        unsupportedChain: (arg) => {
+            return getEthProviderError(standardErrorCodes.provider.unsupportedChain, arg);
+        },
+        custom: (opts) => {
+            if (!opts || typeof opts !== 'object' || Array.isArray(opts)) {
+                throw new Error('Ethereum Provider custom errors must provide single object argument.');
+            }
+            const { code, message, data } = opts;
+            if (!message || typeof message !== 'string') {
+                throw new Error('"message" must be a nonempty string');
+            }
+            return new EthereumProviderError(code, message, data);
+        },
+    },
+};
+// Internal
+function getEthJsonRpcError(code, arg) {
+    const [message, data] = parseOpts(arg);
+    return new EthereumRpcError(code, message || getMessageFromCode(code), data);
+}
+function getEthProviderError(code, arg) {
+    const [message, data] = parseOpts(arg);
+    return new EthereumProviderError(code, message || getMessageFromCode(code), data);
+}
+function parseOpts(arg) {
+    if (arg) {
+        if (typeof arg === 'string') {
+            return [arg];
+        }
+        if (typeof arg === 'object' && !Array.isArray(arg)) {
+            const { message, data } = arg;
+            if (message && typeof message !== 'string') {
+                throw new Error('Must specify string message.');
+            }
+            return [message || undefined, data];
+        }
+    }
+    return [];
+}
+class EthereumRpcError extends Error {
+    constructor(code, message, data) {
+        if (!Number.isInteger(code)) {
+            throw new Error('"code" must be an integer.');
+        }
+        if (!message || typeof message !== 'string') {
+            throw new Error('"message" must be a nonempty string.');
+        }
+        super(message);
+        this.code = code;
+        if (data !== undefined) {
+            this.data = data;
+        }
+    }
+}
+class EthereumProviderError extends EthereumRpcError {
+    /**
+     * Create an Ethereum Provider JSON-RPC error.
+     * `code` must be an integer in the 1000 <= 4999 range.
+     */
+    constructor(code, message, data) {
+        if (!isValidEthProviderCode(code)) {
+            throw new Error('"code" must be an integer such that: 1000 <= code <= 4999');
+        }
+        super(code, message, data);
+    }
+}
+class ActionableInsufficientBalanceError extends EthereumRpcError {
+}
+function isValidEthProviderCode(code) {
+    return Number.isInteger(code) && code >= 1000 && code <= 4999;
+}
+export function isActionableHttpRequestError(errorObject) {
+    return (typeof errorObject === 'object' &&
+        errorObject !== null &&
+        'code' in errorObject &&
+        'data' in errorObject &&
+        errorObject.code === -32090 &&
+        typeof errorObject.data === 'object' &&
+        errorObject.data !== null &&
+        'type' in errorObject.data &&
+        errorObject.data.type === 'INSUFFICIENT_FUNDS');
+}
+export function isViemError(error) {
+    // Check if object and has code, message, and details
+    return typeof error === 'object' && error !== null && 'details' in error;
+}
+export function viemHttpErrorToProviderError(error) {
+    try {
+        const details = JSON.parse(error.details);
+        return new EthereumRpcError(details.code, details.message, details.data);
+    }
+    catch (_) {
+        return null;
+    }
+}
+//# sourceMappingURL=errors.js.map