@aztec/aztec.js 0.0.1-commit.6d3c34e → 0.0.1-commit.733c4a3

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 (197) 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 +18 -12
  22. package/dest/api/contract.d.ts.map +1 -1
  23. package/dest/api/contract.js +16 -10
  24. package/dest/api/deployment.d.ts +1 -2
  25. package/dest/api/deployment.d.ts.map +1 -1
  26. package/dest/api/deployment.js +0 -1
  27. package/dest/api/events.d.ts +10 -6
  28. package/dest/api/events.d.ts.map +1 -1
  29. package/dest/api/events.js +30 -20
  30. package/dest/api/fields.d.ts +2 -1
  31. package/dest/api/fields.d.ts.map +1 -1
  32. package/dest/api/fields.js +1 -0
  33. package/dest/api/keys.d.ts +1 -1
  34. package/dest/api/keys.js +1 -1
  35. package/dest/api/node.d.ts +8 -4
  36. package/dest/api/node.d.ts.map +1 -1
  37. package/dest/api/node.js +7 -3
  38. package/dest/api/protocol.d.ts +7 -1
  39. package/dest/api/protocol.d.ts.map +1 -1
  40. package/dest/api/protocol.js +6 -0
  41. package/dest/api/tx.d.ts +2 -2
  42. package/dest/api/tx.d.ts.map +1 -1
  43. package/dest/api/tx.js +1 -1
  44. package/dest/api/wallet.d.ts +3 -2
  45. package/dest/api/wallet.d.ts.map +1 -1
  46. package/dest/api/wallet.js +2 -1
  47. package/dest/authorization/call_authorization_request.d.ts +22 -1
  48. package/dest/authorization/call_authorization_request.d.ts.map +1 -1
  49. package/dest/contract/base_contract_interaction.d.ts +8 -10
  50. package/dest/contract/base_contract_interaction.d.ts.map +1 -1
  51. package/dest/contract/base_contract_interaction.js +5 -17
  52. package/dest/contract/batch_call.d.ts +3 -3
  53. package/dest/contract/batch_call.d.ts.map +1 -1
  54. package/dest/contract/batch_call.js +8 -5
  55. package/dest/contract/contract_base.d.ts +4 -1
  56. package/dest/contract/contract_base.d.ts.map +1 -1
  57. package/dest/contract/contract_function_interaction.d.ts +3 -12
  58. package/dest/contract/contract_function_interaction.d.ts.map +1 -1
  59. package/dest/contract/contract_function_interaction.js +10 -7
  60. package/dest/contract/deploy_method.d.ts +78 -18
  61. package/dest/contract/deploy_method.d.ts.map +1 -1
  62. package/dest/contract/deploy_method.js +66 -33
  63. package/dest/contract/get_gas_limits.js +3 -3
  64. package/dest/contract/interaction_options.d.ts +49 -5
  65. package/dest/contract/interaction_options.d.ts.map +1 -1
  66. package/dest/contract/interaction_options.js +8 -1
  67. package/dest/contract/protocol_contracts/auth-registry.d.ts +36 -0
  68. package/dest/contract/protocol_contracts/auth-registry.d.ts.map +1 -0
  69. package/dest/contract/protocol_contracts/auth-registry.js +997 -0
  70. package/dest/contract/protocol_contracts/contract-class-registry.d.ts +15 -0
  71. package/dest/contract/protocol_contracts/contract-class-registry.d.ts.map +1 -0
  72. package/dest/contract/protocol_contracts/contract-class-registry.js +139 -0
  73. package/dest/contract/protocol_contracts/contract-instance-registry.d.ts +22 -0
  74. package/dest/contract/protocol_contracts/contract-instance-registry.d.ts.map +1 -0
  75. package/dest/contract/protocol_contracts/contract-instance-registry.js +465 -0
  76. package/dest/contract/protocol_contracts/fee-juice.d.ts +21 -0
  77. package/dest/contract/protocol_contracts/fee-juice.d.ts.map +1 -0
  78. package/dest/contract/protocol_contracts/fee-juice.js +426 -0
  79. package/dest/contract/protocol_contracts/multi-call-entrypoint.d.ts +34 -0
  80. package/dest/contract/protocol_contracts/multi-call-entrypoint.d.ts.map +1 -0
  81. package/dest/contract/protocol_contracts/multi-call-entrypoint.js +593 -0
  82. package/dest/contract/protocol_contracts/public-checks.d.ts +26 -0
  83. package/dest/contract/protocol_contracts/public-checks.d.ts.map +1 -0
  84. package/dest/contract/protocol_contracts/public-checks.js +601 -0
  85. package/dest/contract/wait_for_proven.d.ts +2 -2
  86. package/dest/contract/wait_for_proven.d.ts.map +1 -1
  87. package/dest/contract/wait_for_proven.js +1 -1
  88. package/dest/contract/wait_opts.d.ts +16 -0
  89. package/dest/contract/wait_opts.d.ts.map +1 -0
  90. package/dest/contract/wait_opts.js +5 -0
  91. package/dest/deployment/publish_class.js +2 -2
  92. package/dest/deployment/publish_instance.d.ts +2 -2
  93. package/dest/deployment/publish_instance.d.ts.map +1 -1
  94. package/dest/deployment/publish_instance.js +3 -3
  95. package/dest/ethereum/portal_manager.d.ts +3 -1
  96. package/dest/ethereum/portal_manager.d.ts.map +1 -1
  97. package/dest/fee/fee_juice_payment_method_with_claim.js +6 -6
  98. package/dest/fee/private_fee_payment_method.js +10 -10
  99. package/dest/fee/public_fee_payment_method.js +10 -10
  100. package/dest/fee/sponsored_fee_payment.js +3 -3
  101. package/dest/scripts/generate_protocol_contract_types.d.ts +2 -0
  102. package/dest/scripts/generate_protocol_contract_types.d.ts.map +1 -0
  103. package/dest/scripts/generate_protocol_contract_types.js +120 -0
  104. package/dest/utils/authwit.d.ts +8 -6
  105. package/dest/utils/authwit.d.ts.map +1 -1
  106. package/dest/utils/authwit.js +5 -9
  107. package/dest/utils/node.d.ts +12 -1
  108. package/dest/utils/node.d.ts.map +1 -1
  109. package/dest/utils/node.js +46 -0
  110. package/dest/wallet/account_entrypoint_meta_payment_method.d.ts +5 -8
  111. package/dest/wallet/account_entrypoint_meta_payment_method.d.ts.map +1 -1
  112. package/dest/wallet/account_entrypoint_meta_payment_method.js +28 -43
  113. package/dest/wallet/account_manager.d.ts +5 -8
  114. package/dest/wallet/account_manager.d.ts.map +1 -1
  115. package/dest/wallet/account_manager.js +5 -11
  116. package/dest/wallet/capabilities.d.ts +452 -0
  117. package/dest/wallet/capabilities.d.ts.map +1 -0
  118. package/dest/wallet/capabilities.js +3 -0
  119. package/dest/wallet/deploy_account_method.d.ts +46 -7
  120. package/dest/wallet/deploy_account_method.d.ts.map +1 -1
  121. package/dest/wallet/deploy_account_method.js +33 -5
  122. package/dest/wallet/index.d.ts +2 -1
  123. package/dest/wallet/index.d.ts.map +1 -1
  124. package/dest/wallet/index.js +1 -0
  125. package/dest/wallet/wallet.d.ts +1740 -2496
  126. package/dest/wallet/wallet.d.ts.map +1 -1
  127. package/dest/wallet/wallet.js +211 -108
  128. package/package.json +24 -13
  129. package/src/account/account.ts +34 -58
  130. package/src/account/account_contract.ts +6 -7
  131. package/src/account/account_with_secret_key.ts +33 -8
  132. package/src/account/index.ts +2 -1
  133. package/src/account/signerless_account.ts +13 -12
  134. package/src/api/account.ts +9 -3
  135. package/src/api/authorization.ts +1 -0
  136. package/src/api/contract.ts +24 -9
  137. package/src/api/deployment.ts +0 -1
  138. package/src/api/events.ts +35 -27
  139. package/src/api/fields.ts +1 -0
  140. package/src/api/keys.ts +2 -2
  141. package/src/api/node.ts +7 -3
  142. package/src/api/protocol.ts +7 -0
  143. package/src/api/tx.ts +2 -0
  144. package/src/api/wallet.ts +48 -3
  145. package/src/contract/base_contract_interaction.ts +27 -15
  146. package/src/contract/batch_call.ts +8 -13
  147. package/src/contract/contract_function_interaction.ts +17 -7
  148. package/src/contract/deploy_method.ts +165 -38
  149. package/src/contract/get_gas_limits.ts +3 -3
  150. package/src/contract/interaction_options.ts +56 -4
  151. package/src/contract/protocol_contracts/auth-registry.ts +551 -0
  152. package/src/contract/protocol_contracts/contract-class-registry.ts +99 -0
  153. package/src/contract/protocol_contracts/contract-instance-registry.ts +302 -0
  154. package/src/contract/protocol_contracts/fee-juice.ts +264 -0
  155. package/src/contract/protocol_contracts/multi-call-entrypoint.ts +334 -0
  156. package/src/contract/protocol_contracts/public-checks.ts +318 -0
  157. package/src/contract/wait_for_proven.ts +1 -1
  158. package/src/contract/wait_opts.ts +21 -0
  159. package/src/deployment/publish_class.ts +2 -2
  160. package/src/deployment/publish_instance.ts +3 -6
  161. package/src/fee/fee_juice_payment_method_with_claim.ts +5 -5
  162. package/src/fee/private_fee_payment_method.ts +7 -7
  163. package/src/fee/public_fee_payment_method.ts +8 -8
  164. package/src/fee/sponsored_fee_payment.ts +3 -3
  165. package/src/scripts/generate_protocol_contract_types.ts +150 -0
  166. package/src/utils/authwit.ts +19 -7
  167. package/src/utils/node.ts +62 -0
  168. package/src/wallet/account_entrypoint_meta_payment_method.ts +28 -60
  169. package/src/wallet/account_manager.ts +5 -13
  170. package/src/wallet/capabilities.ts +500 -0
  171. package/src/wallet/deploy_account_method.ts +74 -13
  172. package/src/wallet/index.ts +1 -0
  173. package/src/wallet/wallet.ts +344 -130
  174. package/dest/account/interface.d.ts +0 -19
  175. package/dest/account/interface.d.ts.map +0 -1
  176. package/dest/account/interface.js +0 -5
  177. package/dest/contract/deploy_sent_tx.d.ts +0 -48
  178. package/dest/contract/deploy_sent_tx.d.ts.map +0 -1
  179. package/dest/contract/deploy_sent_tx.js +0 -46
  180. package/dest/contract/protocol_contracts.d.ts +0 -9
  181. package/dest/contract/protocol_contracts.d.ts.map +0 -1
  182. package/dest/contract/protocol_contracts.js +0 -26
  183. package/dest/contract/sent_tx.d.ts +0 -50
  184. package/dest/contract/sent_tx.d.ts.map +0 -1
  185. package/dest/contract/sent_tx.js +0 -90
  186. package/dest/contract/unsafe_contract.d.ts +0 -15
  187. package/dest/contract/unsafe_contract.d.ts.map +0 -1
  188. package/dest/contract/unsafe_contract.js +0 -6
  189. package/dest/deployment/broadcast_function.d.ts +0 -24
  190. package/dest/deployment/broadcast_function.d.ts.map +0 -1
  191. package/dest/deployment/broadcast_function.js +0 -74
  192. package/src/account/interface.ts +0 -25
  193. package/src/contract/deploy_sent_tx.ts +0 -75
  194. package/src/contract/protocol_contracts.ts +0 -35
  195. package/src/contract/sent_tx.ts +0 -129
  196. package/src/contract/unsafe_contract.ts +0 -19
  197. package/src/deployment/broadcast_function.ts +0 -148
