@arkecosystem/typescript-crypto 0.0.1

package/src/utils/AbiBase.ts

@@ -0,0 +1,32 @@
+import { ContractAbiType } from "@/enums/ContractAbiType";
+import { Interface } from "ethers";
+import ConsensusContract from "./Abi/json/Abi.Consensus.json";
+import MultipaymentContract from "./Abi/json/Abi.Multipayment.json";
+import UsernamesContract from "./Abi/json/Abi.Usernames.json";
+
+export abstract class AbiBase {
+	protected interface: Interface;
+
+	constructor(type: ContractAbiType = ContractAbiType.CONSENSUS, customAbi?: string) {
+		const abi = this.contractAbi(type, customAbi);
+
+		this.interface = new Interface(JSON.parse(JSON.stringify(abi)).abi);
+	}
+
+	private contractAbi(type: ContractAbiType = ContractAbiType.CONSENSUS, customAbi?: any): object {
+		switch (type) {
+			case ContractAbiType.CONSENSUS:
+				return ConsensusContract;
+			case ContractAbiType.MULTIPAYMENT:
+				return MultipaymentContract;
+			case ContractAbiType.USERNAMES:
+				return UsernamesContract;
+		}
+
+		if (customAbi) {
+			return customAbi;
+		}
+
+		throw new Error("Invalid contract type");
+	}
+}

package/src/utils/AbiDecoder.ts

@@ -0,0 +1,19 @@
+import { AbiResult } from "@/types";
+import { AbiBase } from "./AbiBase";
+import { Result } from "ethers";
+
+export class AbiDecoder extends AbiBase {
+	decodeFunctionData(data: string): AbiResult {
+		if (!data.startsWith("0x")) {
+			data = "0x" + data;
+		}
+
+		const functionSelector = data.slice(0, 10);
+		const functionFragment = this.interface.getFunction(functionSelector);
+
+		return {
+			functionName: functionFragment!.name,
+			args: this.interface.decodeFunctionData(functionFragment!, data),
+		};
+	}
+}

package/src/utils/AbiEncoder.ts

@@ -0,0 +1,7 @@
+import { AbiBase } from "./AbiBase";
+
+export class AbiEncoder extends AbiBase {
+	encodeFunctionCall(functionName: string, parameters: any[]): string {
+		return this.interface.encodeFunctionData(functionName, parameters);
+	}
+}

package/src/utils/Helpers.ts

@@ -0,0 +1,46 @@
+import { InvalidUsernameException } from "@/exceptions/InvalidUsernameException";
+
+export class Helpers {
+	/**
+	 * Validates a username based on specific rules.
+	 * Based on https://github.com/ArkEcosystem/mainsail/blob/develop/contracts/src/usernames/UsernamesV1.sol#L101
+	 *
+	 * @param username The username to validate
+	 * @returns true if the username is valid
+	 * @throws InvalidUsernameException if the username is invalid
+	 */
+	public static isValidUsername(username: string): boolean {
+		if (username.length < 1 || username.length > 20) {
+			throw new InvalidUsernameException(
+				`Username must be between 1 and 20 characters long. Got ${username.length} characters.`,
+			);
+		}
+
+		// Only lowercase letters, numbers and underscores are allowed
+		if (/[^a-z0-9_]/.test(username)) {
+			throw new InvalidUsernameException("Username can only contain lowercase letters, numbers and underscores.");
+		}
+
+		// Cannot start or end with underscore
+		if (/^_|_$/.test(username)) {
+			throw new InvalidUsernameException("Username cannot start or end with an underscore.");
+		}
+
+		// Cannot contain two or more consecutive underscores
+		if (/__/.test(username)) {
+			throw new InvalidUsernameException("Username cannot contain consecutive underscores.");
+		}
+
+		return true;
+	}
+
+	/**
+	 * Removes the leading '0x' from a hex string.
+	 *
+	 * @param hex The hex string to process
+	 * @returns The hex string without the leading '0x'
+	 */
+	public static removeLeadingHexZero(hex: string): string {
+		return hex.replace(/^0x/, ""); // Using replace to only remove the prefix, not leading zeros
+	}
+}

package/src/utils/Message.ts

