@massalabs/wallet-provider 1.2.1-dev.20230801093549 → 1.2.1-dev.20230803141012

package/dist/esm/connector/Connector.d.ts

@@ -0,0 +1,87 @@
+import { AvailableCommands, IAccountBalanceRequest, IAccountBalanceResponse, IAccountDeletionRequest, IAccountDeletionResponse, IAccountImportRequest, IAccountImportResponse, IAccountSignRequest, IAccountSignResponse } from '..';
+import { IAccount } from '../account/IAccount';
+/**
+ * A constant string that is used to identify the HTML element that is used for
+ * communication between the web page script and the content script.
+ */
+export declare const MASSA_WINDOW_OBJECT = "massaWalletProvider";
+type CallbackFunction = (result: AllowedResponses, error: Error | null) => unknown;
+export type AllowedRequests = object | IAccountBalanceRequest | IAccountSignRequest | IAccountImportRequest | IAccountDeletionRequest;
+export type AllowedResponses = object | IAccountBalanceResponse | IAccountSignResponse | IAccountImportResponse | IAccountDeletionResponse | IAccount[] | string;
+/**
+ * This class enables communication with the content script by sending and receiving messages.
+ * @remarks
+ * - This class is used to send messages to the content script and to receive messages from the content script.
+ * - It is used to send messages to the content script and to receive messages from the content script.
+ *
+ */
+declare class Connector {
+    private registeredProviders;
+    private pendingRequests;
+    private massaStationListener;
+    /**
+     * Connector constructor
+     *
+     * @remarks
+     * - The Connector constructor takes no arguments.
+     * - It creates a Map object that is used to store pending requests.
+     * - It creates an HTML element that is used to communicate with the content script.
+     * - It adds an event listener to the HTML element that is used to communicate with the content script.
+     *
+     * @returns An instance of the Connector class.
+     *
+     */
+    constructor();
+    /**
+     * This method adds a register listener in the web page.
+     * It listens to the 'register' event.
+     *
+     * @returns void
+     *
+     * @remarks
+     * - It is used to register a new provider.
+     * - This method creates a new HTML element and a listener that listens to the register event.
+     *
+     */
+    private register;
+    private initMassaStationListener;
+    startMassaStationDiscovery(): Promise<void>;
+    /**
+     * This method sends a message from the webpage script to the content script.
+     *
+     * @remarks
+     * Sends a message to the content script using the specified provider name, command, and parameters,
+     *
+     * @privateRemarks
+     * This method registers the response callback with a unique ID.
+     *
+     * @param providerName - The name of the provider.
+     * @param command - The command that is sent to the content script (among the {@link AvailableCommands}).
+     * @param params - The parameters that are sent to the content script.
+     * @param responseCallback - The callback function that is called when the content script sends a response.
+     * @returns void
+     *
+     */
+    sendMessageToContentScript(providerName: string, command: AvailableCommands, params: AllowedRequests, responseCallback: CallbackFunction): void;
+    /**
+     * This method returns the registered providers.
+     *
+     * @returns The registered provider associated with its unique key.
+     *
+     */
+    getWalletProviders(): {
+        [key: string]: string;
+    };
+    /**
+     * This method handles the response from the content script by
+     * calling the response callback with the response and error objects.
+     *
+     * @param event - The event that is sent from the content script.
+     * @returns void
+     *
+     */
+    private handleResponseFromContentScript;
+}
+export declare const connector: Connector;
+export {};
+//# sourceMappingURL=Connector.d.ts.map

package/dist/esm/connector/Connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Connector.d.ts","sourceRoot":"","sources":["../../../src/connector/Connector.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,IAAI,CAAC;AAOZ,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD,KAAK,gBAAgB,GAAG,CACtB,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,KAAK,GAAG,IAAI,KAChB,OAAO,CAAC;AAEb,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,sBAAsB,GACtB,mBAAmB,GACnB,qBAAqB,GACrB,uBAAuB,CAAC;AAE5B,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,uBAAuB,GACvB,oBAAoB,GACpB,sBAAsB,GACtB,wBAAwB,GACxB,QAAQ,EAAE,GACV,MAAM,CAAC;AAEX;;;;;;GAMG;AACH,cAAM,SAAS;IACb,OAAO,CAAC,mBAAmB,CAAiC;IAC5D,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,oBAAoB,CAAwB;IAEpD;;;;;;;;;;;OAWG;;IAgBH;;;;;;;;;;OAUG;IACH,OAAO,CAAC,QAAQ;IAqBhB,OAAO,CAAC,wBAAwB;IAWnB,0BAA0B;IAQvC;;;;;;;;;;;;;;;OAeG;IAEI,0BAA0B,CAC/B,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,eAAe,EACvB,gBAAgB,EAAE,gBAAgB;IAgCpC;;;;;OAKG;IACI,kBAAkB,IAAI;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE;IAItD;;;;;;;OAOG;IACH,OAAO,CAAC,+BAA+B;CAuBxC;AAED,eAAO,MAAM,SAAS,WAAkB,CAAC"}

package/dist/esm/connector/Connector.js

