feat: Add MPToken API support for dApps

- Add authorizeMPToken API function for token authorization
- Add createMPTokenIssuance API function to create token issuances
- Add destroyMPTokenIssuance API function to destroy issuances
- Add setMPTokenIssuance API function to lock/unlock holder tokens

Added types:
- AuthorizeMPTokenRequest/Response
- CreateMPTokenIssuanceRequest/Response
- DestroyMPTokenIssuanceRequest/Response
- SetMPTokenIssuanceRequest/Response

Message types updated for all MPToken operations.

Author: RomThpt

packages/api/src/authorizeMPToken/authorizeMPToken.ts

@@ -0,0 +1,53 @@
+import {
+  AuthorizeMPTokenRequest,
+  AuthorizeMPTokenResponse,
+  GEM_WALLET,
+  RequestAuthorizeMPTokenMessage,
+  ResponseType
+} from '@gemwallet/constants';
+
+import { deserializeError } from '../helpers/errors';
+import { sendMessageToContentScript } from '../helpers/extensionMessaging';
+
+export const authorizeMPToken = async (
+  payload: AuthorizeMPTokenRequest
+): Promise<AuthorizeMPTokenResponse> => {
+  /* response:
+   * if the transaction succeeds:
+   * - type: 'response'
+   * - result:
+   *    - hash: hash of the transaction
+   *
+   * if the user rejects the transaction:
+   * - type: 'reject'
+   * - result: undefined
+   *
+   * if the transaction fails:
+   * - throw an error
+   */
+  let response: AuthorizeMPTokenResponse = {
+    type: ResponseType.Reject,
+    result: undefined
+  };
+
+  try {
+    const message: RequestAuthorizeMPTokenMessage = {
+      app: GEM_WALLET,
+      type: 'REQUEST_AUTHORIZE_MPTOKEN/V3',
+      payload
+    };
+    const { result, error } = await sendMessageToContentScript(message);
+    const parsedError = error ? deserializeError(error) : undefined;
+    if (parsedError) {
+      throw parsedError;
+    }
+
+    if (result) {
+      response.type = ResponseType.Response;
+      response.result = result;
+    }
+  } catch (e) {
+    throw e;
+  }
+  return response;
+};

packages/api/src/authorizeMPToken/index.ts

@@ -0,0 +1 @@
+export * from './authorizeMPToken';

packages/api/src/createMPTokenIssuance/createMPTokenIssuance.ts

@@ -0,0 +1,53 @@
+import {
+  CreateMPTokenIssuanceRequest,
+  CreateMPTokenIssuanceResponse,
+  GEM_WALLET,
+  RequestCreateMPTokenIssuanceMessage,
+  ResponseType
+} from '@gemwallet/constants';
+
+import { deserializeError } from '../helpers/errors';
+import { sendMessageToContentScript } from '../helpers/extensionMessaging';
+
+export const createMPTokenIssuance = async (
+  payload: CreateMPTokenIssuanceRequest
+): Promise<CreateMPTokenIssuanceResponse> => {
+  /* response:
+   * if the transaction succeeds:
+   * - type: 'response'
+   * - result:
+   *    - hash: hash of the transaction
+   *
+   * if the user rejects the transaction:
+   * - type: 'reject'
+   * - result: undefined
+   *
+   * if the transaction fails:
+   * - throw an error
+   */
+  let response: CreateMPTokenIssuanceResponse = {
+    type: ResponseType.Reject,
+    result: undefined
+  };
+
+  try {
+    const message: RequestCreateMPTokenIssuanceMessage = {
+      app: GEM_WALLET,
+      type: 'REQUEST_CREATE_MPTOKEN_ISSUANCE/V3',
+      payload
+    };
+    const { result, error } = await sendMessageToContentScript(message);
+    const parsedError = error ? deserializeError(error) : undefined;
+    if (parsedError) {
+      throw parsedError;
+    }
+
+    if (result) {
+      response.type = ResponseType.Response;
+      response.result = result;
+    }
+  } catch (e) {
+    throw e;
+  }
+  return response;
+};

packages/api/src/createMPTokenIssuance/index.ts

@@ -0,0 +1 @@
+export * from './createMPTokenIssuance';

packages/api/src/destroyMPTokenIssuance/destroyMPTokenIssuance.ts

