@arkecosystem/typescript-crypto 0.0.1

package/dist/utils/AbiBase.d.ts

@@ -0,0 +1,8 @@
+import { ContractAbiType } from "../enums/ContractAbiType";
+import { Interface } from "ethers";
+export declare abstract class AbiBase {
+    protected interface: Interface;
+    constructor(type?: ContractAbiType, customAbi?: string);
+    private contractAbi;
+}
+//# sourceMappingURL=AbiBase.d.ts.map

package/dist/utils/AbiBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbiBase.d.ts","sourceRoot":"","sources":["../../src/utils/AbiBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAKnC,8BAAsB,OAAO;IAC5B,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC;gBAEnB,IAAI,GAAE,eAA2C,EAAE,SAAS,CAAC,EAAE,MAAM;IAMjF,OAAO,CAAC,WAAW;CAgBnB"}

package/dist/utils/AbiBase.js

@@ -0,0 +1,25 @@
+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 class AbiBase {
+    constructor(type = ContractAbiType.CONSENSUS, customAbi) {
+        const abi = this.contractAbi(type, customAbi);
+        this.interface = new Interface(JSON.parse(JSON.stringify(abi)).abi);
+    }
+    contractAbi(type = ContractAbiType.CONSENSUS, customAbi) {
+        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/dist/utils/AbiDecoder.d.ts

@@ -0,0 +1,6 @@
+import { AbiResult } from "../types";
+import { AbiBase } from "./AbiBase";
+export declare class AbiDecoder extends AbiBase {
+    decodeFunctionData(data: string): AbiResult;
+}
+//# sourceMappingURL=AbiDecoder.d.ts.map

package/dist/utils/AbiDecoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbiDecoder.d.ts","sourceRoot":"","sources":["../../src/utils/AbiDecoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,qBAAa,UAAW,SAAQ,OAAO;IACtC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;CAa3C"}

package/dist/utils/AbiDecoder.js

@@ -0,0 +1,14 @@
+import { AbiBase } from "./AbiBase";
+export class AbiDecoder extends AbiBase {
+    decodeFunctionData(data) {
+        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/dist/utils/AbiEncoder.d.ts

@@ -0,0 +1,5 @@
+import { AbiBase } from "./AbiBase";
+export declare class AbiEncoder extends AbiBase {
+    encodeFunctionCall(functionName: string, parameters: any[]): string;
+}
+//# sourceMappingURL=AbiEncoder.d.ts.map

package/dist/utils/AbiEncoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbiEncoder.d.ts","sourceRoot":"","sources":["../../src/utils/AbiEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,qBAAa,UAAW,SAAQ,OAAO;IACtC,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,MAAM;CAGnE"}

package/dist/utils/AbiEncoder.js

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

package/dist/utils/Helpers.d.ts

@@ -0,0 +1,19 @@
+export declare 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
+     */
+    static isValidUsername(username: string): boolean;
+    /**
+     * Removes the leading '0x' from a hex string.
+     *
+     * @param hex The hex string to process
+     * @returns The hex string without the leading '0x'
+     */
+    static removeLeadingHexZero(hex: string): string;
+}
+//# sourceMappingURL=Helpers.d.ts.map

package/dist/utils/Helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Helpers.d.ts","sourceRoot":"","sources":["../../src/utils/Helpers.ts"],"names":[],"mappings":"AAEA,qBAAa,OAAO;IACnB;;;;;;;OAOG;WACW,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAyBxD;;;;;OAKG;WACW,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAGvD"}

package/dist/utils/Helpers.js

@@ -0,0 +1,38 @@
+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
+     */
+    static isValidUsername(username) {
+        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'
+     */
+    static removeLeadingHexZero(hex) {
+        return hex.replace(/^0x/, ""); // Using replace to only remove the prefix, not leading zeros
+    }
+}

package/dist/utils/Message.d.ts

@@ -0,0 +1,14 @@
+import { SignedMessage } from "../types";
+export declare class Message {
+    publicKey: string;
+    signature: string;
+    message: string;
+    constructor(message: SignedMessage);
+    static new(message: SignedMessage): Message;
+    static sign(message: string, passphrase: string): Message;
+    verify(): boolean;
+    toString(): string;
+    toArray(): string[];
+    toJson(): SignedMessage;
+}
+//# sourceMappingURL=Message.d.ts.map

package/dist/utils/Message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Message.d.ts","sourceRoot":"","sources":["../../src/utils/Message.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC,qBAAa,OAAO;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,aAAa;IAMlC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO;IAI3C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAazD,MAAM,IAAI,OAAO;IAQjB,QAAQ,IAAI,MAAM;IAIlB,OAAO,IAAI,MAAM,EAAE;IAInB,MAAM,IAAI,aAAa;CAOvB"}

package/dist/utils/Message.js

@@ -0,0 +1,43 @@
+import { PrivateKey } from "../identities/PrivateKey";
+import { PublicKey } from "../identities/PublicKey";
+import { keccak256 } from "ethers";
+import { verify } from "tiny-secp256k1";
+export class Message {
+    constructor(message) {
+        this.publicKey = message.publicKey;
+        this.signature = message.signature;
+        this.message = message.message;
+    }
+    static new(message) {
+        return new Message(message);
+    }
+    static sign(message, passphrase) {
+        const privateKey = PrivateKey.fromPassphrase(passphrase);
+        const publicKey = PublicKey.fromPassphrase(passphrase).publicKey;
+        const signature = privateKey.sign(Buffer.from(message).toString("hex"));
+        return Message.new({
+            publicKey,
+            signature: signature.r + signature.s + Number(signature.v).toString(16),
+            message,
+        });
+    }
+    verify() {
+        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");
+        return verify(message, publicKey, signature, true);
+    }
+    toString() {
+        return JSON.stringify(this.toJson());
+    }
+    toArray() {
+        return [this.publicKey, this.signature, this.message];
+    }
+    toJson() {
+        return {
+            publicKey: this.publicKey,
+            signature: this.signature,
+            message: this.message,
+        };
+    }
+}

package/dist/utils/Slot.d.ts

@@ -0,0 +1,5 @@
+export declare class Slot {
+    static time(): number;
+    static epoch(): number;
+}
+//# sourceMappingURL=Slot.d.ts.map

package/dist/utils/Slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Slot.d.ts","sourceRoot":"","sources":["../../src/utils/Slot.ts"],"names":[],"mappings":"AAEA,qBAAa,IAAI;IAChB,MAAM,CAAC,IAAI,IAAI,MAAM;IAIrB,MAAM,CAAC,KAAK,IAAI,MAAM;CAGtB"}

package/dist/utils/Slot.js

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

package/dist/utils/TransactionUtils.d.ts

@@ -0,0 +1,7 @@
+import { TransactionData } from "../types";
+export declare class TransactionUtils {
+    static toBuffer(transaction: TransactionData, skipSignature?: boolean): Buffer;
+    static toHash(transaction: TransactionData, skipSignature?: boolean): string;
+    static getId(transaction: TransactionData): string;
+}
+//# sourceMappingURL=TransactionUtils.d.ts.map

package/dist/utils/TransactionUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionUtils.d.ts","sourceRoot":"","sources":["../../src/utils/TransactionUtils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,qBAAa,gBAAgB;WACd,QAAQ,CAAC,WAAW,EAAE,eAAe,EAAE,aAAa,GAAE,OAAe,GAAG,MAAM;WA4B9E,MAAM,CAAC,WAAW,EAAE,eAAe,EAAE,aAAa,GAAE,OAAe,GAAG,MAAM;WAM5E,KAAK,CAAC,WAAW,EAAE,eAAe,GAAG,MAAM;CAGzD"}

package/dist/utils/TransactionUtils.js

@@ -0,0 +1,35 @@
+import { encodeRlp, keccak256, toBeArray } from "ethers";
+import { Constants } from "../enums/Constants";
+export class TransactionUtils {
+    static toBuffer(transaction, skipSignature = false) {
+        var _a, _b, _c, _d, _e;
+        const fields = [
+            toBeArray((_a = transaction['network']) !== null && _a !== void 0 ? _a : 0),
+            toBeArray(transaction['nonce'] ? transaction['nonce'] : 0),
+            toBeArray(0),
+            toBeArray((_b = transaction['gasPrice']) !== null && _b !== void 0 ? _b : 0),
+            toBeArray((_c = transaction['gasLimit']) !== null && _c !== void 0 ? _c : 0),
+            (_d = transaction['recipientAddress']) !== null && _d !== void 0 ? _d : '0x',
+            toBeArray(transaction['value'] ? transaction['value'] : 0),
+            transaction['data'] && transaction['data'].startsWith('0x')
+                ? transaction['data']
+                : ('0x' + ((_e = transaction['data']) !== null && _e !== void 0 ? _e : '')),
+            [],
+        ];
+        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);
+    }
+    static toHash(transaction, skipSignature = false) {
+        const encoding = this.toBuffer(transaction, skipSignature);
+        return keccak256('0x' + encoding.toString('binary')).substring(2);
+    }
+    static getId(transaction) {
+        return this.toHash(transaction, false);
+    }
+}

package/dist/utils/UnitConverter.d.ts

@@ -0,0 +1,8 @@
+import BigNumber from "bignumber.js";
+export declare class UnitConverter {
+    static parseUnits(value: number | string, unit?: string): BigNumber;
+    static formatUnits(value: string, unit?: string): number;
+    static weiToArk(value: number | string, suffix?: string): string;
+    static gweiToArk(value: number | string, suffix?: string): string;
+}
+//# sourceMappingURL=UnitConverter.d.ts.map

package/dist/utils/UnitConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnitConverter.d.ts","sourceRoot":"","sources":["../../src/utils/UnitConverter.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,cAAc,CAAC;AAMrC,qBAAa,aAAa;IACzB,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAC,MAAM,EAAE,IAAI,GAAE,MAAc,GAAG,SAAS;IAaxE,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAc,GAAG,MAAM;IAa/D,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;IAY9D,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM;CAW/D"}

package/dist/utils/UnitConverter.js

@@ -0,0 +1,48 @@
+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, unit = 'ark') {
+        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, unit = 'ark') {
+        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, suffix) {
+        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, suffix) {
+        const convertedValue = new BigNumber(this.formatUnits(this.parseUnits(value, 'gwei').toString(), 'ark'))
+            .decimalPlaces(18)
+            .toFixed();
+        if (suffix) {
+            return convertedValue + ' ' + suffix;
+        }
+        return convertedValue;
+    }
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./AbiBase";
+export * from "./AbiDecoder";
+export * from "./AbiEncoder";
+export * from "./Helpers";
+export * from "./Message";
+export * from "./Slot";
+export * from "./TransactionUtils";
+export * from "./UnitConverter";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/utils/index.js

@@ -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/jest.config.ts

@@ -0,0 +1,14 @@
+import { createDefaultEsmPreset, type JestConfigWithTsJest } from 'ts-jest'
+
+const presetConfig = createDefaultEsmPreset()
+
+const jestConfig: JestConfigWithTsJest = {
+	...presetConfig,
+
+	moduleNameMapper: {
+		'^@/(.*)$': '<rootDir>/src/$1',
+		'^@tests/(.*)$': '<rootDir>/tests/$1',
+	},
+}
+
+export default jestConfig

package/package.json

@@ -0,0 +1,59 @@
+{
+	"name": "@arkecosystem/typescript-crypto",
+	"version": "0.0.1",
+	"engines": {
+		"node": ">=20.12.2"
+	},
+	"description": "A simple TypeScript Cryptography Implementation for the Mainsail blockchain.",
+	"type": "module",
+	"main": "dist/index.js",
+	"module": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"require": "./dist/index.js"
+		}
+	},
+	"scripts": {
+		"build": "tsc && esbuild src/index.ts --outdir=dist --format=esm --bundle",
+		"test": "NODE_OPTIONS=--experimental-vm-modules jest"
+	},
+	"bugs": {
+		"url": "https://github.com/ArdentHQ/typescript-crypto/issues"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/ArdentHQ/typescript-crypto.git"
+	},
+	"keywords": [],
+	"author": "",
+	"license": "CC BY-NC-ND 4.0",
+	"devDependencies": {
+		"@jest/globals": "^29.7.0",
+		"@types/jest": "^29.5.14",
+		"@typescript-eslint/eslint-plugin": "^8.25.0",
+		"@typescript-eslint/parser": "^8.25.0",
+		"esbuild": "^0.25.0",
+		"esbuild-jest": "^0.5.0",
+		"eslint": "^9.21.0",
+		"eslint-config-prettier": "^10.0.2",
+		"eslint-plugin-prettier": "^5.2.3",
+		"jest": "^29.7.0",
+		"prettier": "^3.5.3",
+		"ts-jest": "^29.2.6",
+		"ts-node": "^10.9.2",
+		"typescript": "^5.8.2"
+	},
+	"dependencies": {
+		"@noble/secp256k1": "^2.2.3",
+		"bignumber.js": "^9.1.2",
+		"ethers": "^6.13.5",
+		"wif": "^5.0.0"
+	},
+	"pnpm": {
+		"onlyBuiltDependencies": [
+			"esbuild"
+		]
+	}
+}

