trac-msb 0.2.7 → 0.2.9

package/src/core/network/messaging/validators/AdminResponse.js

@@ -1,58 +0,0 @@
-import b4a from 'b4a';
-import PeerWallet from 'trac-wallet';
-import BaseResponse from './base/BaseResponse.js';
-
-class AdminResponse extends BaseResponse {
-
-    constructor(state, wallet) {
-        super(state, wallet);
-    }
-
-    async validate(message, channelString) {
-        if (
-            !this.validatePayload(message) ||
-            !this.validateIssuerPublicKey(message) ||
-            !this.validateTimestamp(message) ||
-            !await this.validateAdminData(message) ||
-            !await this.validateSignature(message) ||
-            !this.validateChannel(message, channelString)
-        ) {
-            throw new Error("Admin response validation failed");
-        }
-
-        return true;
-    }
-
-    validatePayload(message) {
-        if (!message ||
-            !message.op ||
-            !message.wk ||
-            !message.address ||
-            !message.nonce ||
-            !message.channel ||
-            !message.issuer ||
-            !message.timestamp) {
-            throw new Error("Admin response is missing required fields.");
-        }
-        return true;
-    }
-
-    async validateAdminData(message) {
-        const adminEntry = await this.state.getAdminEntry();
-        if (!adminEntry) {
-            throw new Error("Admin entry is null"); 
-        }
-
-        const adminPublicKey = PeerWallet.decodeBech32m(adminEntry.address);
-        const receivedAdminPublicKey = PeerWallet.decodeBech32m(message.address);
-        const adminWritingKey = b4a.from(message.wk, 'hex');
-
-        if (!b4a.equals(adminPublicKey, receivedAdminPublicKey) || !b4a.equals(adminEntry.wk, adminWritingKey)) {
-            throw new Error("Admin public key or writing key mismatch in response.");
-        }
-
-        return true;
-    }
-}
-
-export default AdminResponse;

package/src/core/network/messaging/validators/CustomNodeResponse.js

@@ -1,46 +0,0 @@
-import BaseResponse from './base/BaseResponse.js';
-
-class CustomNodeResponse extends BaseResponse {
-
-    constructor(state, wallet) {
-        super(state, wallet);
-    }
-
-    async validate(message, channelString) {
-        if (
-            !this.validatePayload(message) ||
-            !this.validateIssuerPublicKey(message) ||
-            !this.validateTimestamp(message) ||
-            !await this.validateCustomNodeEntry(message) ||
-            !await this.validateSignature(message) ||
-            !this.validateChannel(message, channelString)
-        ) {
-            throw new Error("Custom node response validation failed");
-        }
-
-        return true;
-    }
-
-    validatePayload(message) {
-        if (!message ||
-            !message.op ||
-            !message.address ||
-            !message.nonce ||
-            !message.channel ||
-            !message.issuer ||
-            !message.timestamp) {
-            throw new Error("Custom node response is missing required fields.");
-        }
-        return true;
-    }
-
-    async validateCustomNodeEntry(message) {
-        const customNodeAddressString = message.address;
-        const customNodeEntry = await this.state.getNodeEntry(customNodeAddressString);
-        if (customNodeEntry === null) {
-            throw new Error("Custom node entry is null - entry is not initialized.");
-        }
-        return true;
-    }
-}
-export default CustomNodeResponse;

package/src/core/state/utils/indexerEntry.js