@@ -0,0 +1,53 @@
+import {
+  DestroyMPTokenIssuanceRequest,
+  DestroyMPTokenIssuanceResponse,
+  GEM_WALLET,
+  RequestDestroyMPTokenIssuanceMessage,
+  ResponseType
+} from '@gemwallet/constants';
+
+import { deserializeError } from '../helpers/errors';
+import { sendMessageToContentScript } from '../helpers/extensionMessaging';
+
+export const destroyMPTokenIssuance = async (
+  payload: DestroyMPTokenIssuanceRequest
+): Promise<DestroyMPTokenIssuanceResponse> => {
+  /* response:
+   * if the transaction succeeds:
+   * - type: 'response'
+   * - result:
+   *    - hash: hash of the transaction
+   *
+   * if the user rejects the transaction:
+   * - type: 'reject'
+   * - result: undefined
+   *
+   * if the transaction fails:
+   * - throw an error
+   */
+  let response: DestroyMPTokenIssuanceResponse = {
+    type: ResponseType.Reject,
+    result: undefined
+  };
+
+  try {
+    const message: RequestDestroyMPTokenIssuanceMessage = {
+      app: GEM_WALLET,
+      type: 'REQUEST_DESTROY_MPTOKEN_ISSUANCE/V3',
+      payload
+    };
+    const { result, error } = await sendMessageToContentScript(message);
+    const parsedError = error ? deserializeError(error) : undefined;
+    if (parsedError) {
+      throw parsedError;
+    }
+
+    if (result) {
+      response.type = ResponseType.Response;
+      response.result = result;
+    }
+  } catch (e) {
+    throw e;
+  }
+  return response;
+};

packages/api/src/destroyMPTokenIssuance/index.ts

@@ -0,0 +1 @@
+export * from './destroyMPTokenIssuance';

packages/api/src/index.ts

@@ -1,9 +1,12 @@
 export * from './acceptNFTOffer';
+export * from './authorizeMPToken';
 export * from './burnNFT';
 export * from './cancelNFTOffer';
 export * from './cancelOffer';
+export * from './createMPTokenIssuance';
 export * from './createNFTOffer';
 export * from './createOffer';
+export * from './destroyMPTokenIssuance';
 export * from './on';
 export * from './getAddress';
 export * from './getNetwork';
@@ -14,6 +17,7 @@ export * from './mintNFT';
 export * from './sendPayment';
 export * from './setAccount';
 export * from './setHook';
+export * from './setMPTokenIssuance';
 export * from './setRegularKey';
 export * from './setTrustline';
 export * from './signMessage';
@@ -36,17 +40,21 @@ export type {
 // API request types
 export type {
   AcceptNFTOfferRequest,
+  AuthorizeMPTokenRequest,
   BurnNFTRequest,
   CancelNFTOfferRequest,
   CancelOfferRequest,
+  CreateMPTokenIssuanceRequest,
   CreateNFTOfferRequest,
   CreateOfferRequest,
+  DestroyMPTokenIssuanceRequest,
   GetNetworkRequest,
   GetNFTRequest,
   MintNFTRequest,
   SendPaymentRequest,
   SetAccountRequest,
   SetHookRequest,
+  SetMPTokenIssuanceRequest,
   SetRegularKeyRequest,
   SetTrustlineRequest,
   SignMessageRequest,
@@ -58,11 +66,14 @@ export type {
 // API response types
 export type {
   AcceptNFTOfferResponse,
+  AuthorizeMPTokenResponse,
   BurnNFTResponse,
   CancelNFTOfferResponse,
   CancelOfferResponse,
+  CreateMPTokenIssuanceResponse,
   CreateNFTOfferResponse,
   CreateOfferResponse,
+  DestroyMPTokenIssuanceResponse,
   GetAddressResponse,
   GetNetworkResponse,
   GetNFTResponse,
@@ -72,6 +83,7 @@ export type {
   SendPaymentResponse,
   SetAccountResponse,
   SetHookResponse,
+  SetMPTokenIssuanceResponse,
   SetRegularKeyResponse,
   SetTrustlineResponse,
   SignMessageResponse,

packages/api/src/setMPTokenIssuance/index.ts

@@ -0,0 +1 @@
+export * from './setMPTokenIssuance';

packages/api/src/setMPTokenIssuance/setMPTokenIssuance.ts

@@ -0,0 +1,53 @@
+import {
+  GEM_WALLET,
+  RequestSetMPTokenIssuanceMessage,
+  ResponseType,
+  SetMPTokenIssuanceRequest,
+  SetMPTokenIssuanceResponse
+} from '@gemwallet/constants';
+
+import { deserializeError } from '../helpers/errors';
+import { sendMessageToContentScript } from '../helpers/extensionMessaging';
+
+export const setMPTokenIssuance = async (
+  payload: SetMPTokenIssuanceRequest
+): Promise<SetMPTokenIssuanceResponse> => {
+  /* response:
+   * if the transaction succeeds:
+   * - type: 'response'
+   * - result:
+   *    - hash: hash of the transaction
+   *
+   * if the user rejects the transaction:
+   * - type: 'reject'
+   * - result: undefined
+   *
+   * if the transaction fails:
+   * - throw an error
+   */
+  let response: SetMPTokenIssuanceResponse = {
+    type: ResponseType.Reject,
+    result: undefined
+  };
+
+  try {
+    const message: RequestSetMPTokenIssuanceMessage = {
+      app: GEM_WALLET,
+      type: 'REQUEST_SET_MPTOKEN_ISSUANCE/V3',
+      payload
+    };
+    const { result, error } = await sendMessageToContentScript(message);
+    const parsedError = error ? deserializeError(error) : undefined;
+    if (parsedError) {
+      throw parsedError;
+    }
+
+    if (result) {
+      response.type = ResponseType.Response;
+      response.result = result;
+    }
+  } catch (e) {
+    throw e;
+  }
+  return response;
+};