@@ -0,0 +1,63 @@
+import { PrivateKey } from "@/identities/PrivateKey";
+import { PublicKey } from "@/identities/PublicKey";
+import { SignedMessage } from "@/types";
+import { keccak256 } from "ethers";
+// import { verify } from "tiny-secp256k1";
+import { verify } from "@noble/secp256k1";
+
+export class Message {
+	public publicKey: string;
+	public signature: string;
+	public message: string;
+
+	constructor(message: SignedMessage) {
+		this.publicKey = message.publicKey;
+		this.signature = message.signature;
+		this.message = message.message;
+	}
+
+	static new(message: SignedMessage): Message {
+		return new Message(message);
+	}
+
+	static async sign(message: string, passphrase: string): Promise<Message> {
+		const privateKey = PrivateKey.fromPassphrase(passphrase);
+		const publicKey = PublicKey.fromPassphrase(passphrase).publicKey;
+
+		const signature = await privateKey.sign(Buffer.from(message).toString("hex"));
+
+		return Message.new({
+			publicKey,
+			signature: signature.r + signature.s + Number(signature.v).toString(16),
+			message,
+		});
+	}
+
+	verify(): boolean {
+		const message = Buffer.from(keccak256(Buffer.from(this.message)).slice(2), "hex");
+		const signature = Buffer.from(this.signature.slice(0, 128), "hex");
+		const publicKey = Buffer.from(this.publicKey, "hex");
+
+		// const r = signature.subarray(0, 32).readBigInt64BE();
+		// const s = signature.subarray(32, 64).readBigInt64BE();
+		// const v = Number(signature.subarray(64, 66).toString("hex"));
+
+		return verify(signature, message, publicKey);
+	}
+
+	toString(): string {
+		return JSON.stringify(this.toJson());
+	}
+
+	toArray(): string[] {
+		return [this.publicKey, this.signature, this.message];
+	}
+
+	toJson(): SignedMessage {
+		return {
+			publicKey: this.publicKey,
+			signature: this.signature,
+			message: this.message,
+		};
+	}
+}

package/src/utils/Slot.ts

@@ -0,0 +1,11 @@
+import { Network } from "@/configuration/Network";
+
+export class Slot {
+	static time(): number {
+		return Math.floor(Date.now() / 1000) - this.epoch();
+	}
+
+	static epoch(): number {
+		return Math.floor(new Date(Network.get().epoch()).getTime() / 1000);
+	}
+}

package/src/utils/TransactionUtils.ts

@@ -0,0 +1,43 @@
+import { encodeRlp, keccak256, toBeArray } from "ethers";
+import { Constants } from "@/enums/Constants";
+import { TransactionData } from "@/types";
+
+export class TransactionUtils {
+	public static toBuffer(transaction: TransactionData, skipSignature: boolean = false): Buffer {
+        const fields = [
+            toBeArray(transaction['network'] ?? 0),
+            toBeArray(transaction['nonce'] ? transaction['nonce'] : 0),
+            toBeArray(0),
+            toBeArray(transaction['gasPrice'] ?? 0),
+            toBeArray(transaction['gasLimit'] ?? 0),
+            transaction['recipientAddress'] ?? '0x',
+            toBeArray(transaction['value'] ? transaction['value'] : 0),
+            transaction['data'] && transaction['data'].startsWith('0x')
+                ? transaction['data']
+                : ('0x' + (transaction['data'] ?? '')),
+            [],
+        ];
+
+        if (! skipSignature && transaction['v'] && transaction['r'] && transaction['s']) {
+			fields.push(toBeArray(transaction['v'] - Constants.ETHEREUM_RECOVERY_ID_OFFSET));
+			fields.push('0x' + transaction['r']);
+			fields.push('0x' + transaction['s']);
+		}
+
+		const encoded = encodeRlp(fields);
+
+        const payload = Constants.EIP_1559_PREFIX + encoded.substring(2);
+
+        return Buffer.from(payload);
+	}
+
+	public static toHash(transaction: TransactionData, skipSignature: boolean = false): string {
+        const encoding = this.toBuffer(transaction, skipSignature);
+
+        return keccak256('0x' + encoding.toString('binary')).substring(2);
+	}
+
+	public static getId(transaction: TransactionData): string {
+		return this.toHash(transaction, false);
+	}
+}

package/src/utils/UnitConverter.ts