@@ -1,105 +0,0 @@
-import b4a from 'b4a';
-import { TRAC_ADDRESS_SIZE } from '../../../utils/constants.js';
-import { isBufferValid } from '../../../utils/buffer.js';
-
-/**
- * Appends an indexer address to the indexers entry buffer.
- * The buffer format is: [count(1)][indexerAddr1][indexerAddr2]...[indexerAddrN]
- * Where count is the number of indexers.
- * If indexersEntry is null or invalid, a new buffer is created.
- * If indexerAddr is invalid, the original entry is returned unchanged.
- *
- * @param {Buffer} indexerAddr - The indexer address to append (must be TRAC_ADDRESS_SIZE bytes).
- * @param {Buffer|null} indexersEntry - The current indexers entry buffer, or null to create a new one.
- * @returns {Buffer} The updated indexers entry buffer or an empty buffer in case something goes wrong.
- */
-export function append(indexerAddr, indexersEntry = null) {
-    if (!isBufferValid(indexerAddr, TRAC_ADDRESS_SIZE)) {
-        return b4a.alloc(0);
-    }
-    // Append the indexer address to the IndexersEntry buffer
-    try {
-        let newIndexersEntry;
-        if (!b4a.isBuffer(indexersEntry) || indexersEntry.length < TRAC_ADDRESS_SIZE + 1) {
-            newIndexersEntry = b4a.concat([b4a.from([1]), indexerAddr]);
-        }
-        else {
-            newIndexersEntry = b4a.concat([indexersEntry, indexerAddr]);
-            newIndexersEntry[0]++;
-        }
-        return newIndexersEntry;
-    }
-    catch (error) {
-        console.error("Error appending indexer:", error);
-        return b4a.alloc(0); // If some error occurs, do nothing
-    }
-}
-
-/**
- * Finds the index of a given indexer address within the indexers entry buffer.
- * The buffer format is: [count(1)][indexerAddr1][indexerAddr2]...[indexerAddrN]
- * Returns the zero-based index of the address if found, or -1 if not found.
- *
- * @param {Buffer} indexersEntry - The current indexers entry buffer.
- * @param {Buffer} indexerAddr - The indexer address to search for (must be TRAC_ADDRESS_SIZE bytes).
- * @returns {number} The index of the address if found, or -1 if not found.
- */
-export function getIndex(indexersEntry, indexerAddr) {
-    if (
-        !b4a.isBuffer(indexersEntry) ||
-        !isBufferValid(indexerAddr, TRAC_ADDRESS_SIZE) ||
-        indexersEntry.length < TRAC_ADDRESS_SIZE + 1 // it should ensure minimal length of the indexersEntry
-    ) {
-        return -1;
-    }
-    // step through the indexersEntry until we find indexerAddr
-    for (let i = 0; i < indexersEntry[0]; i++) {
-        if (b4a.equals(indexersEntry.subarray(1 + i * TRAC_ADDRESS_SIZE, 1 + (i + 1) * TRAC_ADDRESS_SIZE), indexerAddr)) {
-            return i;
-        }
-    }
-    return -1; // Not found
-}
-
-/**
- * Removes an indexer address from the indexers entry buffer.
- * The buffer format is: [count(1)][indexerAddr1][indexerAddr2]...[indexerAddrN]
- * If the indexer address is not found or input is invalid, returns an empty buffer.
- *
- * @param {Buffer} indexerAddr - The indexer address to remove (must be TRAC_ADDRESS_SIZE bytes).
- * @param {Buffer} indexersEntry - The current indexers entry buffer.
- * @returns {Buffer} The updated indexers entry buffer with the address removed,
- *                   or an empty buffer if the address is not found or input is invalid.
- */
-export function remove(indexerAddr, indexersEntry) {
-    if (!b4a.isBuffer(indexersEntry) ||
-        indexersEntry.length < TRAC_ADDRESS_SIZE + 1 ||
-        !isBufferValid(indexerAddr, TRAC_ADDRESS_SIZE)) {
-        return b4a.alloc(0); // If the indexer address is invalid, do nothing
-    }
-
-    try {
-        const index = getIndex(indexersEntry, indexerAddr);
-        if (index === -1) {
-            return b4a.alloc(0); // If the indexer is not found, do nothing
-        }
-        // Remove the indexer address from the entry
-        const newIndexersEntry = b4a.concat([
-            indexersEntry.subarray(0, 1 + index * TRAC_ADDRESS_SIZE),
-            indexersEntry.subarray(1 + (index + 1) * TRAC_ADDRESS_SIZE)
-        ]);
-
-        newIndexersEntry[0]--; // Decrease the count of indexers
-        return newIndexersEntry;
-    }
-    catch (error) {
-        console.error("Error removing indexer:", error);
-        return b4a.alloc(0); // If some error occurs, do nothing
-    }
-}
-
-export default {
-    append,
-    getIndex,
-    remove
-};

