@massalabs/wallet-provider 0.0.0 → 0.0.1-dev.20230424074402

package/dist/account/Account.d.ts

@@ -0,0 +1,80 @@
+import { IAccountBalanceResponse } from './AccountBalance';
+import { IAccountSignResponse } from './AccountSign';
+import { IAccountDetails } from './IAccountDetails';
+import { ITransactionDetails } from '..';
+import { IAccount } from './IAccount';
+/**
+ * This module contains the Account class. It is responsible for representing an account in the wallet.
+ *
+ * @remarks
+ * This class provides methods to interact with the account's {@link balance} and to {@link sign} messages.
+ *
+ */
+export declare class Account 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): Promise<IAccountSignResponse>;
+    /**
+     * This method aims to buy rolls on behalf of the sender.
+     *
+     * @param amount - The amount of rolls to be purchased
+     * @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 to be transferred.
+     * @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.
+     */
+    sendTransaction(amount: bigint, recipientAddress: string, fee: bigint): Promise<ITransactionDetails>;
+}

package/dist/account/Account.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Account = void 0;
+const Connector_1 = require("../connector/Connector");
+const __1 = require("..");
+/**
+ * This module contains the Account class. It is responsible for representing an account in the wallet.
+ *
+ * @remarks
+ * This class provides methods to interact with the account's {@link balance} and to {@link sign} messages.
+ *
+ */
+class Account {
+    /**
+     * 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 }, providerName) {
+        this._address = address;
+        this._name = name;
+        this._providerName = providerName;
+    }
+    /**
+     * @returns The address of the account.
+     */
+    address() {
+        return this._address;
+    }
+    /**
+     * @returns The name of the account.
+     */
+    name() {
+        return this._name;
+    }
+    /**
+     * @returns The name of the provider.
+     */
+    providerName() {
+        return this._providerName;
+    }
+    /**
+     * 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.
+     */
+    async balance() {
+        return new Promise((resolve, reject) => {
+            Connector_1.connector.sendMessageToContentScript(this._providerName, __1.AvailableCommands.AccountBalance, { address: this._address }, (result, err) => {
+                if (err)
+                    return reject(err);
+                return resolve(result);
+            });
+        });
+    }
+    /**
+     * 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.
+     */
+    async sign(data) {
+        return new Promise((resolve, reject) => {
+            Connector_1.connector.sendMessageToContentScript(this._providerName, __1.AvailableCommands.AccountSign, { address: this._address, data }, (result, err) => {
+                if (err)
+                    return reject(err);
+                return resolve(result);
+            });
+        });
+    }
+    /**
+     * This method aims to buy rolls on behalf of the sender.
+     *
+     * @param amount - The amount of rolls to be purchased
+     * @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.
+     */
+    async buyRolls(amount, fee) {
+        return new Promise((resolve, reject) => {
+            Connector_1.connector.sendMessageToContentScript(this._providerName, __1.AvailableCommands.AccountBuyRolls, {
+                amount: amount.toString(),
+                fee: fee.toString(),
+            }, (result, err) => {
+                if (err)
+                    return reject(err);
+                return resolve(result);
+            });
+        });
+    }
+    /**
+     * 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.
+     */
+    async sellRolls(amount, fee) {
+        return new Promise((resolve, reject) => {
+            Connector_1.connector.sendMessageToContentScript(this._providerName, __1.AvailableCommands.AccountSellRolls, {
+                amount: amount.toString(),
+                fee: fee.toString(),
+            }, (result, err) => {
+                if (err)
+                    return reject(err);
+                return resolve(result);
+            });
+        });
+    }
+    /**
+     * This method aims to transfer MAS on behalf of the sender to a recipient.
+     *
+     * @param amount - The amount of MAS to be transferred.
+     * @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.
+     */
+    async sendTransaction(amount, recipientAddress, fee) {
+        return new Promise((resolve, reject) => {
+            Connector_1.connector.sendMessageToContentScript(this._providerName, __1.AvailableCommands.AccountSendTransaction, {
+                amount: amount.toString(),
+                recipientAddress,
+                fee: fee.toString(),
+            }, (result, err) => {
+                if (err)
+                    return reject(err);
+                return resolve(result);
+            });
+        });
+    }
+}
+exports.Account = Account;
+//# sourceMappingURL=Account.js.map

