@aztec-labs/pxe 6.0.0-nightly.20260921 → 6.0.0-nightly.20260923

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 (37) hide show
  1. package/dest/bin/check_oracle_version.js +14 -2
  2. package/dest/bin/oracle_version_helpers.d.ts +2 -2
  3. package/dest/bin/oracle_version_helpers.d.ts.map +1 -1
  4. package/dest/contract_function_simulator/contract_function_simulator.js +3 -1
  5. package/dest/contract_function_simulator/index.d.ts +2 -1
  6. package/dest/contract_function_simulator/index.d.ts.map +1 -1
  7. package/dest/contract_function_simulator/index.js +1 -0
  8. package/dest/contract_function_simulator/oracle/acir_callback.d.ts +11 -6
  9. package/dest/contract_function_simulator/oracle/acir_callback.d.ts.map +1 -1
  10. package/dest/contract_function_simulator/oracle/acir_callback.js +46 -19
  11. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts +2 -2
  12. package/dest/contract_function_simulator/oracle/oracle_registry.d.ts.map +1 -1
  13. package/dest/contract_function_simulator/oracle/private_execution.js +3 -1
  14. package/dest/contract_function_simulator/oracle/protocol_oracle_registry.d.ts +31 -0
  15. package/dest/contract_function_simulator/oracle/protocol_oracle_registry.d.ts.map +1 -0
  16. package/dest/contract_function_simulator/oracle/protocol_oracle_registry.js +183 -0
  17. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +1 -1
  18. package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
  19. package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +3 -1
  20. package/dest/oracle_version.d.ts +3 -1
  21. package/dest/oracle_version.d.ts.map +1 -1
  22. package/dest/oracle_version.js +9 -0
  23. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts +1 -1
  24. package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts.map +1 -1
  25. package/dest/storage/backwards_compatibility_tests/schema_tests.js +2 -2
  26. package/package.json +19 -19
  27. package/src/bin/check_oracle_version.ts +18 -2
  28. package/src/bin/oracle_version_helpers.ts +3 -1
  29. package/src/contract_function_simulator/contract_function_simulator.ts +1 -1
  30. package/src/contract_function_simulator/index.ts +1 -0
  31. package/src/contract_function_simulator/oracle/acir_callback.ts +60 -22
  32. package/src/contract_function_simulator/oracle/oracle_registry.ts +1 -1
  33. package/src/contract_function_simulator/oracle/private_execution.ts +1 -1
  34. package/src/contract_function_simulator/oracle/protocol_oracle_registry.ts +176 -0
  35. package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +5 -1
  36. package/src/oracle_version.ts +11 -0
  37. package/src/storage/backwards_compatibility_tests/schema_tests.ts +8 -1
@@ -1,6 +1,6 @@
1
1
  import { keccak256String } from '@aztec-labs/foundation/crypto/keccak';
2
- import { ORACLE_REGISTRY } from '../contract_function_simulator/index.js';
3
- import { ORACLE_INTERFACE_HASH } from '../oracle_version.js';
2
+ import { ORACLE_REGISTRY, PROTOCOL_ORACLE_REGISTRY } from '../contract_function_simulator/index.js';
3
+ import { ORACLE_INTERFACE_HASH, PROTOCOL_ORACLE_INTERFACE_HASH } from '../oracle_version.js';
4
4
  import { getOracleRegistrySignature } from './oracle_version_helpers.js';
5
5
  /**
6
6
  * Verifies that the Oracle interface matches the expected interface hash.
@@ -19,4 +19,16 @@ import { getOracleRegistrySignature } from './oracle_version_helpers.js';
19
19
  throw new Error(`The Oracle interface has changed. Update ORACLE_INTERFACE_HASH to ${oracleInterfaceHash} in pxe/src/oracle_version.ts and bump the oracle version (ORACLE_VERSION_MAJOR for breaking changes, ORACLE_VERSION_MINOR for oracle additions).`);
20
20
  }
21
21
  }
22
+ /**
23
+ * Verifies that the interface of the oracles served to the protocol contracts matches the expected interface hash.
24
+ *
25
+ * Protocol contracts are only redeployed on a protocol upgrade, so unlike the Aztec.nr oracle interface this one cannot
26
+ * change in between: a mismatch means deployed protocol contracts would stop working.
27
+ */ function assertProtocolOracleInterfaceMatches() {
28
+ const protocolOracleInterfaceHash = keccak256String(getOracleRegistrySignature(PROTOCOL_ORACLE_REGISTRY));
29
+ if (protocolOracleInterfaceHash !== PROTOCOL_ORACLE_INTERFACE_HASH) {
30
+ throw new Error(`The protocol oracle interface has changed, which breaks the deployed protocol contracts. If this ships with a protocol upgrade that redeploys them, update PROTOCOL_ORACLE_INTERFACE_HASH to ${protocolOracleInterfaceHash} in pxe/src/oracle_version.ts and set PROTOCOL_ORACLE_VERSION to the new protocol version. Otherwise keep the interface as it was, adapting how PROTOCOL_ORACLE_REGISTRY serves it to the changed oracle handlers.`);
31
+ }
32
+ }
22
33
  assertOracleInterfaceMatches();
34
+ assertProtocolOracleInterfaceMatches();
@@ -16,5 +16,5 @@ import type { OracleRegistryEntry } from '../contract_function_simulator/index.j
16
16
  * // Returns (sorted, newline-joined):
17
17
  * // "aztec_prv_bar(): void\naztec_utl_foo(a: u32): bool"
18
18
  */
19
- export declare function getOracleRegistrySignature(registry: Record<string, OracleRegistryEntry>): string;
20
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3JhY2xlX3ZlcnNpb25faGVscGVycy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2Jpbi9vcmFjbGVfdmVyc2lvbl9oZWxwZXJzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLG1CQUFtQixFQUFFLE1BQU0seUNBQXlDLENBQUM7QUFFbkY7Ozs7Ozs7Ozs7Ozs7Ozs7R0FnQkc7QUFDSCx3QkFBZ0IsMEJBQTBCLENBQUMsUUFBUSxFQUFFLE1BQU0sQ0FBQyxNQUFNLEVBQUUsbUJBQW1CLENBQUMsR0FBRyxNQUFNLENBVWhHIn0=
19
+ export declare function getOracleRegistrySignature(registry: Record<string, Pick<OracleRegistryEntry, 'params' | 'returnType'>>): string;
20
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3JhY2xlX3ZlcnNpb25faGVscGVycy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2Jpbi9vcmFjbGVfdmVyc2lvbl9oZWxwZXJzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLG1CQUFtQixFQUFFLE1BQU0seUNBQXlDLENBQUM7QUFFbkY7Ozs7Ozs7Ozs7Ozs7Ozs7R0FnQkc7QUFDSCx3QkFBZ0IsMEJBQTBCLENBQ3hDLFFBQVEsRUFBRSxNQUFNLENBQUMsTUFBTSxFQUFFLElBQUksQ0FBQyxtQkFBbUIsRUFBRSxRQUFRLEdBQUcsWUFBWSxDQUFDLENBQUMsR0FDM0UsTUFBTSxDQVVSIn0=
@@ -1 +1 @@
1
- {"version":3,"file":"oracle_version_helpers.d.ts","sourceRoot":"","sources":["../../src/bin/oracle_version_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAEnF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,MAAM,CAUhG"}
1
+ {"version":3,"file":"oracle_version_helpers.d.ts","sourceRoot":"","sources":["../../src/bin/oracle_version_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAEnF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,mBAAmB,EAAE,QAAQ,GAAG,YAAY,CAAC,CAAC,GAC3E,MAAM,CAUR"}
@@ -217,7 +217,9 @@ import { TransientArrayService } from './transient_array_service.js';
217
217
  selector: call.selector
218
218
  });