@@ -0,0 +1,57 @@
+import BigNumber from "bignumber.js";
+
+const WEI_MULTIPLIER = 1;
+const GWEI_MULTIPLIER = 1000000000; // 1e9
+const ARK_MULTIPLIER = 1000000000000000000; // 1e18
+
+export class UnitConverter {
+	static parseUnits(value: number|string, unit: string = 'ark'): BigNumber {
+        switch (unit.toLowerCase()) {
+            case 'wei':
+				return BigNumber(value).multipliedBy(WEI_MULTIPLIER);
+			case 'gwei':
+				return BigNumber(value).multipliedBy(GWEI_MULTIPLIER);
+			case 'ark':
+				return BigNumber(value).multipliedBy(ARK_MULTIPLIER);
+            default:
+                throw new Error(`Unsupported unit: ${unit}. Supported units are 'wei', 'gwei', and 'ark'.`);
+        }
+	}
+
+	static formatUnits(value: string, unit: string = 'ark'): number {
+        switch (unit.toLowerCase()) {
+            case 'wei':
+				return BigNumber(value).dividedBy(WEI_MULTIPLIER).toNumber();
+            case 'gwei':
+				return BigNumber(value).dividedBy(GWEI_MULTIPLIER).toNumber();
+            case 'ark':
+				return BigNumber(value).dividedBy(ARK_MULTIPLIER).toNumber();
+            default:
+                throw new Error(`Unsupported unit: ${unit}. Supported units are 'wei', 'gwei', and 'ark'.`);
+        }
+    }
+
+	static weiToArk(value: number|string, suffix?: string): string {
+		const convertedValue = new BigNumber(this.formatUnits(this.parseUnits(value, 'wei').toString(), 'ark'))
+			.decimalPlaces(18)
+			.toFixed();
+
+        if (suffix) {
+            return convertedValue + ' ' + suffix;
+        }
+
+        return convertedValue;
+	}
+
+	static gweiToArk(value: number|string, suffix?: string): string {
+		const convertedValue = new BigNumber(this.formatUnits(this.parseUnits(value, 'gwei').toString(), 'ark'))
+			.decimalPlaces(18)
+			.toFixed();
+
+        if (suffix) {
+            return convertedValue + ' ' + suffix;
+        }
+
+        return convertedValue;
+	}
+}

package/src/utils/index.ts

@@ -0,0 +1,8 @@
+export * from "./AbiBase";
+export * from "./AbiDecoder";
+export * from "./AbiEncoder";
+export * from "./Helpers";
+export * from "./Message";
+export * from "./Slot";
+export * from "./TransactionUtils";
+export * from "./UnitConverter";

package/tests/fixtures/global.json

@@ -0,0 +1,10 @@
+{
+	"address": "0x6f0182a0cc707b055322ccf6d4cb6a5aff1aeb22",
+	"passphrase": "found lobster oblige describe ready addict body brave live vacuum display salute lizard combine gift resemble race senior quality reunion proud tell adjust angle",
+	"secondPassphrase": "this is a top secret second passphrase",
+	"passphrases": [
+        "album pony urban cheap small blade cannon silent run reveal luxury glad predict excess fire beauty hollow reward solar egg exclude leaf sight degree",
+        "hen slogan retire boss upset blame rocket slender area arch broom bring elder few milk bounce execute page evoke once inmate pear marine deliver",
+        "top visa use bacon sun infant shrimp eye bridge fantasy chair sadness stable simple salad canoe raw hill target connect avoid promote spider category"
+    ]
+}

package/tests/fixtures/identity.json

@@ -0,0 +1,11 @@
+{
+    "data": {
+      "publicKey": "0243333347c8cbf4e3cbc7a96964181d02a2b0c854faa2fef86b4b8d92afcf473d",
+      "privateKey": "50829dd3b7ffbe2df401d730b5e60cea7520ba3f3a18e5b1490707667fb43fae",
+      "address": "0x1E6747BEAa5B4076a6A98D735DF8c35a70D18Bdd",
+      "wif": "UZYnRZ8qpeQWTLeCNzw93guWSdKLmr2vHEWGG4sNv7TJofL7TZvy",
+      "validatorPublicKey": "b209f4a7454ae17c5808991dffbf204c747b851f351d2ce72a6e18903d0e2f609e0328ebbc3fb97cd4d3660b4bc156f1",
+      "validatorPrivateKey": "6ec4993df152b10e672567c1fdf854a4cee50708fa30986a7d9b259673099175"
+    },
+    "passphrase": "found lobster oblige describe ready addict body brave live vacuum display salute lizard combine gift resemble race senior quality reunion proud tell adjust angle"
+  }

package/tests/fixtures/message-sign.json

@@ -0,0 +1,5 @@
+{
+	"message": "Hello, world!",
+	"publicKey": "0243333347c8cbf4e3cbc7a96964181d02a2b0c854faa2fef86b4b8d92afcf473d",
+	"signature": "0e2e53409be748834cac44052817ecef569b429a0492aa6bbc0d934eb71a09547e77aeef33d45669bbcba0498149f0e2b637fe8905186e08a5410c6f2b013bb41b"
+}