package/src/messages/base/StateBuilder.js

@@ -1,25 +0,0 @@
-class StateBuilder {
-
-    constructor() {
-        if (this.constructor === StateBuilder) {
-            throw new Error("Builder is an abstract class and cannot be instantiated directly.");
-        }
-    }
-    reset() { throw new Error("Method 'reset()' must be implemented.");}
-    forOperationType(operationType) {throw new Error("Method 'forOperationType()' must be implemented.");}
-    withAddress(address) { throw new Error("Method 'withAddress()' must be implemented.");}
-    withWriterKey(writerKey) { throw new Error("Method 'withWriterKey()' must be implemented.");}
-    async buildValueAndSign() { throw new Error("Method 'buildValueAndSign()' must be implemented.");}
-    withIncomingAddress(address) { throw new Error("Method 'withIncomingAddress()' must be implemented.");}
-    withIncomingWriterKey(writerKey) { throw new Error("Method 'withIncomingWriterKey()' must be implemented.");}
-    withIncomingNonce(nonce) { throw new Error("Method 'withIncomingNonce()' must be implemented.");}
-    withContentHash(contentHash) { throw new Error("Method 'withContentHash()' must be implemented.");}
-    withIncomingSignature(signature) { throw new Error("Method 'withIncomingSignature()' must be implemented.");}
-    withExternalBootstrap(bootstrapKey) { throw new Error("Method 'withExternalBootstrap()' must be implemented.");}
-    withMsbBootstrap(msbBootstrap) { throw new Error("Method 'withMsbBootstrap()' must be implemented.");}
-    withTxHash(txHash) { throw new Error("Method 'withTxHash()' must be implemented.");}
-    withTxValidity(txValidity) { throw new Error("Method 'withTxValidity()' must be implemented.");}
-    withAmount(amount) { throw new Error("Method 'withAmount()' must be implemented.");}
-}
-
-export default StateBuilder;

package/src/messages/completeStateMessages/CompleteStateMessageBuilder.js

