@aztec/pxe 0.0.1-commit.29c6b1a3 → 0.0.1-commit.2c85e299c

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.
Files changed (209) hide show
  1. package/dest/access_scopes.d.ts +9 -0
  2. package/dest/access_scopes.d.ts.map +1 -0
  3. package/dest/access_scopes.js +6 -0
  4. package/dest/block_synchronizer/block_synchronizer.d.ts +5 -3
  5. package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
  6. package/dest/block_synchronizer/block_synchronizer.js +9 -3
  7. package/dest/config/index.d.ts +2 -2
  8. package/dest/config/index.d.ts.map +1 -1
  9. package/dest/config/index.js +1 -1
  10. package/dest/config/package_info.js +1 -1
  11. package/dest/contract_function_simulator/contract_function_simulator.d.ts +54 -30
  12. package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
  13. package/dest/contract_function_simulator/contract_function_simulator.js +177 -73
  14. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +5 -5
  15. package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
  16. package/dest/contract_function_simulator/execution_tagging_index_cache.js +3 -3
  17. package/dest/contract_function_simulator/noir-structs/event_validation_request.js +1 -1
  18. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +2 -2
  19. package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
  20. package/dest/contract_function_simulator/noir-structs/note_validation_request.js +1 -1
  21. package/dest/contract_function_simulator/oracle/interfaces.d.ts +49 -45
  22. package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
  23. package/dest/contract_function_simulator/oracle/oracle.d.ts +44 -44
  24. package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
  25. package/dest/contract_function_simulator/oracle/oracle.js +156 -101
  26. package/dest/contract_function_simulator/oracle/private_execution.js +1 -1
  27. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +55 -55
  28. package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
  29. package/dest/contract_function_simulator/oracle/private_execution_oracle.js +101 -56
  30. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +77 -51
  31. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  32. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +116 -94
  33. package/dest/contract_logging.d.ts +22 -0
  34. package/dest/contract_logging.d.ts.map +1 -0
  35. package/dest/contract_logging.js +23 -0
  36. package/dest/contract_sync/contract_sync_service.d.ts +43 -0
  37. package/dest/contract_sync/contract_sync_service.d.ts.map +1 -0
  38. package/dest/contract_sync/contract_sync_service.js +97 -0
  39. package/dest/contract_sync/helpers.d.ts +29 -0
  40. package/dest/contract_sync/helpers.d.ts.map +1 -0
  41. package/dest/contract_sync/{index.js → helpers.js} +13 -12
  42. package/dest/debug/pxe_debug_utils.d.ts +14 -10
  43. package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
  44. package/dest/debug/pxe_debug_utils.js +16 -15
  45. package/dest/entrypoints/client/bundle/index.d.ts +4 -1
  46. package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
  47. package/dest/entrypoints/client/bundle/index.js +3 -0
  48. package/dest/entrypoints/client/bundle/utils.d.ts +1 -1
  49. package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
  50. package/dest/entrypoints/client/bundle/utils.js +21 -7
  51. package/dest/entrypoints/client/lazy/index.d.ts +4 -1
  52. package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
  53. package/dest/entrypoints/client/lazy/index.js +3 -0
  54. package/dest/entrypoints/client/lazy/utils.d.ts +2 -2
  55. package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
  56. package/dest/entrypoints/client/lazy/utils.js +22 -8
  57. package/dest/entrypoints/pxe_creation_options.d.ts +3 -2
  58. package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
  59. package/dest/entrypoints/server/index.d.ts +4 -2
  60. package/dest/entrypoints/server/index.d.ts.map +1 -1
  61. package/dest/entrypoints/server/index.js +3 -1
  62. package/dest/entrypoints/server/utils.d.ts +1 -1
  63. package/dest/entrypoints/server/utils.d.ts.map +1 -1
  64. package/dest/entrypoints/server/utils.js +28 -9
  65. package/dest/events/event_service.d.ts +4 -5
  66. package/dest/events/event_service.d.ts.map +1 -1
  67. package/dest/events/event_service.js +5 -6
  68. package/dest/job_coordinator/job_coordinator.d.ts +3 -2
  69. package/dest/job_coordinator/job_coordinator.d.ts.map +1 -1
  70. package/dest/job_coordinator/job_coordinator.js +3 -2
  71. package/dest/logs/log_service.d.ts +7 -5
  72. package/dest/logs/log_service.d.ts.map +1 -1
  73. package/dest/logs/log_service.js +19 -29
  74. package/dest/notes/note_service.d.ts +7 -7
  75. package/dest/notes/note_service.d.ts.map +1 -1
  76. package/dest/notes/note_service.js +9 -9
  77. package/dest/notes_filter.d.ts +25 -0
  78. package/dest/notes_filter.d.ts.map +1 -0
  79. package/dest/notes_filter.js +4 -0
  80. package/dest/oracle_version.d.ts +3 -3
  81. package/dest/oracle_version.d.ts.map +1 -1
  82. package/dest/oracle_version.js +3 -3
  83. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts +4 -0
  84. package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts.map +1 -0
  85. package/dest/private_kernel/hints/{compute_tx_include_by_timestamp.js → compute_tx_expiration_timestamp.js} +12 -12
  86. package/dest/private_kernel/hints/index.d.ts +1 -1
  87. package/dest/private_kernel/hints/index.js +1 -1
  88. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +4 -3
  89. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
  90. package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +129 -68
  91. package/dest/private_kernel/hints/test_utils.d.ts +122 -0
  92. package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
  93. package/dest/private_kernel/hints/test_utils.js +203 -0
  94. package/dest/private_kernel/private_kernel_execution_prover.d.ts +3 -2
  95. package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
  96. package/dest/private_kernel/private_kernel_execution_prover.js +21 -13
  97. package/dest/private_kernel/private_kernel_oracle.d.ts +6 -2
  98. package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
  99. package/dest/private_kernel/private_kernel_oracle.js +7 -3
  100. package/dest/pxe.d.ts +71 -24
  101. package/dest/pxe.d.ts.map +1 -1
  102. package/dest/pxe.js +104 -66
  103. package/dest/storage/address_store/address_store.d.ts +1 -1
  104. package/dest/storage/address_store/address_store.d.ts.map +1 -1
  105. package/dest/storage/address_store/address_store.js +12 -11
  106. package/dest/storage/anchor_block_store/anchor_block_store.d.ts +9 -1
  107. package/dest/storage/anchor_block_store/anchor_block_store.d.ts.map +1 -1
  108. package/dest/storage/anchor_block_store/anchor_block_store.js +8 -1
  109. package/dest/storage/capsule_store/capsule_store.js +6 -8
  110. package/dest/storage/contract_store/contract_store.d.ts +42 -15
  111. package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
  112. package/dest/storage/contract_store/contract_store.js +157 -72
  113. package/dest/storage/metadata.d.ts +1 -1
  114. package/dest/storage/metadata.js +1 -1
  115. package/dest/storage/note_store/note_store.d.ts +13 -3
  116. package/dest/storage/note_store/note_store.d.ts.map +1 -1
  117. package/dest/storage/note_store/note_store.js +147 -107
  118. package/dest/storage/private_event_store/private_event_store.d.ts +1 -1
  119. package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
  120. package/dest/storage/private_event_store/private_event_store.js +84 -61
  121. package/dest/storage/private_event_store/stored_private_event.js +1 -1
  122. package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
  123. package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
  124. package/dest/storage/tagging_store/recipient_tagging_store.js +31 -19
  125. package/dest/storage/tagging_store/sender_address_book_store.d.ts +1 -1
  126. package/dest/storage/tagging_store/sender_address_book_store.d.ts.map +1 -1
  127. package/dest/storage/tagging_store/sender_address_book_store.js +20 -14
  128. package/dest/storage/tagging_store/sender_tagging_store.d.ts +5 -5
  129. package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
  130. package/dest/storage/tagging_store/sender_tagging_store.js +184 -114
  131. package/dest/tagging/get_all_logs_by_tags.d.ts +1 -1
  132. package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
  133. package/dest/tagging/get_all_logs_by_tags.js +17 -3
  134. package/dest/tagging/index.d.ts +2 -2
  135. package/dest/tagging/index.d.ts.map +1 -1
  136. package/dest/tagging/index.js +1 -1
  137. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +4 -5
  138. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +1 -1
  139. package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +7 -7
  140. package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +2 -2
  141. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +6 -7
  142. package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +1 -1
  143. package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +12 -11
  144. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +4 -8
  145. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
  146. package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +3 -6
  147. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +4 -7
  148. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
  149. package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +14 -15
  150. package/package.json +25 -16
  151. package/src/access_scopes.ts +9 -0
  152. package/src/block_synchronizer/block_synchronizer.ts +21 -12
  153. package/src/config/index.ts +1 -1
  154. package/src/config/package_info.ts +1 -1
  155. package/src/contract_function_simulator/contract_function_simulator.ts +326 -131
  156. package/src/contract_function_simulator/execution_tagging_index_cache.ts +5 -5
  157. package/src/contract_function_simulator/noir-structs/event_validation_request.ts +1 -1
  158. package/src/contract_function_simulator/noir-structs/note_validation_request.ts +1 -1
  159. package/src/contract_function_simulator/oracle/interfaces.ts +53 -50
  160. package/src/contract_function_simulator/oracle/oracle.ts +157 -112
  161. package/src/contract_function_simulator/oracle/private_execution.ts +1 -1
  162. package/src/contract_function_simulator/oracle/private_execution_oracle.ts +127 -137
  163. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +167 -105
  164. package/src/contract_logging.ts +39 -0
  165. package/src/contract_sync/contract_sync_service.ts +152 -0
  166. package/src/contract_sync/{index.ts → helpers.ts} +21 -21
  167. package/src/debug/pxe_debug_utils.ts +48 -18
  168. package/src/entrypoints/client/bundle/index.ts +3 -0
  169. package/src/entrypoints/client/bundle/utils.ts +16 -15
  170. package/src/entrypoints/client/lazy/index.ts +3 -0
  171. package/src/entrypoints/client/lazy/utils.ts +17 -15
  172. package/src/entrypoints/pxe_creation_options.ts +2 -1
  173. package/src/entrypoints/server/index.ts +3 -1
  174. package/src/entrypoints/server/utils.ts +22 -26
  175. package/src/events/event_service.ts +4 -6
  176. package/src/job_coordinator/job_coordinator.ts +4 -3
  177. package/src/logs/log_service.ts +31 -38
  178. package/src/notes/note_service.ts +9 -10
  179. package/src/notes_filter.ts +26 -0
  180. package/src/oracle_version.ts +3 -3
  181. package/src/private_kernel/hints/{compute_tx_include_by_timestamp.ts → compute_tx_expiration_timestamp.ts} +13 -13
  182. package/src/private_kernel/hints/index.ts +1 -1
  183. package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +164 -117
  184. package/src/private_kernel/hints/test_utils.ts +325 -0
  185. package/src/private_kernel/private_kernel_execution_prover.ts +25 -15
  186. package/src/private_kernel/private_kernel_oracle.ts +7 -7
  187. package/src/pxe.ts +197 -118
  188. package/src/storage/address_store/address_store.ts +15 -15
  189. package/src/storage/anchor_block_store/anchor_block_store.ts +8 -0
  190. package/src/storage/capsule_store/capsule_store.ts +8 -8
  191. package/src/storage/contract_store/contract_store.ts +186 -76
  192. package/src/storage/metadata.ts +1 -1
  193. package/src/storage/note_store/note_store.ts +169 -132
  194. package/src/storage/private_event_store/private_event_store.ts +102 -81
  195. package/src/storage/private_event_store/stored_private_event.ts +1 -1
  196. package/src/storage/tagging_store/recipient_tagging_store.ts +38 -24
  197. package/src/storage/tagging_store/sender_address_book_store.ts +20 -14
  198. package/src/storage/tagging_store/sender_tagging_store.ts +214 -130
  199. package/src/tagging/get_all_logs_by_tags.ts +28 -4
  200. package/src/tagging/index.ts +1 -1
  201. package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +7 -10
  202. package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +2 -2
  203. package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +10 -15
  204. package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +4 -9
  205. package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +11 -20
  206. package/dest/contract_sync/index.d.ts +0 -23
  207. package/dest/contract_sync/index.d.ts.map +0 -1
  208. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts +0 -4
  209. package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts.map +0 -1
