Merge pull request #21 from XinFinOrg/add-management-page-service

Add management page service layer interface with mock data

frontend/package.json

@@ -18,7 +18,8 @@
     "react-router-dom": "^6.14.0",
     "sass": "^1.63.6",
     "tailwindcss": "^3.3.2",
-    "vite-tsconfig-paths": "^4.2.0"
+    "vite-tsconfig-paths": "^4.2.0",
+    "web3": "1.6.1"
   },
   "devDependencies": {
     "@types/react": "^18.0.37",

frontend/src/services/grandmaster-manager/errors.ts

@@ -0,0 +1,18 @@
+
+export interface ManagerError {
+  errorType: ErrorTypes;
+  errorStatus: number;
+  errorMessage?: string;
+}
+
+export enum ErrorTypes {
+  // Login section
+  WALLET_NOT_INSTALLED = "WALLET_NOT_INSTALLED",
+  WALLET_NOT_LOGIN = "WALLET_NOT_LOGIN",
+  NOT_GRANDMASTER = "NOT_GRANDMASTER",
+  // Transaction section
+  INVALID_TRANSACTION = "INVALID_TRANSACTION",
+  NOT_ENOUGH_BALANCE = "NOT_ENOUGH_BALANCE",
+  // Everything else
+  INTERNAL_ERROR = "INTERNAL_ERROR"
+}

frontend/src/services/grandmaster-manager/index.ts

@@ -0,0 +1,121 @@
+import Web3 from "web3";
+import { ManagerError } from "@/services/grandmaster-manager/errors";
+
+interface AccountDetails {
+  accountAddress: string;
+  balance: string;
+  networkId: number;
+  rpcAddress: string;
+  denom: string;
+}
+
+interface CandidateDetails {
+  address: string;
+  delegation: number;
+  rank: number;
+  status: 'MASTERNODE' | 'PROPOSED' | 'SLASHED'
+}
+
+
+export class GrandMasterManager {
+  private web3Client;
+  constructor() {
+    const win = window as any;
+    this.web3Client = new Web3(win.xdc ? win.xdc : win.ethereum);
+  }
+
+  /**
+   * * This method will detect XDC-Pay and verify if customer has alraedy loggin.
+   * @returns Account details will be returned if all good, otherwise, relevant error message and type will be returned such as WALLET_NOT_LOGIN
+   */
+  async login(): Promise<AccountDetails | ManagerError> {
+    const chainId = 551;
+    return {
+      accountAddress: "xdc888c073313b36cf03cf1f739f39443551ff12bbe",
+      balance: "123",
+      networkId: chainId,
+      denom: "hxdc",
+      rpcAddress: "https://devnetstats.apothem.network/subnet"
+    }
+  }
+
+  /**
+   * Remove a masternode from the manager view list
+   * @param address The master node to be removed
+   * @returns If transaction is successful, return. Otherwise, an error details will be returned
+   */
+  async removeMasterNode(address: string): Promise<true | ManagerError> {
+    return true;
+  }
+
+  /**
+   * Propose to add a new masternode for being a mining candidate from the next epoch
+   * @param address The master node to be added
+   * @returns If transaction is successful, return. Otherwise, an error details will be returned
+   */
+  async addNewMasterNode(address: string): Promise<true | ManagerError> {
+    return true;
+  }
+
+  /**
+   * Change the voting/ranking power/order of a particular masternode.
+   * @param address The targeted masternode
+   * @param value The xdc value that will be applied to the targeted address. Postive number means increase power, negative means decrease the power
+   * @returns If transaction is successful, return. Otherwise, an error details will be returned
+   */
+  async changeVote(address: string, value: number): Promise<true | ManagerError> {
+    return true;
+  }
+
+  /**
+   * A event listener on wallet account. If user switch to a different account, this method will update notify the provided handler
+   * @param changeHandler The handler function to process when the accounts changed. The provided value will be the new wallet address.
+   */
+  onAccountChange(changeHandler: (accounts: string) => any) {
+    changeHandler("0x3c03a0abac1da8f2f419a59afe1c125f90b506c5");
+    // TODO: 1. Handle the account change via accountsChanged
+    // TODO: 2. Handle the chain change via chainChanged. This could happen if switch from testnet to mainnet etc.
+  }
+
+  /**
+   * A method to return subnet candidates and its status.
+   * @returns The address and its current status and stake.
+   * 'MASTERNODE' means it's one of the mining masternode
+   * 'PROPOSED' means it just been proposed, but waiting for have enough vote in order to be the masternode.
+   * 'SLASHED' means it's been taken out from the masternode list
+   */
+  async getCandidates(): Promise<CandidateDetails[]> {
+    return [
+      {
+        address: "xdc25B4CBb9A7AE13feadC3e9F29909833D19D16dE5",
+        delegation: 5e+22,
+        rank: 0,
+        status: "MASTERNODE"
+      },
+      {
+        address: "xdc2af0Cacf84899F504a6dC95e6205547bDfe28c2c",
+        delegation: 5e+22,
+        rank: 1,
+        status: "MASTERNODE"
+      },
+      {
+        address: "xdc30f21E514A66732DA5Dff95340624fa808048601",
+        delegation: 5e+22,
+        rank: 2,
+        status: "MASTERNODE"
+      },
+      {
+        address: "xdc3C03a0aBaC1DA8f2f419a59aFe1c125F90B506c5",
+        delegation: 5e+22,
+        rank: 3,
+        status: "PROPOSED"
+      },
+      {
+        address: "xdc3D9fd0c76BB8B3B4929ca861d167f3e05926CB68",
+        delegation: 5e+22,
+        rank: 4,
+        status: "SLASHED"
+      }
+    ];
+  }
+}