Merge remote-tracking branch 'origin/feat-5.0.0' into feat-keys-and-w…

…rapper

src/sse/event.ts

@@ -114,14 +114,14 @@ export class RawEvent {
   parseAsTransactionProcessedEvent(): TransactionProcessedEvent {
     return this.parseEvent(
       TransactionProcessedEvent,
-      TransactionProcessedEvent.fromJson
+      TransactionProcessedEvent.fromJSON
     );
   }
 
   parseAsTransactionAcceptedEvent(): TransactionAcceptedEvent {
     return this.parseEvent(
       TransactionAcceptedEvent,
-      TransactionAcceptedEvent.fromJson
+      TransactionAcceptedEvent.fromJSON
     );
   }
 
@@ -340,7 +340,7 @@ export class TransactionAcceptedEvent {
   })
   transactionAcceptedPayload: TransactionAcceptedPayload;
 
-  public static fromJson(data: unknown): TransactionAcceptedEvent | Error {
+  public static fromJSON(data: unknown): TransactionAcceptedEvent | Error {
     try {
       const transactionEvent = TypedJSON.parse(data, TransactionAcceptedEvent);
       if (!transactionEvent) throw new Error('TransactionAcceptedEvent is nil');
@@ -475,7 +475,7 @@ export class TransactionProcessedEvent {
   })
   transactionProcessedPayload: TransactionProcessedPayload;
 
-  public static fromJson(data: any): TransactionProcessedEvent | Error {
+  public static fromJSON(data: any): TransactionProcessedEvent | Error {
     try {
       const transactionEvent = TypedJSON.parse(data, TransactionProcessedEvent);
       if (!transactionEvent)

src/types/Deploy.test.ts

@@ -6,8 +6,7 @@ import {
   TransferDeployItem
 } from './ExecutableDeployItem';
 import { Deploy, DeployHeader } from './Deploy';
-import { PrivateKey } from './keypair/PrivateKey';
-import { KeyAlgorithm } from './keypair/Algorithm';
+import { KeyAlgorithm, PrivateKey } from './keypair';
 import { Duration, Timestamp } from './Time';
 import { Hash } from './key';
 import { dehumanizerTTL, humanizerTTL } from './SerializationUtils';
@@ -63,7 +62,7 @@ describe('Deploy', () => {
     deploy.sign(senderKey);
     deploy.sign(recipientKey);
 
-    const json = Deploy.toJson(deploy);
+    const json = Deploy.toJSON(deploy);
 
     deploy = Deploy.fromJSON(json);
 

src/types/Deploy.ts

@@ -464,7 +464,7 @@ export class Deploy {
    * @param deploy The deploy object to convert to JSON.
    * @returns A JSON representation of the deploy.
    */
-  public static toJson = (deploy: Deploy) => {
+  public static toJSON = (deploy: Deploy) => {
     const serializer = new TypedJSON(Deploy);
     return serializer.toPlainJson(deploy);
   };

src/types/EraEnd.ts

@@ -6,11 +6,8 @@ import {
 } from 'typedjson';
 import { PublicKey } from './keypair';
 import { ValidatorWeightEraEnd } from './ValidatorWeight';
-import {
-  CLValueUInt512,
-  deserializeRewards,
-  serializeRewards
-} from './clvalue';
+import { CLValueUInt512 } from './clvalue';
+import { deserializeRewards, serializeRewards } from './SerializationUtils';
 
 /**
  * Class representing the rewards associated with a validator in a given era.
@@ -252,7 +249,7 @@ export class EraEnd {
   @jsonMapMember(String, CLValueUInt512, {
     name: 'rewards',
     deserializer: deserializeRewards,
-    serializer: (map: Map<string, CLValueUInt512[]>) => serializeRewards(map),
+    serializer: (map: Map<string, CLValueUInt512[]>) => serializeRewards(map)
   })
   public rewards: Map<string, CLValueUInt512[]>;
 

src/types/PricingMode.ts

@@ -40,7 +40,7 @@ export class PaymentLimitedMode {
     );
     calltableSerializer.addField(
       3,
-      CLValueBool.fromBoolean(this.standardPayment).bytes()
+      CLValueBool.newCLValueBool(this.standardPayment).bytes()
     );
 
     return calltableSerializer.toBytes();

src/types/SerializationUtils.ts

@@ -2,6 +2,7 @@ import { TypedJSON } from 'typedjson';
 import humanizeDuration from 'humanize-duration';
 import { Args } from './Args';
 import { Conversions } from './Conversions';
+import { CLValueUInt512 } from './clvalue';
 
 /**
  * Serializes a `Uint8Array` into a hexadecimal string.
@@ -172,3 +173,38 @@ export const serializeArgs = (ra: Args, asNamed = false) => {
 
   return argsArray;
 };
+
+/**
+ * Deserializes an array of rewards into a Map.
+ * @param arr - The array to be deserialized, where each element is a tuple containing a key and an array of rewards.
+ * @returns A Map where each key corresponds to an array of CLValueUInt512 rewards.
+ * @throws Will throw an error if duplicate keys are detected.
+ */
+export const deserializeRewards = (arr: any) => {
+  const parsed = new Map(
+    Array.from(arr, ([key, value]) => {
+      const valuesArray = value.map((item: any) =>
+        CLValueUInt512.fromJSON(item)
+      );
+      return [key, valuesArray];
+    })
+  );
+
+  if (parsed.size !== Array.from(arr).length) {
+    throw Error(`Duplicate key exists.`);
+  }
+
+  return parsed;
+};
+
+/**
+ * Serializes a Map of rewards into an array format suitable for JSON storage.
+ * @param map - A Map where each key corresponds to an array of CLValueUInt512 rewards.
+ * @returns An array where each element is a tuple containing a key and an array of rewards in JSON format.
+ */
+export const serializeRewards = (map: Map<string, CLValueUInt512[]>) => {
+  return Array.from(map, ([key, value]) => {
+    const serializedValue = value.map(item => item.toJSON());
+    return [key, serializedValue];
+  });
+};

src/types/Transaction.ts

@@ -265,7 +265,7 @@ export class TransactionV1 {
    * @param transaction The `TransactionV1` object.
    * @returns A JSON version of the `TransactionV1`.
    */
-  public static toJson = (transaction: TransactionV1) => {
+  public static toJSON = (transaction: TransactionV1) => {
     const serializer = new TypedJSON(TransactionV1);
 
     return serializer.toPlainJson(transaction);
@@ -550,7 +550,7 @@ export class Transaction {
     return Deploy.newTransactionFromDeploy(deploy);
   }
 
-  static fromJson(json: any): Transaction {
+  static fromJSON(json: any): Transaction {
     try {
       const txV1 = TransactionV1.fromJSON(json);
 
@@ -568,11 +568,11 @@ export class Transaction {
 
   toJSON() {
     if (this.originTransactionV1) {
-      return TransactionV1.toJson(this.originTransactionV1);
+      return TransactionV1.toJSON(this.originTransactionV1);
     }
 
     if (this.originDeployV1) {
-      return Deploy.toJson(this.originDeployV1)
+      return Deploy.toJSON(this.originDeployV1)
     }
 
     throw new Error('Incorrect Transaction instance. Missing origin value');

src/types/clvalue/Bool.test.ts

@@ -31,7 +31,7 @@ describe('CLBool', () => {
   });
 
   it('toJSON() / fromJSON() do proper bytes serialization', () => {
-    const myBool = CLValueBool.fromBoolean(false);
+    const myBool = CLValueBool.newCLValueBool(false);
     const json = CLValueParser.toJSON(myBool);
     const expectedJson = JSON.parse('{"bytes":"00","cl_type":"Bool"}');
 

src/types/clvalue/Bool.ts

@@ -54,7 +54,7 @@ export class CLValueBool {
    * @param val - The boolean value to be stored in the CLValue.
    * @returns A new CLValue instance encapsulating the boolean value.
    */
-  public static fromBoolean(val: boolean): CLValue {
+  public static newCLValueBool(val: boolean): CLValue {
     const res = new CLValue(CLTypeBool);
     res.bool = new CLValueBool(val);
     return res;

src/types/clvalue/CLValue.ts

@@ -8,15 +8,17 @@ import {
 } from './cltype';
 import { URef, Key } from '../key';
 import { PublicKey } from '../keypair';
-import { CLValueUInt8 } from './Uint8';
-import { CLValueInt64 } from './Int64';
-import { CLValueInt32 } from './Int32';
+import {
+  CLValueUInt8,
+  CLValueInt64,
+  CLValueInt32,
+  CLValueUInt32,
+  CLValueUInt64,
+  CLValueUInt128,
+  CLValueUInt256,
+  CLValueUInt512
+} from './Numeric';
 import { CLValueBool } from './Bool';
-import { CLValueUInt32 } from './Uint32';
-import { CLValueUInt64 } from './Uint64';
-import { CLValueUInt128 } from './Uint128';
-import { CLValueUInt256 } from './Uint256';
-import { CLValueUInt512 } from './Uint512';
 import { CLValueUnit } from './Unit';
 import { CLValueOption } from './Option';
 import { CLValueList } from './List';

src/types/clvalue/List.test.ts

@@ -2,7 +2,7 @@ import { expect } from 'chai';
 import { CLTypeBool, CLTypeList, CLTypeUInt32 } from './cltype';
 import { concat } from '@ethersproject/bytes';
 import { toBytesU32 } from '../ByteConverters';
-import { CLValueUInt32 } from './Uint32';
+import { CLValueUInt32 } from './Numeric/Uint32';
 import { CLValueList } from './List';
 import { BigNumber } from '@ethersproject/bignumber';
 import { CLValue } from './CLValue';
@@ -108,8 +108,8 @@ describe('CLValueList with boolean values', () => {
 
   beforeEach(() => {
     boolTypeList = new CLTypeList(CLTypeBool);
-    trueElement = CLValueBool.fromBoolean(true);
-    falseElement = CLValueBool.fromBoolean(false);
+    trueElement = CLValueBool.newCLValueBool(true);
+    falseElement = CLValueBool.newCLValueBool(false);
     clValueBoolList = new CLValueList(boolTypeList, [
       trueElement,
       falseElement
@@ -135,7 +135,7 @@ describe('CLValueList with boolean values', () => {
   });
 
   it('should add a boolean element to the list when calling append()', () => {
-    const newElement = CLValueBool.fromBoolean(true);
+    const newElement = CLValueBool.newCLValueBool(true);
     clValueBoolList.append(newElement);
     expect(clValueBoolList.elements).to.deep.equal([
       trueElement,
@@ -151,7 +151,7 @@ describe('CLValueList with boolean values', () => {
   });
 
   it('should throw error if index is out of bounds in set() for boolean list', () => {
-    const newElement = CLValueBool.fromBoolean(false);
+    const newElement = CLValueBool.newCLValueBool(false);
     expect(() => clValueBoolList.set(2, newElement)).to.throw(
       'List index out of bounds.'
     );

src/types/clvalue/List.ts

@@ -2,7 +2,7 @@ import { concat } from '@ethersproject/bytes';
 
 import { CLType, CLTypeList } from './cltype';
 import { CLValue, IResultWithBytes } from './CLValue';
-import { CLValueUInt32 } from './Uint32';
+import { CLValueUInt32 } from './Numeric';
 import { CLValueParser } from './Parser';
 import { toBytesU32 } from '../ByteConverters';
 
@@ -152,7 +152,7 @@ export class CLValueList {
     clType: CLTypeList
   ): IResultWithBytes<CLValueList> {
     const { result: u32, bytes: u32Bytes } = CLValueUInt32.fromBytes(source);
-    const size = u32.getValue().toNumber();
+    const size = u32.toNumber();
     let remainder = u32Bytes;
     const elements: CLValue[] = [];
 

src/types/clvalue/Map.ts

@@ -3,7 +3,7 @@ import { concat } from '@ethersproject/bytes';
 import { CLType, CLTypeMap } from './cltype';
 import { CLValue, IResultWithBytes } from './CLValue';
 import { CLValueTuple2 } from './Tuple2';
-import { CLValueUInt32 } from './Uint32';
+import { CLValueUInt32 } from './Numeric';
 import { CLValueParser } from './Parser';
 import { toBytesU32 } from '../ByteConverters';
 
@@ -194,7 +194,7 @@ export class CLValueMap {
     const mapResult = new CLValueMap(mapType);
 
     const { result: u32, bytes: u32Bytes } = CLValueUInt32.fromBytes(bytes);
-    const size = u32.getValue().toNumber();
+    const size = u32.toNumber();
     const remainder = u32Bytes;
 
     if (size === 0) {

src/types/clvalue/Numeric/Abstract.ts

@@ -0,0 +1,56 @@
+import { BigNumber, BigNumberish } from '@ethersproject/bignumber';
+
+/**
+ * Abstract class representing a numeric value in the Casper type system.
+ * Provides common methods and properties for numeric types.
+ */
+export abstract class CLValueNumeric {
+  protected value: BigNumberish;
+
+  /**
+   * The constructor is protected to ensure this class cannot be instantiated directly.
+   * Subclasses can call this constructor using `super`.
+   */
+  protected constructor(value: BigNumberish) {
+    this.value = value;
+  }
+
+  /**
+   * Converts the numeric value to its byte representation.
+   * Must be implemented by subclasses.
+   */
+  public abstract bytes(): Uint8Array;
+
+  /**
+   * Provides a string representation of the numeric value.
+   * @returns The string representation of the value.
+   */
+  public toString(): string {
+    return this.value.toString();
+  }
+
+  /**
+   * Converts the numeric value to a JavaScript number.
+   * @returns The numeric value as a JavaScript number.
+   */
+  public toNumber(): number {
+    const bigNumber = BigNumber.from(this.value);
+    return bigNumber.toNumber();
+  }
+
+  /**
+   * Converts the instance to a JSON-compatible string.
+   * @returns {string} The string representation of the instance.
+   */
+  public toJSON(): string {
+    return this.toString();
+  }
+
+  /**
+   * Retrieves the numeric value.
+   * @returns The numeric representation of the value.
+   */
+  public getValue(): BigNumberish {
+    return this.value;
+  }
+}