trac-msb 0.2.8 → 0.2.10

package/src/messages/completeStateMessages/CompleteStateMessageOperations.js

@@ -1,296 +0,0 @@
-import CompleteStateMessageDirector from './CompleteStateMessageDirector.js';
-import CompleteStateMessageBuilder from './CompleteStateMessageBuilder.js';
-import { safeEncodeApplyOperation } from '../../utils/protobuf/operationHelpers.js';
-
-class CompleteStateMessageOperations {
-    #config
-    #wallet
-    constructor(wallet, config) {
-        this.#wallet = wallet
-        this.#config = config
-    }
-
-    async assembleAddAdminMessage(writingKey, txValidity) {
-        try {
-            const builder = new CompleteStateMessageBuilder(this.#wallet, this.#config);
-            const director = new CompleteStateMessageDirector();
-            director.builder = builder;
-
-            const payload = await director.buildAddAdminMessage(this.#wallet.address, writingKey, txValidity);
-            return safeEncodeApplyOperation(payload);
-        } catch (error) {
-            throw new Error(`Failed to assemble admin message: ${error.message}`);
-        }
-    }
-
-    async assembleDisableInitializationMessage(writingKey, txValidity) {
-        const builder = new CompleteStateMessageBuilder(this.#wallet, this.#config);
-        const director = new CompleteStateMessageDirector();
-        director.builder = builder;
-
-        const payload = await director.buildDisableInitializationMessage(this.#wallet.address, writingKey, txValidity);
-        return safeEncodeApplyOperation(payload);
-    }
-
-    async assembleAddWriterMessage(
-        invokerAddress,
-        transactionHash,
-        txValidity,
-        incomingWritingKey,
-        incomingNonce,
-        incomingSignature
-    ) {
-        try {
-            const builder = new CompleteStateMessageBuilder(this.#wallet, this.#config);
-            const director = new CompleteStateMessageDirector();
-            director.builder = builder;
-
-            const payload = await director.buildAddWriterMessage(
-                invokerAddress,
-                transactionHash,
-                txValidity,
-                incomingWritingKey,
-                incomingNonce,
-                incomingSignature
-            );
-            return safeEncodeApplyOperation(payload);
-
-        } catch (error) {
-            throw new Error(`Failed to assemble add writer message: ${error.message}`);
-        }
-    }
-
-    async assembleRemoveWriterMessage(
-        invokerAddress,
-        transactionHash,
-        txValidity,
-        incomingWritingKey,
-        incomingNonce,
-        incomingSignature
-    ) {
-        try {
-            const builder = new CompleteStateMessageBuilder(this.#wallet, this.#config);
-            const director = new CompleteStateMessageDirector();
-            director.builder = builder;
-
-            const payload = await director.buildRemoveWriterMessage(
-                invokerAddress,
-                transactionHash,
-                txValidity,
-                incomingWritingKey,
-                incomingNonce,
-                incomingSignature
-            );
-            return safeEncodeApplyOperation(payload);
-
-        } catch (error) {
-            throw new Error(`Failed to assemble remove writer message: ${error.message}`);
-        }
-    }
-
-    async assembleAdminRecoveryMessage(
-        invokerAddress,
-        transactionHash,
-        txValidity,
-        incomingWritingKey,
-        incomingNonce,
-        incomingSignature
-    ) {
-        try {
-            const builder = new CompleteStateMessageBuilder(this.#wallet, this.#config);
-            const director = new CompleteStateMessageDirector();
-            director.builder = builder;
-
-            const payload = await director.buildAdminRecoveryMessage(
-                invokerAddress,
-                transactionHash,
-                txValidity,
-                incomingWritingKey,
-                incomingNonce,
-                incomingSignature
-            );
-            return safeEncodeApplyOperation(payload);
-
-        } catch (error) {
-            throw new Error(`Failed to assemble remove writer message: ${error.message}`);
-        }
-    }
-
-    async assembleAddIndexerMessage(incomingAddress, txValidity) {
-        try {
-            const builder = new CompleteStateMessageBuilder(this.#wallet, this.#config);
-            const director = new CompleteStateMessageDirector();
-            director.builder = builder;
-
-            const payload = await director.buildAddIndexerMessage(this.#wallet.address, incomingAddress, txValidity);
-            return safeEncodeApplyOperation(payload);
-
-        } catch (error) {
-            throw new Error(`Failed to assemble addIndexerMessage: ${error.message}`);
-        }
-    }
-
-
-
-    async assembleRemoveIndexerMessage(incomingAddress, txValidity) {
-        try {
-            const builder = new CompleteStateMessageBuilder(this.#wallet, this.#config);
-            const director = new CompleteStateMessageDirector();
-            director.builder = builder;
-
-            const payload = await director.buildRemoveIndexerMessage(this.#wallet.address, incomingAddress, txValidity);
-            return safeEncodeApplyOperation(payload);
-
-        } catch (error) {
-            throw new Error(`Failed to assemble removeIndexerMessage: ${error.message}`);
-        }
-    }
-
-    async assembleAppendWhitelistMessages(txValidity, addressToWhitelist) {
-        try {
-            const builder = new CompleteStateMessageBuilder(this.#wallet, this.#config);
-            const director = new CompleteStateMessageDirector();
-            director.builder = builder;
-
-            const payload = await director.buildAppendWhitelistMessage(this.#wallet.address, addressToWhitelist, txValidity);
-            
-            return safeEncodeApplyOperation(payload);;
-        } catch (error) {
-            throw new Error(`Failed to assemble appendWhitelistMessages: ${error.message}`);
-        }
-    }
-
-    async assembleBalanceInitializationMessages(txValidity, addressBalancePair) {
-        try {
-            const builder = new CompleteStateMessageBuilder(this.#wallet, this.#config);
-            const director = new CompleteStateMessageDirector();
-            director.builder = builder;
-
-            const messages = [];
-
-            for (const [recipientAddress, balanceBuffer] of addressBalancePair) {
-                const payload = await director.buildBalanceInitializationMessage(
-                    this.#wallet.address,
-                    recipientAddress,
-                    balanceBuffer,
-                    txValidity
-                );
-                messages.push(safeEncodeApplyOperation(payload));
-            }
-            return messages;
-
-        } catch (error) {
-            throw new Error(`Failed to assemble balance initialization messages: ${error.message}`);
-        }
-    }
-
-    async assembleBanWriterMessage(incomingAddress, txValidity) {
-        try {
-            const builder = new CompleteStateMessageBuilder(this.#wallet, this.#config);
-            const director = new CompleteStateMessageDirector();
-            director.builder = builder;
-
-            const payload = await director.buildBanWriterMessage(this.#wallet.address, incomingAddress, txValidity);
-            return safeEncodeApplyOperation(payload);
-
-        } catch (error) {
-            throw new Error(`Failed to assemble ban writer message: ${error.message}`);
-        }
-    }
-
-    async assembleCompleteTransactionOperationMessage(
-        invokerAddress,
-        txHash,
-        txValidity,
-        incomingWriterKey,
-        incomingNonce,
-        contentHash,
-        incomingSignature,
-        externalBootstrap,
-        msbBootstrap
-    ) {
-        try {
-            const builder = new CompleteStateMessageBuilder(this.#wallet, this.#config);
-            const director = new CompleteStateMessageDirector();
-            director.builder = builder;
-            const payload = await director.buildTransactionOperationMessage(
-                invokerAddress,
-                txHash,
-                txValidity,
-                incomingWriterKey,
-                incomingNonce,
-                contentHash,
-                incomingSignature,
-                externalBootstrap,
-                msbBootstrap,
-            );
-            return safeEncodeApplyOperation(payload);
-
-        } catch (error) {
-            throw new Error(`Failed to assemble transaction Operation: ${error.message}`);
-        }
-    }
-
-    async assembleCompleteBootstrapDeployment(
-        invokerAddress,
-        transactionHash,
-        txValidity,
-        externalBootstrap,
-        channel,
-        incomingNonce,
-        incomingSignature
-    ) {
-        try {
-            const builder = new CompleteStateMessageBuilder(this.#wallet, this.#config);
-            const director = new CompleteStateMessageDirector();
-            director.builder = builder;
-
-            const payload = await director.buildBootstrapDeploymentMessage(
-                invokerAddress,
-                transactionHash,
-                txValidity,
-                externalBootstrap,
-                channel,
-                incomingNonce,
-                incomingSignature,
-            );
-            return safeEncodeApplyOperation(payload);
-
-        } catch (error) {
-            throw new Error(`Failed to assemble bootstrap deployment message: ${error.message}`);
-        }
-    }
-
-    async assembleCompleteTransferOperationMessage(
-        invokerAddress,
-        transactionHash,
-        txValidity,
-        incomingNonce,
-        recipientAddress,
-        amount,
-        incomingSignature
-    ) {
-        try {
-            const builder = new CompleteStateMessageBuilder(this.#wallet, this.#config);
-            const director = new CompleteStateMessageDirector();
-            director.builder = builder;
-
-            const payload = await director.buildTransferOperationMessage(
-                invokerAddress,
-                transactionHash,
-                txValidity,
-                incomingNonce,
-                recipientAddress,
-                amount,
-                incomingSignature
-            );
-            return safeEncodeApplyOperation(payload);
-
-        } catch (error) {
-            throw new Error(`Failed to assemble transfer operation message: ${error.message}`);
-        }
-    }
-
-}
-
-export default CompleteStateMessageOperations;

package/src/messages/partialStateMessages/PartialStateMessageBuilder.js

@@ -1,272 +0,0 @@
-import PeerWallet from "trac-wallet";
-import b4a from "b4a";
-
-import StateBuilder from '../base/StateBuilder.js'
-import { OperationType } from '../../utils/constants.js';
-import { addressToBuffer, isAddressValid } from '../../core/state/utils/address.js';
-import { isHexString } from "../../utils/helpers.js";
-import { createMessage } from "../../utils/buffer.js";
-import { isTransaction, isRoleAccess, isBootstrapDeployment, isTransfer } from "../../utils/operations.js";
-
-class PartialStateMessageBuilder extends StateBuilder {
-    #wallet;
-    #operationType;
-    #address;
-    #writingKey;
-    #txValidity;
-    #contentHash;
-    #externalBootstrap;
-    #withMsbBootstrap;
-    #channel;
-    #incomingAddress;
-    #amount;
-    #payload;
-    #config;
-
-    /**
-     * @param {PeerWallet} wallet
-     * @param {object} config
-     **/
-    constructor(wallet, config) {
-        super();
-        this.#config = config;
-        if (!wallet || typeof wallet !== 'object') {
-            throw new Error('Wallet must be a valid wallet object');
-        }
-        if (!isAddressValid(wallet.address, this.#config.addressPrefix)) {
-            throw new Error('Wallet should have a valid TRAC address.');
-        }
-
-        this.#wallet = wallet;
-        this.reset();
-    }
-
-    reset() {
-        this.#operationType = null;
-        this.#address = null;
-        this.#writingKey = null;
-        this.#txValidity = null;
-        this.#contentHash = null;
-        this.#externalBootstrap = null;
-        this.#withMsbBootstrap = false;
-        this.#incomingAddress = null;
-        this.#amount = null;
-        this.#channel = null;
-        this.#payload = {};
-    }
-
-    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 (!isAddressValid(address, this.#config.addressPrefix)) {
-            throw new Error(`Address field must be a valid TRAC bech32m address with length ${this.#config.addressLength}.`);
-        }
-
-        this.#address = address;
-        this.#payload.address = this.#address;
-        return this;
-    }
-
-    withContentHash(contentHash) {
-        if (!isHexString(contentHash) || contentHash.length !== 64) {
-            throw new Error('Content hash must be a 64-length hexstring.');
-        }
-        this.#contentHash = contentHash;
-        return this;
-    }
-
-    withExternalBootstrap(bootstrap) {
-        if (!isHexString(bootstrap) || bootstrap.length !== 64) {
-            throw new Error('Bootstrap key must be a 64-length hexstring.');
-        }
-        this.#externalBootstrap = bootstrap;
-        return this;
-    }
-
-    withMsbBootstrap(msbBootstrap) {
-        if (!isHexString(msbBootstrap) || msbBootstrap.length !== 64) {
-            throw new Error('MSB Bootstrap key must be a 64-length hexstring.');
-        }
-        this.#withMsbBootstrap = msbBootstrap;
-        return this;
-    }
-
-    withWriterKey(writerKey) {
-        if (!isHexString(writerKey) || writerKey.length !== 64) {
-            throw new Error('Writer key must be a 64-length hexstring.');
-        }
-        this.#writingKey = writerKey;
-        return this;
-    }
-
-    withTxValidity(txValidity) {
-        if (!isHexString(txValidity) || txValidity.length !== 64) {
-            throw new Error('txValidity must be a 64-length hexstring.');
-        }
-        this.#txValidity = txValidity;
-        return this;
-    }
-
-    withIncomingAddress(address) {
-        if (!isAddressValid(address, this.#config.addressPrefix)) {
-            throw new Error(`Incoming address field must be a valid TRAC bech32m address with length ${this.#config.addressLength}.`);
-        }
-
-        this.#incomingAddress = address;
-        return this;
-    }
-
-    withAmount(amount) {
-        if (!isHexString(amount) || amount.length !== 32) {
-            throw new Error('Amount must be a 32-length hexstring.');
-        }
-
-        this.#amount = amount;
-        return this;
-    }
-
-    withChannel(channel) {
-        if (!isHexString(channel) || channel.length !== 64) {
-            throw new Error('Channel must be a 64-length hexstring.');
-        }
-
-        this.#channel = channel;
-        return this;
-    }
-
-    async buildValueAndSign() {
-        const nonce = PeerWallet.generateNonce();
-        let txMsg = null;
-        let tx = null;
-        let signature = null;
-
-        // Creating a message for signing based on operation type
-        // ATTENTION REMEMBER THAT createMessage accept only BUFFER arguments and uint32
-        switch (this.#operationType) {
-            case OperationType.ADD_WRITER:
-            case OperationType.REMOVE_WRITER:
-            case OperationType.ADMIN_RECOVERY:
-                txMsg = createMessage(
-                    this.#config.networkId,
-                    b4a.from(this.#txValidity, 'hex'),
-                    b4a.from(this.#writingKey, 'hex'),
-                    nonce,
-                    this.#operationType
-                );
-                break;
-
-            case OperationType.BOOTSTRAP_DEPLOYMENT:
-                if (!this.#externalBootstrap) {
-                    throw new Error('External bootstrap key must be set for BOOTSTRAP DEPLOYMENT operation.');
-                }
-                txMsg = createMessage(
-                    this.#config.networkId,
-                    b4a.from(this.#txValidity, 'hex'),
-                    b4a.from(this.#externalBootstrap, 'hex'),
-                    b4a.from(this.#channel, 'hex'),
-                    nonce,
-                    OperationType.BOOTSTRAP_DEPLOYMENT
-                );
-                break;
-
-            case OperationType.TX:
-                txMsg = createMessage(
-                    this.#config.networkId,
-                    b4a.from(this.#txValidity, 'hex'),
-                    b4a.from(this.#writingKey, 'hex'),
-                    b4a.from(this.#contentHash, 'hex'),
-                    b4a.from(this.#externalBootstrap, 'hex'),
-                    b4a.from(this.#withMsbBootstrap, 'hex'),
-                    nonce,
-                    OperationType.TX
-                );
-                break;
-            case OperationType.TRANSFER:
-                txMsg = createMessage(
-                    this.#config.networkId,
-                    b4a.from(this.#txValidity, 'hex'),
-                    addressToBuffer(this.#incomingAddress, this.#config.addressPrefix), // we need to sign address of the recipient as well
-                    b4a.from(this.#amount, 'hex'),
-                    nonce,
-                    OperationType.TRANSFER
-                );
-                break;
-            default:
-                throw new Error(`Unsupported operation type: ${this.#operationType}`);
-        }
-
-        // tx and signature
-        tx = await PeerWallet.blake3(txMsg);
-        signature = this.#wallet.sign(tx);
-
-        // Build the payload based on operation type
-        if (isBootstrapDeployment(this.#operationType)) {
-            this.#payload.bdo = {
-                tx: tx.toString('hex'),
-                txv: this.#txValidity,
-                bs: this.#externalBootstrap,
-                ic: this.#channel,
-                in: nonce.toString('hex'),
-                is: signature.toString('hex')
-            };
-        } else if (isRoleAccess(this.#operationType)) {
-            this.#payload.rao = {
-                tx: tx.toString('hex'),
-                txv: this.#txValidity,
-                iw: this.#writingKey,
-                in: nonce.toString('hex'),
-                is: signature.toString('hex')
-            };
-        } else if (isTransaction(this.#operationType)) {
-            this.#payload.txo = {
-                tx: tx.toString('hex'),
-                txv: this.#txValidity,
-                iw: this.#writingKey,
-                ch: this.#contentHash,
-                bs: this.#externalBootstrap,
-                mbs: this.#withMsbBootstrap,
-                in: nonce.toString('hex'),
-                is: signature.toString('hex'),
-            };
-        } else if (isTransfer(this.#operationType)) {
-            this.#payload.tro = {
-                tx: tx.toString('hex'),
-                txv: this.#txValidity,
-                to: this.#incomingAddress,
-                am: this.#amount,
-                in: nonce.toString('hex'),
-                is: signature.toString('hex')
-            }
-        }
-
-        return this;
-    }
-
-    getPayload() {
-        if (
-            !this.#payload.type ||
-            !this.#payload.address ||
-            (
-                !this.#payload.bdo &&
-                !this.#payload.rao &&
-                !this.#payload.txo &&
-                !this.#payload.tro
-            )
-        ) {
-            throw new Error('Product is not fully assembled. Missing type, address, or value bdo/rao/txo/tro.');
-        }
-        const res = this.#payload;
-        this.reset();
-        return res;
-    }
-}
-
-export default PartialStateMessageBuilder;

package/src/messages/partialStateMessages/PartialStateMessageDirector.js

@@ -1,137 +0,0 @@
-import StateBuilder from '../base/StateBuilder.js'
-import {OperationType} from '../../utils/constants.js'
-import address from "../../core/state/utils/address.js";
-
-class PartialStateMessageDirector {
-    #builder;
-
-    set builder(builderInstance) {
-        if (!(builderInstance instanceof StateBuilder)) {
-            throw new Error('Director requires a Builder instance.');
-        }
-        this.#builder = builderInstance;
-    }
-
-    /**
-     * Builds a PARTIAL bootstrap deployment operation message, which can be sent to a validator.
-     * The validator can sign this operation to make it COMPLETE and broadcast it to the network.
-     * Bootstrap deployment is required to register a subnetwork. The network will reject
-     * TransactionOperation messages for external bootstraps that are not registered.
-     * Do NOT attempt to register the MSB bootstrap key.
-     *
-     * @param {String} address - Trac address of the requester/invoker node that broadcasts the operation.
-     * @param {String} bootstrap - Bootstrap key from the subnetwork to be registered.
-     *                             MUST be different from the MSB bootstrap key.
-     *                             BEFORE deploying, ensure the subnetwork bootstrap is not already deployed.
-     * @param {String} txValidity - Transaction validity hash representing the current indexer combination.
-     *                              The operation remains valid as long as indexer keys maintain their order.
-     *                              Acts as protection against deferred execution attacks.
-     * @returns {Promise<Object>} The built bootstrap deployment operation message.
-     * @throws {Error} If the builder has not been set or message building fails.
-     */
-    async buildPartialBootstrapDeploymentMessage(address, bootstrap, channel, txValidity) {
-        if (!this.#builder) throw new Error('Builder has not been set.');
-
-        await this.#builder
-            .forOperationType(OperationType.BOOTSTRAP_DEPLOYMENT)
-            .withAddress(address)
-            .withTxValidity(txValidity)
-            .withExternalBootstrap(bootstrap)
-            .withChannel(channel)
-            .buildValueAndSign();
-
-        return this.#builder.getPayload();
-    }
-
-    async buildAddWriterMessage(address, writingKey, txValidity) {
-        if (!this.#builder) throw new Error('Builder has not been set.');
-
-        await this.#builder
-            .forOperationType(OperationType.ADD_WRITER)
-            .withAddress(address)
-            .withTxValidity(txValidity)
-            .withWriterKey(writingKey)
-            .buildValueAndSign();
-
-        return this.#builder.getPayload();
-    }
-
-    async buildRemoveWriterMessage(address, writerKey, txValidity) {
-        if (!this.#builder) throw new Error('Builder has not been set.');
-
-        await this.#builder
-            .forOperationType(OperationType.REMOVE_WRITER)
-            .withAddress(address)
-            .withTxValidity(txValidity)
-            .withWriterKey(writerKey)
-            .buildValueAndSign();
-
-        return this.#builder.getPayload();
-    }
-
-    async buildAdminRecoveryMessage(address, writingKey, txValidity) {
-        if (!this.#builder) throw new Error('Builder has not been set.');
-
-        await this.#builder
-            .forOperationType(OperationType.ADMIN_RECOVERY)
-            .withAddress(address)
-            .withTxValidity(txValidity)
-            .withWriterKey(writingKey)
-            .buildValueAndSign();
-
-        return this.#builder.getPayload();
-    }
-
-    /**
-     * Builds a transaction operation message for cross-network communication
-     * @param {String} address - Trac address of the requester/invoker node that broadcasts the transaction
-     * @param {String} incomingWritingKey - Writing key from the subnetwork, used for authentication of the requesting node
-     * @param {String} txValidity - Transaction validity hash representing current indexer combination.
-     *                              Transaction remains valid as long as indexer keys maintain their order.
-     *                              Acts as protection against deferred execution attacks.
-     * @param {String} contentHash - Hash of the contract content from the subnetwork,
-     *                              ensures data integrity between networks
-     * @param {String} externalBootstrap - Bootstrap key from the subnetwork,
-     *                                    used for cross-network communication verification.
-     *                                    MUST BE DIFFERENT from the MSB bootstrap key.
-     *                                    transaction will be rejected if external bootstrap won't be
-     *                                    deployed in the MSB (bootstrapDeploymentOperation).
-     * @param {String} msbBootstrap - Main Settlement Bus bootstrap key,
-     *                                used for internal network verification
-     * @returns {Promise<Object>} The built transaction operation message
-     * @throws {Error} If builder hasn't been set or if message building fails
-     */
-    async buildTransactionOperationMessage(
-        address,
-        incomingWritingKey,
-        txValidity,
-        contentHash,
-        externalBootstrap,
-        msbBootstrap,
-    ) {
-        if (!this.#builder) throw new Error('Builder has not been set.');
-        await this.#builder
-            .forOperationType(OperationType.TX)
-            .withAddress(address)
-            .withTxValidity(txValidity)
-            .withWriterKey(incomingWritingKey)
-            .withContentHash(contentHash)
-            .withExternalBootstrap(externalBootstrap)
-            .withMsbBootstrap(msbBootstrap)
-            .buildValueAndSign();
-        return this.#builder.getPayload();
-    }
-    async buildTransferOperationMessage(address, recipientAddress, amount, txValidity){
-        if (!this.#builder) throw new Error('Builder has not been set.');
-        await this.#builder
-            .forOperationType(OperationType.TRANSFER)
-            .withAddress(address)
-            .withTxValidity(txValidity)
-            .withIncomingAddress(recipientAddress)
-            .withAmount(amount)
-            .buildValueAndSign();
-        return this.#builder.getPayload();
-    }
-}
-
-export default PartialStateMessageDirector;