219
219
  const initialWitness = toACVMWitness(0, call.args);
220
- const acirExecutionResult = await this.simulator.executeUserCircuit(initialWitness, entryPointArtifact, buildACIRCallback(oracle)).catch((err)=>{
220
+ const acirExecutionResult = await this.simulator.executeUserCircuit(initialWitness, entryPointArtifact, buildACIRCallback(oracle, {
221
+ contractAddress: call.to
222
+ })).catch((err)=>{
221
223
  err.message = resolveAssertionMessageFromError(err, entryPointArtifact);
222
224
  throw new ExecutionError(err.message, {
223
225
  contractAddress: call.to,
@@ -13,6 +13,7 @@ export { UtilityExecutionOracle } from './oracle/utility_execution_oracle.js';
13
13
  export { PrivateExecutionOracle } from './oracle/private_execution_oracle.js';
14
14
  export { buildACIRCallback, UnavailableOracleError } from './oracle/acir_callback.js';
15
15
  export { LEGACY_ORACLE_REGISTRY } from './oracle/legacy_oracle_registry.js';
16
+ export { PROTOCOL_ORACLE_REGISTRY } from './oracle/protocol_oracle_registry.js';
16
17
  export { executePrivateFunction, extractPrivateCircuitPublicInputs } from './oracle/private_execution.js';
17
18
  export { generateSimulatedProvingResult } from './contract_function_simulator.js';
18
19
  export { packAsHintedNote } from './oracle/note_packing_utils.js';
@@ -33,4 +34,4 @@ export type { ResolvedTx } from './noir-structs/resolved_tx.js';
33
34
  export type { NullifierMembershipWitnessData } from './noir-structs/nullifier_membership_witness_data.js';
34
35
  export type { PublicDataWitnessData } from './noir-structs/public_data_witness_data.js';
35
36
  export { TransientArrayService } from './transient_array_service.js';
36
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb250cmFjdF9mdW5jdGlvbl9zaW11bGF0b3IvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUNMLGVBQWUsRUFDZixTQUFTLEVBQ1QsS0FBSyxVQUFVLEVBQ2YsS0FBSyxtQkFBbUIsRUFDeEIsS0FBSyxVQUFVLEdBQ2hCLE1BQU0sNkJBQTZCLENBQUM7QUFDckMsT0FBTyxFQUNMLEtBQUssRUFDTCxLQUFLLEVBQ0wsYUFBYSxFQUNiLE1BQU0sRUFDTixVQUFVLEVBQ1YsWUFBWSxFQUNaLFlBQVksRUFDWixJQUFJLEVBQ0osV0FBVyxFQUNYLEVBQUUsRUFDRixpQkFBaUIsRUFDakIsYUFBYSxFQUNiLGVBQWUsRUFDZixXQUFXLEVBQ1gsd0JBQXdCLEVBQ3hCLEtBQUssRUFDTCxXQUFXLEVBQ1gsaUJBQWlCLEVBQ2pCLGlCQUFpQixFQUNqQixRQUFRLEVBQ1IsSUFBSSxFQUNKLFVBQVUsRUFDVixxQkFBcUIsRUFDckIsc0JBQXNCLEVBQ3RCLGtCQUFrQixFQUNsQixhQUFhLEVBQ2IsdUJBQXVCLEVBQ3ZCLE1BQU0sRUFDTixrQkFBa0IsRUFDbEIsS0FBSyxFQUNMLGVBQWUsRUFDZixXQUFXLEVBQ1gsTUFBTSxFQUNOLFdBQVcsRUFDWCxHQUFHLEVBQ0gsTUFBTSxFQUNOLE9BQU8sRUFDUCxHQUFHLEVBQ0gsR0FBRyxFQUNILElBQUksRUFDSixNQUFNLEVBQ04sYUFBYSxFQUNiLGNBQWMsRUFDZCxtQkFBbUIsRUFDbkIsdUJBQXVCLEVBQ3ZCLG1CQUFtQixFQUNuQix3QkFBd0IsRUFDeEIsZUFBZSxFQUNmLGVBQWUsRUFDZixlQUFlLEVBQ2YsS0FBSyxZQUFZLEVBQ2pCLEtBQUssaUJBQWlCLEVBQ3RCLEtBQUssZ0JBQWdCLEVBQ3JCLEtBQUsscUJBQXFCLEVBQzFCLEtBQUssaUJBQWlCLEVBQ3RCLEtBQUssc0JBQXNCLEVBQzNCLEtBQUss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
37
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb250cmFjdF9mdW5jdGlvbl9zaW11bGF0b3IvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUNMLGVBQWUsRUFDZixTQUFTLEVBQ1QsS0FBSyxVQUFVLEVBQ2YsS0FBSyxtQkFBbUIsRUFDeEIsS0FBSyxVQUFVLEdBQ2hCLE1BQU0sNkJBQTZCLENBQUM7QUFDckMsT0FBTyxFQUNMLEtBQUssRUFDTCxLQUFLLEVBQ0wsYUFBYSxFQUNiLE1BQU0sRUFDTixVQUFVLEVBQ1YsWUFBWSxFQUNaLFlBQVksRUFDWixJQUFJLEVBQ0osV0FBVyxFQUNYLEVBQUUsRUFDRixpQkFBaUIsRUFDakIsYUFBYSxFQUNiLGVBQWUsRUFDZixXQUFXLEVBQ1gsd0JBQXdCLEVBQ3hCLEtBQUssRUFDTCxXQUFXLEVBQ1gsaUJBQWlCLEVBQ2pCLGlCQUFpQixFQUNqQixRQUFRLEVBQ1IsSUFBSSxFQUNKLFVBQVUsRUFDVixxQkFBcUIsRUFDckIsc0JBQXNCLEVBQ3RCLGtCQUFrQixFQUNsQixhQUFhLEVBQ2IsdUJBQXVCLEVBQ3ZCLE1BQU0sRUFDTixrQkFBa0IsRUFDbEIsS0FBSyxFQUNMLGVBQWUsRUFDZixXQUFXLEVBQ1gsTUFBTSxFQUNOLFdBQVcsRUFDWCxHQUFHLEVBQ0gsTUFBTSxFQUNOLE9BQU8sRUFDUCxHQUFHLEVBQ0gsR0FBRyxFQUNILElBQUksRUFDSixNQUFNLEVBQ04sYUFBYSxFQUNiLGNBQWMsRUFDZCxtQkFBbUIsRUFDbkIsdUJBQXVCLEVBQ3ZCLG1CQUFtQixFQUNuQix3QkFBd0IsRUFDeEIsZUFBZSxFQUNmLGVBQWUsRUFDZixlQUFlLEVBQ2YsS0FBSyxZQUFZLEVBQ2pCLEtBQUssaUJBQWlCLEVBQ3RCLEtBQUssZ0JBQWdCLEVBQ3JCLEtBQUsscUJBQXFCLEVBQzFCLEtBQUssaUJBQWlCLEVBQ3RCLEtBQUssc0JBQXNCLEVBQzNCLEtBQUss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
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contract_function_simulator/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contract_function_simulator/index.ts"],"names":[],"mappings":"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"}
@@ -9,6 +9,7 @@ export { UtilityExecutionOracle } from './oracle/utility_execution_oracle.js';
9
9
  export { PrivateExecutionOracle } from './oracle/private_execution_oracle.js';
10
10
  export { buildACIRCallback, UnavailableOracleError } from './oracle/acir_callback.js';
11
11
  export { LEGACY_ORACLE_REGISTRY } from './oracle/legacy_oracle_registry.js';
12
+ export { PROTOCOL_ORACLE_REGISTRY } from './oracle/protocol_oracle_registry.js';
12
13
  export { executePrivateFunction, extractPrivateCircuitPublicInputs } from './oracle/private_execution.js';
13
14
  export { generateSimulatedProvingResult } from './contract_function_simulator.js';
14
15
  export { packAsHintedNote } from './oracle/note_packing_utils.js';
@@ -1,7 +1,9 @@
1
1
  import type { ACIRCallback } from '@aztec-labs/simulator/client';
2
+ import type { AztecAddress } from '@aztec-labs/stdlib/aztec-address';
2
3
  import type { IMiscOracle, IPrivateExecutionOracle, IUtilityExecutionOracle } from './interfaces.js';
3
4
  import { type LegacyOracleEntry } from './legacy_oracle_registry.js';
4
5
  import { type OracleRegistryEntry } from './oracle_registry.js';
6
+ import { type ProtocolOracleEntry } from './protocol_oracle_registry.js';
5
7
  export declare class UnavailableOracleError extends Error {
6
8
  constructor(oracleName: string);
7
9
  }
@@ -9,13 +11,16 @@ export declare class UnavailableOracleError extends Error {
9
11
  * Builds an ACIR callback from the oracle registry and a handler object.
10
12
  *
11
13
  * Each oracle call is dispatched by matching the oracle name against the registry for serialization, parsing the
12
- * `aztec_{scope}_{methodName}` convention to resolve the handler, and calling the method directly. Unknown oracle
13
- * names produce enhanced error messages based on the contract's oracle version.
14
+ * `aztec_{oracleKind}_{methodName}` convention to resolve the handler, and calling the method directly. Unknown
15
+ * oracle names produce enhanced error messages based on the contract's oracle version.
14
16
  */
15
- export declare function buildACIRCallback(handler: OracleHandler, registries?: {
16
- real?: Record<string, OracleRegistryEntry>;
17
- legacy?: Record<string, LegacyOracleEntry>;
17
+ export declare function buildACIRCallback(handler: OracleHandler, options?: {
18
+ /** The contract whose function the callback is built for. */
19
+ contractAddress?: AztecAddress;
20
+ currentRegistry?: Record<string, OracleRegistryEntry>;
21
+ legacyRegistry?: Record<string, LegacyOracleEntry>;
22
+ protocolRegistry?: Record<string, ProtocolOracleEntry>;
18
23
  }): ACIRCallback;
19
24
  type OracleHandler = IMiscOracle & (IUtilityExecutionOracle | IPrivateExecutionOracle);
20
25
  export {};
21
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWNpcl9jYWxsYmFjay5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2NvbnRyYWN0X2Z1bmN0aW9uX3NpbXVsYXRvci9vcmFjbGUvYWNpcl9jYWxsYmFjay50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQWEsTUFBTSw4QkFBOEIsQ0FBQztBQUc1RSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsdUJBQXVCLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUNyRyxPQUFPLEVBQTBCLEtBQUssaUJBQWlCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUM3RixPQUFPLEVBQW9DLEtBQUssbUJBQW1CLEVBQWEsTUFBTSxzQkFBc0IsQ0FBQztBQUU3RyxxQkFBYSxzQkFBdUIsU0FBUSxLQUFLO0lBQy9DLFlBQVksVUFBVSxFQUFFLE1BQU0sRUFFN0I7Q0FDRjtBQUVEOzs7Ozs7R0FNRztBQUNILHdCQUFnQixpQkFBaUIsQ0FDL0IsT0FBTyxFQUFFLGFBQWEsRUFDdEIsVUFBVSxHQUFFO0lBQ1YsSUFBSSxDQUFDLEVBQUUsTUFBTSxDQUFDLE1BQU0sRUFBRSxtQkFBbUIsQ0FBQyxDQUFDO0lBQzNDLE1BQU0sQ0FBQyxFQUFFLE1BQU0sQ0FBQyxNQUFNLEVBQUUsaUJBQWlCLENBQUMsQ0FBQztDQUN2QyxHQUNMLFlBQVksQ0FzQ2Q7QUErREQsS0FBSyxhQUFhLEdBQUcsV0FBVyxHQUFHLENBQUMsdUJBQXVCLEdBQUcsdUJBQXVCLENBQUMsQ0FBQyJ9
26
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWNpcl9jYWxsYmFjay5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2NvbnRyYWN0X2Z1bmN0aW9uX3NpbXVsYXRvci9vcmFjbGUvYWNpcl9jYWxsYmFjay50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQWEsTUFBTSw4QkFBOEIsQ0FBQztBQUM1RSxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSxrQ0FBa0MsQ0FBQztBQUdyRSxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsdUJBQXVCLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUNyRyxPQUFPLEVBQTBCLEtBQUssaUJBQWlCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUM3RixPQUFPLEVBQW9DLEtBQUssbUJBQW1CLEVBQWEsTUFBTSxzQkFBc0IsQ0FBQztBQUM3RyxPQUFPLEVBQTRCLEtBQUssbUJBQW1CLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUVuRyxxQkFBYSxzQkFBdUIsU0FBUSxLQUFLO0lBQy9DLFlBQVksVUFBVSxFQUFFLE1BQU0sRUFFN0I7Q0FDRjtBQUVEOzs7Ozs7R0FNRztBQUNILHdCQUFnQixpQkFBaUIsQ0FDL0IsT0FBTyxFQUFFLGFBQWEsRUFDdEIsT0FBTyxHQUFFO0lBQ1AsNkRBQTZEO0lBQzdELGVBQWUsQ0FBQyxFQUFFLFlBQVksQ0FBQztJQUMvQixlQUFlLENBQUMsRUFBRSxNQUFNLENBQUMsTUFBTSxFQUFFLG1CQUFtQixDQUFDLENBQUM7SUFDdEQsY0FBYyxDQUFDLEVBQUUsTUFBTSxDQUFDLE1BQU0sRUFBRSxpQkFBaUIsQ0FBQyxDQUFDO0lBQ25ELGdCQUFnQixDQUFDLEVBQUUsTUFBTSxDQUFDLE1BQU0sRUFBRSxtQkFBbUIsQ0FBQyxDQUFDO0NBQ25ELEdBQ0wsWUFBWSxDQStEZDtBQXNFRCxLQUFLLGFBQWEsR0FBRyxXQUFXLEdBQUcsQ0FBQyx1QkFBdUIsR0FBRyx1QkFBdUIsQ0FBQyxDQUFDIn0=
@@ -1 +1 @@
1
- {"version":3,"file":"acir_callback.d.ts","sourceRoot":"","sources":["../../../src/contract_function_simulator/oracle/acir_callback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,8BAA8B,CAAC;AAG5E,OAAO,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACrG,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAC7F,OAAO,EAAoC,KAAK,mBAAmB,EAAa,MAAM,sBAAsB,CAAC;AAE7G,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,UAAU,EAAE,MAAM,EAE7B;CACF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EACtB,UAAU,GAAE;IACV,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CACvC,GACL,YAAY,CAsCd;AA+DD,KAAK,aAAa,GAAG,WAAW,GAAG,CAAC,uBAAuB,GAAG,uBAAuB,CAAC,CAAC"}
1
+ {"version":3,"file":"acir_callback.d.ts","sourceRoot":"","sources":["../../../src/contract_function_simulator/oracle/acir_callback.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAGrE,OAAO,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACrG,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAC7F,OAAO,EAAoC,KAAK,mBAAmB,EAAa,MAAM,sBAAsB,CAAC;AAC7G,OAAO,EAA4B,KAAK,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEnG,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,UAAU,EAAE,MAAM,EAE7B;CACF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE;IACP,6DAA6D;IAC7D,eAAe,CAAC,EAAE,YAAY,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CACnD,GACL,YAAY,CA+Dd;AAsED,KAAK,aAAa,GAAG,WAAW,GAAG,CAAC,uBAAuB,GAAG,uBAAuB,CAAC,CAAC"}
@@ -1,6 +1,8 @@
1
- import { ORACLE_VERSION_MAJOR, ORACLE_VERSION_MINOR } from '../../oracle_version.js';
1
+ import { isProtocolContract } from '@aztec-labs/protocol-contracts';
2
+ import { ORACLE_VERSION_MAJOR, ORACLE_VERSION_MINOR, PROTOCOL_ORACLE_VERSION } from '../../oracle_version.js';
2
3
  import { LEGACY_ORACLE_REGISTRY } from './legacy_oracle_registry.js';
3
4
  import { ORACLE_REGISTRY, makeEntry } from './oracle_registry.js';
5
+ import { PROTOCOL_ORACLE_REGISTRY } from './protocol_oracle_registry.js';
4
6
  export class UnavailableOracleError extends Error {
5
7
  constructor(oracleName){
6
8
  super(`${oracleName} oracles not available with the current handler`);
@@ -10,15 +12,15 @@ export class UnavailableOracleError extends Error {
10
12
  * Builds an ACIR callback from the oracle registry and a handler object.
11
13
  *
12
14
  * Each oracle call is dispatched by matching the oracle name against the registry for serialization, parsing the
13
- * `aztec_{scope}_{methodName}` convention to resolve the handler, and calling the method directly. Unknown oracle
14
- * names produce enhanced error messages based on the contract's oracle version.
15
- */ export function buildACIRCallback(handler, registries = {}) {
16
- const { real = ORACLE_REGISTRY, legacy: legacyRegistry = LEGACY_ORACLE_REGISTRY } = registries;
15
+ * `aztec_{oracleKind}_{methodName}` convention to resolve the handler, and calling the method directly. Unknown
16
+ * oracle names produce enhanced error messages based on the contract's oracle version.
17
+ */ export function buildACIRCallback(handler, options = {}) {
18
+ const { contractAddress, currentRegistry = ORACLE_REGISTRY, legacyRegistry = LEGACY_ORACLE_REGISTRY, protocolRegistry = PROTOCOL_ORACLE_REGISTRY } = options;
17
19
  const target = {};
18
- for (const [oracleKey, entry] of Object.entries(real)){
19
- const { scope, methodName } = parseOracleName(oracleKey, 'Oracle');
20
+ for (const [oracleKey, entry] of Object.entries(currentRegistry)){
21
+ const { oracleKind, methodName } = parseOracleName(oracleKey, 'Oracle');
20
22
  target[oracleKey] = async (...inputs)=>{
21
- assertHandlerSupportsScope(handler, scope);
23
+ assertHandlerSupportsOracleKind(handler, oracleKind);
22
24
  const named = entry.deserializeParams(inputs);
23
25
  const positional = named.map((p)=>p.value);
24
26
  const result = await handler[methodName](...positional);
@@ -28,11 +30,11 @@ export class UnavailableOracleError extends Error {
28
30
  // Legacy oracle names: served for contracts compiled against a retired oracle version. Each reuses the current
29
31
  // handler of its `modernOracle` and reshapes the wire (params and/or return) back to what the old bytecode expects.
30
32
  for (const [legacyKey, legacy] of Object.entries(legacyRegistry)){
31
- const { scope } = parseOracleName(legacyKey, 'Legacy oracle');
33
+ const { oracleKind } = parseOracleName(legacyKey, 'Legacy oracle');
32
34
  if (legacyKey in target) {
33
35
  throw new Error(`Legacy oracle "${legacyKey}" collides with a live oracle of the same name in the registry`);
34
36
  }
35
- const modernEntry = real[legacy.modernOracle];
37
+ const modernEntry = currentRegistry[legacy.modernOracle];
36
38
  const { methodName } = parseOracleName(legacy.modernOracle, 'Oracle');
37
39
  // Override only the side whose wire changed; inherit the other from the modern entry.
38
40
  const paramOverride = legacy.params;
@@ -46,29 +48,51 @@ export class UnavailableOracleError extends Error {
46
48
  returnType: returnOverride.legacyType
47
49
  }) : modernEntry;
48
50
  target[legacyKey] = async (...inputs)=>{
49
- assertHandlerSupportsScope(handler, scope);
51
+ assertHandlerSupportsOracleKind(handler, oracleKind);
50
52
  const legacyArgs = paramSource.deserializeParams(inputs).map((p)=>p.value);
51
53
  const positional = paramOverride ? await paramOverride.mapping(legacyArgs) : legacyArgs;
52
54
  const result = await handler[methodName](...positional);
53
55
  return returnSource.serializeReturn(returnOverride ? returnOverride.mapping(result) : result);
54
56
  };
55
57
  }
56
- return new Proxy(target, makeUnknownOracleTrap(handler));
58
+ // Protocol oracle names: served to protocol contracts only, each with its own wire.
59
+ const calledByProtocolContract = contractAddress !== undefined && isProtocolContract(contractAddress);
60
+ for (const [protocolKey, protocol] of Object.entries(protocolRegistry)){
61
+ if (protocolKey in target) {
62
+ throw new Error(`Protocol oracle "${protocolKey}" collides with another oracle of the same name`);
63
+ }
64
+ const wire = makeEntry({
65
+ params: [
66
+ ...protocol.params
67
+ ],
68
+ returnType: protocol.returnType
69
+ });
70
+ target[protocolKey] = async (...inputs)=>{
71
+ if (!calledByProtocolContract) {
72
+ const caller = contractAddress ?? 'a caller that is not a contract';
73
+ throw new Error(`Oracle '${protocolKey}' can only be called by protocol contracts, but was called by ${caller}`);
74
+ }
75
+ assertHandlerSupportsOracleKind(handler, protocol.oracleKind);
76
+ const args = wire.deserializeParams(inputs).map((p)=>p.value);
77
+ return wire.serializeReturn(await protocol.serve(handler, args));
78
+ };
79
+ }
80
+ return new Proxy(target, makeUnknownOracleTrap(handler, calledByProtocolContract));
57
81
  }
58
- /** Parses an `aztec_{scope}_{method}` oracle name into its parts, throwing if it doesn't follow the convention. */ function parseOracleName(key, label) {
82
+ /** Parses an `aztec_{oracleKind}_{method}` oracle name into its parts, throwing if it doesn't follow the convention. */ function parseOracleName(key, label) {
59
83
  const match = key.match(/^aztec_(\w+?)_(.+)$/);
60
84
  if (!match) {
61
- throw new Error(`${label} "${key}" does not follow the aztec_{scope}_{method} convention`);
85
+ throw new Error(`${label} "${key}" does not follow the aztec_{oracleKind}_{method} convention`);
62
86
  }
63
87
  return {
64
- scope: match[1],
88
+ oracleKind: match[1],
65
89
  methodName: match[2]
66
90
  };
67
91
  }
68
92
  /**
69
93
  * Proxy trap for the callback table: a known oracle name passes through; an unknown one throws a diagnostic keyed on
70
94
  * the contract's oracle version (version unknown, contract newer than this environment, or a same-version mismatch).
71
- */ function makeUnknownOracleTrap(handler) {
95
+ */ function makeUnknownOracleTrap(handler, calledByProtocolContract) {
72
96
  return {
73
97
  get (obj, prop) {
74
98
  // Own-property check only: `in` would match inherited `Object.prototype` keys (e.g. `constructor`, `toString`)
@@ -77,6 +101,9 @@ export class UnavailableOracleError extends Error {
77
101
  return obj[prop];
78
102
  }
79
103
  return ()=>{
104
+ if (calledByProtocolContract) {
105
+ throw new Error(`Oracle '${prop}' not found. It was called by a protocol contract, whose oracles are those of protocol` + ` oracle version ${PROTOCOL_ORACLE_VERSION}.`);
106
+ }
80
107
  let contractVersion = undefined;
81
108
  if ('nonOracleFunctionGetContractOracleVersion' in handler) {
82
109
  contractVersion = handler.nonOracleFunctionGetContractOracleVersion();
@@ -92,8 +119,8 @@ export class UnavailableOracleError extends Error {
92
119
  }
93
120
  };
94
121
  }
95
- function assertHandlerSupportsScope(handler, scope) {
96
- switch(scope){
122
+ function assertHandlerSupportsOracleKind(handler, oracleKind) {
123
+ switch(oracleKind){
97
124
  case 'misc':
98
125
  if (!('isMisc' in handler)) {
99
126
  throw new UnavailableOracleError('Misc');
@@ -110,6 +137,6 @@ function assertHandlerSupportsScope(handler, scope) {
110
137
  }
111
138
  break;
112
139
  default:
113
- throw new Error(`Unknown oracle scope: ${scope}`);
140
+ throw new Error(`Unknown oracle kind: ${oracleKind}`);
114
141
  }
115
142
  }
@@ -128,7 +128,7 @@ export type ParamTypes<T extends readonly NamedValue[]> = {
128
128
  export type InferDeserializedParams<T extends RegistryParam[]> = {
129
129
  [K in keyof T]: T[K] extends RegistryParam<infer N, infer V> ? NamedValue<N, V> : never;
130
130
  };
131
- /** Strips the `aztec_{scope}_` prefix from an oracle key to get the handler method name. */
131
+ /** Strips the `aztec_{oracleKind}_` prefix from an oracle key to get the handler method name. */
132
132
  type StripOraclePrefix<K extends string> = K extends `aztec_${string}_${infer M}` ? M : never;
133
133
  /** Derives the handler function signature from a registry entry's deserialization/serialization types. */
134
134
  type HandlerFn<E extends OracleRegistryEntry> = (...args: ParamTypes<ReturnType<E['deserializeParams']>>) => MaybePromise<Parameters<E['serializeReturn']>[0]>;
@@ -136,4 +136,4 @@ type HandlerFn<E extends OracleRegistryEntry> = (...args: ParamTypes<ReturnType<
136
136
  export type HandlersForPrefix<R extends Record<string, OracleRegistryEntry>, P extends string> = {
137
137
  [K in keyof R as K extends `aztec_${P}_${string}` ? StripOraclePrefix<K & string> : never]: HandlerFn<R[K]>;
138
138
  };
139
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3JhY2xlX3JlZ2lzdHJ5LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvY29udHJhY3RfZnVuY3Rpb25fc2ltdWxhdG9yL29yYWNsZS9vcmFjbGVfcmVnaXN0cnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLHFDQUFxQyxDQUFDO0FBR3pELE9BQU8sS0FBSyxFQUFFLHdCQUF3QixFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFFN0UsT0FBTyxFQWlCTCxLQUFLLFNBQVMsRUFLZCxLQUFLLFlBQVksRUFPakIsS0FBSyxVQUFVLEVBWWYsS0FBSyxXQUFXLEVBTWpCLE1BQU0sMkJBQTJCLENBQUM7QUFFbkMsT0FBTyxFQUNMLEtBQUssRUFDTCxhQUFhLEVBQ2IsTUFBTSxFQUNOLFlBQVksRUFDWixJQUFJLEVBQ0osV0FBVyxFQUNYLEVBQUUsRUFDRixhQUFhLEVBQ2IseUJBQXlCLEVBQ3pCLGVBQWUsRUFDZix3QkFBd0IsRUFDeEIsS0FBSyxFQUNMLGlCQUFpQixFQUNqQixxQkFBcUIsRUFDckIsc0JBQXNCLEVBQ3RCLGtCQUFrQixFQUNsQix1QkFBdUIsRUFDdkIsTUFBTSxFQUNOLGtCQUFrQixFQUNsQixLQUFLLEVBQ0wsZUFBZSxFQUNmLFdBQVcsRUFDWCxHQUFHLEVBQ0gsR0FBRyxFQUNILE9BQU8sRUFDUCxLQUFLLFNBQVMsRUFDZCxLQUFLLFlBQVksRUFDakIsS0FBSyxVQUFVLEVBQ2YsS0FBSyxTQUFTLEVBQ2QsS0FBSyxXQUFXLEdBQ2pCLE1BQU0sMkJBQTJCLENBQUM7QUFFbkMsZUFBTyxNQUFNLGVBQWU7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztDQXVmbUIsQ0FBQztBQUloRDs7Ozs7R0FLRztBQUNILE1BQU0sV0FBVyxtQkFBbUIsQ0FDbEMsbUJBQW1CLFNBQVMsU0FB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
139
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3JhY2xlX3JlZ2lzdHJ5LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvY29udHJhY3RfZnVuY3Rpb25fc2ltdWxhdG9yL29yYWNsZS9vcmFjbGVfcmVnaXN0cnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBRUEsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLHFDQUFxQyxDQUFDO0FBR3pELE9BQU8sS0FBSyxFQUFFLHdCQUF3QixFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFFN0UsT0FBTyxFQWlCTCxLQUFLLFNBQVMsRUFLZCxLQUFLLFlBQVksRUFPakIsS0FBSyxVQUFVLEVBWWYsS0FBSyxXQUFXLEVBTWpCLE1BQU0sMkJBQTJCLENBQUM7QUFFbkMsT0FBTyxFQUNMLEtBQUssRUFDTCxhQUFhLEVBQ2IsTUFBTSxFQUNOLFlBQVksRUFDWixJQUFJLEVBQ0osV0FBVyxFQUNYLEVBQUUsRUFDRixhQUFhLEVBQ2IseUJBQXlCLEVBQ3pCLGVBQWUsRUFDZix3QkFBd0IsRUFDeEIsS0FBSyxFQUNMLGlCQUFpQixFQUNqQixxQkFBcUIsRUFDckIsc0JBQXNCLEVBQ3RCLGtCQUFrQixFQUNsQix1QkFBdUIsRUFDdkIsTUFBTSxFQUNOLGtCQUFrQixFQUNsQixLQUFLLEVBQ0wsZUFBZSxFQUNmLFdBQVcsRUFDWCxHQUFHLEVBQ0gsR0FBRyxFQUNILE9BQU8sRUFDUCxLQUFLLFNBQVMsRUFDZCxLQUFLLFlBQVksRUFDakIsS0FBSyxVQUFVLEVBQ2YsS0FBSyxTQUFTLEVBQ2QsS0FBSyxXQUFXLEdBQ2pCLE1BQU0sMkJBQTJCLENBQUM7QUFFbkMsZUFBTyxNQUFNLGVBQWU7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztDQXVmbUIsQ0FBQztBQUloRDs7Ozs7R0FLRztBQUNILE1BQU0sV0FBVyxtQkFBbUIsQ0FDbEMsbUJBQW1CLFNBQVMsU0FB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
@@ -1 +1 @@
1
- {"version":3,"file":"oracle_registry.d.ts","sourceRoot":"","sources":["../../../src/contract_function_simulator/oracle/oracle_registry.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"oracle_registry.d.ts","sourceRoot":"","sources":["../../../src/contract_function_simulator/oracle/oracle_registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAE,MAAM,qCAAqC,CAAC;AAGzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAE7E,OAAO,EAiBL,KAAK,SAAS,EAKd,KAAK,YAAY,EAOjB,KAAK,UAAU,EAYf,KAAK,WAAW,EAMjB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,KAAK,EACL,aAAa,EACb,MAAM,EACN,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,EAAE,EACF,aAAa,EACb,yBAAyB,EACzB,eAAe,EACf,wBAAwB,EACxB,KAAK,EACL,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,MAAM,EACN,kBAAkB,EAClB,KAAK,EACL,eAAe,EACf,WAAW,EACX,GAAG,EACH,GAAG,EACH,OAAO,EACP,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,2BAA2B,CAAC;AAEnC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAufmB,CAAC;AAIhD;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB,CAClC,mBAAmB,SAAS,SAAS,UAAU,EAAE,GAAG,SAAS,UAAU,EAAE,EACzE,YAAY,GAAG,GAAG;IAElB,wEAAwE;IACxE,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,mBAAmB,CAAC;IAC5D,+DAA+D;IAC/D,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,EAAE,CAAC;IACpD,mHAAmH;IACnH,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,sFAAsF;IACtF,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;CACjD;AAED,wBAAgB,SAAS,CAAC,KAAK,CAAC,OAAO,SAAS,aAAa,EAAE,GAAG,EAAE,EAAE,YAAY,GAAG,IAAI,EAAE,EACzF,MAAM,EACN,UAAU,EACX,GAAE;IACD,MAAM,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC;IACtB,UAAU,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;CACnC,GAAG,mBAAmB,CAAC,uBAAuB,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,CAwC3E;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,GAAG;IACnE,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;CACtB;AAED,6DAA6D;AAC7D,MAAM,MAAM,UAAU,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,GAAG,IAAI;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvH;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,SAAS,UAAU,EAAE,IAAI;KACvD,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CACrE,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,aAAa,EAAE,IAAI;KAC9D,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK;CACxF,CAAC;AAIF,iGAAiG;AACjG,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,SAAS,MAAM,IAAI,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AAE9F,0GAA0G;AAC1G,KAAK,SAAS,CAAC,CAAC,SAAS,mBAAmB,IAAI,CAC9C,GAAG,IAAI,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,KACpD,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEvD,6FAA6F;AAC7F,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI;KAC9F,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,IAAI,MAAM,EAAE,GAAG,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5G,CAAC"}
@@ -21,7 +21,9 @@ import { buildACIRCallback } from './acir_callback.js';
21
21
  });
22
22
  const initialWitness = privateExecutionOracle.getInitialWitness(artifact);
23
23
  const timer = new Timer();
24
- const acirExecutionResult = await simulator.executeUserCircuit(initialWitness, artifact, buildACIRCallback(privateExecutionOracle)).catch((err)=>{
24
+ const acirExecutionResult = await simulator.executeUserCircuit(initialWitness, artifact, buildACIRCallback(privateExecutionOracle, {
25
+ contractAddress
26
+ })).catch((err)=>{
25
27
  err.message = resolveAssertionMessageFromError(err, artifact);
26
28
  throw new ExecutionError(err.message, {
27
29
  contractAddress,
@@ -0,0 +1,31 @@
1
+ import type { IMiscOracle, IPrivateExecutionOracle, IUtilityExecutionOracle } from './interfaces.js';
2
+ import type { RegistryParam } from './oracle_registry.js';
3
+ import { type TypeMapping } from './oracle_type_mappings.js';
4
+ type OracleHandlers = {
5
+ misc: IMiscOracle;
6
+ utl: IUtilityExecutionOracle;
7
+ prv: IPrivateExecutionOracle;
8
+ };
9
+ /** An oracle served to the protocol contracts. */
10
+ export interface ProtocolOracleEntry<TOracleKind extends keyof OracleHandlers = keyof OracleHandlers> {
11
+ /** Which oracle handler `serve` takes. */
12
+ oracleKind: TOracleKind;
13
+ /** The ordered named parameters of the wire, with their {@link TypeMapping}s. */
14
+ params: readonly RegistryParam[];
15
+ /** The return {@link TypeMapping} of the wire, or `undefined` for oracles that return nothing. */
16
+ returnType?: TypeMapping;
17
+ /** Serves a call from its deserialized args, returning the value `returnType` serializes. */
18
+ serve: (handler: any, args: any) => unknown;
19
+ }
20
+ /**
21
+ * Oracles served to the protocol contracts, keyed by the name their bytecode calls. Protocol contracts are only
22
+ * redeployed on a protocol upgrade, so their oracle interface is versioned by `PROTOCOL_ORACLE_VERSION` rather than by
23
+ * the aztec.nr oracle version: the names and wires declared here must stay as they are no matter how `ORACLE_REGISTRY`
24
+ * changes.
25
+ *
26
+ * Each entry declares its full wire and how to serve it with the oracle handler, so that a change to the handler only
27
+ * requires adapting `serve`.
28
+ */
29
+ export declare const PROTOCOL_ORACLE_REGISTRY: Record<string, ProtocolOracleEntry<keyof OracleHandlers>>;
30
+ export {};
31
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvdG9jb2xfb3JhY2xlX3JlZ2lzdHJ5LmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvY29udHJhY3RfZnVuY3Rpb25fc2ltdWxhdG9yL29yYWNsZS9wcm90b2NvbF9vcmFjbGVfcmVnaXN0cnkudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBTUEsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLHVCQUF1QixFQUFFLHVCQUF1QixFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFDckcsT0FBTyxLQUFLLEVBQXVDLGFBQWEsRUFBRSxNQUFNLHNCQUFzQixDQUFDO0FBQy9GLE9BQU8sRUFTTCxLQUFLLFdBQVcsRUFFakIsTUFBTSwyQkFBMkIsQ0FBQztBQUVuQyxLQUFLLGNBQWMsR0FBRztJQUNwQixJQUFJLEVBQUUsV0FBVyxDQUFDO0lBQ2xCLEdBQUcsRUFBRSx1QkFBdUIsQ0FBQztJQUM3QixHQUFHLEVBQUUsdUJBQXVCLENBQUM7Q0FDOUIsQ0FBQztBQUVGLGtEQUFrRDtBQUNsRCxNQUFNLFdBQVcsbUJBQW1CLENBQUMsV0FBVyxTQUFTLE1BQU0sY0FBYyxHQUFHLE1BQU0sY0FBYztJQUNsRywwQ0FBMEM7SUFDMUMsVUFBVSxFQUFFLFdBQVcsQ0FBQztJQUN4QixpRkFBaUY7SUFDakYsTUFBTSxFQUFFLFNBQVMsYUFBYSxFQUFFLENBQUM7SUFDakMsa0dBQWtHO0lBQ2xHLFVBQVUsQ0FBQyxFQUFFLFdBQVcsQ0FBQztJQUN6Qiw2RkFBNkY7SUFDN0YsS0FBSyxFQUFFLENBQUMsT0FBTyxFQUFFLEdBQUcsRUFBRSxJQUFJLEVBQUUsR0FBRyxLQUFLLE9BQU8sQ0FBQztDQUM3QztBQW1DRDs7Ozs7Ozs7R0FRRztBQUNILGVBQU8sTUFBTSx3QkFBd0IsMkRBOEZuQyxDQUFDIn0=
@@ -0,0 +1 @@
1
+ {"version":3,"file":"protocol_oracle_registry.d.ts","sourceRoot":"","sources":["../../../src/contract_function_simulator/oracle/protocol_oracle_registry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACrG,OAAO,KAAK,EAAuC,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EASL,KAAK,WAAW,EAEjB,MAAM,2BAA2B,CAAC;AAEnC,KAAK,cAAc,GAAG;IACpB,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,EAAE,uBAAuB,CAAC;IAC7B,GAAG,EAAE,uBAAuB,CAAC;CAC9B,CAAC;AAEF,kDAAkD;AAClD,MAAM,WAAW,mBAAmB,CAAC,WAAW,SAAS,MAAM,cAAc,GAAG,MAAM,cAAc;IAClG,0CAA0C;IAC1C,UAAU,EAAE,WAAW,CAAC;IACxB,iFAAiF;IACjF,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,kGAAkG;IAClG,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,6FAA6F;IAC7F,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC;CAC7C;AAmCD;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,2DA8FnC,CAAC"}
@@ -0,0 +1,183 @@
1
+ /* eslint-disable camelcase */ import { L1_TO_L2_MSG_TREE_HEIGHT } from '@aztec-labs/constants';
2
+ import { computeFeeJuiceMessageNullifier } from '@aztec-labs/stdlib/messaging';
3
+ import { PROTOCOL_ORACLE_VERSION } from '../../oracle_version.js';
4
+ import { Option } from '../noir-structs/option.js';
5
+ import { ARRAY, AZTEC_ADDRESS, BOOL, FIELD, MEMBERSHIP_WITNESS, OPTION, STR, U32 } from './oracle_type_mappings.js';
6
+ function protocolOracle(oracleKind, entry) {
7
+ return {
8
+ oracleKind,
9
+ ...entry
10
+ };
11
+ }
12
+ /**
13
+ * Rejects at compile time any entry whose `oracleKind` is not the one its oracle name declares, e.g. if an oracle with
14
+ * the 'aztec_protocol_prv' prefix is declared as kind 'misc'.
15
+ */ function protocolOracleRegistry(registry) {
16
+ return registry;
17
+ }
18
+ /**
19
+ * Oracles served to the protocol contracts, keyed by the name their bytecode calls. Protocol contracts are only
20
+ * redeployed on a protocol upgrade, so their oracle interface is versioned by `PROTOCOL_ORACLE_VERSION` rather than by
21
+ * the aztec.nr oracle version: the names and wires declared here must stay as they are no matter how `ORACLE_REGISTRY`
22
+ * changes.
23
+ *
24
+ * Each entry declares its full wire and how to serve it with the oracle handler, so that a change to the handler only
25
+ * requires adapting `serve`.
26
+ */ export const PROTOCOL_ORACLE_REGISTRY = protocolOracleRegistry({
27
+ aztec_protocol_misc_assertCompatibleOracleVersion: protocolOracle('misc', {
28
+ params: [
29
+ {
30
+ name: 'version',
31
+ type: U32
32
+ }
33
+ ],
34
+ serve: (_handler, [version])=>{
35
+ // This oracle is handled here directly because no other PXE oracle deals with protocol oracle interface
36
+ // versioning.
37
+ if (version !== PROTOCOL_ORACLE_VERSION) {
38
+ throw new Error(`Incompatible protocol oracle version: the protocol contract expects version ${version}, but this PXE serves version ${PROTOCOL_ORACLE_VERSION}.`);
39
+ }
40
+ }
41
+ }),
42
+ aztec_protocol_misc_log: protocolOracle('misc', {
43
+ params: [
44
+ {
45
+ name: 'level',
46
+ type: U32
47
+ },
48
+ {
49
+ name: 'message',
50
+ type: STR
51
+ },
52
+ {
53
+ name: 'fieldsSize',
54
+ type: U32
55
+ },
56
+ {
57
+ name: 'fields',
58
+ type: ARRAY(FIELD)
59
+ }
60
+ ],
61
+ serve: (handler, [level, message, fieldsSize, fields])=>handler.log(level, message, fieldsSize, fields)
62
+ }),
63
+ aztec_protocol_utl_getCapsule: protocolOracle('utl', {
64
+ params: [
65
+ {
66
+ name: 'contractAddress',
67
+ type: AZTEC_ADDRESS
68
+ },
69
+ {
70
+ name: 'slot',
71
+ type: FIELD
72
+ },
73
+ {
74
+ name: 'tSize',
75
+ type: U32
76
+ },
77
+ {
78
+ name: 'scope',
79
+ type: AZTEC_ADDRESS
80
+ }
81
+ ],
82
+ returnType: OPTION(ARRAY(FIELD)),
83
+ serve: (handler, [contractAddress, slot, tSize, scope])=>handler.getCapsule(contractAddress, slot, tSize, scope)
84
+ }),
85
+ aztec_protocol_utl_getL1ToL2MembershipWitness: protocolOracle('utl', {
86
+ params: [
87
+ {
88
+ name: 'contractAddress',
89
+ type: AZTEC_ADDRESS
90
+ },
91
+ {
92
+ name: 'messageHash',
93
+ type: FIELD
94
+ },
95
+ {
96
+ name: 'secret',
97
+ type: FIELD
98
+ }
99
+ ],
100
+ returnType: MEMBERSHIP_WITNESS(L1_TO_L2_MSG_TREE_HEIGHT),
101
+ // The regular PXE handler takes the unsiloed message nullifier instead of the secret it is derived from. The only
102
+ // protocol contract that uses this oracle is the FeeJuice contract, so we apply its derivation.
103
+ serve: async (handler, [contractAddress, messageHash, secret])=>handler.getL1ToL2MembershipWitnessV2(messageHash, Option.some({
104
+ contractAddress,
105
+ nullifier: await computeFeeJuiceMessageNullifier(messageHash, secret)
106
+ }))
107
+ }),
108
+ aztec_protocol_prv_setHashPreimage: protocolOracle('prv', {
109
+ params: [
110
+ {
111
+ name: 'values',
112
+ type: ARRAY(FIELD)
113
+ },
114
+ {
115
+ name: 'hash',
116
+ type: FIELD
117
+ }
118
+ ],
119
+ serve: (handler, [values, hash])=>handler.setHashPreimage(values, hash)
120
+ }),
121
+ aztec_protocol_prv_notifyCreatedNullifier: protocolOracle('prv', {
122
+ params: [
123
+ {
124
+ name: 'innerNullifier',
125
+ type: FIELD
126
+ }
127
+ ],
128
+ serve: (handler, [innerNullifier])=>handler.notifyCreatedNullifier(innerNullifier)
129
+ }),
130
+ aztec_protocol_prv_isNullifierPending: protocolOracle('prv', {
131
+ params: [
132
+ {
133
+ name: 'innerNullifier',
134
+ type: FIELD
135
+ },
136
+ {
137
+ name: 'contractAddress',
138
+ type: AZTEC_ADDRESS
139
+ }
140
+ ],
141
+ returnType: BOOL,
142
+ serve: (handler, [innerNullifier, contractAddress])=>handler.isNullifierPending(innerNullifier, contractAddress)
143
+ }),
144
+ aztec_protocol_prv_notifyCreatedContractClassLog: protocolOracle('prv', {
145
+ params: [
146
+ {
147
+ name: 'contractAddress',
148
+ type: AZTEC_ADDRESS
149
+ },
150
+ {
151
+ name: 'message',
152
+ type: ARRAY(FIELD)
153
+ },
154
+ {
155
+ name: 'length',
156
+ type: U32
157
+ },
158
+ {
159
+ name: 'counter',
160
+ type: U32
161
+ }
162
+ ],
163
+ serve: (handler, [contractAddress, message, length, counter])=>handler.notifyCreatedContractClassLog(contractAddress, message, length, counter)
164
+ }),
165
+ aztec_protocol_prv_assertValidPublicCalldata: protocolOracle('prv', {
166
+ params: [
167
+ {
168
+ name: 'calldataHash',
169
+ type: FIELD
170
+ }
171
+ ],
172
+ serve: (handler, [calldataHash])=>handler.assertValidPublicCalldata(calldataHash)
173
+ }),
174
+ aztec_protocol_prv_notifyRevertiblePhaseStart: protocolOracle('prv', {
175
+ params: [
176
+ {
177
+ name: 'minRevertibleSideEffectCounter',
178
+ type: U32
179
+ }
180
+ ],
181
+ serve: (handler, [minRevertibleSideEffectCounter])=>handler.notifyRevertiblePhaseStart(minRevertibleSideEffectCounter)
182
+ })
183
+ });