package/prettier.config.js

@@ -0,0 +1,8 @@
+module.exports = {
+	semi: true,
+	trailingComma: "all",
+	singleQuote: false,
+	printWidth: 120,
+	useTabs: true,
+	tabWidth: 4,
+};

package/src/configuration/Network.ts

@@ -0,0 +1,18 @@
+import { AbstractNetwork } from "@/networks/AbstractNetwork";
+import { Testnet } from "@/networks/Testnet";
+
+export class Network {
+	private static network: AbstractNetwork;
+
+	public static get(): AbstractNetwork {
+		if (!this.network) {
+			this.network = new Testnet();
+		}
+
+		return this.network;
+	}
+
+	public static set(network: AbstractNetwork): void {
+		this.network = network;
+	}
+}

package/src/configuration/index.ts

@@ -0,0 +1 @@
+export * from "./Network";

package/src/enums/AbiFunction.ts

@@ -0,0 +1,9 @@
+export enum AbiFunction {
+	VOTE = "vote",
+	UNVOTE = "unvote",
+	VALIDATOR_REGISTRATION = "registerValidator",
+	VALIDATOR_RESIGNATION = "resignValidator",
+	USERNAME_REGISTRATION = "registerUsername",
+	USERNAME_RESIGNATION = "resignUsername",
+	MULTIPAYMENT = "pay",
+}