@@ -0,0 +1,172 @@
+/**
+ * This file defines a TypeScript module named connector.
+ * It is the tool that allows the 'provider' and 'account' objects to communicate with the web page script.
+ *
+ * @remarks
+ * - If you are only looking to use our library, the connector object will not be useful to you.
+ * - If you want to work on this repo, you will probably be interested in this object
+ *
+ */
+import { uid } from 'uid';
+import { AvailableCommands, } from '..';
+import { ON_MASSA_STATION_DISCOVERED, ON_MASSA_STATION_DISCONNECTED, MassaStationDiscovery, } from '../massaStation/MassaStationDiscovery';
+import { MASSA_STATION_PROVIDER_NAME } from '../massaStation/MassaStationProvider';
+/**
+ * A constant string that is used to identify the HTML element that is used for
+ * communication between the web page script and the content script.
+ */
+export const MASSA_WINDOW_OBJECT = 'massaWalletProvider';
+/**
+ * This class enables communication with the content script by sending and receiving messages.
+ * @remarks
+ * - This class is used to send messages to the content script and to receive messages from the content script.
+ * - It is used to send messages to the content script and to receive messages from the content script.
+ *
+ */
+class Connector {
+    registeredProviders = {};
+    pendingRequests;
+    massaStationListener;
+    /**
+     * Connector constructor
+     *
+     * @remarks
+     * - The Connector constructor takes no arguments.
+     * - It creates a Map object that is used to store pending requests.
+     * - It creates an HTML element that is used to communicate with the content script.
+     * - It adds an event listener to the HTML element that is used to communicate with the content script.
+     *
+     * @returns An instance of the Connector class.
+     *
+     */
+    constructor() {
+        this.pendingRequests = new Map();
+        this.massaStationListener = new MassaStationDiscovery();
+        this.initMassaStationListener();
+        this.register();
+        // start listening to messages from content script
+        document
+            .getElementById(MASSA_WINDOW_OBJECT)
+            .addEventListener('message', this.handleResponseFromContentScript.bind(this));
+    }
+    /**
+     * This method adds a register listener in the web page.
+     * It listens to the 'register' event.
+     *
+     * @returns void
+     *
+     * @remarks
+     * - It is used to register a new provider.
+     * - This method creates a new HTML element and a listener that listens to the register event.
+     *
+     */
+    register() {
+        // global event target to use for all wallet provider
+        if (!document.getElementById(MASSA_WINDOW_OBJECT)) {
+            const inv = document.createElement('p');
+            inv.id = MASSA_WINDOW_OBJECT;
+            inv.setAttribute('style', 'display:none');
+            document.body.appendChild(inv);
+        }
+        // add an invisible HTML element and set a listener to it like the following
+        // hook up register handler
+        document
+            .getElementById(MASSA_WINDOW_OBJECT)
+            .addEventListener('register', (evt) => {
+            const payload = evt.detail;
+            const providerEventTargetName = `${MASSA_WINDOW_OBJECT}_${payload.providerName}`;
+            this.registeredProviders[payload.providerName] =
+                providerEventTargetName;
+        });
+    }
+    initMassaStationListener() {
+        this.massaStationListener.on(ON_MASSA_STATION_DISCOVERED, () => {
+            this.registeredProviders[MASSA_STATION_PROVIDER_NAME] = `${MASSA_WINDOW_OBJECT}_${MASSA_STATION_PROVIDER_NAME}`;
+        });
+        this.massaStationListener.on(ON_MASSA_STATION_DISCONNECTED, () => {
+            delete this.registeredProviders[MASSA_STATION_PROVIDER_NAME];
+        });
+    }
+    async startMassaStationDiscovery() {
+        try {
+            await this.massaStationListener.startListening();
+        }
+        catch (e) {
+            console.log('MassaStation is not detected');
+        }
+    }
+    /**
+     * This method sends a message from the webpage script to the content script.
+     *
+     * @remarks
+     * Sends a message to the content script using the specified provider name, command, and parameters,
+     *
+     * @privateRemarks
+     * This method registers the response callback with a unique ID.
+     *
+     * @param providerName - The name of the provider.
+     * @param command - The command that is sent to the content script (among the {@link AvailableCommands}).
+     * @param params - The parameters that are sent to the content script.
+     * @param responseCallback - The callback function that is called when the content script sends a response.
+     * @returns void
+     *
+     */
+    sendMessageToContentScript(providerName, command, params, responseCallback) {
+        if (!Object.values(AvailableCommands).includes(command)) {
+            throw new Error(`Unknown command ${command}`);
+        }
+        const requestId = uid();
+        const eventMessageRequest = {
+            params,
+            requestId,
+        };
+        this.pendingRequests.set(requestId, responseCallback);
+        // dispatch an event to the specific provider event target
+        const specificProviderEventTarget = document.getElementById(`${this.registeredProviders[providerName]}`);
+        if (!specificProviderEventTarget) {
+            throw new Error(`Registered provider with name ${providerName} does not exist`);
+        }
+        const isDispatched = specificProviderEventTarget.dispatchEvent(new CustomEvent(command, { detail: eventMessageRequest }));
+        if (!isDispatched) {
+            throw new Error(`Could not dispatch a message to ${this.registeredProviders[providerName]}`);
+        }
+    }
+    /**
+     * This method returns the registered providers.
+     *
+     * @returns The registered provider associated with its unique key.
+     *
+     */
+    getWalletProviders() {
+        return this.registeredProviders;
+    }
+    /**
+     * This method handles the response from the content script by
+     * calling the response callback with the response and error objects.
+     *
+     * @param event - The event that is sent from the content script.
+     * @returns void
+     *
+     */
+    handleResponseFromContentScript(event) {
+        const { result, error, requestId } = event.detail;
+        const responseCallback = this.pendingRequests.get(requestId);
+        if (responseCallback) {
+            if (error) {
+                responseCallback(null, new Error(error.message));
+            }
+            else {
+                responseCallback(result, null);
+            }
+            const deleted = this.pendingRequests.delete(requestId);
+            if (!deleted) {
+                console.error(`Error deleting a pending request with id ${requestId}`);
+            }
+        }
+        else {
+            console.error(`Request Id ${requestId} not found in response callback map`);
+        }
+    }
+}
+export const connector = new Connector();
+//# sourceMappingURL=Connector.js.map

