@aztec/stdlib 0.0.0-test.1 → 0.0.1-commit.017a351

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

@@ -1 +1 @@
-{"version":3,"file":"tx_hash.d.ts","sourceRoot":"","sources":["../../src/tx/tx_hash.ts"],"names":[],"mappings":";;AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAI3D;;GAEG;AACH,qBAAa,MAAM;IAEf,mGAAmG;aACnF,IAAI,EAAE,EAAE;;IADxB,mGAAmG;IACnF,IAAI,EAAE,EAAE;IAO1B,MAAM,CAAC,MAAM;IAIb,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY;IAKnD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM;IAI7B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM;IAIxB,QAAQ;IAIR,QAAQ;IAIR,QAAQ;IAIf,MAAM;IAIC,MAAM,CAAC,KAAK,EAAE,MAAM;IAI3B,MAAM,KAAK,MAAM,oMAEhB;IAED,MAAM,CAAC,IAAI;IAIX,MAAM,KAAK,IAAI,WAEd;CACF"}
+{"version":3,"file":"tx_hash.d.ts","sourceRoot":"","sources":["../../src/tx/tx_hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EACL,YAAY,EACZ,KAAK,UAAU,EAGhB,MAAM,6BAA6B,CAAC;AAIrC;;;GAGG;AACH,qBAAa,MAAM;IAEf,mGAAmG;aACnF,IAAI,EAAE,EAAE;IAF1B;IACE,mGAAmG;IACnF,IAAI,EAAE,EAAE,EACtB;IAEJ,MAAM,CAAC,MAAM,WAEZ;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY,UAGlD;IAED,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,UAE5B;IAED,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,UAE9B;IAED,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,UAEzB;IAEM,QAAQ,IAAI,MAAM,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAQjC,QAAQ,kBAEd;IAEM,QAAQ,WAEd;IAED,MAAM,kBAEL;IAEM,MAAM,CAAC,KAAK,EAAE,MAAM,WAE1B;IAED,MAAM,KAAK,MAAM,+PAEhB;IAED,MAAM,CAAC,IAAI,WAEV;IAED,MAAM,KAAK,IAAI,WAEd;CACF;AAED;;IAEI;AACJ,qBAAa,WAAY,SAAQ,KAAK,CAAC,MAAM,CAAC;IAC5C,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,eAS9C;IAEM,QAAQ,IAAI,MAAM,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CAOzC"}

package/dest/tx/tx_hash.js

@@ -1,17 +1,15 @@
-import { Fr } from '@aztec/foundation/fields';
-import { BufferReader } from '@aztec/foundation/serialize';
+import { Fr } from '@aztec/foundation/curves/bn254';
+import { BufferReader, serializeArrayOfBufferableToVector, serializeArrayToSink } from '@aztec/foundation/serialize';
 import { schemas } from '../schemas/index.js';
 /**
  * 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 class TxHash {
     hash;
     constructor(/** A field representing the tx hash (tx hash is an output of poseidon hash hence it's a field). */ hash){
         this.hash = hash;
     }
