@aztec/txe 0.0.1-commit.fffb133c → 0.0.1-dev
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dest/index.d.ts +1 -1
- package/dest/index.d.ts.map +1 -1
- package/dest/index.js +88 -54
- package/dest/oracle/interfaces.d.ts +35 -28
- package/dest/oracle/interfaces.d.ts.map +1 -1
- package/dest/oracle/txe_oracle_public_context.d.ts +13 -13
- package/dest/oracle/txe_oracle_public_context.d.ts.map +1 -1
- package/dest/oracle/txe_oracle_public_context.js +14 -15
- package/dest/oracle/txe_oracle_top_level_context.d.ts +33 -23
- package/dest/oracle/txe_oracle_top_level_context.d.ts.map +1 -1
- package/dest/oracle/txe_oracle_top_level_context.js +185 -71
- package/dest/rpc_translator.d.ts +135 -83
- package/dest/rpc_translator.d.ts.map +1 -1
- package/dest/rpc_translator.js +540 -178
- package/dest/state_machine/archiver.d.ts +3 -3
- package/dest/state_machine/archiver.d.ts.map +1 -1
- package/dest/state_machine/archiver.js +7 -7
- package/dest/state_machine/dummy_p2p_client.d.ts +16 -12
- package/dest/state_machine/dummy_p2p_client.d.ts.map +1 -1
- package/dest/state_machine/dummy_p2p_client.js +28 -16
- package/dest/state_machine/index.d.ts +7 -5
- package/dest/state_machine/index.d.ts.map +1 -1
- package/dest/state_machine/index.js +19 -10
- package/dest/state_machine/mock_epoch_cache.d.ts +3 -1
- package/dest/state_machine/mock_epoch_cache.d.ts.map +1 -1
- package/dest/state_machine/mock_epoch_cache.js +4 -0
- package/dest/state_machine/synchronizer.d.ts +5 -5
- package/dest/state_machine/synchronizer.d.ts.map +1 -1
- package/dest/state_machine/synchronizer.js +3 -3
- package/dest/txe_oracle_version.d.ts +10 -0
- package/dest/txe_oracle_version.d.ts.map +1 -0
- package/dest/txe_oracle_version.js +8 -0
- package/dest/txe_session.d.ts +67 -8
- package/dest/txe_session.d.ts.map +1 -1
- package/dest/txe_session.js +175 -32
- package/dest/util/encoding.d.ts +43 -41
- package/dest/util/encoding.d.ts.map +1 -1
- package/dest/util/txe_public_contract_data_source.d.ts +2 -3
- package/dest/util/txe_public_contract_data_source.d.ts.map +1 -1
- package/dest/util/txe_public_contract_data_source.js +5 -22
- package/dest/utils/block_creation.d.ts +1 -1
- package/dest/utils/block_creation.d.ts.map +1 -1
- package/dest/utils/block_creation.js +3 -1
- package/package.json +15 -15
- package/src/index.ts +89 -52
- package/src/oracle/interfaces.ts +43 -34
- package/src/oracle/txe_oracle_public_context.ts +14 -16
- package/src/oracle/txe_oracle_top_level_context.ts +231 -132
- package/src/rpc_translator.ts +673 -208
- package/src/state_machine/archiver.ts +7 -5
- package/src/state_machine/dummy_p2p_client.ts +40 -22
- package/src/state_machine/index.ts +30 -10
- package/src/state_machine/mock_epoch_cache.ts +5 -0
- package/src/state_machine/synchronizer.ts +4 -4
- package/src/txe_oracle_version.ts +9 -0
- package/src/txe_session.ts +270 -93
- package/src/util/txe_public_contract_data_source.ts +10 -36
- package/src/utils/block_creation.ts +3 -1
- package/dest/util/txe_contract_store.d.ts +0 -12
- package/dest/util/txe_contract_store.d.ts.map +0 -1
- package/dest/util/txe_contract_store.js +0 -22
- package/src/util/txe_contract_store.ts +0 -36
package/dest/txe_session.d.ts
CHANGED
|
@@ -2,17 +2,16 @@ import { BlockNumber } from '@aztec/foundation/branded-types';
|
|
|
2
2
|
import { Fr } from '@aztec/foundation/curves/bn254';
|
|
3
3
|
import { type Logger } from '@aztec/foundation/log';
|
|
4
4
|
import { KeyStore } from '@aztec/key-store';
|
|
5
|
-
import
|
|
6
|
-
import { AddressStore, CapsuleStore, JobCoordinator, NoteStore, PrivateEventStore, RecipientTaggingStore, SenderAddressBookStore, SenderTaggingStore } from '@aztec/pxe/server';
|
|
5
|
+
import { AddressStore, CapsuleStore, ContractStore, JobCoordinator, NoteStore, PrivateEventStore, RecipientTaggingStore, SenderAddressBookStore, SenderTaggingStore } from '@aztec/pxe/server';
|
|
7
6
|
import { type IPrivateExecutionOracle, type IUtilityExecutionOracle } from '@aztec/pxe/simulator';
|
|
8
7
|
import { AztecAddress } from '@aztec/stdlib/aztec-address';
|
|
8
|
+
import type { GasSettings } from '@aztec/stdlib/gas';
|
|
9
9
|
import { PrivateContextInputs } from '@aztec/stdlib/kernel';
|
|
10
10
|
import type { IAvmExecutionOracle, ITxeExecutionOracle } from './oracle/interfaces.js';
|
|
11
11
|
import { RPCTranslator } from './rpc_translator.js';
|
|
12
12
|
import { TXEStateMachine } from './state_machine/index.js';
|
|
13
13
|
import type { ForeignCallArgs, ForeignCallResult } from './util/encoding.js';
|
|
14
14
|
import { TXEAccountStore } from './util/txe_account_store.js';
|
|
15
|
-
import { TXEContractStore } from './util/txe_contract_store.js';
|
|
16
15
|
type MethodNames<T> = {
|
|
17
16
|
[K in keyof T]: T[K] extends (...args: any[]) => any ? K : never;
|
|
18
17
|
}[keyof T];
|
|
@@ -22,10 +21,47 @@ type MethodNames<T> = {
|
|
|
22
21
|
*/
|
|
23
22
|
export type TXEOracleFunctionName = Exclude<MethodNames<RPCTranslator>, 'constructor' | 'handlerAsMisc' | 'handlerAsUtility' | 'handlerAsPrivate' | 'handlerAsAvm' | 'handlerAsTxe'>;
|
|
24
23
|
export interface TXESessionStateHandler {
|
|
24
|
+
/** Records the TXE oracle version reported by the Noir test code for diagnostics. */
|
|
25
|
+
setTxeOracleVersion(version: {
|
|
26
|
+
major: number;
|
|
27
|
+
minor: number;
|
|
28
|
+
}): void;
|
|
25
29
|
enterTopLevelState(): Promise<void>;
|
|
26
30
|
enterPublicState(contractAddress?: AztecAddress): Promise<void>;
|
|
27
|
-
enterPrivateState(contractAddress
|
|
31
|
+
enterPrivateState(contractAddress: AztecAddress | undefined, anchorBlockNumber: BlockNumber | undefined, gasSettings: GasSettings): Promise<PrivateContextInputs>;
|
|
28
32
|
enterUtilityState(contractAddress?: AztecAddress): Promise<void>;
|
|
33
|
+
cycleJob(): Promise<string>;
|
|
34
|
+
getCurrentJob(): string;
|
|
35
|
+
/**
|
|
36
|
+
* Runs an executor-style top-level call (private/public call, utility execution) with last-call tracking.
|
|
37
|
+
*/
|
|
38
|
+
withTopLevelCallTracking<T>(work: () => Promise<{
|
|
39
|
+
result: T;
|
|
40
|
+
txHash?: Fr;
|
|
41
|
+
}>): Promise<T>;
|
|
42
|
+
/**
|
|
43
|
+
* Captures a raw offchain effect payload for consumption from test environment. Called by the `emit_offchain_effect`
|
|
44
|
+
* oracle handler whenever a contract function emits an offchain message, at any call depth.
|
|
45
|
+
*/
|
|
46
|
+
recordOffchainEffect(data: Fr[]): void;
|
|
47
|
+
/**
|
|
48
|
+
* Returns the raw offchain effect payloads emitted by the last top-level call. Each payload follows the protocol
|
|
49
|
+
* convention documented on `OFFCHAIN_MESSAGE_IDENTIFIER`, i.e. `[identifier, recipient, ...ciphertext]`. Decoding into
|
|
50
|
+
* `OffchainMessage` structs happens on the Noir side of the test helper. Marks the buffer as queried so the
|
|
51
|
+
* unqueried-messages warning doesn't fire on the next reset.
|
|
52
|
+
*/
|
|
53
|
+
getLastCallOffchainEffects(): {
|
|
54
|
+
effects: Fr[][];
|
|
55
|
+
};
|
|
56
|
+
/**
|
|
57
|
+
* Returns the context of the last top-level call: its tx hash (`Fr.ZERO` if the call was tx-less) and the anchor
|
|
58
|
+
* block timestamp captured at the start of the call. Does *not* mark the buffer as queried — context reads are
|
|
59
|
+
* metadata, not effect consumption.
|
|
60
|
+
*/
|
|
61
|
+
getLastCallContext(): {
|
|
62
|
+
txHash: Fr;
|
|
63
|
+
anchorBlockTimestamp: bigint;
|
|
64
|
+
};
|
|
29
65
|
}
|
|
30
66
|
/**
|
|
31
67
|
* A `TXESession` corresponds to a Noir `#[test]` function, and handles all of its oracle calls, stores test-specific
|
|
@@ -52,8 +88,10 @@ export declare class TXESession implements TXESessionStateHandler {
|
|
|
52
88
|
private nextBlockTimestamp;
|
|
53
89
|
private state;
|
|
54
90
|
private authwits;
|
|
55
|
-
|
|
56
|
-
|
|
91
|
+
private lastCallInfo;
|
|
92
|
+
private txeOracleVersion;
|
|
93
|
+
constructor(logger: Logger, stateMachine: TXEStateMachine, oracleHandler: IUtilityExecutionOracle | IPrivateExecutionOracle | IAvmExecutionOracle | ITxeExecutionOracle, contractStore: ContractStore, noteStore: NoteStore, keyStore: KeyStore, addressStore: AddressStore, accountStore: TXEAccountStore, senderTaggingStore: SenderTaggingStore, recipientTaggingStore: RecipientTaggingStore, senderAddressBookStore: SenderAddressBookStore, capsuleStore: CapsuleStore, privateEventStore: PrivateEventStore, jobCoordinator: JobCoordinator, currentJobId: string, chainId: Fr, version: Fr, nextBlockTimestamp: bigint);
|
|
94
|
+
static init(contractStore: ContractStore): Promise<TXESession>;
|
|
57
95
|
/**
|
|
58
96
|
* Processes an oracle function invoked by the Noir test associated to this session.
|
|
59
97
|
* @param functionName The name of the oracle.
|
|
@@ -61,8 +99,29 @@ export declare class TXESession implements TXESessionStateHandler {
|
|
|
61
99
|
* @returns The oracle return values.
|
|
62
100
|
*/
|
|
63
101
|
processFunction(functionName: TXEOracleFunctionName, inputs: ForeignCallArgs): Promise<ForeignCallResult>;
|
|
102
|
+
getCurrentJob(): string;
|
|
103
|
+
/** Commits the current job and begins a new one. Returns the new job ID. */
|
|
104
|
+
cycleJob(): Promise<string>;
|
|
105
|
+
private resetLastCall;
|
|
106
|
+
recordOffchainEffect(data: Fr[]): void;
|
|
107
|
+
private setLastCallContext;
|
|
108
|
+
withTopLevelCallTracking<T>(work: () => Promise<{
|
|
109
|
+
result: T;
|
|
110
|
+
txHash?: Fr;
|
|
111
|
+
}>): Promise<T>;
|
|
112
|
+
getLastCallOffchainEffects(): {
|
|
113
|
+
effects: Fr[][];
|
|
114
|
+
};
|
|
115
|
+
getLastCallContext(): {
|
|
116
|
+
txHash: Fr;
|
|
117
|
+
anchorBlockTimestamp: bigint;
|
|
118
|
+
};
|
|
119
|
+
setTxeOracleVersion(version: {
|
|
120
|
+
major: number;
|
|
121
|
+
minor: number;
|
|
122
|
+
}): void;
|
|
64
123
|
enterTopLevelState(): Promise<void>;
|
|
65
|
-
enterPrivateState(contractAddress
|
|
124
|
+
enterPrivateState(contractAddress: AztecAddress | undefined, anchorBlockNumber: BlockNumber | undefined, gasSettings: GasSettings): Promise<PrivateContextInputs>;
|
|
66
125
|
enterPublicState(contractAddress?: AztecAddress): Promise<void>;
|
|
67
126
|
enterUtilityState(contractAddress?: AztecAddress): Promise<void>;
|
|
68
127
|
private exitTopLevelState;
|
|
@@ -72,4 +131,4 @@ export declare class TXESession implements TXESessionStateHandler {
|
|
|
72
131
|
private utilityExecutorForContractSync;
|
|
73
132
|
}
|
|
74
133
|
export {};
|
|
75
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
134
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHhlX3Nlc3Npb24uZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy90eGVfc2Vzc2lvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDOUQsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQ3BELE9BQU8sRUFBRSxLQUFLLE1BQU0sRUFBZ0IsTUFBTSx1QkFBdUIsQ0FBQztBQUNsRSxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFFNUMsT0FBTyxFQUNMLFlBQVksRUFHWixZQUFZLEVBQ1osYUFBYSxFQUNiLGNBQWMsRUFFZCxTQUFTLEVBQ1QsaUJBQWlCLEVBQ2pCLHFCQUFxQixFQUNyQixzQkFBc0IsRUFDdEIsa0JBQWtCLEVBQ25CLE1BQU0sbUJBQW1CLENBQUM7QUFDM0IsT0FBTyxFQUlMLEtBQUssdUJBQXVCLEVBQzVCLEtBQUssdUJBQXVCLEVBSTdCLE1BQU0sc0JBQXNCLENBQUM7QUFXOUIsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQzNELE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBRXJELE9BQU8sRUFBRSxvQkFBb0IsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBTzVELE9BQU8sS0FBSyxFQUFFLG1CQUFtQixFQUFFLG1CQUFtQixFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFHdkYsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBRXBELE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUUzRCxPQUFPLEtBQUssRUFBRSxlQUFlLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUM3RSxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUF5QzlELEtBQUssV0FBVyxD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
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"txe_session.d.ts","sourceRoot":"","sources":["../src/txe_session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,
|
|
1
|
+
{"version":3,"file":"txe_session.d.ts","sourceRoot":"","sources":["../src/txe_session.ts"],"names":[],"mappings":"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"}
|
package/dest/txe_session.js
CHANGED
|
@@ -3,25 +3,33 @@ import { Fr } from '@aztec/foundation/curves/bn254';
|
|
|
3
3
|
import { createLogger } from '@aztec/foundation/log';
|
|
4
4
|
import { KeyStore } from '@aztec/key-store';
|
|
5
5
|
import { openTmpStore } from '@aztec/kv-store/lmdb-v2';
|
|
6
|
-
import { AddressStore, CapsuleStore, JobCoordinator, NoteService, NoteStore, PrivateEventStore, RecipientTaggingStore, SenderAddressBookStore, SenderTaggingStore } from '@aztec/pxe/server';
|
|
6
|
+
import { AddressStore, AnchorBlockStore, CapsuleService, CapsuleStore, JobCoordinator, NoteService, NoteStore, PrivateEventStore, RecipientTaggingStore, SenderAddressBookStore, SenderTaggingStore } from '@aztec/pxe/server';
|
|
7
7
|
import { ExecutionNoteCache, ExecutionTaggingIndexCache, HashedValuesCache, Oracle, PrivateExecutionOracle, UtilityExecutionOracle } from '@aztec/pxe/simulator';
|
|
8
8
|
import { ExecutionError, WASMSimulator, createSimulationError, extractCallStack, resolveAssertionMessageFromError, toACVMWitness } from '@aztec/simulator/client';
|
|
9
9
|
import { FunctionSelector, FunctionType } from '@aztec/stdlib/abi';
|
|
10
10
|
import { AztecAddress } from '@aztec/stdlib/aztec-address';
|
|
11
|
-
import { GasSettings } from '@aztec/stdlib/gas';
|
|
12
11
|
import { computeProtocolNullifier } from '@aztec/stdlib/hash';
|
|
13
12
|
import { makeGlobalVariables } from '@aztec/stdlib/testing';
|
|
14
|
-
import { CallContext, TxContext } from '@aztec/stdlib/tx';
|
|
13
|
+
import { CallContext, OFFCHAIN_MESSAGE_IDENTIFIER, TxContext } from '@aztec/stdlib/tx';
|
|
15
14
|
import { z } from 'zod';
|
|
16
15
|
import { DEFAULT_ADDRESS } from './constants.js';
|
|
17
16
|
import { TXEOraclePublicContext } from './oracle/txe_oracle_public_context.js';
|
|
18
17
|
import { TXEOracleTopLevelContext } from './oracle/txe_oracle_top_level_context.js';
|
|
19
18
|
import { RPCTranslator } from './rpc_translator.js';
|
|
19
|
+
import { TXEArchiver } from './state_machine/archiver.js';
|
|
20
20
|
import { TXEStateMachine } from './state_machine/index.js';
|
|
21
|
+
import { TXE_ORACLE_VERSION_MAJOR, TXE_ORACLE_VERSION_MINOR } from './txe_oracle_version.js';
|
|
21
22
|
import { TXEAccountStore } from './util/txe_account_store.js';
|
|
22
|
-
import { TXEContractStore } from './util/txe_contract_store.js';
|
|
23
23
|
import { getSingleTxBlockRequestHash, insertTxEffectIntoWorldTrees, makeTXEBlock } from './utils/block_creation.js';
|
|
24
24
|
import { makeTxEffect } from './utils/tx_effect_creation.js';
|
|
25
|
+
function emptyLastCallState() {
|
|
26
|
+
return {
|
|
27
|
+
offchainEffects: [],
|
|
28
|
+
queried: false,
|
|
29
|
+
txHash: Fr.ZERO,
|
|
30
|
+
anchorBlockTimestamp: 0n
|
|
31
|
+
};
|
|
32
|
+
}
|
|
25
33
|
/**
|
|
26
34
|
* A `TXESession` corresponds to a Noir `#[test]` function, and handles all of its oracle calls, stores test-specific
|
|
27
35
|
* state, etc., independent of all other tests running in parallel.
|
|
@@ -46,6 +54,8 @@ import { makeTxEffect } from './utils/tx_effect_creation.js';
|
|
|
46
54
|
nextBlockTimestamp;
|
|
47
55
|
state;
|
|
48
56
|
authwits;
|
|
57
|
+
lastCallInfo;
|
|
58
|
+
txeOracleVersion;
|
|
49
59
|
constructor(logger, stateMachine, oracleHandler, contractStore, noteStore, keyStore, addressStore, accountStore, senderTaggingStore, recipientTaggingStore, senderAddressBookStore, capsuleStore, privateEventStore, jobCoordinator, currentJobId, chainId, version, nextBlockTimestamp){
|
|
50
60
|
this.logger = logger;
|
|
51
61
|
this.stateMachine = stateMachine;
|
|
@@ -69,12 +79,12 @@ import { makeTxEffect } from './utils/tx_effect_creation.js';
|
|
|
69
79
|
name: 'TOP_LEVEL'
|
|
70
80
|
};
|
|
71
81
|
this.authwits = new Map();
|
|
82
|
+
this.lastCallInfo = emptyLastCallState();
|
|
72
83
|
}
|
|
73
|
-
static async init(
|
|
84
|
+
static async init(contractStore) {
|
|
74
85
|
const store = await openTmpStore('txe-session');
|
|
75
86
|
const addressStore = new AddressStore(store);
|
|
76
87
|
const privateEventStore = new PrivateEventStore(store);
|
|
77
|
-
const contractStore = new TXEContractStore(store);
|
|
78
88
|
const noteStore = new NoteStore(store);
|
|
79
89
|
const senderTaggingStore = new SenderTaggingStore(store);
|
|
80
90
|
const recipientTaggingStore = new RecipientTaggingStore(store);
|
|
@@ -91,19 +101,17 @@ import { makeTxEffect } from './utils/tx_effect_creation.js';
|
|
|
91
101
|
privateEventStore,
|
|
92
102
|
noteStore
|
|
93
103
|
]);
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
await contractStore.addContractInstance(instance);
|
|
98
|
-
}
|
|
99
|
-
const stateMachine = await TXEStateMachine.create(store);
|
|
104
|
+
const archiver = new TXEArchiver(store);
|
|
105
|
+
const anchorBlockStore = new AnchorBlockStore(store);
|
|
106
|
+
const stateMachine = await TXEStateMachine.create(archiver, anchorBlockStore, contractStore, noteStore);
|
|
100
107
|
const nextBlockTimestamp = BigInt(Math.floor(new Date().getTime() / 1000));
|
|
101
108
|
const version = new Fr(await stateMachine.node.getVersion());
|
|
102
109
|
const chainId = new Fr(await stateMachine.node.getChainId());
|
|
103
110
|
const initialJobId = jobCoordinator.beginJob();
|
|
104
|
-
const
|
|
105
|
-
|
|
106
|
-
|
|
111
|
+
const logger = createLogger('txe:session');
|
|
112
|
+
const topLevelOracleHandler = new TXEOracleTopLevelContext(stateMachine, contractStore, noteStore, keyStore, addressStore, accountStore, senderTaggingStore, recipientTaggingStore, senderAddressBookStore, capsuleStore, privateEventStore, nextBlockTimestamp, version, chainId, new Map());
|
|
113
|
+
await topLevelOracleHandler.advanceBlocksBy(1);
|
|
114
|
+
return new TXESession(logger, stateMachine, topLevelOracleHandler, contractStore, noteStore, keyStore, addressStore, accountStore, senderTaggingStore, recipientTaggingStore, senderAddressBookStore, capsuleStore, privateEventStore, jobCoordinator, initialJobId, version, chainId, nextBlockTimestamp);
|
|
107
115
|
}
|
|
108
116
|
/**
|
|
109
117
|
* Processes an oracle function invoked by the Noir test associated to this session.
|
|
@@ -118,7 +126,15 @@ import { makeTxEffect } from './utils/tx_effect_creation.js';
|
|
|
118
126
|
return translator[validatedFunctionName](...inputs);
|
|
119
127
|
} catch (error) {
|
|
120
128
|
if (error instanceof z.ZodError) {
|
|
121
|
-
|
|
129
|
+
let versionHint;
|
|
130
|
+
if (!this.txeOracleVersion) {
|
|
131
|
+
versionHint = ' The test appears to use an older version of Aztec.nr that does not' + ' support test environment oracle versioning. Update Aztec.nr to a compatible version.' + ' See https://docs.aztec.network/errors/12';
|
|
132
|
+
} else if (this.txeOracleVersion.minor > TXE_ORACLE_VERSION_MINOR) {
|
|
133
|
+
versionHint = ` The test uses Aztec.nr test oracle version` + ` ${this.txeOracleVersion.major}.${this.txeOracleVersion.minor}, but this test environment` + ` only supports up to ${TXE_ORACLE_VERSION_MAJOR}.${TXE_ORACLE_VERSION_MINOR}.` + ` Upgrade the Aztec CLI to a compatible version.` + ` See https://docs.aztec.network/errors/12`;
|
|
134
|
+
} else {
|
|
135
|
+
versionHint = ` The test's oracle version (${this.txeOracleVersion.major}.${this.txeOracleVersion.minor})` + ` is compatible with this test environment` + ` (${TXE_ORACLE_VERSION_MAJOR}.${TXE_ORACLE_VERSION_MINOR}), so this oracle should be` + ` available. This is an unexpected error, please report it.` + ` See https://docs.aztec.network/errors/13`;
|
|
136
|
+
}
|
|
137
|
+
throw new Error(`Unknown oracle '${functionName}'.${versionHint}`);
|
|
122
138
|
} else if (error instanceof Error) {
|
|
123
139
|
throw new Error(`Execution error while processing function ${functionName} in state ${this.state.name}: ${error.message}`);
|
|
124
140
|
} else {
|
|
@@ -126,6 +142,54 @@ import { makeTxEffect } from './utils/tx_effect_creation.js';
|
|
|
126
142
|
}
|
|
127
143
|
}
|
|
128
144
|
}
|
|
145
|
+
getCurrentJob() {
|
|
146
|
+
return this.currentJobId;
|
|
147
|
+
}
|
|
148
|
+
/** Commits the current job and begins a new one. Returns the new job ID. */ async cycleJob() {
|
|
149
|
+
await this.jobCoordinator.commitJob(this.currentJobId);
|
|
150
|
+
this.currentJobId = this.jobCoordinator.beginJob();
|
|
151
|
+
return this.currentJobId;
|
|
152
|
+
}
|
|
153
|
+
resetLastCall() {
|
|
154
|
+
const notQueriedMessageCount = this.lastCallInfo.queried ? 0 : this.lastCallInfo.offchainEffects.filter((payload)=>payload[0]?.equals(OFFCHAIN_MESSAGE_IDENTIFIER)).length;
|
|
155
|
+
if (notQueriedMessageCount > 0) {
|
|
156
|
+
this.logger.warn(`Dropping ${notQueriedMessageCount} unqueried offchain message(s) from the previous top-level call. ` + `To deliver them, call \`env.offchain_messages()\` and forward the result to the recipient contract's ` + `\`offchain_receive\` utility before issuing another top-level call. To intentionally discard, assign ` + `to \`let _ = env.offchain_messages()\` to silence this warning.`);
|
|
157
|
+
}
|
|
158
|
+
this.lastCallInfo = emptyLastCallState();
|
|
159
|
+
}
|
|
160
|
+
recordOffchainEffect(data) {
|
|
161
|
+
this.lastCallInfo.offchainEffects.push(data);
|
|
162
|
+
}
|
|
163
|
+
setLastCallContext(txHash, anchorBlockTimestamp) {
|
|
164
|
+
this.lastCallInfo.txHash = txHash;
|
|
165
|
+
this.lastCallInfo.anchorBlockTimestamp = anchorBlockTimestamp;
|
|
166
|
+
}
|
|
167
|
+
async withTopLevelCallTracking(work) {
|
|
168
|
+
this.resetLastCall();
|
|
169
|
+
// Capture the anchor *before* `work` runs: private/public executor calls mine a new block as a
|
|
170
|
+
// side effect, and that block's timestamp should not be attributed to this call's anchor.
|
|
171
|
+
const anchorBlockTimestamp = (await this.stateMachine.node.getBlockHeader('latest')).globalVariables.timestamp;
|
|
172
|
+
const { result, txHash } = await work();
|
|
173
|
+
this.setLastCallContext(txHash ?? Fr.ZERO, anchorBlockTimestamp);
|
|
174
|
+
return result;
|
|
175
|
+
}
|
|
176
|
+
getLastCallOffchainEffects() {
|
|
177
|
+
this.lastCallInfo.queried = true;
|
|
178
|
+
return {
|
|
179
|
+
effects: this.lastCallInfo.offchainEffects
|
|
180
|
+
};
|
|
181
|
+
}
|
|
182
|
+
getLastCallContext() {
|
|
183
|
+
const { txHash, anchorBlockTimestamp } = this.lastCallInfo;
|
|
184
|
+
return {
|
|
185
|
+
txHash,
|
|
186
|
+
anchorBlockTimestamp
|
|
187
|
+
};
|
|
188
|
+
}
|
|
189
|
+
setTxeOracleVersion(version) {
|
|
190
|
+
this.txeOracleVersion = version;
|
|
191
|
+
this.logger.debug(`Test compiled with test oracle version ${version.major}.${version.minor}`);
|
|
192
|
+
}
|
|
129
193
|
async enterTopLevelState() {
|
|
130
194
|
switch(this.state.name){
|
|
131
195
|
case 'PRIVATE':
|
|
@@ -153,21 +217,21 @@ import { makeTxEffect } from './utils/tx_effect_creation.js';
|
|
|
153
217
|
}
|
|
154
218
|
}
|
|
155
219
|
// Commit all staged stores from the job that was just completed, then begin a new job
|
|
156
|
-
await this.
|
|
157
|
-
this.
|
|
158
|
-
this.oracleHandler = new TXEOracleTopLevelContext(this.stateMachine, this.contractStore, this.noteStore, this.keyStore, this.addressStore, this.accountStore, this.senderTaggingStore, this.recipientTaggingStore, this.senderAddressBookStore, this.capsuleStore, this.privateEventStore, this.currentJobId, this.nextBlockTimestamp, this.version, this.chainId, this.authwits);
|
|
220
|
+
await this.cycleJob();
|
|
221
|
+
this.oracleHandler = new TXEOracleTopLevelContext(this.stateMachine, this.contractStore, this.noteStore, this.keyStore, this.addressStore, this.accountStore, this.senderTaggingStore, this.recipientTaggingStore, this.senderAddressBookStore, this.capsuleStore, this.privateEventStore, this.nextBlockTimestamp, this.version, this.chainId, this.authwits);
|
|
159
222
|
this.state = {
|
|
160
223
|
name: 'TOP_LEVEL'
|
|
161
224
|
};
|
|
162
225
|
this.logger.debug(`Entered state ${this.state.name}`);
|
|
163
226
|
}
|
|
164
|
-
async enterPrivateState(contractAddress = DEFAULT_ADDRESS, anchorBlockNumber) {
|
|
227
|
+
async enterPrivateState(contractAddress = DEFAULT_ADDRESS, anchorBlockNumber, gasSettings) {
|
|
165
228
|
this.exitTopLevelState();
|
|
166
|
-
|
|
229
|
+
this.resetLastCall();
|
|
167
230
|
// Private execution has two associated block numbers: the anchor block (i.e. the historical block that is used to
|
|
168
231
|
// build the proof), and the *next* block, i.e. the one we'll create once the execution ends, and which will contain
|
|
169
232
|
// a single transaction with the effects of what was done in the test.
|
|
170
233
|
const anchorBlock = await this.stateMachine.node.getBlockHeader(anchorBlockNumber ?? 'latest');
|
|
234
|
+
await new NoteService(this.noteStore, this.stateMachine.node, anchorBlock, this.currentJobId).syncNoteNullifiers(contractAddress, await this.keyStore.getAccounts());
|
|
171
235
|
const latestBlock = await this.stateMachine.node.getBlockHeader('latest');
|
|
172
236
|
const nextBlockGlobalVariables = makeGlobalVariables(undefined, {
|
|
173
237
|
blockNumber: BlockNumber(latestBlock.globalVariables.blockNumber + 1),
|
|
@@ -180,7 +244,34 @@ import { makeTxEffect } from './utils/tx_effect_creation.js';
|
|
|
180
244
|
const noteCache = new ExecutionNoteCache(protocolNullifier);
|
|
181
245
|
const taggingIndexCache = new ExecutionTaggingIndexCache();
|
|
182
246
|
const utilityExecutor = this.utilityExecutorForContractSync(anchorBlock);
|
|
183
|
-
this.oracleHandler = new PrivateExecutionOracle(
|
|
247
|
+
this.oracleHandler = new PrivateExecutionOracle({
|
|
248
|
+
argsHash: Fr.ZERO,
|
|
249
|
+
txContext: new TxContext(this.chainId, this.version, gasSettings),
|
|
250
|
+
callContext: new CallContext(AztecAddress.ZERO, contractAddress, FunctionSelector.empty(), false),
|
|
251
|
+
anchorBlockHeader: anchorBlock,
|
|
252
|
+
utilityExecutor,
|
|
253
|
+
authWitnesses: [],
|
|
254
|
+
capsules: [],
|
|
255
|
+
executionCache: new HashedValuesCache(),
|
|
256
|
+
noteCache,
|
|
257
|
+
taggingIndexCache,
|
|
258
|
+
contractStore: this.contractStore,
|
|
259
|
+
noteStore: this.noteStore,
|
|
260
|
+
keyStore: this.keyStore,
|
|
261
|
+
addressStore: this.addressStore,
|
|
262
|
+
aztecNode: this.stateMachine.node,
|
|
263
|
+
senderTaggingStore: this.senderTaggingStore,
|
|
264
|
+
recipientTaggingStore: this.recipientTaggingStore,
|
|
265
|
+
senderAddressBookStore: this.senderAddressBookStore,
|
|
266
|
+
capsuleService: new CapsuleService(this.capsuleStore, await this.keyStore.getAccounts()),
|
|
267
|
+
privateEventStore: this.privateEventStore,
|
|
268
|
+
contractSyncService: this.stateMachine.contractSyncService,
|
|
269
|
+
l2TipsStore: this.stateMachine.node,
|
|
270
|
+
jobId: this.currentJobId,
|
|
271
|
+
scopes: await this.keyStore.getAccounts(),
|
|
272
|
+
messageContextService: this.stateMachine.messageContextService,
|
|
273
|
+
simulator: new WASMSimulator()
|
|
274
|
+
});
|
|
184
275
|
// We store the note and tagging index caches fed into the PrivateExecutionOracle (along with some other auxiliary
|
|
185
276
|
// data) in order to refer to it later, mimicking the way this object is used by the ContractFunctionSimulator. The
|
|
186
277
|
// difference resides in that the simulator has all information needed in order to run the simulation, while ours
|
|
@@ -193,15 +284,19 @@ import { makeTxEffect } from './utils/tx_effect_creation.js';
|
|
|
193
284
|
taggingIndexCache
|
|
194
285
|
};
|
|
195
286
|
this.logger.debug(`Entered state ${this.state.name}`);
|
|
287
|
+
// Record the *resolved* anchor's timestamp — if the caller pinned the anchor to a past block
|
|
288
|
+
// via `anchorBlockNumber`, "latest" would be the wrong anchor for offchain-message semantics.
|
|
289
|
+
this.setLastCallContext(Fr.ZERO, anchorBlock.globalVariables.timestamp);
|
|
196
290
|
return this.oracleHandler.getPrivateContextInputs();
|
|
197
291
|
}
|
|
198
292
|
async enterPublicState(contractAddress) {
|
|
199
293
|
this.exitTopLevelState();
|
|
294
|
+
this.resetLastCall();
|
|
200
295
|
// The PublicContext will create a block with a single transaction in it, containing the effects of what was done in
|
|
201
296
|
// the test. The block therefore gets the *next* block number and timestamp.
|
|
202
|
-
const
|
|
297
|
+
const latestHeader = await this.stateMachine.node.getBlockHeader('latest');
|
|
203
298
|
const globalVariables = makeGlobalVariables(undefined, {
|
|
204
|
-
blockNumber: BlockNumber(
|
|
299
|
+
blockNumber: BlockNumber(latestHeader.globalVariables.blockNumber + 1),
|
|
205
300
|
timestamp: this.nextBlockTimestamp,
|
|
206
301
|
version: this.version,
|
|
207
302
|
chainId: this.chainId
|
|
@@ -211,21 +306,47 @@ import { makeTxEffect } from './utils/tx_effect_creation.js';
|
|
|
211
306
|
name: 'PUBLIC'
|
|
212
307
|
};
|
|
213
308
|
this.logger.debug(`Entered state ${this.state.name}`);
|
|
309
|
+
// Public state is anchored at the latest block.
|
|
310
|
+
this.setLastCallContext(Fr.ZERO, latestHeader.globalVariables.timestamp);
|
|
214
311
|
}
|
|
215
312
|
async enterUtilityState(contractAddress = DEFAULT_ADDRESS) {
|
|
216
313
|
this.exitTopLevelState();
|
|
314
|
+
this.resetLastCall();
|
|
315
|
+
const anchorBlockHeader = await this.stateMachine.anchorBlockStore.getBlockHeader();
|
|
217
316
|
// There is no automatic message discovery and contract-driven syncing process in inlined private or utility
|
|
218
317
|
// contexts, which means that known nullifiers are also not searched for, since it is during the tagging sync that
|
|
219
318
|
// we perform this. We therefore search for known nullifiers now, as otherwise notes that were nullified would not
|
|
220
319
|
// be removed from the database.
|
|
221
320
|
// TODO(#12553): make the synchronizer sync here instead and remove this
|
|
222
|
-
await new NoteService(this.noteStore, this.stateMachine.node,
|
|
223
|
-
|
|
224
|
-
|
|
321
|
+
await new NoteService(this.noteStore, this.stateMachine.node, anchorBlockHeader, this.currentJobId).syncNoteNullifiers(contractAddress, await this.keyStore.getAccounts());
|
|
322
|
+
this.oracleHandler = new UtilityExecutionOracle({
|
|
323
|
+
contractAddress,
|
|
324
|
+
authWitnesses: [],
|
|
325
|
+
capsules: [],
|
|
326
|
+
anchorBlockHeader,
|
|
327
|
+
contractStore: this.contractStore,
|
|
328
|
+
noteStore: this.noteStore,
|
|
329
|
+
keyStore: this.keyStore,
|
|
330
|
+
addressStore: this.addressStore,
|
|
331
|
+
aztecNode: this.stateMachine.node,
|
|
332
|
+
recipientTaggingStore: this.recipientTaggingStore,
|
|
333
|
+
senderAddressBookStore: this.senderAddressBookStore,
|
|
334
|
+
capsuleService: new CapsuleService(this.capsuleStore, await this.keyStore.getAccounts()),
|
|
335
|
+
privateEventStore: this.privateEventStore,
|
|
336
|
+
messageContextService: this.stateMachine.messageContextService,
|
|
337
|
+
contractSyncService: this.stateMachine.contractSyncService,
|
|
338
|
+
l2TipsStore: this.stateMachine.node,
|
|
339
|
+
jobId: this.currentJobId,
|
|
340
|
+
scopes: await this.keyStore.getAccounts(),
|
|
341
|
+
simulator: new WASMSimulator(),
|
|
342
|
+
utilityExecutor: this.utilityExecutorForContractSync(anchorBlockHeader)
|
|
343
|
+
});
|
|
225
344
|
this.state = {
|
|
226
345
|
name: 'UTILITY'
|
|
227
346
|
};
|
|
228
347
|
this.logger.debug(`Entered state ${this.state.name}`);
|
|
348
|
+
// Utility state anchors at whatever the anchor block store is pointing to (tracked as latest).
|
|
349
|
+
this.setLastCallContext(Fr.ZERO, anchorBlockHeader.globalVariables.timestamp);
|
|
229
350
|
}
|
|
230
351
|
exitTopLevelState() {
|
|
231
352
|
if (this.state.name != 'TOP_LEVEL') {
|
|
@@ -233,8 +354,8 @@ import { makeTxEffect } from './utils/tx_effect_creation.js';
|
|
|
233
354
|
}
|
|
234
355
|
// Note that while all public and private contexts do is build a single block that we then process when exiting
|
|
235
356
|
// those, the top level context performs a large number of actions not captured in the following 'close' call. Among
|
|
236
|
-
// others, it will create empty blocks (via `
|
|
237
|
-
// `
|
|
357
|
+
// others, it will create empty blocks (via `advanceBlocksBy` and `deploy`), create blocks with transactions via
|
|
358
|
+
// `privateCallNewFlow` and `publicCallNewFlow`, add accounts to PXE via `addAccount`, etc. This is a
|
|
238
359
|
// slight inconsistency in the working model of this class, but is not too bad.
|
|
239
360
|
// TODO: it's quite unfortunate that we need to capture the authwits created to later pass them again when the top
|
|
240
361
|
// level context is re-created. This is because authwits create a temporary utility context that'd otherwise reset
|
|
@@ -278,14 +399,36 @@ import { makeTxEffect } from './utils/tx_effect_creation.js';
|
|
|
278
399
|
}
|
|
279
400
|
}
|
|
280
401
|
utilityExecutorForContractSync(anchorBlock) {
|
|
281
|
-
return async (call)=>{
|
|
402
|
+
return async (call, scopes)=>{
|
|
282
403
|
const entryPointArtifact = await this.contractStore.getFunctionArtifactWithDebugMetadata(call.to, call.selector);
|
|
283
404
|
if (entryPointArtifact.functionType !== FunctionType.UTILITY) {
|
|
284
405
|
throw new Error(`Cannot run ${entryPointArtifact.functionType} function as utility`);
|
|
285
406
|
}
|
|
286
407
|
try {
|
|
287
|
-
const
|
|
288
|
-
|
|
408
|
+
const simulator = new WASMSimulator();
|
|
409
|
+
const oracle = new UtilityExecutionOracle({
|
|
410
|
+
contractAddress: call.to,
|
|
411
|
+
authWitnesses: [],
|
|
412
|
+
capsules: [],
|
|
413
|
+
anchorBlockHeader: anchorBlock,
|
|
414
|
+
contractStore: this.contractStore,
|
|
415
|
+
noteStore: this.noteStore,
|
|
416
|
+
keyStore: this.keyStore,
|
|
417
|
+
addressStore: this.addressStore,
|
|
418
|
+
aztecNode: this.stateMachine.node,
|
|
419
|
+
recipientTaggingStore: this.recipientTaggingStore,
|
|
420
|
+
senderAddressBookStore: this.senderAddressBookStore,
|
|
421
|
+
capsuleService: new CapsuleService(this.capsuleStore, scopes),
|
|
422
|
+
privateEventStore: this.privateEventStore,
|
|
423
|
+
messageContextService: this.stateMachine.messageContextService,
|
|
424
|
+
contractSyncService: this.stateMachine.contractSyncService,
|
|
425
|
+
l2TipsStore: this.stateMachine.node,
|
|
426
|
+
jobId: this.currentJobId,
|
|
427
|
+
scopes,
|
|
428
|
+
simulator,
|
|
429
|
+
utilityExecutor: this.utilityExecutorForContractSync(anchorBlock)
|
|
430
|
+
});
|
|
431
|
+
await simulator.executeUserCircuit(toACVMWitness(0, call.args), entryPointArtifact, new Oracle(oracle).toACIRCallback()).catch((err)=>{
|
|
289
432
|
err.message = resolveAssertionMessageFromError(err, entryPointArtifact);
|
|
290
433
|
throw new ExecutionError(err.message, {
|
|
291
434
|
contractAddress: call.to,
|