package/tests/fixtures/sign-compact.json

@@ -0,0 +1,10 @@
+{
+	"data": {
+		"serialized": "1c104665257d4dea61c4654e74c6c0f6cd0a398905781c3040bea67dc641a66da046d718d04b2331f3b0561808549ed3f3f0d867a284acf6b334869078df7a9136",
+		"message": "02ea822710018085012a05f200825208946f0182a0cc707b055322ccf6d4cb6a5aff1aeb228405f5e10080c0",
+		"v": 28,
+		"r": "104665257d4dea61c4654e74c6c0f6cd0a398905781c3040bea67dc641a66da0",
+		"s": "46d718d04b2331f3b0561808549ed3f3f0d867a284acf6b334869078df7a9136"
+	},
+	"passphrase": "found lobster oblige describe ready addict body brave live vacuum display salute lizard combine gift resemble race senior quality reunion proud tell adjust angle"
+}

package/tests/fixtures/transactions/evm-sign.json

@@ -0,0 +1,18 @@
+{
+	"data": {
+		"network": 10000,
+		"nonce": "1",
+		"gasPrice": "5000000000",
+		"gasLimit": "200000",
+		"recipientAddress": "0xE536720791A7DaDBeBdBCD8c8546fb0791a11901",
+		"value": "0",
+		"data": "a9059cbb00000000000000000000000027fa7caffaae77ddb9ab232fdbda56d5e5af23930000000000000000000000000000000000000000000000000000000000000064",
+		"v": 28,
+		"r": "8cd7afafdfaaa6c4b6c97e49888dff89713c99f8b1324693ef4427ce88994bbe",
+		"s": "01c589bb8d3bc908aaee56d64ca35458f2cebf977bbc29180c574aba8bc12b0d",
+		"senderPublicKey": "0243333347c8cbf4e3cbc7a96964181d02a2b0c854faa2fef86b4b8d92afcf473d",
+		"senderAddress": "0x1E6747BEAa5B4076a6A98D735DF8c35a70D18Bdd",
+		"id": "85cdc2ae6cd4569dd1b5b11df10fc409b3996864032d6acf87ff907286f40a03"
+	},
+	"serialized": "02f8af822710018085012a05f20083030d4094e536720791a7dadbebdbcd8c8546fb0791a1190180b844a9059cbb00000000000000000000000027fa7caffaae77ddb9ab232fdbda56d5e5af23930000000000000000000000000000000000000000000000000000000000000064c001a08cd7afafdfaaa6c4b6c97e49888dff89713c99f8b1324693ef4427ce88994bbea001c589bb8d3bc908aaee56d64ca35458f2cebf977bbc29180c574aba8bc12b0d"
+}

package/tests/fixtures/transactions/multipayment-empty.json

@@ -0,0 +1,18 @@
+{
+	"data": {
+		"network": 10000,
+		"nonce": "1",
+		"gasPrice": "5000000000",
+		"gasLimit": "200000",
+		"recipientAddress": "0x00EFd0D4639191C49908A7BddbB9A11A994A8527",
+		"value": "0",
+		"data": "084ce7080000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
+		"v": 27,
+		"r": "cbec73e1cba1177789adf44fcd3cea797d132563635fae211c350acd7c328046",
+		"s": "216eabb6cd1eb5c0000e7eb74f66595bd5b688f43dd646f15f33e3827c8c966b",
+		"senderPublicKey": "0243333347c8cbf4e3cbc7a96964181d02a2b0c854faa2fef86b4b8d92afcf473d",
+		"senderAddress": "0x1E6747BEAa5B4076a6A98D735DF8c35a70D18Bdd",
+		"id": "555fcaca65f9319c638ebb15c5ffdee0a5e41b7dc3b171aca3707bc43f40ed57"
+	},
+	"serialized": "02f8ef822710018085012a05f20083030d409400efd0d4639191c49908a7bddbb9a11a994a852780b884084ce7080000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c080a0cbec73e1cba1177789adf44fcd3cea797d132563635fae211c350acd7c328046a0216eabb6cd1eb5c0000e7eb74f66595bd5b688f43dd646f15f33e3827c8c966b"
+}

package/tests/fixtures/transactions/multipayment-single.json

