Merge pull request #610 from AztecProtocol/cb/merge-public-next-raw

chore: merge public-next into next (raw, conflict markers)

Author: PhilWindle

docs/developer_version_config.json

@@ -1,4 +1,4 @@
 {
   "mainnet": "v4.3.1",
-  "testnet": "v5.0.0-rc.2"
+  "testnet": "v5.0.0"
 }

docs/developer_versioned_docs/version-v5.0.0-rc.2/docs/aztec-nr/framework-description/calling_contracts.md

@@ -16,7 +16,7 @@ This guide shows you how to connect your application to the Aztec local network
 ## Install dependencies
 
 ```bash
-yarn add @aztec/aztec.js@5.0.0-rc.2 @aztec/wallets@5.0.0-rc.2
+yarn add @aztec/aztec.js@5.0.0 @aztec/wallets@5.0.0
 ```
 
 ## Connect to the network
@@ -37,7 +37,7 @@ await waitForNode(node);
 // Create an EmbeddedWallet connected to the node
 const wallet = await EmbeddedWallet.create(node, { ephemeral: true });
 ```
-> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0-rc.2/docs/examples/ts/aztecjs_connection/index.ts#L1-L14" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L1-L14</a></sub></sup>
+> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0/docs/examples/ts/aztecjs_connection/index.ts#L1-L14" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L1-L14</a></sub></sup>
 
 
 :::note About EmbeddedWallet
@@ -57,7 +57,7 @@ const nodeInfo = await node.getNodeInfo();
 console.log("Connected to local network version:", nodeInfo.nodeVersion);
 console.log("Chain ID:", nodeInfo.l1ChainId);
 ```
-> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0-rc.2/docs/examples/ts/aztecjs_connection/index.ts#L16-L20" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L16-L20</a></sub></sup>
+> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0/docs/examples/ts/aztecjs_connection/index.ts#L16-L20" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L16-L20</a></sub></sup>
 
 
 ### Load pre-funded accounts
