@aztec/aztec.js 0.0.1-commit.c7c42ec → 0.0.1-commit.d1f2d6c

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 (161) hide show
  1. package/dest/account/account.d.ts +25 -40
  2. package/dest/account/account.d.ts.map +1 -1
  3. package/dest/account/account.js +19 -47
  4. package/dest/account/account_contract.d.ts +8 -9
  5. package/dest/account/account_contract.d.ts.map +1 -1
  6. package/dest/account/account_with_secret_key.d.ts +19 -7
  7. package/dest/account/account_with_secret_key.d.ts.map +1 -1
  8. package/dest/account/account_with_secret_key.js +21 -4
  9. package/dest/account/index.d.ts +3 -2
  10. package/dest/account/index.d.ts.map +1 -1
  11. package/dest/account/index.js +2 -0
  12. package/dest/account/signerless_account.d.ts +5 -6
  13. package/dest/account/signerless_account.d.ts.map +1 -1
  14. package/dest/account/signerless_account.js +8 -11
  15. package/dest/api/account.d.ts +2 -4
  16. package/dest/api/account.d.ts.map +1 -1
  17. package/dest/api/account.js +1 -3
  18. package/dest/api/authorization.d.ts +2 -2
  19. package/dest/api/authorization.d.ts.map +1 -1
  20. package/dest/api/authorization.js +1 -1
  21. package/dest/api/contract.d.ts +16 -10
  22. package/dest/api/contract.d.ts.map +1 -1
  23. package/dest/api/contract.js +14 -8
  24. package/dest/api/node.d.ts +8 -4
  25. package/dest/api/node.d.ts.map +1 -1
  26. package/dest/api/node.js +7 -3
  27. package/dest/api/protocol.d.ts +7 -1
  28. package/dest/api/protocol.d.ts.map +1 -1
  29. package/dest/api/protocol.js +6 -0
  30. package/dest/api/tx.d.ts +2 -2
  31. package/dest/api/tx.d.ts.map +1 -1
  32. package/dest/api/tx.js +1 -1
  33. package/dest/api/wallet.d.ts +2 -2
  34. package/dest/api/wallet.d.ts.map +1 -1
  35. package/dest/api/wallet.js +1 -1
  36. package/dest/authorization/call_authorization_request.d.ts +22 -1
  37. package/dest/authorization/call_authorization_request.d.ts.map +1 -1
  38. package/dest/contract/base_contract_interaction.d.ts +8 -10
  39. package/dest/contract/base_contract_interaction.d.ts.map +1 -1
  40. package/dest/contract/base_contract_interaction.js +5 -17
  41. package/dest/contract/batch_call.d.ts +1 -1
  42. package/dest/contract/batch_call.d.ts.map +1 -1
  43. package/dest/contract/batch_call.js +3 -1
  44. package/dest/contract/contract_base.d.ts +4 -1
  45. package/dest/contract/contract_base.d.ts.map +1 -1
  46. package/dest/contract/contract_function_interaction.d.ts +1 -1
  47. package/dest/contract/deploy_method.d.ts +63 -16
  48. package/dest/contract/deploy_method.d.ts.map +1 -1
  49. package/dest/contract/deploy_method.js +41 -23
  50. package/dest/contract/interaction_options.d.ts +42 -5
  51. package/dest/contract/interaction_options.d.ts.map +1 -1
  52. package/dest/contract/interaction_options.js +8 -1
  53. package/dest/contract/protocol_contracts/auth-registry.d.ts +36 -0
  54. package/dest/contract/protocol_contracts/auth-registry.d.ts.map +1 -0
  55. package/dest/contract/protocol_contracts/auth-registry.js +963 -0
  56. package/dest/contract/protocol_contracts/contract-class-registry.d.ts +35 -0
  57. package/dest/contract/protocol_contracts/contract-class-registry.d.ts.map +1 -0
  58. package/dest/contract/protocol_contracts/contract-class-registry.js +784 -0
  59. package/dest/contract/protocol_contracts/contract-instance-registry.d.ts +31 -0
  60. package/dest/contract/protocol_contracts/contract-instance-registry.d.ts.map +1 -0
  61. package/dest/contract/protocol_contracts/contract-instance-registry.js +858 -0
  62. package/dest/contract/protocol_contracts/fee-juice.d.ts +30 -0
  63. package/dest/contract/protocol_contracts/fee-juice.d.ts.map +1 -0
  64. package/dest/contract/protocol_contracts/fee-juice.js +827 -0
  65. package/dest/contract/protocol_contracts/multi-call-entrypoint.d.ts +34 -0
  66. package/dest/contract/protocol_contracts/multi-call-entrypoint.d.ts.map +1 -0
  67. package/dest/contract/protocol_contracts/multi-call-entrypoint.js +563 -0
  68. package/dest/contract/protocol_contracts/public-checks.d.ts +26 -0
  69. package/dest/contract/protocol_contracts/public-checks.d.ts.map +1 -0
  70. package/dest/contract/protocol_contracts/public-checks.js +579 -0
  71. package/dest/contract/wait_for_proven.d.ts +2 -2
  72. package/dest/contract/wait_for_proven.d.ts.map +1 -1
  73. package/dest/contract/wait_for_proven.js +1 -1
  74. package/dest/contract/wait_opts.d.ts +16 -0
  75. package/dest/contract/wait_opts.d.ts.map +1 -0
  76. package/dest/contract/wait_opts.js +5 -0
  77. package/dest/deployment/broadcast_function.js +3 -3
  78. package/dest/deployment/publish_class.js +2 -2
  79. package/dest/deployment/publish_instance.d.ts +2 -2
  80. package/dest/deployment/publish_instance.d.ts.map +1 -1
  81. package/dest/deployment/publish_instance.js +3 -3
  82. package/dest/ethereum/portal_manager.d.ts +6 -3
  83. package/dest/ethereum/portal_manager.d.ts.map +1 -1
  84. package/dest/ethereum/portal_manager.js +10 -10
  85. package/dest/scripts/generate_protocol_contract_types.d.ts +2 -0
  86. package/dest/scripts/generate_protocol_contract_types.d.ts.map +1 -0
  87. package/dest/scripts/generate_protocol_contract_types.js +120 -0
  88. package/dest/utils/authwit.d.ts +8 -6
  89. package/dest/utils/authwit.d.ts.map +1 -1
  90. package/dest/utils/authwit.js +5 -9
  91. package/dest/utils/node.d.ts +12 -1
  92. package/dest/utils/node.d.ts.map +1 -1
  93. package/dest/utils/node.js +46 -0
  94. package/dest/wallet/account_entrypoint_meta_payment_method.d.ts +5 -8
  95. package/dest/wallet/account_entrypoint_meta_payment_method.d.ts.map +1 -1
  96. package/dest/wallet/account_entrypoint_meta_payment_method.js +28 -43
  97. package/dest/wallet/account_manager.d.ts +5 -8
  98. package/dest/wallet/account_manager.d.ts.map +1 -1
  99. package/dest/wallet/account_manager.js +5 -11
  100. package/dest/wallet/deploy_account_method.d.ts +34 -6
  101. package/dest/wallet/deploy_account_method.d.ts.map +1 -1
  102. package/dest/wallet/deploy_account_method.js +7 -5
  103. package/dest/wallet/wallet.d.ts +233 -2490
  104. package/dest/wallet/wallet.d.ts.map +1 -1
  105. package/dest/wallet/wallet.js +61 -87
  106. package/package.json +14 -12
  107. package/src/account/account.ts +34 -58
  108. package/src/account/account_contract.ts +6 -7
  109. package/src/account/account_with_secret_key.ts +33 -8
  110. package/src/account/index.ts +2 -1
  111. package/src/account/signerless_account.ts +13 -12
  112. package/src/api/account.ts +9 -3
  113. package/src/api/authorization.ts +1 -0
  114. package/src/api/contract.ts +22 -7
  115. package/src/api/node.ts +7 -3
  116. package/src/api/protocol.ts +7 -0
  117. package/src/api/tx.ts +2 -0
  118. package/src/api/wallet.ts +5 -2
  119. package/src/contract/base_contract_interaction.ts +27 -15
  120. package/src/contract/batch_call.ts +4 -2
  121. package/src/contract/deploy_method.ts +122 -29
  122. package/src/contract/interaction_options.ts +49 -4
  123. package/src/contract/protocol_contracts/auth-registry.ts +545 -0
  124. package/src/contract/protocol_contracts/contract-class-registry.ts +433 -0
  125. package/src/contract/protocol_contracts/contract-instance-registry.ts +493 -0
  126. package/src/contract/protocol_contracts/fee-juice.ts +457 -0
  127. package/src/contract/protocol_contracts/multi-call-entrypoint.ts +329 -0
  128. package/src/contract/protocol_contracts/public-checks.ts +315 -0
  129. package/src/contract/wait_for_proven.ts +1 -1
  130. package/src/contract/wait_opts.ts +21 -0
  131. package/src/deployment/broadcast_function.ts +3 -3
  132. package/src/deployment/publish_class.ts +2 -2
  133. package/src/deployment/publish_instance.ts +3 -6
  134. package/src/ethereum/portal_manager.ts +9 -8
  135. package/src/scripts/generate_protocol_contract_types.ts +150 -0
  136. package/src/utils/authwit.ts +19 -7
  137. package/src/utils/node.ts +62 -0
  138. package/src/wallet/account_entrypoint_meta_payment_method.ts +28 -60
  139. package/src/wallet/account_manager.ts +5 -13
  140. package/src/wallet/deploy_account_method.ts +37 -13
  141. package/src/wallet/wallet.ts +140 -92
  142. package/dest/account/interface.d.ts +0 -19
  143. package/dest/account/interface.d.ts.map +0 -1
  144. package/dest/account/interface.js +0 -5
  145. package/dest/contract/deploy_sent_tx.d.ts +0 -48
  146. package/dest/contract/deploy_sent_tx.d.ts.map +0 -1
  147. package/dest/contract/deploy_sent_tx.js +0 -46
  148. package/dest/contract/protocol_contracts.d.ts +0 -9
  149. package/dest/contract/protocol_contracts.d.ts.map +0 -1
  150. package/dest/contract/protocol_contracts.js +0 -26
  151. package/dest/contract/sent_tx.d.ts +0 -50
  152. package/dest/contract/sent_tx.d.ts.map +0 -1
  153. package/dest/contract/sent_tx.js +0 -90
  154. package/dest/contract/unsafe_contract.d.ts +0 -15
  155. package/dest/contract/unsafe_contract.d.ts.map +0 -1
  156. package/dest/contract/unsafe_contract.js +0 -6
  157. package/src/account/interface.ts +0 -25
  158. package/src/contract/deploy_sent_tx.ts +0 -75
  159. package/src/contract/protocol_contracts.ts +0 -35
  160. package/src/contract/sent_tx.ts +0 -129
  161. package/src/contract/unsafe_contract.ts +0 -19