@@ -0,0 +1,18 @@
+{
+	"data": {
+		"network": 10000,
+		"nonce": "1",
+		"gasPrice": "5000000000",
+		"gasLimit": "200000",
+		"recipientAddress": "0x00EFd0D4639191C49908A7BddbB9A11A994A8527",
+		"value": "100000",
+		"data": "084ce7080000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000010000000000000000000000006f0182a0cc707b055322ccf6d4cb6a5aff1aeb22000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000186a0",
+		"v": 28,
+		"r": "e381eb89f21e450009706650346e3abfaee0c91c5685c8ec923d86b8212a2427",
+		"s": "5b3a7bfdec8ca69469e989805e7715f5d317bf62304f868a905224e7dabe7b37",
+		"senderPublicKey": "0243333347c8cbf4e3cbc7a96964181d02a2b0c854faa2fef86b4b8d92afcf473d",
+		"senderAddress": "0x1E6747BEAa5B4076a6A98D735DF8c35a70D18Bdd",
+		"id": "1d0e3d567ffa39defba7904202941070b224f885f9399c817a58aeb36f4f3863"
+	},
+	"serialized": "02f90132822710018085012a05f20083030d409400efd0d4639191c49908a7bddbb9a11a994a8527830186a0b8c4084ce7080000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000010000000000000000000000006f0182a0cc707b055322ccf6d4cb6a5aff1aeb22000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000186a0c001a0e381eb89f21e450009706650346e3abfaee0c91c5685c8ec923d86b8212a2427a05b3a7bfdec8ca69469e989805e7715f5d317bf62304f868a905224e7dabe7b37"
+}

package/tests/fixtures/transactions/multipayment.json

@@ -0,0 +1,18 @@
+{
+	"data": {
+		"network": 10000,
+		"nonce": "1",
+		"gasPrice": "5000000000",
+		"gasLimit": "200000",
+		"recipientAddress": "0x00EFd0D4639191C49908A7BddbB9A11A994A8527",
+		"value": "300000",
+		"data": "084ce708000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000020000000000000000000000006f0182a0cc707b055322ccf6d4cb6a5aff1aeb22000000000000000000000000c3bbe9b1cee1ff85ad72b87414b0e9b7f2366763000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000186a00000000000000000000000000000000000000000000000000000000000030d40",
+		"v": 27,
+		"r": "0c7cfc6e77249b44385decfd49b8d4deac3c4c49147a0a8d539d82d51da81581",
+		"s": "6af2959905394b401c87872f78ae321cf8cfdd03fe80a815a99bdd723cc90462",
+		"senderPublicKey": "0243333347c8cbf4e3cbc7a96964181d02a2b0c854faa2fef86b4b8d92afcf473d",
+		"senderAddress": "0x1E6747BEAa5B4076a6A98D735DF8c35a70D18Bdd",
+		"id": "d2b7d9e8730de8ab788a37905974c11f6df1a7e5bea5f9a716bffbec17b1d3a8"
+	},
+	"serialized": "02f90173822710018085012a05f20083030d409400efd0d4639191c49908a7bddbb9a11a994a8527830493e0b90104084ce708000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000020000000000000000000000006f0182a0cc707b055322ccf6d4cb6a5aff1aeb22000000000000000000000000c3bbe9b1cee1ff85ad72b87414b0e9b7f2366763000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000186a00000000000000000000000000000000000000000000000000000000000030d40c080a00c7cfc6e77249b44385decfd49b8d4deac3c4c49147a0a8d539d82d51da81581a06af2959905394b401c87872f78ae321cf8cfdd03fe80a815a99bdd723cc90462"
+}

package/tests/fixtures/transactions/transfer-0.json

@@ -0,0 +1,18 @@
+{
+	"data": {
+		"network": 10000,
+		"nonce": "1",
+		"gasPrice": "5000000000",
+		"gasLimit": "21000",
+		"recipientAddress": "0x6F0182a0cc707b055322CcF6d4CB6a5Aff1aEb22",
+		"value": "0",
+		"data": "",
+		"v": 27,
+		"r": "2c42ef45cb01b01c0a59b61a7e82d37c8566e0fc0f0f47c2a2825d1cbc8abefc",
+		"s": "455bb2aec9d8d038db506d5a964728c78eaa4f237e0d40666742e4d5d686f576",
+		"senderPublicKey": "0243333347c8cbf4e3cbc7a96964181d02a2b0c854faa2fef86b4b8d92afcf473d",
+		"senderAddress": "0x1E6747BEAa5B4076a6A98D735DF8c35a70D18Bdd",
+		"id": "241ce787680623dea7b9acf2951e2f8b8afac5f92b33b9909ab2bfbadf4be92c"
+	},
+	"serialized": "02f869822710018085012a05f200825208946f0182a0cc707b055322ccf6d4cb6a5aff1aeb228080c080a02c42ef45cb01b01c0a59b61a7e82d37c8566e0fc0f0f47c2a2825d1cbc8abefca0455bb2aec9d8d038db506d5a964728c78eaa4f237e0d40666742e4d5d686f576"
+}

