@keetanetwork/keetanet-client 0.16.1 → 0.16.2

package/client/index.d.ts

@@ -1446,11 +1446,12 @@ export declare const lib: {
         ASN1: typeof import("../lib/utils/asn1");
         Bloom: typeof import("../lib/utils/bloom");
         Buffer: typeof import("../lib/utils/buffer");
+        Certificate: typeof import("../lib/utils/certificate");
+        Conversion: typeof import("../lib/utils/conversion");
+        DomainSeparation: typeof import("../lib/utils/domain-separation");
         Hash: typeof import("../lib/utils/hash");
         Helper: typeof import("../lib/utils/helper");
         Initial: typeof import("../lib/utils/initial");
-        Conversion: typeof import("../lib/utils/conversion");
-        Certificate: typeof import("../lib/utils/certificate");
     };
 };
 export {};

package/client/index.js

@@ -57597,6 +57597,10 @@ class UserClientBuilder {
                 if (fees.length === 0) {
                     continue;
                 }
+                // If fee options contains an amount of 0, skip this vote
+                if (fees.some(fee => fee.amount === 0n)) {
+                    continue;
+                }
                 // Find fee with undefined token or matching baseToken
                 let selectedFee = fees.find((fee) => {
                     if (fee.token === undefined || fee.token.comparePublicKey(baseToken)) {
@@ -58130,7 +58134,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
-var _Client_instances, _Client_reps, _Client_weightOrderedReps, _Client_intervals, _Client_updateRepsPromise, _Client_apiRaw, _Client_api, _Client_requestVoteOrQuote, _Client_requestQuotes, _Client_requestVotes, _Client_getVotes, _Client_getBuilderRenderOptions, _Client_urlSeparatedAccounts, _Client_formatAllBalances, _Client_parseResponsePermissions, _Client_formatAccountInfo, _Client_parseAccountInfo, _Client_parsePermissionEntries, _Client_mapCertificateWithBundleResult, _Client_parseRepInfo, _UserClient_instances, _UserClient_config, _UserClient_client, _UserClient_listeners, _UserClient_intervals, _UserClient_previousAccountChangeData, _UserClient_socketPromise, _UserClient_filteredWebSocket, _UserClient_changePromise, _UserClient_reconnectAttempts, _UserClient_RECONNECT_TIMEOUT, _UserClient_transientUserClients, _UserClient_getAccount, _UserClient_publishAidURL_get, _UserClient_publishWithPublishAid, _UserClient_reconnectWebSocket, _UserClient_setupFilteredWebSocket, _UserClient_emit, _UserClient_emitAccountInfoIfChanged;
+var _Client_instances, _Client_reps, _Client_weightOrderedReps, _Client_intervals, _Client_updateRepsPromise, _Client_apiRaw, _Client_api, _Client_requestVoteOrQuote, _Client_requestQuotes, _Client_requestVotes, _Client_getVotes, _Client_getBuilderRenderOptions, _Client_votesRequireFees, _Client_urlSeparatedAccounts, _Client_formatAllBalances, _Client_parseResponsePermissions, _Client_formatAccountInfo, _Client_parseAccountInfo, _Client_parsePermissionEntries, _Client_mapCertificateWithBundleResult, _Client_parseRepInfo, _UserClient_instances, _UserClient_config, _UserClient_client, _UserClient_listeners, _UserClient_intervals, _UserClient_previousAccountChangeData, _UserClient_socketPromise, _UserClient_filteredWebSocket, _UserClient_changePromise, _UserClient_reconnectAttempts, _UserClient_RECONNECT_TIMEOUT, _UserClient_transientUserClients, _UserClient_getAccount, _UserClient_publishAidURL_get, _UserClient_publishWithPublishAid, _UserClient_reconnectWebSocket, _UserClient_setupFilteredWebSocket, _UserClient_emit, _UserClient_emitAccountInfoIfChanged;
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.lib = exports.UserClient = exports.Client = void 0;
 exports.blockGenerator = blockGenerator;
@@ -58374,13 +58378,7 @@ class Client {
      */
     async transmit(blocks, options) {
         const tempVotes = await __classPrivateFieldGet(this, _Client_instances, "m", _Client_requestVotes).call(this, blocks, undefined, undefined, options?.quotes);
-        let requiresFee = false;
-        for (const vote of tempVotes) {
-            if (vote.fee !== undefined) {
-                requiresFee = true;
-            }
-        }
-        if (requiresFee) {
+        if (__classPrivateFieldGet(this, _Client_instances, "m", _Client_votesRequireFees).call(this, tempVotes)) {
             if (options?.generateFeeBlock === undefined) {
                 throw (new Error('Votes require fees but generateFeeBlock was not defined'));
             }
@@ -59320,15 +59318,8 @@ class Client {
                 tempVotes = [...tempVotes, ...newTempVotes];
             }
             const missingPermReps = __classPrivateFieldGet(this, _Client_reps, "f").filter(rep => !permReps.includes(rep));
-            // If any of the temporary votes require a fee, we need to generate a fee block
-            let requiresFee = false;
-            for (const vote of tempVotes) {
-                if (vote.fee !== undefined) {
-                    requiresFee = true;
-                }
-            }
             // If we need a fee block and don't have any permanent votes, we need to generate a fee block
-            if (requiresFee && permVotes.length === 0) {
+            if (__classPrivateFieldGet(this, _Client_instances, "m", _Client_votesRequireFees).call(this, tempVotes) && permVotes.length === 0) {
                 if (options?.generateFeeBlock === undefined) {
                     throw (new Error('Votes require fees but generateFeeBlock was not defined'));
                 }
@@ -59823,6 +59814,22 @@ async function _Client_apiRaw(rep, api, method, options = {}) {
             return (currentHeadBlock);
         }
     });
+}, _Client_votesRequireFees = function _Client_votesRequireFees(tempVotes) {
+    let requiresFees = false;
+    for (const vote of tempVotes) {
+        if (vote.fee !== undefined) {
+            const voteFee = Array.isArray(vote.fee) ? vote.fee : [vote.fee];
+            // Check if user has the option to pay zero (any fee with amount === 0)
+            // If a zero-amount option exists, fee block is optional for this vote
+            const hasZeroFeeOption = voteFee.some(fee => fee.amount === 0n);
+            // If no zero option exists (requires payment), fee block is required
+            if (!hasZeroFeeOption) {
+                requiresFees = true;
+                break;
+            }
+        }
+    }
+    return (requiresFees);
 }, _Client_urlSeparatedAccounts = function _Client_urlSeparatedAccounts(accounts) {
     const pubKeys = accounts.map(account => account_1.default.toPublicKeyString(account));
     return (pubKeys.join(','));
@@ -61369,6 +61376,7 @@ const p256_1 = __webpack_require__(5897);
 const buffer_1 = __webpack_require__(3310);
 const helper_1 = __webpack_require__(3208);
 const hash_1 = __webpack_require__(7908);
+const domain_separation_1 = __webpack_require__(9061);
 const asn1_1 = __webpack_require__(6045);
 const block_1 = __importStar(__webpack_require__(6158));
 const account_1 = __importDefault(__webpack_require__(4642));
@@ -61639,7 +61647,7 @@ class ExternalKeyPair extends KeyInterface {
         return (__classPrivateFieldGet(this, _ExternalKeyPair_functions, "f").decrypt(...parameters));
     }
     get supportsEncryption() {
-        return (true);
+        return (__classPrivateFieldGet(this, _ExternalKeyPair_functions, "f").supportsEncryption);
     }
     get keyType() {
         return (__classPrivateFieldGet(this, _ExternalKeyPair_keyType, "f"));
@@ -62645,6 +62653,9 @@ class Account {
         if (__classPrivateFieldGet(this, _Account_privateKeyPair, "f") === null) {
             throw (new Error('May not sign unless a private key is available'));
         }
+        if (options.namespace !== undefined) {
+            data = (0, domain_separation_1.applyNamespace)(options.namespace, data);
+        }
         if (!__classPrivateFieldGet(this, _Account_keyPairHandlesHashing, "f") && !options.raw) {
             data = (0, hash_1.Hash)(Buffer.from(data));
         }
@@ -62659,6 +62670,9 @@ class Account {
             forCert: false,
             ...options
         };
+        if (options.namespace !== undefined) {
+            data = (0, domain_separation_1.applyNamespace)(options.namespace, data);
+        }
         if (!__classPrivateFieldGet(this, _Account_keyPairHandlesHashing, "f") && !options.raw) {
             data = (0, hash_1.Hash)(Buffer.from(data));
         }
@@ -62791,10 +62805,11 @@ class Account {
      * Determine if an account is an identifier
      */
     isIdentifier() {
-        // We are checking here, so it is safe to assert the type
-        // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
-        return (identifierKeyTypes.includes(this.keyType));
+        return (Account.isIdentifierKeyType(__classPrivateFieldGet(this, _Account_keyType, "f")));
     }
+    /**
+     * Determine if an account is a regular (non-identifier)
+     */
     isAccount() {
         return (!this.isIdentifier());
     }
@@ -62827,7 +62842,7 @@ class Account {
     }
     assertAccount() {
         if (this.isIdentifier() !== false) {
-            throw (new Error('Required Account but got Identifier'));
+            throw (new account_1.default('ACCOUNT_NOT_ACCOUNT', 'Required Account but got Identifier'));
         }
         // We need to assert this type because we are changing what the constructed type is
         // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
@@ -62835,7 +62850,7 @@ class Account {
     }
     assertIdentifier() {
         if (this.isIdentifier() !== true) {
-            throw (new Error(`Required Identifier but got Account, ${this.keyType}`));
+            throw (new account_1.default('ACCOUNT_NOT_IDENTIFIER', `Required Identifier but got Account, ${this.keyType}`));
         }
         // We need to assert this type because we are changing what the constructed type is
         // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
@@ -62852,6 +62867,18 @@ _Account_privateKeyPair = new WeakMap(), _Account_publicKeyPair = new WeakMap(),
  */
 Account.AccountKeyAlgorithm = AccountKeyAlgorithm;
 Account.ExternalKeyPair = ExternalKeyPair;
+/**
+ * Access to the underlying Key Pair classes for advanced use cases.
+ */
+Account.KeyPairs = {
+    [AccountKeyAlgorithm.ECDSA_SECP256K1]: ECDSASECP256K1KeyPair,
+    [AccountKeyAlgorithm.ECDSA_SECP256R1]: ECDSASECP256R1KeyPair,
+    [AccountKeyAlgorithm.ED25519]: ED25519KeyPair,
+    [AccountKeyAlgorithm.NETWORK]: IdentifierKeyPair,
+    [AccountKeyAlgorithm.TOKEN]: IdentifierKeyPair,
+    [AccountKeyAlgorithm.STORAGE]: IdentifierKeyPair,
+    [AccountKeyAlgorithm.MULTISIG]: IdentifierKeyPair
+};
 Account.isInstance = (0, helper_2.checkableGenerator)(Account);
 Account.Set = (0, helper_1.setGenerator)(Account, function (account) {
     const retval = account.publicKeyAndTypeString;
@@ -63952,8 +63979,9 @@ class UnsignedBlock extends PossiblyUnsignedBlock {
     async seal() {
         const signers = UnsignedBlock.getSortedRequiredSigners(this.signer);
         const hash = this.hash;
+        const ancillaryData = this.toBytes(false);
         const signatures = await Promise.all(signers.map(async function (signer) {
-            const signature = await signer.sign(hash.getBuffer());
+            const signature = await signer.sign(hash.getBuffer(), { ancillaryData });
             return (signature.getBuffer());
         }));
         const shared = {
@@ -64993,8 +65021,8 @@ class BlockOperationSET_REP extends BlockOperation {
     }
     validate(context) {
         const { block } = context;
-        if (block.account.isIdentifier()) {
-            throw (new block_1.default('BLOCK_NO_IDENTIFIER_OP', 'Identifier accounts cannot use SET_REP'));
+        if (!(0, common_1.canDelegate)(block.account.keyType)) {
+            throw (new block_1.default('BLOCK_NO_IDENTIFIER_OP', `${account_1.AccountKeyAlgorithm[block.account.keyType]} accounts cannot use SET_REP`));
         }
         if (this.to.isIdentifier()) {
             throw (new block_1.default('BLOCK_NO_IDENTIFIER_OP', 'Cannot delegate to an identifier'));
@@ -65698,12 +65726,16 @@ exports.AccountErrorCodes = [
     'INVALID_CONSTRUCTION',
     'NO_IDENTIFIER_SIGN',
     'NO_IDENTIFIER_VERIFY',
+    'NOT_ACCOUNT',
+    'NOT_IDENTIFIER',
     'INVALID_IDENTIFIER_CONSTRUCTION',
     'SEED_INDEX_UNDEFINED',
     'SEED_INDEX_NEGATIVE',
     'SEED_INDEX_NOT_INT',
     'SEED_INDEX_TOO_LARGE',
-    'ENCRYPTION_NOT_SUPPORTED'
+    'ENCRYPTION_NOT_SUPPORTED',
+    'NAMESPACE_EMPTY',
+    'NAMESPACE_TOO_LONG'
 ];
 exports.FullAccountErrorCodes = exports.AccountErrorCodes.map(code => `${AccountErrorType}_${code}`);
 class KeetaNetAccountError extends base_1.KeetaNetErrorBase {
@@ -66452,6 +66484,7 @@ const error_1 = __webpack_require__(5390);
 const ASN1 = __importStar(__webpack_require__(6045));
 const Bloom = __importStar(__webpack_require__(7313));
 const Buffer = __importStar(__webpack_require__(3310));
+const DomainSeparation = __importStar(__webpack_require__(9061));
 const Hash = __importStar(__webpack_require__(7908));
 const Helper = __importStar(__webpack_require__(3208));
 const Initial = __importStar(__webpack_require__(3750));
@@ -66476,11 +66509,12 @@ exports["default"] = {
         ASN1,
         Bloom,
         Buffer,
+        Certificate,
+        Conversion,
+        DomainSeparation,
         Hash,
         Helper,
-        Initial,
-        Conversion,
-        Certificate
+        Initial
     }
 };
 
@@ -66755,6 +66789,7 @@ exports.validateSupply = validateSupply;
 exports.validateNumericValue = validateNumericValue;
 exports.validateBlockSignerCount = validateBlockSignerCount;
 exports.validateBlockSignerDepth = validateBlockSignerDepth;
+exports.canDelegate = canDelegate;
 exports.computeLedgerEffect = computeLedgerEffect;
 exports.addTimeStatistic = addTimeStatistic;
 exports.assertLedgerStorage = assertLedgerStorage;
@@ -66816,6 +66851,29 @@ function validateBlockSignerDepth(depth, network) {
         throw (new block_2.default('BLOCK_INVALID_MULTISIG_SIGNER_DEPTH', `signer depth does not fit proper format -- GOT: '${depth}' MaxValue: ${maxValue}`));
     }
 }
+/**
+ * Determines if an account type can delegate voting weight via SET_REP.
+ *
+ * Regular accounts (ECDSA_SECP256K1, ED25519, ECDSA_SECP256R1) can always delegate.
+ * Among identifier accounts, only STORAGE accounts can delegate.
+ * TOKEN, NETWORK, and MULTISIG identifier accounts cannot delegate.
+ *
+ * @param keyType - The account key algorithm type to check
+ * @returns true if the account type can use SET_REP to delegate, false otherwise
+ *
+ */
+function canDelegate(keyType) {
+    // Regular accounts (non-identifiers) can always delegate
+    if (!account_1.default.isIdentifierKeyType(keyType)) {
+        return (true);
+    }
+    // Among identifiers, only STORAGE can delegate
+    if (keyType === account_1.AccountKeyAlgorithm.STORAGE) {
+        return (true);
+    }
+    // Other identifier accounts cannot delegate
+    return (false);
+}
 /**
  * Compute effects on the ledger from block effects
  */
@@ -66897,7 +66955,7 @@ async function computeLedgerEffect(options, effects, storageProvider, network, t
         const delegationField = effects[accountPubKey]?.fields.delegation;
         const isDelegating = delegationField !== undefined;
         let requestedRep = false;
-        if (isDelegating && computeWeights && getFinalNumericValues && account.isAccount()) {
+        if (isDelegating && computeWeights && getFinalNumericValues && canDelegate(account.keyType)) {
             requestedRep = true;
             prefetchPromises.push(getRep(account, getFinalNumericValues));
             prefetchPromises.push(getWeight(delegationField.delegateTo));
@@ -66925,7 +66983,7 @@ async function computeLedgerEffect(options, effects, storageProvider, network, t
                 if ((possibleNegative && checkRangeConstraints) || set || getFinalNumericValues || (isDelegating && computeWeights)) {
                     prefetchPromises.push(getPreviousBalance(account, token));
                 }
-                if (computeWeights && isBaseToken && account.isAccount() && !requestedRep) {
+                if (computeWeights && isBaseToken && canDelegate(account.keyType) && !requestedRep) {
                     requestedRep = true;
                     prefetchPromises.push(getRep(account, getFinalNumericValues));
                 }
@@ -67061,7 +67119,7 @@ async function computeLedgerEffect(options, effects, storageProvider, network, t
         }
         const delegationField = effects[accountPubKey]?.fields.delegation;
         const isDelegating = delegationField !== undefined;
-        if (isDelegating && account.isAccount() && computeWeights) {
+        if (isDelegating && canDelegate(account.keyType) && computeWeights) {
             const currentDelegation = await getRep(account, getFinalNumericValues);
             const previousBalance = await getPreviousBalance(account, baseToken);
             await modifyWeight(delegationField.delegateTo, previousBalance);
@@ -67115,7 +67173,7 @@ async function computeLedgerEffect(options, effects, storageProvider, network, t
                     receivable[otherAccountPubKey][tokenPubKey] += balanceChange;
                 }
                 const isBaseToken = baseToken.comparePublicKey(tokenAcct);
-                if (isBaseToken && account.isAccount() && computeWeights) {
+                if (isBaseToken && canDelegate(account.keyType) && computeWeights) {
                     if (isDelegating) {
                         await modifyWeight(delegationField.delegateTo, balanceChange);
                     }
@@ -68528,6 +68586,14 @@ class LedgerAtomicInterface {
             if (!quote.issuer.comparePublicKey(ledgerPubKey)) {
                 throw (new ledger_1.KeetaNetLedgerError('LEDGER_QUOTE_MISMATCH', 'Provided quote does not match issuer public key'));
             }
+            if (quote.blocks.length !== blocks.length) {
+                throw (new ledger_1.KeetaNetLedgerError('LEDGER_QUOTE_MISMATCH', 'Provided quote does not match blocks length'));
+            }
+            for (let blockIndex = 0; blockIndex < blocks.length; blockIndex++) {
+                if (!blocks[blockIndex].hash.compareHexString(quote.blocks[blockIndex])) {
+                    throw (new ledger_1.KeetaNetLedgerError('LEDGER_QUOTE_MISMATCH', 'Provided quote does not match blocks content'));
+                }
+            }
         }
         /**
          * Verify some attributes about the other votes if they are provided
@@ -68552,6 +68618,7 @@ class LedgerAtomicInterface {
                 }
             }
             const requiredFees = new Map();
+            const optionalFees = new Map();
             for (const checkVote of otherVotes) {
                 if (checkVote.quote === true) {
                     throw (new ledger_1.KeetaNetLedgerError('LEDGER_VOTE_WITH_QUOTE', 'Cannot request votes with quote as supporting votes'));
@@ -68565,7 +68632,18 @@ class LedgerAtomicInterface {
                 seenVoteIssuers.add(checkVote.issuer);
                 seenVoteUIDs.add(checkVote.$id);
                 if (checkVote.fee !== undefined) {
-                    requiredFees.set(checkVote.issuer, checkVote.fee);
+                    const checkVoteFee = Array.isArray(checkVote.fee) ? checkVote.fee : [checkVote.fee];
+                    // Check if user has the option to pay zero (any fee with amount === 0)
+                    // If a zero-amount option exists, fee block is optional; otherwise required
+                    const hasZeroFeeOption = checkVoteFee.some(fee => fee.amount === 0n);
+                    if (hasZeroFeeOption) {
+                        // At least one fee option is zero amount - fee block is optional, but if included should match one of the provided options
+                        optionalFees.set(checkVote.issuer, checkVote.fee);
+                    }
+                    else if (checkVoteFee.length > 0) {
+                        // All fee options require payment (no zero option) - fee block MUST be present and operation should match at least one fee option
+                        requiredFees.set(checkVote.issuer, checkVote.fee);
+                    }
                 }
                 /*
                  * Handle errors specific to requesting a permanent vote
@@ -68592,23 +68670,43 @@ class LedgerAtomicInterface {
                     foundOurVote = true;
                 }
             }
+            let finalRequiredFees = requiredFees;
             /*
              * We only care about fees if we are issuing a permanent vote,
              * if we are issuing a temporary vote the fees will be checked
              * when the permanent vote is requested
              */
             if (outcome === 'permanent') {
-                if (requiredFees.size > 0) {
-                    if (!hasFeeBlock) {
-                        throw (new ledger_1.KeetaNetLedgerError('LEDGER_MISSING_REQUIRED_FEE_BLOCK', 'Missing fee block but votes require it'));
+                if (requiredFees.size > 0 || optionalFees.size > 0) {
+                    // If fees are required then a fee block should have been provided
+                    if (requiredFees.size > 0) {
+                        if (!hasFeeBlock) {
+                            throw (new ledger_1.KeetaNetLedgerError('LEDGER_MISSING_REQUIRED_FEE_BLOCK', 'Missing fee block but votes require it'));
+                        }
                     }
-                    // Each vote requires exactly one fee payment, regardless of array size
-                    if (requiredFees.size !== possibleFeeBlock?.operations.length) {
-                        throw (new ledger_1.KeetaNetLedgerError('LEDGER_REQUIRED_FEE_MISMATCH', 'Fee Block Operations do not match required fees'));
+                    // We can only validate operations match if we have a fee block
+                    if (hasFeeBlock) {
+                        // Each vote requires exactly one fee payment, regardless of array size
+                        // Optional fees may or may not be included in the operations but if they are they should match
+                        if (optionalFees.size > 0) {
+                            if (possibleFeeBlock?.operations.length !== requiredFees.size &&
+                                possibleFeeBlock?.operations.length !== (requiredFees.size + optionalFees.size)) {
+                                throw (new ledger_1.KeetaNetLedgerError('LEDGER_REQUIRED_FEE_MISMATCH', 'Fee Block Operations do not match required fees or required and optional fees'));
+                            }
+                            // If user provided optional fees then we should validate they match
+                            if (possibleFeeBlock?.operations.length === (requiredFees.size + optionalFees.size)) {
+                                finalRequiredFees = new Map([...requiredFees, ...optionalFees]);
+                            }
+                        }
+                        else {
+                            if (requiredFees.size !== possibleFeeBlock?.operations.length) {
+                                throw (new ledger_1.KeetaNetLedgerError('LEDGER_REQUIRED_FEE_MISMATCH', 'Fee Block Operations do not match required fees'));
+                            }
+                        }
                     }
                 }
                 // Verify that at least one required fee option has been satisfied for each vote
-                for (const [issuer, feeOrFees] of requiredFees) {
+                for (const [issuer, feeOrFees] of finalRequiredFees) {
                     // Handle both single fee and array of fees
                     const fees = Array.isArray(feeOrFees) ? feeOrFees : [feeOrFees];
                     // Check if at least one fee option is satisfied
@@ -68913,6 +69011,10 @@ class LedgerAtomicInterface {
         return (retval);
     }
     async getAccountRep(account) {
+        const acct = account_1.default.toAccount(account);
+        if (!(0, common_1.canDelegate)(acct.keyType)) {
+            return (null);
+        }
         const transaction = __classPrivateFieldGet(this, _LedgerAtomicInterface_instances, "m", _LedgerAtomicInterface_assertTransaction).call(this);
         const retval = await __classPrivateFieldGet(this, _LedgerAtomicInterface_storage, "f").getAccountRep(transaction, account);
         return (retval);
@@ -69543,7 +69645,12 @@ async function _LedgerAtomicInterface_validateLedgerOutcome(blocks) {
      */
     if (requireBlockTimestampCheck) {
         const fee = quote?.fee ?? await this.getFee(blocks, effects);
-        if (fee !== null) {
+        // We add an explicit fee of 0 if one is not provided.
+        // Since the quote identifier is in the fee data and needs to be parsed correctly.
+        if (fee === null || (Array.isArray(fee) && fee.length === 0)) {
+            builder.addFee({ amount: 0n });
+        }
+        else {
             builder.addFee(fee);
         }
     }
@@ -77668,6 +77775,76 @@ function parseHexBigIntString(input) {
 }
 
 
+/***/ }),
+
+/***/ 9061:
+/***/ (function(__unused_webpack_module, exports, __webpack_require__) {
+
+"use strict";
+
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.namespacePrefixSchema = exports.MaxNamespaceLength = exports.KeetaNamespaceVersion = void 0;
+exports.applyNamespace = applyNamespace;
+const account_1 = __importDefault(__webpack_require__(4642));
+const asn1_1 = __webpack_require__(6045);
+/**
+ * Version for Keeta's domain separation namespace schema, encoded as the
+ * `INTEGER` field of `namespacePrefixSchema`.
+ */
+exports.KeetaNamespaceVersion = 0;
+/**
+ * Maximum domain separation namespace length in bytes (for strings,
+ * this is the UTF-8 byte length, not the character count).
+ */
+exports.MaxNamespaceLength = 255;
+/**
+ * Schema for the namespace prefix:
+ *
+ * ```asn1
+ * NamespacePrefix ::= SEQUENCE {
+ *     version   INTEGER,
+ *     namespace OCTET STRING,
+ *     data      OCTET STRING
+ * }
+ * ```
+ */
+exports.namespacePrefixSchema = [
+    asn1_1.ValidateASN1.IsInteger,
+    asn1_1.ValidateASN1.IsOctetString,
+    asn1_1.ValidateASN1.IsOctetString
+];
+/**
+ * Apply the `NamespacePrefix` domain separator to `data`.
+ *
+ * String namespaces are UTF-8 encoded; ArrayBuffer namespaces are used
+ * verbatim. Namespace length MUST be 1-`MaxNamespaceLength` bytes after
+ * encoding.
+ */
+function applyNamespace(namespace, data) {
+    let namespaceBytes;
+    if (typeof namespace === 'string') {
+        namespaceBytes = new TextEncoder().encode(namespace);
+    }
+    else {
+        namespaceBytes = new Uint8Array(namespace);
+    }
+    if (namespaceBytes.length === 0) {
+        throw (new account_1.default('ACCOUNT_NAMESPACE_EMPTY', 'Domain separation namespace must not be empty'));
+    }
+    if (namespaceBytes.length > exports.MaxNamespaceLength) {
+        throw (new account_1.default('ACCOUNT_NAMESPACE_TOO_LONG', `Domain separation namespace must be 1-${exports.MaxNamespaceLength} bytes, got: ${namespaceBytes.length}`));
+    }
+    return ((0, asn1_1.JStoASN1)([
+        exports.KeetaNamespaceVersion,
+        Buffer.from(namespaceBytes),
+        Buffer.from(data)
+    ]).toBER(false));
+}
+
+
 /***/ }),
 
 /***/ 9240:
@@ -78156,6 +78333,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 var _AsyncDisposableStackPolyfill_instances, _AsyncDisposableStackPolyfill_toDispose, _AsyncDisposableStackPolyfill_validateNotDisposed, _a;
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.util = exports.crypto = exports.AsyncDisposableStack = void 0;
+exports.getTypedObjectEntries = getTypedObjectEntries;
 exports.validateBase64ToBuffer = validateBase64ToBuffer;
 exports.bufferToArrayBuffer = bufferToArrayBuffer;
 exports.bufferToBigInt = bufferToBigInt;
@@ -78178,6 +78356,11 @@ const crypto_1 = __importDefault(__webpack_require__(6982));
 const util_1 = __webpack_require__(9023);
 const hash_1 = __webpack_require__(7908);
 const uuid = __importStar(__webpack_require__(5827));
+// Helper to get properly typed entries from an object
+function getTypedObjectEntries(obj) {
+    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+    return Object.entries(obj);
+}
 const randomBytes = crypto_1.default.randomBytes.bind(crypto_1.default);
 const randomUUID = crypto_1.default.randomUUID ? crypto_1.default.randomUUID.bind(crypto_1.default) : function () {
     return (uuid.v4());
@@ -80587,6 +80770,12 @@ class BaseVoteBuilder {
 }
 exports.BaseVoteBuilder = BaseVoteBuilder;
 _BaseVoteBuilder_account = new WeakMap(), _BaseVoteBuilder_blocks = new WeakMap(), _BaseVoteBuilder_fee = new WeakMap(), _BaseVoteBuilder_instances = new WeakSet(), _BaseVoteBuilder_formatSingleFeeEntry = function _BaseVoteBuilder_formatSingleFeeEntry(feeInput) {
+    if (feeInput.amount === undefined) {
+        throw (new vote_1.default('VOTE_BUILDER_INVALID_FEE', 'Fee amount is required'));
+    }
+    if (BigInt(feeInput.amount) < 0n) {
+        throw (new vote_1.default('VOTE_BUILDER_INVALID_FEE', 'Fee amount cannot be negative'));
+    }
     const fee = { amount: BigInt(feeInput.amount) };
     const payTo = account_1.default.toAccount(feeInput.payTo);
     if (payTo !== undefined) {
@@ -80667,7 +80856,7 @@ exports.Testing = { findRDN, blockHashesFromVote, feeFromVote, hashDataSchema, f
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.version = void 0;
-exports.version = '0.16.1+g8d5abd1c27152ecca68f2594f9191c1c77a334a4';
+exports.version = '0.16.2+g2c1441eed2a1c71a895d0fb5166c431799b3d3ca';
 exports["default"] = exports.version;
 
 

package/docs/assets/hierarchy.js

@@ -1 +1 @@
-window.hierarchyData = "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"
+window.hierarchyData = "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"