@@ -1,7 +1,5 @@
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 { FunctionCall, FunctionSelector, encodeArguments, getFunctionArtifactByName } from '@aztec/stdlib/abi';
5
3
  import { ExecutionPayload } from '@aztec/stdlib/tx';
6
4
  /**
7
5
  * Fee payment method that allows an account contract to pay for its own deployment
@@ -18,57 +16,44 @@ import { ExecutionPayload } from '@aztec/stdlib/tx';
18
16
  *
19
17
  * This class can be seen in action in DeployAccountMethod.ts#getSelfPaymentMethod
20
18
  */ export class AccountEntrypointMetaPaymentMethod {
21
- wallet;
22
- artifact;
23
- feePaymentNameOrArtifact;
24
- accountAddress;
19
+ account;
25
20
  paymentMethod;
26
- constructor(wallet, artifact, feePaymentNameOrArtifact, accountAddress, paymentMethod){
27
- this.wallet = wallet;
28
- this.artifact = artifact;
29
- this.feePaymentNameOrArtifact = feePaymentNameOrArtifact;
30
- this.accountAddress = accountAddress;
21
+ feeEntrypointOptions;
22
+ constructor(account, paymentMethod, feeEntrypointOptions){
23
+ this.account = account;
31
24
  this.paymentMethod = paymentMethod;
25
+ this.feeEntrypointOptions = feeEntrypointOptions;
32
26
  }
33
27
  getAsset() {
34
28
  return this.paymentMethod?.getAsset() ?? Promise.resolve(ProtocolContractAddress.FeeJuice);
35
29
  }
36
30
  async getExecutionPayload() {
37
- // Get the execution payload for the fee, it includes the calls and potentially authWitnesses
38
- // It can be empty because the account might attempt to pay for the tx fee using its own
39
- // FeeJuice balance
40
- const { calls: feeCalls, authWitnesses: feeAuthwitnesses } = await this.paymentMethod?.getExecutionPayload() ?? ExecutionPayload.empty();
41
- // Encode the calls for the fee
42
- const feePayer = await this.paymentMethod?.getFeePayer() ?? this.accountAddress;
43
- const isFeePayer = feePayer.equals(this.accountAddress);
44
- let accountFeePaymentMethodOptions = AccountFeePaymentMethodOptions.EXTERNAL;
45
- if (isFeePayer) {
46
- // If the account is the fee payer, and the incoming fee payload has calls
47
- // it can only be FeeJuicePaymentMethodWithClaim
48
- // If the payload has no calls, it's paying using
49
- // its own fee juice balance
50
- accountFeePaymentMethodOptions = feeCalls.length === 0 ? AccountFeePaymentMethodOptions.PREEXISTING_FEE_JUICE : AccountFeePaymentMethodOptions.FEE_JUICE_WITH_CLAIM;
31
+ // Get the execution payload for the fee
32
+ const innerPayload = await this.paymentMethod?.getExecutionPayload() ?? ExecutionPayload.empty();
33
+ // If no fee entrypoint options were provided, compute them based on the wrapped payment method
34
+ // This mimics how the actual account contract works when invoked directly:
35
+ // - If we are the fee payer, are there calls in the inner payload? In that case, those calls can
36
+ // only be claiming fee juice, so we use FEE_JUICE_WITH_CLAIM
37
+ // - If we are the fee payer, but there are no calls, then we assume the account already has
38
+ // fee juice and can pay directly with PREEXISTING_FEE_JUICE
39
+ // - If we are not the fee payer, then EXTERNAL is used
40
+ let options = this.feeEntrypointOptions;
41
+ if (!options) {
42
+ const feePayer = await this.paymentMethod?.getFeePayer() ?? this.account.getAddress();
43
+ const isFeePayer = feePayer.equals(this.account.getAddress());
44
+ let accountFeePaymentMethodOptions = AccountFeePaymentMethodOptions.EXTERNAL;
45
+ if (isFeePayer) {
46
+ accountFeePaymentMethodOptions = innerPayload.calls.length === 0 ? AccountFeePaymentMethodOptions.PREEXISTING_FEE_JUICE : AccountFeePaymentMethodOptions.FEE_JUICE_WITH_CLAIM;
47
+ }
48
+ options = {
49
+ feePaymentMethodOptions: accountFeePaymentMethodOptions
50
+ };
51
51
  }
52
- const feeEncodedCalls = await EncodedAppEntrypointCalls.create(feeCalls);
53
- // Get the entrypoint args
54
- const args = [
55
- feeEncodedCalls,
56
- accountFeePaymentMethodOptions,
57
- false
58
- ];
59
- const feePaymentArtifact = typeof this.feePaymentNameOrArtifact === 'string' ? getFunctionArtifactByName(this.artifact, this.feePaymentNameOrArtifact) : this.feePaymentNameOrArtifact;
60
- const entrypointCall = new FunctionCall(feePaymentArtifact.name, this.accountAddress, await FunctionSelector.fromNameAndParameters(feePaymentArtifact.name, feePaymentArtifact.parameters), feePaymentArtifact.functionType, false, feePaymentArtifact.isStatic, encodeArguments(feePaymentArtifact, args), feePaymentArtifact.returnTypes);
61
- // Compute the authwitness required to verify the combined payload
62
- const payloadAuthWitness = await this.wallet.createAuthWit(this.accountAddress, await feeEncodedCalls.hash());
63
- return new ExecutionPayload([
64
- entrypointCall
65
- ], [
66
- payloadAuthWitness,
67
- ...feeAuthwitnesses
68
- ], [], feeEncodedCalls.hashedArguments, feePayer);
52
+ // Use the generic wrapping mechanism from the account interface
53
+ return this.account.wrapExecutionPayload(innerPayload, options);
69
54
  }
70
55
  getFeePayer() {
71
- return this.paymentMethod?.getFeePayer() ?? Promise.resolve(this.accountAddress);
56
+ return this.paymentMethod?.getFeePayer() ?? Promise.resolve(this.account.getAddress());
72
57
  }
73
58
  getGasSettings() {
74
59
  return this.paymentMethod?.getGasSettings();
@@ -3,7 +3,6 @@ import { CompleteAddress, type ContractInstanceWithAddress } from '@aztec/stdlib
3
3
  import type { AccountContract } from '../account/account_contract.js';
4
4
  import { AccountWithSecretKey } from '../account/account_with_secret_key.js';
5
5
  import type { Salt } from '../account/index.js';
6
- import type { AccountInterface } from '../account/interface.js';
7
6
  import { DeployAccountMethod } from './deploy_account_method.js';
8
7
  import type { Wallet } from './wallet.js';
9
8
  /**
@@ -15,16 +14,14 @@ export declare class AccountManager {
15
14
  private secretKey;
16
15
  private accountContract;
17
16
  private instance;
17
+ /**
18
+ * Contract instantiation salt for the account contract
19
+ */
18
20
  readonly salt: Salt;
19
21
  private constructor();
20
22
  static create(wallet: Wallet, secretKey: Fr, accountContract: AccountContract, salt?: Salt): Promise<AccountManager>;
21
23
  protected getPublicKeys(): import("@aztec/stdlib/keys").PublicKeys;
22
24
  protected getPublicKeysHash(): Fr | Promise<Fr>;
23
- /**
24
- * Returns the entrypoint for this account as defined by its account contract.
25
- * @returns An entrypoint.
26
- */
27
- getAccountInterface(): Promise<AccountInterface>;
28
25
  /**
29
26
  * Gets the calculated complete address associated with this account.
30
27
  * Does not require the account to have been published for public execution.
@@ -35,7 +32,7 @@ export declare class AccountManager {
35
32
  * Returns the secret key used to derive the rest of the privacy keys for this contract
36
33
  */
37
34
  getSecretKey(): Fr;
38
- get address(): import("../api/addresses.js").AztecAddress;
35
+ get address(): import("@aztec/stdlib/aztec-address").AztecAddress;
39
36
  /**
40
37
  * Returns the contract instance definition associated with this account.
41
38
  * Does not require the account to have been published for public execution.
@@ -63,4 +60,4 @@ export declare class AccountManager {
63
60
  */
64
61
  hasInitializer(): Promise<boolean>;
65
62
  }
66
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWNjb3VudF9tYW5hZ2VyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvd2FsbGV0L2FjY291bnRfbWFuYWdlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDcEQsT0FBTyxFQUNMLGVBQWUsRUFDZixLQUFLLDJCQUEyQixFQUVqQyxNQUFNLHdCQUF3QixDQUFDO0FBR2hDLE9BQU8sS0FBSyxFQUFFLGVBQWUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQ3RFLE9BQU8sRUFBRSxvQkFBb0IsRUFBRSxNQUFNLHVDQUF1QyxDQUFDO0FBQzdFLE9BQU8sS0FBSyxFQUFFLElBQUksRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBQ2hELE9BQU8sS0FBSyxFQUFFLGdCQUFnQixFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFFaEUsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDakUsT0FBTyxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBRTFDOzs7R0FHRztBQUNILHFCQUFhLGNBQWM7SUFFdkIsT0FBTyxDQUFDLE1BQU07SUFDZCxPQUFPLENBQUMsU0FBUztJQUNqQixPQUFPLENBQUMsZUFBZTtJQUN2QixPQUFPLENBQUMsUUFBUTthQUlBLElBQUksRUFBRSxJQUFJO0lBUjVCLE9BQU8sZUFTSDtJQUVKLE9BQWEsTUFBTSxDQUFDLE1BQU0sRUFBRSxNQUFNLEVBQUUsU0FBUyxFQUFFLEVBQUUsRUFBRSxlQUFlLEVBQUUsZUFBZSxFQUFFLElBQUksQ0FBQyxFQUFFLElBQUksMkJBa0IvRjtJQUVELFNBQVMsQ0FBQyxhQUFhLDRDQUV0QjtJQUVELFNBQVMsQ0FBQyxpQkFBaUIscUJBRTFCO0lBRUQ7OztPQUdHO0lBQ1UsbUJBQW1CLElBQUksT0FBTyxDQUFDLGdCQUFnQixDQUFDLENBSTVEO0lBRUQ7Ozs7T0FJRztJQUNJLGtCQUFrQixJQUFJLE9BQU8sQ0FBQyxlQUFlLENBQUMsQ0FFcEQ7SUFFRDs7T0FFRztJQUNJLFlBQVksT0FFbEI7SUFFRCxJQUFJLE9BQU8sK0NBRVY7SUFFRDs7OztPQUlHO0lBQ0ksV0FBVyxJQUFJLDJCQUEyQixDQUVoRDtJQUVEOzs7O09BSUc7SUFDVSxVQUFVLElBQUksT0FBTyxDQUFDLG9CQUFvQixDQUFDLENBR3ZEO0lBRUQ7OztPQUdHO0lBQ0gsa0JBQWtCLElBQUksZUFBZSxDQUVwQztJQUVEOzs7T0FHRztJQUNVLGVBQWUsSUFBSSxPQUFPLENBQUMsbUJBQW1CLENBQUMsQ0F3QjNEO0lBRUQ7O09BRUc7SUFDVSxjQUFjLHFCQUUxQjtDQUNGIn0=
63
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWNjb3VudF9tYW5hZ2VyLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvd2FsbGV0L2FjY291bnRfbWFuYWdlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDcEQsT0FBTyxFQUNMLGVBQWUsRUFDZixLQUFLLDJCQUEyQixFQUVqQyxNQUFNLHdCQUF3QixDQUFDO0FBR2hDLE9BQU8sS0FBSyxFQUFFLGVBQWUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQ3RFLE9BQU8sRUFBRSxvQkFBb0IsRUFBRSxNQUFNLHVDQUF1QyxDQUFDO0FBQzdFLE9BQU8sS0FBSyxFQUFFLElBQUksRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBRWhELE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBQ2pFLE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUUxQzs7O0dBR0c7QUFDSCxxQkFBYSxjQUFjO0lBRXZCLE9BQU8sQ0FBQyxNQUFNO0lBQ2QsT0FBTyxDQUFDLFNBQVM7SUFDakIsT0FBTyxDQUFDLGVBQWU7SUFDdkIsT0FBTyxDQUFDLFFBQVE7SUFDaEI7O09BRUc7YUFDYSxJQUFJLEVBQUUsSUFBSTtJQVI1QixPQUFPLGVBU0g7SUFFSixPQUFhLE1BQU0sQ0FBQyxNQUFNLEVBQUUsTUFBTSxFQUFFLFNBQVMsRUFBRSxFQUFFLEVBQUUsZUFBZSxFQUFFLGVBQWUsRUFBRSxJQUFJLENBQUMsRUFBRSxJQUFJLDJCQWtCL0Y7SUFFRCxTQUFTLENBQUMsYUFBYSw0Q0FFdEI7SUFFRCxTQUFTLENBQUMsaUJBQWlCLHFCQUUxQjtJQUVEOzs7O09BSUc7SUFDSSxrQkFBa0IsSUFBSSxPQUFPLENBQUMsZUFBZSxDQUFDLENBRXBEO0lBRUQ7O09BRUc7SUFDSSxZQUFZLE9BRWxCO0lBRUQsSUFBSSxPQUFPLHVEQUVWO0lBRUQ7Ozs7T0FJRztJQUNJLFdBQVcsSUFBSSwyQkFBMkIsQ0FFaEQ7SUFFRDs7OztPQUlHO0lBQ1UsVUFBVSxJQUFJLE9BQU8sQ0FBQyxvQkFBb0IsQ0FBQyxDQUl2RDtJQUVEOzs7T0FHRztJQUNILGtCQUFrQixJQUFJLGVBQWUsQ0FFcEM7SUFFRDs7O09BR0c7SUFDVSxlQUFlLElBQUksT0FBTyxDQUFDLG1CQUFtQixDQUFDLENBMEIzRDtJQUVEOztPQUVHO0lBQ1UsY0FBYyxxQkFFMUI7Q0FDRiJ9
@@ -1 +1 @@
1
- {"version":3,"file":"account_manager.d.ts","sourceRoot":"","sources":["../../src/wallet/account_manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EACL,eAAe,EACf,KAAK,2BAA2B,EAEjC,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,QAAQ;aAIA,IAAI,EAAE,IAAI;IAR5B,OAAO,eASH;IAEJ,OAAa,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,eAAe,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,IAAI,2BAkB/F;IAED,SAAS,CAAC,aAAa,4CAEtB;IAED,SAAS,CAAC,iBAAiB,qBAE1B;IAED;;;OAGG;IACU,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAI5D;IAED;;;;OAIG;IACI,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAEpD;IAED;;OAEG;IACI,YAAY,OAElB;IAED,IAAI,OAAO,+CAEV;IAED;;;;OAIG;IACI,WAAW,IAAI,2BAA2B,CAEhD;IAED;;;;OAIG;IACU,UAAU,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAGvD;IAED;;;OAGG;IACH,kBAAkB,IAAI,eAAe,CAEpC;IAED;;;OAGG;IACU,eAAe,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAwB3D;IAED;;OAEG;IACU,cAAc,qBAE1B;CACF"}
1
+ {"version":3,"file":"account_manager.d.ts","sourceRoot":"","sources":["../../src/wallet/account_manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EACL,eAAe,EACf,KAAK,2BAA2B,EAEjC,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;GAGG;AACH,qBAAa,cAAc;IAEvB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,QAAQ;IAChB;;OAEG;aACa,IAAI,EAAE,IAAI;IAR5B,OAAO,eASH;IAEJ,OAAa,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,eAAe,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,IAAI,2BAkB/F;IAED,SAAS,CAAC,aAAa,4CAEtB;IAED,SAAS,CAAC,iBAAiB,qBAE1B;IAED;;;;OAIG;IACI,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CAEpD;IAED;;OAEG;IACI,YAAY,OAElB;IAED,IAAI,OAAO,uDAEV;IAED;;;;OAIG;IACI,WAAW,IAAI,2BAA2B,CAEhD;IAED;;;;OAIG;IACU,UAAU,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAIvD;IAED;;;OAGG;IACH,kBAAkB,IAAI,eAAe,CAEpC;IAED;;;OAGG;IACU,eAAe,IAAI,OAAO,CAAC,mBAAmB,CAAC,CA0B3D;IAED;;OAEG;IACU,cAAc,qBAE1B;CACF"}
@@ -45,14 +45,6 @@ import { DeployAccountMethod } from './deploy_account_method.js';
45
45
  return this.getPublicKeys().hash();
46
46
  }
47
47
  /**
48
- * Returns the entrypoint for this account as defined by its account contract.
49
- * @returns An entrypoint.
50
- */ async getAccountInterface() {
51
- const chainInfo = await this.wallet.getChainInfo();
52
- const completeAddress = await this.getCompleteAddress();
53
- return this.accountContract.getInterface(completeAddress, chainInfo);
54
- }
55
- /**
56
48
  * Gets the calculated complete address associated with this account.
57
49
  * Does not require the account to have been published for public execution.
58
50
  * @returns The address, partial address, and encryption public key.
@@ -79,8 +71,9 @@ import { DeployAccountMethod } from './deploy_account_method.js';
79
71
  * instances to be interacted with from this account.
80
72
  * @returns A Wallet instance.
81
73
  */ async getAccount() {
82
- const accountInterface = await this.getAccountInterface();
83
- return new AccountWithSecretKey(accountInterface, this.secretKey, this.salt);
74
+ const completeAddress = await this.getCompleteAddress();
75
+ const account = this.accountContract.getAccount(completeAddress);
76
+ return new AccountWithSecretKey(account, this.secretKey, this.salt);
84
77
  }
85
78
  /**
86
79
  * Returns the account contract that backs this account.
@@ -103,7 +96,8 @@ import { DeployAccountMethod } from './deploy_account_method.js';
103
96
  constructorName: undefined,
104
97
  constructorArgs: undefined
105
98
  };
106
- return new DeployAccountMethod(this.getPublicKeys(), this.wallet, artifact, (instance)=>Contract.at(instance.address, artifact, this.wallet), new Fr(this.salt), constructorArgs, constructorName);
99
+ const account = await this.getAccount();
100
+ return new DeployAccountMethod(this.getPublicKeys(), this.wallet, artifact, (instance)=>Contract.at(instance.address, artifact, this.wallet), new Fr(this.salt), account, constructorArgs, constructorName);
107
101
  }
108
102
  /**
109
103
  * Returns whether this account contract has an initializer function.
@@ -0,0 +1,452 @@
1
+ import type { Fr } from '@aztec/foundation/curves/bn254';
2
+ import type { AztecAddress } from '@aztec/stdlib/aztec-address';
3
+ import type { Aliased } from './wallet.js';
4
+ /**
5
+ * Current capability manifest version.
6
+ */
7
+ export declare const CAPABILITY_VERSION: "1.0";
8
+ /**
9
+ * Pattern for matching contract functions with wildcards.
10
+ *
11
+ * Used in simulation and transaction capabilities to specify which
12
+ * contract functions are allowed.
13
+ *
14
+ * @example
15
+ * // Allow any function on a specific contract
16
+ * \{ contract: ammAddress, function: '*' \}
17
+ *
18
+ * @example
19
+ * // Allow only 'swap' function on a specific contract
20
+ * \{ contract: ammAddress, function: 'swap' \}
21
+ *
22
+ * @example
23
+ * // Allow 'transfer' on any contract
24
+ * \{ contract: '*', function: 'transfer' \}
25
+ */
26
+ export interface ContractFunctionPattern {
27
+ /** Contract address or '*' for any contract */
28
+ contract: AztecAddress | '*';
29
+ /** Function name or '*' for any function */
30
+ function: string;
31
+ /**
32
+ * Additional addresses whose private state and keys are accessible
33
+ * when calling this function, beyond the sender's.
34
+ * - undefined: No additional scopes allowed
35
+ * - AztecAddress[]: Only these specific addresses allowed as additional scopes
36
+ * - '*': All known address allowed as an additional scope
37
+ */
38
+ additionalScopes?: AztecAddress[] | '*';
39
+ }
40
+ /**
41
+ * Account access capability - grants access to user accounts.
42
+ *
43
+ * Maps to wallet methods:
44
+ * - getAccounts (when canGet: true)
45
+ * - createAuthWit (when canCreateAuthWit: true)
46
+ *
47
+ * The wallet decides which accounts to reveal to the app.
48
+ * Apps don't specify which accounts they want - they just request
49
+ * the capability and the wallet shows them the available accounts.
50
+ */
51
+ export interface AccountsCapability {
52
+ /** Discriminator for capability type */
53
+ type: 'accounts';
54
+ /** Can get accounts from wallet. Maps to: getAccounts */
55
+ canGet?: boolean;
56
+ /** Can create auth witnesses for accounts. Maps to: createAuthWit */
57
+ canCreateAuthWit?: boolean;
58
+ }
59
+ /**
60
+ * Granted account access capability.
61
+ *
62
+ * Extends the request with specific accounts that were granted by the wallet.
63
+ */
64
+ export interface GrantedAccountsCapability extends AccountsCapability {
65
+ /** Specific accounts granted by the wallet with their aliases. The wallet adds this when granting the capability. */
66
+ accounts: Aliased<AztecAddress>[];
67
+ }
68
+ /**
69
+ * Contract interaction capability - for registering and querying contracts.
70
+ *
71
+ * Maps to wallet methods:
72
+ * - registerContract (when canRegister: true)
73
+ * - getContractMetadata (when canGetMetadata: true)
74
+ *
75
+ * Matching is done by contract address, not class ID. This allows updating
76
+ * existing contracts with new artifacts (e.g., when contract is upgraded
77
+ * to a new contractClassId on-chain).
78
+ *
79
+ * Note: For querying contract class metadata, use ContractClassesCapability instead.
80
+ *
81
+ * @example
82
+ * // Register and query specific contracts
83
+ * \{
84
+ * type: 'contracts',
85
+ * contracts: [ammAddress, tokenAddress],
86
+ * canRegister: true,
87
+ * canGetMetadata: true
88
+ * \}
89
+ *
90
+ * @example
91
+ * // Query any contract (read-only)
92
+ * \{
93
+ * type: 'contracts',
94
+ * contracts: '*',
95
+ * canGetMetadata: true
96
+ * \}
97
+ */
98
+ export interface ContractsCapability {
99
+ /** Discriminator for capability type */
100
+ type: 'contracts';
101
+ /**
102
+ * Which contracts this applies to:
103
+ * - '*': Any contract address
104
+ * - AztecAddress[]: Specific contract addresses
105
+ */
106
+ contracts: '*' | AztecAddress[];
107
+ /**
108
+ * Can register contracts and update existing registrations.
109
+ * Maps to: registerContract
110
+ *
111
+ * When true, allows:
112
+ * - Registering new contract instances at specified addresses
113
+ * - Re-registering existing contracts with updated artifacts (e.g., after upgrade)
114
+ */
115
+ canRegister?: boolean;
116
+ /** Can query contract metadata. Maps to: getContractMetadata */
117
+ canGetMetadata?: boolean;
118
+ }
119
+ /**
120
+ * Granted contract interaction capability.
121
+ *
122
+ * The wallet may reduce the scope (e.g., from '*' to specific addresses).
123
+ */
124
+ export interface GrantedContractsCapability extends ContractsCapability {
125
+ }
126
+ /**
127
+ * Contract class capability - for querying contract class metadata.
128
+ *
129
+ * Maps to wallet methods:
130
+ * - getContractClassMetadata
131
+ *
132
+ * Contract classes are identified by their class ID (Fr), not by contract address.
133
+ * Multiple contract instances can share the same class. This capability grants
134
+ * permission to query metadata for specific contract classes.
135
+ *
136
+ * Apps typically acquire this permission automatically when registering a contract
137
+ * with an artifact (the wallet auto-grants permission for that contract's class ID).
138
+ *
139
+ * @example
140
+ * // Query specific contract classes
141
+ * \{
142
+ * type: 'contractClasses',
143
+ * classes: [classId1, classId2],
144
+ * canGetMetadata: true
145
+ * \}
146
+ *
147
+ * @example
148
+ * // Query any contract class (wildcard)
149
+ * \{
150
+ * type: 'contractClasses',
151
+ * classes: '*',
152
+ * canGetMetadata: true
153
+ * \}
154
+ */
155
+ export interface ContractClassesCapability {
156
+ /** Discriminator for capability type */
157
+ type: 'contractClasses';
158
+ /**
159
+ * Which contract classes this applies to:
160
+ * - '*': Any contract class ID
161
+ * - Fr[]: Specific contract class IDs
162
+ */
163
+ classes: '*' | Fr[];
164
+ /** Can query contract class metadata. Maps to: getContractClassMetadata */
165
+ canGetMetadata: boolean;
166
+ }
167
+ /**
168
+ * Granted contract class capability.
169
+ *
170
+ * The wallet may reduce the scope (e.g., from '*' to specific class IDs).
171
+ */
172
+ export interface GrantedContractClassesCapability extends ContractClassesCapability {
173
+ }
174
+ /**
175
+ * Transaction simulation capability - for simulating transactions and executing utilities.
176
+ *
177
+ * Maps to wallet methods:
178
+ * - simulateTx (when transactions scope specified)
179
+ * - executeUtility (when utilities scope specified)
180
+ * - profileTx (when transactions scope specified)
181
+ *
182
+ * @example
183
+ * // Simulate any transaction on specific contracts
184
+ * \{
185
+ * type: 'simulation',
186
+ * transactions: \{
187
+ * scope: [
188
+ * \{ contract: ammAddress, function: '*' \},
189
+ * \{ contract: tokenAddress, function: 'transfer' \}
190
+ * ]
191
+ * \}
192
+ * \}
193
+ *
194
+ * @example
195
+ * // Simulate any transaction and execute any utility call
196
+ * \{
197
+ * type: 'simulation',
198
+ * transactions: \{ scope: '*' \},
199
+ * utilities: \{ scope: '*' \}
200
+ * \}
201
+ */
202
+ export interface SimulationCapability {
203
+ /** Discriminator for capability type */
204
+ type: 'simulation';
205
+ /** Transaction simulation scope. Maps to: simulateTx, profileTx */
206
+ transactions?: {
207
+ /**
208
+ * Which contracts/functions to allow:
209
+ * - '*': Any transaction
210
+ * - ContractFunctionPattern[]: Specific contract functions
211
+ */
212
+ scope: '*' | ContractFunctionPattern[];
213
+ };
214
+ /** Utility execution scope (unconstrained calls). Maps to: executeUtility */
215
+ utilities?: {
216
+ /**
217
+ * Which contracts/functions to allow:
218
+ * - '*': Any utility call
219
+ * - ContractFunctionPattern[]: Specific contract functions
220
+ */
221
+ scope: '*' | ContractFunctionPattern[];
222
+ };
223
+ }
224
+ /**
225
+ * Granted transaction simulation capability.
226
+ *
227
+ * The wallet may reduce the scope (e.g., from '*' to specific patterns).
228
+ */
229
+ export interface GrantedSimulationCapability extends SimulationCapability {
230
+ }
231
+ /**
232
+ * Transaction execution capability - for sending transactions.
233
+ *
234
+ * Maps to wallet methods:
235
+ * - sendTx
236
+ *
237
+ * Policy enforcement (rate limits, spending limits) should be handled
238
+ * at the contract level in Aztec, not at the wallet level.
239
+ *
240
+ * @example
241
+ * // Send specific transactions with approval
242
+ * \{
243
+ * type: 'transaction',
244
+ * scope: [
245
+ * \{ contract: ammAddress, function: 'swap' \},
246
+ * \{ contract: ammAddress, function: 'addLiquidity' \}
247
+ * ]
248
+ * \}
249
+ *
250
+ * @example
251
+ * // Send any transaction
252
+ * \{
253
+ * type: 'transaction',
254
+ * scope: '*'
255
+ * \}
256
+ */
257
+ export interface TransactionCapability {
258
+ /** Discriminator for capability type */
259
+ type: 'transaction';
260
+ /**
261
+ * Which contracts/functions to allow:
262
+ * - '*': Any transaction
263
+ * - ContractFunctionPattern[]: Specific patterns
264
+ */
265
+ scope: '*' | ContractFunctionPattern[];
266
+ }
267
+ /**
268
+ * Granted transaction execution capability.
269
+ *
270
+ * The wallet may reduce the scope (e.g., from '*' to specific patterns).
271
+ */
272
+ export interface GrantedTransactionCapability extends TransactionCapability {
273
+ }
274
+ /**
275
+ * Data access capability - for querying private data.
276
+ *
277
+ * Maps to wallet methods:
278
+ * - getAddressBook (when addressBook: true)
279
+ * - getPrivateEvents (when privateEvents specified)
280
+ *
281
+ * @example
282
+ * // Access address book and events from specific contract
283
+ * \{
284
+ * type: 'data',
285
+ * addressBook: true,
286
+ * privateEvents: \{
287
+ * contracts: [ammAddress],
288
+ * events: ['Swap', 'LiquidityAdded']
289
+ * \}
290
+ * \}
291
+ *
292
+ * @example
293
+ * // Access all events from any contract
294
+ * \{
295
+ * type: 'data',
296
+ * privateEvents: \{
297
+ * contracts: '*',
298
+ * events: '*'
299
+ * \}
300
+ * \}
301
+ */
302
+ export interface DataCapability {
303
+ /** Discriminator for capability type */
304
+ type: 'data';
305
+ /** Access to address book. Maps to: getAddressBook */
306
+ addressBook?: boolean;
307
+ /** Access to private events. Maps to: getPrivateEvents */
308
+ privateEvents?: {
309
+ /**
310
+ * Which contracts to allow event queries from:
311
+ * - '*': Any contract
312
+ * - AztecAddress[]: Specific contracts
313
+ */
314
+ contracts: '*' | AztecAddress[];
315
+ };
316
+ }
317
+ /**
318
+ * Granted data access capability.
319
+ *
320
+ * The wallet may reduce the scope (e.g., from '*' to specific contracts).
321
+ */
322
+ export interface GrantedDataCapability extends DataCapability {
323
+ }
324
+ /**
325
+ * Union type of all capability scopes (app request).
326
+ *
327
+ * Capabilities group wallet operations by their security sensitivity
328
+ * and functional cohesion, making permission requests understandable
329
+ * to users.
330
+ */
331
+ export type Capability = AccountsCapability | ContractsCapability | ContractClassesCapability | SimulationCapability | TransactionCapability | DataCapability;
332
+ /**
333
+ * Union type of all granted capabilities (wallet response).
334
+ *
335
+ * The wallet may augment capabilities with additional information:
336
+ * - AccountsCapability: adds specific accounts granted
337
+ * - Other capabilities: may reduce scope (e.g., '*' to specific addresses)
338
+ */
339
+ export type GrantedCapability = GrantedAccountsCapability | GrantedContractsCapability | GrantedContractClassesCapability | GrantedSimulationCapability | GrantedTransactionCapability | GrantedDataCapability;
340
+ /**
341
+ * Application capability manifest.
342
+ *
343
+ * Sent by dApp to declare all operations it needs. This reduces authorization
344
+ * friction from multiple dialogs to a single comprehensive permission request.
345
+ *
346
+ * @example
347
+ * // DEX application manifest
348
+ * const manifest: AppCapabilities = \{
349
+ * version: CAPABILITY_VERSION,
350
+ * metadata: \{
351
+ * name: 'MyDEX',
352
+ * version: '1.0.0',
353
+ * description: 'Decentralized exchange for private token swaps',
354
+ * url: 'https://example.com',
355
+ * icon: 'https://example.com/icon.png'
356
+ * \},
357
+ * capabilities: [
358
+ * \{
359
+ * type: 'accounts',
360
+ * canGet: true,
361
+ * canCreateAuthWit: true
362
+ * \},
363
+ * \{
364
+ * type: 'contracts',
365
+ * contracts: [ammAddress, tokenAAddress, tokenBAddress],
366
+ * canRegister: true,
367
+ * canGetMetadata: true
368
+ * \},
369
+ * \{
370
+ * type: 'simulation',
371
+ * transactions: \{
372
+ * scope: [\{ contract: ammAddress, function: '*' \}]
373
+ * \}
374
+ * \},
375
+ * \{
376
+ * type: 'transaction',
377
+ * scope: [\{ contract: ammAddress, function: 'swap' \}]
378
+ * \}
379
+ * ]
380
+ * \};
381
+ */
382
+ export interface AppCapabilities {
383
+ /**
384
+ * Manifest version for forward compatibility.
385
+ * Currently only '1.0' is supported.
386
+ */
387
+ version: typeof CAPABILITY_VERSION;
388
+ /** Application metadata for display in authorization dialogs. */
389
+ metadata: {
390
+ /** Human-readable app name */
391
+ name: string;
392
+ /** App version */
393
+ version: string;
394
+ /** Optional description of what the app does */
395
+ description?: string;
396
+ /** Optional website URL */
397
+ url?: string;
398
+ /** Optional icon URL or data URI */
399
+ icon?: string;
400
+ };
401
+ /**
402
+ * Requested capabilities grouped by scope.
403
+ */
404
+ capabilities: Capability[];
405
+ }
406
+ /**
407
+ * Wallet capability response.
408
+ *
409
+ * Returned by wallet after user reviews and approves/denies the capability request.
410
+ *
411
+ * The wallet can modify requested capabilities:
412
+ * - Reduce scope (e.g., restrict to specific contracts instead of '*')
413
+ * - Add information (e.g., specify which accounts are granted)
414
+ * - Deny capabilities (by omitting them from the `granted` array)
415
+ *
416
+ * @example
417
+ * // App requests
418
+ * const manifest: AppCapabilities = \{
419
+ * version: '1.0',
420
+ * metadata: \{ name: 'MyDApp', version: '1.0.0' \},
421
+ * capabilities: [
422
+ * \{ type: 'accounts', canGet: true \},
423
+ * \{ type: 'contracts', contracts: '*', canRegister: true \}
424
+ * ]
425
+ * \};
426
+ *
427
+ * // Wallet responds with specific accounts and restricted contracts
428
+ * const response = await wallet.requestCapabilities(manifest);
429
+ * console.log(response.granted);
430
+ * // [
431
+ * // \{ type: 'accounts', canGet: true, accounts: [addr1, addr2] \},
432
+ * // \{ type: 'contracts', contracts: [specificContract], canRegister: true \}
433
+ * // ]
434
+ */
435
+ export interface WalletCapabilities {
436
+ /** Response version for forward compatibility. */
437
+ version: typeof CAPABILITY_VERSION;
438
+ /**
439
+ * Capabilities granted by the wallet.
440
+ * Capabilities not in this array were implicitly denied.
441
+ * Empty array means the user denied all capabilities.
442
+ */
443
+ granted: GrantedCapability[];
444
+ /** Wallet implementation details. */
445
+ wallet: {
446
+ /** Wallet name/implementation */
447
+ name: string;
448
+ /** Wallet version */
449
+ version: string;
450
+ };
451
+ }
452
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2FwYWJpbGl0aWVzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvd2FsbGV0L2NhcGFiaWxpdGllcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUN6RCxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUVoRSxPQUFPLEtBQUssRUFBRSxPQUFPLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFFM0M7O0dBRUc7QUFDSCxlQUFPLE1BQU0sa0JBQWtCLE9BQWlCLENBQUM7QUFFakQ7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBaUJHO0FBQ0gsTUFBTSxXQUFXLHVCQUF1QjtJQUN0QywrQ0FBK0M7SUFDL0MsUUFBUSxFQUFFLFlBQVksR0FBRyxHQUFHLENBQUM7SUFFN0IsNENBQTRDO0lBQzVDLFFBQVEsRUFBRSxNQUFNLENBQUM7SUFFakI7Ozs7OztPQU1HO0lBQ0gsZ0JBQWdCLENBQUMsRUFBRSxZQUFZLEVBQUUsR0FBRyxHQUFHLENBQUM7Q0FDekM7QUFFRDs7Ozs7Ozs7OztHQVVHO0FBQ0gsTUFBTSxXQUFXLGtCQUFrQjtJQUNqQyx3Q0FBd0M7SUFDeEMsSUFBSSxFQUFFLFVBQVUsQ0FBQztJQUVqQix5REFBeUQ7SUFDekQsTUFBTSxDQUFDLEVBQUUsT0FBTyxDQUFDO0lBRWpCLHFFQUFxRTtJQUNyRSxnQkFBZ0IsQ0FBQyxFQUFFLE9BQU8sQ0FBQztDQUM1QjtBQUVEOzs7O0dBSUc7QUFDSCxNQUFNLFdBQVcseUJBQTBCLFNBQVEsa0JBQWtCO0lBQ25FLHFIQUFxSDtJQUNySCxRQUFRLEVBQUUsT0FBTyxDQUFDLFlBQVksQ0FBQyxFQUFFLENBQUM7Q0FDbkM7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0E2Qkc7QUFDSCxNQUFNLFdBQVcsbUJBQW1CO0lBQ2xDLHdDQUF3QztJQUN4QyxJQUFJLEVBQUUsV0FB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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/wallet/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,kBAAkB,OAAiB,CAAC;AAEjD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,QAAQ,EAAE,YAAY,GAAG,GAAG,CAAC;IAE7B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC;CACzC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,IAAI,EAAE,UAAU,CAAC;IAEjB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,qHAAqH;IACrH,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,IAAI,EAAE,WAAW,CAAC;IAElB;;;;OAIG;IACH,SAAS,EAAE,GAAG,GAAG,YAAY,EAAE,CAAC;IAEhC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB;CAAG;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,yBAAyB;IACxC,wCAAwC;IACxC,IAAI,EAAE,iBAAiB,CAAC;IAExB;;;;OAIG;IACH,OAAO,EAAE,GAAG,GAAG,EAAE,EAAE,CAAC;IAEpB,2EAA2E;IAC3E,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,gCAAiC,SAAQ,yBAAyB;CAAG;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,IAAI,EAAE,YAAY,CAAC;IAEnB,mEAAmE;IACnE,YAAY,CAAC,EAAE;QACb;;;;WAIG;QACH,KAAK,EAAE,GAAG,GAAG,uBAAuB,EAAE,CAAC;KACxC,CAAC;IAEF,6EAA6E;IAC7E,SAAS,CAAC,EAAE;QACV;;;;WAIG;QACH,KAAK,EAAE,GAAG,GAAG,uBAAuB,EAAE,CAAC;KACxC,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;CAAG;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,IAAI,EAAE,aAAa,CAAC;IAEpB;;;;OAIG;IACH,KAAK,EAAE,GAAG,GAAG,uBAAuB,EAAE,CAAC;CACxC;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA6B,SAAQ,qBAAqB;CAAG;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,0DAA0D;IAC1D,aAAa,CAAC,EAAE;QACd;;;;WAIG;QACH,SAAS,EAAE,GAAG,GAAG,YAAY,EAAE,CAAC;KACjC,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;CAAG;AAEhE;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAClB,kBAAkB,GAClB,mBAAmB,GACnB,yBAAyB,GACzB,oBAAoB,GACpB,qBAAqB,GACrB,cAAc,CAAC;AAEnB;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GACzB,yBAAyB,GACzB,0BAA0B,GAC1B,gCAAgC,GAChC,2BAA2B,GAC3B,4BAA4B,GAC5B,qBAAqB,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,OAAO,EAAE,OAAO,kBAAkB,CAAC;IAEnC,iEAAiE;IACjE,QAAQ,EAAE;QACR,8BAA8B;QAC9B,IAAI,EAAE,MAAM,CAAC;QAEb,kBAAkB;QAClB,OAAO,EAAE,MAAM,CAAC;QAEhB,gDAAgD;QAChD,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB,2BAA2B;QAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;QAEb,oCAAoC;QACpC,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IAEF;;OAEG;IACH,YAAY,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,OAAO,EAAE,OAAO,kBAAkB,CAAC;IAEnC;;;;OAIG;IACH,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAE7B,qCAAqC;IACrC,MAAM,EAAE;QACN,iCAAiC;QACjC,IAAI,EAAE,MAAM,CAAC;QAEb,qBAAqB;QACrB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH"}
@@ -0,0 +1,3 @@
1
+ /**
2
+ * Current capability manifest version.
3
+ */ export const CAPABILITY_VERSION = '1.0';