Implement Grade Of Finality Support

Author: GalRogozinski

src/app/components/Settings.tsx

@@ -42,10 +42,22 @@ class Settings extends Component<SettingsProps, SettingsState> {
             password: settings.password,
             accessManaPledgeID: settings.accessManaPledgeID,
             consensusManaPledgeID: settings.consensusManaPledgeID,
+            gofConfThreshold: settings.gofConfThreshold,
             isBusy: false
         });
     }
 
+    private static imposeMinMax(el: HTMLInputElement): void {
+        if (el.value !== "") {
+            if (parseInt(el.value) < parseInt(el.min)) {
+                el.value = el.min;
+            }
+            if (parseInt(el.value) > parseInt(el.max)) {
+                el.value = el.max;
+            }
+        }
+    }
+
     /**
      * Render the component.
      * @returns The node to render.
@@ -139,6 +151,23 @@ class Settings extends Component<SettingsProps, SettingsState> {
                                 onChange={e => this.setState({ consensusManaPledgeID: e.target.value })}
                             />
                         </div>
+                        <div className="card--label">
+                            Grade Of Finality for confirmation
+                        </div>
+                        <div className="card--value">
+                            <input
+                                className="fill"
+                                type="number"
+                                min="1"
+                                max="3"
+                                value={this.state.gofConfThreshold}
+                                onChange={e => {
+                                    Settings.imposeMinMax(e.target);
+                                    this.setState({ gofConfThreshold: e.target.valueAsNumber });
+                                    }
+                                }
+                            />
+                        </div>
                         <div className="margin-t-s">
                             <button
                                 onClick={() => this.save()}
@@ -178,7 +207,8 @@ class Settings extends Component<SettingsProps, SettingsState> {
             user: this.state.user ?? "",
             password: this.state.password ?? "",
             accessManaPledgeID: this.state.accessManaPledgeID ?? "",
-            consensusManaPledgeID: this.state.consensusManaPledgeID ?? ""
+            consensusManaPledgeID: this.state.consensusManaPledgeID ?? "",
+            gofConfThreshold: this.state.gofConfThreshold ?? 0
         };
         await this._settingsService.set(newSettings);
 

src/app/components/SettingsState.ts

@@ -40,4 +40,9 @@ export interface SettingsState {
      * The nodeID of the consensus Mana pledge.
      */
     consensusManaPledgeID?: string;
+
+    /**
+     * The minimal grade of finality needed for an output to be confirmed
+     */
+    gofConfThreshold?: number
 }

src/app/components/Wallet.tsx

@@ -255,7 +255,6 @@ class Wallet extends Component<WalletProps, WalletState> {
                                                     <th>Color</th>
                                                     <th>Confirmed</th>
                                                     <th>Pending</th>
-                                                    <th>Rejected</th>
                                                     <th>&nbsp;</th>
                                                 </tr>
                                             </thead>
@@ -283,9 +282,6 @@ class Wallet extends Component<WalletProps, WalletState> {
                                                             <td className="warning">
                                                                 {balance.unConfirmed.toString()}
                                                             </td>
-                                                            <td className="danger">
-                                                                {balance.rejected.toString()}
-                                                            </td>
                                                             <td>
                                                                 <button
                                                                     disabled={balance.confirmed <= 0}

src/iota/api/models/IUnspentOutputsResponse.ts

@@ -49,22 +49,10 @@ export interface IUnspentOutputsResponse extends IResponse {
             };
 
             /**
-             *  InclusionState represents the different states of an OutputID.
+             *  GradeOfFinality represents the confirmation level. 0 is not confirmed.
+             *  3 is the maximum confirmation level.
              */
-            inclusionState: {
-                /**
-                 * Is the output confirmed.
-                 */
-                confirmed?: boolean;
-                /**
-                 * Is the output rejected.
-                 */
-                rejected?: boolean;
-                /**
-                 * Is the output conflicting.
-                 */
-                conflicting?: boolean;
-            };
+            gradeOfFinality: number;
         }[];
     }[];
 }

src/models/ISettings.ts

@@ -28,4 +28,9 @@ export interface ISettings {
      * Access Mana Pledge ID.
      */
     consensusManaPledgeID: string;
+
+    /**
+     * Grade of Finality Confirmation threshold
+     */
+    gofConfThreshold: number;
 }

src/models/IWalletBalance.ts

@@ -15,9 +15,4 @@ export interface IWalletBalance {
      * Unconfirmed Balance.
      */
     unConfirmed: bigint;
-
-    /**
-     * Rejected Balance.
-     */
-    rejected: bigint;
 }

src/models/IWalletOutput.ts

@@ -13,7 +13,7 @@ export interface IWalletOutput {
     balances: IWalletOutputBalance[];
 
     /**
-     * Inclusion state.
+     * Grade of finality.
      */
-    inclusionState: IWalletOutputInclusionState;
+    gof: number;
 }

src/models/IWalletOutputInclusionState.ts