package/dist/account/Account.js.map

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

package/dist/account/AccountBalance.d.ts

@@ -0,0 +1,13 @@
+/**
+ * This interface represents the request object of the AccountBalance command.
+ */
+export interface IAccountBalanceRequest {
+    address: string;
+}
+/**
+ * This interface represents the response object of the AccountBalance command sent by the content script.
+ */
+export interface IAccountBalanceResponse {
+    finalBalance: string;
+    candidateBalance: string;
+}

package/dist/account/AccountBalance.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=AccountBalance.js.map

package/dist/account/AccountBalance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountBalance.js","sourceRoot":"","sources":["../../src/account/AccountBalance.ts"],"names":[],"mappings":""}

package/dist/account/AccountSign.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This interface represents the request object for the signing operation sent to the content script.
+ */
+export interface IAccountSignRequest {
+    address: string;
+    data: Uint8Array;
+}
+/**
+ * This interface represents the response object containing the signed message data, which is sent by the content script
+ * after the signing operation.
+ */
+export interface IAccountSignResponse {
+    publicKey: string;
+    signature: Uint8Array;
+}

package/dist/account/AccountSign.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=AccountSign.js.map

package/dist/account/AccountSign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccountSign.js","sourceRoot":"","sources":["../../src/account/AccountSign.ts"],"names":[],"mappings":""}

package/dist/account/IAccount.d.ts

@@ -0,0 +1,16 @@
+import { ITransactionDetails } from '..';
+import { IAccountBalanceResponse } from './AccountBalance';
+import { IAccountSignResponse } from './AccountSign';
+/**
+ * This interface represents an Account object.
+ */
+export interface IAccount {
+    address(): string;
+    name(): string;
+    providerName(): string;
+    balance(): Promise<IAccountBalanceResponse>;
+    sign(data: Uint8Array | string): Promise<IAccountSignResponse>;
+    buyRolls(amount: bigint, fee: bigint): Promise<ITransactionDetails>;
+    sellRolls(amount: bigint, fee: bigint): Promise<ITransactionDetails>;
+    sendTransaction(amount: bigint, recipientAddress: string, fee: bigint): Promise<ITransactionDetails>;
+}

package/dist/account/IAccount.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IAccount.js.map

package/dist/account/IAccount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAccount.js","sourceRoot":"","sources":["../../src/account/IAccount.ts"],"names":[],"mappings":""}

package/dist/account/IAccountDetails.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This interface represents the account details such as name and address.
+ */
+export interface IAccountDetails {
+    name?: string;
+    address: string;
+}

package/dist/account/IAccountDetails.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IAccountDetails.js.map

package/dist/account/IAccountDetails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAccountDetails.js","sourceRoot":"","sources":["../../src/account/IAccountDetails.ts"],"names":[],"mappings":""}

package/dist/account/IAccountRolls.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This interface represents the request object for roll operations (buy & sell) sent to the content script.
+ */
+export interface IAccountRollsRequest {
+    amount: string;
+    fee: string;
+}

package/dist/account/IAccountRolls.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IAccountRolls.js.map

package/dist/account/IAccountRolls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAccountRolls.js","sourceRoot":"","sources":["../../src/account/IAccountRolls.ts"],"names":[],"mappings":""}

package/dist/account/IAccountSendTransaction.d.ts

@@ -0,0 +1,8 @@
+/**
+ * This interface represents the request object for roll operations (buy & sell) sent to the content script.
+ */
+export interface IAccountSendTransactionRequest {
+    recipientAddress: string;
+    amount: string;
+    fee: string;
+}

