TIP BlockId tests

bindings/nodejs/lib/client/client.ts

@@ -426,7 +426,7 @@ export class Client {
      * Get the token supply.
      */
     async getTokenSupply(): Promise<u64> {
-        return (await this.getProtocolParameters()).tokenSupply;
+        return BigInt((await this.getProtocolParameters()).tokenSupply);
     }
 
     /**

bindings/nodejs/lib/index.ts

@@ -5,6 +5,8 @@
 import 'reflect-metadata';
 import { callUtilsMethod } from './bindings';
 import {
+    Block,
+    BlockId,
     BlockError,
     ClientError,
     ClientErrorName,
@@ -15,8 +17,9 @@ import {
     UTXOInput,
     WalletError,
     WalletErrorName,
+    ProtocolParameters,
 } from './types';
-import { bigIntToHex } from './utils';
+import { bigIntToHex, Utils } from './utils';
 
 // Allow bigint to be serialized as hex string.
 //
@@ -27,8 +30,8 @@ import { bigIntToHex } from './utils';
     return bigIntToHex(this);
 };
 
-// Assign the util method on UTXOInput here,
-// to prevent loading bindings (callUtilsMethod) when importing UTXOInput just for typing.
+// Assign the util method on UTXOInput here to prevent loading bindings (callUtilsMethod)
+// when importing UTXOInput just for typing.
 Object.assign(UTXOInput, {
     /**
      * Creates a `UTXOInput` from an output id.
@@ -44,6 +47,17 @@ Object.assign(UTXOInput, {
     },
 });
 
+// Assign the util method on Block here to prevent loading bindings (callUtilsMethod)
+// when importing Block just for typing.
+Object.assign(Block, {
+    /**
+     * Returns the block id for the given block.
+     */
+    id(block: Block, params: ProtocolParameters): BlockId {
+        return Utils.blockId(block, params);
+    },
+});
+
 export * from './client';
 export * from './secret_manager';
 export * from './types';

bindings/nodejs/lib/types/block/core/block.ts

@@ -10,6 +10,7 @@ import { BlockBody } from './block-body';
 import { BasicBlockBody } from './basic';
 import { ValidationBlockBody } from './validation';
 import { BlockBodyDiscriminator } from '.';
+import { ProtocolParameters, BlockId } from '../../..';
 
 /**
  * The block header.
@@ -118,6 +119,15 @@ class Block {
     asValidation(): ValidationBlockBody {
         return this.body.asValidation();
     }
+
+    /**
+     * Returns the block id.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    static id(block: Block, params: ProtocolParameters): BlockId {
+        // Implementation injected in lib/index.ts, as it uses bindings.
+        return null as unknown as BlockId;
+    }
 }
 
 function parseBlock(data: any): Block {

bindings/nodejs/lib/types/models/info/node-info-protocol.ts

@@ -3,12 +3,12 @@
 
 import type { StorageScoreParameters } from '../storage-score';
 import { EpochIndex } from '../../block/slot';
-import { u64 } from '../../utils';
+import { u64 } from '../../utils/type-aliases';
 
 /**
  * The Protocol Info.
  */