package/dist/esm/connector/Connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Connector.js","sourceRoot":"","sources":["../../../src/connector/Connector.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * This file defines a TypeScript module named connector.\n * It is the tool that allows the 'provider' and 'account' objects to communicate with the web page script.\n *\n * @remarks\n * - If you are only looking to use our library, the connector object will not be useful to you.\n * - If you want to work on this repo, you will probably be interested in this object\n *\n */\nimport { uid } from 'uid';\nimport { ICustomEventMessageResponse } from './ICustomEventMessageResponse';\nimport { ICustomEventMessageRequest } from './ICustomEventMessageRequest';\nimport { IRegisterEvent } from './IRegisterEvent';\nimport {\n  AvailableCommands,\n  IAccountBalanceRequest,\n  IAccountBalanceResponse,\n  IAccountDeletionRequest,\n  IAccountDeletionResponse,\n  IAccountImportRequest,\n  IAccountImportResponse,\n  IAccountSignRequest,\n  IAccountSignResponse,\n} from '..';\nimport {\n  ON_MASSA_STATION_DISCOVERED,\n  ON_MASSA_STATION_DISCONNECTED,\n  MassaStationDiscovery,\n} from '../massaStation/MassaStationDiscovery';\nimport { MASSA_STATION_PROVIDER_NAME } from '../massaStation/MassaStationProvider';\nimport { IAccount } from '../account/IAccount';\n\n/**\n * A constant string that is used to identify the HTML element that is used for\n * communication between the web page script and the content script.\n */\nexport const MASSA_WINDOW_OBJECT = 'massaWalletProvider';\n\ntype CallbackFunction = (\n  result: AllowedResponses,\n  error: Error | null,\n) => unknown;\n\nexport type AllowedRequests =\n  | object\n  | IAccountBalanceRequest\n  | IAccountSignRequest\n  | IAccountImportRequest\n  | IAccountDeletionRequest;\n\nexport type AllowedResponses =\n  | object\n  | IAccountBalanceResponse\n  | IAccountSignResponse\n  | IAccountImportResponse\n  | IAccountDeletionResponse\n  | IAccount[]\n  | string;\n\n/**\n * This class enables communication with the content script by sending and receiving messages.\n * @remarks\n * - This class is used to send messages to the content script and to receive messages from the content script.\n * - It is used to send messages to the content script and to receive messages from the content script.\n *\n */\nclass Connector {\n  private registeredProviders: { [key: string]: string } = {};\n  private pendingRequests: Map<string, CallbackFunction>;\n  private massaStationListener: MassaStationDiscovery;\n\n  /**\n   * Connector constructor\n   *\n   * @remarks\n   * - The Connector constructor takes no arguments.\n   * - It creates a Map object that is used to store pending requests.\n   * - It creates an HTML element that is used to communicate with the content script.\n   * - It adds an event listener to the HTML element that is used to communicate with the content script.\n   *\n   * @returns An instance of the Connector class.\n   *\n   */\n  public constructor() {\n    this.pendingRequests = new Map<string, CallbackFunction>();\n    this.massaStationListener = new MassaStationDiscovery();\n    this.initMassaStationListener();\n    this.register();\n\n    // start listening to messages from content script\n    document\n      .getElementById(MASSA_WINDOW_OBJECT)\n      .addEventListener(\n        'message',\n        this.handleResponseFromContentScript.bind(this),\n      );\n  }\n\n  /**\n   * This method adds a register listener in the web page.\n   * It listens to the 'register' event.\n   *\n   * @returns void\n   *\n   * @remarks\n   * - It is used to register a new provider.\n   * - This method creates a new HTML element and a listener that listens to the register event.\n   *\n   */\n  private register() {\n    // global event target to use for all wallet provider\n    if (!document.getElementById(MASSA_WINDOW_OBJECT)) {\n      const inv = document.createElement('p');\n      inv.id = MASSA_WINDOW_OBJECT;\n      inv.setAttribute('style', 'display:none');\n      document.body.appendChild(inv);\n    }\n\n    // add an invisible HTML element and set a listener to it like the following\n    // hook up register handler\n    document\n      .getElementById(MASSA_WINDOW_OBJECT)\n      .addEventListener('register', (evt: CustomEvent) => {\n        const payload: IRegisterEvent = evt.detail;\n        const providerEventTargetName = `${MASSA_WINDOW_OBJECT}_${payload.providerName}`;\n        this.registeredProviders[payload.providerName] =\n          providerEventTargetName;\n      });\n  }\n\n  private initMassaStationListener() {\n    this.massaStationListener.on(ON_MASSA_STATION_DISCOVERED, () => {\n      this.registeredProviders[\n        MASSA_STATION_PROVIDER_NAME\n      ] = `${MASSA_WINDOW_OBJECT}_${MASSA_STATION_PROVIDER_NAME}`;\n    });\n    this.massaStationListener.on(ON_MASSA_STATION_DISCONNECTED, () => {\n      delete this.registeredProviders[MASSA_STATION_PROVIDER_NAME];\n    });\n  }\n\n  public async startMassaStationDiscovery() {\n    try {\n      await this.massaStationListener.startListening();\n    } catch (e) {\n      console.log('MassaStation is not detected');\n    }\n  }\n\n  /**\n   * This method sends a message from the webpage script to the content script.\n   *\n   * @remarks\n   * Sends a message to the content script using the specified provider name, command, and parameters,\n   *\n   * @privateRemarks\n   * This method registers the response callback with a unique ID.\n   *\n   * @param providerName - The name of the provider.\n   * @param command - The command that is sent to the content script (among the {@link AvailableCommands}).\n   * @param params - The parameters that are sent to the content script.\n   * @param responseCallback - The callback function that is called when the content script sends a response.\n   * @returns void\n   *\n   */\n\n  public sendMessageToContentScript(\n    providerName: string,\n    command: AvailableCommands,\n    params: AllowedRequests,\n    responseCallback: CallbackFunction,\n  ) {\n    if (!Object.values(AvailableCommands).includes(command)) {\n      throw new Error(`Unknown command ${command}`);\n    }\n\n    const requestId = uid();\n    const eventMessageRequest: ICustomEventMessageRequest = {\n      params,\n      requestId,\n    };\n    this.pendingRequests.set(requestId, responseCallback);\n\n    // dispatch an event to the specific provider event target\n    const specificProviderEventTarget = document.getElementById(\n      `${this.registeredProviders[providerName]}`,\n    ) as EventTarget;\n    if (!specificProviderEventTarget) {\n      throw new Error(\n        `Registered provider with name ${providerName} does not exist`,\n      );\n    }\n    const isDispatched = specificProviderEventTarget.dispatchEvent(\n      new CustomEvent(command, { detail: eventMessageRequest }),\n    );\n    if (!isDispatched) {\n      throw new Error(\n        `Could not dispatch a message to ${this.registeredProviders[providerName]}`,\n      );\n    }\n  }\n\n  /**\n   * This method returns the registered providers.\n   *\n   * @returns The registered provider associated with its unique key.\n   *\n   */\n  public getWalletProviders(): { [key: string]: string } {\n    return this.registeredProviders;\n  }\n\n  /**\n   * This method handles the response from the content script by\n   * calling the response callback with the response and error objects.\n   *\n   * @param event - The event that is sent from the content script.\n   * @returns void\n   *\n   */\n  private handleResponseFromContentScript(event: CustomEvent) {\n    const { result, error, requestId }: ICustomEventMessageResponse =\n      event.detail;\n\n    const responseCallback: CallbackFunction =\n      this.pendingRequests.get(requestId);\n\n    if (responseCallback) {\n      if (error) {\n        responseCallback(null, new Error(error.message));\n      } else {\n        responseCallback(result, null);\n      }\n      const deleted = this.pendingRequests.delete(requestId);\n      if (!deleted) {\n        console.error(`Error deleting a pending request with id ${requestId}`);\n      }\n    } else {\n      console.error(\n        `Request Id ${requestId} not found in response callback map`,\n      );\n    }\n  }\n}\n\nexport const connector = new Connector();\n"]}

package/dist/esm/connector/ICustomEventMessageRequest.d.ts

@@ -0,0 +1,10 @@
+import { AllowedRequests } from './Connector';
+/**
+ * This interface represents the request done by the web page script to the content script
+ * in order to setup a custom event.
+ */
+export interface ICustomEventMessageRequest {
+    params: AllowedRequests;
+    requestId: string;
+}
+//# sourceMappingURL=ICustomEventMessageRequest.d.ts.map

package/dist/esm/connector/ICustomEventMessageRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICustomEventMessageRequest.d.ts","sourceRoot":"","sources":["../../../src/connector/ICustomEventMessageRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/esm/connector/ICustomEventMessageRequest.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ICustomEventMessageRequest.js.map

package/dist/esm/connector/ICustomEventMessageRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICustomEventMessageRequest.js","sourceRoot":"","sources":["../../../src/connector/ICustomEventMessageRequest.ts"],"names":[],"mappings":"","sourcesContent":["import { AllowedRequests } from './Connector';\n\n/**\n * This interface represents the request done by the web page script to the content script\n * in order to setup a custom event.\n */\nexport interface ICustomEventMessageRequest {\n  params: AllowedRequests;\n  requestId: string;\n}\n"]}

package/dist/esm/connector/ICustomEventMessageResponse.d.ts

@@ -0,0 +1,11 @@
+import { AllowedResponses } from './Connector';
+/**
+ * This interface represents the response from the content script to the web page script
+ * for an ICustomEventMessageRequest.
+ */
+export interface ICustomEventMessageResponse {
+    result?: AllowedResponses;
+    error?: Error;
+    requestId: string;
+}
+//# sourceMappingURL=ICustomEventMessageResponse.d.ts.map

package/dist/esm/connector/ICustomEventMessageResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICustomEventMessageResponse.d.ts","sourceRoot":"","sources":["../../../src/connector/ICustomEventMessageResponse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/esm/connector/ICustomEventMessageResponse.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ICustomEventMessageResponse.js.map

package/dist/esm/connector/ICustomEventMessageResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICustomEventMessageResponse.js","sourceRoot":"","sources":["../../../src/connector/ICustomEventMessageResponse.ts"],"names":[],"mappings":"","sourcesContent":["import { AllowedResponses } from './Connector';\n\n/**\n * This interface represents the response from the content script to the web page script\n * for an ICustomEventMessageRequest.\n */\nexport interface ICustomEventMessageResponse {\n  result?: AllowedResponses;\n  error?: Error;\n  requestId: string;\n}\n"]}

package/dist/esm/connector/IRegisterEvent.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This interface represents the object that is used to register an event.
+ */
+export interface IRegisterEvent {
+    providerName: string;
+    eventTarget: string;
+}
+//# sourceMappingURL=IRegisterEvent.d.ts.map

package/dist/esm/connector/IRegisterEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRegisterEvent.d.ts","sourceRoot":"","sources":["../../../src/connector/IRegisterEvent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/esm/connector/IRegisterEvent.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IRegisterEvent.js.map

package/dist/esm/connector/IRegisterEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRegisterEvent.js","sourceRoot":"","sources":["../../../src/connector/IRegisterEvent.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * This interface represents the object that is used to register an event.\n */\nexport interface IRegisterEvent {\n  providerName: string;\n  eventTarget: string;\n}\n"]}

package/dist/esm/connector/index.d.ts

@@ -0,0 +1,5 @@
+export { connector, AllowedRequests, AllowedResponses, MASSA_WINDOW_OBJECT, } from './Connector';
+export { ICustomEventMessageRequest } from './ICustomEventMessageRequest';
+export { ICustomEventMessageResponse } from './ICustomEventMessageResponse';
+export { IRegisterEvent } from './IRegisterEvent';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/connector/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connector/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/esm/connector/index.js

@@ -0,0 +1,2 @@
+export { connector, MASSA_WINDOW_OBJECT, } from './Connector';
+//# sourceMappingURL=index.js.map

package/dist/esm/connector/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/connector/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EAGT,mBAAmB,GACpB,MAAM,aAAa,CAAC","sourcesContent":["export {\n  connector,\n  AllowedRequests,\n  AllowedResponses,\n  MASSA_WINDOW_OBJECT,\n} from './Connector';\nexport { ICustomEventMessageRequest } from './ICustomEventMessageRequest';\nexport { ICustomEventMessageResponse } from './ICustomEventMessageResponse';\nexport { IRegisterEvent } from './IRegisterEvent';\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,48 @@
+/// <reference types="node" />
+/** Polyfills */
+import { Buffer } from 'buffer';
+declare global {
+    interface Window {
+        Buffer: typeof Buffer;
+    }
+}
+import { IProvider } from './provider/IProvider';
+export declare enum AvailableCommands {
+    ProviderListAccounts = "LIST_ACCOUNTS",
+    ProviderDeleteAccount = "DELETE_ACCOUNT",
+    ProviderImportAccount = "IMPORT_ACCOUNT",
+    ProviderGetNodesUrls = "GET_NODES_URLS",
+    AccountBalance = "ACCOUNT_BALANCE",
+    AccountSign = "ACCOUNT_SIGN",
+    ProviderGenerateNewAccount = "GENERATE_NEW_ACCOUNT",
+    AccountSellRolls = "ACCOUNT_SELL_ROLLS",
+    AccountBuyRolls = "ACCOUNT_BUY_ROLLS",
+    AccountSendTransaction = "ACCOUNT_SEND_TRANSACTION",
+    AccountCallSC = "ACCOUNT_CALL_SC"
+}
+export interface ITransactionDetails {
+    operationId: string;
+}
+/**
+ * Get the list of providers that are available to interact with.
+ *
+ * @param retry - If true, will retry to get the list of providers if none are available.
+ * @param pollInterval - The timeout in milliseconds to wait between retries. default is 2000ms.
+ * @param timeout - The timeout in milliseconds to wait before giving up. default is 3000ms.
+ *
+ * @returns An array of providers.
+ */
+export declare function providers(retry?: boolean, timeout?: number, pollInterval?: number): Promise<IProvider[]>;
+/**
+ * Manually register a provider to interact with.
+ *
+ * @param name - The name of the provider.
+ * @param id - The id of the HTML element that is used to communicate with the provider.
+ */
+export declare function registerProvider(name: string, id?: string): void;
+export { AllowedRequests, AllowedResponses } from './connector';
+export { IAccountDetails, IAccountBalanceRequest, IAccountBalanceResponse, IAccountSignRequest, IAccountSignResponse, IAccount, Account, IAccountRollsRequest, IAccountSendTransactionRequest, IAccountCallSCRequest, } from './account';
+export { EAccountDeletionResponse, EAccountImportResponse, IAccountDeletionRequest, IAccountDeletionResponse, IAccountImportRequest, IAccountImportResponse, IProvider, Provider, } from './provider';
+export { IMassaStationWallet } from './massaStation/MassaStationProvider';
+export { MassaStationAccount } from './massaStation/MassaStationAccount';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,gBAAgB;AAChB,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,MAAM,EAAE,OAAO,MAAM,CAAC;KACvB;CACF;AAQD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAOjD,oBAAY,iBAAiB;IAC3B,oBAAoB,kBAAkB;IACtC,qBAAqB,mBAAmB;IACxC,qBAAqB,mBAAmB;IACxC,oBAAoB,mBAAmB;IACvC,cAAc,oBAAoB;IAClC,WAAW,iBAAiB;IAC5B,0BAA0B,yBAAyB;IACnD,gBAAgB,uBAAuB;IACvC,eAAe,sBAAsB;IACrC,sBAAsB,6BAA6B;IACnD,aAAa,oBAAoB;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,KAAK,UAAO,EACZ,OAAO,SAAO,EACd,YAAY,SAAM,GACjB,OAAO,CAAC,SAAS,EAAE,CAAC,CA6BtB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,SAAsB,GAAG,IAAI,CAQ7E;AAED,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,QAAQ,EACR,OAAO,EACP,oBAAoB,EACpB,8BAA8B,EAC9B,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAE1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,79 @@
+/** Polyfills */
+import { Buffer } from 'buffer';
+// Check if we are on browser
+if (typeof window !== 'undefined') {
+    window.Buffer = Buffer;
+}
+import { MASSA_WINDOW_OBJECT, connector } from './connector/Connector';
+import { Provider } from './provider/Provider';
+import { MASSA_STATION_PROVIDER_NAME, MassaStationProvider, } from './massaStation/MassaStationProvider';
+export var AvailableCommands;
+(function (AvailableCommands) {
+    AvailableCommands["ProviderListAccounts"] = "LIST_ACCOUNTS";
+    AvailableCommands["ProviderDeleteAccount"] = "DELETE_ACCOUNT";
+    AvailableCommands["ProviderImportAccount"] = "IMPORT_ACCOUNT";
+    AvailableCommands["ProviderGetNodesUrls"] = "GET_NODES_URLS";
+    AvailableCommands["AccountBalance"] = "ACCOUNT_BALANCE";
+    AvailableCommands["AccountSign"] = "ACCOUNT_SIGN";
+    AvailableCommands["ProviderGenerateNewAccount"] = "GENERATE_NEW_ACCOUNT";
+    AvailableCommands["AccountSellRolls"] = "ACCOUNT_SELL_ROLLS";
+    AvailableCommands["AccountBuyRolls"] = "ACCOUNT_BUY_ROLLS";
+    AvailableCommands["AccountSendTransaction"] = "ACCOUNT_SEND_TRANSACTION";
+    AvailableCommands["AccountCallSC"] = "ACCOUNT_CALL_SC";
+})(AvailableCommands || (AvailableCommands = {}));
+/**
+ * Get the list of providers that are available to interact with.
+ *
+ * @param retry - If true, will retry to get the list of providers if none are available.
+ * @param pollInterval - The timeout in milliseconds to wait between retries. default is 2000ms.
+ * @param timeout - The timeout in milliseconds to wait before giving up. default is 3000ms.
+ *
+ * @returns An array of providers.
+ */
+export async function providers(retry = true, timeout = 3000, pollInterval = 500) {
+    if (timeout <= 0) {
+        return [];
+    }
+    await connector.startMassaStationDiscovery();
+    return new Promise((resolve) => {
+        let provider = [];
+        for (const providerName of Object.keys(connector.getWalletProviders())) {
+            if (providerName === MASSA_STATION_PROVIDER_NAME) {
+                const p = new MassaStationProvider();
+                provider.push(p);
+            }
+            else {
+                const p = new Provider(providerName);
+                provider.push(p);
+            }
+        }
+        // If no providers are available, wait and try again
+        if (retry && provider.length === 0) {
+            setTimeout(() => {
+                providers(retry, timeout - pollInterval, pollInterval).then(resolve);
+            }, pollInterval);
+        }
+        else {
+            resolve(provider);
+        }
+    });
+}
+/**
+ * Manually register a provider to interact with.
+ *
+ * @param name - The name of the provider.
+ * @param id - The id of the HTML element that is used to communicate with the provider.
+ */
+export function registerProvider(name, id = MASSA_WINDOW_OBJECT) {
+    const registerEvent = new CustomEvent('register', {
+        detail: { providerName: name },
+    });
+    const element = document.getElementById(id);
+    if (element) {
+        element.dispatchEvent(registerEvent);
+    }
+}
+export { Account, } from './account';
+export { EAccountDeletionResponse, EAccountImportResponse, Provider, } from './provider';
+export { MassaStationAccount } from './massaStation/MassaStationAccount';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAQhC,6BAA6B;AAC7B,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE;IACjC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,qCAAqC,CAAC;AAE7C,MAAM,CAAN,IAAY,iBAYX;AAZD,WAAY,iBAAiB;IAC3B,2DAAsC,CAAA;IACtC,6DAAwC,CAAA;IACxC,6DAAwC,CAAA;IACxC,4DAAuC,CAAA;IACvC,uDAAkC,CAAA;IAClC,iDAA4B,CAAA;IAC5B,wEAAmD,CAAA;IACnD,4DAAuC,CAAA;IACvC,0DAAqC,CAAA;IACrC,wEAAmD,CAAA;IACnD,sDAAiC,CAAA;AACnC,CAAC,EAZW,iBAAiB,KAAjB,iBAAiB,QAY5B;AAMD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAAK,GAAG,IAAI,EACZ,OAAO,GAAG,IAAI,EACd,YAAY,GAAG,GAAG;IAElB,IAAI,OAAO,IAAI,CAAC,EAAE;QAChB,OAAO,EAAE,CAAC;KACX;IAED,MAAM,SAAS,CAAC,0BAA0B,EAAE,CAAC;IAE7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,QAAQ,GAAgB,EAAE,CAAC;QAE/B,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,kBAAkB,EAAE,CAAC,EAAE;YACtE,IAAI,YAAY,KAAK,2BAA2B,EAAE;gBAChD,MAAM,CAAC,GAAG,IAAI,oBAAoB,EAAE,CAAC;gBACrC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;aAClB;iBAAM;gBACL,MAAM,CAAC,GAAG,IAAI,QAAQ,CAAC,YAAY,CAAC,CAAC;gBACrC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;aAClB;SACF;QAED,oDAAoD;QACpD,IAAI,KAAK,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE;YAClC,UAAU,CAAC,GAAG,EAAE;gBACd,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvE,CAAC,EAAE,YAAY,CAAC,CAAC;SAClB;aAAM;YACL,OAAO,CAAC,QAAQ,CAAC,CAAC;SACnB;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,EAAE,GAAG,mBAAmB;IACrE,MAAM,aAAa,GAAG,IAAI,WAAW,CAAC,UAAU,EAAE;QAChD,MAAM,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;KAC/B,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IAC5C,IAAI,OAAO,EAAE;QACX,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC;KACtC;AACH,CAAC;AAID,OAAO,EAOL,OAAO,GAIR,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EAMtB,QAAQ,GACT,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC","sourcesContent":["/** Polyfills */\nimport { Buffer } from 'buffer';\n\ndeclare global {\n  interface Window {\n    Buffer: typeof Buffer;\n  }\n}\n\n// Check if we are on browser\nif (typeof window !== 'undefined') {\n  window.Buffer = Buffer;\n}\n\nimport { MASSA_WINDOW_OBJECT, connector } from './connector/Connector';\nimport { IProvider } from './provider/IProvider';\nimport { Provider } from './provider/Provider';\nimport {\n  MASSA_STATION_PROVIDER_NAME,\n  MassaStationProvider,\n} from './massaStation/MassaStationProvider';\n\nexport enum AvailableCommands {\n  ProviderListAccounts = 'LIST_ACCOUNTS',\n  ProviderDeleteAccount = 'DELETE_ACCOUNT',\n  ProviderImportAccount = 'IMPORT_ACCOUNT',\n  ProviderGetNodesUrls = 'GET_NODES_URLS',\n  AccountBalance = 'ACCOUNT_BALANCE',\n  AccountSign = 'ACCOUNT_SIGN',\n  ProviderGenerateNewAccount = 'GENERATE_NEW_ACCOUNT',\n  AccountSellRolls = 'ACCOUNT_SELL_ROLLS',\n  AccountBuyRolls = 'ACCOUNT_BUY_ROLLS',\n  AccountSendTransaction = 'ACCOUNT_SEND_TRANSACTION',\n  AccountCallSC = 'ACCOUNT_CALL_SC',\n}\n\nexport interface ITransactionDetails {\n  operationId: string;\n}\n\n/**\n * Get the list of providers that are available to interact with.\n *\n * @param retry - If true, will retry to get the list of providers if none are available.\n * @param pollInterval - The timeout in milliseconds to wait between retries. default is 2000ms.\n * @param timeout - The timeout in milliseconds to wait before giving up. default is 3000ms.\n *\n * @returns An array of providers.\n */\nexport async function providers(\n  retry = true,\n  timeout = 3000,\n  pollInterval = 500,\n): Promise<IProvider[]> {\n  if (timeout <= 0) {\n    return [];\n  }\n\n  await connector.startMassaStationDiscovery();\n\n  return new Promise((resolve) => {\n    let provider: IProvider[] = [];\n\n    for (const providerName of Object.keys(connector.getWalletProviders())) {\n      if (providerName === MASSA_STATION_PROVIDER_NAME) {\n        const p = new MassaStationProvider();\n        provider.push(p);\n      } else {\n        const p = new Provider(providerName);\n        provider.push(p);\n      }\n    }\n\n    // If no providers are available, wait and try again\n    if (retry && provider.length === 0) {\n      setTimeout(() => {\n        providers(retry, timeout - pollInterval, pollInterval).then(resolve);\n      }, pollInterval);\n    } else {\n      resolve(provider);\n    }\n  });\n}\n\n/**\n * Manually register a provider to interact with.\n *\n * @param name - The name of the provider.\n * @param id - The id of the HTML element that is used to communicate with the provider.\n */\nexport function registerProvider(name: string, id = MASSA_WINDOW_OBJECT): void {\n  const registerEvent = new CustomEvent('register', {\n    detail: { providerName: name },\n  });\n  const element = document.getElementById(id);\n  if (element) {\n    element.dispatchEvent(registerEvent);\n  }\n}\n\nexport { AllowedRequests, AllowedResponses } from './connector';\n\nexport {\n  IAccountDetails,\n  IAccountBalanceRequest,\n  IAccountBalanceResponse,\n  IAccountSignRequest,\n  IAccountSignResponse,\n  IAccount,\n  Account,\n  IAccountRollsRequest,\n  IAccountSendTransactionRequest,\n  IAccountCallSCRequest,\n} from './account';\n\nexport {\n  EAccountDeletionResponse,\n  EAccountImportResponse,\n  IAccountDeletionRequest,\n  IAccountDeletionResponse,\n  IAccountImportRequest,\n  IAccountImportResponse,\n  IProvider,\n  Provider,\n} from './provider';\n\nexport { IMassaStationWallet } from './massaStation/MassaStationProvider';\n\nexport { MassaStationAccount } from './massaStation/MassaStationAccount';\n"]}

package/dist/esm/massaStation/MassaStationAccount.d.ts

@@ -0,0 +1,103 @@
+import { IAccountBalanceResponse, IAccountDetails, IAccountSignResponse, ITransactionDetails } from '..';
+import { IAccount } from '../account/IAccount';
+import { Args, IContractReadOperationResponse } from '@massalabs/web3-utils';
+/**
+ * This module contains the MassaStationAccount class. It is responsible for representing an account in
+ * the MassaStation wallet.
+ *
+ * @remarks
+ * This class provides methods to interact with MassaStation account's {@link balance} and to {@link sign} messages.
+ *
+ */
+export declare class MassaStationAccount implements IAccount {
+    private _providerName;
+    private _address;
+    private _name;
+    /**
+     * This constructor takes an object of type IAccountDetails and a providerName string as its arguments.
+     *
+     * @param address - The address of the account.
+     * @param name - The name of the account.
+     * @param providerName - The name of the provider.
+     * @returns An instance of the Account class.
+     *
+     * @remarks
+     * - The Account constructor takes an object of type IAccountDetails and a providerName string as its arguments.
+     * - The IAccountDetails object contains the account's address and name.
+     * - The providerName string identifies the provider that is used to interact with the blockchain.
+     */
+    constructor({ address, name }: IAccountDetails, providerName: string);
+    /**
+     * @returns The address of the account.
+     */
+    address(): string;
+    /**
+     * @returns The name of the account.
+     */
+    name(): string;
+    /**
+     * @returns The name of the provider.
+     */
+    providerName(): string;
+    /**
+     * This method aims to retrieve the account's balance.
+     *
+     * @returns A promise that resolves to an object of type IAccountBalanceResponse. It contains the account's balance.
+     */
+    balance(): Promise<IAccountBalanceResponse>;
+    /**
+     * This method aims to sign a message.
+     *
+     * @param data - The message to be signed.
+     * @returns An IAccountSignResponse object. It contains the signature of the message.
+     */
+    sign(data: Uint8Array | string): Promise<IAccountSignResponse>;
+    /**
+     * This method aims to buy rolls on behalf of the sender.
+     *
+     * @param amount - The amount of rolls to be bought.
+     * @param fee - The fee to be paid for the transaction execution by the node.
+     * @returns An ITransactionDetails object. It contains the operationId on the network.
+     */
+    buyRolls(amount: bigint, fee: bigint): Promise<ITransactionDetails>;
+    /**
+     * This method aims to sell rolls on behalf of the sender.
+     *
+     * @param amount - The amount of rolls to be sold.
+     * @param fee - The fee to be paid for the transaction execution by the node.
+     * @returns An ITransactionDetails object. It contains the operationId on the network.
+     */
+    sellRolls(amount: bigint, fee: bigint): Promise<ITransactionDetails>;
+    /**
+     * This method aims to transfer MAS on behalf of the sender to a recipient.
+     *
+     * @param amount - The amount of MAS (in the smallest unit) to be transferred.
+     * @param fee - The fee to be paid for the transaction execution (in the smallest unit).
+     * @returns An ITransactionDetails object. It contains the operationId on the network.
+     */
+    sendTransaction(amount: bigint, recipientAddress: string, fee: bigint): Promise<ITransactionDetails>;
+    /**
+     * This method aims to interact with a smart contract deployed on the MASSA blockchain.
+     *
+     * @remarks
+     * If dryRun.dryRun is true, the method will dry run the smart contract call and return an
+     * IContractReadOperationResponse object which contains all the information about the dry run
+     * (state changes, gas used, etc.)
+     *
+     * @param contractAddress - The address of the smart contract.
+     * @param functionName - The name of the function to be called.
+     * @param parameter - The parameters as an Args object to be passed to the function.
+     * @param amount - The amount of MASSA coins to be sent to the contract (in the smallest unit).
+     * @param fee - The fee to be paid for the transaction execution (in the smallest unit).
+     * @param maxGas - The maximum amount of gas to be used for the transaction execution.
+     * @param nonPersistentExecution - The dryRun object to be passed to the function.
+     *
+     * @returns if 'nonPersistentExecution' is true, it returns an IContractReadOperationResponse object.
+     * Otherwise, it returns an ITransactionDetails object which contains the operationId on the network.
+     *
+     */
+    callSC(contractAddress: string, functionName: string, parameter: Uint8Array | Args, amount: bigint, fee: bigint, maxGas: bigint, nonPersistentExecution?: boolean): Promise<ITransactionDetails | IContractReadOperationResponse>;
+    getNodeUrlFromMassaStation(): Promise<string>;
+    nonPersistentCallSC(contractAddress: string, functionName: string, parameter: Uint8Array | Args, amount: bigint, fee: bigint, maxGas: bigint): Promise<IContractReadOperationResponse>;
+}
+//# sourceMappingURL=MassaStationAccount.d.ts.map

package/dist/esm/massaStation/MassaStationAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MassaStationAccount.d.ts","sourceRoot":"","sources":["../../../src/massaStation/MassaStationAccount.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,IAAI,CAAC;AACZ,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAM/C,OAAO,EACL,IAAI,EAEJ,8BAA8B,EAC/B,MAAM,uBAAuB,CAAC;AAoC/B;;;;;;;GAOG;AACH,qBAAa,mBAAoB,YAAW,QAAQ;IAClD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;IAEtB;;;;;;;;;;;;OAYG;gBACgB,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM;IAM3E;;OAEG;IACI,OAAO,IAAI,MAAM;IAIxB;;OAEG;IACI,IAAI,IAAI,MAAM;IAIrB;;OAEG;IACI,YAAY,IAAI,MAAM;IAI7B;;;;OAIG;IACU,OAAO,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAqBxD;;;;;OAKG;IACU,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAoB3E;;;;;;OAMG;IACU,QAAQ,CACnB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,CAAC;IAoB/B;;;;;;OAMG;IACU,SAAS,CACpB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,CAAC;IAoB/B;;;;;;OAMG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EACxB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,CAAC;IAsB/B;;;;;;;;;;;;;;;;;;;OAmBG;IACU,MAAM,CACjB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,UAAU,GAAG,IAAI,EAC5B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,sBAAsB,UAAQ,GAC7B,OAAO,CAAC,mBAAmB,GAAG,8BAA8B,CAAC;IAyCnD,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC;IAoB7C,mBAAmB,CAC9B,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,UAAU,GAAG,IAAI,EAC5B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,8BAA8B,CAAC;CAgE3C"}