@@ -1,18 +1,18 @@
1
- import { DirectionalAppTaggingSecret, type PreTag } from '@aztec/stdlib/logs';
1
+ import { ExtendedDirectionalAppTaggingSecret, type PreTag } from '@aztec/stdlib/logs';
2
2
 
3
3
  /**
4
- * A map that stores the tagging index for a given directional app tagging secret.
4
+ * A map that stores the tagging index for a given extended directional app tagging secret.
5
5
  * Note: The directional app tagging secret is unique for a (sender, recipient, contract) tuple while the direction
6
6
  * of sender -> recipient matters.
7
7
  */
8
8
  export class ExecutionTaggingIndexCache {
9
9
  private taggingIndexMap: Map<string, number> = new Map();
10
10
 
11
- public getLastUsedIndex(secret: DirectionalAppTaggingSecret): number | undefined {
11
+ public getLastUsedIndex(secret: ExtendedDirectionalAppTaggingSecret): number | undefined {
12
12
  return this.taggingIndexMap.get(secret.toString());
13
13
  }
14
14
 
15
- public setLastUsedIndex(secret: DirectionalAppTaggingSecret, index: number) {
15
+ public setLastUsedIndex(secret: ExtendedDirectionalAppTaggingSecret, index: number) {
16
16
  const currentValue = this.taggingIndexMap.get(secret.toString());
17
17
  if (currentValue !== undefined && currentValue !== index - 1) {
18
18
  throw new Error(`Invalid tagging index update. Current value: ${currentValue}, new value: ${index}`);
@@ -25,7 +25,7 @@ export class ExecutionTaggingIndexCache {
25
25
  */
26
26
  public getUsedPreTags(): PreTag[] {
27
27
  return Array.from(this.taggingIndexMap.entries()).map(([secret, index]) => ({
28
- secret: DirectionalAppTaggingSecret.fromString(secret),
28
+ extendedSecret: ExtendedDirectionalAppTaggingSecret.fromString(secret),
29
29
  index,
30
30
  }));
31
31
  }
@@ -5,7 +5,7 @@ import { AztecAddress } from '@aztec/stdlib/aztec-address';
5
5
  import { TxHash } from '@aztec/stdlib/tx';
6
6
 
7
7
  // TODO(#14617): should we compute this from constants? This value is aztec-nr specific.
8
- const MAX_EVENT_SERIALIZED_LEN = 12;
8
+ const MAX_EVENT_SERIALIZED_LEN = 10;
9
9
 
10
10
  /**
11
11
  * Intermediate struct used to perform batch event validation by PXE. The `utilityValidateAndStoreEnqueuedNotesAndEvents` oracle
@@ -4,7 +4,7 @@ import { AztecAddress } from '@aztec/stdlib/aztec-address';
4
4
  import { TxHash } from '@aztec/stdlib/tx';
5
5
 
6
6
  // TODO(#14617): should we compute this from constants? This value is aztec-nr specific.
7
- export const MAX_NOTE_PACKED_LEN = 10;
7
+ export const MAX_NOTE_PACKED_LEN = 8;
8
8
 
9
9
  /**
10
10
  * Intermediate struct used to perform batch note validation by PXE. The `utilityValidateAndStoreEnqueuedNotesAndEvents` oracle
@@ -6,8 +6,9 @@ import { MembershipWitness } from '@aztec/foundation/trees';
6
6
  import type { FunctionSelector, NoteSelector } from '@aztec/stdlib/abi';
7
7
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
8
8
  import { BlockHash } from '@aztec/stdlib/block';
9
- import type { CompleteAddress, ContractInstance } from '@aztec/stdlib/contract';
9
+ import type { ContractInstance, PartialAddress } from '@aztec/stdlib/contract';
10
10
  import type { KeyValidationRequest } from '@aztec/stdlib/kernel';
11
+ import type { PublicKeys } from '@aztec/stdlib/keys';
11
12
  import type { ContractClassLog, Tag } from '@aztec/stdlib/logs';
12
13
  import type { Note, NoteStatus } from '@aztec/stdlib/note';
13
14
  import { type NullifierMembershipWitness, PublicDataWitness } from '@aztec/stdlib/trees';
@@ -52,9 +53,9 @@ export interface NoteData {
52
53
  export interface IMiscOracle {
53
54
  isMisc: true;
54
55
 
55
- utilityGetRandomField(): Fr;
56
- utilityAssertCompatibleOracleVersion(version: number): void;
57
- utilityDebugLog(level: number, message: string, fields: Fr[]): void;
56
+ getRandomField(): Fr;
57
+ assertCompatibleOracleVersion(version: number): void;
58
+ log(level: number, message: string, fields: Fr[]): Promise<void>;
58
59
  }
59
60
 
60
61
  /**
@@ -64,30 +65,32 @@ export interface IMiscOracle {
64
65
  export interface IUtilityExecutionOracle {
65
66
  isUtility: true;
66
67
 
67
- utilityGetUtilityContext(): UtilityContext;
68
- utilityGetKeyValidationRequest(pkMHash: Fr): Promise<KeyValidationRequest>;
69
- utilityGetContractInstance(address: AztecAddress): Promise<ContractInstance>;
70
- utilityGetNoteHashMembershipWitness(
71
- blockHash: BlockHash,
72
- leafValue: Fr,
68
+ getUtilityContext(): UtilityContext;
69
+ getKeyValidationRequest(pkMHash: Fr): Promise<KeyValidationRequest>;
70
+ getContractInstance(address: AztecAddress): Promise<ContractInstance>;
71
+ getNoteHashMembershipWitness(
72
+ anchorBlockHash: BlockHash,
73
+ noteHash: Fr,
73
74
  ): Promise<MembershipWitness<typeof NOTE_HASH_TREE_HEIGHT> | undefined>;
74
- utilityGetArchiveMembershipWitness(
75
+ getBlockHashMembershipWitness(
76
+ anchorBlockHash: BlockHash,
75
77
  blockHash: BlockHash,
76
- leafValue: Fr,
77
78
  ): Promise<MembershipWitness<typeof ARCHIVE_HEIGHT> | undefined>;
78
- utilityGetNullifierMembershipWitness(
79
- blockHash: BlockHash,
79
+ getNullifierMembershipWitness(
80
+ anchorBlockHash: BlockHash,
80
81
  nullifier: Fr,
81
82
  ): Promise<NullifierMembershipWitness | undefined>;
82
- utilityGetPublicDataWitness(blockHash: BlockHash, leafSlot: Fr): Promise<PublicDataWitness | undefined>;
83
- utilityGetLowNullifierMembershipWitness(
84
- blockHash: BlockHash,
83
+ getPublicDataWitness(anchorBlockHash: BlockHash, leafSlot: Fr): Promise<PublicDataWitness | undefined>;
84
+ getLowNullifierMembershipWitness(
85
+ anchorBlockHash: BlockHash,
85
86
  nullifier: Fr,
86
87
  ): Promise<NullifierMembershipWitness | undefined>;
87
- utilityGetBlockHeader(blockNumber: BlockNumber): Promise<BlockHeader | undefined>;
88
- utilityGetPublicKeysAndPartialAddress(account: AztecAddress): Promise<CompleteAddress>;
89
- utilityGetAuthWitness(messageHash: Fr): Promise<Fr[] | undefined>;
90
- utilityGetNotes(
88
+ getBlockHeader(blockNumber: BlockNumber): Promise<BlockHeader | undefined>;
89
+ tryGetPublicKeysAndPartialAddress(
90
+ account: AztecAddress,
91
+ ): Promise<{ publicKeys: PublicKeys; partialAddress: PartialAddress } | undefined>;
92
+ getAuthWitness(messageHash: Fr): Promise<Fr[] | undefined>;
93
+ getNotes(
91
94
  owner: AztecAddress | undefined,
92
95
  storageSlot: Fr,
93
96
  numSelects: number,
@@ -104,35 +107,35 @@ export interface IUtilityExecutionOracle {
104
107
  offset: number,
105
108
  status: NoteStatus,
106
109
  ): Promise<NoteData[]>;
107
- utilityCheckNullifierExists(innerNullifier: Fr): Promise<boolean>;
108
- utilityGetL1ToL2MembershipWitness(
110
+ checkNullifierExists(innerNullifier: Fr): Promise<boolean>;
111
+ getL1ToL2MembershipWitness(
109
112
  contractAddress: AztecAddress,
110
113
  messageHash: Fr,
111
114
  secret: Fr,
112
115
  ): Promise<MessageLoadOracleInputs<typeof L1_TO_L2_MSG_TREE_HEIGHT>>;
113
- utilityStorageRead(
114
- blockHash: BlockHash,
116
+ storageRead(
117
+ anchorBlockHash: BlockHash,
115
118
  contractAddress: AztecAddress,
116
119
  startStorageSlot: Fr,
117
120
  numberOfElements: number,
118
121
  ): Promise<Fr[]>;
119
- utilityFetchTaggedLogs(pendingTaggedLogArrayBaseSlot: Fr): Promise<void>;
120
- utilityValidateAndStoreEnqueuedNotesAndEvents(
122
+ fetchTaggedLogs(pendingTaggedLogArrayBaseSlot: Fr): Promise<void>;
123
+ validateAndStoreEnqueuedNotesAndEvents(
121
124
  contractAddress: AztecAddress,
122
125
  noteValidationRequestsArrayBaseSlot: Fr,
123
126
  eventValidationRequestsArrayBaseSlot: Fr,
124
127
  ): Promise<void>;
125
- utilityBulkRetrieveLogs(
128
+ bulkRetrieveLogs(
126
129
  contractAddress: AztecAddress,
127
130
  logRetrievalRequestsArrayBaseSlot: Fr,
128
131
  logRetrievalResponsesArrayBaseSlot: Fr,
129
132
  ): Promise<void>;
130
- utilityStoreCapsule(contractAddress: AztecAddress, key: Fr, capsule: Fr[]): Promise<void>;
131
- utilityLoadCapsule(contractAddress: AztecAddress, key: Fr): Promise<Fr[] | null>;
132
- utilityDeleteCapsule(contractAddress: AztecAddress, key: Fr): Promise<void>;
133
- utilityCopyCapsule(contractAddress: AztecAddress, srcKey: Fr, dstKey: Fr, numEntries: number): Promise<void>;
134
- utilityAes128Decrypt(ciphertext: Buffer, iv: Buffer, symKey: Buffer): Promise<Buffer>;
135
- utilityGetSharedSecret(address: AztecAddress, ephPk: Point): Promise<Point>;
133
+ storeCapsule(contractAddress: AztecAddress, key: Fr, capsule: Fr[]): Promise<void>;
134
+ loadCapsule(contractAddress: AztecAddress, key: Fr): Promise<Fr[] | null>;
135
+ deleteCapsule(contractAddress: AztecAddress, key: Fr): Promise<void>;
136
+ copyCapsule(contractAddress: AztecAddress, srcKey: Fr, dstKey: Fr, numEntries: number): Promise<void>;
137
+ aes128Decrypt(ciphertext: Buffer, iv: Buffer, symKey: Buffer): Promise<Buffer>;
138
+ getSharedSecret(address: AztecAddress, ephPk: Point): Promise<Point>;
136
139
  }
137
140
 
138
141
  /**
@@ -142,9 +145,9 @@ export interface IUtilityExecutionOracle {
142
145
  export interface IPrivateExecutionOracle {
143
146
  isPrivate: true;
144
147
 
145
- privateStoreInExecutionCache(values: Fr[], hash: Fr): void;
146
- privateLoadFromExecutionCache(hash: Fr): Promise<Fr[]>;
147
- privateNotifyCreatedNote(
148
+ storeInExecutionCache(values: Fr[], hash: Fr): void;
149
+ loadFromExecutionCache(hash: Fr): Promise<Fr[]>;
150
+ notifyCreatedNote(
148
151
  owner: AztecAddress,
149
152
  storageSlot: Fr,
150
153
  randomness: Fr,
@@ -153,33 +156,33 @@ export interface IPrivateExecutionOracle {
153
156
  noteHash: Fr,
154
157
  counter: number,
155
158
  ): void;
156
- privateNotifyNullifiedNote(innerNullifier: Fr, noteHash: Fr, counter: number): Promise<void>;
157
- privateNotifyCreatedNullifier(innerNullifier: Fr): Promise<void>;
158
- privateIsNullifierPending(innerNullifier: Fr, contractAddress: AztecAddress): Promise<boolean>;
159
- privateNotifyCreatedContractClassLog(log: ContractClassLog, counter: number): void;
160
- privateCallPrivateFunction(
159
+ notifyNullifiedNote(innerNullifier: Fr, noteHash: Fr, counter: number): Promise<void>;
160
+ notifyCreatedNullifier(innerNullifier: Fr): Promise<void>;
161
+ isNullifierPending(innerNullifier: Fr, contractAddress: AztecAddress): Promise<boolean>;
162
+ notifyCreatedContractClassLog(log: ContractClassLog, counter: number): void;
163
+ callPrivateFunction(
161
164
  targetContractAddress: AztecAddress,
162
165
  functionSelector: FunctionSelector,
163
166
  argsHash: Fr,
164
167
  sideEffectCounter: number,
165
168
  isStaticCall: boolean,
166
169
  ): Promise<{ endSideEffectCounter: Fr; returnsHash: Fr }>;
167
- privateNotifyEnqueuedPublicFunctionCall(
170
+ notifyEnqueuedPublicFunctionCall(
168
171
  targetContractAddress: AztecAddress,
169
172
  calldataHash: Fr,
170
173
  sideEffectCounter: number,
171
174
  isStaticCall: boolean,
172
175
  ): Promise<void>;
173
- privateNotifySetPublicTeardownFunctionCall(
176
+ notifySetPublicTeardownFunctionCall(
174
177
  targetContractAddress: AztecAddress,
175
178
  calldataHash: Fr,
176
179
  sideEffectCounter: number,
177
180
  isStaticCall: boolean,
178
181
  ): Promise<void>;
179
- privateNotifySetMinRevertibleSideEffectCounter(minRevertibleSideEffectCounter: number): Promise<void>;
180
- privateIsSideEffectCounterRevertible(sideEffectCounter: number): Promise<boolean>;
181
- privateGetSenderForTags(): Promise<AztecAddress | undefined>;
182
- privateSetSenderForTags(senderForTags: AztecAddress): Promise<void>;
183
- privateGetNextAppTagAsSender(sender: AztecAddress, recipient: AztecAddress): Promise<Tag>;
184
- utilityEmitOffchainEffect(data: Fr[]): Promise<void>;
182
+ notifySetMinRevertibleSideEffectCounter(minRevertibleSideEffectCounter: number): Promise<void>;
183
+ isSideEffectCounterRevertible(sideEffectCounter: number): Promise<boolean>;
184
+ getSenderForTags(): Promise<AztecAddress | undefined>;
185
+ setSenderForTags(senderForTags: AztecAddress): Promise<void>;
186
+ getNextAppTagAsSender(sender: AztecAddress, recipient: AztecAddress): Promise<Tag>;
187
+ emitOffchainEffect(data: Fr[]): Promise<void>;
185
188
  }