@@ -1,421 +0,0 @@
-import b4a from 'b4a';
-import PeerWallet from 'trac-wallet';
-
-import StateBuilder from '../base/StateBuilder.js'
-import { createMessage } from '../../utils/buffer.js';
-import { OperationType } from '../../utils/protobuf/applyOperations.cjs'
-import { addressToBuffer, bufferToAddress } from '../../core/state/utils/address.js';
-import { TRAC_ADDRESS_SIZE, NETWORK_ID } from '../../utils/constants.js';
-import { isAddressValid } from "../../core/state/utils/address.js";
-import { blake3Hash } from '../../utils/crypto.js';
-import {
-    isCoreAdmin,
-    isAdminControl,
-    isRoleAccess,
-    isTransaction,
-    isBootstrapDeployment,
-    isTransfer,
-    isBalanceInitialization
-} from '../../utils/operations.js';
-
-class CompleteStateMessageBuilder extends StateBuilder {
-    #wallet;
-    #operationType;
-    #address;
-    #writingKey;
-    #payload;
-    #txHash;
-    #incomingAddress;
-    #incomingWriterKey;
-    #incomingNonce;
-    #contentHash;
-    #incomingSignature;
-    #externalBootstrap;
-    #channel;
-    #msbBootstrap;
-    #validatorNonce;
-    #txValidity;
-    #amount;
-
-    constructor(wallet) {
-        super();
-        if (!wallet || typeof wallet !== 'object') {
-            throw new Error('Wallet must be a valid wallet object');
-        }
-        if (!isAddressValid(wallet.address)) {
-            throw new Error('Wallet should have a valid TRAC address.');
-        }
-
-
-        this.#wallet = wallet;
-        this.reset();
-    }
-
-    reset() {
-        this.#operationType = OperationType.UNKNOWN;
-        this.#address = null;
-        this.#writingKey = null;
-        this.#payload = {};
-        this.#txHash = null;
-        this.#incomingAddress = null;
-        this.#incomingWriterKey = null;
-        this.#incomingNonce = null;
-        this.#contentHash = null;
-        this.#incomingSignature = null;
-        this.#externalBootstrap = null;
-        this.#channel = null;
-        this.#msbBootstrap = null;
-        this.#validatorNonce = null;
-        this.#txValidity = null;
-        this.#amount = null;
-    }
-
-    forOperationType(operationType) {
-        if (!Object.values(OperationType).includes(operationType) || OperationType === OperationType.UNKNOWN) {
-            throw new Error(`Invalid operation type: ${operationType}`);
-        }
-        this.#operationType = operationType;
-        this.#payload.type = operationType;
-        return this;
-    }
-
-    withAddress(address) {
-        if (b4a.isBuffer(address) && address.length === TRAC_ADDRESS_SIZE) {
-            address = bufferToAddress(address);
-        }
-
-        if (!isAddressValid(address)) {
-            throw new Error(`Address field must be a valid TRAC bech32m address with length ${TRAC_ADDRESS_SIZE}.`);
-        }
-
-        this.#address = addressToBuffer(address);
-        this.#payload.address = this.#address;
-        return this;
-    }
-
-    withWriterKey(writingKey) {
-        if (!b4a.isBuffer(writingKey) || writingKey.length !== 32) {
-            throw new Error('Writer key must be a 32 length buffer.');
-        }
-        this.#writingKey = writingKey;
-        return this;
-    }
-
-    withTxHash(txHash) {
-        if (!b4a.isBuffer(txHash) || txHash.length !== 32) {
-            throw new Error('Transaction hash must be a 32-byte buffer.');
-        }
-        this.#txHash = txHash;
-        return this;
-    }
-
-    withIncomingAddress(address) {
-        if (b4a.isBuffer(address) && address.length === TRAC_ADDRESS_SIZE) {
-            address = bufferToAddress(address);
-        }
-
-        if (!isAddressValid(address)) {
-            throw new Error(`Address field must be a valid TRAC bech32m address with length ${TRAC_ADDRESS_SIZE}.`);
-        }
-
-        this.#incomingAddress = addressToBuffer(address);
-        return this;
-    }
-
-    withIncomingWriterKey(writerKey) {
-        if (!b4a.isBuffer(writerKey) || writerKey.length !== 32) {
-            throw new Error('Incoming writer key must be a 32-byte buffer.');
-        }
-        this.#incomingWriterKey = writerKey;
-        return this;
-    }
-
-    withIncomingNonce(nonce) {
-        if (!b4a.isBuffer(nonce) || nonce.length !== 32) {
-            throw new Error('Incoming nonce must be a 32-byte buffer.');
-        }
-        this.#incomingNonce = nonce;
-        return this;
-    }
-
-    withContentHash(contentHash) {
-        if (!b4a.isBuffer(contentHash) || contentHash.length !== 32) {
-            throw new Error('Content hash must be a 32-byte buffer.');
-        }
-        this.#contentHash = contentHash;
-        return this;
-    }
-
-    withIncomingSignature(signature) {
-        if (!b4a.isBuffer(signature) || signature.length !== 64) {
-            throw new Error('Incoming signature must be a 64-byte buffer.');
-        }
-        this.#incomingSignature = signature;
-        return this;
-    }
-
-    withExternalBootstrap(bootstrapKey) {
-        if (!b4a.isBuffer(bootstrapKey) || bootstrapKey.length !== 32) {
-            throw new Error('Bootstrap key must be a 32-byte buffer.');
-        }
-        this.#externalBootstrap = bootstrapKey;
-        return this;
-    }
-
-    withMsbBootstrap(msbBootstrap) {
-        if (!b4a.isBuffer(msbBootstrap) || msbBootstrap.length !== 32) {
-            throw new Error('MSB bootstrap must be a 32-byte buffer.');
-        }
-        this.#msbBootstrap = msbBootstrap;
-        return this;
-    }
-
-    withChannel(channel) {
-        if (!b4a.isBuffer(channel) || channel.length !== 32) {
-            throw new Error('Channel must be a 32-byte buffer.');
-        }
-        this.#channel = channel;
-        return this;
-    }
-
-    withTxValidity(txValidity) {
-        if (!b4a.isBuffer(txValidity) || txValidity.length !== 32) {
-            throw new Error('Transaction validity must be a 32-byte buffer.');
-        }
-        this.#txValidity = txValidity;
-        return this;
-    }
-
-    withAmount(amount) {
-        if (!b4a.isBuffer(amount) || amount.length !== 16) {
-            throw new Error('Amount must be a 16-byte buffer.');
-        }
-
-        this.#amount = amount;
-        return this;
-    }
-
-    async buildValueAndSign() {
-        if (!this.#operationType || !this.#address) {
-            throw new Error('Operation type, address must be set before building the message.');
-        }
-
-        if (this.#operationType === OperationType.UNKNOWN) {
-            throw new Error('UNKNOWN is not allowed to construct');
-        }
-
-        const nonce = PeerWallet.generateNonce();
-
-        let msg = null;
-        let tx = null;
-        let signature = null;
-
-        // all incoming data from setters should be as buffer data type, createMessage accept only buffer and uint32
-        switch (this.#operationType) {
-            // Complete by default
-            case OperationType.ADD_ADMIN:
-            case OperationType.DISABLE_INITIALIZATION:
-                msg = createMessage(
-                    NETWORK_ID,
-                    this.#txValidity,
-                    this.#writingKey,
-                    nonce,
-                    this.#operationType);
-                break;
-            // Complete by default
-            case OperationType.BALANCE_INITIALIZATION:
-                if (!this.#incomingAddress || !this.#amount || !this.#txValidity || !this.#address) {
-                    throw new Error('All balance initialization fields must be set before building the message!');
-                }
-                msg = createMessage(
-                    NETWORK_ID,
-                    this.#txValidity,
-                    this.#incomingAddress,
-                    this.#amount,
-                    nonce,
-                    this.#operationType
-                );
-                break;
-            // Partial need to be signed
-            case OperationType.ADD_WRITER:
-            case OperationType.REMOVE_WRITER:
-            case OperationType.ADMIN_RECOVERY:
-                msg = createMessage(
-                    NETWORK_ID,
-                    this.#txHash,
-                    nonce,
-                    this.#operationType
-                );
-                break;
-            // Complete by default
-            case OperationType.APPEND_WHITELIST:
-            case OperationType.ADD_INDEXER:
-            case OperationType.REMOVE_INDEXER:
-            case OperationType.BAN_VALIDATOR:
-                if (this.#wallet.address === bufferToAddress(this.#incomingAddress)) {
-                    throw new Error('Address must not be the same as the wallet address for basic operations.');
-                }
-
-                msg = createMessage(
-                    NETWORK_ID,
-                    this.#txValidity,
-                    this.#incomingAddress,
-                    nonce,
-                    this.#operationType
-                );
-
-                break;
-            // Partial need to be signed
-            case OperationType.BOOTSTRAP_DEPLOYMENT:
-                if (!this.#txHash || !this.#externalBootstrap || !this.#channel || !this.#incomingNonce || !this.#incomingSignature) {
-                    throw new Error('All bootstrap deployment fields must be set before building the message!');
-                }
-                msg = createMessage(
-                    NETWORK_ID,
-                    this.#txHash,
-                    nonce,
-                    this.#operationType
-                );
-                break;
-
-            // Partial need to be signed
-            case OperationType.TX:
-                if (!this.#txHash || !this.#txValidity || !this.#address || !this.#incomingWriterKey ||
-                    !this.#incomingNonce || !this.#contentHash || !this.#incomingSignature ||
-                    !this.#externalBootstrap || !this.#msbBootstrap) {
-                    throw new Error('All postTx fields must be set before building the message!');
-                }
-                msg = createMessage(
-                    NETWORK_ID,
-                    this.#txHash,
-                    nonce,
-                    this.#operationType
-                );
-                break;
-
-            case OperationType.TRANSFER:
-                if (!this.#txHash || !this.#txValidity || !this.#address || !this.#incomingNonce ||
-                    !this.#incomingSignature || !this.#amount || !this.#incomingAddress) {
-                    throw new Error('All transfer fields must be set before building the message!');
-                }
-                msg = createMessage(
-                    NETWORK_ID,
-                    this.#txHash,
-                    nonce,
-                    this.#operationType
-                );
-                break;
-
-            default:
-                throw new Error(`Unsupported operation type for building value: ${OperationType[this.#operationType]}.`);
-        }
-
-        tx = await blake3Hash(msg);
-        signature = this.#wallet.sign(tx);
-
-        if (isCoreAdmin(this.#operationType)) {
-            this.#payload.cao = {
-                tx: tx,
-                txv: this.#txValidity,
-                iw: this.#writingKey,
-                in: nonce,
-                is: signature
-            };
-        } else if (isAdminControl(this.#operationType)) {
-            this.#payload.aco = {
-                tx: tx,
-                txv: this.#txValidity,
-                ia: this.#incomingAddress,
-                in: nonce,
-                is: signature
-            };
-        }
-        else if (isRoleAccess(this.#operationType)) {
-            this.#payload.rao = {
-                tx: this.#txHash,
-                txv: this.#txValidity,
-                iw: this.#incomingWriterKey,
-                in: this.#incomingNonce,
-                is: this.#incomingSignature,
-                va: addressToBuffer(this.#wallet.address),
-                vn: nonce,
-                vs: signature,
-            };
-        } else if (isTransaction(this.#operationType)) {
-            this.#payload.txo = {
-                tx: this.#txHash,
-                txv: this.#txValidity,
-                iw: this.#incomingWriterKey,
-                ch: this.#contentHash,
-                bs: this.#externalBootstrap,
-                mbs: this.#msbBootstrap,
-                in: this.#incomingNonce,
-                is: this.#incomingSignature,
-                va: addressToBuffer(this.#wallet.address),
-                vn: nonce,
-                vs: signature,
-            };
-        } else if (isBootstrapDeployment(this.#operationType)) {
-            this.#payload.bdo = {
-                tx: this.#txHash,
-                txv: this.#txValidity,
-                bs: this.#externalBootstrap,
-                ic: this.#channel,
-                in: this.#incomingNonce,
-                is: this.#incomingSignature,
-                va: addressToBuffer(this.#wallet.address),
-                vn: nonce,
-                vs: signature
-            }
-        } else if (isTransfer(this.#operationType)) {
-            this.#payload.tro = {
-                tx: this.#txHash,
-                txv: this.#txValidity,
-                to: this.#incomingAddress,
-                am: this.#amount,
-                in: this.#incomingNonce,
-                is: this.#incomingSignature,
-                va: addressToBuffer(this.#wallet.address),
-                vn: nonce,
-                vs: signature
-            }
-        } else if (isBalanceInitialization(this.#operationType)) {
-            this.#payload.bio = {
-                tx: tx,
-                txv: this.#txValidity,
-                ia: this.#incomingAddress,
-                am: this.#amount,
-                in: nonce,
-                is: signature
-            }
-        }
-        else {
-            throw new Error(`No corresponding value type for operation: ${OperationType[this.#operationType]}.`);
-        }
-
-        return this;
-    }
-
-    getPayload() {
-        if (
-            !this.#payload.type ||
-            !this.#payload.address ||
-            (
-                !this.#payload.cao &&
-                !this.#payload.aco &&
-                !this.#payload.rao &&
-                !this.#payload.txo &&
-                !this.#payload.bdo &&
-                !this.#payload.tro &&
-                !this.#payload.bio
-            )
-        ) {
-            throw new Error('Product is not fully assembled. Missing type, address, or value (cao/aco/rao/txo/bdo/tro/bio).');
-        }
-        const res = this.#payload;
-        this.reset();
-        return res;
-    }
-}
-
-export default CompleteStateMessageBuilder;