package/src/enums/Constants.ts

@@ -0,0 +1,4 @@
+export enum Constants {
+	EIP_1559_PREFIX = '02',
+	ETHEREUM_RECOVERY_ID_OFFSET = 27,
+}

package/src/enums/ContractAbiType.ts

@@ -0,0 +1,6 @@
+export enum ContractAbiType {
+    CUSTOM       = 'custom',
+    CONSENSUS    = 'consensus',
+    MULTIPAYMENT = 'multipayment',
+    USERNAMES    = 'usernames',
+}

package/src/enums/ContractAddresses.ts

@@ -0,0 +1,5 @@
+export enum ContractAddresses {
+	CONSENSUS = "0x535B3D7A252fa034Ed71F0C53ec0C6F784cB64E1",
+	MULTIPAYMENT = "0x00EFd0D4639191C49908A7BddbB9A11A994A8527",
+	USERNAMES = "0x2c1DE3b4Dbb4aDebEbB5dcECAe825bE2a9fc6eb6",
+}

package/src/enums/index.ts

@@ -0,0 +1,4 @@
+export * from "./AbiFunction";
+export * from "./Constants";
+export * from "./ContractAbiType";
+export * from "./ContractAddresses";

package/src/exceptions/InvalidUsernameException.ts

@@ -0,0 +1,6 @@
+export class InvalidUsernameException extends Error {
+	constructor(message: string) {
+		super(message);
+		this.name = "InvalidUsernameException";
+	}
+}

