@aztec/stdlib 0.0.0-test.0 → 0.0.1-commit.0208eb9

package/dest/tx/tx_effect.js

@@ -1,11 +1,11 @@
-import { CONTRACT_CLASS_LOGS_PREFIX, CONTRACT_CLASS_LOG_SIZE_IN_FIELDS, L2_L1_MSGS_PREFIX, MAX_CONTRACT_CLASS_LOGS_PER_TX, MAX_L2_TO_L1_MSGS_PER_TX, MAX_NOTE_HASHES_PER_TX, MAX_NULLIFIERS_PER_TX, MAX_PRIVATE_LOGS_PER_TX, MAX_TOTAL_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, NOTES_PREFIX, NULLIFIERS_PREFIX, PRIVATE_LOGS_PREFIX, PRIVATE_LOG_SIZE_IN_FIELDS, PUBLIC_DATA_UPDATE_REQUESTS_PREFIX, PUBLIC_LOGS_PREFIX, PUBLIC_LOG_SIZE_IN_FIELDS, REVERT_CODE_PREFIX, TX_FEE_PREFIX } from '@aztec/constants';
+var _computedKey;
+import { decodeTxBlobData, encodeTxBlobData, getNumTxBlobFields } from '@aztec/blob-lib/encoding';
+import { MAX_CONTRACT_CLASS_LOGS_PER_TX, MAX_L2_TO_L1_MSGS_PER_TX, MAX_NOTE_HASHES_PER_TX, MAX_NULLIFIERS_PER_TX, MAX_PRIVATE_LOGS_PER_TX, MAX_TOTAL_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX } from '@aztec/constants';
 import { makeTuple, makeTupleAsync } from '@aztec/foundation/array';
-import { toBufferBE } from '@aztec/foundation/bigint-buffer';
-import { padArrayEnd } from '@aztec/foundation/collection';
-import { sha256Trunc } from '@aztec/foundation/crypto';
-import { Fr } from '@aztec/foundation/fields';
+import { randomInt } from '@aztec/foundation/crypto/random';
+import { Fr } from '@aztec/foundation/curves/bn254';
 import { schemas } from '@aztec/foundation/schemas';
-import { BufferReader, FieldReader, serializeArrayOfBufferableToVector, serializeToBuffer } from '@aztec/foundation/serialize';
+import { BufferReader, serializeArrayOfBufferableToVector, serializeToBuffer } from '@aztec/foundation/serialize';
 import { bufferToHex, hexToBuffer } from '@aztec/foundation/string';
 import { inspect } from 'util';
 import { z } from 'zod';
@@ -13,14 +13,9 @@ import { PublicDataWrite } from '../avm/public_data_write.js';
 import { RevertCode } from '../avm/revert_code.js';
 import { ContractClassLog } from '../logs/contract_class_log.js';
 import { PrivateLog } from '../logs/private_log.js';
-import { PublicLog } from '../logs/public_log.js';
+import { FlatPublicLogs, PublicLog } from '../logs/public_log.js';
 import { TxHash } from './tx_hash.js';
-// This will appear as 0x74785f7374617274 in logs
-export const TX_START_PREFIX = 8392562855083340404n;
-// These are helper constants to decode tx effects from blob encoded fields
-export const TX_START_PREFIX_BYTES_LENGTH = TX_START_PREFIX.toString(16).length / 2;
-// 7 bytes for: | 0 | txlen[0] | txlen[1] | 0 | REVERT_CODE_PREFIX | 0 | revertCode |
-export const TX_EFFECT_PREFIX_BYTE_LENGTH = TX_START_PREFIX_BYTES_LENGTH + 7;
+_computedKey = inspect.custom;
 export class TxEffect {
     revertCode;
     txHash;
@@ -117,12 +112,12 @@ export class TxEffect {
             serializeArrayOfBufferableToVector(this.l2ToL1Msgs, 1),
             serializeArrayOfBufferableToVector(this.publicDataWrites, 1),
             serializeArrayOfBufferableToVector(this.privateLogs, 1),
-            serializeArrayOfBufferableToVector(this.publicLogs, 1),
+            serializeArrayOfBufferableToVector(this.publicLogs, 4),
             serializeArrayOfBufferableToVector(this.contractClassLogs, 1)
         ]);
     }