package/dist/account/IAccountSendTransaction.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IAccountSendTransaction.js.map

package/dist/account/IAccountSendTransaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAccountSendTransaction.js","sourceRoot":"","sources":["../../src/account/IAccountSendTransaction.ts"],"names":[],"mappings":""}

package/dist/account/index.d.ts

@@ -0,0 +1,7 @@
+export { Account } from './Account';
+export { IAccountBalanceRequest, IAccountBalanceResponse, } from './AccountBalance';
+export { IAccount } from './IAccount';
+export { IAccountSignRequest, IAccountSignResponse } from './AccountSign';
+export { IAccountDetails } from './IAccountDetails';
+export { IAccountRollsRequest } from './IAccountRolls';
+export { IAccountSendTransactionRequest } from './IAccountSendTransaction';

package/dist/account/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Account = void 0;
+var Account_1 = require("./Account");
+Object.defineProperty(exports, "Account", { enumerable: true, get: function () { return Account_1.Account; } });
+//# sourceMappingURL=index.js.map

package/dist/account/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/account/index.ts"],"names":[],"mappings":";;;AAAA,qCAAoC;AAA3B,kGAAA,OAAO,OAAA"}

package/dist/connector/Connector.d.ts

@@ -0,0 +1,79 @@
+import { AvailableCommands, IAccountBalanceRequest, IAccountBalanceResponse, IAccountDeletionRequest, IAccountDeletionResponse, IAccountImportRequest, IAccountImportResponse, IAccountSignRequest, IAccountSignResponse } from '..';
+import { IAccount } from '../account/IAccount';
+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 thyraListener;
+    /**
+     * 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;
+    /**
+     * 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 {};

package/dist/connector/Connector.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.connector = void 0;
+/**
+ * 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
+ *
+ */
+const uid_1 = require("uid");
+const __1 = require("..");
+const ThyraDiscovery_1 = require("../thyra/ThyraDiscovery");
+const ThyraProvider_1 = require("../thyra/ThyraProvider");
+/**
+ * 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.
+ */
+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 {
+    /**
+     * 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.registeredProviders = {};
+        this.pendingRequests = new Map();
+        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;
+        });
+        // start thyra discovery
+        this.thyraListener = new ThyraDiscovery_1.ThyraDiscovery(1000);
+        this.thyraListener.startListening();
+        this.thyraListener.on(ThyraDiscovery_1.ON_THYRA_DISCOVERED, () => {
+            this.registeredProviders[ThyraProvider_1.THYRA_PROVIDER_NAME] = `${MASSA_WINDOW_OBJECT}_${ThyraProvider_1.THYRA_PROVIDER_NAME}`;
+        });
+        this.thyraListener.on(ThyraDiscovery_1.ON_THYRA_DISCONNECTED, () => {
+            delete this.registeredProviders[ThyraProvider_1.THYRA_PROVIDER_NAME];
+        });
+    }
+    /**
+     * 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(__1.AvailableCommands).includes(command)) {
+            throw new Error(`Unknown command ${command}`);
+        }
+        const requestId = (0, uid_1.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`);
+        }
+    }
+}
+exports.connector = new Connector();
+//# sourceMappingURL=Connector.js.map

package/dist/connector/Connector.js.map

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

package/dist/connector/ICustomEventMessageRequest.d.ts

@@ -0,0 +1,9 @@
+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;
+}

package/dist/connector/ICustomEventMessageRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ICustomEventMessageRequest.js.map

package/dist/connector/ICustomEventMessageRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICustomEventMessageRequest.js","sourceRoot":"","sources":["../../src/connector/ICustomEventMessageRequest.ts"],"names":[],"mappings":""}

package/dist/connector/ICustomEventMessageResponse.d.ts

@@ -0,0 +1,10 @@
+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;
+}