package/src/exceptions/index.ts

@@ -0,0 +1 @@
+export * from "./InvalidUsernameException"

package/src/identities/Address.ts

@@ -0,0 +1,19 @@
+import { ethers, sha256 } from "ethers";
+
+export class Address {
+	static fromPassphrase(passphrase: string): string {
+		return this.fromPrivateKey(sha256(Buffer.from(passphrase)));
+	}
+
+	static fromPublicKey(publicKey: string): string {
+		return ethers.computeAddress(`0x${publicKey}`);
+	}
+
+	static fromPrivateKey(privateKey: string): string {
+		return new ethers.Wallet(privateKey).address;
+	}
+
+	static validate(address: string): boolean {
+		return ethers.isAddress(address);
+	}
+}

package/src/identities/PrivateKey.ts

@@ -0,0 +1,49 @@
+import * as WIF from "wif";
+
+import { ethers, keccak256, sha256 } from "ethers";
+import { signAsync } from "@noble/secp256k1";
+
+import { Constants } from "@/enums/Constants";
+import { Network } from "@/configuration/Network";
+
+type RecoverableSignature = {
+	r: string;
+	s: string;
+	v: number;
+};
+
+export class PrivateKey {
+	public privateKey: string;
+
+	constructor(keyPair: ethers.Wallet) {
+		this.privateKey = keyPair.privateKey.substring(2);
+	}
+
+	static fromPassphrase(passphrase: string): PrivateKey {
+		return PrivateKey.fromHex(sha256(Buffer.from(passphrase)));
+	}
+
+	static fromHex(hex: string): PrivateKey {
+		const wallet = new ethers.Wallet(hex);
+
+		return new PrivateKey(wallet);
+	}
+
+	static fromWif(wif: string): PrivateKey {
+		const decodedWif = WIF.decode(wif, Buffer.from(Network.get().getWif(), "hex").readUInt8());
+
+		return PrivateKey.fromHex(Buffer.from(decodedWif.privateKey).toString("hex"));
+	}
+
+	async sign(message: string): Promise<RecoverableSignature> {
+		const hash = keccak256("0x" + message).slice(2);
+
+		const signature = await signAsync(hash, this.privateKey);
+
+		return {
+			r: signature.r.toString(16).padStart(64, "0"),
+			s: signature.s.toString(16).padStart(64, "0"),
+			v: signature.recovery + Constants.ETHEREUM_RECOVERY_ID_OFFSET,
+		};
+	}
+}