@@ -6,11 +6,7 @@ export interface IWalletOutputInclusionState {
     /**
      * Is the output confirmed.
      */
-    confirmed?: boolean;
-    /**
-     * Is the output rejected.
-     */
-    rejected?: boolean;
+    gof?: number;
     /**
      * Is the output liked.
      */

src/services/settingsService.ts

@@ -3,6 +3,8 @@ import { ISettings } from "../models/ISettings";
 import { IJsonStorageService } from "../models/services/IJsonStorageService";
 import { ISettingsService } from "../models/services/ISettingsService";
 
+const defaultGofConfThreshold = 3;
+
 /**
  * Service to manage settings.
  */
@@ -40,7 +42,8 @@ export class SettingsService implements ISettingsService {
                 user: "",
                 password: "",
                 accessManaPledgeID: "",
-                consensusManaPledgeID: ""
+                consensusManaPledgeID: "",
+                gofConfThreshold: defaultGofConfThreshold
             };
         }
 

src/services/walletService.ts

@@ -358,10 +358,10 @@ export class WalletService implements IWalletService {
 
             const version = 0;
             const time = Date.now();
-            const timestamp = BigInt(time * 1000000);
+            const timestamp = BigInt(time * 1_000_000);
 
             // Calculate the spending requirements
-            const consumedOutputs = this.determineOutputsToConsume(sendFundsOptions);
+            const consumedOutputs = this.determineOutputsToConsume(sendFundsOptions, settings.gofConfThreshold);
 
             const { inputs, consumedFunds } = this.buildInputs(consumedOutputs);
             const outputs = this.buildOutputs(sendFundsOptions, consumedFunds);
@@ -575,7 +575,7 @@ export class WalletService implements IWalletService {
                     outputs: uo.outputs.filter(o => o.output.type === "SigLockedColoredOutputType").map(uid => ({
                         id: uid.output.outputID.base58,
                         balances: this.mapToArray(uid.output.output.balances),
-                        inclusionState: uid.inclusionState
+                        gof: uid.gradeOfFinality
                     }))
                 })));
             } while (spentAddresses.length > BLOCK_COUNT - 2);
@@ -607,10 +607,11 @@ export class WalletService implements IWalletService {
 
     /**
      * From all the inputs determine which ones we need to consume.
-     * @param sendFundOptions The request funds.
+     * @param sendFundOptions The request funds options.
+     * @param gofConfThreshold the grade of finality needed to consider the outputs as approved
      * @returns The output that we need to consume.
      */
-    private determineOutputsToConsume(sendFundOptions: ISendFundsOptions): {
+    private determineOutputsToConsume(sendFundOptions: ISendFundsOptions, gofConfThreshold : number): {
         [address: string]: { [outputID: string]: IWalletOutput };
     } {
         const outputsToConsume: { [address: string]: { [outputID: string]: IWalletOutput } } = {};
@@ -637,9 +638,7 @@ export class WalletService implements IWalletService {
                 const confirmedUnspentOutputs = unspentOutput.outputs.filter(o =>
                     (!this._spentOutputTransactions ||
                         !this._spentOutputTransactions.includes(o.id)) &&
-                    o.inclusionState.confirmed);
-
-
+                    o.gof >= gofConfThreshold);
                 // scan the outputs on this address for required funds
                 for (const output of confirmedUnspentOutputs) {
                     // keeps track if the output contains any usable funds
@@ -895,14 +894,16 @@ export class WalletService implements IWalletService {
             const assetsMap: { [id: string]: IWalletAsset } = {};
             const addedAssets: IWalletAsset[] = [];
             const apiRegistryClient = await this.buildApiRegistryClient();
+            const settingsService = ServiceFactory.get<SettingsService>("settings");
+            const settings = await settingsService.get();
 
             for (let i = 0; i <= this._wallet.lastAddressIndex; i++) {
                 const addr = Seed.generateAddress(Base58.decode(this._wallet.seed), BigInt(i));
                 const address: IWalletAddress = {
                     index: BigInt(i),
                     address: addr,
                     isSpent: this._wallet &&
-                        this._wallet.spentAddresses.includes(addr) ? true : false
+                    this._wallet.spentAddresses.includes(addr) ? true : false
                 };
                 addressMap[address.address] = address;
                 this._addresses.push(address);
@@ -948,15 +949,13 @@ export class WalletService implements IWalletService {
                             colorMap[balance.color] = {
                                 asset: assetsMap[balance.color],
                                 confirmed: BigInt(0),
-                                unConfirmed: BigInt(0),
-                                rejected: BigInt(0)
+                                unConfirmed: BigInt(0)
                             };
                             this._balances.push(colorMap[balance.color]);
                         }
-                        if (output.inclusionState.confirmed) {
+
+                        if (output.gof >= settings.gofConfThreshold) {
                             colorMap[balance.color].confirmed += balance.value;
-                        } else if (output.inclusionState.rejected) {
-                            colorMap[balance.color].rejected += balance.value;
                         } else {
                             colorMap[balance.color].unConfirmed += balance.value;
                         }
@@ -1040,4 +1039,4 @@ export class WalletService implements IWalletService {
         const settings = await settingsService.get();
         return new ApiRegistryClient(settings.apiRegistryEndpoint);
     }
-}
+}