-    /*
-   * TxHashes are generated from the first nullifier of a transaction, which is a Fr.
-   * @returns A random TxHash.
-   */ static random() {
+    static random() {
         return new TxHash(Fr.random());
     }
     static fromBuffer(buffer) {
@@ -24,8 +22,14 @@ import { schemas } from '../schemas/index.js';
     static fromBigInt(value) {
         return new TxHash(new Fr(value));
     }
-    toBuffer() {
-        return this.hash.toBuffer();
+    static fromField(value) {
+        return new TxHash(value);
+    }
+    toBuffer(sink) {
+        if (!sink) {
+            return this.hash.toBuffer();
+        }
+        this.hash.toBuffer(sink);
     }
     toString() {
         return this.hash.toString();
@@ -49,3 +53,26 @@ import { schemas } from '../schemas/index.js';
         return Fr.SIZE_IN_BYTES;
     }
 }
+/**
+ * Helper class to handle Serialization and Deserialization of TxHashes array.
+ **/ export class TxHashArray extends Array {
+    static fromBuffer(buffer) {
+        try {
+            const reader = BufferReader.asReader(buffer);
+            const hashes = reader.readVector(TxHash);
+            return new TxHashArray(...hashes);
+        } catch  {
+            return new TxHashArray();
+        }
+    }
+    toBuffer(sink) {
+        if (!sink) {
+            return serializeArrayOfBufferableToVector([
+                ...this
+            ]);
+        }
+        serializeArrayToSink(sink, [
+            ...this
+        ]);
+    }
+}

package/dest/tx/tx_receipt.d.ts

@@ -1,83 +1,183 @@
-import type { Fr } from '@aztec/foundation/fields';
-import type { FieldsOf } from '@aztec/foundation/types';
-import { PublicDataWrite } from '../avm/public_data_write.js';
+import { BlockNumber, EpochNumber, SlotNumber } from '@aztec/foundation/branded-types';
+import type { DefineIfFlag, FieldsOf, PickDefined } from '@aztec/foundation/types';
 import { RevertCode } from '../avm/revert_code.js';
-import { L2BlockHash } from '../block/block_hash.js';
+import { BlockHash } from '../block/block_hash.js';
+import { DebugLog } from '../logs/debug_log.js';
 import { type ZodFor } from '../schemas/schemas.js';
+import { Tx } from './tx.js';
+import { TxEffect } from './tx_effect.js';
 import { TxHash } from './tx_hash.js';
-/**
- * Possible status of a transaction.
- */
+/** Block inclusion/finalization status. */
 export declare enum TxStatus {
     DROPPED = "dropped",
     PENDING = "pending",
+    PROPOSED = "proposed",
+    CHECKPOINTED = "checkpointed",
+    PROVEN = "proven",
+    FINALIZED = "finalized"
+}
+/** Tx status sorted by finalization progress. */
+export declare const SortedTxStatuses: TxStatus[];
+/** The four statuses a mined transaction can hold, ordered by finalization progress. */
+export declare const MinedTxStatuses: readonly [TxStatus.PROPOSED, TxStatus.CHECKPOINTED, TxStatus.PROVEN, TxStatus.FINALIZED];
+/** Block finalization status of a mined transaction. */
+export type MinedTxStatus = (typeof MinedTxStatuses)[number];
+/** Execution result - only set when tx is in a block. */
+export declare enum TxExecutionResult {
     SUCCESS = "success",
-    APP_LOGIC_REVERTED = "app_logic_reverted",
-    TEARDOWN_REVERTED = "teardown_reverted",
-    BOTH_REVERTED = "both_reverted"
+    REVERTED = "reverted"
 }
-/**
- * Represents a transaction receipt in the Aztec network.
- * Contains essential information about the transaction including its status, origin, and associated addresses.
- * REFACTOR: TxReceipt should be returned only once the tx is mined, and all its fields should be required.
- * We should not be using a TxReceipt to answer a query for a pending or dropped tx.
- */
-export declare class TxReceipt {
-    /** A unique identifier for a transaction. */
-    txHash: TxHash;
-    /** The transaction's status. */
+/** Returned from a `getTxReceipt` call to the node RPC API. */
+export interface TxReceiptInterface {
+    /** The transaction's block finalization status. */
     status: TxStatus;
-    /** Description of transaction error, if any. */
-    error: string;
+    /** The execution result of the transaction, only set when the tx is in a block. */
+    executionResult?: TxExecutionResult;
+    /** Description of the transaction error, if any. */
+    error?: string;
     /** The transaction fee paid for the transaction. */
-    transactionFee?: bigint | undefined;
+    transactionFee?: bigint;
     /** The hash of the block containing the transaction. */
-    blockHash?: L2BlockHash | undefined;
+    blockHash?: BlockHash;
     /** The block number in which the transaction was included. */
-    blockNumber?: number | undefined;
-    /** Information useful for testing/debugging, set when test flag is set to true in `waitOpts`. */
-    debugInfo?: DebugInfo | undefined;
+    blockNumber?: BlockNumber;
+    /** The slot number in which the transaction's block was built. */
+    slotNumber?: SlotNumber;
+    /** The epoch number in which the transaction was included. */
+    epochNumber?: EpochNumber;
+    /** The index of the transaction within its block. */
+    txIndexInBlock?: number;
+    /** The full transaction effect, attached when requested via `includeTxEffect`. */
+    txEffect?: TxEffect;
+    /** The pending transaction, attached when requested via `includePendingTx`. */
+    tx?: Tx;
+    /**
+     * Debug logs collected during public function execution. Served only when the node is in test mode and placed on
+     * the receipt only because it's a convenient place for it (the logs are printed out by the wallet when a mined
+     * tx receipt is obtained).
+     */
+    debugLogs?: DebugLog[];
+    /** Returns true (and narrows) if the transaction has been included in a block. */
+    isMined(): this is MinedTxReceipt;
+    /** Returns true (and narrows) if the transaction is pending. */
+    isPending(): this is PendingTxReceipt;
+    /** Returns true (and narrows) if the transaction was dropped. */
+    isDropped(): this is DroppedTxReceipt;
+    /** Returns true if the transaction was executed successfully. */
+    hasExecutionSucceeded(): boolean;
+    /** Returns true if the transaction execution reverted. */
+    hasExecutionReverted(): boolean;
+}
+/**
+ * Common surface shared by every transaction receipt variant ({@link PendingTxReceipt}, {@link DroppedTxReceipt},
+ * {@link MinedTxReceipt}).
+ *
+ * Every cross-variant field is declared once here, optional except for `txHash` (always present) and `status`
+ * (abstract, narrowed by each subclass). Declaring the fields optional on the base lets callers read a bare
+ * {@link TxReceipt} union (without first narrowing) and keep compiling. Use the `is*` guards to narrow to the strong
+ * variant type and gain access to its required fields.
+ */
+declare abstract class TxReceiptBase {
+    /** A unique identifier for a transaction. */
+    readonly txHash: TxHash;
+    /** The transaction's block finalization status. */
+    abstract readonly status: TxStatus;
+    /** Description of the transaction error, if any. */
+    readonly error?: string;
     constructor(
     /** A unique identifier for a transaction. */
-    txHash: TxHash, 
-    /** The transaction's status. */
-    status: TxStatus, 
-    /** Description of transaction error, if any. */
-    error: string, 
-    /** The transaction fee paid for the transaction. */
-    transactionFee?: bigint | undefined, 
-    /** The hash of the block containing the transaction. */
-    blockHash?: L2BlockHash | undefined, 
-    /** The block number in which the transaction was included. */
-    blockNumber?: number | undefined, 
-    /** Information useful for testing/debugging, set when test flag is set to true in `waitOpts`. */
-    debugInfo?: DebugInfo | undefined);
-    static empty(): TxReceipt;
-    static get schema(): ZodFor<TxReceipt>;
-    static from(fields: FieldsOf<TxReceipt>): TxReceipt;
-    static statusFromRevertCode(revertCode: RevertCode): TxStatus.SUCCESS | TxStatus.APP_LOGIC_REVERTED | TxStatus.TEARDOWN_REVERTED | TxStatus.BOTH_REVERTED;
+    txHash: TxHash);
+    /** Returns true (and narrows) if the transaction has been included in a block. */
+    isMined(): this is MinedTxReceipt;
+    /** Returns true (and narrows) if the transaction is pending. */
+    isPending(): this is PendingTxReceipt;
+    /** Returns true (and narrows) if the transaction was dropped. */
+    isDropped(): this is DroppedTxReceipt;
+    /** Returns true if the transaction was executed successfully. */
+    hasExecutionSucceeded(): boolean;
+    /** Returns true if the transaction execution reverted. */
+    hasExecutionReverted(): boolean;
+}
+declare abstract class UnminedTxReceipt extends TxReceiptBase {
+    readonly executionResult: undefined;
+    readonly transactionFee: undefined;
+    readonly blockHash: undefined;
+    readonly blockNumber: undefined;
+    readonly slotNumber: undefined;
+    readonly txIndexInBlock: undefined;
+    readonly epochNumber: undefined;
+    readonly txEffect: undefined;
 }
 /**
- * Information useful for debugging/testing purposes included in the receipt when the debug flag is set to true
- * in `WaitOpts`.
+ * Receipt for a transaction that is in the mempool but not yet included in a block.
  */
-interface DebugInfo {
-    /**
-     * New note hashes created by the transaction.
-     */
-    noteHashes: Fr[];
-    /**
-     * New nullifiers created by the transaction.
-     */
-    nullifiers: Fr[];
-    /**
-     * New public data writes created by the transaction.
-     */
-    publicDataWrites: PublicDataWrite[];
-    /**
-     * New L2 to L1 messages created by the transaction.
-     */
-    l2ToL1Msgs: Fr[];
+export declare class PendingTxReceipt<Opts extends GetTxReceiptOptions = GetTxReceiptOptions> extends UnminedTxReceipt implements TxReceiptInterface {
+    /** The pending transaction, attached when requested via `includePendingTx`. */
+    readonly tx: DefineIfFlag<Opts, 'includePendingTx', Tx>;
+    readonly status = TxStatus.PENDING;
+    constructor(txHash: TxHash, 
+    /** The pending transaction, attached when requested via `includePendingTx`. */
+    tx: DefineIfFlag<Opts, 'includePendingTx', Tx>);
+    static empty(): PendingTxReceipt;
+    static from(fields: PickDefined<FieldsOf<PendingTxReceipt>>): PendingTxReceipt;
+    static get schema(): ZodFor<PendingTxReceipt>;
 }
+/**
+ * Receipt for a transaction that was dropped from the mempool without being mined.
+ */
+export declare class DroppedTxReceipt extends UnminedTxReceipt implements TxReceiptInterface {
+    readonly error?: string | undefined;
+    readonly status = TxStatus.DROPPED;
+    tx: undefined;
+    constructor(txHash: TxHash, error?: string | undefined);
+    static empty(): DroppedTxReceipt;
+    static from(fields: PickDefined<FieldsOf<DroppedTxReceipt>>): DroppedTxReceipt;
+    static get schema(): ZodFor<DroppedTxReceipt>;
+}
+/**
+ * Receipt for a transaction that has been included in a block (proposed, checkpointed, proven, or finalized).
+ * All block-related fields are required for this variant.
+ */
+export declare class MinedTxReceipt<Opts extends GetTxReceiptOptions = GetTxReceiptOptions> extends TxReceiptBase implements TxReceiptInterface {
+    readonly executionResult: TxExecutionResult;
+    readonly transactionFee: bigint;
+    readonly blockHash: BlockHash;
+    readonly blockNumber: BlockNumber;
+    readonly slotNumber: SlotNumber;
+    readonly txIndexInBlock: number;
+    readonly epochNumber: EpochNumber;
+    readonly txEffect: DefineIfFlag<Opts, 'includeTxEffect', TxEffect>;
+    debugLogs?: DebugLog[] | undefined;
+    readonly status: MinedTxStatus;
+    readonly tx: undefined;
+    constructor(txHash: TxHash, status: MinedTxStatus, executionResult: TxExecutionResult, transactionFee: bigint, blockHash: BlockHash, blockNumber: BlockNumber, slotNumber: SlotNumber, txIndexInBlock: number, epochNumber: EpochNumber, txEffect: DefineIfFlag<Opts, 'includeTxEffect', TxEffect>, debugLogs?: DebugLog[] | undefined);
+    hasExecutionSucceeded(): boolean;
+    hasExecutionReverted(): boolean;
+    static from(fields: PickDefined<FieldsOf<MinedTxReceipt>>): MinedTxReceipt;
+    static get schema(): ZodFor<MinedTxReceipt>;
+    static executionResultFromRevertCode(revertCode: RevertCode): TxExecutionResult;
+}
+/**
+ * A transaction receipt summarizing the lifecycle of a transaction in the Aztec network. Discriminated over the
+ * transaction's status: {@link PendingTxReceipt} while in the mempool, {@link DroppedTxReceipt} once dropped, and
+ * {@link MinedTxReceipt} once included in a block.
+ */
+export type TxReceipt<Opts extends GetTxReceiptOptions = GetTxReceiptOptions> = PendingTxReceipt<Opts> | DroppedTxReceipt | MinedTxReceipt<Opts>;
+/**
+ * Zod schema for {@link TxReceipt}. Each member constrains its `status` field so the union routes
+ * unambiguously, giving a deterministic serialization round-trip.
+ */
+export declare const TxReceiptSchema: ZodFor<TxReceipt>;
+/** Options controlling which optional data is attached to a {@link TxReceipt}. */
+export type GetTxReceiptOptions = {
+    /** Attach the full {@link TxEffect} (mined txs only). */
+    includeTxEffect?: boolean;
+    /** Attach the pending {@link Tx} (pending txs only). */
+    includePendingTx?: boolean;
+    /** Keep the proof on the attached pending {@link Tx}; only meaningful alongside `includePendingTx`. */
+    includeProof?: boolean;
+};
+/** Zod schema for {@link GetTxReceiptOptions}. */
+export declare const GetTxReceiptOptionsSchema: ZodFor<GetTxReceiptOptions>;
 export {};
-//# sourceMappingURL=tx_receipt.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHhfcmVjZWlwdC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3R4L3R4X3JlY2VpcHQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUNMLFdBQVcsRUFFWCxXQUFXLEVBRVgsVUFBVSxFQUVYLE1BQU0saUNBQWlDLENBQUM7QUFDekMsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLFFBQVEsRUFBRSxXQUFXLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUluRixPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDbkQsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBQ25ELE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUNoRCxPQUFPLEVBQUUsS0FBSyxNQUFNLEVBQVcsTUFBTSx1QkFBdUIsQ0FBQztBQUM3RCxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQzdCLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUMxQyxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sY0FBYyxDQUFDO0FBRXRDLDJDQUEyQztBQUMzQyxvQkFBWSxRQUFRO0lBQ2xCLE9BQU8sWUFBWTtJQUNuQixPQUFPLFlBQVk7SUFDbkIsUUFBUSxhQUFhO0lBQ3JCLFlBQVksaUJBQWlCO0lBQzdCLE1BQU0sV0FBVztJQUNqQixTQUFTLGNBQWM7Q0FDeEI7QUFFRCxpREFBaUQ7QUFDakQsZUFBTyxNQUFNLGdCQUFnQixFQUFFLFFBQVEsRUFPdEMsQ0FBQztBQUVGLHdGQUF3RjtBQUN4RixlQUFPLE1BQU0sZUFBZSwwRkFBMkYsQ0FBQztBQUV4SCx3REFBd0Q7QUFDeEQsTUFBTSxNQUFNLGFBQWEsR0FBRyxDQUFDLE9BQU8sZUFBZSxDQUFDLENBQUMsTUFBTSxDQUFDLENBQUM7QUFFN0QseURBQXlEO0FBQ3pELG9CQUFZLGlCQUFpQjtJQUMz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

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

@@ -1 +1 @@
-{"version":3,"file":"tx_receipt.d.ts","sourceRoot":"","sources":["../../src/tx/tx_receipt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAIxD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;GAEG;AACH,oBAAY,QAAQ;IAClB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,kBAAkB,uBAAuB;IACzC,iBAAiB,sBAAsB;IACvC,aAAa,kBAAkB;CAChC;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IAElB,6CAA6C;IACtC,MAAM,EAAE,MAAM;IACrB,gCAAgC;IACzB,MAAM,EAAE,QAAQ;IACvB,gDAAgD;IACzC,KAAK,EAAE,MAAM;IACpB,oDAAoD;IAC7C,cAAc,CAAC;IACtB,wDAAwD;IACjD,SAAS,CAAC;IACjB,8DAA8D;IACvD,WAAW,CAAC;IACnB,iGAAiG;IAC1F,SAAS,CAAC;;IAbjB,6CAA6C;IACtC,MAAM,EAAE,MAAM;IACrB,gCAAgC;IACzB,MAAM,EAAE,QAAQ;IACvB,gDAAgD;IACzC,KAAK,EAAE,MAAM;IACpB,oDAAoD;IAC7C,cAAc,CAAC,oBAAQ;IAC9B,wDAAwD;IACjD,SAAS,CAAC,yBAAa;IAC9B,8DAA8D;IACvD,WAAW,CAAC,oBAAQ;IAC3B,iGAAiG;IAC1F,SAAS,CAAC,uBAAW;IAG9B,MAAM,CAAC,KAAK;IAIZ,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC,CAYrC;IAED,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC;WAYzB,oBAAoB,CAAC,UAAU,EAAE,UAAU;CAa1D;AAED;;;GAGG;AACH,UAAU,SAAS;IACjB;;OAEG;IACH,UAAU,EAAE,EAAE,EAAE,CAAC;IACjB;;OAEG;IACH,UAAU,EAAE,EAAE,EAAE,CAAC;IACjB;;OAEG;IACH,gBAAgB,EAAE,eAAe,EAAE,CAAC;IACpC;;OAEG;IACH,UAAU,EAAE,EAAE,EAAE,CAAC;CAClB"}
+{"version":3,"file":"tx_receipt.d.ts","sourceRoot":"","sources":["../../src/tx/tx_receipt.ts"],"names":[],"mappings":"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"}

package/dest/tx/tx_receipt.js

@@ -1,76 +1,192 @@
+import { BlockNumberSchema, EpochNumberSchema, SlotNumberSchema } from '@aztec/foundation/branded-types';
 import { z } from 'zod';
-import { PublicDataWrite } from '../avm/public_data_write.js';
-import { RevertCode } from '../avm/revert_code.js';
-import { L2BlockHash } from '../block/block_hash.js';
+import { BlockHash } from '../block/block_hash.js';
+import { DebugLog } from '../logs/debug_log.js';
 import { schemas } from '../schemas/schemas.js';
+import { Tx } from './tx.js';
+import { TxEffect } from './tx_effect.js';
 import { TxHash } from './tx_hash.js';
-/**
- * Possible status of a transaction.
- */ export var TxStatus = /*#__PURE__*/ function(TxStatus) {
+/** Block inclusion/finalization status. */ export var TxStatus = /*#__PURE__*/ function(TxStatus) {
     TxStatus["DROPPED"] = "dropped";
     TxStatus["PENDING"] = "pending";
-    TxStatus["SUCCESS"] = "success";
-    TxStatus["APP_LOGIC_REVERTED"] = "app_logic_reverted";
-    TxStatus["TEARDOWN_REVERTED"] = "teardown_reverted";
-    TxStatus["BOTH_REVERTED"] = "both_reverted";
+    TxStatus["PROPOSED"] = "proposed";
+    TxStatus["CHECKPOINTED"] = "checkpointed";
+    TxStatus["PROVEN"] = "proven";
+    TxStatus["FINALIZED"] = "finalized";
     return TxStatus;
 }({});
+/** Tx status sorted by finalization progress. */ export const SortedTxStatuses = [
+    "dropped",
+    "pending",
+    "proposed",
+    "checkpointed",
+    "proven",
+    "finalized"
+];
+/** The four statuses a mined transaction can hold, ordered by finalization progress. */ export const MinedTxStatuses = [
+    "proposed",
+    "checkpointed",
+    "proven",
+    "finalized"
+];
+/** Execution result - only set when tx is in a block. */ export var TxExecutionResult = /*#__PURE__*/ function(TxExecutionResult) {
+    TxExecutionResult["SUCCESS"] = "success";
+    TxExecutionResult["REVERTED"] = "reverted";
+    return TxExecutionResult;
+}({});
 /**
- * Represents a transaction receipt in the Aztec network.
- * Contains essential information about the transaction including its status, origin, and associated addresses.
- * REFACTOR: TxReceipt should be returned only once the tx is mined, and all its fields should be required.
- * We should not be using a TxReceipt to answer a query for a pending or dropped tx.
- */ export class TxReceipt {
+ * Common surface shared by every transaction receipt variant ({@link PendingTxReceipt}, {@link DroppedTxReceipt},
+ * {@link MinedTxReceipt}).
+ *
+ * Every cross-variant field is declared once here, optional except for `txHash` (always present) and `status`
+ * (abstract, narrowed by each subclass). Declaring the fields optional on the base lets callers read a bare
+ * {@link TxReceipt} union (without first narrowing) and keep compiling. Use the `is*` guards to narrow to the strong
+ * variant type and gain access to its required fields.
+ */ class TxReceiptBase {
     txHash;
+    /** Description of the transaction error, if any. */ error;
+    constructor(/** A unique identifier for a transaction. */ txHash){
+        this.txHash = txHash;
+    }
+    /** Returns true (and narrows) if the transaction has been included in a block. */ isMined() {
+        return this instanceof MinedTxReceipt;
+    }
+    /** Returns true (and narrows) if the transaction is pending. */ isPending() {
+        return this instanceof PendingTxReceipt;
+    }
+    /** Returns true (and narrows) if the transaction was dropped. */ isDropped() {
+        return this instanceof DroppedTxReceipt;
+    }
+    /** Returns true if the transaction was executed successfully. */ hasExecutionSucceeded() {
+        return false;
+    }
+    /** Returns true if the transaction execution reverted. */ hasExecutionReverted() {
+        return false;
+    }
+}
+class UnminedTxReceipt extends TxReceiptBase {
+    executionResult = undefined;
+    transactionFee = undefined;
+    blockHash = undefined;
+    blockNumber = undefined;
+    slotNumber = undefined;
+    txIndexInBlock = undefined;
+    epochNumber = undefined;
+    txEffect = undefined;
+}
+/**
+ * Receipt for a transaction that is in the mempool but not yet included in a block.
+ */ export class PendingTxReceipt extends UnminedTxReceipt {
+    tx;
     status;
+    constructor(txHash, /** The pending transaction, attached when requested via `includePendingTx`. */ tx){
+        super(txHash), this.tx = tx, this.status = "pending";
+    }
+    static empty() {
+        return new PendingTxReceipt(TxHash.zero(), undefined);
+    }
+    static from(fields) {
+        return new PendingTxReceipt(fields.txHash, fields.tx);
+    }
+    static get schema() {
+        return z.object({
+            txHash: TxHash.schema,
+            status: z.literal("pending"),
+            tx: Tx.schema.optional()
+        }).transform((fields)=>PendingTxReceipt.from({
+                tx: undefined,
+                ...fields
+            }));
+    }
+}
+/**
+ * Receipt for a transaction that was dropped from the mempool without being mined.
+ */ export class DroppedTxReceipt extends UnminedTxReceipt {
     error;
+    status;
+    tx;
+    constructor(txHash, error){
+        super(txHash), this.error = error, this.status = "dropped", this.tx = undefined;
+    }
+    static empty() {
+        return new DroppedTxReceipt(TxHash.zero());
+    }
+    static from(fields) {
+        return new DroppedTxReceipt(fields.txHash, fields.error);
+    }
+    static get schema() {
+        return z.object({
+            txHash: TxHash.schema,
+            status: z.literal("dropped"),
+            error: z.string().optional()
+        }).transform(DroppedTxReceipt.from);
+    }
+}
+/**
+ * Receipt for a transaction that has been included in a block (proposed, checkpointed, proven, or finalized).
+ * All block-related fields are required for this variant.
+ */ export class MinedTxReceipt extends TxReceiptBase {
+    executionResult;
     transactionFee;
     blockHash;
     blockNumber;
-    debugInfo;
-    constructor(/** A unique identifier for a transaction. */ txHash, /** The transaction's status. */ status, /** Description of transaction error, if any. */ error, /** The transaction fee paid for the transaction. */ transactionFee, /** The hash of the block containing the transaction. */ blockHash, /** The block number in which the transaction was included. */ blockNumber, /** Information useful for testing/debugging, set when test flag is set to true in `waitOpts`. */ debugInfo){
-        this.txHash = txHash;
+    slotNumber;
+    txIndexInBlock;
+    epochNumber;
+    txEffect;
+    debugLogs;
+    status;
+    tx;
+    constructor(txHash, status, executionResult, transactionFee, blockHash, blockNumber, slotNumber, txIndexInBlock, epochNumber, txEffect, debugLogs){
+        super(txHash), this.executionResult = executionResult, this.transactionFee = transactionFee, this.blockHash = blockHash, this.blockNumber = blockNumber, this.slotNumber = slotNumber, this.txIndexInBlock = txIndexInBlock, this.epochNumber = epochNumber, this.txEffect = txEffect, this.debugLogs = debugLogs, this.tx = undefined;
         this.status = status;
-        this.error = error;
-        this.transactionFee = transactionFee;
-        this.blockHash = blockHash;
-        this.blockNumber = blockNumber;
-        this.debugInfo = debugInfo;
     }
-    static empty() {
-        return new TxReceipt(TxHash.zero(), "dropped", '');
+    hasExecutionSucceeded() {
+        return this.executionResult === "success";
+    }
+    hasExecutionReverted() {
+        return this.executionResult !== "success";
+    }
+    static from(fields) {
+        return new MinedTxReceipt(fields.txHash, fields.status, fields.executionResult, fields.transactionFee, fields.blockHash, fields.blockNumber, fields.slotNumber, fields.txIndexInBlock, fields.epochNumber, fields.txEffect, fields.debugLogs);
     }
     static get schema() {
         return z.object({
             txHash: TxHash.schema,
-            status: z.nativeEnum(TxStatus),
-            error: z.string(),
-            blockHash: L2BlockHash.schema.optional(),
-            blockNumber: z.number().int().nonnegative().optional(),
-            transactionFee: schemas.BigInt.optional(),
-            debugInfo: DebugInfoSchema.optional()
-        }).transform(TxReceipt.from);
+            status: z.enum([
+                "proposed",
+                "checkpointed",
+                "proven",
+                "finalized"
+            ]),
+            executionResult: z.nativeEnum(TxExecutionResult),
+            transactionFee: schemas.BigInt,
+            blockHash: BlockHash.schema,
+            blockNumber: BlockNumberSchema,
+            slotNumber: SlotNumberSchema,
+            txIndexInBlock: schemas.Integer,
+            epochNumber: EpochNumberSchema,
+            txEffect: TxEffect.schema.optional(),
+            debugLogs: z.array(DebugLog.schema).optional()
+        }).transform((fields)=>MinedTxReceipt.from({
+                txEffect: undefined,
+                ...fields
+            }));
     }
-    static from(fields) {
-        return new TxReceipt(fields.txHash, fields.status, fields.error, fields.transactionFee, fields.blockHash, fields.blockNumber, fields.debugInfo);
-    }
-    static statusFromRevertCode(revertCode) {
-        if (revertCode.equals(RevertCode.OK)) {
-            return "success";
-        } else if (revertCode.equals(RevertCode.APP_LOGIC_REVERTED)) {
-            return "app_logic_reverted";
-        } else if (revertCode.equals(RevertCode.TEARDOWN_REVERTED)) {
-            return "teardown_reverted";
-        } else if (revertCode.equals(RevertCode.BOTH_REVERTED)) {
-            return "both_reverted";
-        } else {
-            throw new Error(`Unknown revert code: ${revertCode}`);
-        }
+    static executionResultFromRevertCode(revertCode) {
+        return revertCode.isOK() ? "success" : "reverted";
     }
 }
-const DebugInfoSchema = z.object({
-    noteHashes: z.array(schemas.Fr),
-    nullifiers: z.array(schemas.Fr),
-    publicDataWrites: z.array(PublicDataWrite.schema),
-    l2ToL1Msgs: z.array(schemas.Fr)
+/**
+ * Zod schema for {@link TxReceipt}. Each member constrains its `status` field so the union routes
+ * unambiguously, giving a deterministic serialization round-trip.
+ */ export const TxReceiptSchema = z.union([
+    PendingTxReceipt.schema,
+    DroppedTxReceipt.schema,
+    MinedTxReceipt.schema
+]);
+/** Zod schema for {@link GetTxReceiptOptions}. */ export const GetTxReceiptOptionsSchema = z.object({
+    includeTxEffect: z.boolean().optional(),
+    includePendingTx: z.boolean().optional(),
+    includeProof: z.boolean().optional()
 });