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

package/dist/thyra/ThyraAccount.d.ts

@@ -0,0 +1,77 @@
+import { IAccountBalanceResponse, IAccountDetails, IAccountSignResponse, ITransactionDetails } from '..';
+import { IAccount } from '../account/IAccount';
+/**
+ * This module contains the ThyraAccount class. It is responsible for representing an account in the Thyra wallet.
+ *
+ * @remarks
+ * This class provides methods to interact with Thyra account's {@link balance} and to {@link sign} messages.
+ *
+ */
+export declare class ThyraAccount 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 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/thyra/ThyraAccount.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThyraAccount = void 0;
+const RequestHandler_1 = require("./RequestHandler");
+const ThyraProvider_1 = require("./ThyraProvider");
+/**
+ * The Thyra's account balance url
+ */
+const THYRA_BALANCE_URL = `https://my.massa/massa/addresses?attributes=balance&addresses`;
+/**
+ * This module contains the ThyraAccount class. It is responsible for representing an account in the Thyra wallet.
+ *
+ * @remarks
+ * This class provides methods to interact with Thyra account's {@link balance} and to {@link sign} messages.
+ *
+ */
+class ThyraAccount {
+    /**
+     * 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() {
+        let signOpResponse = null;
+        try {
+            signOpResponse = await (0, RequestHandler_1.getRequest)(`${THYRA_BALANCE_URL}=${this._address}`);
+        }
+        catch (ex) {
+            console.error(`Thyra account balance error`);
+            throw ex;
+        }
+        if (signOpResponse.isError || signOpResponse.error) {
+            throw signOpResponse.error;
+        }
+        const balance = signOpResponse.result.addressesAttributes[this._address].balance;
+        return {
+            finalBalance: balance.final,
+            candidateBalance: balance.pending,
+        };
+    }
+    /**
+     * 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) {
+        let signOpResponse = null;
+        try {
+            signOpResponse = await (0, RequestHandler_1.postRequest)(`${ThyraProvider_1.THYRA_ACCOUNTS_URL}/${this._name}/signOperation`, {
+                operation: data,
+                batch: false,
+            });
+        }
+        catch (ex) {
+            console.error(`Thyra account signing error`);
+            throw ex;
+        }
+        if (signOpResponse.isError || signOpResponse.error) {
+            throw signOpResponse.error;
+        }
+        return signOpResponse.result;
+    }
+    /**
+     * 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, fee) {
+        throw new Error('Method not implemented.');
+    }
+    /**
+     * 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, fee) {
+        throw new Error('Method not implemented.');
+    }
+    /**
+     * 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, recipientAddress, fee) {
+        throw new Error('Method not implemented.');
+    }
+}
+exports.ThyraAccount = ThyraAccount;
+//# sourceMappingURL=ThyraAccount.js.map

package/dist/thyra/ThyraAccount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThyraAccount.js","sourceRoot":"","sources":["../../src/thyra/ThyraAccount.ts"],"names":[],"mappings":";;;AAOA,qDAAgF;AAChF,mDAAqD;AAErD;;GAEG;AACH,MAAM,iBAAiB,GAAG,+DAA+D,CAAC;AA4B1F;;;;;;GAMG;AACH,MAAa,YAAY;IAKvB;;;;;;;;;;;;OAYG;IACH,YAAmB,EAAE,OAAO,EAAE,IAAI,EAAmB,EAAE,YAAoB;QACzE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;IACpC,CAAC;IAED;;OAEG;IACI,OAAO;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACI,IAAI;QACT,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;OAEG;IACI,YAAY;QACjB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,OAAO;QAClB,IAAI,cAAc,GAA4C,IAAI,CAAC;QACnE,IAAI;YACF,cAAc,GAAG,MAAM,IAAA,2BAAU,EAC/B,GAAG,iBAAiB,IAAI,IAAI,CAAC,QAAQ,EAAE,CACxC,CAAC;SACH;QAAC,OAAO,EAAE,EAAE;YACX,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC7C,MAAM,EAAE,CAAC;SACV;QACD,IAAI,cAAc,CAAC,OAAO,IAAI,cAAc,CAAC,KAAK,EAAE;YAClD,MAAM,cAAc,CAAC,KAAK,CAAC;SAC5B;QACD,MAAM,OAAO,GACX,cAAc,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;QACnE,OAAO;YACL,YAAY,EAAE,OAAO,CAAC,KAAK;YAC3B,gBAAgB,EAAE,OAAO,CAAC,OAAO;SAClC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,IAAI,CAAC,IAAyB;QACzC,IAAI,cAAc,GAA8C,IAAI,CAAC;QACrE,IAAI;YACF,cAAc,GAAG,MAAM,IAAA,4BAAW,EAChC,GAAG,kCAAkB,IAAI,IAAI,CAAC,KAAK,gBAAgB,EACnD;gBACE,SAAS,EAAE,IAAI;gBACf,KAAK,EAAE,KAAK;aACK,CACpB,CAAC;SACH;QAAC,OAAO,EAAE,EAAE;YACX,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC7C,MAAM,EAAE,CAAC;SACV;QACD,IAAI,cAAc,CAAC,OAAO,IAAI,cAAc,CAAC,KAAK,EAAE;YAClD,MAAM,cAAc,CAAC,KAAK,CAAC;SAC5B;QACD,OAAO,cAAc,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,MAAc,EAAE,GAAW;QAClC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,MAAc,EAAE,GAAW;QACnC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;OAMG;IACH,eAAe,CACb,MAAc,EACd,gBAAwB,EACxB,GAAW;QAEX,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;CACF;AArID,oCAqIC"}

package/dist/thyra/ThyraDiscovery.d.ts

@@ -0,0 +1,69 @@
+/**
+ * This file defines a TypeScript class named ThyraDiscovery.
+ * The class is being used to recursively search for a connection to Thyra's server
+ * and if so report this via emitting messages.
+ *
+ * @remarks
+ * - If you are only looking to use our library, the connector ThyraDiscovery will not be useful to you.
+ * - If you want to work on this repo, you will probably be interested in this object
+ *
+ */
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+/**
+ * Url used for the thyra discovery and pinging the thyra server's index.html
+ */
+export declare const THYRA_DISCOVERY_URL = "https://my.massa/thyra/home/index.html";
+/**
+ * A message emitted on successful Thyra discovery
+ */
+export declare const ON_THYRA_DISCOVERED = "ON_THYRA_DISCOVERED";
+/**
+ * A message emitted on Thyra disconnect
+ */
+export declare const ON_THYRA_DISCONNECTED = "ON_THYRA_DISCONNECTED";
+/**
+ * This file defines a TypeScript class named ThyraDiscovery.
+ * The class is being used to recursively ping Thyra's server
+ * and if a response is received emit a message so Thyra can be enlisted as a wallet provider in the `Connector` class.
+ */
+export declare class ThyraDiscovery extends EventEmitter {
+    private readonly pollIntervalMillis;
+    private timeoutId;
+    private isDiscovered;
+    /**
+     * ThyraDiscovery constructor
+     *
+     * @param pollIntervalMillis - Polling interval defined in milliseconds
+     *
+     * @remarks
+     * - It creates a timeout using the given `pollIntervalMillis` argument on every trigger of which
+     *  the Thyra pinging is triggered and if a successful response is fetched,
+     * a message `ON_THYRA_DISCOVERED` is emitted that Thyra has been discovered
+     * as a wallet provider upon which the `Connector` class will enlist Thyra as a wallet provider
+     * - If once found, but then disconnected the following message `ON_THYRA_DISCONNECTED` is being emitted
+     *  so that the `Connector` class delists Thyra as a wallet provider
+     *
+     * @returns An instance of the ThyraDiscovery class.
+     *
+     */
+    constructor(pollIntervalMillis: number);
+    /**
+     * A callback method that triggers a ping of the Thyra's server
+     *
+     * @returns void
+     */
+    private callback;
+    /**
+     * A method to stop listening for a connection to Thyra's server
+     *
+     * @returns void
+     */
+    stopListening(): void;
+    /**
+     * A method to start listening for a connection to Thyra's server.
+     *
+     * @returns void
+     */
+    startListening(): void;
+}

package/dist/thyra/ThyraDiscovery.js

@@ -0,0 +1,107 @@
+"use strict";
+/**
+ * This file defines a TypeScript class named ThyraDiscovery.
+ * The class is being used to recursively search for a connection to Thyra's server
+ * and if so report this via emitting messages.
+ *
+ * @remarks
+ * - If you are only looking to use our library, the connector ThyraDiscovery will not be useful to you.
+ * - If you want to work on this repo, you will probably be interested in this object
+ *
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThyraDiscovery = exports.ON_THYRA_DISCONNECTED = exports.ON_THYRA_DISCOVERED = exports.THYRA_DISCOVERY_URL = void 0;
+const events_1 = require("events");
+const time_1 = require("../utils/time");
+const RequestHandler_1 = require("./RequestHandler");
+/**
+ * Url used for the thyra discovery and pinging the thyra server's index.html
+ */
+exports.THYRA_DISCOVERY_URL = 'https://my.massa/thyra/home/index.html';
+/**
+ * A message emitted on successful Thyra discovery
+ */
+exports.ON_THYRA_DISCOVERED = 'ON_THYRA_DISCOVERED';
+/**
+ * A message emitted on Thyra disconnect
+ */
+exports.ON_THYRA_DISCONNECTED = 'ON_THYRA_DISCONNECTED';
+/**
+ * This file defines a TypeScript class named ThyraDiscovery.
+ * The class is being used to recursively ping Thyra's server
+ * and if a response is received emit a message so Thyra can be enlisted as a wallet provider in the `Connector` class.
+ */
+class ThyraDiscovery extends events_1.EventEmitter {
+    /**
+     * ThyraDiscovery constructor
+     *
+     * @param pollIntervalMillis - Polling interval defined in milliseconds
+     *
+     * @remarks
+     * - It creates a timeout using the given `pollIntervalMillis` argument on every trigger of which
+     *  the Thyra pinging is triggered and if a successful response is fetched,
+     * a message `ON_THYRA_DISCOVERED` is emitted that Thyra has been discovered
+     * as a wallet provider upon which the `Connector` class will enlist Thyra as a wallet provider
+     * - If once found, but then disconnected the following message `ON_THYRA_DISCONNECTED` is being emitted
+     *  so that the `Connector` class delists Thyra as a wallet provider
+     *
+     * @returns An instance of the ThyraDiscovery class.
+     *
+     */
+    constructor(pollIntervalMillis) {
+        super();
+        this.pollIntervalMillis = pollIntervalMillis;
+        this.timeoutId = null;
+        this.isDiscovered = false;
+        // bind class methods
+        this.callback = this.callback.bind(this);
+        this.stopListening = this.stopListening.bind(this);
+        this.startListening = this.startListening.bind(this);
+    }
+    /**
+     * A callback method that triggers a ping of the Thyra's server
+     *
+     * @returns void
+     */
+    async callback() {
+        let resp = null;
+        try {
+            resp = await (0, RequestHandler_1.getRequest)(exports.THYRA_DISCOVERY_URL);
+        }
+        catch (ex) {
+            console.error(`Error calling ${exports.THYRA_DISCOVERY_URL}`);
+        }
+        if (!resp.isError && !resp.error) {
+            this.isDiscovered = true;
+            this.emit(exports.ON_THYRA_DISCOVERED);
+        }
+        if ((resp.isError || resp.error) && this.isDiscovered) {
+            this.emit(exports.ON_THYRA_DISCONNECTED);
+        }
+        // reset the interval
+        this.timeoutId = new time_1.Timeout(this.pollIntervalMillis, () => this.callback());
+    }
+    /**
+     * A method to stop listening for a connection to Thyra's server
+     *
+     * @returns void
+     */
+    stopListening() {
+        if (this.timeoutId)
+            this.timeoutId.clear();
+    }
+    /**
+     * A method to start listening for a connection to Thyra's server.
+     *
+     * @returns void
+     */
+    startListening() {
+        const that = this;
+        if (this.timeoutId) {
+            return;
+        }
+        this.timeoutId = new time_1.Timeout(this.pollIntervalMillis, () => that.callback());
+    }
+}
+exports.ThyraDiscovery = ThyraDiscovery;
+//# sourceMappingURL=ThyraDiscovery.js.map

package/dist/thyra/ThyraDiscovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThyraDiscovery.js","sourceRoot":"","sources":["../../src/thyra/ThyraDiscovery.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,mCAAsC;AACtC,wCAAwC;AACxC,qDAAmE;AAEnE;;GAEG;AACU,QAAA,mBAAmB,GAAG,wCAAwC,CAAC;AAE5E;;GAEG;AACU,QAAA,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD;;GAEG;AACU,QAAA,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D;;;;GAIG;AACH,MAAa,cAAe,SAAQ,qBAAY;IAI9C;;;;;;;;;;;;;;;OAeG;IACH,YAAoC,kBAA0B;QAC5D,KAAK,EAAE,CAAC;QAD0B,uBAAkB,GAAlB,kBAAkB,CAAQ;QAnBtD,cAAS,GAAmB,IAAI,CAAC;QACjC,iBAAY,GAAG,KAAK,CAAC;QAqB3B,qBAAqB;QACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,QAAQ;QACpB,IAAI,IAAI,GAAiC,IAAI,CAAC;QAC9C,IAAI;YACF,IAAI,GAAG,MAAM,IAAA,2BAAU,EAAC,2BAAmB,CAAC,CAAC;SAC9C;QAAC,OAAO,EAAE,EAAE;YACX,OAAO,CAAC,KAAK,CAAC,iBAAiB,2BAAmB,EAAE,CAAC,CAAC;SACvD;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE;YAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,2BAAmB,CAAC,CAAC;SAChC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE;YACrD,IAAI,CAAC,IAAI,CAAC,6BAAqB,CAAC,CAAC;SAClC;QAED,qBAAqB;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,cAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CACzD,IAAI,CAAC,QAAQ,EAAE,CAChB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,aAAa;QAClB,IAAI,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACI,cAAc;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC;QAClB,IAAI,IAAI,CAAC,SAAS,EAAE;YAClB,OAAO;SACR;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,cAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE,CACzD,IAAI,CAAC,QAAQ,EAAE,CAChB,CAAC;IACJ,CAAC;CACF;AAhFD,wCAgFC"}

package/dist/thyra/ThyraProvider.d.ts

@@ -0,0 +1,87 @@
+import { IAccountDeletionResponse } from '../provider/AccountDeletion';
+import { IAccountImportResponse } from '../provider/AccountImport';
+import { IProvider } from '../provider/IProvider';
+import { IAccount } from '../account/IAccount';
+import { IAccountDetails } from '../account';
+/**
+ * The Thyra accounts url
+ */
+export declare const THYRA_ACCOUNTS_URL = "https://my.massa/thyra/plugin/massalabs/wallet/rest/wallet";
+/**
+ * Thyra's url for importing accounts
+ */
+export declare const THYRA_IMPORT_ACCOUNTS_URL: string;
+/**
+ * Thyra's wallet provider name
+ */
+export declare const THYRA_PROVIDER_NAME = "THYRA";
+/**
+ * This interface represents the payload returned by making a call to Thyra's accounts url.
+ */
+export interface IThyraWallet {
+    address: string;
+    nickname: string;
+    keyPair: {
+        nonce: string;
+        privateKey: string;
+        publicKey: string;
+        salt: string;
+    };
+}
+/**
+ * This class provides an implementation for communicating with the Thyra wallet provider.
+ * @remarks
+ * This class is used as a proxy to the Thyra server for exchanging message over https calls.
+ */
+export declare class ThyraProvider implements IProvider {
+    private providerName;
+    /**
+     * Provider constructor
+     *
+     * @param providerName - The name of the provider.
+     * @returns An instance of the Provider class.
+     */
+    constructor();
+    /**
+     * This method returns the name of the provider.
+     * @returns The name of the provider.
+     */
+    name(): string;
+    /**
+     * This method sends a message to the Thyra server to get the list of accounts for the provider.
+     * It returns a Promise that resolves to an array of Account instances.
+     *
+     * @returns A promise that resolves to an array of Account instances.
+     */
+    accounts(): Promise<IAccount[]>;
+    /**
+     * This method makes an http call to the Thyra server to import an account with the given publicKey and privateKey.
+     *
+     * @remarks This method in not yet implemented and depends on `massalabs/thyra-plugin-wallet#82` to be merged first
+     *
+     * @param publicKey - The public key of the account.
+     * @param privateKey - The private key of the account.
+     * @returns a Promise that resolves to an instance of IAccountImportResponse.
+     *
+     */
+    importAccount(publicKey: string, privateKey: string): Promise<IAccountImportResponse>;
+    /**
+     * This method sends an http call to the Thyra server to delete the account associated with the given address.
+     *
+     * @param address - The address of the account.
+     * @returns a Promise that resolves to an instance of IAccountDeletionResponse.
+     */
+    deleteAccount(address: string): Promise<IAccountDeletionResponse>;
+    /**
+     * This method sends an http call to the Thyra server to obtain node urls.
+     *
+     * @returns a Promise that resolves to a list of node urls.
+     */
+    getNodesUrls(): Promise<string[]>;
+    /**
+     * This method sends an http call to the Thyra server to create a new random account.
+     *
+     * @returns a Promise that resolves to the details of the newly generated account.
+     */
+    generateNewAccount(name: string): Promise<IAccountDetails>;
+}

package/dist/thyra/ThyraProvider.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThyraProvider = exports.THYRA_PROVIDER_NAME = exports.THYRA_IMPORT_ACCOUNTS_URL = exports.THYRA_ACCOUNTS_URL = void 0;
+const AccountDeletion_1 = require("../provider/AccountDeletion");
+const RequestHandler_1 = require("./RequestHandler");
+const ThyraAccount_1 = require("./ThyraAccount");
+/**
+ * The Thyra accounts url
+ */
+exports.THYRA_ACCOUNTS_URL = 'https://my.massa/thyra/plugin/massalabs/wallet/rest/wallet';
+/**
+ * Thyra's url for importing accounts
+ */
+exports.THYRA_IMPORT_ACCOUNTS_URL = `${exports.THYRA_ACCOUNTS_URL}/import/`;
+/**
+ * Thyra's wallet provider name
+ */
+exports.THYRA_PROVIDER_NAME = 'THYRA';
+/**
+ * This class provides an implementation for communicating with the Thyra wallet provider.
+ * @remarks
+ * This class is used as a proxy to the Thyra server for exchanging message over https calls.
+ */
+class ThyraProvider {
+    /**
+     * Provider constructor
+     *
+     * @param providerName - The name of the provider.
+     * @returns An instance of the Provider class.
+     */
+    constructor() {
+        this.providerName = exports.THYRA_PROVIDER_NAME;
+    }
+    /**
+     * This method returns the name of the provider.
+     * @returns The name of the provider.
+     */
+    name() {
+        return this.providerName;
+    }
+    /**
+     * This method sends a message to the Thyra server to get the list of accounts for the provider.
+     * It returns a Promise that resolves to an array of Account instances.
+     *
+     * @returns A promise that resolves to an array of Account instances.
+     */
+    async accounts() {
+        let thyraAccountsResponse = null;
+        try {
+            thyraAccountsResponse = await (0, RequestHandler_1.getRequest)(exports.THYRA_ACCOUNTS_URL);
+        }
+        catch (ex) {
+            console.error(`Thyra accounts retrieval error`);
+            throw ex;
+        }
+        if (thyraAccountsResponse.isError || thyraAccountsResponse.error) {
+            throw thyraAccountsResponse.error.message;
+        }
+        return thyraAccountsResponse.result.map((thyraAccount) => {
+            return new ThyraAccount_1.ThyraAccount({ address: thyraAccount.address, name: thyraAccount.nickname }, this.providerName);
+        });
+    }
+    /**
+     * This method makes an http call to the Thyra server to import an account with the given publicKey and privateKey.
+     *
+     * @remarks This method in not yet implemented and depends on `massalabs/thyra-plugin-wallet#82` to be merged first
+     *
+     * @param publicKey - The public key of the account.
+     * @param privateKey - The private key of the account.
+     * @returns a Promise that resolves to an instance of IAccountImportResponse.
+     *
+     */
+    async importAccount(publicKey, privateKey) {
+        // TODO: once  massalabs/thyra-plugin-wallet#82 is merged, to be updated here
+        throw new Error(`Unimplemented method!`);
+    }
+    /**
+     * This method sends an http call to the Thyra server to delete the account associated with the given address.
+     *
+     * @param address - The address of the account.
+     * @returns a Promise that resolves to an instance of IAccountDeletionResponse.
+     */
+    async deleteAccount(address) {
+        // get all accounts
+        let allAccounts = null;
+        try {
+            allAccounts = await (0, RequestHandler_1.getRequest)(exports.THYRA_ACCOUNTS_URL);
+        }
+        catch (ex) {
+            console.error(`Thyra accounts retrieval error`);
+            throw ex;
+        }
+        if (allAccounts.isError || allAccounts.error) {
+            throw allAccounts.error.message;
+        }
+        // find the account with the desired address
+        const accountToDelete = allAccounts.result.find((account) => account.address.toLowerCase() === address.toLowerCase());
+        // delete the account in question
+        let thyraAccountsResponse = null;
+        try {
+            thyraAccountsResponse = await (0, RequestHandler_1.deleteRequest)(`${exports.THYRA_ACCOUNTS_URL}/${accountToDelete.nickname}`);
+        }
+        catch (ex) {
+            console.error(`Thyra accounts deletion error`, ex);
+            return {
+                response: AccountDeletion_1.EAccountDeletionResponse.ERROR,
+            };
+        }
+        if (thyraAccountsResponse.isError || thyraAccountsResponse.error) {
+            console.error(`Thyra accounts deletion error`, thyraAccountsResponse.error.message);
+            return {
+                response: AccountDeletion_1.EAccountDeletionResponse.ERROR,
+            };
+        }
+        return {
+            response: AccountDeletion_1.EAccountDeletionResponse.OK,
+        };
+    }
+    /**
+     * This method sends an http call to the Thyra server to obtain node urls.
+     *
+     * @returns a Promise that resolves to a list of node urls.
+     */
+    async getNodesUrls() {
+        throw new Error('Method not implemented.');
+    }
+    /**
+     * This method sends an http call to the Thyra server to create a new random account.
+     *
+     * @returns a Promise that resolves to the details of the newly generated account.
+     */
+    async generateNewAccount(name) {
+        throw new Error('Method not implemented.');
+    }
+}
+exports.ThyraProvider = ThyraProvider;
+//# sourceMappingURL=ThyraProvider.js.map

package/dist/thyra/ThyraProvider.js.map

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