package/tests/fixtures/transactions/transfer-large-amount.json

@@ -0,0 +1,18 @@
+{
+	"data": {
+		"network": 10000,
+		"nonce": "1",
+		"gasPrice": "5000000000",
+		"gasLimit": "21000",
+		"recipientAddress": "0x6F0182a0cc707b055322CcF6d4CB6a5Aff1aEb22",
+		"value": "10000000000000000000",
+		"data": "",
+		"v": 27,
+		"r": "62666b937e4c3f55c87c44ee72b5a228c1377adbdad44264dd953b3c2b878734",
+		"s": "2d8670a69ce09018cfac5604d59a2b74bee18c99a91cbd14ac33c3ccfe96a35a",
+		"senderPublicKey": "0243333347c8cbf4e3cbc7a96964181d02a2b0c854faa2fef86b4b8d92afcf473d",
+		"senderAddress": "0x1E6747BEAa5B4076a6A98D735DF8c35a70D18Bdd",
+		"id": "0d22ff14b09da9c5fa975d8fe79b93086853d223000cf88ff923a57650c93e4a"
+	},
+	"serialized": "02f871822710018085012a05f200825208946f0182a0cc707b055322ccf6d4cb6a5aff1aeb22888ac7230489e8000080c080a062666b937e4c3f55c87c44ee72b5a228c1377adbdad44264dd953b3c2b878734a02d8670a69ce09018cfac5604d59a2b74bee18c99a91cbd14ac33c3ccfe96a35a"
+}

package/tests/fixtures/transactions/transfer.json

@@ -0,0 +1,18 @@
+{
+	"data": {
+		"network": 10000,
+		"nonce": "1",
+		"gasPrice": "5000000000",
+		"gasLimit": "21000",
+		"recipientAddress": "0x6F0182a0cc707b055322CcF6d4CB6a5Aff1aEb22",
+		"value": "100000000",
+		"data": "",
+		"v": 28,
+		"r": "104665257d4dea61c4654e74c6c0f6cd0a398905781c3040bea67dc641a66da0",
+		"s": "46d718d04b2331f3b0561808549ed3f3f0d867a284acf6b334869078df7a9136",
+		"senderPublicKey": "0243333347c8cbf4e3cbc7a96964181d02a2b0c854faa2fef86b4b8d92afcf473d",
+		"senderAddress": "0x1E6747BEAa5B4076a6A98D735DF8c35a70D18Bdd",
+		"id": "b7927d90b38cd1296351f26145b3d8b0674fdc9b8721bc1a10f71a12bcbccf60"
+	},
+	"serialized": "02f86d822710018085012a05f200825208946f0182a0cc707b055322ccf6d4cb6a5aff1aeb228405f5e10080c001a0104665257d4dea61c4654e74c6c0f6cd0a398905781c3040bea67dc641a66da0a046d718d04b2331f3b0561808549ed3f3f0d867a284acf6b334869078df7a9136"
+}

package/tests/fixtures/transactions/unvote.json

@@ -0,0 +1,18 @@
+{
+	"data": {
+		"network": 10000,
+		"nonce": "1",
+		"gasPrice": "5000000000",
+		"gasLimit": "200000",
+		"recipientAddress": "0x535B3D7A252fa034Ed71F0C53ec0C6F784cB64E1",
+		"value": "0",
+		"data": "3174b689",
+		"v": 27,
+		"r": "bd7f932c18b49e05600cd1603808fd0a19701ee4af99035fc7b1a9159458d08d",
+		"s": "18a4420edfdc90fcff7c6e4d062ae11dae7a62a7ab53f6499862f3e79d67a252",
+		"senderPublicKey": "0243333347c8cbf4e3cbc7a96964181d02a2b0c854faa2fef86b4b8d92afcf473d",
+		"senderAddress": "0x1E6747BEAa5B4076a6A98D735DF8c35a70D18Bdd",
+		"id": "ed937a96f4edc0fa89e7d6146b88f17a3de71f86fc200da49c73e7c93eabfea9"
+	},
+	"serialized": "02f86e822710018085012a05f20083030d4094535b3d7a252fa034ed71f0c53ec0c6f784cb64e180843174b689c080a0bd7f932c18b49e05600cd1603808fd0a19701ee4af99035fc7b1a9159458d08da018a4420edfdc90fcff7c6e4d062ae11dae7a62a7ab53f6499862f3e79d67a252"
+}