-export interface ProtocolInfo {
+interface ProtocolInfo {
     /**
      * The start epoch of the set of protocol parameters.
      */
@@ -22,7 +22,7 @@ export interface ProtocolInfo {
 /**
  * The Protocol Parameters.
  */
-export interface ProtocolParameters {
+interface ProtocolParameters {
     /**
      * Set to value 0 to denote a IOTA 2.0 protocol parameter.
      */
@@ -129,7 +129,7 @@ export interface ProtocolParameters {
 /**
  * Rewards Parameters defines the parameters that are used to calculate Mana rewards.
  */
-export interface RewardsParameters {
+interface RewardsParameters {
     /**
      * Profit Margin Exponent is used for shift operation for calculation of profit margin.
      */
@@ -164,7 +164,7 @@ export interface RewardsParameters {
 /**
  * Work Score Parameters lists the work score of each type, it is used to denote the computation costs of processing an object.
  */
-export interface WorkScoreParameters {
+interface WorkScoreParameters {
     /**
      * DataByte accounts for the network traffic per kibibyte.
      */
@@ -210,7 +210,7 @@ export interface WorkScoreParameters {
 /**
  * ManaParameters defines the parameters used by mana calculation.
  */
-export interface ManaParameters {
+interface ManaParameters {
     /**
      * The number of bits used to represent Mana.
      */
@@ -244,7 +244,7 @@ export interface ManaParameters {
 /**
  * Congestion Control Parameters defines the parameters used to calculate the Reference Mana Cost (RMC).
  */
-export interface CongestionControlParameters {
+interface CongestionControlParameters {
     /**
      * The minimum value of the reference Mana cost.
      */
@@ -282,7 +282,7 @@ export interface CongestionControlParameters {
 /**
  * The version signaling parameters.
  */
-export interface VersionSignalingParameters {
+interface VersionSignalingParameters {
     /**
      * The size of the window in epochs to find which version of protocol parameters was most signaled, from currentEpoch - windowSize to currentEpoch.
      */
@@ -296,3 +296,14 @@ export interface VersionSignalingParameters {
      */
     activationOffset: number;
 }
+
+export {
+    ProtocolInfo,
+    ProtocolParameters,
+    RewardsParameters,
+    WorkScoreParameters,
+    StorageScoreParameters,
+    ManaParameters,
+    VersionSignalingParameters,
+    CongestionControlParameters,
+};

bindings/nodejs/lib/types/models/storage-score.ts

@@ -1,7 +1,7 @@
 // Copyright 2023 IOTA Stiftung
 // SPDX-License-Identifier: Apache-2.0
 
-import { u64 } from '../../utils';
+import { u64 } from '../utils/type-aliases';
 
 /**
  * Defines the parameters of storage score calculations on objects which take node resources.

bindings/nodejs/tests/types/block.spec.ts

@@ -0,0 +1,38 @@
+// Copyright 2024 IOTA Stiftung
+// SPDX-License-Identifier: Apache-2.0
+
+import 'reflect-metadata';
+
+import { expect, describe, it } from '@jest/globals';
+import * as basic_block_tagged_data_payload_json from '../../../../sdk/tests/types/fixtures/basic_block_tagged_data_payload.json';
+import * as basic_block_transaction_payload_json from '../../../../sdk/tests/types/fixtures/basic_block_transaction_payload.json';
+import * as validation_block_json from '../../../../sdk/tests/types/fixtures/validation_block.json';
+import * as protocol_parameters_json from '../../../../sdk/tests/types/fixtures/protocol_parameters.json';
+import { Block, BlockId, parseBlock, ProtocolParameters } from '../../';
+
+describe('Block tests', () => {
+
+    it('compares basic block tagged data payload from a fixture', async () => {
+        const block = parseBlock(basic_block_tagged_data_payload_json.block);
+        expect(block).toBeInstanceOf(Block);
+        const params: ProtocolParameters = JSON.parse(JSON.stringify(protocol_parameters_json.params));
+        const expected_id = basic_block_tagged_data_payload_json.id as BlockId;
+        expect(Block.id(block, params)).toEqual(expected_id);
+    });
+
+    it('compares basic block transaction payload from a fixture', async () => {
+        const block = parseBlock(basic_block_transaction_payload_json.block);
+        expect(block).toBeInstanceOf(Block);
+        const params: ProtocolParameters = JSON.parse(JSON.stringify(protocol_parameters_json.params));
+        const expected_id = basic_block_transaction_payload_json.id as BlockId;
+        expect(Block.id(block, params)).toEqual(expected_id);
+    });
+
+    it('compares validation block from a fixture', async () => {
+        const block = parseBlock(validation_block_json.block);
+        expect(block).toBeInstanceOf(Block);
+        const params: ProtocolParameters = JSON.parse(JSON.stringify(protocol_parameters_json.params));
+        const expected_id = validation_block_json.id as BlockId;
+        expect(Block.id(block, params)).toEqual(expected_id);
+    });
+});

bindings/nodejs/tests/types/protocol_parameters.spec.ts

@@ -12,7 +12,7 @@ describe('ProtocolParameters tests', () => {
 
     it('compares ProtocolParameters hash from a fixture', async () => {
 
-        const params = protocol_parameters.params as unknown as ProtocolParameters;
+        const params: ProtocolParameters = JSON.parse(JSON.stringify(protocol_parameters.params));
         const hash = Utils.protocolParametersHash(params);
         const expected_hash = protocol_parameters.hash;