package/src/identities/PublicKey.ts

@@ -0,0 +1,28 @@
+import { sha256, SigningKey } from "ethers";
+import { Signature } from "@noble/secp256k1";
+
+export class PublicKey {
+	public publicKey: string;
+
+	constructor(publicKey: string) {
+		this.publicKey = publicKey;
+	}
+
+	static fromPassphrase(passphrase: string): PublicKey {
+		const publicKey = SigningKey.computePublicKey(sha256(Buffer.from(passphrase)), true).substring(2);
+
+		return new PublicKey(publicKey);
+	}
+
+	static fromHex(publicKey: string): PublicKey {
+		const computedPublicKey = SigningKey.computePublicKey(`0x${publicKey}`).substring(2);
+
+		return new PublicKey(computedPublicKey);
+	}
+
+	static recover(message: Buffer, r: bigint, s: bigint, v: number): PublicKey {
+		const publicKey = new Signature(r, s, v).recoverPublicKey(message);
+
+		return new PublicKey(publicKey.toHex());
+	}
+}

package/src/identities/WIF.ts

@@ -0,0 +1,16 @@
+import { sha256 } from "ethers";
+import { Network } from "@/configuration/Network";
+import * as WIFPackage from "wif";
+import { PrivateKey } from "./PrivateKey";
+
+export class WIF {
+	static fromPassphrase(passphrase: string): string {
+		const privateKey = PrivateKey.fromPassphrase(passphrase);
+
+		return WIFPackage.encode({
+			version: Buffer.from(Network.get().getWif(), 'hex').readUInt8(),
+			privateKey: Buffer.from(privateKey.privateKey, 'hex'),
+			compressed: true,
+		});
+	}
+}

package/src/identities/index.ts

@@ -0,0 +1,4 @@
+export * from "./Address";
+export * from "./PrivateKey";
+export * from "./PublicKey";
+export * from "./WIF";