package/tests/fixtures/transactions/username-registration.json

@@ -0,0 +1,18 @@
+{
+	"data": {
+		"network": 10000,
+		"nonce": "1",
+		"gasPrice": "5000000000",
+		"gasLimit": "200000",
+		"recipientAddress": "0x2c1DE3b4Dbb4aDebEbB5dcECAe825bE2a9fc6eb6",
+		"value": "0",
+		"data": "36a94134000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000076669787475726500000000000000000000000000000000000000000000000000",
+		"v": 28,
+		"r": "4564cc1adbde3e8a309bf9d3eb76b45fecfae62fbdc0604f70483197de4d66b3",
+		"s": "4d4573a50c9a80221c21d11ce51b9b8bd196f9e1ab1a805b7d8b8e56fcfe2003",
+		"senderPublicKey": "0243333347c8cbf4e3cbc7a96964181d02a2b0c854faa2fef86b4b8d92afcf473d",
+		"senderAddress": "0x1E6747BEAa5B4076a6A98D735DF8c35a70D18Bdd",
+		"id": "781979a58ac75475b91a1e401b50f9cc52465b21fe83e1c30e05676aaeb6a806"
+	},
+	"serialized": "02f8cf822710018085012a05f20083030d40942c1de3b4dbb4adebebb5dcecae825be2a9fc6eb680b86436a94134000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000076669787475726500000000000000000000000000000000000000000000000000c001a04564cc1adbde3e8a309bf9d3eb76b45fecfae62fbdc0604f70483197de4d66b3a04d4573a50c9a80221c21d11ce51b9b8bd196f9e1ab1a805b7d8b8e56fcfe2003"
+}

package/tests/fixtures/transactions/username-resignation.json

@@ -0,0 +1,18 @@
+{
+	"data": {
+		"network": 10000,
+		"nonce": "1",
+		"gasPrice": "5000000000",
+		"gasLimit": "200000",
+		"recipientAddress": "0x2c1DE3b4Dbb4aDebEbB5dcECAe825bE2a9fc6eb6",
+		"value": "0",
+		"data": "ebed6dab",
+		"v": 27,
+		"r": "c786beafa03da8c6485bc15870ea8512db27427e3aa38654a7b8d534b30c48da",
+		"s": "78b2b4568f4d0f5d482c670001e6877b282ed6e16cdcbea6bd29195ca2bb036d",
+		"senderPublicKey": "0243333347c8cbf4e3cbc7a96964181d02a2b0c854faa2fef86b4b8d92afcf473d",
+		"senderAddress": "0x1E6747BEAa5B4076a6A98D735DF8c35a70D18Bdd",
+		"id": "d1647fe630bcf63a23bda6015295dafe246356b0e7930cdc8a52f216fa4429a5"
+	},
+	"serialized": "02f86e822710018085012a05f20083030d40942c1de3b4dbb4adebebb5dcecae825be2a9fc6eb68084ebed6dabc080a0c786beafa03da8c6485bc15870ea8512db27427e3aa38654a7b8d534b30c48daa078b2b4568f4d0f5d482c670001e6877b282ed6e16cdcbea6bd29195ca2bb036d"
+}

package/tests/fixtures/transactions/validator-registration.json

@@ -0,0 +1,18 @@
+{
+	"data": {
+		"network": 10000,
+		"nonce": "1",
+		"gasPrice": "5000000000",
+		"gasLimit": "200000",
+		"recipientAddress": "0x535B3D7A252fa034Ed71F0C53ec0C6F784cB64E1",
+		"value": "0",
+		"data": "602a9eee0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000003030954f46d6097a1d314e900e66e11e0dad0a57cd03e04ec99f0dedd1c765dcb11e6d7fa02e22cf40f9ee23d9cc1c062400000000000000000000000000000000",
+		"v": 28,
+		"r": "57216346b5252f6db63a2c78b5bc0a3697d2247377e9d9ef1b67849a87eb2413",
+		"s": "66ea02477fc19671b3b626e3c4d33939a8ba43004f0a56e900efc1e580739d11",
+		"senderPublicKey": "0243333347c8cbf4e3cbc7a96964181d02a2b0c854faa2fef86b4b8d92afcf473d",
+		"senderAddress": "0x1E6747BEAa5B4076a6A98D735DF8c35a70D18Bdd",
+		"id": "5064b50091b8e5d50ec1d1eb7c5b71cdcf9c7355bba18ee0efeaeacb0b1c95d5"
+	},
+	"serialized": "02f8ef822710018085012a05f20083030d4094535b3d7a252fa034ed71f0c53ec0c6f784cb64e180b884602a9eee0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000003030954f46d6097a1d314e900e66e11e0dad0a57cd03e04ec99f0dedd1c765dcb11e6d7fa02e22cf40f9ee23d9cc1c062400000000000000000000000000000000c001a057216346b5252f6db63a2c78b5bc0a3697d2247377e9d9ef1b67849a87eb2413a066ea02477fc19671b3b626e3c4d33939a8ba43004f0a56e900efc1e580739d11"
+}