@@ -16,7 +16,7 @@ import {
16
16
  import { Capsule } from '@aztec/stdlib/tx';
17
17
 
18
18
  import type { ContractFunctionInteraction } from '../contract/contract_function_interaction.js';
19
- import { getClassRegistryContract } from '../contract/protocol_contracts.js';
19
+ import { ContractClassRegistryContract } from '../contract/protocol_contracts/contract-class-registry.js';
20
20
  import type { Wallet } from '../wallet/index.js';
21
21
 
22
22
  /**
@@ -58,7 +58,7 @@ export async function broadcastPrivateFunction(
58
58
 
59
59
  const vkHash = await computeVerificationKeyHash(privateFunctionArtifact);
60
60
 
61
- const classRegistry = await getClassRegistryContract(wallet);
61
+ const classRegistry = ContractClassRegistryContract.at(wallet);
62
62
  const bytecode = bufferAsFields(
63
63
  privateFunctionArtifact.bytecode,
64
64
  MAX_PACKED_BYTECODE_SIZE_PER_PRIVATE_FUNCTION_IN_FIELDS,
@@ -121,7 +121,7 @@ export async function broadcastUtilityFunction(
121
121
  privateFunctionsArtifactTreeRoot,
122
122
  } = await createUtilityFunctionMembershipProof(selector, artifact);
123
123
 
124
- const classRegistry = await getClassRegistryContract(wallet);
124
+ const classRegistry = ContractClassRegistryContract.at(wallet);
125
125
  const bytecode = bufferAsFields(
126
126
  utilityFunctionArtifact.bytecode,
127
127
  MAX_PACKED_BYTECODE_SIZE_PER_PRIVATE_FUNCTION_IN_FIELDS,
@@ -9,7 +9,7 @@ import { getContractClassFromArtifact } from '@aztec/stdlib/contract';
9
9
  import { Capsule } from '@aztec/stdlib/tx';
10
10
 
11
11
  import type { ContractFunctionInteraction } from '../contract/contract_function_interaction.js';
12
- import { getClassRegistryContract } from '../contract/protocol_contracts.js';
12
+ import { ContractClassRegistryContract } from '../contract/protocol_contracts/contract-class-registry.js';
13
13
  import type { Wallet } from '../wallet/index.js';
14
14
 
15
15
  /** Sets up a call to publish a contract class given its artifact. */
@@ -19,7 +19,7 @@ export async function publishContractClass(
19
19
  ): Promise<ContractFunctionInteraction> {
20
20
  const { artifactHash, privateFunctionsRoot, publicBytecodeCommitment, packedBytecode } =
21
21
  await getContractClassFromArtifact(artifact);
22
- const classRegistry = await getClassRegistryContract(wallet);
22
+ const classRegistry = ContractClassRegistryContract.at(wallet);
23
23
 
24
24
  const encodedBytecode = bufferAsFields(packedBytecode, MAX_PACKED_PUBLIC_BYTECODE_SIZE_IN_FIELDS);
25
25
  return classRegistry.methods.publish(artifactHash, privateFunctionsRoot, publicBytecodeCommitment).with({
@@ -1,7 +1,7 @@
1
1
  import type { ContractInstanceWithAddress } from '@aztec/stdlib/contract';
2
2
 
3
3
  import type { ContractFunctionInteraction } from '../contract/contract_function_interaction.js';
4
- import { getInstanceRegistryContract } from '../contract/protocol_contracts.js';
4
+ import { ContractInstanceRegistryContract } from '../contract/protocol_contracts/contract-instance-registry.js';
5
5
  import type { Wallet } from '../wallet/wallet.js';
6
6
 
7
7
  /**
@@ -9,11 +9,8 @@ import type { Wallet } from '../wallet/wallet.js';
9
9
  * @param wallet - The wallet to use for the publication (setup) tx.
10
10
  * @param instance - The instance to publish.
11
11
  */
12
- export async function publishInstance(
13
- wallet: Wallet,
14
- instance: ContractInstanceWithAddress,
15
- ): Promise<ContractFunctionInteraction> {
16
- const contractInstanceRegistry = await getInstanceRegistryContract(wallet);
12
+ export function publishInstance(wallet: Wallet, instance: ContractInstanceWithAddress): ContractFunctionInteraction {
13
+ const contractInstanceRegistry = ContractInstanceRegistryContract.at(wallet);
17
14
  const { salt, currentContractClassId: contractClassId, publicKeys, deployer: instanceDeployer } = instance;
18
15
  const isUniversalDeploy = instanceDeployer.isZero();
19
16
  return contractInstanceRegistry.methods.publish_for_public_execution(
@@ -1,5 +1,6 @@
1
1
  import type { ExtendedViemWalletClient, ViemContract } from '@aztec/ethereum/types';
2
2
  import { extractEvent } from '@aztec/ethereum/utils';
3
+ import type { EpochNumber } from '@aztec/foundation/branded-types';
3
4
  import { sha256ToField } from '@aztec/foundation/crypto/sha256';
4
5
  import { Fr } from '@aztec/foundation/curves/bn254';
5
6
  import { EthAddress } from '@aztec/foundation/eth-address';
@@ -408,26 +409,26 @@ export class L1TokenPortalManager extends L1ToL2TokenPortalManager {
408
409
  * Withdraws funds from the portal by consuming an L2 to L1 message. Returns once the tx is mined on L1.
409
410
  * @param amount - Amount to withdraw.
410
411
  * @param recipient - Who will receive the funds.
411
- * @param blockNumber - L2 block number of the message.
412
+ * @param epochNumber - Epoch number of the message.
412
413
  * @param messageIndex - Index of the message.
413
414
  * @param siblingPath - Sibling path of the message.
414
415
  */
415
416
  public async withdrawFunds(
416
417
  amount: bigint,
417
418
  recipient: EthAddress,
418
- blockNumber: bigint,
419
+ epochNumber: EpochNumber,
419
420
  messageIndex: bigint,
420
421
  siblingPath: SiblingPath<number>,
421
422
  ) {
422
423
  this.logger.info(
423
- `Sending L1 tx to consume message at block ${blockNumber} index ${messageIndex} to withdraw ${amount}`,
424
+ `Sending L1 tx to consume message at epoch ${epochNumber} index ${messageIndex} to withdraw ${amount}`,
424
425
  );
425
426
 
426
427
  const messageLeafId = getL2ToL1MessageLeafId({ leafIndex: messageIndex, siblingPath });
427
- const isConsumedBefore = await this.outbox.read.hasMessageBeenConsumedAtCheckpoint([blockNumber, messageLeafId]);
428
+ const isConsumedBefore = await this.outbox.read.hasMessageBeenConsumedAtEpoch([BigInt(epochNumber), messageLeafId]);
428
429
  if (isConsumedBefore) {
429
430
  throw new Error(
430
- `L1 to L2 message at block ${blockNumber} index ${messageIndex} height ${siblingPath.pathSize} has already been consumed`,
431
+ `L2 to L1 message at epoch ${epochNumber} index ${messageIndex} height ${siblingPath.pathSize} has already been consumed`,
431
432
  );
432
433
  }
433
434
 
@@ -436,7 +437,7 @@ export class L1TokenPortalManager extends L1ToL2TokenPortalManager {
436
437
  recipient.toString(),
437
438
  amount,
438
439
  false,
439
- BigInt(blockNumber),
440
+ BigInt(epochNumber),
440
441
  messageIndex,
441
442
  siblingPath.toBufferArray().map((buf: Buffer): Hex => `0x${buf.toString('hex')}`),
442
443
  ]);
@@ -445,10 +446,10 @@ export class L1TokenPortalManager extends L1ToL2TokenPortalManager {
445
446
  hash: await this.extendedClient.writeContract(withdrawRequest),
446
447
  });
447
448
 
448
- const isConsumedAfter = await this.outbox.read.hasMessageBeenConsumedAtCheckpoint([blockNumber, messageLeafId]);
449
+ const isConsumedAfter = await this.outbox.read.hasMessageBeenConsumedAtEpoch([BigInt(epochNumber), messageLeafId]);
449
450
  if (!isConsumedAfter) {
450
451
  throw new Error(
451
- `L1 to L2 message at block ${blockNumber} index ${messageIndex} height ${siblingPath.pathSize} not consumed after withdrawal`,
452
+ `L2 to L1 message at epoch ${epochNumber} index ${messageIndex} height ${siblingPath.pathSize} not consumed after withdrawal`,
452
453
  );
453
454
  }
454
455
  }
@@ -0,0 +1,150 @@
1
+ /**
2
+ * Generates type-safe contract wrappers for protocol contracts.
3
+ * These wrappers use a minimal artifact (without bytecode) since PXE already has the full artifacts registered.
4
+ */
5
+ import { generateTypescriptContractInterface } from '@aztec/builder/codegen';
6
+ import {
7
+ type ContractArtifact,
8
+ type FunctionAbi,
9
+ FunctionType,
10
+ getAllFunctionAbis,
11
+ loadContractArtifact,
12
+ } from '@aztec/stdlib/abi';
13
+ import type { NoirCompiledContract } from '@aztec/stdlib/noir';
14
+
15
+ import { promises as fs } from 'fs';
16
+ import path from 'path';
17
+
18
+ const log = console.log;
19
+
20
+ const noirContractsRoot = path.join(import.meta.dirname, '../../../../noir-projects/noir-contracts');
21
+ const srcPath = path.join(noirContractsRoot, 'target');
22
+ const outputDir = path.join(import.meta.dirname, '../contract/protocol_contracts');
23
+
24
+ function toKebabCase(str: string): string {
25
+ return str.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
26
+ }
27
+
28
+ function functionTypeToEnum(type: FunctionType): string {
29
+ switch (type) {
30
+ case FunctionType.PRIVATE:
31
+ return 'FunctionType.PRIVATE';
32
+ case FunctionType.PUBLIC:
33
+ return 'FunctionType.PUBLIC';
34
+ case FunctionType.UTILITY:
35
+ return 'FunctionType.UTILITY';
36
+ }
37
+ }
38
+
39
+ function generateFunctionAbiJson(abi: FunctionAbi): string {
40
+ const baseObj = {
41
+ name: abi.name,
42
+ isOnlySelf: abi.isOnlySelf,
43
+ isStatic: abi.isStatic,
44
+ isInitializer: abi.isInitializer,
45
+ parameters: abi.parameters,
46
+ returnTypes: abi.returnTypes,
47
+ errorTypes: abi.errorTypes,
48
+ };
49
+ const jsonStr = JSON.stringify(baseObj);
50
+ return jsonStr.replace('{', `{ functionType: ${functionTypeToEnum(abi.functionType)},`);
51
+ }
52
+
53
+ function generateProtocolContractArtifact(input: ContractArtifact): string {
54
+ const allAbis = getAllFunctionAbis(input);
55
+ const functionAbis = input.functions.map(f => allAbis.find(abi => abi.name === f.name)!);
56
+ const nonDispatchAbis = input.nonDispatchPublicFunctions;
57
+
58
+ const functionsArray = functionAbis
59
+ .map(abi => `{ ...${generateFunctionAbiJson(abi)}, bytecode: Buffer.from([]), debugSymbols: '' }`)
60
+ .join(',\n ');
61
+
62
+ const nonDispatchArray = nonDispatchAbis.map(abi => generateFunctionAbiJson(abi)).join(',\n ');
63
+
64
+ return `{
65
+ name: '${input.name}',
66
+ functions: [
67
+ ${functionsArray}
68
+ ],
69
+ nonDispatchPublicFunctions: [
70
+ ${nonDispatchArray}
71
+ ],
72
+ outputs: { structs: {}, globals: {} },
73
+ storageLayout: {},
74
+ fileMap: {},
75
+ }`;
76
+ }
77
+
78
+ async function generateProtocolContractInterface(
79
+ input: ContractArtifact,
80
+ protocolContractName: string,
81
+ ): Promise<string> {
82
+ const baseInterface = await generateTypescriptContractInterface(input);
83
+
84
+ // Match everything between "public declare methods: {" and the closing "};"
85
+ const methodsMatch = baseInterface.match(/public declare methods: \{([\s\S]*?)\n \};/);
86
+ if (!methodsMatch) {
87
+ throw new Error('Could not extract methods from generated interface');
88
+ }
89
+
90
+ const artifactCode = generateProtocolContractArtifact(input);
91
+ const contractName = `${input.name}Contract`;
92
+
93
+ return `
94
+ /* Autogenerated file, do not edit! */
95
+
96
+ /* eslint-disable */
97
+ import { ProtocolContractAddress } from '@aztec/protocol-contracts';
98
+ import { FunctionType } from '@aztec/stdlib/abi';
99
+
100
+ import type { ContractArtifact } from '../../api/abi.js';
101
+ import { PublicKeys } from '../../api/keys.js';
102
+ import type { AztecAddressLike, EthAddressLike, FieldLike, FunctionSelectorLike, WrappedFieldLike } from '../../utils/abi_types.js';
103
+ import { ContractBase, type ContractMethod } from '../contract_base.js';
104
+ import { ContractFunctionInteraction } from '../contract_function_interaction.js';
105
+ import type { Wallet } from '../../wallet/wallet.js';
106
+
107
+ const ${contractName}Artifact: ContractArtifact = ${artifactCode};
108
+
109
+ export class ${contractName} extends ContractBase {
110
+ private constructor(wallet: Wallet) {
111
+ super(ProtocolContractAddress.${protocolContractName}, ${contractName}Artifact, wallet);
112
+ }
113
+
114
+ public static at(wallet: Wallet): ${contractName} {
115
+ return new ${contractName}(wallet);
116
+ }
117
+
118
+ public declare methods: {${methodsMatch[1]}
119
+ };
120
+ }
121
+ `;
122
+ }
123
+
124
+ async function main() {
125
+ await fs.rm(outputDir, { recursive: true, force: true });
126
+ await fs.mkdir(outputDir, { recursive: true });
127
+
128
+ const srcNames = JSON.parse(
129
+ await fs.readFile(path.join(noirContractsRoot, 'protocol_contracts.json'), 'utf8'),
130
+ ) as string[];
131
+
132
+ for (const srcName of srcNames) {
133
+ // srcName is like "auth_registry_contract-AuthRegistry", split to get the contract name
134
+ const name = srcName.split('-')[1];
135
+ const artifactPath = path.join(srcPath, `${srcName}.json`);
136
+ const json = JSON.parse(await fs.readFile(artifactPath, 'utf8')) as NoirCompiledContract;
137
+ const contractArtifact = loadContractArtifact(json);
138
+
139
+ const content = await generateProtocolContractInterface(contractArtifact, name);
140
+ const fileName = `${toKebabCase(name)}.ts`;
141
+ await fs.writeFile(path.join(outputDir, fileName), content);
142
+
143
+ log(`Generated ${fileName}`);
144
+ }
145
+ }
146
+
147
+ main().catch(err => {
148
+ console.error('Error generating protocol contract types:', err);
149
+ process.exit(1);
150
+ });
@@ -5,16 +5,18 @@ import { type ABIParameterVisibility, type FunctionAbi, type FunctionCall, Funct
5
5
  import { AuthWitness, computeInnerAuthWitHash, computeOuterAuthWitHash } from '@aztec/stdlib/auth-witness';
6
6
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
7
7
  import { computeVarArgsHash } from '@aztec/stdlib/hash';
8
- import type { TxProfileResult } from '@aztec/stdlib/tx';
8
+ import type { TxHash, TxProfileResult, TxReceipt } from '@aztec/stdlib/tx';
9
9
 
10
10
  import { ContractFunctionInteraction } from '../contract/contract_function_interaction.js';
11
11
  import type {
12
+ InteractionWaitOptions,
12
13
  ProfileInteractionOptions,
13
14
  SendInteractionOptions,
15
+ SendInteractionOptionsWithoutWait,
16
+ SendReturn,
14
17
  SimulateInteractionOptions,
15
18
  SimulationReturn,
16
19
  } from '../contract/interaction_options.js';
17
- import type { SentTx } from '../contract/sent_tx.js';
18
20
  import type { Wallet } from '../wallet/index.js';
19
21
 
20
22
  /** Intent with an inner hash */
@@ -42,7 +44,7 @@ export type ContractFunctionInteractionCallIntent = {
42
44
  };
43
45
 
44
46
  /** Identifies ContractFunctionInteractionCallIntents */
45
- function isContractFunctionIntractionCallIntent(
47
+ export function isContractFunctionInteractionCallIntent(
46
48
  messageHashOrIntent: Fr | IntentInnerHash | CallIntent | ContractFunctionInteractionCallIntent,
47
49
  ): messageHashOrIntent is ContractFunctionInteractionCallIntent {
48
50
  return (
@@ -81,7 +83,7 @@ export const computeAuthWitMessageHash = async (
81
83
  const version = metadata.version;
82
84
 
83
85
  if ('caller' in intent) {
84
- const call = isContractFunctionIntractionCallIntent(intent) ? await intent.action.getFunctionCall() : intent.call;
86
+ const call = isContractFunctionInteractionCallIntent(intent) ? await intent.action.getFunctionCall() : intent.call;
85
87
  return computeOuterAuthWitHash(
86
88
  call.to,
87
89
  chainId,
@@ -154,7 +156,7 @@ export async function lookupValidity(
154
156
  }> {
155
157
  let innerHash, consumer;
156
158
  if ('caller' in intent) {
157
- const call = isContractFunctionIntractionCallIntent(intent) ? await intent.action.getFunctionCall() : intent.call;
159
+ const call = isContractFunctionInteractionCallIntent(intent) ? await intent.action.getFunctionCall() : intent.call;
158
160
  innerHash = await computeInnerAuthWitHashFromAction(intent.caller, call);
159
161
  consumer = call.to;
160
162
  } else {
@@ -286,9 +288,19 @@ export class SetPublicAuthwitContractInteraction extends ContractFunctionInterac
286
288
  * Overrides the send method, adding the sender of the authwit (authorizer) as from
287
289
  * and preventing misuse
288
290
  * @param options - An optional object containing 'fee' options information
289
- * @returns A SentTx instance for tracking the transaction status and information.
291
+ * @returns A TxReceipt (if wait is true/undefined) or TxHash (if wait is false)
290
292
  */
291
- public override send(options: Omit<SendInteractionOptions, 'from'> = {}): SentTx {
293
+ // Overload for when wait is not specified at all - returns TxReceipt
294
+ public override send(options?: Omit<SendInteractionOptionsWithoutWait, 'from'>): Promise<TxReceipt>;
295
+ // Generic overload for explicit wait values
296
+ // eslint-disable-next-line jsdoc/require-jsdoc
297
+ public override send<W extends InteractionWaitOptions>(
298
+ options?: Omit<SendInteractionOptions<W>, 'from'>,
299
+ ): Promise<SendReturn<W>>;
300
+ // eslint-disable-next-line jsdoc/require-jsdoc
301
+ public override send(
302
+ options?: Omit<SendInteractionOptions<InteractionWaitOptions>, 'from'>,
303
+ ): Promise<TxReceipt | TxHash> {
292
304
  return super.send({ ...options, from: this.from });
293
305
  }
294
306
 
package/src/utils/node.ts CHANGED
@@ -1,6 +1,10 @@
1
1
  import type { Logger } from '@aztec/foundation/log';
2
2
  import { retryUntil } from '@aztec/foundation/retry';
3
3
  import type { AztecNode } from '@aztec/stdlib/interfaces/client';
4
+ import type { TxHash, TxReceipt } from '@aztec/stdlib/tx';
5
+ import { SortedTxStatuses, TxStatus } from '@aztec/stdlib/tx';
6
+
7
+ import { DefaultWaitOpts, type WaitOpts } from '../contract/wait_opts.js';
4
8
 
5
9
  export const waitForNode = async (node: AztecNode, logger?: Logger) => {
6
10
  await retryUntil(async () => {
@@ -16,4 +20,62 @@ export const waitForNode = async (node: AztecNode, logger?: Logger) => {
16
20
  }, 'RPC Get Node Info');
17
21
  };
18
22
 
23
+ /** Returns true if the receipt status is at least the desired status level. */
24
+ function hasReachedStatus(receipt: TxReceipt, desiredStatus: TxStatus): boolean {
25
+ return SortedTxStatuses.indexOf(receipt.status) >= SortedTxStatuses.indexOf(desiredStatus);
26
+ }
27
+
28
+ /**
29
+ * Waits for a transaction to be mined and returns its receipt.
30
+ * @param node - The Aztec node to query for transaction status
31
+ * @param txHash - The hash of the transaction to wait for
32
+ * @param opts - Optional configuration for waiting behavior
33
+ * @returns The transaction receipt
34
+ * @throws If the transaction fails and dontThrowOnRevert is not set
35
+ */
36
+ export async function waitForTx(node: AztecNode, txHash: TxHash, opts?: WaitOpts): Promise<TxReceipt> {
37
+ const startTime = Date.now();
38
+ const ignoreDroppedReceiptsFor = opts?.ignoreDroppedReceiptsFor ?? DefaultWaitOpts.ignoreDroppedReceiptsFor;
39
+ const waitForStatus = opts?.waitForStatus ?? TxStatus.CHECKPOINTED;
40
+
41
+ const receipt = await retryUntil(
42
+ async () => {
43
+ const txReceipt = await node.getTxReceipt(txHash);
44
+ // If receipt is not yet available, try again
45
+ if (txReceipt.isPending()) {
46
+ return undefined;
47
+ }
48
+ // If the tx was "dropped", either return it or ignore based on timing.
49
+ // We can ignore it at first because the transaction may have been sent to node 1, and now we're asking node 2 for the receipt.
50
+ // If we don't allow a short grace period, we could incorrectly return a TxReceipt with status DROPPED.
51
+ if (txReceipt.isDropped()) {
52
+ const elapsedSeconds = (Date.now() - startTime) / 1000;
53
+ if (!ignoreDroppedReceiptsFor || elapsedSeconds > ignoreDroppedReceiptsFor) {
54
+ return txReceipt;
55
+ }
56
+ return undefined;
57
+ }
58
+ // Check if the receipt has reached the desired status level
59
+ if (!hasReachedStatus(txReceipt, waitForStatus)) {
60
+ return undefined;
61
+ }
62
+ return txReceipt;
63
+ },
64
+ 'isMined',
65
+ opts?.timeout ?? DefaultWaitOpts.timeout,
66
+ opts?.interval ?? DefaultWaitOpts.interval,
67
+ );
68
+
69
+ if (!receipt.isMined()) {
70
+ throw new Error(`Transaction ${txHash.toString()} was ${receipt.status}. Reason: ${receipt.error ?? 'unknown'}`);
71
+ }
72
+ if (!receipt.hasExecutionSucceeded() && !opts?.dontThrowOnRevert) {
73
+ throw new Error(
74
+ `Transaction ${txHash.toString()} reverted: ${receipt.executionResult}. Reason: ${receipt.error ?? 'unknown'}`,
75
+ );
76
+ }
77
+
78
+ return receipt;
79
+ }
80
+
19
81
  export { createAztecNodeClient, type AztecNode } from '@aztec/stdlib/interfaces/client';
@@ -1,20 +1,11 @@
1
1
  import { AccountFeePaymentMethodOptions } from '@aztec/entrypoints/account';
2
- import { EncodedAppEntrypointCalls } from '@aztec/entrypoints/encoding';
3
2
  import { ProtocolContractAddress } from '@aztec/protocol-contracts';
4
- import {
5
- type ContractArtifact,
6
- type FunctionArtifact,
7
- FunctionCall,
8
- FunctionSelector,
9
- encodeArguments,
10
- getFunctionArtifactByName,
11
- } from '@aztec/stdlib/abi';
12
3
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
13
4
  import type { GasSettings } from '@aztec/stdlib/gas';
14
5
  import { ExecutionPayload } from '@aztec/stdlib/tx';
15
6
 
7
+ import type { Account } from '../account/account.js';
16
8
  import type { FeePaymentMethod } from '../fee/fee_payment_method.js';
17
- import type { Wallet } from './index.js';
18
9
 
19
10
  /**
20
11
  * Fee payment method that allows an account contract to pay for its own deployment
@@ -33,11 +24,9 @@ import type { Wallet } from './index.js';
33
24
  */
34
25
  export class AccountEntrypointMetaPaymentMethod implements FeePaymentMethod {
35
26
  constructor(
36
- private wallet: Wallet,
37
- private artifact: ContractArtifact,
38
- private feePaymentNameOrArtifact: string | FunctionArtifact,
39
- private accountAddress: AztecAddress,
27
+ private account: Account,
40
28
  private paymentMethod?: FeePaymentMethod,
29
+ private feeEntrypointOptions?: any,
41
30
  ) {}
42
31
 
43
32
  getAsset(): Promise<AztecAddress> {
@@ -45,59 +34,38 @@ export class AccountEntrypointMetaPaymentMethod implements FeePaymentMethod {
45
34
  }
46
35
 
47
36
  async getExecutionPayload(): Promise<ExecutionPayload> {
48
- // Get the execution payload for the fee, it includes the calls and potentially authWitnesses
49
- // It can be empty because the account might attempt to pay for the tx fee using its own
50
- // FeeJuice balance
51
- const { calls: feeCalls, authWitnesses: feeAuthwitnesses } =
52
- (await this.paymentMethod?.getExecutionPayload()) ?? ExecutionPayload.empty();
53
- // Encode the calls for the fee
54
- const feePayer = (await this.paymentMethod?.getFeePayer()) ?? this.accountAddress;
55
- const isFeePayer = feePayer.equals(this.accountAddress);
56
- let accountFeePaymentMethodOptions = AccountFeePaymentMethodOptions.EXTERNAL;
57
- if (isFeePayer) {
58
- // If the account is the fee payer, and the incoming fee payload has calls
59
- // it can only be FeeJuicePaymentMethodWithClaim
60
- // If the payload has no calls, it's paying using
61
- // its own fee juice balance
62
- accountFeePaymentMethodOptions =
63
- feeCalls.length === 0
64
- ? AccountFeePaymentMethodOptions.PREEXISTING_FEE_JUICE
65
- : AccountFeePaymentMethodOptions.FEE_JUICE_WITH_CLAIM;
66
- }
67
- const feeEncodedCalls = await EncodedAppEntrypointCalls.create(feeCalls);
37
+ // Get the execution payload for the fee
38
+ const innerPayload = (await this.paymentMethod?.getExecutionPayload()) ?? ExecutionPayload.empty();
68
39
 
69
- // Get the entrypoint args
70
- const args = [feeEncodedCalls, accountFeePaymentMethodOptions, false];
71
- const feePaymentArtifact =
72
- typeof this.feePaymentNameOrArtifact === 'string'
73
- ? getFunctionArtifactByName(this.artifact, this.feePaymentNameOrArtifact)
74
- : this.feePaymentNameOrArtifact;
40
+ // If no fee entrypoint options were provided, compute them based on the wrapped payment method
41
+ // This mimics how the actual account contract works when invoked directly:
42
+ // - If we are the fee payer, are there calls in the inner payload? In that case, those calls can
43
+ // only be claiming fee juice, so we use FEE_JUICE_WITH_CLAIM
44
+ // - If we are the fee payer, but there are no calls, then we assume the account already has
45
+ // fee juice and can pay directly with PREEXISTING_FEE_JUICE
46
+ // - If we are not the fee payer, then EXTERNAL is used
47
+ let options = this.feeEntrypointOptions;
48
+ if (!options) {
49
+ const feePayer = (await this.paymentMethod?.getFeePayer()) ?? this.account.getAddress();
50
+ const isFeePayer = feePayer.equals(this.account.getAddress());
75
51
 
76
- const entrypointCall = new FunctionCall(
77
- feePaymentArtifact.name,
78
- this.accountAddress,
79
- await FunctionSelector.fromNameAndParameters(feePaymentArtifact.name, feePaymentArtifact.parameters),
80
- feePaymentArtifact.functionType,
81
- false /** hideMsgSender -- set to `false`, because it's not applicable for an entrypoint function (only for enqueued public calls) */,
82
- feePaymentArtifact.isStatic,
83
- encodeArguments(feePaymentArtifact, args),
84
- feePaymentArtifact.returnTypes,
85
- );
52
+ let accountFeePaymentMethodOptions = AccountFeePaymentMethodOptions.EXTERNAL;
53
+ if (isFeePayer) {
54
+ accountFeePaymentMethodOptions =
55
+ innerPayload.calls.length === 0
56
+ ? AccountFeePaymentMethodOptions.PREEXISTING_FEE_JUICE
57
+ : AccountFeePaymentMethodOptions.FEE_JUICE_WITH_CLAIM;
58
+ }
86
59
 
87
- // Compute the authwitness required to verify the combined payload
88
- const payloadAuthWitness = await this.wallet.createAuthWit(this.accountAddress, await feeEncodedCalls.hash());
60
+ options = { feePaymentMethodOptions: accountFeePaymentMethodOptions };
61
+ }
89
62
 
90
- return new ExecutionPayload(
91
- [entrypointCall],
92
- [payloadAuthWitness, ...feeAuthwitnesses],
93
- [],
94
- feeEncodedCalls.hashedArguments,
95
- feePayer,
96
- );
63
+ // Use the generic wrapping mechanism from the account interface
64
+ return this.account.wrapExecutionPayload(innerPayload, options);
97
65
  }
98
66
 
99
67
  getFeePayer(): Promise<AztecAddress> {
100
- return this.paymentMethod?.getFeePayer() ?? Promise.resolve(this.accountAddress);
68
+ return this.paymentMethod?.getFeePayer() ?? Promise.resolve(this.account.getAddress());
101
69
  }
102
70
 
103
71
  getGasSettings(): GasSettings | undefined {
@@ -9,7 +9,6 @@ import { deriveKeys } from '@aztec/stdlib/keys';
9
9
  import type { AccountContract } from '../account/account_contract.js';
10
10
  import { AccountWithSecretKey } from '../account/account_with_secret_key.js';
11
11
  import type { Salt } from '../account/index.js';
12
- import type { AccountInterface } from '../account/interface.js';
13
12
  import { Contract } from '../contract/contract.js';
14
13
  import { DeployAccountMethod } from './deploy_account_method.js';
15
14
  import type { Wallet } from './wallet.js';
@@ -58,16 +57,6 @@ export class AccountManager {
58
57
  return this.getPublicKeys().hash();
59
58
  }
60
59
 
61
- /**
62
- * Returns the entrypoint for this account as defined by its account contract.
63
- * @returns An entrypoint.
64
- */
65
- public async getAccountInterface(): Promise<AccountInterface> {
66
- const chainInfo = await this.wallet.getChainInfo();
67
- const completeAddress = await this.getCompleteAddress();
68
- return this.accountContract.getInterface(completeAddress, chainInfo);
69
- }
70
-
71
60
  /**
72
61
  * Gets the calculated complete address associated with this account.
73
62
  * Does not require the account to have been published for public execution.
@@ -103,8 +92,9 @@ export class AccountManager {
103
92
  * @returns A Wallet instance.
104
93
  */
105
94
  public async getAccount(): Promise<AccountWithSecretKey> {
106
- const accountInterface = await this.getAccountInterface();
107
- return new AccountWithSecretKey(accountInterface, this.secretKey, this.salt);
95
+ const completeAddress = await this.getCompleteAddress();
96
+ const account = this.accountContract.getAccount(completeAddress);
97
+ return new AccountWithSecretKey(account, this.secretKey, this.salt);
108
98
  }
109
99
 
110
100
  /**
@@ -134,12 +124,14 @@ export class AccountManager {
134
124
  constructorArgs: undefined,
135
125
  };
136
126
 
127
+ const account = await this.getAccount();
137
128
  return new DeployAccountMethod(
138
129
  this.getPublicKeys(),
139
130
  this.wallet,
140
131
  artifact,
141
132
  instance => Contract.at(instance.address, artifact, this.wallet),
142
133
  new Fr(this.salt),
134
+ account,
143
135
  constructorArgs,
144
136
  constructorName,
145
137
  );