-    /** Returns the size of this tx effect in bytes as serialized onto DA. */ getDASize() {
-        return this.toBlobFields().length * Fr.SIZE_IN_BYTES;
+    equals(other) {
+        return this.revertCode.equals(other.revertCode) && this.txHash.equals(other.txHash) && this.transactionFee.equals(other.transactionFee) && this.noteHashes.length === other.noteHashes.length && this.noteHashes.every((h, i)=>h.equals(other.noteHashes[i])) && this.nullifiers.length === other.nullifiers.length && this.nullifiers.every((h, i)=>h.equals(other.nullifiers[i])) && this.l2ToL1Msgs.length === other.l2ToL1Msgs.length && this.l2ToL1Msgs.every((h, i)=>h.equals(other.l2ToL1Msgs[i])) && this.publicDataWrites.length === other.publicDataWrites.length && this.publicDataWrites.every((h, i)=>h.equals(other.publicDataWrites[i])) && this.privateLogs.length === other.privateLogs.length && this.privateLogs.every((h, i)=>h.equals(other.privateLogs[i])) && this.publicLogs.length === other.publicLogs.length && this.publicLogs.every((h, i)=>h.equals(other.publicLogs[i])) && this.contractClassLogs.length === other.contractClassLogs.length && this.contractClassLogs.every((h, i)=>h.equals(other.contractClassLogs[i]));
     }
     /**
    * Deserializes the TxEffect object from a Buffer.
@@ -130,275 +125,90 @@ export class TxEffect {
    * @returns An instance of TxEffect.
    */ static fromBuffer(buffer) {
         const reader = BufferReader.asReader(buffer);
-        return new TxEffect(RevertCode.fromBuffer(reader), TxHash.fromBuffer(reader), Fr.fromBuffer(reader), reader.readVectorUint8Prefix(Fr), reader.readVectorUint8Prefix(Fr), reader.readVectorUint8Prefix(Fr), reader.readVectorUint8Prefix(PublicDataWrite), reader.readVectorUint8Prefix(PrivateLog), reader.readVectorUint8Prefix(PublicLog), reader.readVectorUint8Prefix(ContractClassLog));
+        return new TxEffect(RevertCode.fromBuffer(reader), TxHash.fromBuffer(reader), Fr.fromBuffer(reader), reader.readVectorUint8Prefix(Fr), reader.readVectorUint8Prefix(Fr), reader.readVectorUint8Prefix(Fr), reader.readVectorUint8Prefix(PublicDataWrite), reader.readVectorUint8Prefix(PrivateLog), reader.readVector(PublicLog), reader.readVectorUint8Prefix(ContractClassLog));
     }
-    /**
-   * Computes txOutHash of this tx effect.
-   * TODO(#7218): Revert to fixed height tree for outbox
-   * @dev Follows new_sha in variable_merkle_tree.nr
-   */ txOutHash() {
-        const { l2ToL1Msgs } = this;
-        if (l2ToL1Msgs.length == 0) {
-            return Buffer.alloc(32);
-        }
-        const depth = l2ToL1Msgs.length == 1 ? 1 : Math.ceil(Math.log2(l2ToL1Msgs.length));
-        let thisLayer = padArrayEnd(l2ToL1Msgs.map((msg)=>msg.toBuffer()), Buffer.alloc(32), 2 ** depth);
-        let nextLayer = [];
-        for(let i = 0; i < depth; i++){
-            for(let j = 0; j < thisLayer.length; j += 2){
-                // Store the hash of each pair one layer up
-                nextLayer[j / 2] = sha256Trunc(Buffer.concat([
-                    thisLayer[j],
-                    thisLayer[j + 1]
-                ]));
-            }
-            thisLayer = nextLayer;
-            nextLayer = [];
-        }
-        return thisLayer[0];
-    }
-    static async random(numPublicCallsPerTx = 3, numPublicLogsPerCall = 1) {
-        return new TxEffect(RevertCode.random(), TxHash.random(), new Fr(Math.floor(Math.random() * 100_000)), makeTuple(MAX_NOTE_HASHES_PER_TX, Fr.random), makeTuple(MAX_NULLIFIERS_PER_TX, Fr.random), makeTuple(MAX_L2_TO_L1_MSGS_PER_TX, Fr.random), makeTuple(MAX_TOTAL_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, ()=>new PublicDataWrite(Fr.random(), Fr.random())), makeTuple(MAX_PRIVATE_LOGS_PER_TX, ()=>new PrivateLog(makeTuple(PRIVATE_LOG_SIZE_IN_FIELDS, Fr.random))), await makeTupleAsync(numPublicCallsPerTx * numPublicLogsPerCall, PublicLog.random), await makeTupleAsync(MAX_CONTRACT_CLASS_LOGS_PER_TX, ContractClassLog.random));
+    static async random({ numNoteHashes, numNullifiers, numL2ToL1Msgs, numPublicDataWrites, numPrivateLogs, numPublicCallsPerTx = 3, numPublicLogsPerCall = 1, numContractClassLogs, maxEffects } = {}) {
+        const count = (max, num)=>num ?? Math.min(maxEffects ?? randomInt(max), max);
+        // Every tx effect must have at least 1 nullifier (the first nullifier is used for log indexing)
+        const countNullifiers = (max, num)=>Math.max(1, count(max, num));
+        return new TxEffect(RevertCode.random(), TxHash.random(), new Fr(Math.floor(Math.random() * 100_000)), makeTuple(count(MAX_NOTE_HASHES_PER_TX, numNoteHashes), Fr.random), makeTuple(countNullifiers(MAX_NULLIFIERS_PER_TX, numNullifiers), Fr.random), makeTuple(count(MAX_L2_TO_L1_MSGS_PER_TX, numL2ToL1Msgs), Fr.random), makeTuple(count(MAX_TOTAL_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX, numPublicDataWrites), PublicDataWrite.random), makeTuple(count(MAX_PRIVATE_LOGS_PER_TX, numPrivateLogs), ()=>PrivateLog.random()), await Promise.all(new Array(numPublicCallsPerTx * numPublicLogsPerCall).fill(null).map(()=>PublicLog.random())), await makeTupleAsync(count(MAX_CONTRACT_CLASS_LOGS_PER_TX, numContractClassLogs), ContractClassLog.random));
     }
     static empty() {
         return new TxEffect(RevertCode.OK, TxHash.zero(), Fr.ZERO, [], [], [], [], [], [], []);
     }
-    isEmpty() {
-        return this.nullifiers.length === 0;
-    }
     /** Returns a hex representation of the TxEffect object. */ toString() {
         return bufferToHex(this.toBuffer());
     }
-    /**
-   * Returns the prefix as used in a blob.
-   * Used to prefix a 'block' of tx effects with its type and length.
-   */ toPrefix(type, length) {
-        const buf = Buffer.alloc(4);
-        buf.writeUint8(type);
-        buf.writeUInt16BE(length, 2);
-        return new Fr(buf);
-    }
-    /**
-   * Decodes the prefix as used in a blob to tx effect type and length.
-   */ static fromPrefix(prefix) {
-        const buf = prefix.toBuffer().subarray(-4);
+    getNumBlobFields() {
+        return this.getTxStartMarker().numBlobFields;
+    }
+    toBlobFields() {
+        return encodeTxBlobData(this.toTxBlobData());
+    }
+    static fromBlobFields(fields) {
+        return TxEffect.fromTxBlobData(decodeTxBlobData(fields));
+    }
+    getTxStartMarker() {
+        const flatPublicLogs = FlatPublicLogs.fromLogs(this.publicLogs);
+        const partialTxStartMarker = {
+            revertCode: this.revertCode.getCode(),
+            numNoteHashes: this.noteHashes.length,
+            numNullifiers: this.nullifiers.length,
+            numL2ToL1Msgs: this.l2ToL1Msgs.length,
+            numPublicDataWrites: this.publicDataWrites.length,
+            numPrivateLogs: this.privateLogs.length,
+            privateLogsLength: this.privateLogs.reduce((acc, log)=>acc + log.emittedLength, 0),
+            publicLogsLength: flatPublicLogs.length,
+            contractClassLogLength: this.contractClassLogs[0]?.emittedLength ?? 0
+        };
+        const numBlobFields = getNumTxBlobFields(partialTxStartMarker);
         return {
-            type: buf[0],
-            length: new Fr(buf.subarray(-2)).toNumber()
+            ...partialTxStartMarker,
+            numBlobFields
         };
     }
-    /**
-   * Encodes the first field of a tx effect as used in a blob:
-   * TX_START_PREFIX | 0 | txlen[0] txlen[1] | 0 | REVERT_CODE_PREFIX | 0 | revert_code
-   */ encodeFirstField(length, revertCode) {
-        const lengthBuf = Buffer.alloc(2);
-        lengthBuf.writeUInt16BE(length, 0);
-        return new Fr(Buffer.concat([
-            toBufferBE(TX_START_PREFIX, TX_START_PREFIX_BYTES_LENGTH),
-            Buffer.alloc(1),
-            lengthBuf,
-            Buffer.alloc(1),
-            Buffer.from([
-                REVERT_CODE_PREFIX
-            ]),
-            Buffer.alloc(1),
-            revertCode.toBuffer()
-        ]));
-    }
-    /**
-   * Decodes the first field of a tx effect as used in a blob:
-   * TX_START_PREFIX | 0 | txlen[0] txlen[1] | 0 | REVERT_CODE_PREFIX | 0 | revert_code
-   * Assumes that isFirstField has been called already.
-   */ static decodeFirstField(field) {
-        const buf = field.toBuffer().subarray(-TX_EFFECT_PREFIX_BYTE_LENGTH);
+    toTxBlobData() {
         return {
-            length: new Fr(buf.subarray(TX_START_PREFIX_BYTES_LENGTH + 1, TX_START_PREFIX_BYTES_LENGTH + 3)).toNumber(),
-            revertCode: buf[buf.length - 1]
+            txStartMarker: this.getTxStartMarker(),
+            txHash: this.txHash.hash,
+            transactionFee: this.transactionFee,
+            noteHashes: this.noteHashes,
+            nullifiers: this.nullifiers,
+            l2ToL1Msgs: this.l2ToL1Msgs,
+            publicDataWrites: this.publicDataWrites.map((w)=>w.toBlobFields()),
+            privateLogs: this.privateLogs.map((l)=>l.toBlobFields()),
+            publicLogs: FlatPublicLogs.fromLogs(this.publicLogs).toBlobFields(),
+            contractClassLog: this.contractClassLogs.map((l)=>l.toBlobFields()).flat()
         };
     }
     /**
-   * Determines whether a field is the first field of a tx effect
-   */ static isFirstField(field) {
-        const buf = field.toBuffer();
-        if (!buf.subarray(0, field.size - TX_EFFECT_PREFIX_BYTE_LENGTH).equals(Buffer.alloc(field.size - TX_EFFECT_PREFIX_BYTE_LENGTH))) {
-            return false;
-        }
-        const sliced = buf.subarray(-TX_EFFECT_PREFIX_BYTE_LENGTH);
-        if (// Checking we start with the correct prefix...
-        !new Fr(sliced.subarray(0, TX_START_PREFIX_BYTES_LENGTH)).equals(new Fr(TX_START_PREFIX)) || // ...and include the revert code prefix..
-        sliced[sliced.length - 3] !== REVERT_CODE_PREFIX || // ...and the following revert code is valid.
-        sliced[sliced.length - 1] > 4) {
-            return false;
-        }
-        return true;
-    }
-    /**
-   * Returns a flat packed array of prefixed fields of all tx effects, used for blobs.
-   */ toBlobFields() {
-        if (this.isEmpty()) {
-            return [];
-        }
-        const flattened = [];
-        // We reassign the first field when we know the length of all effects - see below
-        flattened.push(Fr.ZERO);
-        flattened.push(this.txHash.hash);
-        // TODO: how long should tx fee be? For now, not using toPrefix()
-        flattened.push(new Fr(Buffer.concat([
-            Buffer.from([
-                TX_FEE_PREFIX
-            ]),
-            Buffer.alloc(1),
-            this.transactionFee.toBuffer().subarray(3)
-        ])));
-        if (this.noteHashes.length) {
-            flattened.push(this.toPrefix(NOTES_PREFIX, this.noteHashes.length));
-            flattened.push(...this.noteHashes);
-        }
-        if (this.nullifiers.length) {
-            flattened.push(this.toPrefix(NULLIFIERS_PREFIX, this.nullifiers.length));
-            flattened.push(...this.nullifiers);
-        }
-        if (this.l2ToL1Msgs.length) {
-            flattened.push(this.toPrefix(L2_L1_MSGS_PREFIX, this.l2ToL1Msgs.length));
-            flattened.push(...this.l2ToL1Msgs);
-        }
-        if (this.publicDataWrites.length) {
-            flattened.push(this.toPrefix(PUBLIC_DATA_UPDATE_REQUESTS_PREFIX, this.publicDataWrites.length * 2));
-            flattened.push(...this.publicDataWrites.map((w)=>[
-                    w.leafSlot,
-                    w.value
-                ]).flat());
-        }
-        if (this.privateLogs.length) {
-            const totalLogLen = this.privateLogs.reduce(// +1 for length prefix
-            (total, log)=>total + (log.getEmittedLength() == 0 ? 0 : log.getEmittedLength() + 1), 0);
-            flattened.push(this.toPrefix(PRIVATE_LOGS_PREFIX, totalLogLen));
-            flattened.push(...this.privateLogs.flatMap((l)=>[
-                    new Fr(l.getEmittedLength()),
-                    ...l.getEmittedFields()
-                ]));
-        }
-        if (this.publicLogs.length) {
-            const totalLogLen = this.publicLogs.reduce(// +1 for length prefix
-            (total, log)=>total + (log.getEmittedLength() == 0 ? 0 : log.getEmittedLength() + 1), 0);
-            flattened.push(this.toPrefix(PUBLIC_LOGS_PREFIX, totalLogLen));
-            flattened.push(...this.publicLogs.flatMap((l)=>[
-                    new Fr(l.getEmittedLength()),
-                    ...l.getEmittedFields()
-                ]));
-        }
-        if (this.contractClassLogs.length) {
-            const totalLogLen = this.contractClassLogs.reduce(// +2 for length prefix and contract address
-            (total, log)=>total + (log.getEmittedLength() == 0 ? 0 : log.getEmittedLength() + 2), 0);
-            flattened.push(this.toPrefix(CONTRACT_CLASS_LOGS_PREFIX, totalLogLen));
-            flattened.push(...this.contractClassLogs.flatMap((l)=>[
-                    new Fr(l.getEmittedLength()),
-                    l.contractAddress.toField(),
-                    ...l.getEmittedFields()
-                ]));
-        }
-        // The first value appended to each list of fields representing a tx effect is:
-        // TX_START_PREFIX | 0 | txlen[0] txlen[1] | 0 | REVERT_CODE_PREFIX | 0 | revert_code
-        // Tx start and len are to aid decomposing/ identifying when we reach a new tx effect
-        // The remaining bytes are used for revert code, since that only requires 3 bytes
-        flattened[0] = this.encodeFirstField(flattened.length, this.revertCode);
-        return flattened;
-    }
-    /**
-   * Decodes a flat packed array of prefixed fields to TxEffect
-   */ static fromBlobFields(fields) {
-        const ensureEmpty = (arr)=>{
-            if (arr.length) {
-                throw new Error('Invalid fields given to TxEffect.fromBlobFields(): Attempted to assign property twice.');
-            }
-        };
-        const effect = this.empty();
-        if (!(fields instanceof FieldReader) && !fields.length) {
-            return effect;
-        }
-        const reader = FieldReader.asReader(fields);
-        const firstField = reader.readField();
-        if (!this.isFirstField(firstField)) {
-            throw new Error('Invalid fields given to TxEffect.fromBlobFields(): First field invalid.');
-        }
-        const { length: _, revertCode } = this.decodeFirstField(firstField);
-        effect.revertCode = RevertCode.fromField(new Fr(revertCode));
-        effect.txHash = new TxHash(reader.readField());
-        // TODO: how long should tx fee be? For now, not using fromPrefix()
-        const prefixedFee = reader.readField();
-        // NB: Fr.fromBuffer hangs here if you provide a buffer less than 32 in len
-        // todo: try new Fr(prefixedFee.toBuffer().subarray(3))
-        effect.transactionFee = Fr.fromBuffer(Buffer.concat([
-            Buffer.alloc(3),
-            prefixedFee.toBuffer().subarray(3)
-        ]));
-        while(!reader.isFinished()){
-            const { type, length } = this.fromPrefix(reader.readField());
-            switch(type){
-                case NOTES_PREFIX:
-                    ensureEmpty(effect.noteHashes);
-                    effect.noteHashes = reader.readFieldArray(length);
-                    break;
-                case NULLIFIERS_PREFIX:
-                    ensureEmpty(effect.nullifiers);
-                    effect.nullifiers = reader.readFieldArray(length);
-                    break;
-                case L2_L1_MSGS_PREFIX:
-                    ensureEmpty(effect.l2ToL1Msgs);
-                    effect.l2ToL1Msgs = reader.readFieldArray(length);
-                    break;
-                case PUBLIC_DATA_UPDATE_REQUESTS_PREFIX:
-                    {
-                        ensureEmpty(effect.publicDataWrites);
-                        const publicDataPairs = reader.readFieldArray(length);
-                        for(let i = 0; i < length; i += 2){
-                            effect.publicDataWrites.push(new PublicDataWrite(publicDataPairs[i], publicDataPairs[i + 1]));
-                        }
-                        break;
-                    }
-                case PRIVATE_LOGS_PREFIX:
-                    {
-                        ensureEmpty(effect.privateLogs);
-                        const flatPrivateLogs = reader.readFieldArray(length);
-                        let i = 0;
-                        while(i < length){
-                            const logLen = flatPrivateLogs[i++].toNumber();
-                            const logFields = flatPrivateLogs.slice(i, i += logLen);
-                            effect.privateLogs.push(PrivateLog.fromFields(logFields.concat(new Array(PRIVATE_LOG_SIZE_IN_FIELDS - logLen).fill(Fr.ZERO))));
-                        }
-                        break;
-                    }
-                case PUBLIC_LOGS_PREFIX:
-                    {
-                        ensureEmpty(effect.publicLogs);
-                        const flatPublicLogs = reader.readFieldArray(length);
-                        let i = 0;
-                        while(i < length){
-                            const logLen = flatPublicLogs[i++].toNumber();
-                            const logFields = flatPublicLogs.slice(i, i += logLen);
-                            effect.publicLogs.push(PublicLog.fromFields(logFields.concat(new Array(PUBLIC_LOG_SIZE_IN_FIELDS - logLen).fill(Fr.ZERO))));
-                        }
-                        break;
-                    }
-                case CONTRACT_CLASS_LOGS_PREFIX:
-                    {
-                        ensureEmpty(effect.contractClassLogs);
-                        const flatContractClassLogs = reader.readFieldArray(length);
-                        let i = 0;
-                        while(i < length){
-                            const logLen = flatContractClassLogs[i++].toNumber();
-                            // +1 for address
-                            const logFields = flatContractClassLogs.slice(i, i += logLen + 1);
-                            effect.contractClassLogs.push(ContractClassLog.fromFields(logFields.concat(new Array(CONTRACT_CLASS_LOG_SIZE_IN_FIELDS - logLen).fill(Fr.ZERO))));
-                        }
-                        break;
-                    }
-                case REVERT_CODE_PREFIX:
-                default:
-                    throw new Error(`Too many fields to decode given to TxEffect.fromBlobFields()`);
-            }
-        }
-        return effect;
+   * Decodes a flat packed array of fields to TxEffect.
+   */ static fromTxBlobData(txBlobData) {
+        const txStartMarker = txBlobData.txStartMarker;
+        const revertCode = RevertCode.fromNumber(txStartMarker.revertCode);
+        const txHash = new TxHash(txBlobData.txHash);
+        const transactionFee = txBlobData.transactionFee;
+        const noteHashes = txBlobData.noteHashes;
+        const nullifiers = txBlobData.nullifiers;
+        const l2ToL1Msgs = txBlobData.l2ToL1Msgs;
+        const publicDataWrites = txBlobData.publicDataWrites.map((w)=>PublicDataWrite.fromBlobFields(w));
+        const privateLogs = txBlobData.privateLogs.map((l)=>PrivateLog.fromBlobFields(l.length, l));
+        const publicLogs = FlatPublicLogs.fromBlobFields(txStartMarker.publicLogsLength, txBlobData.publicLogs).toLogs();
+        const contractClassLogs = txStartMarker.contractClassLogLength > 0 ? [
+            ContractClassLog.fromBlobFields(txStartMarker.contractClassLogLength, txBlobData.contractClassLog)
+        ] : [];
+        return TxEffect.from({
+            revertCode,
+            txHash,
+            transactionFee,
+            noteHashes,
+            nullifiers,
+            l2ToL1Msgs,
+            publicDataWrites,
+            privateLogs,
+            publicLogs,
+            contractClassLogs
+        });
     }
     static from(fields) {
         return new TxEffect(fields.revertCode, fields.txHash, fields.transactionFee, fields.noteHashes, fields.nullifiers, fields.l2ToL1Msgs, fields.publicDataWrites, fields.privateLogs, fields.publicLogs, fields.contractClassLogs);
@@ -417,18 +227,18 @@ export class TxEffect {
             contractClassLogs: z.array(ContractClassLog.schema)
         }).transform(TxEffect.from);
     }
-    [inspect.custom]() {
+    [_computedKey]() {
         return `TxEffect {
-      revertCode: ${this.revertCode},
+      revertCode: ${this.revertCode.getCode()},
       txHash: ${this.txHash},
       transactionFee: ${this.transactionFee},
       note hashes: [${this.noteHashes.map((h)=>h.toString()).join(', ')}],
       nullifiers: [${this.nullifiers.map((h)=>h.toString()).join(', ')}],
       l2ToL1Msgs: [${this.l2ToL1Msgs.map((h)=>h.toString()).join(', ')}],
       publicDataWrites: [${this.publicDataWrites.map((h)=>h.toString()).join(', ')}],
-      privateLogs: [${this.privateLogs.map((l)=>l.toString()).join(', ')}],
-      publicLogs: [${this.publicLogs.map((l)=>l.toString()).join(', ')}],
-      contractClassLogs: [${this.contractClassLogs.map((l)=>l.toString()).join(', ')}],
+      privateLogs: [${this.privateLogs.map((l)=>l.fields.map((f)=>f.toString()).join(',')).join(', ')}],
+      publicLogs: ${inspect(this.publicLogs)},
+      contractClassLogs: [${this.contractClassLogs.map((l)=>l.toFields().map((f)=>f.toString()).join(',')).join(', ')}],
      }`;
     }
     /**

package/dest/tx/tx_execution_request.d.ts

@@ -1,7 +1,4 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-import { Fr } from '@aztec/foundation/fields';
+import { Fr } from '@aztec/foundation/curves/bn254';
 import { BufferReader } from '@aztec/foundation/serialize';
 import type { FieldsOf } from '@aztec/foundation/types';
 import { inspect } from 'util';
@@ -49,6 +46,11 @@ export declare class TxExecutionRequest {
      * Read-only data passed through the oracle calls during this tx execution.
      */
     capsules: Capsule[];
+    /**
+     * A salt to make the tx request hash difficult to predict.
+     * The hash is used as the first nullifier if there is no nullifier emitted throughout the tx.
+     */
+    salt: Fr;
     constructor(
     /**
      * Sender.
@@ -81,16 +83,21 @@ export declare class TxExecutionRequest {
     /**
      * Read-only data passed through the oracle calls during this tx execution.
      */
-    capsules: Capsule[]);
+    capsules: Capsule[], 
+    /**
+     * A salt to make the tx request hash difficult to predict.
+     * The hash is used as the first nullifier if there is no nullifier emitted throughout the tx.
+     */
+    salt?: Fr);
     static get schema(): ZodFor<TxExecutionRequest>;
     toTxRequest(): TxRequest;
-    static getFields(fields: FieldsOf<TxExecutionRequest>): readonly [AztecAddress, FunctionSelector, Fr, TxContext, HashedValues[], AuthWitness[], Capsule[]];
+    static getFields(fields: FieldsOf<TxExecutionRequest>): readonly [AztecAddress, FunctionSelector, Fr, TxContext, HashedValues[], AuthWitness[], Capsule[], Fr];
     static from(fields: FieldsOf<TxExecutionRequest>): TxExecutionRequest;
     /**
      * Serialize as a buffer.
      * @returns The buffer.
      */
-    toBuffer(): Buffer;
+    toBuffer(): Buffer<ArrayBufferLike>;
     /**
      * Serialize as a string.
      * @returns The string.
@@ -111,4 +118,4 @@ export declare class TxExecutionRequest {
     static random(): Promise<TxExecutionRequest>;
     [inspect.custom](): string;
 }
-//# sourceMappingURL=tx_execution_request.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHhfZXhlY3V0aW9uX3JlcXVlc3QuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90eC90eF9leGVjdXRpb25fcmVxdWVzdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDcEQsT0FBTyxFQUFFLFlBQVksRUFBcUIsTUFBTSw2QkFBNkIsQ0FBQztBQUU5RSxPQUFPLEtBQUssRUFBRSxRQUFRLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUV4RCxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sTUFBTSxDQUFDO0FBRy9CLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQy9ELE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUM5RCxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDekQsT0FBTyxFQUFFLEtBQUssTUFBTSxFQUFXLE1BQU0scUJBQXFCLENBQUM7QUFFM0QsT0FBTyxFQUFFLE9BQU8sRUFBRSxNQUFNLGNBQWMsQ0FBQztBQUV2QyxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDbEQsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBQzVDLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUU1Qzs7R0FFRztBQUVILHFCQUFhLGtCQUFrQjtJQUUzQjs7T0FFRztJQUNJLE1BQU0sRUFBRSxZQUFZO0lBQzNCOztPQUVHO0lBQ0ksZ0JBQWdCLEVBQUUsZ0JBQWdCO0lBQ3pDOzs7T0FHRztJQUNJLGlCQUFpQixFQUFFLEVBQUU7SUFDNUI7O09BRUc7SUFDSSxTQUFTLEVBQUUsU0FBUztJQUMzQjs7OztPQUlHO0lBQ0ksV0FBVyxFQUFFLFlBQVksRUFBRTtJQUNsQzs7O09BR0c7SUFDSSxhQUFhLEVBQUUsV0FBVyxFQUFFO0lBQ25DOztPQUVHO0lBQ0ksUUFBUSxFQUFFLE9BQU8sRUFBRTtJQUMxQjs7O09BR0c7SUFDSSxJQUFJO0lBckNiO0lBQ0U7O09BRUc7SUFDSSxNQUFNLEVBQUUsWUFBWTtJQUMzQjs7T0FFRztJQUNJLGdCQUFnQixFQUFFLGdCQUFnQjtJQUN6Qzs7O09BR0c7SUFDSSxpQkFBaUIsRUFBRSxFQUFFO0lBQzVCOztPQUVHO0lBQ0ksU0FBUyxFQUFFLFNBQVM7SUFDM0I7Ozs7T0FJRztJQUNJLFdBQVcsRUFBRSxZQUFZLEVBQUU7SUFDbEM7OztPQUdHO0lBQ0ksYUFBYSxFQUFFLFdBQVcsRUFBRTtJQUNuQzs7T0FFRztJQUNJLFFBQVEsRUFBRSxPQUFPLEVBQUU7SUFDMUI7OztPQUdHO0lBQ0ksSUFBSSxLQUFjLEVBQ3ZCO0lBR0osTUFBTSxLQUFLLE1BQU0sSUFBSSxNQUFNLENBQUMsa0JBQWtCLENBQUMsQ0FhOUM7SUFFRCxXQUFXLElBQUksU0FBUyxDQVN2QjtJQUVELE1BQU0sQ0FBQyxTQUFTLENBQUMsTUFBTSxFQUFFLFFBQVEsQ0FBQyxrQkFBa0IsQ0FBQywwR0FXcEQ7SUFFRCxNQUFNLENBQUMsSUFBSSxDQUFDLE1BQU0sRUFBRSxRQUFRLENBQUMsa0JBQWtCLENBQUMsR0FBRyxrQkFBa0IsQ0FFcEU7SUFFRDs7O09BR0c7SUFDSCxRQUFRLDRCQVdQO0lBRUQ7OztPQUdHO0lBQ0gsUUFBUSxrQkFFUDtJQUVEOzs7O09BSUc7SUFDSCxNQUFNLENBQUMsVUFBVSxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsWUFBWSxHQUFHLGtCQUFrQixDQVluRTtJQUVEOzs7O09BSUc7SUFDSCxNQUFNLENBQUMsVUFBVSxDQUFDLEdBQUcsRUFBRSxNQUFNLEdBQUcsa0JBQWtCLENBRWpEO0lBRUQsT0FBYSxNQUFNLGdDQWNsQjtJQUVELENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxXQUVmO0NBQ0YifQ==

package/dest/tx/tx_execution_request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tx_execution_request.d.ts","sourceRoot":"","sources":["../../src/tx/tx_execution_request.ts"],"names":[],"mappings":";;;AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAE9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAG/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;GAEG;AACH,qBAAa,kBAAkB;IAE3B;;OAEG;IACI,MAAM,EAAE,YAAY;IAC3B;;OAEG;IACI,gBAAgB,EAAE,gBAAgB;IACzC;;;OAGG;IACI,iBAAiB,EAAE,EAAE;IAC5B;;OAEG;IACI,SAAS,EAAE,SAAS;IAC3B;;;;OAIG;IACI,WAAW,EAAE,YAAY,EAAE;IAClC;;;OAGG;IACI,aAAa,EAAE,WAAW,EAAE;IACnC;;OAEG;IACI,QAAQ,EAAE,OAAO,EAAE;;IA/B1B;;OAEG;IACI,MAAM,EAAE,YAAY;IAC3B;;OAEG;IACI,gBAAgB,EAAE,gBAAgB;IACzC;;;OAGG;IACI,iBAAiB,EAAE,EAAE;IAC5B;;OAEG;IACI,SAAS,EAAE,SAAS;IAC3B;;;;OAIG;IACI,WAAW,EAAE,YAAY,EAAE;IAClC;;;OAGG;IACI,aAAa,EAAE,WAAW,EAAE;IACnC;;OAEG;IACI,QAAQ,EAAE,OAAO,EAAE;IAG5B,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,kBAAkB,CAAC,CAY9C;IAED,WAAW,IAAI,SAAS;IAUxB,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC;IAYrD,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,kBAAkB;IAIrE;;;OAGG;IACH,QAAQ;IAYR;;;OAGG;IACH,QAAQ;IAIR;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,kBAAkB;IAapE;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB;WAIrC,MAAM;IAenB,CAAC,OAAO,CAAC,MAAM,CAAC;CAGjB"}
+{"version":3,"file":"tx_execution_request.d.ts","sourceRoot":"","sources":["../../src/tx/tx_execution_request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAE9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAG/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;GAEG;AAEH,qBAAa,kBAAkB;IAE3B;;OAEG;IACI,MAAM,EAAE,YAAY;IAC3B;;OAEG;IACI,gBAAgB,EAAE,gBAAgB;IACzC;;;OAGG;IACI,iBAAiB,EAAE,EAAE;IAC5B;;OAEG;IACI,SAAS,EAAE,SAAS;IAC3B;;;;OAIG;IACI,WAAW,EAAE,YAAY,EAAE;IAClC;;;OAGG;IACI,aAAa,EAAE,WAAW,EAAE;IACnC;;OAEG;IACI,QAAQ,EAAE,OAAO,EAAE;IAC1B;;;OAGG;IACI,IAAI;IArCb;IACE;;OAEG;IACI,MAAM,EAAE,YAAY;IAC3B;;OAEG;IACI,gBAAgB,EAAE,gBAAgB;IACzC;;;OAGG;IACI,iBAAiB,EAAE,EAAE;IAC5B;;OAEG;IACI,SAAS,EAAE,SAAS;IAC3B;;;;OAIG;IACI,WAAW,EAAE,YAAY,EAAE;IAClC;;;OAGG;IACI,aAAa,EAAE,WAAW,EAAE;IACnC;;OAEG;IACI,QAAQ,EAAE,OAAO,EAAE;IAC1B;;;OAGG;IACI,IAAI,KAAc,EACvB;IAGJ,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,kBAAkB,CAAC,CAa9C;IAED,WAAW,IAAI,SAAS,CASvB;IAED,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,0GAWpD;IAED,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAEpE;IAED;;;OAGG;IACH,QAAQ,4BAWP;IAED;;;OAGG;IACH,QAAQ,kBAEP;IAED;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,kBAAkB,CAYnE;IAED;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAEjD;IAED,OAAa,MAAM,gCAclB;IAED,CAAC,OAAO,CAAC,MAAM,CAAC,WAEf;CACF"}

package/dest/tx/tx_execution_request.js

@@ -1,4 +1,5 @@
-import { Fr } from '@aztec/foundation/fields';
+var _computedKey;
+import { Fr } from '@aztec/foundation/curves/bn254';
 import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
 import { bufferToHex, hexToBuffer } from '@aztec/foundation/string';
 import { inspect } from 'util';
@@ -13,9 +14,11 @@ import { FunctionData } from './function_data.js';
 import { HashedValues } from './hashed_values.js';
 import { TxContext } from './tx_context.js';
 import { TxRequest } from './tx_request.js';
+_computedKey = inspect.custom;
 /**
  * Request to execute a transaction. Similar to TxRequest, but has the full args.
- */ export class TxExecutionRequest {
+ */ // docs:start:tx_execution_request_class
+export class TxExecutionRequest {
     origin;
     functionSelector;
     firstCallArgsHash;
@@ -23,6 +26,7 @@ import { TxRequest } from './tx_request.js';
     argsOfCalls;
     authWitnesses;
     capsules;
+    salt;
     constructor(/**
      * Sender.
      */ origin, /**
@@ -41,7 +45,10 @@ import { TxRequest } from './tx_request.js';
      * These witnesses are not expected to be stored in the local witnesses database of the PXE.
      */ authWitnesses, /**
      * Read-only data passed through the oracle calls during this tx execution.
-     */ capsules){
+     */ capsules, /**
+     * A salt to make the tx request hash difficult to predict.
+     * The hash is used as the first nullifier if there is no nullifier emitted throughout the tx.
+     */ salt = Fr.random()){
         this.origin = origin;
         this.functionSelector = functionSelector;
         this.firstCallArgsHash = firstCallArgsHash;
@@ -49,7 +56,9 @@ import { TxRequest } from './tx_request.js';
         this.argsOfCalls = argsOfCalls;
         this.authWitnesses = authWitnesses;
         this.capsules = capsules;
+        this.salt = salt;
     }
+    // docs:end:tx_execution_request_class
     static get schema() {
         return z.object({
             origin: schemas.AztecAddress,
@@ -58,12 +67,13 @@ import { TxRequest } from './tx_request.js';
             txContext: TxContext.schema,
             argsOfCalls: z.array(HashedValues.schema),
             authWitnesses: z.array(AuthWitness.schema),
-            capsules: z.array(Capsule.schema)
+            capsules: z.array(Capsule.schema),
+            salt: schemas.Fr
         }).transform(TxExecutionRequest.from);
     }
     toTxRequest() {
-        return new TxRequest(this.origin, // Entrypoints must be private as as defined by the protocol.
-        new FunctionData(this.functionSelector, true), this.firstCallArgsHash, this.txContext);
+        return new TxRequest(this.origin, this.firstCallArgsHash, this.txContext, // Entrypoints must be private as defined by the protocol.
+        new FunctionData(this.functionSelector, true), this.salt);
     }
     static getFields(fields) {
         return [
@@ -73,7 +83,8 @@ import { TxRequest } from './tx_request.js';
             fields.txContext,
             fields.argsOfCalls,
             fields.authWitnesses,
-            fields.capsules
+            fields.capsules,
+            fields.salt
         ];
     }
     static from(fields) {
@@ -83,7 +94,7 @@ import { TxRequest } from './tx_request.js';
    * Serialize as a buffer.
    * @returns The buffer.
    */ toBuffer() {
-        return serializeToBuffer(this.origin, this.functionSelector, this.firstCallArgsHash, this.txContext, new Vector(this.argsOfCalls), new Vector(this.authWitnesses), new Vector(this.capsules));
+        return serializeToBuffer(this.origin, this.functionSelector, this.firstCallArgsHash, this.txContext, new Vector(this.argsOfCalls), new Vector(this.authWitnesses), new Vector(this.capsules), this.salt);
     }
     /**
    * Serialize as a string.
@@ -97,7 +108,7 @@ import { TxRequest } from './tx_request.js';
    * @returns The deserialized TxRequest object.
    */ static fromBuffer(buffer) {
         const reader = BufferReader.asReader(buffer);
-        return new TxExecutionRequest(reader.readObject(AztecAddress), reader.readObject(FunctionSelector), Fr.fromBuffer(reader), reader.readObject(TxContext), reader.readVector(HashedValues), reader.readVector(AuthWitness), reader.readVector(Capsule));
+        return new TxExecutionRequest(reader.readObject(AztecAddress), reader.readObject(FunctionSelector), Fr.fromBuffer(reader), reader.readObject(TxContext), reader.readVector(HashedValues), reader.readVector(AuthWitness), reader.readVector(Capsule), Fr.fromBuffer(reader));
     }
     /**
    * Deserializes from a string, corresponding to a write in cpp.
@@ -108,7 +119,7 @@ import { TxRequest } from './tx_request.js';
     }
     static async random() {
         return new TxExecutionRequest(await AztecAddress.random(), FunctionSelector.random(), Fr.random(), TxContext.empty(), [
-            await HashedValues.random()
+            HashedValues.random()
         ], [
             AuthWitness.random()
         ], [
@@ -119,9 +130,9 @@ import { TxRequest } from './tx_request.js';
             new Capsule(await AztecAddress.random(), Fr.random(), [
                 Fr.random()
             ])
-        ]);
+        ], Fr.random());
     }
-    [inspect.custom]() {
+    [_computedKey]() {
         return `TxExecutionRequest(${this.origin} called ${this.functionSelector})`;
     }
 }

package/dest/tx/tx_hash.d.ts

@@ -1,9 +1,8 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
-import { Fr } from '@aztec/foundation/fields';
+import { Fr } from '@aztec/foundation/curves/bn254';
 import { BufferReader } from '@aztec/foundation/serialize';
 /**
  * A class representing hash of Aztec transaction.
+ * @dev Computed by hashing the public inputs of the private kernel tail circuit (see Tx::getTxHash function).
  */
 export declare class TxHash {
     /** A field representing the tx hash (tx hash is an output of poseidon hash hence it's a field). */
@@ -15,13 +14,21 @@ export declare class TxHash {
     static fromBuffer(buffer: Uint8Array | BufferReader): TxHash;
     static fromString(str: string): TxHash;
     static fromBigInt(value: bigint): TxHash;
-    toBuffer(): Buffer;
+    static fromField(value: Fr): TxHash;
+    toBuffer(): Buffer<ArrayBufferLike>;
     toString(): `0x${string}`;
     toBigInt(): bigint;
     toJSON(): `0x${string}`;
     equals(other: TxHash): boolean;
-    static get schema(): import("zod").ZodEffects<import("zod").ZodEffects<import("zod").ZodEffects<import("zod").ZodEffects<import("zod").ZodString, string, string>, string, string>, Buffer, string>, TxHash, string>;
+    static get schema(): import("zod").ZodEffects<import("zod").ZodEffects<import("zod").ZodEffects<import("zod").ZodEffects<import("zod").ZodString, string, string>, string, string>, Buffer<ArrayBuffer>, string>, TxHash, string>;
     static zero(): TxHash;
     static get SIZE(): number;
 }
-//# sourceMappingURL=tx_hash.d.ts.map
+/**
+ * Helper class to handle Serialization and Deserialization of TxHashes array.
+ **/
+export declare class TxHashArray extends Array<TxHash> {
+    static fromBuffer(buffer: Buffer | BufferReader): TxHashArray;
+    toBuffer(): Buffer;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHhfaGFzaC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3R4L3R4X2hhc2gudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQ3BELE9BQU8sRUFBRSxZQUFZLEVBQXNDLE1BQU0sNkJBQTZCLENBQUM7QUFJL0Y7OztHQUdHO0FBQ0gscUJBQWEsTUFBTTtJQUVmLG1HQUFtRzthQUNuRixJQUFJLEVBQUUsRUFBRTtJQUYxQjtJQUNFLG1HQUFtRztJQUNuRixJQUFJLEVBQUUsRUFBRSxFQUN0QjtJQUVKLE1BQU0sQ0FBQyxNQUFNLFdBRVo7SUFFRCxNQUFNLENBQUMsVUFBVSxDQUFDLE1BQU0sRUFBRSxVQUFVLEdBQUcsWUFBWSxVQUdsRDtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sVUFFNUI7SUFFRCxNQUFNLENBQUMsVUFBVSxDQUFDLEtBQUssRUFBRSxNQUFNLFVBRTlCO0lBRUQsTUFBTSxDQUFDLFNBQVMsQ0FBQyxLQUFLLEVBQUUsRUFBRSxVQUV6QjtJQUVNLFFBQVEsNEJBRWQ7SUFFTSxRQUFRLGtCQUVkO0lBRU0sUUFBUSxXQUVkO0lBRUQsTUFBTSxrQkFFTDtJQUVNLE1BQU0sQ0FBQyxLQUFLLEVBQUUsTUFBTSxXQUUxQjtJQUVELE1BQU0sS0FBSyxNQUFNLGlOQUVoQjtJQUVELE1BQU0sQ0FBQyxJQUFJLFdBRVY7SUFFRCxNQUFNLEtBQUssSUFBSSxXQUVkO0NBQ0Y7QUFFRDs7SUFFSTtBQUNKLHFCQUFhLFdBQVksU0FBUSxLQUFLLENBQUMsTUFBTSxDQUFDO0lBQzVDLE1BQU0sQ0FBQyxVQUFVLENBQUMsTUFBTSxFQUFFLE1BQU0sR0FBRyxZQUFZLGVBUzlDO0lBRU0sUUFBUSxJQUFJLE1BQU0sQ0FFeEI7Q0FDRiJ9