package/tests/fixtures/transactions/validator-resignation.json

@@ -0,0 +1,18 @@
+{
+	"data": {
+		"network": 10000,
+		"nonce": "1",
+		"gasPrice": "5000000000",
+		"gasLimit": "200000",
+		"recipientAddress": "0x535B3D7A252fa034Ed71F0C53ec0C6F784cB64E1",
+		"value": "0",
+		"data": "b85f5da2",
+		"v": 28,
+		"r": "5670e5d314906eeaf92da15b55eaeabbb92814874f2fe6c72bcbee7e13e7ff40",
+		"s": "32a34c8438e441d10e83180b5a8a84cf1bfb92fc0fe8b53cd23dc4105631b83d",
+		"senderPublicKey": "0243333347c8cbf4e3cbc7a96964181d02a2b0c854faa2fef86b4b8d92afcf473d",
+		"senderAddress": "0x1E6747BEAa5B4076a6A98D735DF8c35a70D18Bdd",
+		"id": "2dc3b976d8dee25e2ecf341c1493670d9d087cc338ed63f764c0eb9e28869dc3"
+	},
+	"serialized": "02f86e822710018085012a05f20083030d4094535b3d7a252fa034ed71f0c53ec0c6f784cb64e18084b85f5da2c001a05670e5d314906eeaf92da15b55eaeabbb92814874f2fe6c72bcbee7e13e7ff40a032a34c8438e441d10e83180b5a8a84cf1bfb92fc0fe8b53cd23dc4105631b83d"
+}

package/tests/fixtures/transactions/vote.json

@@ -0,0 +1,18 @@
+{
+	"data": {
+		"network": 10000,
+		"nonce": "1",
+		"gasPrice": "5000000000",
+		"gasLimit": "200000",
+		"recipientAddress": "0x535B3D7A252fa034Ed71F0C53ec0C6F784cB64E1",
+		"value": "0",
+		"data": "6dd7d8ea000000000000000000000000c3bbe9b1cee1ff85ad72b87414b0e9b7f2366763",
+		"v": 27,
+		"r": "67734fadb38bd9cd584d39fc08af836f15dd6337b05511b312add11a3586451a",
+		"s": "08ba89cec57c38b1e1f488d3507b9cbe1a21aa3f441482e62bd9c1eef61d3bd9",
+		"senderPublicKey": "0243333347c8cbf4e3cbc7a96964181d02a2b0c854faa2fef86b4b8d92afcf473d",
+		"senderAddress": "0x1E6747BEAa5B4076a6A98D735DF8c35a70D18Bdd",
+		"id": "351114ee096ad8a02ddb7abee6f4fe283b8dadceff17157722d7a8153de710c1"
+	},
+	"serialized": "02f88e822710018085012a05f20083030d4094535b3d7a252fa034ed71f0c53ec0c6f784cb64e180a46dd7d8ea000000000000000000000000c3bbe9b1cee1ff85ad72b87414b0e9b7f2366763c080a067734fadb38bd9cd584d39fc08af836f15dd6337b05511b312add11a3586451aa008ba89cec57c38b1e1f488d3507b9cbe1a21aa3f441482e62bd9c1eef61d3bd9"
+}

package/tests/unit/identities/Address.test.ts

@@ -0,0 +1,26 @@
+import fixture from "@tests/fixtures/identity.json";
+import { Address } from "@/identities/Address";
+
+it('should get the address from passphrase', () => {
+	const actual = Address.fromPassphrase(fixture.passphrase);
+
+	expect(actual).toEqual(fixture.data.address);
+});
+
+it('should get the address from public key', () => {
+	const actual = Address.fromPublicKey(fixture.data.publicKey);
+
+	expect(actual).toEqual(fixture.data.address);
+});
+
+it('should get the address from private key', () => {
+	const actual = Address.fromPrivateKey(fixture.data.privateKey);
+
+	expect(actual).toEqual(fixture.data.address);
+});
+
+it('should validate the address', () => {
+	const actual = Address.validate(fixture.data.address);
+
+	expect(actual).toBe(true);
+});