@@ -81,7 +81,7 @@ const [aliceAddress, bobAddress] = await Promise.all(
 console.log(`Alice's address: ${aliceAddress.toString()}`);
 console.log(`Bob's address: ${bobAddress.toString()}`);
 ```
-> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0-rc.2/docs/examples/ts/aztecjs_connection/index.ts#L22-L38" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L22-L38</a></sub></sup>
+> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0/docs/examples/ts/aztecjs_connection/index.ts#L22-L38" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L22-L38</a></sub></sup>
 
 
 These accounts are pre-funded with fee juice (the native gas token) at genesis, so you can immediately send transactions without needing to bridge funds from L1.
@@ -96,7 +96,7 @@ import { getFeeJuiceBalance } from "@aztec/aztec.js/utils";
 const aliceBalance = await getFeeJuiceBalance(aliceAddress, node);
 console.log(`Alice's fee juice balance: ${aliceBalance}`);
 ```
-> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0-rc.2/docs/examples/ts/aztecjs_connection/index.ts#L40-L45" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L40-L45</a></sub></sup>
+> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0/docs/examples/ts/aztecjs_connection/index.ts#L40-L45" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L40-L45</a></sub></sup>
 
 
 ## Next steps

…d_docs/version-v5.0.0-rc.2/ai_tooling.md …sioned_docs/version-v5.0.0/ai_tooling.mddocs/developer_versioned_docs/version-v5.0.0-rc.2/ai_tooling.md renamed to docs/developer_versioned_docs/version-v5.0.0/ai_tooling.md docs/developer_versioned_docs/version-v5.0.0-rc.2/ai_tooling.md renamed to docs/developer_versioned_docs/version-v5.0.0/ai_tooling.md

@@ -15,33 +15,54 @@ This guide shows you how to create and deploy a new account on Aztec.
 ## Install dependencies
 
 ```bash
-yarn add @aztec/aztec.js@5.0.0-rc.2 @aztec/wallets@5.0.0-rc.2 @aztec/noir-contracts.js@5.0.0-rc.2
+yarn add @aztec/aztec.js@5.0.0 @aztec/wallets@5.0.0 @aztec/noir-contracts.js@5.0.0
 ```
 
 ## Create a new account
 
-Using the [`wallet` from the connection guide](./how_to_connect_to_local_network.md), call `createSchnorrAccount` to create a new account with a random secret and salt:
+Using the [`wallet` from the connection guide](./how_to_connect_to_local_network.md), call `createSchnorrAccount` to create a new account with a random secret, salt, and signing key:
 
 ```typescript title="create_account" showLineNumbers 
-import { Fr } from "@aztec/aztec.js/fields";
+import { Fr, GrumpkinScalar } from "@aztec/aztec.js/fields";
 
 const secret = Fr.random();
 const salt = Fr.random();
-const newAccount = await wallet.createSchnorrAccount(secret, salt);
+const signingKey = GrumpkinScalar.random();
+const newAccount = await wallet.createSchnorrAccount(secret, salt, signingKey);
 console.log("New account address:", newAccount.address.toString());
 ```
-> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0-rc.2/docs/examples/ts/aztecjs_connection/index.ts#L47-L54" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L47-L54</a></sub></sup>
+> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0/docs/examples/ts/aztecjs_connection/index.ts#L47-L55" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L47-L55</a></sub></sup>
 
 
-The secret is used to derive the account's encryption keys, and the salt ensures address uniqueness. The signing key is automatically derived from the secret.
+The secret derives the account's encryption keys, the signing key authenticates its transactions, and the salt ensures address uniqueness. The signing key is provided independently and is not derived from the secret: it is an ownership key, so keep it separate from the encryption secret that your PXE holds.
 
-:::warning Store your secret and salt
-Save the `secret` and `salt` values securely. You need both to recover access to your account. If you lose them, you will permanently lose access to the account and any assets it holds.
+:::warning Store your secret, salt, and signing key
+Save the `secret`, `salt`, and `signingKey` values securely. You need all three to recover access to your account. If you lose them, you will permanently lose access to the account and any assets it holds.
 :::
 
+## Create an initializerless account
+
+Alternatively, create an [initializerless account](../foundational-topics/accounts/deployment.md), which needs no deployment transaction at all:
+
+```typescript
+const secret = Fr.random();
+const salt = Fr.random();
+const account = await wallet.createSchnorrInitializerlessAccount(secret, salt);
+console.log("Account address:", account.address.toString());
+```
+
+An initializerless account commits its signing public key into the address itself (through the instance's `immutables_hash`), so there is no onchain state to initialize. Creating the account registers it locally in the PXE, and it is ready to use immediately: skip the deployment section below entirely. Fees are only needed for the account's first real transaction, paid with any of the usual [payment methods](./how_to_pay_fees.md).
+
+Two things to keep in mind:
+
+- The signing key cannot be changed later. A new key means a new address.
+- Calling `getDeployMethod()` on an initializerless account throws, since there is nothing to deploy.
+
+See [account deployment](../foundational-topics/accounts/deployment.md) for how this works and how to choose between the two account types.
+
 ## Deploy the account
 
-New accounts must be deployed before they can send transactions. Deployment requires paying fees.
+Accounts created with `createSchnorrAccount` must be deployed before they can send transactions (initializerless accounts skip this step). Deployment requires paying fees.
 
 ### Using the Sponsored FPC
 
@@ -74,7 +95,7 @@ await deployMethod.send({
   fee: { paymentMethod: sponsoredPaymentMethod },
 });
 ```
-> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0-rc.2/docs/examples/ts/aztecjs_connection/index.ts#L56-L82" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L56-L82</a></sub></sup>
+> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0/docs/examples/ts/aztecjs_connection/index.ts#L57-L83" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L57-L83</a></sub></sup>
 
 
 :::info
@@ -93,12 +114,14 @@ Create a new Schnorr account for this path:
 // can coexist in one example; in your own code, pick whichever name fits.
 const feeJuiceSecret = Fr.random();
 const feeJuiceSalt = Fr.random();
+const feeJuiceSigningKey = GrumpkinScalar.random();
 const feeJuiceAccount = await wallet.createSchnorrAccount(
   feeJuiceSecret,
   feeJuiceSalt,
+  feeJuiceSigningKey,
 );
 ```
-> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0-rc.2/docs/examples/ts/aztecjs_connection/index.ts#L84-L94" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L84-L94</a></sub></sup>
+> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0/docs/examples/ts/aztecjs_connection/index.ts#L85-L97" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L85-L97</a></sub></sup>
 
 
 Claim the bridged Fee Juice and deploy in one step:
@@ -120,7 +143,7 @@ await deployMethodBridged.send({
   fee: { paymentMethod: bridgePaymentMethod },
 });
 ```
-> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0-rc.2/docs/examples/ts/aztecjs_connection/index.ts#L163-L179" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L163-L179</a></sub></sup>
+> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0/docs/examples/ts/aztecjs_connection/index.ts#L166-L182" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L166-L182</a></sub></sup>
 
 
 If the account already has Fee Juice on L2 (for example, from a faucet or a previously claimed bridge), no special payment method is needed — just call `send({ from: NO_FROM })` and Fee Juice is used automatically.
@@ -137,12 +160,12 @@ Confirm the account was deployed successfully. Substitute the account variable f
 const metadata = await wallet.getContractMetadata(newAccount.address);
 console.log("Account deployed:", metadata.initializationStatus);
 ```
-> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0-rc.2/docs/examples/ts/aztecjs_connection/index.ts#L181-L186" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L181-L186</a></sub></sup>
+> <sup><sub><a href="https://github.com/AztecProtocol/aztec-packages/blob/v5.0.0/docs/examples/ts/aztecjs_connection/index.ts#L184-L189" target="_blank" rel="noopener noreferrer">Source code: docs/examples/ts/aztecjs_connection/index.ts#L184-L189</a></sub></sup>
 
 
 ## Next steps
 
 - [Deploy contracts](./how_to_deploy_contract.md) with your new account
 - [Send transactions](./how_to_send_transaction.md) from an account
-- Learn about [account abstraction](../foundational-topics/accounts/index.md)
+- Learn about [account abstraction](../foundational-topics/accounts/index.md) and [account deployment](../foundational-topics/accounts/deployment.md)
 - Implement [authentication witnesses](./how_to_use_authwit.md)