,
+amount: Field,
+```
+> Source code: noir-projects/aztec-nr/value-note/src/utils.nr#L27-L30
+
+
+Note that this will create a new note in the set of notes passed as the first argument.
+For example:
+```rust title="increment_valuenote" showLineNumbers
+increment(storage.notes.at(owner), value, owner, sender);
+```
+> Source code: noir-projects/noir-contracts/contracts/benchmarking_contract/src/main.nr#L24-L26
+
+
+The `decrement` function works similarly except the `amount` is the number that the value will be decremented by, and it will fail if the sum of the selected notes is less than the amount.
+
+## Learn more
+
+- [Keys, including nullifier keys and outgoing viewer](../../../../../aztec/concepts/accounts/keys.md)
+- [How to implement a note](./implementing_a_note.md)
+- [ValueNote reference](../../../../reference/smart_contract_reference/aztec-nr/value-note/value_note.md)
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/guides/smart_contracts/writing_contracts/portals/communicate_with_portal.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/guides/smart_contracts/writing_contracts/portals/communicate_with_portal.md
new file mode 100644
index 000000000000..5c6356344dfa
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/guides/smart_contracts/writing_contracts/portals/communicate_with_portal.md
@@ -0,0 +1,381 @@
+---
+title: Communicating with L1
+tags: [contracts, portals]
+---
+
+Follow the [token bridge tutorial](../../../../../developers/tutorials/codealong/contract_tutorials/token_bridge.md) for hands-on experience writing and deploying a Portal contract.
+
+## Passing data to the rollup
+
+Whether it is tokens or other information being passed to the rollup, the portal should use the `Inbox` to do it.
+
+The `Inbox` can be seen as a mailbox to the rollup, portals put messages into the box, and the sequencer then consumes a batch of messages from the box and include it in their blocks.
+
+When sending messages, we need to specify quite a bit of information beyond just the content that we are sharing. Namely we need to specify:
+
+| Name | Type | Description |
+| ----------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Recipient | `L2Actor` | The message recipient. This **MUST** match the rollup version and an Aztec contract that is **attached** to the contract making this call. If the recipient is not attached to the caller, the message cannot be consumed by it. |
+| Secret Hash | `field` (~254 bits) | A hash of a secret that is used when consuming the message on L2. Keep this preimage a secret to make the consumption private. To consume the message the caller must know the pre-image (the value that was hashed) - so make sure your app keeps track of the pre-images! Use `computeSecretHash` to compute it from a secret. |
+| Content | `field` (~254 bits) | The content of the message. This is the data that will be passed to the recipient. The content is limited to be a single field. If the content is small enough it can just be passed along, otherwise it should be hashed and the hash passed along (you can use our [`Hash` (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/master/l1-contracts/src/core/libraries/Hash.sol) utilities with `sha256ToField` functions) |
+
+With all that information at hand, we can call the `sendL2Message` function on the Inbox. The function will return a `field` (inside `bytes32`) that is the hash of the message. This hash can be used as an identifier to spot when your message has been included in a rollup block.
+
+```solidity title="send_l1_to_l2_message" showLineNumbers
+/**
+ * @notice Inserts a new message into the Inbox
+ * @dev Emits `MessageSent` with data for easy access by the sequencer
+ * @param _recipient - The recipient of the message
+ * @param _content - The content of the message (application specific)
+ * @param _secretHash - The secret hash of the message (make it possible to hide when a specific message is consumed on L2)
+ * @return The key of the message in the set and its leaf index in the tree
+ */
+function sendL2Message(
+ DataStructures.L2Actor memory _recipient,
+ bytes32 _content,
+ bytes32 _secretHash
+) external returns (bytes32, uint256);
+```
+> Source code: l1-contracts/src/core/interfaces/messagebridge/IInbox.sol#L21-L35
+
+
+A sequencer will consume the message batch your message was included in and include it in their block.
+Upon inclusion, it is made available to be consumed on L2 via the L2 outbox.
+
+To consume the message, we can use the `consume_l1_to_l2_message` function within the `context` struct.
+
+- The `msg_key` is the hash of the message returned by the `sendL2Message` call and is used to help the RPC find the correct message.
+- The `content` is the content of the message, limited to one Field element. For content larger than one Field, we suggest using the `sha256` hash function truncated to a single Field element. `sha256` is suggested as it is cheap on L1 while still being manageable on L2.
+- The `secret` is the pre-image hashed using Pedersen to compute the `secretHash`.
+- If the `content` or `secret` does not match the entry at `msg_key` the message will not be consumed, and the transaction will revert.
+
+:::info
+Note that while the `secret` and the `content` are both hashed, they are actually hashed with different hash functions!
+:::
+
+```rust title="context_consume_l1_to_l2_message" showLineNumbers
+pub fn consume_l1_to_l2_message(
+ &mut self,
+ content: Field,
+ secret: Field,
+ sender: EthAddress,
+ leaf_index: Field,
+) {
+```
+> Source code: noir-projects/aztec-nr/aztec/src/context/private_context.nr#L300-L309
+
+
+### Token bridge example
+
+Computing the `content` must currently be done manually, as we are still adding a number of bytes utilities. A good example exists within the [Token bridge example (codealong tutorial)](../../../../../developers/tutorials/codealong/contract_tutorials/token_bridge.md).
+
+```rust title="claim_public" showLineNumbers
+// Consumes a L1->L2 message and calls the token contract to mint the appropriate amount publicly
+#[public]
+fn claim_public(to: AztecAddress, amount: u128, secret: Field, message_leaf_index: Field) {
+ let content_hash = get_mint_to_public_content_hash(to, amount);
+
+ let config = storage.config.read();
+
+ // Consume message and emit nullifier
+ context.consume_l1_to_l2_message(content_hash, secret, config.portal, message_leaf_index);
+
+ // Mint tokens
+ Token::at(config.token).mint_to_public(to, amount).call(&mut context);
+}
+```
+> Source code: noir-projects/noir-contracts/contracts/token_bridge_contract/src/main.nr#L57-L71
+
+
+:::info
+The `content_hash` is a sha256 truncated to a field element (~ 254 bits). In Aztec.nr, you can use our `sha256_to_field()` to do a sha256 hash which fits in one field element
+:::
+
+### Token portal hash library
+
+```rust title="mint_to_public_content_hash_nr" showLineNumbers
+use dep::aztec::prelude::{AztecAddress, EthAddress};
+use dep::aztec::protocol_types::{hash::sha256_to_field, traits::ToField};
+
+// Computes a content hash of a deposit/mint_to_public message.
+// Refer TokenPortal.sol for reference on L1.
+pub fn get_mint_to_public_content_hash(owner: AztecAddress, amount: u128) -> Field {
+ let mut hash_bytes = [0; 68];
+ let recipient_bytes: [u8; 32] = owner.to_field().to_be_bytes();
+ let amount_bytes: [u8; 32] = (amount as Field).to_be_bytes();
+
+ // The purpose of including the following selector is to make the message unique to that specific call. Note that
+ // it has nothing to do with calling the function.
+ let selector =
+ comptime { keccak256::keccak256("mint_to_public(bytes32,uint256)".as_bytes(), 31) };
+
+ for i in 0..4 {
+ hash_bytes[i] = selector[i];
+ }
+
+ for i in 0..32 {
+ hash_bytes[i + 4] = recipient_bytes[i];
+ hash_bytes[i + 36] = amount_bytes[i];
+ }
+
+ let content_hash = sha256_to_field(hash_bytes);
+ content_hash
+}
+```
+> Source code: noir-projects/noir-contracts/contracts/token_portal_content_hash_lib/src/lib.nr#L1-L29
+
+
+### Token Portal contract
+
+In Solidity, you can use our `Hash.sha256ToField()` method:
+
+```solidity title="content_hash_sol_import" showLineNumbers
+import {Hash} from "@aztec/core/libraries/crypto/Hash.sol";
+```
+> Source code: l1-contracts/test/portals/TokenPortal.sol#L12-L14
+
+
+```solidity title="deposit_public" showLineNumbers
+/**
+ * @notice Deposit funds into the portal and adds an L2 message which can only be consumed publicly on Aztec
+ * @param _to - The aztec address of the recipient
+ * @param _amount - The amount to deposit
+ * @param _secretHash - The hash of the secret consumable message. The hash should be 254 bits (so it can fit in a Field element)
+ * @return The key of the entry in the Inbox and its leaf index
+ */
+function depositToAztecPublic(bytes32 _to, uint256 _amount, bytes32 _secretHash)
+ external
+ returns (bytes32, uint256)
+```
+> Source code: l1-contracts/test/portals/TokenPortal.sol#L45-L56
+
+
+The `secret_hash` uses the pederson hash which fits in a field element. You can use the utility method `computeSecretHash()`in `@aztec/aztec.js` npm package to generate a secret and its corresponding hash.
+
+After the transaction has been mined, the message is consumed, a nullifier is emitted and the tokens have been minted on Aztec and are ready for claiming.
+
+Since the message consumption is emitting a nullifier, the same message cannot be consumed again. The index in the message tree is used as part of the nullifier computation, ensuring that the same content and secret being inserted will be distinct messages that can each be consumed. Without the index in the nullifier, it would be possible to perform a kind of attack known as `Faerie Gold` attacks where two seemingly good messages are inserted, but only one of them can be consumed later.
+
+## Passing data to L1
+
+To pass data to L1, we use the `Outbox`. The `Outbox` is the mailbox for L2 to L1 messages. This is the location on L1 where all the messages from L2 will live, and where they can be consumed from.
+
+:::danger
+
+Similarly to messages going to L2 from L1, a message can only be consumed by the specified recipient. But it is up to the portal contract to ensure that the sender is as expected! Any L2 contract can send a message to a portal contract on L1, but the portal contract should only consume messages from the expected sender.
+
+:::
+
+The portal must ensure that the sender is as expected. One flexible solution is to have an `initialize` function in the portal contract which can be used to set the address of the Aztec contract. In this model, the portal contract can check that the sender matches the value it has in storage.
+
+To send a message to L1 from your Aztec contract, you must use the `message_portal` function on the `context`. When messaging to L1, only the `content` is required (as a `Field`).
+
+```rust title="context_message_portal" showLineNumbers
+pub fn message_portal(&mut self, recipient: EthAddress, content: Field) {
+```
+> Source code: noir-projects/aztec-nr/aztec/src/context/private_context.nr#L293-L295
+
+
+When sending a message from L2 to L1 we don't need to pass in a secret.
+
+:::danger
+Access control on the L1 portal contract is essential to prevent consumption of messages sent from the wrong L2 contract.
+:::
+
+### Token bridge
+
+As earlier, we can use a token bridge as an example. In this case, we are burning tokens on L2 and sending a message to the portal to free them on L1.
+
+```rust title="exit_to_l1_private" showLineNumbers
+// Burns the appropriate amount of tokens and creates a L2 to L1 withdraw message privately
+// Requires `msg.sender` (caller of the method) to give approval to the bridge to burn tokens on their behalf using witness signatures
+#[private]
+fn exit_to_l1_private(
+ token: AztecAddress,
+ recipient: EthAddress, // ethereum address to withdraw to
+ amount: u128,
+ caller_on_l1: EthAddress, // ethereum address that can call this function on the L1 portal (0x0 if anyone can call)
+ nonce: Field, // nonce used in the approval message by `msg.sender` to let bridge burn their tokens on L2
+) {
+ let config = storage.config.read();
+
+ // Assert that user provided token address is same as seen in storage.
+ assert_eq(config.token, token, "Token address is not the same as seen in storage");
+
+ // Send an L2 to L1 message
+ let content = get_withdraw_content_hash(recipient, amount, caller_on_l1);
+ context.message_portal(config.portal, content);
+
+ // Burn tokens
+ Token::at(token).burn_private(context.msg_sender(), amount, nonce).call(&mut context);
+}
+```
+> Source code: noir-projects/noir-contracts/contracts/token_bridge_contract/src/main.nr#L125-L150
+
+
+When the transaction is included in a rollup block and published to Ethereum the message will be inserted into the `Outbox` on Ethereum, where the recipient portal can consume it from. When consuming, the `msg.sender` must match the `recipient` meaning that only portal can actually consume the message.
+
+```solidity title="l2_to_l1_msg" showLineNumbers
+/**
+ * @notice Struct containing a message from L2 to L1
+ * @param sender - The sender of the message
+ * @param recipient - The recipient of the message
+ * @param content - The content of the message (application specific) padded to bytes32 or hashed if larger.
+ * @dev Not to be confused with L2ToL1Message in Noir circuits
+ */
+struct L2ToL1Msg {
+ DataStructures.L2Actor sender;
+ DataStructures.L1Actor recipient;
+ bytes32 content;
+}
+```
+> Source code: l1-contracts/src/core/libraries/DataStructures.sol#L53-L66
+
+
+#### Outbox `consume`
+
+```solidity title="outbox_consume" showLineNumbers
+/**
+ * @notice Consumes an entry from the Outbox
+ * @dev Only useable by portals / recipients of messages
+ * @dev Emits `MessageConsumed` when consuming messages
+ * @param _message - The L2 to L1 message
+ * @param _l2BlockNumber - The block number specifying the block that contains the message we want to consume
+ * @param _leafIndex - The index inside the merkle tree where the message is located
+ * @param _path - The sibling path used to prove inclusion of the message, the _path length directly depends
+ * on the total amount of L2 to L1 messages in the block. i.e. the length of _path is equal to the depth of the
+ * L1 to L2 message tree.
+ */
+function consume(
+ DataStructures.L2ToL1Msg calldata _message,
+ uint256 _l2BlockNumber,
+ uint256 _leafIndex,
+ bytes32[] calldata _path
+) external;
+```
+> Source code: l1-contracts/src/core/interfaces/messagebridge/IOutbox.sol#L35-L53
+
+
+#### Withdraw
+
+As noted earlier, the portal contract should check that the sender is as expected. In the example below, we support only one sender contract (stored in `l2TokenAddress`) so we can just pass it as the sender, that way we will only be able to consume messages from that contract.
+
+It is possible to support multiple senders from L2. You could use a have `mapping(address => bool) allowed` and check that `allowed[msg.sender]` is `true`.
+
+```solidity title="token_portal_withdraw" showLineNumbers
+/**
+ * @notice Withdraw funds from the portal
+ * @dev Second part of withdraw, must be initiated from L2 first as it will consume a message from outbox
+ * @param _recipient - The address to send the funds to
+ * @param _amount - The amount to withdraw
+ * @param _withCaller - Flag to use `msg.sender` as caller, otherwise address(0)
+ * @param _l2BlockNumber - The address to send the funds to
+ * @param _leafIndex - The amount to withdraw
+ * @param _path - Flag to use `msg.sender` as caller, otherwise address(0)
+ * Must match the caller of the message (specified from L2) to consume it.
+ */
+function withdraw(
+ address _recipient,
+ uint256 _amount,
+ bool _withCaller,
+ uint256 _l2BlockNumber,
+ uint256 _leafIndex,
+ bytes32[] calldata _path
+) external {
+ // The purpose of including the function selector is to make the message unique to that specific call. Note that
+ // it has nothing to do with calling the function.
+ DataStructures.L2ToL1Msg memory message = DataStructures.L2ToL1Msg({
+ sender: DataStructures.L2Actor(l2Bridge, 1),
+ recipient: DataStructures.L1Actor(address(this), block.chainid),
+ content: Hash.sha256ToField(
+ abi.encodeWithSignature(
+ "withdraw(address,uint256,address)",
+ _recipient,
+ _amount,
+ _withCaller ? msg.sender : address(0)
+ )
+ )
+ });
+
+ IOutbox outbox = IRollup(registry.getRollup()).getOutbox();
+
+ outbox.consume(message, _l2BlockNumber, _leafIndex, _path);
+
+ underlying.transfer(_recipient, _amount);
+}
+```
+> Source code: l1-contracts/test/portals/TokenPortal.sol#L114-L155
+
+
+## Considerations
+
+### Structure of messages
+
+Application developers should consider creating messages that follow a function call structure e.g., using a function signature and arguments. This will make it easier to prevent producing messages that could be misinterpreted by the recipient.
+
+An example of a bad format would be using `amount, token_address, recipient_address` as the message for a withdraw function and `amount, token_address, on_behalf_of_address` for a deposit function. Any deposit could then also be mapped to a withdraw or vice versa.
+
+```solidity
+// Don't to this!
+bytes memory message = abi.encode(
+ _amount,
+ _token,
+ _to
+);
+
+// Do this!
+bytes memory message abi.encodeWithSignature(
+ "withdraw(uint256,address,address)",
+ _amount,
+ _token,
+ _to
+);
+```
+
+### Error Handling
+
+Handling error when moving cross chain can quickly get tricky. Since the L1 and L2 calls are async and independent of each other, the L1 part of a deposit might execute just fine, with the L2 part failing. If this is not handled well, the funds may be lost forever! Developers should consider ways their application can fail cross chain, and handle all cases explicitly.
+
+First, entries in the outboxes **SHOULD** only be consumed if the execution is successful. For an L2 -> L1 call, the L1 execution can revert the transaction completely if anything fails. As the tx is atomic, the failure also reverts consumption.
+
+If it is possible to enter a state where the second part of the execution fails forever, the application builder should consider including additional failure mechanisms (for token withdraws this could be depositing them again etc).
+
+Generally it is good practice to keep cross-chain calls simple to avoid too many edge cases and state reversions.
+
+:::info
+Error handling for cross chain messages is handled by the application contract and not the protocol. The protocol only delivers the messages, it does not ensure that they are executed successfully.
+:::
+
+### Designated caller
+
+Designating a caller grants the ability to specify who should be able to call a function that consumes a message. This is useful for ordering of batched messages.
+
+When performing multiple cross-chain calls in one action it is important to consider the order of the calls. Say for example, that you want to perform a uniswap trade on L1. You would withdraw funds from the rollup, swap them on L1, and then deposit the swapped funds back into the rollup. This is a straightforward process, but it requires that the calls are done in the correct order (e.g. if the swap is called before the funds are withdrawn, the swap will fail).
+
+The message boxes (Inbox and Outbox) will only allow the recipient portal to consume the message, and we can use this to ensure that the calls are done in the correct order. Say that we include a designated "caller" in the messages, and that the portal contract checks that the caller matches the designated caller or designated as `address(0)` (if anyone can call). When the messages are to be consumed on L1, it can compute the message as seen below:
+
+```solidity
+bytes memory message = abi.encodeWithSignature(
+ "withdraw(uint256,address,address)",
+ _amount,
+ _to,
+ _withCaller ? msg.sender : address(0)
+);
+```
+
+This way, the message can be consumed by the portal contract, but only if the caller is the specified caller. In the logic of the contract that is the designated caller, we can ensure that the calls are done in the correct order.
+
+For example, we could require that the Uniswap portal is the caller of the withdrawal, and ensure that the uniswap portal contract implementation is executing the withdrawal before the swap.
+The order of execution can be specified in the contract. Since all of the messages are emitted to L1 in the same transaction, we can leverage transaction atomicity to ensure success of failure of all messages.
+
+Note, that crossing the L1/L2 chasm is asynchronous, so there could be a situation where the user has burned their assets on L2 but the swap fails on L1! This could be due to major price movements for example. In such a case, the user could be stuck with funds on L1 that they cannot get back to L2 unless the portal contract implements a way to properly handle such errors.
+
+:::caution
+Designated callers are enforced at the contract level for contracts that are not the rollup itself, and should not be trusted to implement the contract correctly. The user should always be aware that it is possible for the developer to implement something that looks like designated caller without providing the abilities to the user.
+:::
+
+## Examples of portals
+
+- Token bridge (Portal contract built for L1 -> L2, i.e., a non-native L2 asset)
+ - [Portal contract (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/v0.82.2/l1-contracts/test/portals/TokenPortal.sol)
+ - [Aztec contract (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/v0.82.2/noir-projects/noir-contracts/contracts/token_bridge_contract/src/main.nr)
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/guides/smart_contracts/writing_contracts/portals/index.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/guides/smart_contracts/writing_contracts/portals/index.md
new file mode 100644
index 000000000000..d9292f2848e8
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/guides/smart_contracts/writing_contracts/portals/index.md
@@ -0,0 +1,6 @@
+---
+title: Portals
+sidebar_position: 7
+---
+
+A portal is a point of contact between L1 and a contract on Aztec. For applications such as token bridges, this is the point where the tokens are held on L1 while used in L2. Note, that a portal doesn't actually need to be a contract, it could be any address on L1.
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/guides/smart_contracts/writing_contracts/storage/index.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/guides/smart_contracts/writing_contracts/storage/index.md
new file mode 100644
index 000000000000..622df9645037
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/guides/smart_contracts/writing_contracts/storage/index.md
@@ -0,0 +1,21 @@
+---
+title: Declaring Storage
+sidebar_position: 2
+tags: [contracts, storage]
+---
+
+On this page, you will learn how to define storage in your smart contract.
+
+To learn more about how storage works in Aztec, read [the concepts](./storage_slots.md).
+
+[See the storage reference](../../../../reference/smart_contract_reference/storage/index.md).
+
+```rust
+#[storage]
+struct Storage {
+ // public state variables
+ // private state variables
+}
+```
+
+If you have defined a struct and annotated it as `#[storage]`, then it will be made available to you through the reserved `storage` keyword within your contract functions.
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/guides/smart_contracts/writing_contracts/storage/notes.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/guides/smart_contracts/writing_contracts/storage/notes.md
new file mode 100644
index 000000000000..622c215463a2
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/guides/smart_contracts/writing_contracts/storage/notes.md
@@ -0,0 +1,169 @@
+---
+title: Writing Notes
+description: Core knowledge of Notes and how they work
+useful-for: dev
+tags: [contracts, storage, notes]
+---
+
+Most prominent blockchain networks don't have privacy at the protocol level. Aztec contracts can define public and private functions, that can read/write public and private state.
+
+To be clear, "private" here is referring to the opposite of how things work on a public blockchain network, not the conventional syntax for visibility within code.
+
+For private state we need encryption and techniques to hide information about state changes. For private functions, we need local execution and proof of correct execution.
+
+### Some context
+
+- Public functions and storage work much like other blockchains in terms of having dedicated storage slots and being publicly visible
+- Private functions are executed locally with proofs generated for sound execution, and commitments to private variable updates are stored using append-only trees
+- "Note" types are part of Aztec.nr, a framework that facilitates use of Aztec's different storage trees to achieve things such as private variables
+
+This page will focus on how private variables are implemented with Notes and storage trees.
+
+#### Side-note about execution
+
+Under the hood, the Aztec protocol handles some important details around public and private function calls. Calls between them are asynchronous due to different execution contexts (local execution vs. node execution).
+A detailed explanation of the transaction lifecycle can be found [here](../../../../../aztec/concepts/transactions.md#simple-example-of-the-private-transaction-lifecycle).
+
+## Private state variables in Aztec
+
+State variables in an Aztec contract are defined inside a struct specifically named `Storage`, and must satisfy the [Note Interface (GitHub link)](https://github.com/AztecProtocol/aztec-packages/tree/v0.82.2/noir-projects/aztec-nr/aztec/src/note/note_interface.nr) and contain a [Note header (GitHub link)](https://github.com/AztecProtocol/aztec-packages/tree/v0.82.2/noir-projects/aztec-nr/aztec/src/note/note_header.nr).
+
+The Note header struct contains the contract address which the value is effectively siloed to, a nonce to ensure unique Note hashes, and a storage "slot" (or ID) to associate multiple notes.
+
+A couple of things to unpack here:
+
+#### Storage "slot"
+
+Storage slots are more literal for public storage, a place where a value is stored. For private storage, a storage slot is logical (more [here](../../../../../aztec/concepts/advanced/storage/storage_slots.md)).
+
+#### Silos
+
+The address of the contract is included in a Note's data to ensure that different contracts don't arrive at the same hash with an identical variable. This is handled in the protocol's execution.
+
+### Note types
+
+There is more than one Note type, such as the `PrivateSet` type is used for private variables. There are also `PrivateMutable` and `PrivateImmutable` types.
+
+Furthermore, notes can be completely custom types, storing any value or set of values that are desired by an application.
+
+### Initialization
+
+Private state variables are stored locally when the contract is created. Depending on the application, values may be privately shared by the creator with others via encrypted logs onchain.
+A hash of a note is stored in the append-only note hash tree on the network so as to prove existence of the current state of the note in a privacy preserving way.
+
+#### Note Hash Tree
+
+By virtue of being append only, notes are not edited. If two transactions amend a private value, multiple notes will be inserted into the tree to the note hash tree and the nullifier tree. The header will contain the same logical storage slot.
+
+### Reading Notes
+
+:::info
+
+Only those with appropriate keys/information will be able to successfully read private values that they have permission to. Notes can be read outside of a transaction or "off-chain" with no changes to data structures on-chain.
+
+:::
+
+When a note is read in a transaction, a subsequent read from another transaction of the same note would reveal a link between the two. So to preserve privacy, notes that are read in a transaction are said to be "consumed" (defined below), and new note(s) are then created with a unique hash.
+
+With type `PrviateSet`, a private variable's value is interpreted as the sum of values of notes with the same logical storage slot.
+
+Consuming, deleting, or otherwise "nullifying" a note is NOT done by deleting the Note hash; this would leak information. Rather a nullifier is created deterministically linked to the value. This nullifier is inserted into another the nullifier storage tree.
+
+When reading a value, the local private execution checks that its notes (of the corresponding storage slot/ID) have not been nullified.
+
+### Updating
+
+:::note
+Only those with appropriate keys/information will be able to successfully nullify a value that they have permission to.
+:::
+
+To update a value, its previous note hash(es) are nullified. The new note value is updated in the user's private execution environment (PXE), and the updated note hash inserted into the note hash tree.
+
+## Supplementary components
+
+Some optional background resources on notes can be found here:
+
+- [High level network architecture](../../../../../aztec/index.md), specifically the Private Execution Environment
+- [Transaction lifecycle (simple diagram)](../../../../../aztec/concepts/transactions.md#simple-example-of-the-private-transaction-lifecycle)
+- [Public and Private state](../../../../../aztec/concepts/storage/state_model.md)
+
+Notes touch several core components of the protocol, but we will focus on a the essentials first.
+
+### Some code context
+
+The way Aztec benefits from the Noir language is via three important components:
+
+- `Aztec.nr` - a Noir framework enabling contracts on Aztec, written in Noir. Includes useful Note implementations
+- `noir contracts` - example Aztec contracts
+- `noir-protocol-circuits` - a crate containing essential circuits for the protocol (public circuits and private wrappers)
+
+A lot of what we will look at will be in [aztec-nr/aztec/src/note (GitHub link)](https://github.com/AztecProtocol/aztec-packages/tree/v0.82.2/noir-projects/aztec-nr/aztec/src/note), specifically the lifecycle and note interface.
+
+Looking at the noir circuits in these components, you will see references to the distinction between public/private execution and state.
+
+### Lifecycle functions
+
+Inside the [lifecycle (GitHub link)](https://github.com/AztecProtocol/aztec-packages/tree/v0.82.2/noir-projects/aztec-nr/aztec/src/note/lifecycle.nr) circuits we see the functions to create and destroy a note, implemented as insertions of note hashes and nullifiers respectively. This is helpful for regular private variables.
+
+We also see a function to create a note hash from the public context, a way of creating a private variable from a public call (run in the sequencer). This could be used in application contracts to give private digital assets to users.
+
+### Note Interface functions
+
+To see a [note_interface (GitHub link)](https://github.com/AztecProtocol/aztec-packages/tree/v0.82.2/noir-projects/aztec-nr/aztec/src/note/note_interface.nr) implementation, we will look at a simple [ValueNote GitHub link](https://github.com/AztecProtocol/aztec-packages/tree/v0.82.2/noir-projects/aztec-nr/value-note/src/value_note.nr).
+
+The interface is required to work within an Aztec contract's storage, and a ValueNote is a specific type of note to hold a number (as a `Field`).
+
+#### Computing hashes and nullifiers
+
+A few key functions in the note interface are around computing the note hash and nullifier, with logic to get/use secret keys from the private context.
+
+In the ValueNote implementation you'll notice that it uses the `pedersen_hash` function. This is currently required by the protocol, but may be updated to another hashing function, like poseidon.
+
+As a convenience, the outer [note/utils.nr (GitHub link)](https://github.com/AztecProtocol/aztec-packages/tree/v0.82.2/noir-projects/aztec-nr/aztec/src/note/utils.nr) contains implementations of functions that may be needed in Aztec contracts, for example computing note hashes.
+
+#### Serialization and deserialization
+
+Serialization/deserialization of content is used to convert between the Note's variables and a generic array of Field elements. The Field type is understood and used by lower level crypographic libraries.
+This is analogous to the encoding/decoding between variables and bytes in solidity.
+
+For example in ValueNote, the `serialize_content` function simply returns: the value, nullifying public key hash (as a field) and the note randomness; as an array of Field elements.
+
+### Value as a sum of Notes
+
+We recall that multiple notes are associated with a "slot" (or ID), and so the value of a numerical note (like ValueNote) is the sum of each note's value.
+The helper function in [balance_utils (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/#include_/noir-projects/aztec-nr/value-note/src/balance_utils.nr) implements this logic taking a `PrivateSet` of `ValueNotes`.
+
+A couple of things worth clarifying:
+
+- A `PrivateSet` takes a Generic type, specified here as `ValueNote`, but can be any `Note` type (for all notes in the set)
+- A `PrivateSet` of notes also specifies _the_ slot of all Notes that it holds
+
+### Example - Notes in action
+
+The Aztec.nr framework includes examples of high-level states [easy_private_uint (GitHub link)](https://github.com/AztecProtocol/aztec-packages/tree/v0.82.2/noir-projects/aztec-nr/easy-private-state/src/easy_private_uint.nr) for use in contracts.
+
+The struct (`EasyPrivateUint`) contains a Context, Set of ValueNotes, and storage_slot (used when setting the Set).
+
+Notice how the `add` function shows the simplicity of appending a new note to all existing ones. On the other hand, `sub` (subtraction), needs to first add up all existing values (consuming them in the process), and then insert a single new value of the difference between the sum and parameter.
+
+---
+
+### Apply
+
+Try the [NFT tutorial](../../../../tutorials/codealong/contract_tutorials/nft_contract.md) to see what notes can achieve. In this section you will also find other tutorials using notes in different ways.
+
+### Further reading
+
+- [Proof of prior notes](../how_to_prove_history.md) - public/private reading of public/private proof of state (public or private)
+
+If you're curious about any of the following related topics, search the documentation for...
+
+- Private and public contexts
+- Encryption keys and events
+- Oracle's role in using notes
+- Value Serialization/Deserialization
+
+### References
+
+- ["Stable" state variable (GitHub link)](https://github.com/AztecProtocol/aztec-packages/issues/4130)
+- [Code: Aztec-Patterns (GitHub link)](https://github.com/defi-wonderland/aztec-patterns)
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/guides/smart_contracts/writing_contracts/storage/storage_slots.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/guides/smart_contracts/writing_contracts/storage/storage_slots.md
new file mode 100644
index 000000000000..194a5ef24a92
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/guides/smart_contracts/writing_contracts/storage/storage_slots.md
@@ -0,0 +1,69 @@
+---
+title: Storage slots
+tags: [contracts, storage]
+---
+
+From the description of storage slots [in the Concepts](../../../../../aztec/concepts/advanced/storage/storage_slots.md) you will get an idea around the logic of storage slots. In this section we will go into more detail and walk through an entire example of how storage slots are computed for private state to improve our storage slot intuition. Recall, that storage slots in the private domain is just a logical construct, and are not "actually" used for lookups, but rather just as a value to constrain against.
+
+For the case of the example, we will look at what is inserted into the note hashes tree when adding a note in the Token contract. Specifically, we are looking at the last part of the `transfer` function:
+
+```rust title="increase_private_balance" showLineNumbers
+storage.balances.at(from).sub(from, amount).emit(encode_and_encrypt_note(
+ &mut context,
+ from,
+ from,
+));
+```
+> Source code: noir-projects/noir-contracts/contracts/token_contract/src/main.nr#L371-L379
+
+
+This function is creating a new note and inserting it into the balance set of the recipient `to`. Recall that to ensure privacy, only the note hash is really inserted into the note hashes tree. To share the contents of the note with `to` the contract can emit an encrypted log (which this one does), or it can require an out-of-band data transfer sharing the information. Below, we will walk through the steps of how the note hash is computed and inserted into the tree. For this, we don't care about the encrypted log, so we are going to ignore that part of the function call for now.
+
+Outlining it in more detail below as a sequence diagram, we can see how the calls make their way down the stack.
+In the end a siloed note hash is computed in the kernel.
+
+:::info
+Some of the syntax below is a little butchered to make it easier to follow variables without the full code.
+:::
+
+```mermaid
+sequenceDiagram
+ alt Call
+ Token->>BalanceMap: Map::new(map_slot);
+ Token->>Token: to_bal = storage.balances.at(to)
+ Token->>BalanceMap: BalanceMap.at(to)
+ BalanceMap->>BalanceMap: derived_slot = H(map_slot, to)
+ BalanceMap->>BalanceSet: BalanceSet::new(to, derived_slot)
+ Token->>BalanceSet: to_bal.add(amount)
+ BalanceSet->>BalanceSet: note = UintNote::new(amount, to)
+ BalanceSet->>Set: insert(note)
+ Set->>LifeCycle: create_note(derived_slot, note)
+ LifeCycle->>LifeCycle: note.header = NoteHeader { contract_address,
storage_slot: derived_slot, nonce: 0, note_hash_counter }
+ Utils->>UintNote: note_hiding_point = note.compute_note_hiding_point()
+ UintNote->>Utils: note_hash = note_hiding_point.x
+ LifeCycle->>Context: push_note_hash(note_hash)
+ end
+ Context->>Kernel: unique_note_hash = H(nonce, note_hash)
+ Context->>Kernel: siloed_note_hash = H(contract_address, unique_note_hash)
+```
+
+Notice the `siloed_note_hash` at the very end. It's a hash that will be inserted into the note hashes tree. To clarify what this really is, we "unroll" the values to their simplest components. This gives us a better idea around what is actually inserted into the tree.
+
+```rust
+siloed_note_hash = H(contract_address, unique_note_hash)
+siloed_note_hash = H(contract_address, H(nonce, note_hash))
+siloed_note_hash = H(contract_address, H(H(tx_hash, note_index_in_tx), note_hash))
+siloed_note_hash = H(contract_address, H(H(tx_hash, note_index_in_tx), MSM([G_amt, G_to, G_rand, G_slot], [amount, to, randomness, derived_slot]).x))
+```
+
+MSM is a multi scalar multiplication on a grumpkin curve and G_* values are generators.
+
+And `to` is the actor who receives the note, `amount` of the note and `randomness` is the randomness used to make the note hiding. Without the `randomness` the note could just as well be plaintext (computational cost of a preimage attack would be trivial in such a case).
+
+:::info
+Beware that this hash computation is what the aztec.nr library is doing, and not strictly required by the network (only the kernel computation is).
+:::
+
+With this note structure, the contract can require that only notes sitting at specific storage slots can be used by specific operations, e.g., if transferring funds from `from` to `to`, the notes to destroy should be linked to `H(map_slot, from)` and the new notes (except the change-note) should be linked to `H(map_slot, to)`.
+
+That way, we can have logical storage slots, without them really existing. This means that knowing the storage slot for a note is not enough to actually figure out what is in there (whereas it would be for looking up public state).
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/index.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/index.md
new file mode 100644
index 000000000000..aa692db11222
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/index.md
@@ -0,0 +1,79 @@
+---
+id: index
+sidebar_position: 0
+title: Build
+---
+
+# Build
+
+## Get Started
+
+
+
+
+ Getting Started
+
+
+ Get started on Aztec by installing the sandbox and playing with it
+
+
+
+
+## Build applications
+
+
+
+
+ Contract Tutorials
+
+
+ Go from zero to hero by following these tutorials in order, starting with a counter contract
+
+
+
+
+
+ Full stack app on Aztec
+
+
+ Learn how everything works together by building an app in JavaScript that connects to a contract
+
+
+
+
+## Clone a repo
+
+
+
+ 
+
+
+ Full stack app on Aztec
+
+
+ Learn how everything works together by building an app in JavaScript that connects to a contract
+
+
+
+## Get inspired
+
+
+
+
+ What to build on Aztec
+
+
+ Find requests for applications, potential designs, and existing ecosystem projects
+
+
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/inspiration.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/inspiration.md
new file mode 100644
index 000000000000..6f89bd191338
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/inspiration.md
@@ -0,0 +1,98 @@
+---
+id: inspiration
+title: Inspiration and Ideas
+---
+
+This page covers requests for apps on Aztec, designs that some teams are exploring, existing contract examples, and open source ecosystem projects.
+
+## App ideas
+
+### Finance
+
+- Undercollateralized Lending
+- Private order matching
+- Hidden liquidity aggregation
+- Batch Clearing
+- Escrow Systems
+- Private Bill Splitting
+- Fee Payment Contracts (FPCs)
+- Private Auction Systems
+- Private Betting with Commit-Reveal Schemes
+- Stablecoins
+- Stablecoin Swap Portal
+- L1-L2 Lending Portal (supply L1, borrow L2)
+- Mint DAI on L2 via L1 ETH
+- Recurring Payments with Account Abstraction
+- Token Streaming
+
+### Identity & Access Management
+
+- Private Glassdoor
+- Private Yelp
+- Onchain Loyalty System
+- History-based Gating
+- NFT Verification
+- Multisig Implementation
+- Verifiable Random Functions (VRFs)
+- Bridge to connect Aztec with Other L2s
+- L1-L2 Activity Verification, eg prove L1 degeneracy score on L2
+- Storage proof libraries and tooling
+- Private Creator Payment Systems
+
+### Gaming & Governance
+
+- DAO Infrastructure
+- DAO Voting via Portals (threshold-triggered)
+- Private Voting Systems
+- Private Airdrop Systems
+
+### Infrastructure & Tooling
+
+- Privacy-Preserving Oracle Systems
+- Privacy-Preserving RPC Proxies
+
+There are countless other ideas. Join the [developer Discord](https://discord.com/invite/aztec) if you're interested in building any of these or more.
+
+## Design explorations
+
+Many of these are not official resources, may be outdated, or are works in progress.
+
+- [Blog: Can blockchains and zero-knowledge help humanity survive? 47 real-world use cases](https://aztec.network/blog/can-blockchains-and-zero-knowledge-help-humanity-survive-47-real-world-use-cases)
+- [Alpha Build: DEXes](https://docs.google.com/document/d/1J0i2ciIHFN2bJJxLRgEdJnI6hd7FxkedSd78qMC7ziM/edit?usp=sharing) - A Google doc with a deep dive of how various DEXes could work on Aztec
+
+## Contract examples
+
+Explore the [tutorials section](../developers/tutorials/codealong/contract_tutorials/counter_contract.md) for some contract and full-stack project examples.
+
+There is also a list of up-to-date contract examples in the [aztec-packages Github repo](https://github.com/AztecProtocol/aztec-packages/tree/master/noir-projects/noir-contracts/contracts).
+
+## Ecosystem projects
+
+- [ShieldSwap](https://app.shieldswap.org/?type=market)
+- [AztecScan](https://aztecscan.xyz/)
+- [Azguard](https://azguardwallet.io/terms)
+
+Explore the [Aztec Network ecosystem page](https://aztec.network/ecosystem) to discover more.
+
+### Proof of concepts
+
+Many of these are outdated.
+
+- [Ikegai](https://github.com/resurgencelabs/ikigai_backend)
+- [Aztec private oracle](https://github.com/defi-wonderland/aztec-private-oracle)
+- [Zybil](https://github.com/mach-34/zybil)
+- [Aztec poker](https://github.com/zobront/aztec-poker/)
+- [Alpha Build winners](https://aztec.network/blog/shaping-the-future-of-payments-meet-the-winners-of-alpha-build-one)
+
+### Noir
+
+This is a list of open source Noir projects, libraries, or primitives that can be integrated into Aztec projects.
+
+- [ZKEmail](https://github.com/zkemail/zkemail.nr/tree/main)
+- [ZKPassport](https://github.com/zkpassport)
+- [StealthNote](https://github.com/saleel/stealthnote)
+- [Anoncast](https://github.com/anondotworld/anonworld)
+
+## Independent projects with open issues
+
+Explore independent projects on [OnlyDust](https://app.onlydust.com/ecosystems/aztec).
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/_category_.yml b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/_category_.yml
new file mode 100644
index 000000000000..57dc01ecdd54
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/_category_.yml
@@ -0,0 +1 @@
+label: "AztecJS"
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/_category_.yml b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/_category_.yml
new file mode 100644
index 000000000000..08af16b98be8
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/_category_.yml
@@ -0,0 +1 @@
+label: "Accounts"
\ No newline at end of file
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/_category_.yml b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/_category_.yml
new file mode 100644
index 000000000000..55c7980a4644
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/_category_.yml
@@ -0,0 +1,2 @@
+label: "Classes"
+position: 3
\ No newline at end of file
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/defaults.DefaultAccountContract.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/defaults.DefaultAccountContract.md
new file mode 100644
index 000000000000..11d775807e59
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/defaults.DefaultAccountContract.md
@@ -0,0 +1,94 @@
+---
+id: "defaults.DefaultAccountContract"
+title: "Class: DefaultAccountContract"
+sidebar_label: "DefaultAccountContract"
+custom_edit_url: null
+---
+
+[defaults](../modules/defaults.md).DefaultAccountContract
+
+Base class for implementing an account contract. Requires that the account uses the
+default entrypoint method signature.
+
+## Implements
+
+- `AccountContract`
+
+## Constructors
+
+### constructor
+
+• **new DefaultAccountContract**(): [`DefaultAccountContract`](defaults.DefaultAccountContract.md)
+
+#### Returns
+
+[`DefaultAccountContract`](defaults.DefaultAccountContract.md)
+
+## Methods
+
+### getAuthWitnessProvider
+
+▸ **getAuthWitnessProvider**(`address`): `AuthWitnessProvider`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `address` | `CompleteAddress` |
+
+#### Returns
+
+`AuthWitnessProvider`
+
+#### Implementation of
+
+AccountContract.getAuthWitnessProvider
+
+___
+
+### getContractArtifact
+
+▸ **getContractArtifact**(): `Promise`\<`ContractArtifact`\>
+
+#### Returns
+
+`Promise`\<`ContractArtifact`\>
+
+#### Implementation of
+
+AccountContract.getContractArtifact
+
+___
+
+### getDeploymentFunctionAndArgs
+
+▸ **getDeploymentFunctionAndArgs**(): `Promise`\<`undefined` \| \{ `constructorArgs`: `any`[] ; `constructorName`: `string` }\>
+
+#### Returns
+
+`Promise`\<`undefined` \| \{ `constructorArgs`: `any`[] ; `constructorName`: `string` }\>
+
+#### Implementation of
+
+AccountContract.getDeploymentFunctionAndArgs
+
+___
+
+### getInterface
+
+▸ **getInterface**(`address`, `nodeInfo`): `AccountInterface`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `address` | `CompleteAddress` |
+| `nodeInfo` | `NodeInfo` |
+
+#### Returns
+
+`AccountInterface`
+
+#### Implementation of
+
+AccountContract.getInterface
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/defaults.DefaultAccountInterface.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/defaults.DefaultAccountInterface.md
new file mode 100644
index 000000000000..c24b4aff13f5
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/defaults.DefaultAccountInterface.md
@@ -0,0 +1,161 @@
+---
+id: "defaults.DefaultAccountInterface"
+title: "Class: DefaultAccountInterface"
+sidebar_label: "DefaultAccountInterface"
+custom_edit_url: null
+---
+
+[defaults](../modules/defaults.md).DefaultAccountInterface
+
+Default implementation for an account interface. Requires that the account uses the default
+entrypoint signature, which accept an AppPayload and a FeePayload as defined in noir-libs/aztec-noir/src/entrypoint module
+
+## Implements
+
+- `AccountInterface`
+
+## Constructors
+
+### constructor
+
+• **new DefaultAccountInterface**(`authWitnessProvider`, `address`, `nodeInfo`): [`DefaultAccountInterface`](defaults.DefaultAccountInterface.md)
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `authWitnessProvider` | `AuthWitnessProvider` |
+| `address` | `CompleteAddress` |
+| `nodeInfo` | `Pick`\<`NodeInfo`, ``"l1ChainId"`` \| ``"protocolVersion"``\> |
+
+#### Returns
+
+[`DefaultAccountInterface`](defaults.DefaultAccountInterface.md)
+
+## Properties
+
+### address
+
+• `Private` **address**: `CompleteAddress`
+
+___
+
+### authWitnessProvider
+
+• `Private` **authWitnessProvider**: `AuthWitnessProvider`
+
+___
+
+### chainId
+
+• `Private` **chainId**: `Fr`
+
+___
+
+### entrypoint
+
+• `Protected` **entrypoint**: `EntrypointInterface`
+
+___
+
+### version
+
+• `Private` **version**: `Fr`
+
+## Methods
+
+### createAuthWit
+
+▸ **createAuthWit**(`messageHash`): `Promise`\<`AuthWitness`\>
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `messageHash` | `Fr` |
+
+#### Returns
+
+`Promise`\<`AuthWitness`\>
+
+#### Implementation of
+
+AccountInterface.createAuthWit
+
+___
+
+### createTxExecutionRequest
+
+▸ **createTxExecutionRequest**(`exec`, `fee`, `options`): `Promise`\<`TxExecutionRequest`\>
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `exec` | `ExecutionPayload` |
+| `fee` | `FeeOptions` |
+| `options` | `TxExecutionOptions` |
+
+#### Returns
+
+`Promise`\<`TxExecutionRequest`\>
+
+#### Implementation of
+
+AccountInterface.createTxExecutionRequest
+
+___
+
+### getAddress
+
+▸ **getAddress**(): `AztecAddress`
+
+#### Returns
+
+`AztecAddress`
+
+#### Implementation of
+
+AccountInterface.getAddress
+
+___
+
+### getChainId
+
+▸ **getChainId**(): `Fr`
+
+#### Returns
+
+`Fr`
+
+#### Implementation of
+
+AccountInterface.getChainId
+
+___
+
+### getCompleteAddress
+
+▸ **getCompleteAddress**(): `CompleteAddress`
+
+#### Returns
+
+`CompleteAddress`
+
+#### Implementation of
+
+AccountInterface.getCompleteAddress
+
+___
+
+### getVersion
+
+▸ **getVersion**(): `Fr`
+
+#### Returns
+
+`Fr`
+
+#### Implementation of
+
+AccountInterface.getVersion
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/ecdsa.EcdsaKAccountContract.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/ecdsa.EcdsaKAccountContract.md
new file mode 100644
index 000000000000..3068a0c66294
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/ecdsa.EcdsaKAccountContract.md
@@ -0,0 +1,107 @@
+---
+id: "ecdsa.EcdsaKAccountContract"
+title: "Class: EcdsaKAccountContract"
+sidebar_label: "EcdsaKAccountContract"
+custom_edit_url: null
+---
+
+[ecdsa](../modules/ecdsa.md).EcdsaKAccountContract
+
+Account contract that authenticates transactions using ECDSA signatures
+verified against a secp256k1 public key stored in an immutable encrypted note.
+Eagerly loads the contract artifact
+
+## Hierarchy
+
+- `EcdsaKBaseAccountContract`
+
+ ↳ **`EcdsaKAccountContract`**
+
+## Constructors
+
+### constructor
+
+• **new EcdsaKAccountContract**(`signingPrivateKey`): [`EcdsaKAccountContract`](ecdsa.EcdsaKAccountContract.md)
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `signingPrivateKey` | `Buffer` |
+
+#### Returns
+
+[`EcdsaKAccountContract`](ecdsa.EcdsaKAccountContract.md)
+
+#### Overrides
+
+EcdsaKBaseAccountContract.constructor
+
+## Methods
+
+### getAuthWitnessProvider
+
+▸ **getAuthWitnessProvider**(`_address`): `AuthWitnessProvider`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `_address` | `CompleteAddress` |
+
+#### Returns
+
+`AuthWitnessProvider`
+
+#### Inherited from
+
+EcdsaKBaseAccountContract.getAuthWitnessProvider
+
+___
+
+### getContractArtifact
+
+▸ **getContractArtifact**(): `Promise`\<`ContractArtifact`\>
+
+#### Returns
+
+`Promise`\<`ContractArtifact`\>
+
+#### Overrides
+
+EcdsaKBaseAccountContract.getContractArtifact
+
+___
+
+### getDeploymentFunctionAndArgs
+
+▸ **getDeploymentFunctionAndArgs**(): `Promise`\<\{ `constructorArgs`: `Buffer`[] ; `constructorName`: `string` = 'constructor' }\>
+
+#### Returns
+
+`Promise`\<\{ `constructorArgs`: `Buffer`[] ; `constructorName`: `string` = 'constructor' }\>
+
+#### Inherited from
+
+EcdsaKBaseAccountContract.getDeploymentFunctionAndArgs
+
+___
+
+### getInterface
+
+▸ **getInterface**(`address`, `nodeInfo`): `AccountInterface`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `address` | `CompleteAddress` |
+| `nodeInfo` | `NodeInfo` |
+
+#### Returns
+
+`AccountInterface`
+
+#### Inherited from
+
+EcdsaKBaseAccountContract.getInterface
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/ecdsa.EcdsaRSSHAccountContract.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/ecdsa.EcdsaRSSHAccountContract.md
new file mode 100644
index 000000000000..7c25ebb65998
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/ecdsa.EcdsaRSSHAccountContract.md
@@ -0,0 +1,110 @@
+---
+id: "ecdsa.EcdsaRSSHAccountContract"
+title: "Class: EcdsaRSSHAccountContract"
+sidebar_label: "EcdsaRSSHAccountContract"
+custom_edit_url: null
+---
+
+[ecdsa](../modules/ecdsa.md).EcdsaRSSHAccountContract
+
+Account contract that authenticates transactions using ECDSA signatures
+verified against a secp256r1 public key stored in an immutable encrypted note.
+Since this implementation relays signatures to an SSH agent, we provide the
+public key here not for signature verification, but to identify actual identity
+that will be used to sign authwitnesses.
+Eagerly loads the contract artifact
+
+## Hierarchy
+
+- `EcdsaRSSHBaseAccountContract`
+
+ ↳ **`EcdsaRSSHAccountContract`**
+
+## Constructors
+
+### constructor
+
+• **new EcdsaRSSHAccountContract**(`signingPrivateKey`): [`EcdsaRSSHAccountContract`](ecdsa.EcdsaRSSHAccountContract.md)
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `signingPrivateKey` | `Buffer` |
+
+#### Returns
+
+[`EcdsaRSSHAccountContract`](ecdsa.EcdsaRSSHAccountContract.md)
+
+#### Overrides
+
+EcdsaRSSHBaseAccountContract.constructor
+
+## Methods
+
+### getAuthWitnessProvider
+
+▸ **getAuthWitnessProvider**(`_address`): `AuthWitnessProvider`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `_address` | `CompleteAddress` |
+
+#### Returns
+
+`AuthWitnessProvider`
+
+#### Inherited from
+
+EcdsaRSSHBaseAccountContract.getAuthWitnessProvider
+
+___
+
+### getContractArtifact
+
+▸ **getContractArtifact**(): `Promise`\<`ContractArtifact`\>
+
+#### Returns
+
+`Promise`\<`ContractArtifact`\>
+
+#### Overrides
+
+EcdsaRSSHBaseAccountContract.getContractArtifact
+
+___
+
+### getDeploymentFunctionAndArgs
+
+▸ **getDeploymentFunctionAndArgs**(): `Promise`\<\{ `constructorArgs`: `Buffer`[] ; `constructorName`: `string` = 'constructor' }\>
+
+#### Returns
+
+`Promise`\<\{ `constructorArgs`: `Buffer`[] ; `constructorName`: `string` = 'constructor' }\>
+
+#### Inherited from
+
+EcdsaRSSHBaseAccountContract.getDeploymentFunctionAndArgs
+
+___
+
+### getInterface
+
+▸ **getInterface**(`address`, `nodeInfo`): `AccountInterface`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `address` | `CompleteAddress` |
+| `nodeInfo` | `NodeInfo` |
+
+#### Returns
+
+`AccountInterface`
+
+#### Inherited from
+
+EcdsaRSSHBaseAccountContract.getInterface
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/schnorr.SchnorrAccountContract.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/schnorr.SchnorrAccountContract.md
new file mode 100644
index 000000000000..ba045b038046
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/schnorr.SchnorrAccountContract.md
@@ -0,0 +1,107 @@
+---
+id: "schnorr.SchnorrAccountContract"
+title: "Class: SchnorrAccountContract"
+sidebar_label: "SchnorrAccountContract"
+custom_edit_url: null
+---
+
+[schnorr](../modules/schnorr.md).SchnorrAccountContract
+
+Account contract that authenticates transactions using Schnorr signatures
+verified against a Grumpkin public key stored in an immutable encrypted note.
+Eagerly loads the contract artifact
+
+## Hierarchy
+
+- `SchnorrBaseAccountContract`
+
+ ↳ **`SchnorrAccountContract`**
+
+## Constructors
+
+### constructor
+
+• **new SchnorrAccountContract**(`signingPrivateKey`): [`SchnorrAccountContract`](schnorr.SchnorrAccountContract.md)
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `signingPrivateKey` | `Fq` |
+
+#### Returns
+
+[`SchnorrAccountContract`](schnorr.SchnorrAccountContract.md)
+
+#### Overrides
+
+SchnorrBaseAccountContract.constructor
+
+## Methods
+
+### getAuthWitnessProvider
+
+▸ **getAuthWitnessProvider**(`_address`): `AuthWitnessProvider`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `_address` | `CompleteAddress` |
+
+#### Returns
+
+`AuthWitnessProvider`
+
+#### Inherited from
+
+SchnorrBaseAccountContract.getAuthWitnessProvider
+
+___
+
+### getContractArtifact
+
+▸ **getContractArtifact**(): `Promise`\<`ContractArtifact`\>
+
+#### Returns
+
+`Promise`\<`ContractArtifact`\>
+
+#### Overrides
+
+SchnorrBaseAccountContract.getContractArtifact
+
+___
+
+### getDeploymentFunctionAndArgs
+
+▸ **getDeploymentFunctionAndArgs**(): `Promise`\<\{ `constructorArgs`: `Fr`[] ; `constructorName`: `string` = 'constructor' }\>
+
+#### Returns
+
+`Promise`\<\{ `constructorArgs`: `Fr`[] ; `constructorName`: `string` = 'constructor' }\>
+
+#### Inherited from
+
+SchnorrBaseAccountContract.getDeploymentFunctionAndArgs
+
+___
+
+### getInterface
+
+▸ **getInterface**(`address`, `nodeInfo`): `AccountInterface`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `address` | `CompleteAddress` |
+| `nodeInfo` | `NodeInfo` |
+
+#### Returns
+
+`AccountInterface`
+
+#### Inherited from
+
+SchnorrBaseAccountContract.getInterface
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/single_key.SingleKeyAccountContract.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/single_key.SingleKeyAccountContract.md
new file mode 100644
index 000000000000..d9b230516512
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/classes/single_key.SingleKeyAccountContract.md
@@ -0,0 +1,107 @@
+---
+id: "single_key.SingleKeyAccountContract"
+title: "Class: SingleKeyAccountContract"
+sidebar_label: "SingleKeyAccountContract"
+custom_edit_url: null
+---
+
+[single\_key](../modules/single_key.md).SingleKeyAccountContract
+
+Account contract that authenticates transactions using Schnorr signatures verified against
+the note encryption key, relying on a single private key for both encryption and authentication.
+Eagerly loads the contract artifact
+
+## Hierarchy
+
+- `SingleKeyBaseAccountContract`
+
+ ↳ **`SingleKeyAccountContract`**
+
+## Constructors
+
+### constructor
+
+• **new SingleKeyAccountContract**(`signingPrivateKey`): [`SingleKeyAccountContract`](single_key.SingleKeyAccountContract.md)
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `signingPrivateKey` | `Fq` |
+
+#### Returns
+
+[`SingleKeyAccountContract`](single_key.SingleKeyAccountContract.md)
+
+#### Overrides
+
+SingleKeyBaseAccountContract.constructor
+
+## Methods
+
+### getAuthWitnessProvider
+
+▸ **getAuthWitnessProvider**(`account`): `AuthWitnessProvider`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `account` | `CompleteAddress` |
+
+#### Returns
+
+`AuthWitnessProvider`
+
+#### Inherited from
+
+SingleKeyBaseAccountContract.getAuthWitnessProvider
+
+___
+
+### getContractArtifact
+
+▸ **getContractArtifact**(): `Promise`\<`ContractArtifact`\>
+
+#### Returns
+
+`Promise`\<`ContractArtifact`\>
+
+#### Overrides
+
+SingleKeyBaseAccountContract.getContractArtifact
+
+___
+
+### getDeploymentFunctionAndArgs
+
+▸ **getDeploymentFunctionAndArgs**(): `Promise`\<`undefined`\>
+
+#### Returns
+
+`Promise`\<`undefined`\>
+
+#### Inherited from
+
+SingleKeyBaseAccountContract.getDeploymentFunctionAndArgs
+
+___
+
+### getInterface
+
+▸ **getInterface**(`address`, `nodeInfo`): `AccountInterface`
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `address` | `CompleteAddress` |
+| `nodeInfo` | `NodeInfo` |
+
+#### Returns
+
+`AccountInterface`
+
+#### Inherited from
+
+SingleKeyBaseAccountContract.getInterface
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/index.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/index.md
new file mode 100644
index 000000000000..0c19cb267f7e
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/index.md
@@ -0,0 +1,16 @@
+---
+id: "index"
+title: "@aztec/accounts"
+sidebar_label: "Table of Contents"
+sidebar_position: 0.5
+hide_table_of_contents: true
+custom_edit_url: null
+---
+
+## Modules
+
+- [defaults](modules/defaults.md)
+- [ecdsa](modules/ecdsa.md)
+- [schnorr](modules/schnorr.md)
+- [single\_key](modules/single_key.md)
+- [testing](modules/testing.md)
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/interfaces/_category_.yml b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/interfaces/_category_.yml
new file mode 100644
index 000000000000..43bec88cfa0a
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/interfaces/_category_.yml
@@ -0,0 +1,2 @@
+label: "Interfaces"
+position: 4
\ No newline at end of file
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/interfaces/testing.InitialAccountData.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/interfaces/testing.InitialAccountData.md
new file mode 100644
index 000000000000..7b2757593317
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/interfaces/testing.InitialAccountData.md
@@ -0,0 +1,42 @@
+---
+id: "testing.InitialAccountData"
+title: "Interface: InitialAccountData"
+sidebar_label: "InitialAccountData"
+custom_edit_url: null
+---
+
+[testing](../modules/testing.md).InitialAccountData
+
+Data for generating an initial account.
+
+## Properties
+
+### address
+
+• **address**: `AztecAddress`
+
+Address of the schnorr account contract.
+
+___
+
+### salt
+
+• **salt**: `Fr`
+
+Contract address salt.
+
+___
+
+### secret
+
+• **secret**: `Fr`
+
+Secret to derive the keys for the account.
+
+___
+
+### signingKey
+
+• **signingKey**: `Fq`
+
+Signing key od the account.
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/_category_.yml b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/_category_.yml
new file mode 100644
index 000000000000..63f9c4e40160
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/_category_.yml
@@ -0,0 +1,2 @@
+label: "Modules"
+position: 1
\ No newline at end of file
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/defaults.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/defaults.md
new file mode 100644
index 000000000000..9252b70f72ae
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/defaults.md
@@ -0,0 +1,16 @@
+---
+id: "defaults"
+title: "Module: defaults"
+sidebar_label: "defaults"
+sidebar_position: 0
+custom_edit_url: null
+---
+
+The `@aztec/accounts/defaults` export provides the base class [DefaultAccountContract](../classes/defaults.DefaultAccountContract.md) for implementing account contracts that use the default entrypoint payload module.
+
+Read more in [Writing an account contract](https://docs.aztec.network/developers/tutorials/codealong/contract_tutorials/write_accounts_contract).
+
+## Classes
+
+- [DefaultAccountContract](../classes/defaults.DefaultAccountContract.md)
+- [DefaultAccountInterface](../classes/defaults.DefaultAccountInterface.md)
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/ecdsa.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/ecdsa.md
new file mode 100644
index 000000000000..e6bd39fdf1ca
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/ecdsa.md
@@ -0,0 +1,114 @@
+---
+id: "ecdsa"
+title: "Module: ecdsa"
+sidebar_label: "ecdsa"
+sidebar_position: 0
+custom_edit_url: null
+---
+
+## Classes
+
+- [EcdsaKAccountContract](../classes/ecdsa.EcdsaKAccountContract.md)
+- [EcdsaRSSHAccountContract](../classes/ecdsa.EcdsaRSSHAccountContract.md)
+
+## Variables
+
+### EcdsaKAccountContractArtifact
+
+• `Const` **EcdsaKAccountContractArtifact**: `ContractArtifact`
+
+___
+
+### EcdsaRAccountContractArtifact
+
+• `Const` **EcdsaRAccountContractArtifact**: `ContractArtifact`
+
+## Functions
+
+### getEcdsaKAccount
+
+▸ **getEcdsaKAccount**(`pxe`, `secretKey`, `signingPrivateKey`, `salt?`): `Promise`\<`AccountManager`\>
+
+Creates an Account that relies on an ECDSA signing key for authentication.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `pxe` | `PXE` | An PXE server instance. |
+| `secretKey` | `Fr` | Secret key used to derive all the keystore keys. |
+| `signingPrivateKey` | `Buffer` | Secp256k1 key used for signing transactions. |
+| `salt?` | `Salt` | Deployment salt. |
+
+#### Returns
+
+`Promise`\<`AccountManager`\>
+
+An account manager initialized with the account contract and its deployment params
+
+___
+
+### getEcdsaKWallet
+
+▸ **getEcdsaKWallet**(`pxe`, `address`, `signingPrivateKey`): `Promise`\<`AccountWallet`\>
+
+Gets a wallet for an already registered account using ECDSA signatures.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `pxe` | `PXE` | An PXE server instance. |
+| `address` | `AztecAddress` | Address for the account. |
+| `signingPrivateKey` | `Buffer` | ECDSA key used for signing transactions. |
+
+#### Returns
+
+`Promise`\<`AccountWallet`\>
+
+A wallet for this account that can be used to interact with a contract instance.
+
+___
+
+### getEcdsaRSSHAccount
+
+▸ **getEcdsaRSSHAccount**(`pxe`, `secretKey`, `signingPublicKey`, `salt?`): `Promise`\<`AccountManager`\>
+
+Creates an Account that relies on an ECDSA signing key for authentication.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `pxe` | `PXE` | An PXE server instance. |
+| `secretKey` | `Fr` | Secret key used to derive all the keystore keys. |
+| `signingPublicKey` | `Buffer` | Secp2561 key used to identify its corresponding private key in the SSH Agent. |
+| `salt?` | `Salt` | Deployment salt. |
+
+#### Returns
+
+`Promise`\<`AccountManager`\>
+
+An account manager initialized with the account contract and its deployment params
+
+___
+
+### getEcdsaRSSHWallet
+
+▸ **getEcdsaRSSHWallet**(`pxe`, `address`, `signingPublicKey`): `Promise`\<`AccountWallet`\>
+
+Gets a wallet for an already registered account using ECDSA signatures.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `pxe` | `PXE` | An PXE server instance. |
+| `address` | `AztecAddress` | Address for the account. |
+| `signingPublicKey` | `Buffer` | - |
+
+#### Returns
+
+`Promise`\<`AccountWallet`\>
+
+A wallet for this account that can be used to interact with a contract instance.
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/schnorr.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/schnorr.md
new file mode 100644
index 000000000000..cbd6dcd7734e
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/schnorr.md
@@ -0,0 +1,108 @@
+---
+id: "schnorr"
+title: "Module: schnorr"
+sidebar_label: "schnorr"
+sidebar_position: 0
+custom_edit_url: null
+---
+
+The `@aztec/accounts/schnorr` export provides an account contract implementation that uses Schnorr signatures with a Grumpkin key for authentication, and a separate Grumpkin key for encryption.
+This is the suggested account contract type for most use cases within Aztec.
+
+## Classes
+
+- [SchnorrAccountContract](../classes/schnorr.SchnorrAccountContract.md)
+
+## Variables
+
+### SchnorrAccountContractArtifact
+
+• `Const` **SchnorrAccountContractArtifact**: `ContractArtifact`
+
+## Functions
+
+### getSchnorrAccount
+
+▸ **getSchnorrAccount**(`pxe`, `secretKey`, `signingPrivateKey`, `salt?`): `Promise`\<`AccountManager`\>
+
+Creates an Account Manager that relies on a Grumpkin signing key for authentication.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `pxe` | `PXE` | An PXE server instance. |
+| `secretKey` | `Fr` | Secret key used to derive all the keystore keys. |
+| `signingPrivateKey` | `Fq` | Grumpkin key used for signing transactions. |
+| `salt?` | `Salt` | Deployment salt. |
+
+#### Returns
+
+`Promise`\<`AccountManager`\>
+
+An account manager initialized with the account contract and its deployment params
+
+___
+
+### getSchnorrAccountContractAddress
+
+▸ **getSchnorrAccountContractAddress**(`secret`, `salt`, `signingPrivateKey?`): `Promise`\<`AztecAddress`\>
+
+Compute the address of a schnorr account contract.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `secret` | `Fr` | A seed for deriving the signing key and public keys. |
+| `salt` | `Fr` | The contract address salt. |
+| `signingPrivateKey?` | `Fq` | A specific signing private key that's not derived from the secret. |
+
+#### Returns
+
+`Promise`\<`AztecAddress`\>
+
+___
+
+### getSchnorrWallet
+
+▸ **getSchnorrWallet**(`pxe`, `address`, `signingPrivateKey`): `Promise`\<`AccountWallet`\>
+
+Gets a wallet for an already registered account using Schnorr signatures.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `pxe` | `PXE` | An PXE server instance. |
+| `address` | `AztecAddress` | Address for the account. |
+| `signingPrivateKey` | `Fq` | Grumpkin key used for signing transactions. |
+
+#### Returns
+
+`Promise`\<`AccountWallet`\>
+
+A wallet for this account that can be used to interact with a contract instance.
+
+___
+
+### getSchnorrWalletWithSecretKey
+
+▸ **getSchnorrWalletWithSecretKey**(`pxe`, `secretKey`, `signingPrivateKey`, `salt`): `Promise`\<`AccountWalletWithSecretKey`\>
+
+Gets a wallet for an already registered account using Schnorr signatures.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `pxe` | `PXE` | An PXE server instance. |
+| `secretKey` | `Fr` | Secret key used to derive all the keystore keys. |
+| `signingPrivateKey` | `Fq` | Grumpkin key used for signing transactions. |
+| `salt` | `Salt` | Deployment salt. |
+
+#### Returns
+
+`Promise`\<`AccountWalletWithSecretKey`\>
+
+A wallet for this account that can be used to interact with a contract instance.
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/single_key.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/single_key.md
new file mode 100644
index 000000000000..e376e50fbb03
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/single_key.md
@@ -0,0 +1,64 @@
+---
+id: "single_key"
+title: "Module: single_key"
+sidebar_label: "single_key"
+sidebar_position: 0
+custom_edit_url: null
+---
+
+The `@aztec/accounts/single_key` export provides a testing account contract implementation that uses a single Grumpkin key for both authentication and encryption.
+It is not recommended to use this account type in production.
+
+## Classes
+
+- [SingleKeyAccountContract](../classes/single_key.SingleKeyAccountContract.md)
+
+## Variables
+
+### SchnorrSingleKeyAccountContractArtifact
+
+• `Const` **SchnorrSingleKeyAccountContractArtifact**: `ContractArtifact`
+
+## Functions
+
+### getUnsafeSchnorrAccount
+
+▸ **getUnsafeSchnorrAccount**(`pxe`, `secretKey`, `salt?`): `Promise`\<`AccountManager`\>
+
+Creates an Account that uses the same Grumpkin key for encryption and authentication.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `pxe` | `PXE` | An PXE server instance. |
+| `secretKey` | `Fr` | Secret key used to derive all the keystore keys (in this case also used to get signing key). |
+| `salt?` | `Salt` | Deployment salt. |
+
+#### Returns
+
+`Promise`\<`AccountManager`\>
+
+An account manager initialized with the account contract and its deployment params
+
+___
+
+### getUnsafeSchnorrWallet
+
+▸ **getUnsafeSchnorrWallet**(`pxe`, `address`, `signingPrivateKey`): `Promise`\<`AccountWallet`\>
+
+Gets a wallet for an already registered account using Schnorr signatures with a single key for encryption and authentication.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `pxe` | `PXE` | An PXE server instance. |
+| `address` | `AztecAddress` | Address for the account. |
+| `signingPrivateKey` | `Fq` | Grumpkin key used for note encryption and signing transactions. |
+
+#### Returns
+
+`Promise`\<`AccountWallet`\>
+
+A wallet for this account that can be used to interact with a contract instance.
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/testing.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/testing.md
new file mode 100644
index 000000000000..7fd5dd4fe70f
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/accounts/modules/testing.md
@@ -0,0 +1,173 @@
+---
+id: "testing"
+title: "Module: testing"
+sidebar_label: "testing"
+sidebar_position: 0
+custom_edit_url: null
+---
+
+The `@aztec/accounts/testing` export provides utility methods for testing, in particular in a Sandbox environment.
+
+Use [getInitialTestAccountsWallets](testing.md#getinitialtestaccountswallets) to obtain a list of wallets for the Sandbox pre-seeded accounts.
+
+## Interfaces
+
+- [InitialAccountData](../interfaces/testing.InitialAccountData.md)
+
+## Variables
+
+### INITIAL\_TEST\_ACCOUNT\_SALTS
+
+• `Const` **INITIAL\_TEST\_ACCOUNT\_SALTS**: `Fr`[]
+
+___
+
+### INITIAL\_TEST\_ENCRYPTION\_KEYS
+
+• `Const` **INITIAL\_TEST\_ENCRYPTION\_KEYS**: `Fq`[]
+
+___
+
+### INITIAL\_TEST\_SECRET\_KEYS
+
+• `Const` **INITIAL\_TEST\_SECRET\_KEYS**: `Fr`[]
+
+___
+
+### INITIAL\_TEST\_SIGNING\_KEYS
+
+• `Const` **INITIAL\_TEST\_SIGNING\_KEYS**: `Fq`[] = `INITIAL_TEST_ENCRYPTION_KEYS`
+
+## Functions
+
+### deployFundedSchnorrAccount
+
+▸ **deployFundedSchnorrAccount**(`pxe`, `account`, `opts?`, `waitForProvenOptions?`): `Promise`\<`AccountManager`\>
+
+Deploy schnorr account contract.
+It will pay for the fee for the deployment itself. So it must be funded with the prefilled public data.
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `pxe` | `PXE` |
+| `account` | `DeployAccountData` |
+| `opts` | `WaitOpts` & \{ `skipClassRegistration?`: `boolean` } |
+| `waitForProvenOptions?` | `WaitForProvenOpts` |
+
+#### Returns
+
+`Promise`\<`AccountManager`\>
+
+___
+
+### deployFundedSchnorrAccounts
+
+▸ **deployFundedSchnorrAccounts**(`pxe`, `accounts`, `opts?`, `waitForProvenOptions?`): `Promise`\<`AccountManager`[]\>
+
+Deploy schnorr account contracts.
+They will pay for the fees for the deployment themselves. So they must be funded with the prefilled public data.
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `pxe` | `PXE` |
+| `accounts` | `DeployAccountData`[] |
+| `opts` | `WaitOpts` & \{ `skipClassRegistration?`: `boolean` } |
+| `waitForProvenOptions?` | `WaitForProvenOpts` |
+
+#### Returns
+
+`Promise`\<`AccountManager`[]\>
+
+___
+
+### generateSchnorrAccounts
+
+▸ **generateSchnorrAccounts**(`numberOfAccounts`): `Promise`\<\{ `address`: `AztecAddress` ; `salt`: `Fr` ; `secret`: `Fr` ; `signingKey`: `Fq` }[]\>
+
+Generate a fixed amount of random schnorr account contract instance.
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `numberOfAccounts` | `number` |
+
+#### Returns
+
+`Promise`\<\{ `address`: `AztecAddress` ; `salt`: `Fr` ; `secret`: `Fr` ; `signingKey`: `Fq` }[]\>
+
+___
+
+### getDeployedTestAccounts
+
+▸ **getDeployedTestAccounts**(`pxe`): `Promise`\<[`InitialAccountData`](../interfaces/testing.InitialAccountData.md)[]\>
+
+Queries a PXE for it's registered accounts.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `pxe` | `PXE` | PXE instance. |
+
+#### Returns
+
+`Promise`\<[`InitialAccountData`](../interfaces/testing.InitialAccountData.md)[]\>
+
+A set of key data for each of the initial accounts.
+
+___
+
+### getDeployedTestAccountsWallets
+
+▸ **getDeployedTestAccountsWallets**(`pxe`): `Promise`\<`AccountWalletWithSecretKey`[]\>
+
+Queries a PXE for it's registered accounts and returns wallets for those accounts using keys in the initial test accounts.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `pxe` | `PXE` | PXE instance. |
+
+#### Returns
+
+`Promise`\<`AccountWalletWithSecretKey`[]\>
+
+A set of AccountWallet implementations for each of the initial accounts.
+
+___
+
+### getInitialTestAccounts
+
+▸ **getInitialTestAccounts**(): `Promise`\<[`InitialAccountData`](../interfaces/testing.InitialAccountData.md)[]\>
+
+Gets the basic information for initial test accounts.
+
+#### Returns
+
+`Promise`\<[`InitialAccountData`](../interfaces/testing.InitialAccountData.md)[]\>
+
+___
+
+### getInitialTestAccountsWallets
+
+▸ **getInitialTestAccountsWallets**(`pxe`): `Promise`\<`AccountWalletWithSecretKey`[]\>
+
+Gets a collection of wallets for the Aztec accounts that are initially stored in the test environment.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `pxe` | `PXE` | PXE instance. |
+
+#### Returns
+
+`Promise`\<`AccountWalletWithSecretKey`[]\>
+
+A set of AccountWallet implementations for each of the initial accounts.
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/aztec-js/_category_.yml b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/aztec-js/_category_.yml
new file mode 100644
index 000000000000..f5c77d17cdcf
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/aztec-js/_category_.yml
@@ -0,0 +1 @@
+label: "Aztec.js"
\ No newline at end of file
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/aztec-js/index.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/aztec-js/index.md
new file mode 100644
index 000000000000..2961da2dd54c
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/aztec-js/index.md
@@ -0,0 +1,46 @@
+---
+id: "index"
+title: "@aztec/aztec.js"
+sidebar_label: "Table of Contents"
+sidebar_position: 0.5
+hide_table_of_contents: true
+custom_edit_url: null
+---
+
+The `account` module provides utilities for managing accounts. The AccountManager class
+allows to deploy and register a fresh account, or to obtain a `Wallet` instance out of an account
+already deployed. Use the `@aztec/accounts` package to load default account implementations that rely
+on ECDSA or Schnorr signatures.
+
+## Interfaces
+
+- [AccountContract](interfaces/AccountContract.md)
+- [AccountInterface](interfaces/AccountInterface.md)
+
+## Type Aliases
+
+### Salt
+
+Ƭ **Salt**: `Fr` \| `number` \| `bigint`
+
+A contract deployment salt.
+
+## Functions
+
+### getAccountContractAddress
+
+▸ **getAccountContractAddress**(`accountContract`, `secret`, `salt`): `Promise`\<`AztecAddress`\>
+
+Compute the address of an account contract from secret and salt.
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `accountContract` | [`AccountContract`](interfaces/AccountContract.md) |
+| `secret` | `Fr` |
+| `salt` | `Fr` |
+
+#### Returns
+
+`Promise`\<`AztecAddress`\>
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/aztec-js/interfaces/AccountContract.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/aztec-js/interfaces/AccountContract.md
new file mode 100644
index 000000000000..8e86c77e9efa
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/aztec-js/interfaces/AccountContract.md
@@ -0,0 +1,75 @@
+---
+id: "AccountContract"
+title: "Interface: AccountContract"
+sidebar_label: "AccountContract"
+sidebar_position: 0
+custom_edit_url: null
+---
+
+An account contract instance. Knows its artifact, deployment arguments, how to create
+transaction execution requests out of function calls, and how to authorize actions.
+
+## Methods
+
+### getAuthWitnessProvider
+
+▸ **getAuthWitnessProvider**(`address`): `AuthWitnessProvider`
+
+Returns the auth witness provider for the given address.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `address` | `CompleteAddress` | Address for which to create auth witnesses. |
+
+#### Returns
+
+`AuthWitnessProvider`
+
+___
+
+### getContractArtifact
+
+▸ **getContractArtifact**(): `Promise`\<`ContractArtifact`\>
+
+Returns the artifact of this account contract.
+
+#### Returns
+
+`Promise`\<`ContractArtifact`\>
+
+___
+
+### getDeploymentFunctionAndArgs
+
+▸ **getDeploymentFunctionAndArgs**(): `Promise`\<`undefined` \| \{ `constructorArgs`: `any`[] ; `constructorName`: `string` }\>
+
+Returns the deployment function name and arguments for this instance, or undefined if this contract does not require deployment.
+
+#### Returns
+
+`Promise`\<`undefined` \| \{ `constructorArgs`: `any`[] ; `constructorName`: `string` }\>
+
+___
+
+### getInterface
+
+▸ **getInterface**(`address`, `nodeInfo`): [`AccountInterface`](AccountInterface.md)
+
+Returns the account interface for this account contract given a deployment at the provided address.
+The account interface is responsible for assembling tx requests given requested function calls, and
+for creating signed auth witnesses given action identifiers (message hashes).
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `address` | `CompleteAddress` | Address where this account contract is deployed. |
+| `nodeInfo` | `NodeInfo` | Info on the chain where it is deployed. |
+
+#### Returns
+
+[`AccountInterface`](AccountInterface.md)
+
+An account interface instance for creating tx requests and authorizing actions.
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/aztec-js/interfaces/AccountInterface.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/aztec-js/interfaces/AccountInterface.md
new file mode 100644
index 000000000000..c2197f036a0f
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/aztec-js/interfaces/AccountInterface.md
@@ -0,0 +1,116 @@
+---
+id: "AccountInterface"
+title: "Interface: AccountInterface"
+sidebar_label: "AccountInterface"
+sidebar_position: 0
+custom_edit_url: null
+---
+
+Handler for interfacing with an account. Knows how to create transaction execution
+requests and authorize actions for its corresponding account.
+
+## Hierarchy
+
+- `EntrypointInterface`
+
+- `AuthWitnessProvider`
+
+ ↳ **`AccountInterface`**
+
+## Methods
+
+### createAuthWit
+
+▸ **createAuthWit**(`messageHash`): `Promise`\<`AuthWitness`\>
+
+Computes an authentication witness from either a message hash
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `messageHash` | `Fr` \| `Buffer` | The message hash to approve |
+
+#### Returns
+
+`Promise`\<`AuthWitness`\>
+
+The authentication witness
+
+#### Inherited from
+
+AuthWitnessProvider.createAuthWit
+
+___
+
+### createTxExecutionRequest
+
+▸ **createTxExecutionRequest**(`exec`, `fee`, `options`): `Promise`\<`TxExecutionRequest`\>
+
+Generates an execution request out of set of function calls.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `exec` | `ExecutionPayload` | The execution intents to be run. |
+| `fee` | `FeeOptions` | The fee options for the transaction. |
+| `options` | `TxExecutionOptions` | Nonce and whether the transaction is cancellable. |
+
+#### Returns
+
+`Promise`\<`TxExecutionRequest`\>
+
+The authenticated transaction execution request.
+
+#### Inherited from
+
+EntrypointInterface.createTxExecutionRequest
+
+___
+
+### getAddress
+
+▸ **getAddress**(): `AztecAddress`
+
+Returns the address for this account.
+
+#### Returns
+
+`AztecAddress`
+
+___
+
+### getChainId
+
+▸ **getChainId**(): `Fr`
+
+Returns the chain id for this account
+
+#### Returns
+
+`Fr`
+
+___
+
+### getCompleteAddress
+
+▸ **getCompleteAddress**(): `CompleteAddress`
+
+Returns the complete address for this account.
+
+#### Returns
+
+`CompleteAddress`
+
+___
+
+### getVersion
+
+▸ **getVersion**(): `Fr`
+
+Returns the rollup version for this account
+
+#### Returns
+
+`Fr`
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/aztec-js/interfaces/_category_.yml b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/aztec-js/interfaces/_category_.yml
new file mode 100644
index 000000000000..43bec88cfa0a
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/aztec-js/interfaces/_category_.yml
@@ -0,0 +1,2 @@
+label: "Interfaces"
+position: 4
\ No newline at end of file
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/_category_.yml b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/_category_.yml
new file mode 100644
index 000000000000..3095e3e72ff8
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/_category_.yml
@@ -0,0 +1 @@
+label: "Private Execution Environment (PXE)"
\ No newline at end of file
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/enums/EventType.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/enums/EventType.md
new file mode 100644
index 000000000000..338e46d1034e
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/enums/EventType.md
@@ -0,0 +1,21 @@
+---
+id: "EventType"
+title: "Enumeration: EventType"
+sidebar_label: "EventType"
+sidebar_position: 0
+custom_edit_url: null
+---
+
+This is used in getting events via the filter
+
+## Enumeration Members
+
+### Encrypted
+
+• **Encrypted** = ``"Encrypted"``
+
+___
+
+### Unencrypted
+
+• **Unencrypted** = ``"Unencrypted"``
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/enums/_category_.yml b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/enums/_category_.yml
new file mode 100644
index 000000000000..1687a9e03fd7
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/enums/_category_.yml
@@ -0,0 +1,2 @@
+label: "Enumerations"
+position: 2
\ No newline at end of file
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/index.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/index.md
new file mode 100644
index 000000000000..390faf79398f
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/index.md
@@ -0,0 +1,38 @@
+---
+id: "index"
+title: "@aztec/stdlib"
+sidebar_label: "Exports"
+sidebar_position: 0.5
+custom_edit_url: null
+---
+
+## Enumerations
+
+- [EventType](enums/EventType.md)
+
+## Interfaces
+
+- [ContractClassMetadata](interfaces/ContractClassMetadata.md)
+- [ContractMetadata](interfaces/ContractMetadata.md)
+- [PXE](interfaces/PXE.md)
+- [PXEInfo](interfaces/PXEInfo.md)
+
+## Type Aliases
+
+### EventMetadataDefinition
+
+Ƭ **EventMetadataDefinition**: `Object`
+
+#### Type declaration
+
+| Name | Type |
+| :------ | :------ |
+| `abiType` | `AbiType` |
+| `eventSelector` | `EventSelector` |
+| `fieldNames` | `string`[] |
+
+## Variables
+
+### PXESchema
+
+• `Const` **PXESchema**: `ApiSchemaFor`\<[`PXE`](interfaces/PXE.md)\>
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/interfaces/ContractClassMetadata.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/interfaces/ContractClassMetadata.md
new file mode 100644
index 000000000000..4a152c2a34a9
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/interfaces/ContractClassMetadata.md
@@ -0,0 +1,25 @@
+---
+id: "ContractClassMetadata"
+title: "Interface: ContractClassMetadata"
+sidebar_label: "ContractClassMetadata"
+sidebar_position: 0
+custom_edit_url: null
+---
+
+## Properties
+
+### artifact
+
+• `Optional` **artifact**: `ContractArtifact`
+
+___
+
+### contractClass
+
+• `Optional` **contractClass**: `ContractClassWithId`
+
+___
+
+### isContractClassPubliclyRegistered
+
+• **isContractClassPubliclyRegistered**: `boolean`
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/interfaces/ContractMetadata.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/interfaces/ContractMetadata.md
new file mode 100644
index 000000000000..7bd09ee675a8
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/interfaces/ContractMetadata.md
@@ -0,0 +1,25 @@
+---
+id: "ContractMetadata"
+title: "Interface: ContractMetadata"
+sidebar_label: "ContractMetadata"
+sidebar_position: 0
+custom_edit_url: null
+---
+
+## Properties
+
+### contractInstance
+
+• `Optional` **contractInstance**: `ContractInstanceWithAddress`
+
+___
+
+### isContractInitialized
+
+• **isContractInitialized**: `boolean`
+
+___
+
+### isContractPubliclyDeployed
+
+• **isContractPubliclyDeployed**: `boolean`
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/interfaces/PXE.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/interfaces/PXE.md
new file mode 100644
index 000000000000..f3018f0b4047
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/interfaces/PXE.md
@@ -0,0 +1,724 @@
+---
+id: "PXE"
+title: "Interface: PXE"
+sidebar_label: "PXE"
+sidebar_position: 0
+custom_edit_url: null
+---
+
+Private eXecution Environment (PXE) runs locally for each user, providing functionality for all the operations
+needed to interact with the Aztec network, including account management, private data management,
+transaction local simulation, and access to an Aztec node. This interface, as part of a Wallet,
+is exposed to dapps for interacting with the network on behalf of the user.
+
+## Methods
+
+### getBlock
+
+▸ **getBlock**(`number`): `Promise`\<`undefined` \| `L2Block`\>
+
+Get the given block.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `number` | `number` | The block number being requested. |
+
+#### Returns
+
+`Promise`\<`undefined` \| `L2Block`\>
+
+The blocks requested.
+
+___
+
+### getBlockNumber
+
+▸ **getBlockNumber**(): `Promise`\<`number`\>
+
+Fetches the current block number.
+
+#### Returns
+
+`Promise`\<`number`\>
+
+The block number.
+
+___
+
+### getContractClassLogs
+
+▸ **getContractClassLogs**(`filter`): `Promise`\<`GetContractClassLogsResponse`\>
+
+Gets contract class logs based on the provided filter.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `filter` | `LogFilter` | The filter to apply to the logs. |
+
+#### Returns
+
+`Promise`\<`GetContractClassLogsResponse`\>
+
+The requested logs.
+
+___
+
+### getContractClassMetadata
+
+▸ **getContractClassMetadata**(`id`, `includeArtifact?`): `Promise`\<[`ContractClassMetadata`](ContractClassMetadata.md)\>
+
+Returns the contract class metadata given a contract class id.
+The metadata consists of its contract class, whether it has been publicly registered, and its artifact.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `id` | `Fr` | Identifier of the class. |
+| `includeArtifact?` | `boolean` | Identifier of the class. |
+
+#### Returns
+
+`Promise`\<[`ContractClassMetadata`](ContractClassMetadata.md)\>
+
+- It returns the contract class metadata, with the artifact field being optional, and will only be returned if true is passed in
+for `includeArtifact`
+TODO(@spalladino): The PXE actually holds artifacts and not classes, what should we return? Also,
+should the pxe query the node for contract public info, and merge it with its own definitions?
+TODO(@spalladino): This method is strictly needed to decide whether to publicly register a class or not
+during a public deployment. We probably want a nicer and more general API for this, but it'll have to
+do for the time being.
+
+**`Remark`**
+
+- it queries the node to check whether the contract class with the given id has been publicly registered.
+
+___
+
+### getContractMetadata
+
+▸ **getContractMetadata**(`address`): `Promise`\<[`ContractMetadata`](ContractMetadata.md)\>
+
+Returns the contract metadata given an address.
+The metadata consists of its contract instance, which includes the contract class identifier,
+initialization hash, deployment salt, and public keys hash; whether the contract instance has been initialized;
+and whether the contract instance with the given address has been publicly deployed.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `address` | `AztecAddress` | The address that the contract instance resides at. |
+
+#### Returns
+
+`Promise`\<[`ContractMetadata`](ContractMetadata.md)\>
+
+- It returns the contract metadata
+TODO(@spalladino): Should we return the public keys in plain as well here?
+
+**`Remark`**
+
+- it queries the node to check whether the contract instance has been initialized / publicly deployed through a node.
+This query is not dependent on the PXE.
+
+___
+
+### getContracts
+
+▸ **getContracts**(): `Promise`\<`AztecAddress`[]\>
+
+Retrieves the addresses of contracts added to this PXE Service.
+
+#### Returns
+
+`Promise`\<`AztecAddress`[]\>
+
+An array of contracts addresses registered on this PXE Service.
+
+___
+
+### getCurrentBaseFees
+
+▸ **getCurrentBaseFees**(): `Promise`\<`GasFees`\>
+
+Method to fetch the current base fees.
+
+#### Returns
+
+`Promise`\<`GasFees`\>
+
+The current base fees.
+
+___
+
+### getL1ToL2MembershipWitness
+
+▸ **getL1ToL2MembershipWitness**(`contractAddress`, `messageHash`, `secret`): `Promise`\<[`bigint`, `SiblingPath`\<``39``\>]\>
+
+Fetches an L1 to L2 message from the node.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `contractAddress` | `AztecAddress` | Address of a contract by which the message was emitted. |
+| `messageHash` | `Fr` | Hash of the message. |
+| `secret` | `Fr` | Secret used to compute a nullifier. |
+
+#### Returns
+
+`Promise`\<[`bigint`, `SiblingPath`\<``39``\>]\>
+
+The l1 to l2 membership witness (index of message in the tree and sibling path).
+
+**`Dev`**
+
+Contract address and secret are only used to compute the nullifier to get non-nullified messages
+
+___
+
+### getL2ToL1MembershipWitness
+
+▸ **getL2ToL1MembershipWitness**(`blockNumber`, `l2Tol1Message`): `Promise`\<[`bigint`, `SiblingPath`\<`number`\>]\>
+
+Gets the membership witness for a message that was emitted at a particular block
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `blockNumber` | `number` | The block number in which to search for the message |
+| `l2Tol1Message` | `Fr` | The message to search for |
+
+#### Returns
+
+`Promise`\<[`bigint`, `SiblingPath`\<`number`\>]\>
+
+The membership witness for the message
+
+___
+
+### getNodeInfo
+
+▸ **getNodeInfo**(): `Promise`\<`NodeInfo`\>
+
+Returns the information about the server's node. Includes current Node version, compatible Noir version,
+L1 chain identifier, protocol version, and L1 address of the rollup contract.
+
+#### Returns
+
+`Promise`\<`NodeInfo`\>
+
+- The node information.
+
+___
+
+### getNotes
+
+▸ **getNotes**(`filter`): `Promise`\<`UniqueNote`[]\>
+
+Gets notes registered in this PXE based on the provided filter.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `filter` | `NotesFilter` | The filter to apply to the notes. |
+
+#### Returns
+
+`Promise`\<`UniqueNote`[]\>
+
+The requested notes.
+
+___
+
+### getPXEInfo
+
+▸ **getPXEInfo**(): `Promise`\<[`PXEInfo`](PXEInfo.md)\>
+
+Returns information about this PXE.
+
+#### Returns
+
+`Promise`\<[`PXEInfo`](PXEInfo.md)\>
+
+___
+
+### getPrivateEvents
+
+▸ **getPrivateEvents**\<`T`\>(`eventMetadata`, `from`, `limit`, `vpks`): `Promise`\<`T`[]\>
+
+Returns the private events given search parameters.
+
+#### Type parameters
+
+| Name |
+| :------ |
+| `T` |
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `eventMetadata` | [`EventMetadataDefinition`](../#eventmetadatadefinition) | Metadata of the event. This should be the class generated from the contract. e.g. Contract.events.Event |
+| `from` | `number` | The block number to search from. |
+| `limit` | `number` | The amount of blocks to search. |
+| `vpks` | `Point`[] | The incoming viewing public keys that can decrypt the log. |
+
+#### Returns
+
+`Promise`\<`T`[]\>
+
+- The deserialized events.
+
+___
+
+### getProvenBlockNumber
+
+▸ **getProvenBlockNumber**(): `Promise`\<`number`\>
+
+Fetches the current proven block number.
+
+#### Returns
+
+`Promise`\<`number`\>
+
+The block number.
+
+___
+
+### getPublicEvents
+
+▸ **getPublicEvents**\<`T`\>(`eventMetadata`, `from`, `limit`): `Promise`\<`T`[]\>
+
+Returns the public events given search parameters.
+
+#### Type parameters
+
+| Name |
+| :------ |
+| `T` |
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `eventMetadata` | [`EventMetadataDefinition`](../#eventmetadatadefinition) | Metadata of the event. This should be the class generated from the contract. e.g. Contract.events.Event |
+| `from` | `number` | The block number to search from. |
+| `limit` | `number` | The amount of blocks to search. |
+
+#### Returns
+
+`Promise`\<`T`[]\>
+
+- The deserialized events.
+
+___
+
+### getPublicLogs
+
+▸ **getPublicLogs**(`filter`): `Promise`\<`GetPublicLogsResponse`\>
+
+Gets public logs based on the provided filter.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `filter` | `LogFilter` | The filter to apply to the logs. |
+
+#### Returns
+
+`Promise`\<`GetPublicLogsResponse`\>
+
+The requested logs.
+
+___
+
+### getPublicStorageAt
+
+▸ **getPublicStorageAt**(`contract`, `slot`): `Promise`\<`Fr`\>
+
+Gets the storage value at the given contract storage slot.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `contract` | `AztecAddress` | Address of the contract to query. |
+| `slot` | `Fr` | Slot to query. |
+
+#### Returns
+
+`Promise`\<`Fr`\>
+
+Storage value at the given contract slot.
+
+**`Remarks`**
+
+The storage slot here refers to the slot as it is defined in Noir not the index in the merkle tree.
+Aztec's version of `eth_getStorageAt`.
+
+**`Throws`**
+
+If the contract is not deployed.
+
+___
+
+### getRegisteredAccounts
+
+▸ **getRegisteredAccounts**(): `Promise`\<`CompleteAddress`[]\>
+
+Retrieves the user accounts registered on this PXE Service.
+
+#### Returns
+
+`Promise`\<`CompleteAddress`[]\>
+
+An array of the accounts registered on this PXE Service.
+
+___
+
+### getSenders
+
+▸ **getSenders**(): `Promise`\<`AztecAddress`[]\>
+
+Retrieves the addresses stored as senders on this PXE Service.
+
+#### Returns
+
+`Promise`\<`AztecAddress`[]\>
+
+An array of the senders on this PXE Service.
+
+___
+
+### getTxEffect
+
+▸ **getTxEffect**(`txHash`): `Promise`\<`undefined` \| `InBlock`\<`TxEffect`\>\>
+
+Get a tx effect.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `txHash` | `TxHash` | The hash of a transaction which resulted in the returned tx effect. |
+
+#### Returns
+
+`Promise`\<`undefined` \| `InBlock`\<`TxEffect`\>\>
+
+The requested tx effect.
+
+___
+
+### getTxReceipt
+
+▸ **getTxReceipt**(`txHash`): `Promise`\<`TxReceipt`\>
+
+Fetches a transaction receipt for a given transaction hash. Returns a mined receipt if it was added
+to the chain, a pending receipt if it's still in the mempool of the connected Aztec node, or a dropped
+receipt if not found in the connected Aztec node.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `txHash` | `TxHash` | The transaction hash. |
+
+#### Returns
+
+`Promise`\<`TxReceipt`\>
+
+A receipt of the transaction.
+
+___
+
+### isL1ToL2MessageSynced
+
+▸ **isL1ToL2MessageSynced**(`l1ToL2Message`): `Promise`\<`boolean`\>
+
+Returns whether an L1 to L2 message is synced by archiver and if it's ready to be included in a block.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `l1ToL2Message` | `Fr` | The L1 to L2 message to check. |
+
+#### Returns
+
+`Promise`\<`boolean`\>
+
+Whether the message is synced and ready to be included in a block.
+
+___
+
+### profileTx
+
+▸ **profileTx**(`txRequest`, `profileMode`, `msgSender?`): `Promise`\<`TxProfileResult`\>
+
+Profiles a transaction, reporting gate counts (unless disabled) and returns an execution trace.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `txRequest` | `TxExecutionRequest` | An authenticated tx request ready for simulation |
+| `profileMode` | ``"gates"`` \| ``"execution-steps"`` \| ``"full"`` | - |
+| `msgSender?` | `AztecAddress` | (Optional) The message sender to use for the simulation. |
+
+#### Returns
+
+`Promise`\<`TxProfileResult`\>
+
+A trace of the program execution with gate counts.
+
+**`Throws`**
+
+If the code for the functions executed in this transaction have not been made available via `addContracts`.
+
+___
+
+### proveTx
+
+▸ **proveTx**(`txRequest`, `privateExecutionResult`): `Promise`\<`TxProvingResult`\>
+
+Proves the private portion of a simulated transaction, ready to send to the network
+(where valiators prove the public portion).
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `txRequest` | `TxExecutionRequest` | An authenticated tx request ready for proving |
+| `privateExecutionResult` | `PrivateExecutionResult` | The result of the private execution of the transaction |
+
+#### Returns
+
+`Promise`\<`TxProvingResult`\>
+
+A result containing the proof and public inputs of the tail circuit.
+
+**`Throws`**
+
+If contract code not found, or public simulation reverts.
+Also throws if simulatePublic is true and public simulation reverts.
+
+___
+
+### registerAccount
+
+▸ **registerAccount**(`secretKey`, `partialAddress`): `Promise`\<`CompleteAddress`\>
+
+Registers a user account in PXE given its master encryption private key.
+Once a new account is registered, the PXE Service will trial-decrypt all published notes on
+the chain and store those that correspond to the registered account. Will do nothing if the
+account is already registered.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `secretKey` | `Fr` | Secret key of the corresponding user master public key. |
+| `partialAddress` | `Fr` | The partial address of the account contract corresponding to the account being registered. |
+
+#### Returns
+
+`Promise`\<`CompleteAddress`\>
+
+The complete address of the account.
+
+___
+
+### registerContract
+
+▸ **registerContract**(`contract`): `Promise`\<`void`\>
+
+Adds deployed contracts to the PXE Service. Deployed contract information is used to access the
+contract code when simulating local transactions. This is automatically called by aztec.js when
+deploying a contract. Dapps that wish to interact with contracts already deployed should register
+these contracts in their users' PXE Service through this method.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `contract` | `Object` | A contract instance to register, with an optional artifact which can be omitted if the contract class has already been registered. |
+| `contract.artifact?` | `ContractArtifact` | - |
+| `contract.instance` | `ContractInstanceWithAddress` | - |
+
+#### Returns
+
+`Promise`\<`void`\>
+
+___
+
+### registerContractClass
+
+▸ **registerContractClass**(`artifact`): `Promise`\<`void`\>
+
+Registers a contract class in the PXE without registering any associated contract instance with it.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `artifact` | `ContractArtifact` | The build artifact for the contract class. |
+
+#### Returns
+
+`Promise`\<`void`\>
+
+___
+
+### registerSender
+
+▸ **registerSender**(`address`): `Promise`\<`AztecAddress`\>
+
+Registers a user contact in PXE.
+
+Once a new contact is registered, the PXE Service will be able to receive notes tagged from this contact.
+Will do nothing if the account is already registered.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `address` | `AztecAddress` | Address of the user to add to the address book |
+
+#### Returns
+
+`Promise`\<`AztecAddress`\>
+
+The address address of the account.
+
+___
+
+### removeSender
+
+▸ **removeSender**(`address`): `Promise`\<`void`\>
+
+Removes a sender in the address book.
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `address` | `AztecAddress` |
+
+#### Returns
+
+`Promise`\<`void`\>
+
+___
+
+### sendTx
+
+▸ **sendTx**(`tx`): `Promise`\<`TxHash`\>
+
+Sends a transaction to an Aztec node to be broadcasted to the network and mined.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `tx` | `Tx` | The transaction as created via `proveTx`. |
+
+#### Returns
+
+`Promise`\<`TxHash`\>
+
+A hash of the transaction, used to identify it.
+
+___
+
+### simulateTx
+
+▸ **simulateTx**(`txRequest`, `simulatePublic`, `msgSender?`, `skipTxValidation?`, `skipFeeEnforcement?`, `scopes?`): `Promise`\<`TxSimulationResult`\>
+
+Simulates a transaction based on the provided preauthenticated execution request.
+This will run a local simulation of private execution (and optionally of public as well), run the
+kernel circuits to ensure adherence to protocol rules (without generating a proof), and return the
+simulation results .
+
+Note that this is used with `ContractFunctionInteraction::simulateTx` to bypass certain checks.
+In that case, the transaction returned is only potentially ready to be sent to the network for execution.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `txRequest` | `TxExecutionRequest` | An authenticated tx request ready for simulation |
+| `simulatePublic` | `boolean` | Whether to simulate the public part of the transaction. |
+| `msgSender?` | `AztecAddress` | (Optional) The message sender to use for the simulation. |
+| `skipTxValidation?` | `boolean` | (Optional) If false, this function throws if the transaction is unable to be included in a block at the current state. |
+| `skipFeeEnforcement?` | `boolean` | (Optional) If false, fees are enforced. |
+| `scopes?` | `AztecAddress`[] | (Optional) The accounts whose notes we can access in this call. Currently optional and will default to all. |
+
+#### Returns
+
+`Promise`\<`TxSimulationResult`\>
+
+A simulated transaction result object that includes public and private return values.
+
+**`Throws`**
+
+If the code for the functions executed in this transaction have not been made available via `addContracts`.
+Also throws if simulatePublic is true and public simulation reverts.
+
+___
+
+### simulateUnconstrained
+
+▸ **simulateUnconstrained**(`functionName`, `args`, `to`, `authwits?`, `from?`, `scopes?`): `Promise`\<`AbiDecoded`\>
+
+Simulate the execution of an unconstrained function on a deployed contract without actually modifying state.
+This is useful to inspect contract state, for example fetching a variable value or calling a getter function.
+The function takes function name and arguments as parameters, along with the contract address
+and optionally the sender's address.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `functionName` | `string` | The name of the function to be called in the contract. |
+| `args` | `any`[] | The arguments to be provided to the function. |
+| `to` | `AztecAddress` | The address of the contract to be called. |
+| `authwits?` | `AuthWitness`[] | - |
+| `from?` | `AztecAddress` | (Optional) The msg sender to set for the call. |
+| `scopes?` | `AztecAddress`[] | (Optional) The accounts whose notes we can access in this call. Currently optional and will default to all. |
+
+#### Returns
+
+`Promise`\<`AbiDecoded`\>
+
+The result of the view function call, structured based on the function ABI.
+
+___
+
+### updateContract
+
+▸ **updateContract**(`contractAddress`, `artifact`): `Promise`\<`void`\>
+
+Updates a deployed contract in the PXE Service. This is used to update the contract artifact when
+an update has happened, so the new code can be used in the simulation of local transactions.
+This is called by aztec.js when instantiating a contract in a given address with a mismatching artifact.
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `contractAddress` | `AztecAddress` | The address of the contract to update. |
+| `artifact` | `ContractArtifact` | The updated artifact for the contract. |
+
+#### Returns
+
+`Promise`\<`void`\>
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/interfaces/PXEInfo.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/interfaces/PXEInfo.md
new file mode 100644
index 000000000000..b34b5866adef
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/interfaces/PXEInfo.md
@@ -0,0 +1,25 @@
+---
+id: "PXEInfo"
+title: "Interface: PXEInfo"
+sidebar_label: "PXEInfo"
+sidebar_position: 0
+custom_edit_url: null
+---
+
+Provides basic information about the running PXE.
+
+## Properties
+
+### protocolContractAddresses
+
+• **protocolContractAddresses**: `ProtocolContractAddresses`
+
+Protocol contract addresses
+
+___
+
+### pxeVersion
+
+• **pxeVersion**: `string`
+
+Version as tracked in the aztec-packages repository.
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/interfaces/_category_.yml b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/interfaces/_category_.yml
new file mode 100644
index 000000000000..43bec88cfa0a
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/aztecjs/pxe/interfaces/_category_.yml
@@ -0,0 +1,2 @@
+label: "Interfaces"
+position: 4
\ No newline at end of file
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/considerations/_category_.json b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/considerations/_category_.json
new file mode 100644
index 000000000000..3d16e4d09376
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/considerations/_category_.json
@@ -0,0 +1,6 @@
+{
+ "label": "Considerations and Limitations",
+ "position": 4,
+ "collapsible": true,
+ "collapsed": true
+}
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/considerations/limitations.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/considerations/limitations.md
new file mode 100644
index 000000000000..5dbcc7346797
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/considerations/limitations.md
@@ -0,0 +1,328 @@
+---
+title: Limitations
+sidebar_position: 6
+tags: [sandbox]
+---
+
+The Aztec Sandbox and the Aztec Smart Contract Library are **prototypes**, and should be treated as such. They've been released early, to gather feedback on the capabilities of the protocol and user experiences.
+
+## What to expect?
+
+- Regular Breaking Changes;
+- Missing features;
+- Bugs;
+- An 'unpolished' UX;
+- Missing information.
+
+## Why participate?
+
+Front-run the future!
+
+Help shape and define:
+
+- Previously-impossible smart contracts and applications
+- Network tooling;
+- Network standards;
+- Smart contract syntax;
+- Educational content;
+- Core protocol improvements;
+
+## Limitations developers need to know about
+
+- It is a testing environment, it is insecure, unaudited and does not generate any proofs, its only for testing purposes;
+- Constructors can not call nor alter public state
+ - The constructor is executed exclusively in private domain, WITHOUT the ability to call public functions or alter public state. This means to set initial storage values, you need to follow a pattern similar to [proxies in Ethereum](https://blog.openzeppelin.com/proxy-patterns), where you `initialize` the contract with values after it have been deployed.
+ - Beware that what you think of as a `view` could alter state ATM! Notably the account could alter state or re-enter whenever the account contract's `is_valid` function is called.
+- `msg_sender` is currently leaking when doing private -> public calls
+ - The `msg_sender` will always be set, if you call a public function from the private world, the `msg_sender` will be set to the private caller's address.
+- The initial `msg_sender` is 0, which can be problematic for some contracts.
+- Unencrypted logs don't link to the contract that emitted it, so essentially just a `debug_log`` that you can match values against.
+- A note that is created and nullified in the same transaction will still emit an encrypted log.
+- A limited amount of new note hashes, nullifiers and calls that are supported by a transaction, see [circuit limitations](#circuit-limitations).
+
+## Limitations
+
+There are plans to resolve all of the below.
+
+### It is not audited
+
+None of the Sandbox code is audited. It's being iterated-on every day. It will not be audited for quite some time.
+
+### No Proofs
+
+That's right, the Sandbox doesn't actually generate or verify any zk-SNARKs yet!
+
+The main goal of the Sandbox is to enable developers to experiment with building apps, and hopefully to provide feedback. We want the developer experience to be as fast as possible, much like how Ethereum developers use Ganache or Anvil to get super-fast block times, instead of the slow-but-realistic 12-second block times that they'll encounter in production. A fast Sandbox enables fast testing, which enables developers to iterate quickly.
+
+That's not to say a super-fast proving system isn't being worked on as we speak.
+
+#### What are the consequences?
+
+By the time mainnet comes around, zk-SNARKs will be needed in order to validate the correctness of every function that's executed on Aztec. In other words, in order for the execution of a function to be registered as part of the Aztec blockchain's history, a proof of correct execution will need to be furnished. Each proof will be an attestation that the rules of a particular function were followed correctly.
+
+But proofs are really only needed as a protection against malicious behavior. The Sandbox is an emulated ecosystem; entirely contained within your laptop, and it follows the network's rules out of the box. So as long as its inner workings aren't tampered-with, it will act 'honestly'. Since you'll be the only person interacting with the Sandbox on your own laptop, and with a healthy assumption that you should be honest with yourself, you won't need proofs when testing.
+
+### No Circuits!
+
+This is kind-of a repetition of ['No Proofs!'](#no-proofs) above, but for the sake of clarity, there aren't yet any arithmetic circuits in the Sandbox. We might refer to certain components of the core protocol as being 'circuits', and we might refer to user-defined smart contract functions as being compiled to 'circuits', but the Sandbox doesn't actually contain any circuits yet. Instead, there is code which emulates the logic of a circuit. This is intentional, to make execution of the Sandbox as fast as possible.
+
+Obviously, as development continues, the so-called 'circuits' will actually become proper circuits, and actual proofs will be generated.
+
+#### What are the consequences?
+
+The Sandbox will execute more quickly. The logic of all 'circuits' is still in place*. Smart contract logic will be executed, and core protocol logic will be executed*. So invalid transactions will be caught\* and rejected.
+
+\*Note: some core protocol circuit assertions and constraints still need to be written (see [GitHub](https://github.com/AztecProtocol/aztec-packages/issues)). This would be bad in an adversarial environment, but the Sandbox is not that. Naturally, proper circuits will need to be written.
+
+### No Fees!
+
+That's right, there are no L2 network fees yet!
+
+The Sandbox can currently be thought of as a bare-minimum execution layer. We'll be speccing and implementing gas metering and fees soon!
+
+> Note: there is still a notion of an L1 fee in the Sandbox, because it uses Anvil to emulate the Ethereum blockchain.
+
+#### What are the consequences?
+
+Apps won't yet be able to allow for any L2 fee logic. Once fees are introduced, this will cause breaking changes to in-progress apps, which will need to be updated to accommodate the notion of paying network fees for transactions. Clear documentation will be provided.
+
+### Basic Keys and Addresses!
+
+The way in which keypairs and addresses are currently derived and implemented (inside the Sandbox) is greatly over-simplified, relative to future plans.
+
+They're so over-simplified that they're known to be insecure. Other features have been prioritized so-far in Sandbox development.
+
+#### What are the consequences?
+
+This will impact the kinds of apps that you can build with the Sandbox, as it is today:
+
+- The management of keys when designing account contracts and wallets will be affected.
+- The keys used when generating nullifiers will be affected. (Although the machinery relating to nullifiers is mostly abstracted away from developers who use Aztec.nr.
+ - In particular the current, over-simplified key derivation scheme is known to be **insecure**:
+ - Currently, the same nullifier secret key is used by _every_ smart contract on the network. This would enable malicious apps to trivially emit a user's nullifier secret key to the world!
+ - In future, there are detailed plans to 'silo' a nullifier key per contract address (and per user), to fix this obvious vulnerability.
+- The keys used when encrypting and decrypting logs will be affected.
+ - In particular the current, over-simplified key derivation scheme is known to be **insecure**:
+ - Currently, a user's nullifier secret key is the same as their encryption secret key. And as stated above, this would enable malicious apps to trivially emit a user's secret key to the world!
+ - In future there are also plans to have incoming and outgoing viewing keys, inspired by [ZCash Sapling](https://electriccoin.co/blog/explaining-viewing-keys/).
+ - If developers wish to design apps which incorporate certain auditability patterns, the current over-simplification of keys might not be sufficient.
+
+Please open new discussions on [discourse](http://discourse.aztec.network) or open issues on [github](http://github.com/AztecProtocol/aztec-packages), if you have requirements that aren't-yet being met by the Sandbox's current key derivation scheme.
+
+### It's not-yet decentralized
+
+It's an emulated blockchain entirely contained within your own laptop! It's centralized by design!
+As for deploying this all to mainnet, a decentralized sequencer selection and prover selection protocols are still [being discussed](https://discourse.aztec.network/t/request-for-proposals-decentralized-sequencer-selection/350). There are plans for decentralized testnets in 2024.
+
+### You can't read mutable public state from a private function
+
+Private smart contract functions won't be able to read mutable public state yet. We have some [ideas](https://discourse.aztec.network/t/accessing-historic-public-state-from-private-functions/241/7?u=mike) for how to solve this, and will look to implement something very soon.
+
+#### What are the consequences?
+
+Reading public state from a private contract will be a common pattern. For example, it's needed if you want to maintain a public whitelist/blacklist, but prove you are/aren't on that blacklist privately. This will be a high priority, coming soon.
+
+### No delegatecalls
+
+A contract can't perform a delegatecall yet (if ever). Delegatecalls are quite a controversial feature of the EVM.
+
+### No privacy-preserving queries to nodes
+
+Ethereum has a notion of a 'full node' which keeps-up with the blockchain and stores the full chain state. Many users don't wish to run full nodes, so rely on 3rd-party 'full-node-as-a-service' infrastructure providers, who service blockchain queries from their users.
+
+This pattern is likely to develop in Aztec as well, except there's a problem: privacy. If a privacy-seeking user makes a query to a 3rd-party 'full node', that user might leak data about who they are, or about their historical network activity, or about their future intentions. One solution to this problem is "always run a full node", but pragmatically, not everyone will. To protect less-advanced users' privacy, research is underway to explore how a privacy-seeking user may request and receive data from a 3rd-party node without revealing what that data is, nor who is making the request.
+
+### No private data authentication
+
+Private data should not be returned to an app, unless the user authorizes such access to the app. An authorization layer is not-yet in place.
+
+#### What are the consequences?
+
+Any app can request and receive any private user data relating to any other private app. Obviously this sounds bad. But the Sandbox is a sandbox, and no meaningful value or credentials should be stored there; only test values and test credentials.
+
+An auth layer will be added in due course.
+
+### No bytecode validation
+
+Bytecode should not be executed, unless the Sandbox has validated that the user's intentions (the function signature and contract address) match the bytecode.
+
+#### What are the consequences?
+
+Without such 'bytecode validation', if the incorrect bytecode is executed, and that bytecode is malicious, it could read private data from some other contract and emit that private data to the world. Obviously this would be bad in production. But the Sandbox is a sandbox, and no meaningful value or credentials should be stored there; only test values and test credentials.
+
+There are plans to add bytecode validation soon.
+
+### Insecure hashes
+
+Currently, Pedersen hashes are being used pretty-much everywhere. To any cryptographers reading this, don't panic. A thorough review of which hashes to use in which part of the protocol will be conducted soon.
+
+Additionally, domain separation of hashes needs some review.
+
+#### What are the consequences?
+
+Collisions and other hash-related attacks might be possible in the Sandbox. Obviously that would be bad in production. But it's unlikely to cause problems at this early stage of testing.
+
+### `msg_sender` is leaked when making a private -> public call
+
+There are [ongoing discussions](https://discourse.aztec.network/t/who-is-msg-sender-when-making-private-public-function-calls/242) around how to address this.
+
+#### What are the consequences?
+
+When a private function makes a call to a public function, the `msg_sender` of the calling function will be given to the public world. Most critically, this includes if the `msg_sender` is an account contract.
+This will be patched in the near future, but unfortunately, app developers might need to 'overlook' this privacy leakage until then, with the assumption that it will be fixed. But note, one possible 'patch' might be to set `msg_sender` to `0` for all private -> public calls. This might cause breaking changes to your public functions, if they rely on reading `msg_sender`. There are patterns to work around this, but they wouldn't be pretty, and we won't go into details until a solution is chosen. Sorry about this, and thanks for your patience whilst we work this out :)
+
+### New Privacy Standards are required
+
+There are many [patterns](../../reference/considerations/privacy_considerations.md) which can leak privacy, even on Aztec. Standards haven't been developed yet, to encourage best practices when designing private smart contracts.
+
+#### What are the consequences?
+
+For example, until community standards are developed to reduce the uniqueness of ['Tx Fingerprints'](../../reference/considerations/privacy_considerations.md#function-fingerprints-and-tx-fingerprints) app developers might accidentally forfeit some function privacy.
+
+## Circuit limitations
+
+### Upper limits on function outputs and tx outputs
+
+Due to the rigidity of zk-SNARK circuits, there are upper bounds on the amount of computation a circuit can perform, and on the amount of data that can be passed into and out of a function.
+
+> Blockchain developers are no stranger to restrictive computational environments. Ethereum has gas limits, local variable stack limits, call stack limits, contract deployment size limits, log size limits, etc.
+
+Here are the current constants:
+
+```rust title="constants" showLineNumbers
+// "PER CALL" CONSTANTS
+pub global MAX_NOTE_HASHES_PER_CALL: u32 = 16;
+pub global MAX_NULLIFIERS_PER_CALL: u32 = 16;
+pub global MAX_PRIVATE_CALL_STACK_LENGTH_PER_CALL: u32 = 5;
+pub global MAX_ENQUEUED_CALLS_PER_CALL: u32 = 16;
+pub global MAX_L2_TO_L1_MSGS_PER_CALL: u32 = 2;
+pub global MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_CALL: u32 = 63;
+pub global MAX_PUBLIC_DATA_READS_PER_CALL: u32 = 64;
+pub global MAX_NOTE_HASH_READ_REQUESTS_PER_CALL: u32 = 16;
+pub global MAX_NULLIFIER_READ_REQUESTS_PER_CALL: u32 = 16;
+pub global MAX_NULLIFIER_NON_EXISTENT_READ_REQUESTS_PER_CALL: u32 = 16;
+pub global MAX_L1_TO_L2_MSG_READ_REQUESTS_PER_CALL: u32 = 16;
+pub global MAX_KEY_VALIDATION_REQUESTS_PER_CALL: u32 = 16;
+pub global MAX_PRIVATE_LOGS_PER_CALL: u32 = 16;
+pub global MAX_PUBLIC_LOGS_PER_CALL: u32 = 4;
+pub global MAX_CONTRACT_CLASS_LOGS_PER_CALL: u32 = 1;
+
+// TREES RELATED CONSTANTS
+pub global ARCHIVE_HEIGHT: u32 = 29;
+pub global VK_TREE_HEIGHT: u32 = 6;
+pub global PROTOCOL_CONTRACT_TREE_HEIGHT: u32 = 3;
+pub global FUNCTION_TREE_HEIGHT: u32 = 5;
+pub global NOTE_HASH_TREE_HEIGHT: u32 = 40;
+pub global PUBLIC_DATA_TREE_HEIGHT: u32 = 40;
+pub global NULLIFIER_TREE_HEIGHT: u32 = 40;
+pub global L1_TO_L2_MSG_TREE_HEIGHT: u32 = 39;
+pub global ARTIFACT_FUNCTION_TREE_MAX_HEIGHT: u32 = 5;
+pub global NULLIFIER_TREE_ID: Field = 0;
+pub global NOTE_HASH_TREE_ID: Field = 1;
+pub global PUBLIC_DATA_TREE_ID: Field = 2;
+pub global L1_TO_L2_MESSAGE_TREE_ID: Field = 3;
+pub global ARCHIVE_TREE_ID: Field = 4;
+
+// SUB-TREES RELATED CONSTANTS
+pub global NOTE_HASH_SUBTREE_HEIGHT: u32 = 6;
+pub global NULLIFIER_SUBTREE_HEIGHT: u32 = 6;
+// Deprecated: to be removed after removal of legacy ts trees
+pub global PUBLIC_DATA_SUBTREE_HEIGHT: u32 = 6;
+pub global L1_TO_L2_MSG_SUBTREE_HEIGHT: u32 = 4;
+pub global NOTE_HASH_SUBTREE_SIBLING_PATH_LENGTH: u32 =
+ NOTE_HASH_TREE_HEIGHT - NOTE_HASH_SUBTREE_HEIGHT;
+pub global NULLIFIER_SUBTREE_SIBLING_PATH_LENGTH: u32 =
+ NULLIFIER_TREE_HEIGHT - NULLIFIER_SUBTREE_HEIGHT;
+pub global L1_TO_L2_MSG_SUBTREE_SIBLING_PATH_LENGTH: u32 =
+ L1_TO_L2_MSG_TREE_HEIGHT - L1_TO_L2_MSG_SUBTREE_HEIGHT;
+
+// "PER TRANSACTION" CONSTANTS
+pub global MAX_NOTE_HASHES_PER_TX: u32 = (1 as u8 << NOTE_HASH_SUBTREE_HEIGHT as u8) as u32;
+pub global MAX_NULLIFIERS_PER_TX: u32 = (1 as u8 << NULLIFIER_SUBTREE_HEIGHT as u8) as u32;
+pub global MAX_PRIVATE_CALL_STACK_LENGTH_PER_TX: u32 = 8;
+pub global MAX_ENQUEUED_CALLS_PER_TX: u32 = 32;
+pub global PROTOCOL_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX: u32 = 1;
+pub global MAX_TOTAL_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX: u32 =
+ (1 as u8 << PUBLIC_DATA_SUBTREE_HEIGHT as u8) as u32;
+pub global MAX_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX: u32 =
+ MAX_TOTAL_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX - PROTOCOL_PUBLIC_DATA_UPDATE_REQUESTS_PER_TX;
+pub global MAX_PUBLIC_DATA_READS_PER_TX: u32 = 64;
+pub global MAX_L2_TO_L1_MSGS_PER_TX: u32 = 8;
+pub global MAX_NOTE_HASH_READ_REQUESTS_PER_TX: u32 = 64;
+pub global MAX_NULLIFIER_READ_REQUESTS_PER_TX: u32 = 64;
+pub global MAX_NULLIFIER_NON_EXISTENT_READ_REQUESTS_PER_TX: u32 = 64;
+pub global MAX_L1_TO_L2_MSG_READ_REQUESTS_PER_TX: u32 = 64;
+// TODO: for large multisends we might run out of key validation requests here but not dealing with this now as
+// databus will hopefully make the issue go away.
+pub global MAX_KEY_VALIDATION_REQUESTS_PER_TX: u32 = 64;
+pub global MAX_PRIVATE_LOGS_PER_TX: u32 = 32;
+pub global MAX_PUBLIC_LOGS_PER_TX: u32 = 8;
+pub global MAX_CONTRACT_CLASS_LOGS_PER_TX: u32 = 1;
+```
+> Source code: noir-projects/noir-protocol-circuits/crates/types/src/constants.nr#L28-L97
+
+
+#### What are the consequences?
+
+When you write an Aztec.nr function, there will be upper bounds on the following:
+
+- The number of public state reads and writes;
+- The number of note reads and nullifications;
+- The number of new notes that may be created;
+- The number of encrypted logs that may be emitted;
+- The number of unencrypted logs that may be emitted;
+- The number of L1->L2 messages that may be consumed;
+- The number of L2->L1 messages that may be submitted to L1;
+- The number of private function calls;
+- The number of public function calls that may be enqueued;
+
+Not only are there limits on a _per function_ basis, there are also limits on a _per transaction_ basis.
+
+**In particular, these _per-transaction_ limits will limit transaction call stack depths** in the Sandbox. That means if a function call results in a cascade of nested function calls, and each of those function calls outputs lots of state reads and writes, or logs (etc.), then all of that accumulated output data might exceed the per-transaction limits that we currently have. This would cause such transactions to fail.
+
+There are plans to relax all of this rigidity, by providing many 'sizes' of kernel circuit, and introducing a 'bus' to ferry varying lengths of data between kernel iterations. But that'll all take some time.
+
+> **In the mean time**, if you encounter a per-transaction limit when testing, and you're feeling adventurous, you could 'hack' the Sandbox to increase the limits. See here (TODO: link) for a guide. **However**, the limits cannot be increased indefinitely. So although we do anticipate that we'll be able to increase them a little bit, don't go mad and provide yourself with 1 million state transitions per transaction. That would be as unrealistic as artificially increasing Ethereum gas limits to 1 trillion.
+
+### Circuits Processing Order Differs from Execution Order
+
+Each function call is represented by a circuit with a dedicated zero-knowledge proof of its execution. The private kernel circuit is in charge of stitching all these proofs together to produce a zero-knowledge proof that the whole execution of all function calls within a transaction is correct. In doing so, the processing order differs from the execution order. Firstly, the private kernel has to handle one function call in its entirety at a time because a zk proof cannot be verified partially. This property alone makes it impossible for the ordering of kernel circuit validation to match the order in which the functions of the transaction were executed. Secondly, the private kernel processes function calls in a stack-based order, i.e., after having processed a function call, it processes all direct child function calls in an order which is the reverse of the execution order.
+
+Note that there is no plan to change this in the future.
+
+### Example
+
+Let us assume that the main function named $f_1$ is calling in order $f_2$, $f_3$ (which calls $f_5$ followed by $f_6$), and $f_4$.
+
+Call Dependency:
+
+> $f_1 \longrightarrow f_2$, $f_3$, $f_4$
+
+> $f_3 \longrightarrow f_5$, $f_6$
+
+Execution Order:
+
+> $f_1$, $f_2$, $f_3$, $f_5$, $f_6$, $f_4$
+
+Private Kernel Processing Order:
+
+> $f_1$, $f_4$, $f_3$, $f_6$, $f_5$, $f_2$
+
+#### What are the consequences?
+
+Transaction output elements such as notes in encrypted logs, note hashes (commitments), nullifiers might be ordered differently than the one expected by the execution.
+
+### Chopped Transient Notes are still Emitted in Logs
+
+A note which is created and nullified during the very same transaction is called transient. Such a note is chopped by the private kernel circuit and is never stored in any persistent data tree.
+
+For the time being, such chopped notes are still emitted through encrypted logs (which is the communication channel to transmit notes). When a log containing a chopped note is processed, a warning will be logged about a decrypted note which does not exist in data tree. We [improved (GitHub link)](https://github.com/AztecProtocol/aztec-packages/issues/1603) error logging to help identify such an occurrence. However, this might be a source of confusion.
+This issue is tracked in ticket [#1641 (GitHub link)](https://github.com/AztecProtocol/aztec-packages/issues/1641).
+
+### Note Terminology: Note Commitments and Note Hashes
+
+The notes or UTXOs in Aztec need to be compressed before they are added to the trees. To do so, we need to hash all the data inside a note using a collision-resistant hash function. Currently, we use Pedersen hash (using lookup tables) to compress note data. The compressed note data is referred to as "note commitments" in our architecture. However, note commitments are referred to as "note hashes" in aztec-noir code. Be mindful of that fact that note commitments and note hashes mean the same thing. Note that we only mean to talk about terminology here and in no way one should infer security/cryptographic properties (e.g., hiding, binding) based on the name. Namely, notes come with different flavours of security properties depending on the use case.
+
+## There's more
+
+See the [GitHub issues (GitHub link)](https://github.com/AztecProtocol/aztec-packages/issues) for all known bugs fixes and features currently being worked on.
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/considerations/privacy_considerations.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/considerations/privacy_considerations.md
new file mode 100644
index 000000000000..7a44889e5669
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/considerations/privacy_considerations.md
@@ -0,0 +1,140 @@
+---
+title: Privacy Considerations
+sidebar_position: 5
+tags: [protocol, PXE]
+---
+
+Privacy is important.
+
+Keeping information private is difficult.
+
+Once information is leaked, it cannot be unleaked.
+
+---
+
+## What can Aztec keep private?
+
+Aztec provides a set of tools to enable developers to build private smart contracts. The following can be kept private:
+
+**Private persistent state**
+
+Store state variables in an encrypted form, so that no one can see what those variables are, except those with the decryption key.
+
+**Private events and messages**
+
+Emit encrypted events, or encrypted messages from a private smart contract function. Only those with the decryption key will learn the message.
+
+**Private function execution**
+
+Execute a private function without the world knowing which function you've executed.
+
+:::danger
+Privacy is not guaranteed without care.
+Although Aztec provides the tools for private smart contracts, information can still be leaked unless the dapp developer is careful.
+This page outlines some best practices to aid dapp developers.
+:::
+
+---
+
+## Leaky practices
+
+There are many caveats to the above. Since Aztec also enables interaction with the _public_ world (public L2 functions and L1 functions), private information can be accidentally leaked if developers aren't careful.
+
+### Crossing the private -> public boundary
+
+Any time a private function makes a call to a public function, information is leaked. Now, that might be perfectly fine in some use cases (it's up to the smart contract developer). Indeed, most interesting apps will require some public state. But let's have a look at some leaky patterns:
+
+- Calling a public function from a private function. The public function execution will be publicly visible.
+- Calling a public function from a private function, without revealing the `msg_sender` of that call. (Otherwise the `msg_sender` will be publicly visible).
+- Passing arguments to a public function from a private function. All of those arguments will be publicly visible.
+- Calling an internal public function from a private function. The fact that the call originated from a private function of that same contract will be trivially known.
+- Emitting unencrypted events from a private function. The unencrypted event name and arguments will be publicly visible.
+- Sending L2->L1 messages from a private function. The entire message, and the resulting L1 function execution will all be publicly visible.
+
+### Crossing the public -> private boundary
+
+If a public function sends a message to be consumed by a private function, the act of consuming that message might be leaked if not following recommended patterns.
+
+### Timing of transactions
+
+Information about the nature of a transaction can be leaked based on the timing of that transaction.
+
+If a transaction is executed at 8am GMT, it's much less likely to have been made by someone in the USA.
+
+If there's a spike in transactions on the last day of every month, those might be salaries.
+
+These minor details are information that can disclose much more information about a user than the user might otherwise expect.
+
+Suppose that every time Alice sends Bob a private token, 1 minute later a transaction is always submitted to the tx pool with the same kind of 'fingerprint'. Alice might deduce that these transactions are automated reactions by Bob. (Here, 'fingerprint' is an intentionally vague term. It could be a public function call, or a private tx proof with a particular number of nonzero public inputs, or some other discernible pattern that Alice sees).
+
+TL;DR: app developers should think about the _timing_ of user transactions, and how this might leak information.
+
+### Function Fingerprints and Tx Fingerprints
+
+A 'Function Fingerprint' is any data which is exposed by a function to the outside world. A 'Tx Fingerprint' is any data which is exposed by a tx to the outside world. We're interested in minimizing leakages of information from private txs. The leakiness of a Tx Fingerprint depends on the leakiness of its constituent functions' Function Fingerprints _and_ on the appearance of the tx's Tx Fingerprint as a whole. For a private function (and by extension, for a private tx), the following information _could_ be leaked (depending on the function, of course):
+
+- All calls to public functions.
+ - The contract address of the private function (if it calls an internal public function).
+ - This could be the address of the transactor themselves, if the calling contract is an account contract.
+ - All arguments which are passed to public functions.
+- All calls to L1 functions (in the form of L2 -> L1 messages).
+ - The contents of L2 -> L1 messages.
+- All public logs (topics and arguments).
+- The roots of all trees which have been read from.
+- The _number_ of ['side effects']():
+ - \# new note hashes
+ - \# new nullifiers
+ - \# bytes of encrypted logs
+ - \# public function calls
+ - \# L2->L1 messages
+ - \# nonzero roots[^1]
+
+> Note: many of these were mentioned in the ["Crossing the private -> public boundary"](#crossing-the-private---public-boundary) section.
+
+> Note: the transaction effects submitted to L1 is [encoded (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/master/l1-contracts/src/core/libraries/Decoder.sol) but not garbled with other transactions: the distinct Tx Fingerprint of each tx can is publicly visible when a tx is submitted to the L2 tx pool.
+
+#### Standardizing Fingerprints
+
+If each private function were to have a unique Fingerprint, then all private functions would be distinguishable from each-other, and all of the efforts of the Aztec protocol to enable 'private function execution' would have been pointless. Standards need to be developed, to encourage smart contract developers to adhere to a restricted set of Tx Fingerprints. For example, a standard might propose that the number of new note hashes, nullifiers, logs, etc. must always be equal, and must always equal a power of two. Such a standard would effectively group private functions/txs into 'privacy sets', where all functions/txs in a particular 'privacy set' would look indistinguishable from each-other, when executed.
+
+### Data queries
+
+It's not just the broadcasting of transactions to the network that can leak data.
+
+Ethereum has a notion of a 'full node' which keeps-up with the blockchain and stores the full chain state. Many users don't wish to run full nodes, so rely on 3rd-party 'full-node-as-a-service' infrastructure providers, who service blockchain queries from their users.
+
+This pattern is likely to develop in Aztec as well, except there's a problem: privacy. If a privacy-seeking user makes a query to a 3rd-party 'full node', that user might leak data about who they are; about their historical network activity; or about their future intentions. One solution to this problem is "always run a full node", but pragmatically, not everyone will. To protect less-advanced users' privacy, research is underway to explore how a privacy-seeking user may request and receive data from a 3rd-party node without revealing what that data is, nor who is making the request.
+
+App developers should be aware of this avenue for private data leakage. **Whenever an app requests information from a node, the entity running that node is unlikely to be your user!**
+
+#### What kind of queries can be leaky?
+
+##### Querying for up-to-date note sibling paths
+
+To read a private state is to read a note from the note hash tree. To read a note is to prove existence of that note in the note hash tree. And to prove existence is to re-compute the root of the note hash tree using the leaf value, the leaf index, and the sibling path of that leaf. This computed root is then exposed to the world, as a way of saying "This note exists", or more precisely "This note has existed at least since this historical snapshot time".
+
+If an old historical snapshot is used, then that old historical root will be exposed, and this leaks some information about the nature of your transaction: it leaks that your note was created before the snapshot date. It shrinks the 'privacy set' of the transaction to a smaller window of time than the entire history of the network.
+
+So for maximal privacy, it's in a user's best interest to read from the very-latest snapshot of the data tree.
+
+Naturally, the note hash tree is continuously changing as new transactions take place and their new notes are appended. Most notably, the sibling path for every leaf in the tree changes every time a new leaf is appended.
+
+If a user runs their own node, there's no problem: they can query the latest sibling path for their note(s) from their own machine without leaking any information to the outside world.
+
+But if a user is not running their own node, they would need to query the very-latest sibling path of their note(s) from some 3rd-party node. In order to query the sibling path of a leaf, the leaf's index needs to be provided as an argument. Revealing the leaf's index to a 3rd-party trivially reveals exactly the note(s) you're about to read. And since those notes were created in some prior transaction, the 3rd-party will be able to link you with that prior transaction. Suppose then that the 3rd-party also serviced the creator of said prior transaction: the 3rd-party will slowly be able to link more and more transactions, and gain more and more insight into a network which is meant to be private!
+
+We're researching cryptographic ways to enable users to retrieve sibling paths from 3rd-parties without revealing leaf indices.
+
+> \* Note: due to the non-uniformity of Aztec transactions, the 'privacy set' of a transaction might not be the entire set of transactions that came before.
+
+##### Any query
+
+Any query to a node leaks information to that node.
+
+We're researching cryptographic ways to enable users to query any data privately.
+
+---
+
+Footnotes
+
+[^1]: All txs should set the kernel circuit public inputs for all roots to _valid_, _up-to-date_ nonzero values, so as to mask which trees have _actually_ been read from. The Sandbox will eventually automate this (see this [issue (GitHub link)](https://github.com/AztecProtocol/aztec-packages/issues/1676)).
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/debugging/_category_.json b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/debugging/_category_.json
new file mode 100644
index 000000000000..99db708f09cb
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/debugging/_category_.json
@@ -0,0 +1,6 @@
+{
+ "label": "Debugging",
+ "position": 3,
+ "collapsible": true,
+ "collapsed": true
+}
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/debugging/aztecnr-errors.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/debugging/aztecnr-errors.md
new file mode 100644
index 000000000000..84e1a1e286f7
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/debugging/aztecnr-errors.md
@@ -0,0 +1,75 @@
+---
+title: Aztec.nr Errors
+tags: [contracts]
+---
+
+This section contains some errors that you may encounter when writing and compiling contracts in Aztec.nr. If you run into an error that is not listed here, please [create an issue (GitHub link)](https://github.com/AztecProtocol/aztec-packages/issues/new).
+
+#### `Aztec dependency not found. Please add aztec as a dependency in your Nargo.toml`
+
+All smart contracts written in Aztec.nr need the `aztec` dependency. In your `Nargo.toml` under `[dependencies]`, add this:
+
+```toml
+aztec = { git="https://github.com/AztecProtocol/aztec-packages/", tag="v0.82.2", directory="noir-projects/aztec-nr/aztec" }
+```
+
+You can learn more about dependencies and their paths [here](../smart_contract_reference/dependencies.md).
+
+#### `backend has encountered an error`
+
+This is likely due to a version mismatch or bad install of barretenberg. Try [reinstalling nargo](../../guides/local_env/versions-updating.md) or uninstalling barretenberg:
+
+```bash
+nargo backend uninstall acvm-backend-barretenberg
+```
+
+It will then reinstall when you compile.
+
+#### `Oracle callback {} not found` & `Oracle callback pedersenHash not found`
+
+This can occasionally happen when there are breaking releases. Make sure that your dependencies in `Nargo.toml` are [updated to the latest release](../../guides/local_env/versions-updating.md#dependency-versions).
+
+#### `error: Failed constraint: 'Public state writes only supported in public functions`
+
+Reading and writing to public state from private functions is currently not supported.
+This is because public values may change before the private function execution is posted on-chain.
+
+This may change in future versions.
+
+#### `Simulation error: Assertion failed:...`
+
+This is an assertion error that is thrown when a condition is not met.
+
+To address the error. find the line in the contract that is throwing the error and investigate why the condition is not met.
+
+#### `Unknown contract 0x0: add it to PXE by calling server.addContracts(...)`
+
+This error occurs when you are trying to interact with a smart contract via an Private Execution Environment (PXE) that does not have the necessary information to execute a transaction.
+
+To execute a transaction, the PXE needs to know the complete address of a contract and contract artifacts.
+
+To address the error, add the contract to the PXE by calling [`pxe.addContracts(...)`](../../../aztec/concepts/pxe/index.md).
+
+#### `Simulation error: No public key registered for address 0x0. Register it by calling pxe.registerRecipient(...) or pxe.registerAccount(...)`
+
+This error occurs when your contract is trying to get a public key via the `get_public_key` oracle call, but the PXE does not have the Complete Address (Complete Address contains the public key).
+
+Your contract typically needs a note recipient's public key when it wants to send a note to because the public key is used to encrypt notes.
+
+:::info
+Manually adding the recipient to the PXE should not be required in case the recipient contract has already been deployed and the PXE is fully synced.
+This is because this information is submitted on-chain when the recipient contract is deployed.
+:::
+
+#### `Could not process note because of "Error: Unknown account.". Skipping note...`
+
+This error occurs when your contract is trying to get a secret via the `get_secret` oracle call, but the PXE does not have the secret for the public key.
+
+This error might occur when you register an account only as a recipient and not as an account.
+To address the error, register the account by calling `server.registerAccount(...)`.
+
+#### `Failed to solve brillig function 'self._is_some`
+
+You may encounter this error when trying to send a transaction that is using an invalid contract. The contract may compile without errors and you only encounter this when sending the transaction.
+
+This error may arise when function parameters are not properly formatted, when trying to "double-spend" a note, or it may indicate that there is a bug deeper in the stack (e.g. a bug in the Aztec.nr library or deeper). If you hit this error, double-check your contract implementation, but also consider [opening an issue (GitHub link)](https://github.com/AztecProtocol/aztec-packages/issues/new).
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/debugging/index.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/debugging/index.md
new file mode 100644
index 000000000000..f020a71f846a
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/debugging/index.md
@@ -0,0 +1,67 @@
+---
+title: Debugging
+sidebar_position: 1
+---
+
+## Logging in Aztec.nr
+
+On this section you can learn how to debug your Aztec.nr smart contracts and common errors that you may run into.
+
+You can log statements from Aztec.nr contracts that will show ups in the Sandbox.
+
+:::info
+
+The Noir standard library `std::println` function will not work in Aztec contracts. You must use the `debug_log` and `debug_log_format` defined below.
+
+:::
+
+### Import `debug_log`
+
+Import the `debug_log` dependency from Aztec oracles:
+
+```rust
+use dep::aztec::oracle::debug_log::{ debug_log };
+```
+
+### Write log
+
+Write `debug_log()` in the appropriate place in your contract.
+
+```rust
+debug_log("here");
+```
+
+Other methods for logging include:
+
+`debug_log_format()`: for logging Field values along arbitrary strings.
+
+```rust
+debug_log_format("get_2(slot:{0}) =>\n\t0:{1}\n\t1:{2}", [storage_slot, note0_hash, note1_hash]);
+```
+
+`debug_log_field()`: for logging Fields.
+
+```rust
+debug_log_field(my_field);
+```
+
+`debug_log_array()`: for logging array types.
+
+```rust
+debug_log_array(my_array);
+```
+
+### Start Sandbox in debug mode
+
+Set `LOG_LEVEL` to `verbose` or `debug`:
+
+```bash
+# Options are 'fatal', 'error', 'warn', 'info', 'verbose', 'debug', 'trace'
+LOG_LEVEL=debug aztec start --sandbox
+```
+
+and start the sandbox normally.
+
+You can specify different log levels for different services.
+
+For example: `LOG_LEVEL="verbose;info:sequencer"` will use verbose logging for everything except the `sequencer` service, which will use the `info` level.
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/debugging/sandbox-errors.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/debugging/sandbox-errors.md
new file mode 100644
index 000000000000..a43faed0196f
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/debugging/sandbox-errors.md
@@ -0,0 +1,200 @@
+---
+title: Aztec Sandbox Errors
+tags: [sandbox]
+---
+
+import Disclaimer from '@site/src/components/Disclaimers/\_wip_disclaimer.mdx';
+
+
+
+This section contains a list of errors you may encounter when using Aztec Sandbox and an explanation of each of them.
+
+## Circuit Errors
+
+**To prevent bloating this doc, here is a list of some of the common errors.**
+
+### Kernel Circuits
+
+We have several versions of public and private kernels as explained in [the circuits section in the concepts](../../../aztec/concepts/advanced/circuits/index.md). Certain things are only possible in certain versions of the circuits. So always ensure that the right version is being used for proof generation. For example, there is a specific version of the public kernel that only works if the previous kernel iteration was a private kernel. Similarly there is one that only works if the previous kernel was public.
+
+Remember that for each function call (i.e. each item in the call stack), there is a new kernel iteration that gets run.
+
+#### 2002 - PRIVATE_KERNEL\_\_INVALID_CONTRACT_ADDRESS
+
+Cannot call contract at address(0x0) privately.
+This error may also happen when you deploy a new contract and the contract data hash is inconsistent to the expected contract address.
+
+#### 2005 - PRIVATE_KERNEL\_\_NEW_NOTE_HASHES_PROHIBITED_IN_STATIC_CALL
+
+For static calls, new note hashes aren't allowed
+
+#### 2006 - PRIVATE_KERNEL\_\_NEW_NULLIFIERS_PROHIBITED_IN_STATIC_CALL
+
+For static calls, new nullifiers aren't allowed
+
+#### 2009 - PRIVATE_KERNEL\_\_NON_PRIVATE_FUNCTION_EXECUTED_WITH_PRIVATE_KERNEL
+
+You cannot execute a public Aztec.nr function in the private kernel
+
+#### 2011 - PRIVATE_KERNEL\_\_UNSUPPORTED_OP
+
+You are trying to do something that is currently unsupported in the private kernel. If this is a blocker feel free to open up an issue on our monorepo [aztec-packages (GitHub link)](https://github.com/AztecProtocol/aztec-packages/tree/master) or reach out to us on discord
+
+Note that certain operations are unsupported on certain versions of the private kernel. Eg static calls are allowed for all but the initial iteration of the private kernel (which initializes the kernel for subsequent function calls).
+
+#### 2012 - PRIVATE_KERNEL\_\_CONTRACT_ADDRESS_MISMATCH
+
+For the initial iteration of the private kernel, only the expected Aztec.nr contract should be the entrypoint. Static and delegate calls are not allowed in the initial iteration.
+
+#### 2013 - PRIVATE_KERNEL\_\_NON_PRIVATE_KERNEL_VERIFIED_WITH_PRIVATE_KERNEL
+
+The previous kernel iteration within the private kernel must also be private
+
+#### 2014 - PRIVATE_KERNEL\_\_CONSTRUCTOR_EXECUTED_IN_RECURSION
+
+A constructor must be executed as the first tx in the recursion i.e. a constructor call must be the first item in the call stack i.e. it can be executed in the first kernel iteration but not in subsequent ones. This also means you can't have a contract deploy another contract yet on Aztec.
+
+#### 2017 - PRIVATE_KERNEL\_\_USER_INTENT_MISMATCH_BETWEEN_TX_REQUEST_AND_CALL_STACK_ITEM
+
+Confirms that the TxRequest (user's intent) matches the private call being executed. This error may happen when:
+
+- origin address of tx_request doesn't match call_stack_item's contract_address
+- tx_request.function_data doesn't match call_stack_item.function_data
+- Aztec.nr function args passed to tx_request doesn't match args in the call_stack_item
+
+#### 2018 - PRIVATE_KERNEL\_\_READ_REQUEST_NOTE_HASH_TREE_ROOT_MISMATCH
+
+Given a read request and provided witness, we check that the merkle root obtained from the witness' sibling path and it's leaf is similar to the historical state root we want to read against. This is a sanity check to ensure we are reading from the right state.
+For a non transient read, we fetch the merkle root from the membership witnesses and the leaf index
+
+#### 2019 - PRIVATE_KERNEL\_\_TRANSIENT_READ_REQUEST_NO_MATCH
+
+A pending note hash is the one that is not yet added to note hash tree.
+A transient read is when we try to "read" a pending note hash.
+This error happens when you try to read a pending note hash that doesn't exist.
+
+#### 2021 - PRIVATE_KERNEL\_\_UNRESOLVED_NON_TRANSIENT_READ_REQUEST
+
+For a transient read request we skip merkle membership checks since pending note hashes aren't inserted into the note hash tree yet.
+But for non transient reads, we do a merkle membership check. Reads are done at the kernel circuit. So this checks that there are no already unresolved reads from a previous kernel iteration (other than non transient ones).
+
+#### 3001 - PUBLIC_KERNEL\_\_UNSUPPORTED_OP
+
+You are trying to do something that is currently unsupported in the public kernel. If this is a blocker feel free to open up an issue on our monorepo [aztec-packages (GitHub link)](https://github.com/AztecProtocol/aztec-packages/tree/master) or reach out to us on discord
+
+#### 3002 - PUBLIC_KERNEL\_\_PRIVATE_FUNCTION_NOT_ALLOWED
+
+Calling a private Aztec.nr function in a public kernel is not allowed.
+
+#### 3005 - PUBLIC_KERNEL\_\_NON_EMPTY_PRIVATE_CALL_STACK
+
+Public functions are executed after all the private functions are (see [private-public execution](../../../aztec/smart_contracts/functions/public_private_calls.md)). As such, private call stack must be empty when executing in the public kernel.
+
+#### 3011 - PUBLIC_KERNEL\_\_CALCULATED_PRIVATE_CALL_HASH_AND_PROVIDED_PRIVATE_CALL_HASH_MISMATCH
+
+When the hash stored at the top most of the call stack is different to the call stack item expected by the public kernel's inputs.
+
+#### 3012 - PUBLIC_KERNEL\_\_PUBLIC_CALL_STACK_MISMATCH
+
+Similar to above, except here we actually have the preimages to the call stack and hash to ensure they match.
+
+#### 3013 - PUBLIC_KERNEL\_\_CONTRACT_DEPLOYMENT_NOT_ALLOWED
+
+Public kernel doesn't allow contract deployments
+
+#### 3014 - PUBLIC_KERNEL\_\_CONSTRUCTOR_NOT_ALLOWED
+
+Aztec doesn't support public constructors.
+
+#### 3015 - PUBLIC_KERNEL\_\_CONTRACT_ADDRESS_INVALID
+
+Calling `address(0x0)` publicly is not permitted.
+
+#### 3016 - PUBLIC_KERNEL\_\_FUNCTION_SIGNATURE_INVALID
+
+Cannot call a contract with no function (i.e. function signature of 0) publicly.
+
+#### 3022 - PUBLIC_KERNEL\_\_PUBLIC_CALL_STACK_CONTRACT_STORAGE_UPDATES_PROHIBITED_FOR_STATIC_CALL
+
+For static calls, no contract storage change requests are allowed.
+
+#### 3024 - PUBLIC_KERNEL\_\_CALL_CONTEXT_CONTRACT_STORAGE_UPDATE_REQUESTS_PROHIBITED_FOR_STATIC_CALL
+
+Same as [3022](#3022---public_kernel__public_call_stack_contract_storage_updates_prohibited_for_static_call), no contract changes are allowed for static calls.
+
+#### 3026 - PUBLIC_KERNEL\_\_NOTE_HASHES_PROHIBITED_IN_STATIC_CALL
+
+For static calls, no new note hashes or nullifiers can be added to the state.
+
+#### 3027 - PUBLIC_KERNEL\_\_NEW_NULLIFIERS_PROHIBITED_IN_STATIC_CALL
+
+For static calls, no new note hashes or nullifiers can be added to the state.
+
+### Rollup circuit errors
+
+These are errors that occur when kernel proofs (transaction proofs) are sent to the rollup circuits to create an L2 block. See [rollup circuits](../../../aztec/concepts/advanced/circuits/rollup_circuits/index.md) for more information.
+
+#### 4007 - BASE\_\_INVALID_CHAIN_ID
+
+The L1 chain ID you used in your proof generation (for your private transaction) is different to what the rollup circuits expected. Double check against the global variables passed to noir and the config set in [Aztec's rollup contract (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/master/l1-contracts/src/core/Rollup.sol) which are [read in by sequencer GitHub link](https://github.com/AztecProtocol/aztec-packages/blob/master/yarn-project/sequencer-client/src/global_variable_builder/global_builder.ts#L32) and subsequently passed in as inputs to the base rollup. When the sequencer submits the block to the rollup contracts, this is again sanity checked so ensure this is the same everywhere.
+
+#### 4008 - BASE\_\_INVALID_VERSION
+
+Same as [section 4007](#4007---base__invalid_chain_id) except the `version` refers to the version of the Aztec L2 instance.
+
+Some scary bugs like `4003 - BASE__INVALID_NULLIFIER_SUBTREE` and `4004 - BASE__INVALID_NULLIFIER_RANGE` which are to do malformed nullifier trees (see [Indexed Merkle Trees](../../../aztec/concepts/advanced/storage/indexed_merkle_tree.mdx)) etc may seem unrelated at a glance, but at a closer look may be because of some bug in an application's Aztec.nr code. Same is true for certain instances of `7008 - MEMBERSHIP_CHECK_FAILED`.
+
+### Generic circuit errors
+
+#### 7009 - ARRAY_OVERFLOW
+
+Circuits work by having a fixed size array. As such, we have limits on how many UTXOs can be created (aka "commitments") or destroyed/nullified (aka "nullifiers") in a transaction. Similarly we have limits on many reads or writes you can do, how many contracts you can create in a transaction. This error typically says that you have reached the current limits of what you can do in a transaction. Some examples when you may hit this error are:
+
+- too many new note hashes in one tx
+- too many new nullifiers in one tx
+ - Note: Nullifiers may be created even outside the context of your Aztec.nr code. Eg, when creating a contract, we add a nullifier for its address to prevent same address from ever occurring. Similarly, we add a nullifier for your transaction hash too.
+- too many private function calls in one tx (i.e. call stack size exceeded)
+- too many public function calls in one tx (i.e. call stack size exceeded)
+- too many new L2 to L1 messages in one tx
+- too many contracts created in one tx
+- too many public data update requests in one tx
+- too many public data reads in one tx
+- too many transient read requests in one tx
+- too many transient read request membership witnesses in one tx
+
+You can have a look at our current constants/limitations in [constants.nr (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/master/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr)
+
+#### 7008 - MEMBERSHIP_CHECK_FAILED
+
+Users may create a proof against a historical state in Aztec. The rollup circuits performs a merkle membership check to ensure this state existed at some point. If the historical state doesn't exist, you get this error. Some examples when you may hit this error are:
+
+- using invalid historical note hash tree state (aka historical commitments tree)
+- using invalid historical contracts data tree state
+- using invalid historical L1 to L2 message data tree state
+- inserting a subtree into the greater tree
+ - we make a smaller merkle tree of all the new note hashes/nullifiers etc that were created in a transaction or in a rollup and add it to the bigger state tree. Before inserting, we do a merkle membership check to ensure that the index to insert at is indeed an empty subtree (otherwise we would be overwriting state). This can happen when `next_available_leaf_index` in the state tree's snapshot is wrong (it is fetched by the sequencer from the archiver). The error message should reveal which tree is causing this issue
+ - nullifier tree related errors - The nullifier tree uses an [Indexed Merkle Tree](../../../aztec/concepts/advanced/storage/indexed_merkle_tree.mdx). It requires additional data from the archiver to know which is the nullifier in the tree that is just below the current nullifier before it can perform batch insertion. If the low nullifier is wrong, or the nullifier is in incorrect range, you may receive this error.
+
+---
+
+## Archiver Errors
+
+- "No non-nullified L1 to L2 message found for message hash \$\{messageHash.toString()\}"/"Tried to consume nonexistent L1-to-L2 message" - happens when the L1 to L2 message doesn't exist or is "pending", when the user has sent a message on L1 via the Inbox contract but it has yet to be included in an L2 block by the sequencer - the user has to wait for enough blocks to progress and for the archiver to sync the respective L2 block. You can get the sequencer to pick it up by doing 2 arbitrary transactions on L2 (eg. send DAI to yourself 2 times). This would give the sequencer a transaction to process and as a side effect it would consume 2 subtrees of new messages from the Inbox contract. 2 subtrees need to be consumed and not just 1 because there is a 1 block lag to prevent the subtree from changing when the sequencer is proving.
+
+- "Block number mismatch: expected \$\{l2BlockNum\} but got \$\{block.number\}" - The archiver keeps track of the next expected L2 block number. It throws this error if it got a different one when trying to sync with the rollup contract's events on L1.
+
+## Sequencer Errors
+
+- "\$\{treeName\} tree root mismatch" - The sequencer validates that the root of the tree matches the output of the circuit simulation. The tree name could be Public data tree, Note Hash Tree, Contract tree, Nullifier tree or the L1ToL2Message tree,
+
+- "\$\{treeName\} tree next available leaf index mismatch" - validating a tree's root is not enough. It also checks that the `next_available_leaf_index` is as expected. This is the next index we can insert new values into. Note that for the public data tree, this test is skipped since as it is a sparse tree unlike the others.
+
+- "Public call stack size exceeded" - In Aztec, the sequencer executes all enqueued public functions in a transaction (to prevent race conditions - see [private-public execution](../../../aztec/smart_contracts/functions/public_private_calls.md)). This error says there are too many public functions requested.
+
+- "Array size exceeds target length" - happens if you add more items than allowed by the constants set due to our circuit limitations (eg sending too many L2 to L1 messages or creating a function that exceeds the call stack length or returns more values than what Aztec.nr functions allow)
+
+- "Failed to publish block" - Happens when sequencer tries to submit its L2 block + proof to the rollup contract.
+
+## L1 Aztec Contract Errors
+
+Aztec's L1 contracts use custom errors in solidity. While it saves gas, it has a side effect of making it harder to decode when things go wrong. If you get an error when submitting an L2Block into our rollup contract or when interacting with our Inbox/Outbox contracts, you can use the [Errors.sol library (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/master/l1-contracts/src/core/libraries/Errors.sol) to match the hex encoded error to the error name.
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/_category_.json b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/_category_.json
new file mode 100644
index 000000000000..e51f342c74a7
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/_category_.json
@@ -0,0 +1,6 @@
+{
+ "label": "Developer Environment",
+ "position": 0,
+ "collapsible": true,
+ "collapsed": true
+}
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/cheat_codes.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/cheat_codes.md
new file mode 100644
index 000000000000..6d5f5a539299
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/cheat_codes.md
@@ -0,0 +1,558 @@
+---
+title: Cheat Codes
+tags: [sandbox]
+sidebar_position: 4
+---
+
+import Disclaimer from "@site/src/components/Disclaimers/\_wip_disclaimer.mdx";
+
+## Introduction
+
+To help with testing, the sandbox is shipped with a set of cheatcodes.
+
+Cheatcodes allow you to change the time of the Aztec block, load certain state or more easily manipulate Ethereum instead of having to write dedicated RPC calls to anvil or hardhat.
+
+:::info Prerequisites
+If you aren't familiar with [Anvil (Foundry)](https://book.getfoundry.sh/anvil/), we recommend reading up on that since Aztec Sandbox uses Anvil as the local Ethereum instance.
+:::
+
+### Aims
+
+The guide will cover how to manipulate the state of the:
+
+- Ethereum blockchain;
+- Aztec network.
+
+### Dependencies
+
+For this guide, the following Aztec packages are used:
+
+- @aztec/aztec.js
+
+### Initialization
+
+```ts
+import { createPXEClient, CheatCodes } from "@aztec/aztec.js";
+const pxeRpcUrl = "http://localhost:8080";
+const ethRpcUrl = "http://localhost:8545";
+const pxe = createPXEClient(pxeRpcUrl);
+const cc = await CheatCodes.create(ethRpcUrl, pxe);
+```
+
+There are two properties of the CheatCodes class - `eth` and `aztec` for cheatcodes relating to the Ethereum blockchain (L1) and the Aztec network (L2) respectively.
+
+## Ethereum related cheatcodes
+
+These are cheatcodes exposed from anvil/hardhat conveniently wrapped for ease of use in the Sandbox.
+
+### Interface
+
+```ts
+// Fetch current block number of Ethereum
+public async blockNumber(): Promise
+
+// Fetch chain ID of the local Ethereum instance
+public async chainId(): Promise
+
+// Fetch current timestamp on Ethereum
+public async timestamp(): Promise
+
+// Mine a given number of blocks on Ethereum. Mines 1 block by default
+public async mine(numberOfBlocks = 1): Promise
+
+// Set the timestamp for the next block on Ethereum.
+public async setNextBlockTimestamp(timestamp: number): Promise
+
+// Dumps the current Ethereum chain state to a given file.
+public async dumpChainState(fileName: string): Promise
+
+// Loads the Ethereum chain state from a file. You may use `dumpChainState()` to save the state of the Ethereum chain to a file and later load it.
+public async loadChainState(fileName: string): Promise
+
+// Load the value at a storage slot of a contract address on Ethereum
+public async load(contract: EthAddress, slot: bigint): Promise
+
+// Set the value at a storage slot of a contract address on Ethereum (e.g. modify a storage variable on your portal contract or even the rollup contract).
+public async store(contract: EthAddress, slot: bigint, value: bigint): Promise
+
+// Computes the slot value for a given map and key on Ethereum. A convenient wrapper to find the appropriate storage slot to load or overwrite the state.
+public keccak256(baseSlot: bigint, key: bigint): bigint
+
+// Let you send transactions on Ethereum impersonating an externally owned or contract, without knowing the private key.
+public async startImpersonating(who: EthAddress): Promise
+
+// Stop impersonating an account on Ethereum that you are currently impersonating.
+public async stopImpersonating(who: EthAddress): Promise
+
+// Set the bytecode for a Ethereum contract
+public async etch(contract: EthAddress, bytecode: `0x${string}`): Promise
+
+// Get the bytecode for a Ethereum contract
+public async getBytecode(contract: EthAddress): Promise<`0x${string}`>
+```
+
+### blockNumber
+
+#### Function Signature
+
+```ts
+public async blockNumber(): Promise
+```
+
+#### Description
+
+Fetches the current Ethereum block number.
+
+#### Example
+
+```ts
+const blockNumber = await cc.eth.blockNumber();
+```
+
+### chainId
+
+#### Function Signature
+
+```ts
+public async chainId(): Promise
+```
+
+#### Description
+
+Fetches the Ethereum chain ID
+
+#### Example
+
+```ts
+const chainId = await cc.eth.chainId();
+```
+
+### timestamp
+
+#### Function Signature
+
+```ts
+public async timestamp(): Promise
+```
+
+#### Description
+
+Fetches the current Ethereum timestamp.
+
+#### Example
+
+```ts
+const timestamp = await cc.eth.timestamp();
+```
+
+### mine
+
+#### Function Signature
+
+```ts
+public async mine(numberOfBlocks = 1): Promise
+```
+
+#### Description
+
+Mines the specified number of blocks on Ethereum (default 1).
+
+#### Example
+
+```ts
+const blockNum = await cc.eth.blockNumber();
+await cc.eth.mine(10); // mines 10 blocks
+const newBlockNum = await cc.eth.blockNumber(); // = blockNum + 10.
+```
+
+### setNextBlockTimestamp
+
+#### Function Signature
+
+```ts
+public async setNextBlockTimestamp(timestamp: number): Promise
+```
+
+#### Description
+
+Sets the timestamp (unix format in seconds) for the next mined block on Ethereum.
+Time can only be set in the future.
+If you set the timestamp to a time in the past, this method will throw an error.
+
+#### Example
+
+```ts
+// // Set next block timestamp to 16 Aug 2023 10:54:30 GMT
+await cc.eth.setNextBlockTimestamp(1692183270);
+// next transaction you will do will have the timestamp as 1692183270
+```
+
+### dumpChainState
+
+#### Function Signature
+
+```ts
+public async dumpChainState(fileName: string): Promise
+```
+
+#### Description
+
+Dumps the current Ethereum chain state to a file.
+Stores a hex string representing the complete state of the chain in a file with the provided path. Can be re-imported into a fresh/restarted instance of Anvil to reattain the same state.
+When combined with `loadChainState()` cheatcode, it can be let you easily import the current state of mainnet into the Anvil instance of the sandbox.
+
+#### Example
+
+```ts
+await cc.eth.dumpChainState("chain-state.json");
+```
+
+### loadChainState
+
+#### Function Signature
+
+```ts
+public async loadChainState(fileName: string): Promise
+```
+
+#### Description
+
+Loads the Ethereum chain state from a file which contains a hex string representing an Ethereum state.
+When given a file previously written to by `cc.eth.dumpChainState()`, it merges the contents into the current chain state. Will overwrite any colliding accounts/storage slots.
+
+#### Example
+
+```ts
+await cc.eth.loadChainState("chain-state.json");
+```
+
+### load
+
+#### Function Signature
+
+```ts
+public async load(contract: EthAddress, slot: bigint): Promise
+```
+
+#### Description
+
+Loads the value at a storage slot of a Ethereum contract.
+
+#### Example
+
+```solidity
+contract LeetContract {
+ uint256 private leet = 1337; // slot 0
+}
+```
+
+```ts
+const leetContractAddress = EthAddress.fromString("0x1234...");
+const value = await cc.eth.load(leetContractAddress, BigInt(0));
+console.log(value); // 1337
+```
+
+### store
+
+#### Function Signature
+
+```ts
+public async store(contract: EthAddress, slot: bigint, value: bigint): Promise
+```
+
+#### Description
+
+Stores the value in storage slot on a Ethereum contract.
+
+#### Example
+
+```solidity
+contract LeetContract {
+ uint256 private leet = 1337; // slot 0
+}
+```
+
+```ts
+const leetContractAddress = EthAddress.fromString("0x1234...");
+await cc.eth.store(leetContractAddress, BigInt(0), BigInt(1000));
+const value = await cc.eth.load(leetContractAddress, BigInt(0));
+console.log(value); // 1000
+```
+
+### keccak256
+
+#### Function Signature
+
+```ts
+public keccak256(baseSlot: bigint, key: bigint): bigint
+```
+
+#### Description
+
+Computes the storage slot for a map key.
+
+#### Example
+
+```solidity
+contract LeetContract {
+ uint256 private leet = 1337; // slot 0
+ mapping(address => uint256) public balances; // base slot 1
+}
+```
+
+```ts
+// find the storage slot for key `0xdead` in the balance map.
+const address = BigInt("0x000000000000000000000000000000000000dead");
+const slot = cc.eth.keccak256(1n, address);
+// store balance of 0xdead as 100
+await cc.eth.store(contractAddress, slot, 100n);
+```
+
+### startImpersonating
+
+#### Function Signature
+
+```ts
+public async startImpersonating(who: EthAddress): Promise
+```
+
+#### Description
+
+Start impersonating an Ethereum account.
+This allows you to use this address as a sender.
+
+#### Example
+
+```ts
+await cc.eth.startImpersonating(EthAddress.fromString(address));
+```
+
+### stopImpersonating
+
+#### Function Signature
+
+```ts
+public async stopImpersonating(who: EthAddress): Promise
+```
+
+#### Description
+
+Stop impersonating an Ethereum account.
+Stops an active impersonation started by startImpersonating.
+
+#### Example
+
+```ts
+await cc.eth.stopImpersonating(EthAddress.fromString(address));
+```
+
+### getBytecode
+
+#### Function Signature
+
+```ts
+public async getBytecode(contract: EthAddress): Promise<`0x${string}`>
+```
+
+#### Description
+
+Get the bytecode for an Ethereum contract.
+
+#### Example
+
+```ts
+const bytecode = await cc.eth.getBytecode(contract); // 0x6080604052348015610010...
+```
+
+### etch
+
+#### Function Signature
+
+```ts
+public async etch(contract: EthAddress, bytecode: `0x${string}`): Promise
+```
+
+#### Description
+
+Set the bytecode for an Ethereum contract.
+
+#### Example
+
+```ts
+const bytecode = `0x6080604052348015610010...`;
+await cc.eth.etch(contract, bytecode);
+console.log(await cc.eth.getBytecode(contract)); // 0x6080604052348015610010...
+```
+
+## Aztec related cheatcodes
+
+These are cheatcodes specific to manipulating the state of Aztec rollup.
+
+### Interface
+
+```ts
+// Get the current aztec block number
+public async blockNumber(): Promise
+
+// Set time of the next execution on aztec. It also modifies time on Ethereum for next execution and stores this time as the last rollup block on the rollup contract.
+public async warp(to: number): Promise
+
+// Loads the value stored at the given slot in the public storage of the given contract.
+public async loadPublic(who: AztecAddress, slot: Fr | bigint): Promise
+
+// Loads the value stored at the given slot in the private storage of the given contract.
+public async loadPrivate(owner: AztecAddress, contract: AztecAddress, slot: Fr | bigint): Promise
+
+// Computes the slot value for a given map and key.
+public computeSlotInMap(baseSlot: Fr | bigint, key: Fr | bigint): Fr
+```
+
+### blockNumber
+
+#### Function Signature
+
+```ts
+public async blockNumber(): Promise
+```
+
+#### Description
+
+Get the current aztec block number.
+
+#### Example
+
+```ts
+const blockNumber = await cc.aztec.blockNumber();
+```
+
+### warp
+
+#### Function Signature
+
+```ts
+public async warp(to: number): Promise
+```
+
+#### Description
+
+Sets the time on Ethereum and the time of the next block on Aztec.
+Like with the corresponding Ethereum cheatcode, time can only be set in the future, not the past.
+Otherwise, it will throw an error.
+
+#### Example
+
+```ts
+const timestamp = await cc.eth.timestamp();
+const newTimestamp = timestamp + 100_000_000;
+await cc.aztec.warp(newTimestamp);
+// any Aztec.nr contract calls that make use of current timestamp
+// and is executed in the next rollup block will now read `newTimestamp`
+```
+
+### computeSlotInMap
+
+#### Function Signature
+
+```ts
+public computeSlotInMap(baseSlot: Fr | bigint, key: Fr | bigint): Fr
+```
+
+#### Description
+
+Compute storage slot for a map key.
+The baseSlot is specified in the Aztec.nr contract.
+
+#### Example
+
+```rust
+#[storage]
+struct Storage {
+ balances: Map>,
+}
+
+contract Token {
+ ...
+}
+```
+
+```ts
+const slot = cc.aztec.computeSlotInMap(1n, key);
+```
+
+### loadPublic
+
+#### Function Signature
+
+```ts
+public async loadPublic(who: AztecAddress, slot: Fr | bigint): Promise
+```
+
+#### Description
+
+Loads the value stored at the given slot in the public storage of the given contract.
+
+Note: One Field element occupies a storage slot. Hence, structs with multiple field elements will be spread over multiple sequential slots. Using loadPublic will only load a single field of the struct (depending on the size of the attributes within it).
+
+#### Example
+
+```rust
+#[storage]
+struct Storage {
+ balances: Map>,
+}
+
+contract Token {
+ ...
+}
+```
+
+```ts
+const address = AztecAddress.fromString("0x123...");
+const slot = cc.aztec.computeSlotInMap(1n, key);
+const value = await cc.aztec.loadPublic(address, slot);
+```
+
+### loadPrivate
+
+#### Function Signature
+
+```ts
+public async loadPrivate(owner: AztecAddress, contract: AztecAddress, slot: Fr | bigint): Promise
+```
+
+#### Description
+
+Loads the value stored at the given slot in the private storage of the given contract.
+
+Note: One Field element occupies a storage slot. Hence, structs with multiple field elements will be spread over multiple sequential slots. Using loadPublic will only load a single field of the struct (depending on the size of the attributes within it).
+
+#### Example
+
+```typescript title="load_private_cheatcode" showLineNumbers
+const mintAmount = 100n;
+
+await mintTokensToPrivate(token, wallet, admin, mintAmount);
+await token.methods.sync_notes().simulate();
+
+const balancesAdminSlot = await cc.aztec.computeSlotInMap(TokenContract.storage.balances.slot, admin);
+
+// check if note was added to pending shield:
+const notes = await cc.aztec.loadPrivate(admin, token.address, balancesAdminSlot);
+
+// @note If you get pain for dinner, this guys is the reason.
+// Assuming that it is still testing the token contract, you need to look at the balances,
+// and then the type of note, currently a `UintNote` which stores fields: [owner, randomness, amount]
+const values = notes.map(note => note.items[2]);
+const balance = values.reduce((sum, current) => sum + current.toBigInt(), 0n);
+expect(balance).toEqual(mintAmount);
+```
+> Source code: yarn-project/end-to-end/src/e2e_cheat_codes.test.ts#L182-L199
+
+
+## Participate
+
+Keep up with the latest discussion and join the conversation in the [Aztec forum](https://discourse.aztec.network).
+
+You can also use the above link to request more cheatcodes.
+
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/cli_reference.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/cli_reference.md
new file mode 100644
index 000000000000..5b8ee8dca8c5
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/cli_reference.md
@@ -0,0 +1,375 @@
+---
+title: CLI Reference
+tags: [sandbox]
+sidebar_position: 2
+---
+
+:::warning
+
+`aztec-builder` and `aztec-sandbox` have been deprecated in favor of `aztec` CLI
+
+:::
+- [Start](#starting-and-testing)
+- [Accounts](#account-management)
+- [Contract deployments and interaction](#contract-deployment-and-interaction)
+- [Network and node info](#network-and-node-information)
+- [Querying](#transaction-and-block-querying)
+- [Logging](#logging-and-data-retrieval)
+- [Debugging](#development-and-debugging-tools)
+- [L1 contracts](#l1-contract-management)
+- [Utils](#utility-commands)
+
+## Starting and testing
+
+### start
+
+Initiates various Aztec modules. It can be used to start individual components or the entire Aztec Sandbox.
+
+```
+aztec start [options]
+```
+
+Options:
+- `-sb, --sandbox`: Starts the Aztec Sandbox.
+- `-p, --port `: Specifies the port to run Aztec on (default: 8080).
+- `-n, --node [options]`: Starts the Aztec Node with specified options.
+- `-px, --pxe [options]`: Starts the PXE (Private eXecution Environment) with specified options.
+- `-a, --archiver [options]`: Starts the Archiver with specified options.
+- `-s, --sequencer [options]`: Starts the Sequencer with specified options.
+- `-r, --prover [options]`: Starts the Prover Agent with specified options.
+- `-o, --prover-node [options]`: Starts the Prover Node with specified options.
+- `-p2p, --p2p-bootstrap [options]`: Starts the P2P Bootstrap node with specified options.
+- `-t, --txe [options]`: Starts the TXE (Transaction Execution Environment) with specified options.
+
+### test
+
+Runs tests written in contracts.
+
+```
+aztec test [options]
+```
+
+Options:
+- `--workdir `: Sets the working directory inside the container (default: current directory).
+- `-e, --env `: Set environment variables (can be used multiple times).
+- `--no-tty`: Run the container without a TTY.
+- `--rm`: Automatically remove the container when it exits.
+- `-i, --interactive`: Keep STDIN open even if not attached.
+- `-t, --tty`: Allocate a pseudo-TTY.
+
+## Account Management
+
+### create-account
+Creates an Aztec account for sending transactions.
+
+```
+aztec create-account [options]
+```
+
+Options:
+- `--skip-initialization`: Skip initializing the account contract.
+- `--public-deploy`: Publicly deploys the account and registers the class if needed.
+- `--private-key `: Private key for the account (uses random by default).
+- `--register-only`: Just register the account on the PXE without deploying.
+- `--no-wait`: Skip waiting for the contract deployment.
+
+### get-accounts
+Retrieves all Aztec accounts stored in the PXE.
+
+```
+aztec get-accounts [options]
+```
+
+Options:
+- `--json`: Emit output as JSON.
+
+### get-account
+Retrieves an account given its Aztec address.
+
+```
+aztec get-account [options]
+```
+
+### register-recipient
+Registers a recipient in the PXE.
+
+```
+aztec register-recipient [options]
+```
+
+Required options:
+- `-a, --address `: The account's Aztec address.
+- `-p, --public-key `: The account public key.
+- `-pa, --partial-address `: The partially computed address of the account contract.
+
+## Contract Deployment and Interaction
+
+### deploy
+Deploys a compiled Aztec.nr contract to Aztec.
+
+```
+aztec deploy [options]
+```
+
+Options:
+- `--init `: The contract initializer function to call (default: "constructor").
+- `--no-init`: Leave the contract uninitialized.
+- `-a, --args `: Contract constructor arguments.
+- `-k, --public-key `: Optional encryption public key for this address.
+- `-s, --salt `: Optional deployment salt for generating the deployment address.
+- `--universal`: Do not mix the sender address into the deployment.
+- `--json`: Emit output as JSON.
+- `--no-wait`: Skip waiting for the contract deployment.
+- `--no-class-registration`: Don't register this contract class.
+- `--no-public-deployment`: Don't emit this contract's public bytecode.
+
+### send
+Calls a function on an Aztec contract.
+
+```
+aztec send [options]
+```
+
+Options:
+- `-a, --args [functionArgs...]`: Function arguments.
+- `-c, --contract-artifact `: Compiled Aztec.nr contract's ABI.
+- `-ca, --contract-address `: Aztec address of the contract.
+- `--no-wait`: Print transaction hash without waiting for it to be mined.
+
+### call
+Simulates the execution of a view (read-only) function on a deployed contract.
+
+```
+aztec call [options]
+```
+
+Options:
+- `-a, --args [functionArgs...]`: Function arguments.
+- `-c, --contract-artifact `: Compiled Aztec.nr contract's ABI.
+- `-ca, --contract-address `: Aztec address of the contract.
+- `-f, --from `: Aztec address of the caller.
+
+### add-contract
+Adds an existing contract to the PXE.
+
+```
+aztec add-contract [options]
+```
+
+Required options:
+- `-c, --contract-artifact `: Compiled Aztec.nr contract's ABI.
+- `-ca, --contract-address `: Aztec address of the contract.
+- `--init-hash `: Initialization hash.
+
+Optional:
+- `--salt `: Optional deployment salt.
+- `-p, --public-key `: Optional public key for this contract.
+- `--portal-address `: Optional address to a portal contract on L1.
+- `--deployer-address `: Optional address of the contract deployer.
+
+## Network and Node Information
+
+### get-node-info
+Retrieves information about an Aztec node at a URL.
+
+```
+aztec get-node-info [options]
+```
+
+### get-pxe-info
+Retrieves information about a PXE at a URL.
+
+```
+aztec get-pxe-info [options]
+```
+
+### block-number
+Retrieves the current Aztec L2 block number.
+
+```
+aztec block-number [options]
+```
+
+## Transaction and Block Querying
+
+### get-tx
+Retrieves the receipt for a specified transaction hash.
+
+```
+aztec get-tx [options]
+```
+
+### get-block
+Retrieves information for a given block or the latest block.
+
+```
+aztec get-block [blockNumber] [options]
+```
+
+Options:
+- `-f, --follow`: Keep polling for new blocks.
+
+## Logging and Data Retrieval
+
+### get-logs
+Retrieves unencrypted logs based on filter parameters.
+
+```
+aztec get-logs [options]
+```
+
+Options:
+- `-tx, --tx-hash `: Transaction hash to get the receipt for.
+- `-fb, --from-block `: Initial block number for getting logs.
+- `-tb, --to-block `: Up to which block to fetch logs.
+- `-al --after-log `: ID of a log after which to fetch the logs.
+- `-ca, --contract-address `: Contract address to filter logs by.
+- `--follow`: Keep polling for new logs until interrupted.
+
+## Development and Debugging Tools
+
+### flamegraph
+Generates a flamegraph of the gate counts of a private function call.
+
+```
+[SERVE=1] aztec flamegraph
+```
+
+### codegen
+Validates and generates an Aztec Contract ABI from Noir ABI.
+
+```
+aztec codegen [options]
+```
+
+Options:
+- `-o, --outdir `: Output folder for the generated code.
+- `--force`: Force code generation even when the contract has not changed.
+
+### update
+Updates Nodejs and Noir dependencies.
+
+```
+aztec update [projectPath] [options]
+```
+
+Options:
+- `--contract [paths...]`: Paths to contracts to update dependencies.
+- `--aztec-version `: The version to update Aztec packages to (default: latest).
+
+### inspect-contract
+Shows a list of external callable functions for a contract.
+
+```
+aztec inspect-contract
+```
+
+### parse-parameter-struct
+Helper for parsing an encoded string into a contract's parameter struct.
+
+```
+aztec parse-parameter-struct [options]
+```
+
+Required options:
+- `-c, --contract-artifact `: Compiled Aztec.nr contract's ABI.
+- `-p, --parameter `: The name of the struct parameter to decode into.
+
+## L1 Contract Management
+
+### deploy-l1-contracts
+Deploys all necessary Ethereum contracts for Aztec.
+
+```
+aztec deploy-l1-contracts [options]
+```
+
+Required options:
+- `-u, --rpc-urls `: List of URLs of Ethereum nodes (comma separated).
+- `-pk, --private-key `: The private key to use for deployment.
+
+### deploy-l1-verifier
+Deploys the rollup verifier contract.
+
+```
+aztec deploy-l1-verifier [options]
+```
+
+Required options:
+- `--eth-rpc-urls `: List of URLs of Ethereum nodes (comma separated).
+- `-pk, --private-key `: The private key to use for deployment.
+- `--verifier `: Either 'mock' or 'real'.
+
+### bridge-fee-juice
+Bridges (and optionally mints) L1 Fee Juice and pushes them to L2.
+
+```
+aztec bridge-fee-juice [options]
+```
+
+Required option:
+- `--l1-rpc-urls `: List of URLs of Ethereum nodes (comma separated).
+
+### get-l1-balance
+Gets the balance of ETH or an ERC20 token on L1 for a given Ethereum address.
+
+```
+aztec get-l1-balance [options]
+```
+
+Required option:
+- `--l1-rpc-urls `: List of URLs of Ethereum nodes (comma separated).
+
+## Utility Commands
+
+### generate-keys
+Generates encryption and signing private keys.
+
+```
+aztec generate-keys [options]
+```
+
+Option:
+- `-m, --mnemonic`: Optional mnemonic string for private key generation.
+
+### generate-p2p-private-key
+Generates a LibP2P peer private key.
+
+```
+aztec generate-p2p-private-key
+```
+
+### example-contracts
+Lists the example contracts available to deploy from @aztec/noir-contracts.js.
+
+```
+aztec example-contracts
+```
+
+### compute-selector
+Computes a selector for a given function signature.
+
+```
+aztec compute-selector
+```
+
+### bootstrap
+Bootstraps the blockchain.
+
+```
+aztec bootstrap [options]
+```
+
+### sequencers
+Manages or queries registered sequencers on the L1 rollup contract.
+
+```
+aztec sequencers [who] [options]
+```
+
+Commands: list, add, remove, who-next
+
+Required option:
+- `--l1-rpc-urls `: List of URLs of Ethereum nodes (comma separated).
+
+Note: Most commands accept a `--rpc-url` option to specify the Aztec node URL, and many accept fee-related options for gas limit and price configuration.
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/cli_wallet_reference.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/cli_wallet_reference.md
new file mode 100644
index 000000000000..10c4d4f97829
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/cli_wallet_reference.md
@@ -0,0 +1,160 @@
+---
+title: CLI Wallet
+tags: [sandbox, wallet, cli]
+keywords: [wallet, cli wallet]
+sidebar_position: 3
+---
+
+For development, it may be useful to deploy, transact, or create notes in a non-programmatic way. You can use Aztec's CLI Wallet for thing such as:
+
+- Deploying contracts
+- Sending transactions
+- Bridging L1 "Fee Juice" into Aztec
+- Pushing arbitrary [notes](../../guides/smart_contracts/writing_contracts/notes/index.md) to your PXE
+- Creating [authwits](../../guides/smart_contracts/writing_contracts/authwit.md)
+- Aliasing info and secrets for further usage
+- Proving your transactions and profile gate counts
+
+:::info
+
+At any time, you can get an updated version of the existing commands and subcommands by adding `-h`. For example:
+
+```bash
+aztec-wallet create-account -h
+```
+
+:::
+
+## Aliases
+
+The CLI wallet makes extensive use of aliases, that is, when an address, artifact, secret, or other information is given a name that can be later used to reference it.
+
+Aliases have different types like `address` or `artifact` or `contract`. You can see a list of these types by running the help command `aztec-wallet alias -h`. You can then specify a type with the `:` character whenever needed. For example `accounts:master_yoda` or `artifacts:light_saber`.
+
+:::tip
+
+The wallet writes to the `last` alias if it's likely that you use that same alias in the next command.
+
+It will also try to determine which type is expected. For example, if the alias `master_yoda` is an account, you don't need to prepend `account:` if, for example, you're deploying a contract.
+
+You can create arbitrary aliases with the `alias` command. For example `aztec-wallet alias accounts test_alias 0x2c37902cdade7710bd2355e5949416dc5e43a16e0b13a5560854d2451d92d289`.
+
+:::
+
+## Account Management
+
+The wallet comes with some options for account deployment and management. You can register and deploy accounts, or only register them, and pass different options to serve your workflow.
+
+### create-account
+
+Generates a secret key and deploys an account contract.
+
+#### Example
+
+```bash
+aztec-wallet create-account -a master_yoda
+```
+
+### Deploy account
+
+Deploy an account that is already registered (i.e. your PXE knows about it) but not deployed. Most times you should pass an alias or address registered in the PXE by passing the `-f` or `--from` flag.
+
+#### Example
+
+```bash
+$ aztec-wallet create-account --register-only -a master_yoda
+...
+$ aztec-wallet deploy-account -f master_yoda
+```
+
+### Deploy
+
+You can deploy a [compiled contract](../../guides/smart_contracts/how_to_compile_contract.md) to the network.
+
+You probably want to look at flags such as `--init` which allows you to specify the [initializer function](../../guides/smart_contracts/writing_contracts/initializers.md) to call, or `-k` for the [encryption public key](../../../aztec/concepts/accounts/keys.md#incoming-viewing-keys) if the contract is expected to have notes being encrypted to it.
+
+You can pass arguments with the `--arg` flag.
+
+#### Example
+
+This example compiles the Jedi Code and deploys it from Master Yoda's account, initializing it with the parameter "Grand Master" and aliasing it to `jedi_order`. Notice how we can simply pass `master_yoda` in the `--from` flag (because `--from` always expects an account):
+
+```bash
+aztec-nargo compile
+aztec-wallet deploy ./target/jedi_code.nr --arg accounts:master_yoda --from master_yoda --alias jedi_order
+```
+
+### Send
+
+This command sends a transaction to the network by calling a contract's function. Just calling `aztec-wallet send` gives you a list of options, but you probably want to pass `--from` as the sender, `--contract-address` for your target's address, and `--args` if it requires arguments.
+
+#### Example
+
+```bash
+aztec-wallet send --from master_yoda --contract-address jedi_order --args "luke skywalker" train_jedi
+```
+
+Again, notice how it's not necessary to pass `contracts:jedi_order` as the wallet already knows that the only available type for `--contract-address` is a contract.
+
+### Manage authwits
+
+You can use the CLI wallet to quickly generate [Authentication Witnesses](../../guides/smart_contracts/writing_contracts/authwit.md). These allow you to authorize the caller to execute an action on behalf of an account. They get aliased into the `authwits` type.
+
+### In private
+
+The authwit management in private is a two-step process: create and add. It's not too different from a `send` command, but providing the caller that can privately execute the action on behalf of the caller.
+
+#### Example
+
+An example for authorizing an operator (ex. a DeFi protocol) to call the transfer_in_private action (transfer on the user's behalf):
+
+```bash
+aztec-wallet create-authwit transfer_in_private accounts:coruscant_trader -ca contracts:token --args accounts:jedi_master accounts:coruscant_trader 20 secrets:auth_nonce -f accounts:jedi_master -a secret_trade
+
+aztec-wallet add-authwit authwits:secret_trade accounts:jedi_master -f accounts:coruscant_trader
+```
+
+### In public
+
+A similar call to the above, but in public:
+
+```bash
+aztec-wallet authorize-action transfer_in_public accounts:coruscant_trader -ca contracts:token --args accounts:jedi_master accounts:coruscant_trader 20 secrets:auth_nonce -f accounts:jedi_master
+```
+
+### Simulate
+
+Simulates a transaction instead of sending it. This allows you to obtain i.e. the return value before sending the transaction.
+
+#### Example
+
+```bash
+aztec-wallet simulate --from master_yoda --contract-address jedi_order --args "luke_skywalker" train_jedi
+```
+
+### Profile
+
+This allows you to get the gate count of each private function in the transaction. Read more about profiling [here](../../guides/smart_contracts/profiling_transactions.md).
+
+#### Example
+
+```bash
+aztec-wallet profile --from master_yoda --contract-address jedi_order --args "luke_skywalker" train_jedi
+```
+
+### Bridge Fee Juice
+
+The wallet provides an easy way to mint the fee-paying asset on L1 and bridging it to L2. Current placeholder-name "fee juice".
+
+Using the sandbox, there's already a Fee Juice contract that manages this enshrined asset. You can optionally mint more Juice before bridging it.
+
+#### Example
+
+This example mints and bridges 1000 units of fee juice and bridges it to the `master_yoda` recipient on L2.
+
+```bash
+aztec-wallet bridge-fee-juice --mint 1000 master_yoda
+```
+
+## Proving
+You can prove a transaction using the aztec-wallet with a running sandbox. Follow the guide [here](../../guides/local_env/sandbox_proving.md#proving-with-aztec-wallet)
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/index.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/index.md
new file mode 100644
index 000000000000..669c0329faf6
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/index.md
@@ -0,0 +1,19 @@
+---
+title: Developer Environment
+tags: [sandbox]
+sidebar_position: 0
+---
+
+The Aztec Sandbox is an environment for local development on the Aztec Network. It's easy to get setup with just a single, simple command, and contains all the components needed to develop and test Aztec contracts and applications.
+
+## What's in the Sandbox?
+
+The sandbox contains a local Ethereum instance running [Anvil](https://book.getfoundry.sh/anvil/), a local instance of the Aztec rollup and an aztec private execution client for handling user transactions and state.
+
+These provide a self contained environment which deploys Aztec on a local (empty) Ethereum network, creates 3 smart contract wallet accounts on the rollup, and allows transactions to be processed on the local Aztec sequencer.
+
+The current sandbox does not generate or verify proofs, but provides a working end to end developer flow for writing and interacting with Aztec.nr smart contracts.
+
+## Command line tools
+
+Aztec-nargo and aztec CLI are command-line tool allowing you to compile smart contracts. See the [compiling contracts guide](../../guides/local_env/run_more_than_one_pxe_sandbox.md) for more information.
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/sandbox-reference.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/sandbox-reference.md
new file mode 100644
index 000000000000..c0519fc0c6b1
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/environment_reference/sandbox-reference.md
@@ -0,0 +1,166 @@
+---
+title: Sandbox Reference
+tags: [sandbox]
+sidebar_position: 1
+---
+
+:::tip
+
+For a quick start, follow the [guide](../../getting_started.md) to install the sandbox.
+
+:::
+
+## Environment Variables
+
+There are various environment variables you can use when running the whole sandbox or when running on of the available modes.
+
+**Sandbox**
+
+```sh
+LOG_LEVEL=debug # Options are 'fatal', 'error', 'warn', 'info', 'verbose', 'debug', 'trace'
+HOST_WORKDIR='${PWD}' # The location to store log outputs. Will use ~/.aztec where the binaries are stored by default.
+ETHEREUM_HOSTS=http://127.0.0.1:8545 # List of Ethereum JSON RPC URLs. We use an anvil instance that runs in parallel to the sandbox on docker by default.
+ANVIL_PORT=8545 # The port that docker will forward to the anvil instance (default: 8545)
+L1_CHAIN_ID=31337 # The Chain ID that the Ethereum host is using.
+TEST_ACCOUNTS='true' # Option to deploy 3 test account when sandbox starts. (default: true)
+MODE='sandbox' # Option to start the sandbox or a standalone part of the system. (default: sandbox)
+PXE_PORT=8080 # The port that the PXE will be listening to (default: 8080)
+AZTEC_NODE_PORT=8080 # The port that Aztec Node will be listening to (default: 8080)
+
+## Polling intervals ##
+ARCHIVER_POLLING_INTERVAL_MS=50
+P2P_BLOCK_CHECK_INTERVAL_MS=50
+SEQ_TX_POLLING_INTERVAL_MS=50
+WS_BLOCK_CHECK_INTERVAL_MS=50
+ARCHIVER_VIEM_POLLING_INTERVAL_MS=500
+```
+
+**Aztec Node**
+
+Variables like `DEPLOY_AZTEC_CONTRACTS` & `AZTEC_NODE_PORT` are valid here as described above.
+`TEST_ACCOUNTS` cannot be used here because the Aztec node does not control an Aztec account to deploy contracts from.
+
+```sh
+# P2P config #
+# Configuration variables for connecting a Node to the Aztec Node P2P network. You'll need a running P2P-Bootstrap node to connect to.
+P2P_ENABLED='false' # A flag to enable P2P networking for this node. (default: false)
+P2P_BLOCK_CHECK_INTERVAL_MS=100 # The frequency in which to check for new L2 blocks.
+P2P_PEER_CHECK_INTERVAL_MS=1000 # The frequency in which to check for peers.
+P2P_L2_BLOCK_QUEUE_SIZE=1000 # Size of queue of L2 blocks to store.
+P2P_IP='' # Announce IP of the peer. Defaults to working it out using discV5, otherwise set P2P_QUERY_FOR_IP if you are behind a NAT
+P2P_LISTEN_ADDR=0.0.0.0 # The address on which the P2P service should listen for connections.(default: 0.0.0.0)
+P2P_PORT=40400 # The Port that will be used for sending & listening p2p messages (default: 40400)
+PEER_ID_PRIVATE_KEY='' # An optional peer id private key. If blank, will generate a random key.
+BOOTSTRAP_NODES='' # A list of bootstrap peers to connect to, separated by commas
+P2P_ANNOUNCE_PORT='' # Port to announce to the p2p network
+P2P_NAT_ENABLED='false' # Whether to enable NAT from libp2p
+P2P_MAX_PEERS=100 # The maximum number of peers (a peer count above this will cause the node to refuse connection attempts)
+
+## Aztec Contract Addresses ##
+# When running a standalone node, you need to have deployed Aztec contracts on your Ethereum host, then declare their addresses as env variables.
+REGISTRY_CONTRACT_ADDRESS=0x01234567890abcde01234567890abcde
+INBOX_CONTRACT_ADDRESS=0x01234567890abcde01234567890abcde
+OUTBOX_CONTRACT_ADDRESS=0x01234567890abcde01234567890abcde
+ROLLUP_CONTRACT_ADDRESS=0x01234567890abcde01234567890abcde
+
+## Sequencer variables ##
+SEQ_PUBLISHER_PRIVATE_KEY=0x01234567890abcde01234567890abcde # Private key of an ethereum account that will be used by the sequencer to publish blocks.
+SEQ_MAX_TX_PER_BLOCK=32 # Maximum txs to go on a block. (default: 32)
+SEQ_MIN_TX_PER_BLOCK=1 # Minimum txs to go on a block. (default: 1)
+
+## Validator variables ##
+VALIDATOR_PRIVATE_KEY=0x01234567890abcde01234567890abcde # Private key of the ethereum account that will be used to perform validator duties
+```
+
+**PXE**
+
+Variables like `TEST_ACCOUNTS` & `PXE_PORT` are valid here as described above.
+
+```sh
+AZTEC_NODE_URL='http://localhost:8079' # The address of an Aztec Node URL that the PXE will connect to (default: http://localhost:8079)
+PXE_PORT=8080 # The port that the PXE will be listening to (default: 8080)
+TEST_ACCOUNTS='true' # Option to deploy 3 test account when sandbox starts. (default: true)
+PXE_L2_STARTING_BLOCK=1 # L2 Block to start synching the PXE from (default: 1)
+```
+
+**P2P Bootstrap Node**
+
+The P2P Bootstrap node is a standalone app whose purpose is to assist new P2P network participants in acquiring peers.
+
+```sh
+PEER_ID_PRIVATE_KEY='' # The private key to be used by the peer for secure communications with other peers. This key will also be used to derive the Peer ID.
+P2P_IP='' # Announce IP of the peer. Defaults to working it out using discV5, otherwise set P2P_QUERY_FOR_IP if you are behind a NAT
+P2P_LISTEN_ADDR=0.0.0.0 # The address on which the P2P service should listen for connections.(default: 0.0.0.0)
+P2P_PORT=40400 # The Port that will be used for sending & listening p2p messages (default: 40400)
+```
+
+## Cheat Codes
+
+To help with testing, the sandbox is shipped with a set of cheatcodes.
+
+Cheatcodes allow you to change the time of the Aztec block, load certain state or more easily manipulate Ethereum instead of having to write dedicated RPC calls to anvil or hardhat.
+
+You can find the cheat code reference [here](./cheat_codes.md).
+
+## Contracts
+
+We have shipped a number of example contracts in the `@aztec/noir-contracts.js` [npm package](https://www.npmjs.com/package/@aztec/noir-contracts.js). This is included with the sandbox by default so you are able to use these contracts to test with.
+
+```bash
+AppSubscriptionContractArtifact
+AuthContractArtifact
+BenchmarkingContractArtifact
+CardGameContractArtifact
+ChildContractArtifact
+ClaimContractArtifact
+ContractClassRegistererContractArtifact
+ContractInstanceDeployerContractArtifact
+CounterContractArtifact
+CrowdfundingContractArtifact
+DocsExampleContractArtifact
+EasyPrivateTokenContractArtifact
+EasyPrivateVotingContractArtifact
+EcdsaAccountContractArtifact
+EscrowContractArtifact
+FPCContractArtifact
+FeeJuiceContractArtifact
+ImportTestContractArtifact
+LendingContractArtifact
+MultiCallEntrypointContractArtifact
+ParentContractArtifact
+PendingNoteHashesContractArtifact
+PriceFeedContractArtifact
+ReaderContractArtifact
+SchnorrAccountContractArtifact
+SchnorrHardcodedAccountContractArtifact
+SchnorrSingleKeyAccountContractArtifact
+SlowTreeContractArtifact
+StatefulTestContractArtifact
+TestContractArtifact
+TokenBlacklistContractArtifact
+TokenBridgeContractArtifact
+TokenContractArtifact
+UniswapContractArtifact
+```
+
+> Source code: /yarn-project/end-to-end/src/composed/cli_docs_sandbox.test.ts#L95-L118
+
+You can see all of our example contracts in the monorepo [here (GitHub link)](https://github.com/AztecProtocol/aztec-packages/tree/master/noir-projects/noir-contracts/contracts).
+
+## Running Aztec PXE / Node / P2P-Bootstrap node individually
+
+If you wish to run components of the Aztec network stack separately, you can use the `aztec start` command with various options for enabling components.
+
+```bash
+aztec start --node [nodeOptions] --pxe [pxeOptions] --archiver [archiverOptions] --sequencer [sequencerOptions] --prover [proverOptions] --p2p-bootstrap [p2pOptions]
+```
+
+Starting the aztec node alongside a PXE, sequencer or archiver, will attach the components to the node. Eg if you want to run a PXE separately to a node, you can [read this guide](../../guides/local_env/run_more_than_one_pxe_sandbox.md).
+
+## Update the sandbox
+
+To update the sandbox, run:
+
+```bash
+aztec-up
+```
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/_category_.json b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/_category_.json
new file mode 100644
index 000000000000..968f9bcf0a6b
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/_category_.json
@@ -0,0 +1,6 @@
+{
+ "label": "Smart Contract Reference",
+ "position": 1,
+ "collapsible": true,
+ "collapsed": true
+}
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/address-note/address_note.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/address-note/address_note.md
new file mode 100644
index 000000000000..e16195153664
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/address-note/address_note.md
@@ -0,0 +1,23 @@
+# AddressNote
+
+## Fields
+| Field | Type |
+| --- | --- |
+| address | AztecAddress |
+| owner | AztecAddress |
+| randomness | Field |
+
+## Methods
+
+### new
+
+```rust
+AddressNote::new(address, owner);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+| owner | AztecAddress |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/account.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/account.md
new file mode 100644
index 000000000000..0fcca4b241f4
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/account.md
@@ -0,0 +1,43 @@
+## Standalone Functions
+
+### init
+
+```rust
+init(context, is_valid_impl, Field);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | Context |
+| is_valid_impl | fn(&mut PrivateContext |
+| Field | |
+
+### entrypoint
+
+```rust
+entrypoint(self, app_payload, fee_payload, cancellable);
+```
+
+docs:start:entrypoint
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| app_payload | AppPayload |
+| fee_payload | FeePayload |
+| cancellable | bool |
+
+### verify_private_authwit
+
+```rust
+verify_private_authwit(self, inner_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| inner_hash | Field |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/auth.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/auth.md
new file mode 100644
index 000000000000..468b57445dd2
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/auth.md
@@ -0,0 +1,138 @@
+## Standalone Functions
+
+### assert_current_call_valid_authwit
+
+```rust
+assert_current_call_valid_authwit(context, on_behalf_of);
+```
+
+docs:start:assert_current_call_valid_authwit
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PrivateContext |
+| on_behalf_of | AztecAddress |
+
+### assert_inner_hash_valid_authwit
+
+```rust
+assert_inner_hash_valid_authwit(context, on_behalf_of, inner_hash, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PrivateContext |
+| on_behalf_of | AztecAddress |
+| inner_hash | Field |
+| | |
+
+### assert_current_call_valid_authwit_public
+
+```rust
+assert_current_call_valid_authwit_public(context, on_behalf_of, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PublicContext |
+| on_behalf_of | AztecAddress |
+| | |
+
+### assert_inner_hash_valid_authwit_public
+
+```rust
+assert_inner_hash_valid_authwit_public(context, on_behalf_of, inner_hash, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PublicContext |
+| on_behalf_of | AztecAddress |
+| inner_hash | Field |
+| | |
+
+### compute_authwit_message_hash_from_call
+
+```rust
+compute_authwit_message_hash_from_call(caller, consumer, chain_id, version, selector, args, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| caller | AztecAddress |
+| consumer | AztecAddress |
+| chain_id | Field |
+| version | Field |
+| selector | FunctionSelector |
+| args | [Field; N] |
+| | |
+
+### compute_inner_authwit_hash
+
+```rust
+compute_inner_authwit_hash(args);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| args | [Field; N] |
+
+### compute_authwit_nullifier
+
+```rust
+compute_authwit_nullifier(on_behalf_of, inner_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| on_behalf_of | AztecAddress |
+| inner_hash | Field |
+
+### compute_authwit_message_hash
+
+```rust
+compute_authwit_message_hash(consumer, chain_id, version, inner_hash, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| consumer | AztecAddress |
+| chain_id | Field |
+| version | Field |
+| inner_hash | Field |
+| | |
+
+### set_authorized
+
+```rust
+set_authorized(context, message_hash, authorize, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PublicContext |
+| message_hash | Field |
+| authorize | bool |
+| | |
+
+### set_reject_all
+
+```rust
+set_reject_all(context, reject);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PublicContext |
+| reject | bool |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/auth_witness.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/auth_witness.md
new file mode 100644
index 000000000000..11338206f5cd
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/auth_witness.md
@@ -0,0 +1,24 @@
+## Standalone Functions
+
+### get_auth_witness_oracle
+
+```rust
+get_auth_witness_oracle(_message_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _message_hash | Field |
+
+### get_auth_witness
+
+```rust
+get_auth_witness(message_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| message_hash | Field |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/cheatcodes.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/cheatcodes.md
new file mode 100644
index 000000000000..5203a24f03fa
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/cheatcodes.md
@@ -0,0 +1,30 @@
+## Standalone Functions
+
+### add_private_authwit_from_call_interface
+
+```rust
+add_private_authwit_from_call_interface(on_behalf_of, caller, call_interface, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| on_behalf_of | AztecAddress |
+| caller | AztecAddress |
+| call_interface | C |
+| | |
+
+### add_public_authwit_from_call_interface
+
+```rust
+add_public_authwit_from_call_interface(on_behalf_of, caller, call_interface, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| on_behalf_of | AztecAddress |
+| caller | AztecAddress |
+| call_interface | C |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/entrypoint/app.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/entrypoint/app.md
new file mode 100644
index 000000000000..2a7c2659fee5
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/entrypoint/app.md
@@ -0,0 +1,48 @@
+# AppPayload
+
+## Fields
+| Field | Type |
+| --- | --- |
+| function_calls | FunctionCall; ACCOUNT_MAX_CALLS] |
+| pub nonce | Field |
+
+## Methods
+
+### to_be_bytes
+
+Serializes the payload as an array of bytes. Useful for hashing with sha256.
+
+```rust
+AppPayload::to_be_bytes(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### execute_calls
+
+```rust
+AppPayload::execute_calls(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+
+## Standalone Functions
+
+### hash
+
+```rust
+hash(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/entrypoint/fee.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/entrypoint/fee.md
new file mode 100644
index 000000000000..b72c0ab0ecb2
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/entrypoint/fee.md
@@ -0,0 +1,47 @@
+# FeePayload
+
+## Fields
+| Field | Type |
+| --- | --- |
+| function_calls | FunctionCall; MAX_FEE_FUNCTION_CALLS] |
+| nonce | Field |
+| is_fee_payer | bool |
+
+## Methods
+
+### to_be_bytes
+
+```rust
+FeePayload::to_be_bytes(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### execute_calls
+
+```rust
+FeePayload::execute_calls(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+
+## Standalone Functions
+
+### hash
+
+```rust
+hash(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/entrypoint/function_call.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/entrypoint/function_call.md
new file mode 100644
index 000000000000..57848a06db89
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/authwit/entrypoint/function_call.md
@@ -0,0 +1,24 @@
+# FunctionCall
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub args_hash | Field, /* args_hash is calldata_hash if is_public is true */ |
+| pub function_selector | FunctionSelector |
+| pub target_address | AztecAddress |
+| pub is_public | bool |
+| pub is_static | bool |
+
+## Methods
+
+### to_be_bytes
+
+```rust
+FunctionCall::to_be_bytes(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/capsules/mod.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/capsules/mod.md
new file mode 100644
index 000000000000..3ba9d4ad3c6f
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/capsules/mod.md
@@ -0,0 +1,137 @@
+## Standalone Functions
+
+### at
+
+```rust
+at(contract_address, base_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| base_slot | Field |
+
+### len
+
+```rust
+len(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### push
+
+```rust
+push(self, value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| value | T |
+
+### get
+
+```rust
+get(self, index);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| index | u32 |
+
+### remove
+
+```rust
+remove(self, index);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| index | u32 |
+
+### slot_at
+
+```rust
+slot_at(self, index);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| index | u32 |
+
+### setup
+
+```rust
+setup();
+```
+
+Takes no parameters.
+
+### empty_array
+
+```rust
+empty_array();
+```
+
+Takes no parameters.
+
+### empty_array_read
+
+```rust
+empty_array_read();
+```
+
+Takes no parameters.
+
+### array_push
+
+```rust
+array_push();
+```
+
+Takes no parameters.
+
+### read_past_len
+
+```rust
+read_past_len();
+```
+
+Takes no parameters.
+
+### array_remove_last
+
+```rust
+array_remove_last();
+```
+
+Takes no parameters.
+
+### array_remove_some
+
+```rust
+array_remove_some();
+```
+
+Takes no parameters.
+
+### array_remove_all
+
+```rust
+array_remove_all();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/call_interfaces.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/call_interfaces.md
new file mode 100644
index 000000000000..a0d2bd0f914c
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/call_interfaces.md
@@ -0,0 +1,897 @@
+## Standalone Functions
+
+### get_args
+
+```rust
+get_args(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_selector
+
+```rust
+get_selector(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_name
+
+```rust
+get_name(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_contract_address
+
+```rust
+get_contract_address(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_is_static
+
+```rust
+get_is_static(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### new
+
+```rust
+new(target_contract, selector, name, args, is_static, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| target_contract | AztecAddress |
+| selector | FunctionSelector |
+| name | str<N> |
+| args | [Field] |
+| is_static | bool |
+| | |
+
+### call
+
+```rust
+call(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+
+### view
+
+```rust
+view(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+
+### get_args
+
+```rust
+get_args(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_selector
+
+```rust
+get_selector(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_name
+
+```rust
+get_name(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_contract_address
+
+```rust
+get_contract_address(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_is_static
+
+```rust
+get_is_static(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### new
+
+```rust
+new(target_contract, selector, name, args, is_static, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| target_contract | AztecAddress |
+| selector | FunctionSelector |
+| name | str<N> |
+| args | [Field] |
+| is_static | bool |
+| | |
+
+### call
+
+```rust
+call(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+
+### view
+
+```rust
+view(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+
+### get_args
+
+```rust
+get_args(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_selector
+
+```rust
+get_selector(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_name
+
+```rust
+get_name(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_contract_address
+
+```rust
+get_contract_address(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_is_static
+
+```rust
+get_is_static(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### new
+
+```rust
+new(target_contract, selector, name, args, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| target_contract | AztecAddress |
+| selector | FunctionSelector |
+| name | str<N> |
+| args | [Field] |
+| | |
+
+### view
+
+```rust
+view(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+
+### get_args
+
+```rust
+get_args(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_selector
+
+```rust
+get_selector(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_name
+
+```rust
+get_name(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_contract_address
+
+```rust
+get_contract_address(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_is_static
+
+```rust
+get_is_static(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### new
+
+```rust
+new(target_contract, selector, name, args, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| target_contract | AztecAddress |
+| selector | FunctionSelector |
+| name | str<N> |
+| args | [Field] |
+| | |
+
+### view
+
+```rust
+view(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+
+### get_args
+
+```rust
+get_args(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_selector
+
+```rust
+get_selector(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_name
+
+```rust
+get_name(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_contract_address
+
+```rust
+get_contract_address(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_is_static
+
+```rust
+get_is_static(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### new
+
+```rust
+new(target_contract, selector, name, args, is_static, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| target_contract | AztecAddress |
+| selector | FunctionSelector |
+| name | str<N> |
+| args | [Field] |
+| is_static | bool |
+| | |
+
+### with_gas
+
+```rust
+with_gas(self, gas_opts);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | &mut Self |
+| gas_opts | GasOpts |
+
+### call
+
+```rust
+call(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PublicContext |
+
+### view
+
+```rust
+view(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PublicContext |
+
+### enqueue
+
+```rust
+enqueue(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+
+### enqueue_view
+
+```rust
+enqueue_view(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+
+### get_args
+
+```rust
+get_args(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_selector
+
+```rust
+get_selector(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_name
+
+```rust
+get_name(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_contract_address
+
+```rust
+get_contract_address(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_is_static
+
+```rust
+get_is_static(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### new
+
+```rust
+new(target_contract, selector, name, args, is_static, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| target_contract | AztecAddress |
+| selector | FunctionSelector |
+| name | str<N> |
+| args | [Field] |
+| is_static | bool |
+| | |
+
+### with_gas
+
+```rust
+with_gas(self, gas_opts);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | &mut Self |
+| gas_opts | GasOpts |
+
+### call
+
+```rust
+call(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PublicContext |
+
+### view
+
+```rust
+view(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PublicContext |
+
+### enqueue
+
+```rust
+enqueue(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+
+### enqueue_view
+
+```rust
+enqueue_view(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+
+### set_as_teardown
+
+```rust
+set_as_teardown(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+
+### get_args
+
+```rust
+get_args(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_selector
+
+```rust
+get_selector(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_name
+
+```rust
+get_name(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_contract_address
+
+```rust
+get_contract_address(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_is_static
+
+```rust
+get_is_static(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### new
+
+```rust
+new(target_contract, selector, name, args, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| target_contract | AztecAddress |
+| selector | FunctionSelector |
+| name | str<N> |
+| args | [Field] |
+| | |
+
+### with_gas
+
+```rust
+with_gas(self, gas_opts);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | &mut Self |
+| gas_opts | GasOpts |
+
+### view
+
+```rust
+view(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PublicContext |
+
+### enqueue_view
+
+```rust
+enqueue_view(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+
+### get_args
+
+```rust
+get_args(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_selector
+
+```rust
+get_selector(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_name
+
+```rust
+get_name(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_contract_address
+
+```rust
+get_contract_address(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_is_static
+
+```rust
+get_is_static(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### new
+
+```rust
+new(target_contract, selector, name, args, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| target_contract | AztecAddress |
+| selector | FunctionSelector |
+| name | str<N> |
+| args | [Field] |
+| | |
+
+### with_gas
+
+```rust
+with_gas(self, gas_opts);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | &mut Self |
+| gas_opts | GasOpts |
+
+### view
+
+```rust
+view(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PublicContext |
+
+### enqueue_view
+
+```rust
+enqueue_view(self, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+
+### get_args
+
+```rust
+get_args(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_selector
+
+```rust
+get_selector(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_name
+
+```rust
+get_name(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_contract_address
+
+```rust
+get_contract_address(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_is_static
+
+```rust
+get_is_static(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/gas.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/gas.md
new file mode 100644
index 000000000000..cc183e086f42
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/gas.md
@@ -0,0 +1,30 @@
+# GasOpts
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub l2_gas | Option<Field> |
+| pub da_gas | Option<Field> |
+
+## Methods
+
+### default
+
+```rust
+GasOpts::default();
+```
+
+Takes no parameters.
+
+### new
+
+```rust
+GasOpts::new(l2_gas, da_gas);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| l2_gas | Field |
+| da_gas | Field |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/inputs/private_context_inputs.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/inputs/private_context_inputs.md
new file mode 100644
index 000000000000..b9c4f97350ad
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/inputs/private_context_inputs.md
@@ -0,0 +1,22 @@
+# PrivateContextInputs
+
+PrivateContextInputs are expected to be provided to each private function
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub call_context | CallContext |
+| pub historical_header | BlockHeader |
+| pub tx_context | TxContext |
+| pub start_side_effect_counter | u32 |
+
+## Standalone Functions
+
+### empty
+
+```rust
+empty();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/private_context.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/private_context.md
new file mode 100644
index 000000000000..fc67b1569921
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/private_context.md
@@ -0,0 +1,554 @@
+# PrivateContext
+
+When finished, one can call .finish() to convert back to the abi
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub inputs | PrivateContextInputs |
+| pub side_effect_counter | u32 |
+| pub min_revertible_side_effect_counter | u32 |
+| pub is_fee_payer | bool |
+| pub args_hash | Field |
+| pub return_hash | Field |
+| pub max_block_number | MaxBlockNumber |
+| pub note_hash_read_requests | BoundedVec<ReadRequest, MAX_NOTE_HASH_READ_REQUESTS_PER_CALL> |
+| pub nullifier_read_requests | BoundedVec<ReadRequest, MAX_NULLIFIER_READ_REQUESTS_PER_CALL> |
+| key_validation_requests_and_generators | BoundedVec<KeyValidationRequestAndGenerator, MAX_KEY_VALIDATION_REQUESTS_PER_CALL> |
+| pub note_hashes | BoundedVec<NoteHash, MAX_NOTE_HASHES_PER_CALL> |
+| pub nullifiers | BoundedVec<Nullifier, MAX_NULLIFIERS_PER_CALL> |
+| pub private_call_requests | BoundedVec<PrivateCallRequest, MAX_PRIVATE_CALL_STACK_LENGTH_PER_CALL> |
+| pub public_call_requests | BoundedVec<Counted<PublicCallRequest>, MAX_ENQUEUED_CALLS_PER_CALL> |
+| pub public_teardown_call_request | PublicCallRequest |
+| pub l2_to_l1_msgs | BoundedVec<L2ToL1Message, MAX_L2_TO_L1_MSGS_PER_CALL> |
+| pub historical_header | BlockHeader |
+| pub private_logs | BoundedVec<PrivateLogData, MAX_PRIVATE_LOGS_PER_CALL> |
+| pub contract_class_logs_hashes | BoundedVec<LogHash, MAX_CONTRACT_CLASS_LOGS_PER_CALL> |
+| pub last_key_validation_requests | Option<KeyValidationRequest>; NUM_KEY_TYPES] |
+
+## Methods
+
+### new
+
+```rust
+PrivateContext::new(inputs, args_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| inputs | PrivateContextInputs |
+| args_hash | Field |
+
+### msg_sender
+
+```rust
+PrivateContext::msg_sender(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### this_address
+
+```rust
+PrivateContext::this_address(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### chain_id
+
+```rust
+PrivateContext::chain_id(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### version
+
+```rust
+PrivateContext::version(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### gas_settings
+
+```rust
+PrivateContext::gas_settings(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### selector
+
+```rust
+PrivateContext::selector(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_args_hash
+
+```rust
+PrivateContext::get_args_hash(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### push_note_hash
+
+```rust
+PrivateContext::push_note_hash(&mut self, note_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| note_hash | Field |
+
+### push_nullifier
+
+```rust
+PrivateContext::push_nullifier(&mut self, nullifier);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| nullifier | Field |
+
+### push_nullifier_for_note_hash
+
+```rust
+PrivateContext::push_nullifier_for_note_hash(&mut self, nullifier, nullified_note_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| nullifier | Field |
+| nullified_note_hash | Field |
+
+### get_block_header
+
+Returns the header of a block whose state is used during private execution (not the block the transaction is included in).
+
+```rust
+PrivateContext::get_block_header(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_block_header_at
+
+Returns the header of an arbitrary block whose block number is less than or equal to the block number of historical header.
+
+```rust
+PrivateContext::get_block_header_at(self, block_number);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| block_number | u32 |
+
+### set_return_hash
+
+```rust
+PrivateContext::set_return_hash(&mut self, returns_hasher);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| returns_hasher | ArgsHasher |
+
+### finish
+
+```rust
+PrivateContext::finish(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### set_as_fee_payer
+
+```rust
+PrivateContext::set_as_fee_payer(&mut self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+
+### end_setup
+
+```rust
+PrivateContext::end_setup(&mut self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+
+### set_tx_max_block_number
+
+```rust
+PrivateContext::set_tx_max_block_number(&mut self, max_block_number);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| max_block_number | u32 |
+
+### push_note_hash_read_request
+
+```rust
+PrivateContext::push_note_hash_read_request(&mut self, note_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| note_hash | Field |
+
+### push_nullifier_read_request
+
+```rust
+PrivateContext::push_nullifier_read_request(&mut self, nullifier);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| nullifier | Field |
+
+### request_nsk_app
+
+```rust
+PrivateContext::request_nsk_app(&mut self, npk_m_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| npk_m_hash | Field |
+
+### request_ovsk_app
+
+```rust
+PrivateContext::request_ovsk_app(&mut self, ovpk_m_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| ovpk_m_hash | Field |
+
+### request_sk_app
+
+```rust
+PrivateContext::request_sk_app(&mut self, pk_m_hash, key_index);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| pk_m_hash | Field |
+| key_index | Field |
+
+### message_portal
+
+```rust
+PrivateContext::message_portal(&mut self, recipient, content);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| recipient | EthAddress |
+| content | Field |
+
+### consume_l1_to_l2_message
+
+```rust
+PrivateContext::consume_l1_to_l2_message(&mut self, content, secret, sender, leaf_index, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| content | Field |
+| secret | Field |
+| sender | EthAddress |
+| leaf_index | Field |
+| | |
+
+### emit_private_log
+
+```rust
+PrivateContext::emit_private_log(&mut self, log);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| log | [Field; PRIVATE_LOG_SIZE_IN_FIELDS] |
+
+### emit_raw_note_log
+
+```rust
+PrivateContext::emit_raw_note_log(&mut self, log, note_hash_counter, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| log | [Field; PRIVATE_LOG_SIZE_IN_FIELDS] |
+| note_hash_counter | u32 |
+| | |
+
+### call_private_function
+
+```rust
+PrivateContext::call_private_function(&mut self, contract_address, function_selector, args, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| contract_address | AztecAddress |
+| function_selector | FunctionSelector |
+| args | [Field; ARGS_COUNT] |
+| | |
+
+### static_call_private_function
+
+```rust
+PrivateContext::static_call_private_function(&mut self, contract_address, function_selector, args, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| contract_address | AztecAddress |
+| function_selector | FunctionSelector |
+| args | [Field; ARGS_COUNT] |
+| | |
+
+### call_private_function_no_args
+
+```rust
+PrivateContext::call_private_function_no_args(&mut self, contract_address, function_selector, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| contract_address | AztecAddress |
+| function_selector | FunctionSelector |
+| | |
+
+### static_call_private_function_no_args
+
+```rust
+PrivateContext::static_call_private_function_no_args(&mut self, contract_address, function_selector, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| contract_address | AztecAddress |
+| function_selector | FunctionSelector |
+| | |
+
+### call_private_function_with_args_hash
+
+```rust
+PrivateContext::call_private_function_with_args_hash(&mut self, contract_address, function_selector, args_hash, is_static_call, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| contract_address | AztecAddress |
+| function_selector | FunctionSelector |
+| args_hash | Field |
+| is_static_call | bool |
+| | |
+
+### call_public_function
+
+```rust
+PrivateContext::call_public_function(&mut self, contract_address, function_selector, args, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| contract_address | AztecAddress |
+| function_selector | FunctionSelector |
+| args | [Field; ARGS_COUNT] |
+| | |
+
+### static_call_public_function
+
+```rust
+PrivateContext::static_call_public_function(&mut self, contract_address, function_selector, args, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| contract_address | AztecAddress |
+| function_selector | FunctionSelector |
+| args | [Field; ARGS_COUNT] |
+| | |
+
+### call_public_function_no_args
+
+```rust
+PrivateContext::call_public_function_no_args(&mut self, contract_address, function_selector, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| contract_address | AztecAddress |
+| function_selector | FunctionSelector |
+| | |
+
+### static_call_public_function_no_args
+
+```rust
+PrivateContext::static_call_public_function_no_args(&mut self, contract_address, function_selector, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| contract_address | AztecAddress |
+| function_selector | FunctionSelector |
+| | |
+
+### call_public_function_with_calldata_hash
+
+```rust
+PrivateContext::call_public_function_with_calldata_hash(&mut self, contract_address, calldata_hash, is_static_call, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| contract_address | AztecAddress |
+| calldata_hash | Field |
+| is_static_call | bool |
+| | |
+
+### set_public_teardown_function
+
+```rust
+PrivateContext::set_public_teardown_function(&mut self, contract_address, function_selector, args, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| contract_address | AztecAddress |
+| function_selector | FunctionSelector |
+| args | [Field; ARGS_COUNT] |
+| | |
+
+### set_public_teardown_function_with_calldata_hash
+
+```rust
+PrivateContext::set_public_teardown_function_with_calldata_hash(&mut self, contract_address, calldata_hash, is_static_call, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| contract_address | AztecAddress |
+| calldata_hash | Field |
+| is_static_call | bool |
+| | |
+
+### next_counter
+
+```rust
+PrivateContext::next_counter(&mut self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+
+## Standalone Functions
+
+### empty
+
+```rust
+empty();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/public_context.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/public_context.md
new file mode 100644
index 000000000000..e1704da2fb49
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/public_context.md
@@ -0,0 +1,818 @@
+# PublicContext
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub args_hash | Option<Field> |
+| pub compute_args_hash | fn() -> Field |
+
+## Methods
+
+### new
+
+```rust
+PublicContext::new(compute_args_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| compute_args_hash | fn( |
+
+### emit_public_log
+
+```rust
+PublicContext::emit_public_log(_self, log);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | &mut Self |
+| log | T |
+
+### note_hash_exists
+
+```rust
+PublicContext::note_hash_exists(_self, note_hash, leaf_index);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+| note_hash | Field |
+| leaf_index | Field |
+
+### l1_to_l2_msg_exists
+
+```rust
+PublicContext::l1_to_l2_msg_exists(_self, msg_hash, msg_leaf_index);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+| msg_hash | Field |
+| msg_leaf_index | Field |
+
+### nullifier_exists
+
+```rust
+PublicContext::nullifier_exists(_self, unsiloed_nullifier, address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+| unsiloed_nullifier | Field |
+| address | AztecAddress |
+
+### consume_l1_to_l2_message
+
+```rust
+PublicContext::consume_l1_to_l2_message(&mut self, content, secret, sender, leaf_index, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| content | Field |
+| secret | Field |
+| sender | EthAddress |
+| leaf_index | Field |
+| | |
+
+### message_portal
+
+```rust
+PublicContext::message_portal(_self, recipient, content);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | &mut Self |
+| recipient | EthAddress |
+| content | Field |
+
+### call_public_function
+
+```rust
+PublicContext::call_public_function(_self, contract_address, function_selector, args, gas_opts, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | &mut Self |
+| contract_address | AztecAddress |
+| function_selector | FunctionSelector |
+| args | [Field] |
+| gas_opts | GasOpts |
+| | |
+
+### static_call_public_function
+
+```rust
+PublicContext::static_call_public_function(_self, contract_address, function_selector, args, gas_opts, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | &mut Self |
+| contract_address | AztecAddress |
+| function_selector | FunctionSelector |
+| args | [Field] |
+| gas_opts | GasOpts |
+| | |
+
+### push_note_hash
+
+```rust
+PublicContext::push_note_hash(_self, note_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | &mut Self |
+| note_hash | Field |
+
+### push_nullifier
+
+```rust
+PublicContext::push_nullifier(_self, nullifier);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | &mut Self |
+| nullifier | Field |
+
+### this_address
+
+```rust
+PublicContext::this_address(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### msg_sender
+
+```rust
+PublicContext::msg_sender(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### selector
+
+```rust
+PublicContext::selector(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### get_args_hash
+
+```rust
+PublicContext::get_args_hash(mut self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| mut self | |
+
+### transaction_fee
+
+```rust
+PublicContext::transaction_fee(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### chain_id
+
+```rust
+PublicContext::chain_id(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### version
+
+```rust
+PublicContext::version(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### block_number
+
+```rust
+PublicContext::block_number(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### timestamp
+
+```rust
+PublicContext::timestamp(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### fee_per_l2_gas
+
+```rust
+PublicContext::fee_per_l2_gas(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### fee_per_da_gas
+
+```rust
+PublicContext::fee_per_da_gas(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### l2_gas_left
+
+```rust
+PublicContext::l2_gas_left(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### da_gas_left
+
+```rust
+PublicContext::da_gas_left(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### is_static_call
+
+```rust
+PublicContext::is_static_call(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### raw_storage_read
+
+```rust
+PublicContext::raw_storage_read(_self, storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+| storage_slot | Field |
+
+### storage_read
+
+```rust
+PublicContext::storage_read(self, storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| storage_slot | Field |
+
+### raw_storage_write
+
+```rust
+PublicContext::raw_storage_write(_self, storage_slot, values);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+| storage_slot | Field |
+| values | [Field; N] |
+
+### storage_write
+
+```rust
+PublicContext::storage_write(self, storage_slot, value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| storage_slot | Field |
+| value | T |
+
+## Standalone Functions
+
+### gas_for_call
+
+```rust
+gas_for_call(user_gas);
+```
+
+Helper functions
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| user_gas | GasOpts |
+
+### address
+
+```rust
+address();
+```
+
+Takes no parameters.
+
+### sender
+
+```rust
+sender();
+```
+
+Takes no parameters.
+
+### emit_note_hash
+
+```rust
+emit_note_hash(note_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| note_hash | Field |
+
+### emit_nullifier
+
+```rust
+emit_nullifier(nullifier);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| nullifier | Field |
+
+### send_l2_to_l1_msg
+
+```rust
+send_l2_to_l1_msg(recipient, content);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| recipient | EthAddress |
+| content | Field |
+
+### call
+
+```rust
+call(gas, address, args);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| gas | [Field; 2] |
+| address | AztecAddress |
+| args | [Field] |
+
+### call_static
+
+```rust
+call_static(gas, address, args);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| gas | [Field; 2] |
+| address | AztecAddress |
+| args | [Field] |
+
+### calldata_copy
+
+```rust
+calldata_copy(cdoffset, copy_size);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| cdoffset | u32 |
+| copy_size | u32 |
+
+### success_copy
+
+```rust
+success_copy();
+```
+
+Takes no parameters.
+
+### returndata_size
+
+```rust
+returndata_size();
+```
+
+Takes no parameters.
+
+### returndata_copy
+
+```rust
+returndata_copy(rdoffset, copy_size);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| rdoffset | u32 |
+| copy_size | u32 |
+
+### avm_return
+
+```rust
+avm_return(returndata);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| returndata | [Field] |
+
+### avm_revert
+
+```rust
+avm_revert(revertdata);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| revertdata | [Field] |
+
+### empty
+
+```rust
+empty();
+```
+
+Takes no parameters.
+
+### address_opcode
+
+```rust
+address_opcode();
+```
+
+Takes no parameters.
+
+### sender_opcode
+
+```rust
+sender_opcode();
+```
+
+Takes no parameters.
+
+### transaction_fee_opcode
+
+```rust
+transaction_fee_opcode();
+```
+
+Takes no parameters.
+
+### chain_id_opcode
+
+```rust
+chain_id_opcode();
+```
+
+Takes no parameters.
+
+### version_opcode
+
+```rust
+version_opcode();
+```
+
+Takes no parameters.
+
+### block_number_opcode
+
+```rust
+block_number_opcode();
+```
+
+Takes no parameters.
+
+### timestamp_opcode
+
+```rust
+timestamp_opcode();
+```
+
+Takes no parameters.
+
+### fee_per_l2_gas_opcode
+
+```rust
+fee_per_l2_gas_opcode();
+```
+
+Takes no parameters.
+
+### fee_per_da_gas_opcode
+
+```rust
+fee_per_da_gas_opcode();
+```
+
+Takes no parameters.
+
+### l2_gas_left_opcode
+
+```rust
+l2_gas_left_opcode();
+```
+
+Takes no parameters.
+
+### da_gas_left_opcode
+
+```rust
+da_gas_left_opcode();
+```
+
+Takes no parameters.
+
+### is_static_call_opcode
+
+```rust
+is_static_call_opcode();
+```
+
+Takes no parameters.
+
+### note_hash_exists_opcode
+
+```rust
+note_hash_exists_opcode(note_hash, leaf_index);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| note_hash | Field |
+| leaf_index | Field |
+
+### emit_note_hash_opcode
+
+```rust
+emit_note_hash_opcode(note_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| note_hash | Field |
+
+### nullifier_exists_opcode
+
+```rust
+nullifier_exists_opcode(nullifier, address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| nullifier | Field |
+| address | Field |
+
+### emit_nullifier_opcode
+
+```rust
+emit_nullifier_opcode(nullifier);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| nullifier | Field |
+
+### emit_public_log_opcode
+
+```rust
+emit_public_log_opcode(message);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| message | [Field] |
+
+### l1_to_l2_msg_exists_opcode
+
+```rust
+l1_to_l2_msg_exists_opcode(msg_hash, msg_leaf_index);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| msg_hash | Field |
+| msg_leaf_index | Field |
+
+### send_l2_to_l1_msg_opcode
+
+```rust
+send_l2_to_l1_msg_opcode(recipient, content);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| recipient | EthAddress |
+| content | Field |
+
+### calldata_copy_opcode
+
+```rust
+calldata_copy_opcode(cdoffset, copy_size);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| cdoffset | u32 |
+| copy_size | u32 |
+
+### returndata_size_opcode
+
+```rust
+returndata_size_opcode();
+```
+
+Takes no parameters.
+
+### returndata_copy_opcode
+
+```rust
+returndata_copy_opcode(rdoffset, copy_size);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| rdoffset | u32 |
+| copy_size | u32 |
+
+### return_opcode
+
+```rust
+return_opcode(returndata);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| returndata | [Field] |
+
+### revert_opcode
+
+```rust
+revert_opcode(revertdata);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| revertdata | [Field] |
+
+### call_opcode
+
+```rust
+call_opcode(gas, // gas allocation, da_gas]
+ address, args, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| gas | [Field; 2] |
+| // gas allocation | [l2_gas |
+| da_gas]
+ address | AztecAddress |
+| args | [Field] |
+| | |
+
+### call_static_opcode
+
+```rust
+call_static_opcode(gas, // gas allocation, da_gas]
+ address, args, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| gas | [Field; 2] |
+| // gas allocation | [l2_gas |
+| da_gas]
+ address | AztecAddress |
+| args | [Field] |
+| | |
+
+### success_copy_opcode
+
+```rust
+success_copy_opcode();
+```
+
+Takes no parameters.
+
+### storage_read_opcode
+
+```rust
+storage_read_opcode(storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| storage_slot | Field |
+
+### storage_write_opcode
+
+```rust
+storage_write_opcode(storage_slot, value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| storage_slot | Field |
+| value | Field |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/returns_hash.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/returns_hash.md
new file mode 100644
index 000000000000..e63203400cc9
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/returns_hash.md
@@ -0,0 +1,55 @@
+# ReturnsHash
+
+## Fields
+| Field | Type |
+| --- | --- |
+| hash | Field |
+
+## Methods
+
+### new
+
+```rust
+ReturnsHash::new(hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| hash | Field |
+
+### assert_empty
+
+```rust
+ReturnsHash::assert_empty(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### raw
+
+```rust
+ReturnsHash::raw(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_preimage
+
+/ This is only used during private execution, since in public it is the VM itself that keeps track of return / values.
+
+```rust
+ReturnsHash::get_preimage(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/unconstrained_context.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/unconstrained_context.md
new file mode 100644
index 000000000000..76606c164b35
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/context/unconstrained_context.md
@@ -0,0 +1,112 @@
+# UnconstrainedContext
+
+## Fields
+| Field | Type |
+| --- | --- |
+| block_number | u32 |
+| contract_address | AztecAddress |
+| version | Field |
+| chain_id | Field |
+
+## Methods
+
+### new
+
+```rust
+UnconstrainedContext::new();
+```
+
+Takes no parameters.
+
+### at
+
+```rust
+UnconstrainedContext::at(contract_address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+
+### at_historical
+
+```rust
+UnconstrainedContext::at_historical(contract_address, block_number);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| block_number | u32 |
+
+### block_number
+
+```rust
+UnconstrainedContext::block_number(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### this_address
+
+```rust
+UnconstrainedContext::this_address(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### version
+
+```rust
+UnconstrainedContext::version(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### chain_id
+
+```rust
+UnconstrainedContext::chain_id(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### raw_storage_read
+
+```rust
+UnconstrainedContext::raw_storage_read(self, storage_slot, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | Self |
+| storage_slot | Field |
+| | |
+
+### storage_read
+
+```rust
+UnconstrainedContext::storage_read(self, storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| storage_slot | Field |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/deploy.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/deploy.md
new file mode 100644
index 000000000000..b250ece82dd1
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/deploy.md
@@ -0,0 +1,16 @@
+## Standalone Functions
+
+### deploy_contract
+
+```rust
+deploy_contract(context, target);
+```
+
+Calls `deploy` on the deployer contract to deploy a new instance.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PrivateContext |
+| target | AztecAddress |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/discovery/mod.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/discovery/mod.md
new file mode 100644
index 000000000000..44476bc58c20
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/discovery/mod.md
@@ -0,0 +1,23 @@
+# NoteHashAndNullifier
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub note_hash | Field |
+| pub inner_nullifier | Field |
+
+## Standalone Functions
+
+### discover_new_messages
+
+```rust
+discover_new_messages(contract_address, compute_note_hash_and_nullifier, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| compute_note_hash_and_nullifier | ComputeNoteHashAndNullifier<Env> |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/discovery/nonce_discovery.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/discovery/nonce_discovery.md
new file mode 100644
index 000000000000..953255258568
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/discovery/nonce_discovery.md
@@ -0,0 +1,33 @@
+# DiscoveredNoteInfo
+
+/ A struct with the discovered information of a complete note, required for delivery to PXE. Note that this is *not* / the complete note information, since it does not include content, storage slot, etc.
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub nonce | Field |
+| pub note_hash | Field |
+| pub inner_nullifier | Field |
+
+## Standalone Functions
+
+### attempt_note_nonce_discovery
+
+```rust
+attempt_note_nonce_discovery(unique_note_hashes_in_tx, MAX_NOTE_HASHES_PER_TX>, first_nullifier_in_tx, compute_note_hash_and_nullifier, contract_address, storage_slot, note_type_id, packed_note, MAX_NOTE_PACKED_LEN>, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| unique_note_hashes_in_tx | BoundedVec<Field |
+| MAX_NOTE_HASHES_PER_TX> | |
+| first_nullifier_in_tx | Field |
+| compute_note_hash_and_nullifier | ComputeNoteHashAndNullifier<Env> |
+| contract_address | AztecAddress |
+| storage_slot | Field |
+| note_type_id | Field |
+| packed_note | BoundedVec<Field |
+| MAX_NOTE_PACKED_LEN> | |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/discovery/partial_notes.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/discovery/partial_notes.md
new file mode 100644
index 000000000000..6d4f177f87d0
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/discovery/partial_notes.md
@@ -0,0 +1,56 @@
+# DeliveredPendingPartialNote
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub(crate) note_completion_log_tag | Field |
+| pub(crate) storage_slot | Field |
+| pub(crate) note_type_id | Field |
+| pub(crate) packed_private_note_content | BoundedVec<Field, MAX_PARTIAL_NOTE_PRIVATE_PACKED_LEN> |
+| pub(crate) recipient | AztecAddress |
+
+## Standalone Functions
+
+### process_partial_note_private_log
+
+```rust
+process_partial_note_private_log(contract_address, recipient, log_metadata, log_content, MAX_LOG_CONTENT_LEN>, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| recipient | AztecAddress |
+| log_metadata | u64 |
+| log_content | BoundedVec<Field |
+| MAX_LOG_CONTENT_LEN> | |
+| | |
+
+### fetch_and_process_public_partial_note_completion_logs
+
+```rust
+fetch_and_process_public_partial_note_completion_logs(contract_address, compute_note_hash_and_nullifier, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| compute_note_hash_and_nullifier | ComputeNoteHashAndNullifier<Env> |
+| | |
+
+### decode_partial_note_private_log
+
+```rust
+decode_partial_note_private_log(log_metadata, log_content, MAX_LOG_CONTENT_LEN>, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| log_metadata | u64 |
+| log_content | BoundedVec<Field |
+| MAX_LOG_CONTENT_LEN> | |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/discovery/private_logs.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/discovery/private_logs.md
new file mode 100644
index 000000000000..3ccf6c5bb033
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/discovery/private_logs.md
@@ -0,0 +1,48 @@
+## Standalone Functions
+
+### fetch_and_process_private_tagged_logs
+
+```rust
+fetch_and_process_private_tagged_logs(_contract_address, _compute_note_hash_and_nullifier, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _contract_address | AztecAddress |
+| _compute_note_hash_and_nullifier | ComputeNoteHashAndNullifier<Env> |
+| | |
+
+### do_process_log
+
+```rust
+do_process_log(contract_address, log, PRIVATE_LOG_SIZE_IN_FIELDS>, tx_hash, unique_note_hashes_in_tx, MAX_NOTE_HASHES_PER_TX>, first_nullifier_in_tx, recipient, compute_note_hash_and_nullifier, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| log | BoundedVec<Field |
+| PRIVATE_LOG_SIZE_IN_FIELDS> | |
+| tx_hash | Field |
+| unique_note_hashes_in_tx | BoundedVec<Field |
+| MAX_NOTE_HASHES_PER_TX> | |
+| first_nullifier_in_tx | Field |
+| recipient | AztecAddress |
+| compute_note_hash_and_nullifier | ComputeNoteHashAndNullifier<Env> |
+| | |
+
+### decode_log_plaintext
+
+```rust
+decode_log_plaintext(log_plaintext, PRIVATE_LOG_PLAINTEXT_SIZE_IN_FIELDS>, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| log_plaintext | BoundedVec<Field |
+| PRIVATE_LOG_PLAINTEXT_SIZE_IN_FIELDS> | |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/discovery/private_notes.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/discovery/private_notes.md
new file mode 100644
index 000000000000..f39fae67cd73
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/discovery/private_notes.md
@@ -0,0 +1,59 @@
+## Standalone Functions
+
+### process_private_note_log
+
+```rust
+process_private_note_log(contract_address, tx_hash, unique_note_hashes_in_tx, MAX_NOTE_HASHES_PER_TX>, first_nullifier_in_tx, recipient, compute_note_hash_and_nullifier, log_metadata, log_content, MAX_LOG_CONTENT_LEN>, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| tx_hash | Field |
+| unique_note_hashes_in_tx | BoundedVec<Field |
+| MAX_NOTE_HASHES_PER_TX> | |
+| first_nullifier_in_tx | Field |
+| recipient | AztecAddress |
+| compute_note_hash_and_nullifier | ComputeNoteHashAndNullifier<Env> |
+| log_metadata | u64 |
+| log_content | BoundedVec<Field |
+| MAX_LOG_CONTENT_LEN> | |
+| | |
+
+### attempt_note_discovery
+
+```rust
+attempt_note_discovery(contract_address, tx_hash, unique_note_hashes_in_tx, MAX_NOTE_HASHES_PER_TX>, first_nullifier_in_tx, recipient, compute_note_hash_and_nullifier, storage_slot, note_type_id, packed_note, MAX_NOTE_PACKED_LEN>, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| tx_hash | Field |
+| unique_note_hashes_in_tx | BoundedVec<Field |
+| MAX_NOTE_HASHES_PER_TX> | |
+| first_nullifier_in_tx | Field |
+| recipient | AztecAddress |
+| compute_note_hash_and_nullifier | ComputeNoteHashAndNullifier<Env> |
+| storage_slot | Field |
+| note_type_id | Field |
+| packed_note | BoundedVec<Field |
+| MAX_NOTE_PACKED_LEN> | |
+| | |
+
+### decode_private_note_log
+
+```rust
+decode_private_note_log(log_metadata, log_content, MAX_LOG_CONTENT_LEN>, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| log_metadata | u64 |
+| log_content | BoundedVec<Field |
+| MAX_LOG_CONTENT_LEN> | |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/encrypt/aes128.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/encrypt/aes128.md
new file mode 100644
index 000000000000..83d8b610e717
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/encrypt/aes128.md
@@ -0,0 +1,68 @@
+## Standalone Functions
+
+### extract_close_to_uniformly_random_256_bits_from_ecdh_shared_secret_using_poseidon2
+
+```rust
+extract_close_to_uniformly_random_256_bits_from_ecdh_shared_secret_using_poseidon2(shared_secret, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| shared_secret | Point |
+| | |
+
+### extract_close_to_uniformly_random_256_bits_from_ecdh_shared_secret_using_sha256
+
+```rust
+extract_close_to_uniformly_random_256_bits_from_ecdh_shared_secret_using_sha256(shared_secret, );
+```
+
+TODO(#10537): Consider nuking this function.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| shared_secret | Point |
+| | |
+
+### derive_aes_symmetric_key_and_iv_from_ecdh_shared_secret
+
+```rust
+derive_aes_symmetric_key_and_iv_from_ecdh_shared_secret(shared_secret, randomness_extraction_fn);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| shared_secret | Point |
+| randomness_extraction_fn | fn(Point |
+
+### derive_aes_symmetric_key_and_iv_from_ecdh_shared_secret_using_sha256
+
+```rust
+derive_aes_symmetric_key_and_iv_from_ecdh_shared_secret_using_sha256(shared_secret, );
+```
+
+TODO(#10537): Consider nuking this function.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| shared_secret | Point |
+| | |
+
+### derive_aes_symmetric_key_and_iv_from_ecdh_shared_secret_using_poseidon2
+
+```rust
+derive_aes_symmetric_key_and_iv_from_ecdh_shared_secret_using_poseidon2(shared_secret, );
+```
+
+TODO(#10537): This function is currently unused. Consider using it instead of the sha256 one.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| shared_secret | Point |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/encrypt/poseidon2.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/encrypt/poseidon2.md
new file mode 100644
index 000000000000..94a18d6cf067
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/encrypt/poseidon2.md
@@ -0,0 +1,87 @@
+## Standalone Functions
+
+### poseidon2_encrypt
+
+```rust
+poseidon2_encrypt(msg, shared_secret, nonce, );
+```
+
+/// @param nonce is only needed if your use case needs to protect against replay attacks.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| msg | [Field; L] |
+| shared_secret | Point |
+| nonce | Field |
+| | |
+
+### poseidon2_decrypt
+
+```rust
+poseidon2_decrypt(ciphertext);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| ciphertext | [Field; ((L + 3 - 1 |
+
+### encrypt_then_decrypt
+
+```rust
+encrypt_then_decrypt(msg);
+```
+
+Helper function that allows us to test encryption, then decryption, for various sizes of message.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| msg | [Field; N] |
+
+### poseidon2_encryption
+
+```rust
+poseidon2_encryption();
+```
+
+Takes no parameters.
+
+### test_poseidon2_decryption_with_bad_secret_fails
+
+```rust
+test_poseidon2_decryption_with_bad_secret_fails();
+```
+
+Takes no parameters.
+
+### encrypt_and_return_ct_length
+
+```rust
+encrypt_and_return_ct_length(msg);
+```
+
+Helper function with encryption boilerplate
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| msg | [Field; N] |
+
+### test_ciphertext_lengths
+
+```rust
+test_ciphertext_lengths();
+```
+
+Takes no parameters.
+
+### test_2_pow_128
+
+```rust
+test_2_pow_128();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/log_assembly_strategies/default_aes128/arithmetic_generics_utils.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/log_assembly_strategies/default_aes128/arithmetic_generics_utils.md
new file mode 100644
index 000000000000..90cd3f129c6d
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/log_assembly_strategies/default_aes128/arithmetic_generics_utils.md
@@ -0,0 +1,99 @@
+## Standalone Functions
+
+### get_arr_of_size__full_plaintext
+
+```rust
+get_arr_of_size__full_plaintext();
+```
+
+|full_pt| = |pt| = (N * 32) + 64
+
+Takes no parameters.
+
+### get_arr_of_size__plaintext_aes_padding
+
+```rust
+get_arr_of_size__plaintext_aes_padding(_full_pt, );
+```
+
+|pt_aes_padding| = 16 - (|full_pt| % 16)
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _full_pt | [u8; FULL_PT] |
+| | |
+
+### get_arr_of_size__ciphertext
+
+```rust
+get_arr_of_size__ciphertext(_full_pt, _pt_aes_padding, );
+```
+
+|ct| = |full_pt| + |pt_aes_padding|
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _full_pt | [u8; FULL_PT] |
+| _pt_aes_padding | [u8; PT_AES_PADDING] |
+| | |
+
+### get_arr_of_size__log_bytes_without_padding
+
+```rust
+get_arr_of_size__log_bytes_without_padding(_ct);
+```
+
+Let lbwop = 1 + 48 + |ct| // aka log bytes without padding
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _ct | [u8; CT] |
+
+### get_arr_of_size__log_bytes_padding
+
+```rust
+get_arr_of_size__log_bytes_padding(_lbwop, );
+```
+
+(because ceil(x / y) = (x + y - 1) // y ).
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _lbwop | [u8; LBWOP] |
+| | |
+
+### get_arr_of_size__log_bytes
+
+```rust
+get_arr_of_size__log_bytes(_lbwop, _p, );
+```
+
+p is the padding
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _lbwop | [u8; LBWOP] |
+| _p | [u8; P] |
+| | |
+
+### get_arr_of_size__log_bytes_padding__from_PT
+
+```rust
+get_arr_of_size__log_bytes_padding__from_PT();
+```
+
+Takes no parameters.
+
+### get_arr_of_size__log_bytes__from_PT
+
+```rust
+get_arr_of_size__log_bytes__from_PT();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/log_assembly_strategies/default_aes128/event.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/log_assembly_strategies/default_aes128/event.md
new file mode 100644
index 000000000000..b1ce72d59ebc
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/log_assembly_strategies/default_aes128/event.md
@@ -0,0 +1,79 @@
+## Standalone Functions
+
+### compute_event_plaintext_for_this_strategy
+
+```rust
+compute_event_plaintext_for_this_strategy(event);
+```
+
+/ NB: The extra `+ 1` is for the event_type_id:
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| event | Event |
+
+### compute_log
+
+```rust
+compute_log(context, event, recipient, sender, );
+```
+
+we perform some note-specific log length assertions.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | PrivateContext |
+| event | Event |
+| recipient | AztecAddress |
+| sender | AztecAddress |
+| | |
+
+### compute_log_unconstrained
+
+```rust
+compute_log_unconstrained(context, event, recipient, sender, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | PrivateContext |
+| event | Event |
+| recipient | AztecAddress |
+| sender | AztecAddress |
+| | |
+
+### encode_and_encrypt_event
+
+```rust
+encode_and_encrypt_event(context, recipient, sender, );
+```
+
+/ private logs.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PrivateContext |
+| recipient | AztecAddress |
+| sender | AztecAddress |
+| | |
+
+### encode_and_encrypt_event_unconstrained
+
+```rust
+encode_and_encrypt_event_unconstrained(context, recipient, sender, );
+```
+
+/// Only use this function in scenarios where the recipient not receiving the event is an acceptable outcome.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PrivateContext |
+| recipient | AztecAddress |
+| sender | AztecAddress |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/log_assembly_strategies/default_aes128/note/encryption.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/log_assembly_strategies/default_aes128/note/encryption.md
new file mode 100644
index 000000000000..9bc540e83070
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/log_assembly_strategies/default_aes128/note/encryption.md
@@ -0,0 +1,41 @@
+## Standalone Functions
+
+### encrypt_log
+
+```rust
+encrypt_log(contract_address, plaintext, recipient, sender, );
+```
+
+/ 4. Format into final log structure with padding
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| plaintext | [Field; PT] |
+| recipient | AztecAddress |
+| sender | AztecAddress |
+| | |
+
+### decrypt_log
+
+```rust
+decrypt_log(log, PRIVATE_LOG_SIZE_IN_FIELDS>, recipient, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| log | BoundedVec<Field |
+| PRIVATE_LOG_SIZE_IN_FIELDS> | |
+| recipient | AztecAddress |
+| | |
+
+### encrypt_decrypt_log
+
+```rust
+encrypt_decrypt_log();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/log_assembly_strategies/default_aes128/note/note.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/log_assembly_strategies/default_aes128/note/note.md
new file mode 100644
index 000000000000..0d6477b97196
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/encrypted_logs/log_assembly_strategies/default_aes128/note/note.md
@@ -0,0 +1,97 @@
+## Standalone Functions
+
+### assert_note_exists
+
+```rust
+assert_note_exists(context, note_hash_counter);
+```
+
+TODO: it feels like this existence check is in the wrong place. In fact, why is it needed at all? Under what circumstances have we found a non-existent note being emitted accidentally?
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | PrivateContext |
+| note_hash_counter | u32 |
+
+### compute_note_plaintext_for_this_strategy
+
+```rust
+compute_note_plaintext_for_this_strategy(note, storage_slot, );
+```
+
+/ NB: The "2" in "N + 2" is for the note_id and the storage_slot of the note:
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| note | Note |
+| storage_slot | Field |
+| | |
+
+### compute_log
+
+```rust
+compute_log(context, note, storage_slot, recipient, sender, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | PrivateContext |
+| note | Note |
+| storage_slot | Field |
+| recipient | AztecAddress |
+| sender | AztecAddress |
+| | |
+
+### compute_log_unconstrained
+
+```rust
+compute_log_unconstrained(context, note, storage_slot, recipient, sender, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | PrivateContext |
+| note | Note |
+| storage_slot | Field |
+| recipient | AztecAddress |
+| sender | AztecAddress |
+| | |
+
+### encode_and_encrypt_note
+
+```rust
+encode_and_encrypt_note(context, recipient, // We need this because to compute a tagging secret, we require a sender, );
+```
+
+/ private logs.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PrivateContext |
+| recipient | AztecAddress |
+| // We need this because to compute a tagging secret | |
+| we require a sender | sender |
+| | |
+
+### encode_and_encrypt_note_unconstrained
+
+```rust
+encode_and_encrypt_note_unconstrained(context, recipient, // We need this because to compute a tagging secret, we require a sender, );
+```
+
+/// Only use this function in scenarios where the recipient not receiving the note is an acceptable outcome.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PrivateContext |
+| recipient | AztecAddress |
+| // We need this because to compute a tagging secret | |
+| we require a sender | sender |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/event/event_interface.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/event/event_interface.md
new file mode 100644
index 000000000000..c38c957c39b2
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/event/event_interface.md
@@ -0,0 +1,22 @@
+## Standalone Functions
+
+### get_event_type_id
+
+```rust
+get_event_type_id();
+```
+
+Takes no parameters.
+
+### emit
+
+```rust
+emit(self, emit);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| emit | fn[Env](Self |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/hash.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/hash.md
new file mode 100644
index 000000000000..c91a9008d6eb
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/hash.md
@@ -0,0 +1,169 @@
+# ArgsHasher
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub fields | Field] |
+
+## Methods
+
+### new
+
+```rust
+ArgsHasher::new();
+```
+
+Takes no parameters.
+
+### add
+
+```rust
+ArgsHasher::add(&mut self, field);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| field | Field |
+
+### add_multiple
+
+```rust
+ArgsHasher::add_multiple(&mut self, fields);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| fields | [Field; N] |
+
+## Standalone Functions
+
+### pedersen_commitment
+
+```rust
+pedersen_commitment(inputs, hash_index);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| inputs | [Field; N] |
+| hash_index | u32 |
+
+### compute_secret_hash
+
+```rust
+compute_secret_hash(secret);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| secret | Field |
+
+### compute_l1_to_l2_message_hash
+
+```rust
+compute_l1_to_l2_message_hash(sender, chain_id, recipient, version, content, secret_hash, leaf_index, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| sender | EthAddress |
+| chain_id | Field |
+| recipient | AztecAddress |
+| version | Field |
+| content | Field |
+| secret_hash | Field |
+| leaf_index | Field |
+| | |
+
+### compute_l1_to_l2_message_nullifier
+
+```rust
+compute_l1_to_l2_message_nullifier(message_hash, secret);
+```
+
+The nullifier of a l1 to l2 message is the hash of the message salted with the secret
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| message_hash | Field |
+| secret | Field |
+
+### hash
+
+```rust
+hash(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### hash_args_array
+
+```rust
+hash_args_array(args);
+```
+
+Computes the hash of input arguments or return values for private functions, or for authwit creation.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| args | [Field; N] |
+
+### hash_args
+
+```rust
+hash_args(args);
+```
+
+Same as `hash_args_array`, but takes a slice instead of an array.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| args | [Field] |
+
+### hash_calldata_array
+
+```rust
+hash_calldata_array(calldata);
+```
+
+Computes the hash of calldata for public functions.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| calldata | [Field; N] |
+
+### hash_calldata
+
+```rust
+hash_calldata(calldata);
+```
+
+Same as `hash_calldata_array`, but takes a slice instead of an array.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| calldata | [Field] |
+
+### compute_var_args_hash
+
+```rust
+compute_var_args_hash();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/contract_inclusion.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/contract_inclusion.md
new file mode 100644
index 000000000000..99fad72c761e
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/contract_inclusion.md
@@ -0,0 +1,98 @@
+## Standalone Functions
+
+### prove_contract_deployment
+
+```rust
+prove_contract_deployment(header, contract_address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| header | BlockHeader |
+| contract_address | AztecAddress |
+
+### prove_contract_deployment
+
+```rust
+prove_contract_deployment(self, contract_address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| contract_address | AztecAddress |
+
+### prove_contract_non_deployment
+
+```rust
+prove_contract_non_deployment(header, contract_address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| header | BlockHeader |
+| contract_address | AztecAddress |
+
+### prove_contract_non_deployment
+
+```rust
+prove_contract_non_deployment(self, contract_address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| contract_address | AztecAddress |
+
+### prove_contract_initialization
+
+```rust
+prove_contract_initialization(header, contract_address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| header | BlockHeader |
+| contract_address | AztecAddress |
+
+### prove_contract_initialization
+
+```rust
+prove_contract_initialization(self, contract_address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| contract_address | AztecAddress |
+
+### prove_contract_non_initialization
+
+```rust
+prove_contract_non_initialization(header, contract_address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| header | BlockHeader |
+| contract_address | AztecAddress |
+
+### prove_contract_non_initialization
+
+```rust
+prove_contract_non_initialization(self, contract_address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| contract_address | AztecAddress |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/note_inclusion.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/note_inclusion.md
new file mode 100644
index 000000000000..17ae76551001
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/note_inclusion.md
@@ -0,0 +1,29 @@
+## Standalone Functions
+
+### prove_note_inclusion
+
+```rust
+prove_note_inclusion(header, retrieved_note, storage_slot, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| header | BlockHeader |
+| retrieved_note | RetrievedNote<Note> |
+| storage_slot | Field |
+| | |
+
+### prove_note_inclusion
+
+```rust
+prove_note_inclusion(self, retrieved_note, storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| retrieved_note | RetrievedNote<Note> |
+| storage_slot | Field |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/note_inclusion/test.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/note_inclusion/test.md
new file mode 100644
index 000000000000..d2cd51877bd0
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/note_inclusion/test.md
@@ -0,0 +1,18 @@
+## Standalone Functions
+
+### note_inclusion
+
+```rust
+note_inclusion();
+```
+
+Takes no parameters.
+
+### note_inclusion_fails
+
+```rust
+note_inclusion_fails();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/note_validity.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/note_validity.md
new file mode 100644
index 000000000000..77e745b3d35b
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/note_validity.md
@@ -0,0 +1,32 @@
+## Standalone Functions
+
+### prove_note_validity
+
+```rust
+prove_note_validity(header, retrieved_note, storage_slot, context, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| header | BlockHeader |
+| retrieved_note | RetrievedNote<Note> |
+| storage_slot | Field |
+| context | &mut PrivateContext |
+| | |
+
+### prove_note_validity
+
+```rust
+prove_note_validity(self, retrieved_note, storage_slot, context, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| retrieved_note | RetrievedNote<Note> |
+| storage_slot | Field |
+| context | &mut PrivateContext |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/note_validity/test.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/note_validity/test.md
new file mode 100644
index 000000000000..5048efe761e7
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/note_validity/test.md
@@ -0,0 +1,26 @@
+## Standalone Functions
+
+### note_not_valid_due_to_non_inclusion
+
+```rust
+note_not_valid_due_to_non_inclusion();
+```
+
+Takes no parameters.
+
+### note_is_valid
+
+```rust
+note_is_valid();
+```
+
+Takes no parameters.
+
+### note_not_valid_due_to_nullification
+
+```rust
+note_not_valid_due_to_nullification();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/nullifier_inclusion.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/nullifier_inclusion.md
new file mode 100644
index 000000000000..12767f6427d0
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/nullifier_inclusion.md
@@ -0,0 +1,58 @@
+## Standalone Functions
+
+### prove_nullifier_inclusion
+
+```rust
+prove_nullifier_inclusion(header, nullifier);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| header | BlockHeader |
+| nullifier | Field |
+
+### prove_nullifier_inclusion
+
+```rust
+prove_nullifier_inclusion(self, nullifier);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| nullifier | Field |
+
+### prove_note_is_nullified
+
+```rust
+prove_note_is_nullified(header, retrieved_note, storage_slot, context, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| header | BlockHeader |
+| retrieved_note | RetrievedNote<Note> |
+| storage_slot | Field |
+| context | &mut PrivateContext |
+| | |
+
+### prove_note_is_nullified
+
+```rust
+prove_note_is_nullified(self, retrieved_note, storage_slot, context, );
+```
+
+docs:start:prove_note_is_nullified
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| retrieved_note | RetrievedNote<Note> |
+| storage_slot | Field |
+| context | &mut PrivateContext |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/nullifier_inclusion/test.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/nullifier_inclusion/test.md
new file mode 100644
index 000000000000..eb17eb928337
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/nullifier_inclusion/test.md
@@ -0,0 +1,34 @@
+## Standalone Functions
+
+### note_is_nullified
+
+```rust
+note_is_nullified();
+```
+
+Takes no parameters.
+
+### note_is_not_nullified
+
+```rust
+note_is_not_nullified();
+```
+
+Takes no parameters.
+
+### nullifier_inclusion
+
+```rust
+nullifier_inclusion();
+```
+
+Takes no parameters.
+
+### nullifier_inclusion_fails
+
+```rust
+nullifier_inclusion_fails();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/nullifier_non_inclusion.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/nullifier_non_inclusion.md
new file mode 100644
index 000000000000..003fe67433aa
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/nullifier_non_inclusion.md
@@ -0,0 +1,58 @@
+## Standalone Functions
+
+### prove_nullifier_non_inclusion
+
+```rust
+prove_nullifier_non_inclusion(header, nullifier);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| header | BlockHeader |
+| nullifier | Field |
+
+### prove_nullifier_non_inclusion
+
+```rust
+prove_nullifier_non_inclusion(self, nullifier);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| nullifier | Field |
+
+### prove_note_not_nullified
+
+```rust
+prove_note_not_nullified(header, retrieved_note, storage_slot, context, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| header | BlockHeader |
+| retrieved_note | RetrievedNote<Note> |
+| storage_slot | Field |
+| context | &mut PrivateContext |
+| | |
+
+### prove_note_not_nullified
+
+```rust
+prove_note_not_nullified(self, retrieved_note, storage_slot, context, );
+```
+
+docs:start:prove_note_not_nullified
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| retrieved_note | RetrievedNote<Note> |
+| storage_slot | Field |
+| context | &mut PrivateContext |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/nullifier_non_inclusion/test.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/nullifier_non_inclusion/test.md
new file mode 100644
index 000000000000..1049861dcd79
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/nullifier_non_inclusion/test.md
@@ -0,0 +1,34 @@
+## Standalone Functions
+
+### note_not_nullified
+
+```rust
+note_not_nullified();
+```
+
+Takes no parameters.
+
+### note_not_nullified_fails
+
+```rust
+note_not_nullified_fails();
+```
+
+Takes no parameters.
+
+### nullifier_non_inclusion
+
+```rust
+nullifier_non_inclusion();
+```
+
+Takes no parameters.
+
+### nullifier_non_inclusion_fails
+
+```rust
+nullifier_non_inclusion_fails();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/public_storage.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/public_storage.md
new file mode 100644
index 000000000000..f7cd599a8f70
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/public_storage.md
@@ -0,0 +1,30 @@
+## Standalone Functions
+
+### public_storage_historical_read
+
+```rust
+public_storage_historical_read(header, storage_slot, contract_address, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| header | BlockHeader |
+| storage_slot | Field |
+| contract_address | AztecAddress |
+| | |
+
+### public_storage_historical_read
+
+```rust
+public_storage_historical_read(self, storage_slot, contract_address, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| storage_slot | Field |
+| contract_address | AztecAddress |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/public_storage/test.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/public_storage/test.md
new file mode 100644
index 000000000000..84a551e9f2c1
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/public_storage/test.md
@@ -0,0 +1,26 @@
+## Standalone Functions
+
+### setup
+
+```rust
+setup();
+```
+
+Takes no parameters.
+
+### public_storage_read
+
+```rust
+public_storage_read();
+```
+
+Takes no parameters.
+
+### public_storage_read_empty
+
+```rust
+public_storage_read_empty();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/test.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/test.md
new file mode 100644
index 000000000000..a60a191e3bd8
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/history/test.md
@@ -0,0 +1,18 @@
+## Standalone Functions
+
+### create_note
+
+```rust
+create_note();
+```
+
+Takes no parameters.
+
+### create_note_and_nullify_it
+
+```rust
+create_note_and_nullify_it();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/keys/ecdh_shared_secret.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/keys/ecdh_shared_secret.md
new file mode 100644
index 000000000000..6208b7f6505a
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/keys/ecdh_shared_secret.md
@@ -0,0 +1,55 @@
+## Standalone Functions
+
+### derive_ecdh_shared_secret
+
+```rust
+derive_ecdh_shared_secret(secret, public_key);
+```
+
+See also: https://en.wikipedia.org/wiki/Elliptic-curve_Diffie%E2%80%93Hellman
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| secret | Scalar |
+| public_key | Point |
+
+### derive_ecdh_shared_secret_using_aztec_address
+
+```rust
+derive_ecdh_shared_secret_using_aztec_address(ephemeral_secret, recipient_address, );
+```
+
+/ given the address of their intended recipient.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| ephemeral_secret | Scalar |
+| recipient_address | AztecAddress |
+| | |
+
+### test_consistency_with_typescript
+
+```rust
+test_consistency_with_typescript();
+```
+
+Takes no parameters.
+
+### test_shared_secret_computation_in_both_directions
+
+```rust
+test_shared_secret_computation_in_both_directions();
+```
+
+Takes no parameters.
+
+### test_shared_secret_computation_from_address_in_both_directions
+
+```rust
+test_shared_secret_computation_from_address_in_both_directions();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/keys/ephemeral.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/keys/ephemeral.md
new file mode 100644
index 000000000000..e1c05843a2da
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/keys/ephemeral.md
@@ -0,0 +1,10 @@
+## Standalone Functions
+
+### generate_ephemeral_key_pair
+
+```rust
+generate_ephemeral_key_pair();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/keys/getters/mod.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/keys/getters/mod.md
new file mode 100644
index 000000000000..9bf0f20e23a2
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/keys/getters/mod.md
@@ -0,0 +1,37 @@
+## Standalone Functions
+
+### get_nsk_app
+
+```rust
+get_nsk_app(npk_m_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| npk_m_hash | Field |
+
+### get_ovsk_app
+
+```rust
+get_ovsk_app(ovpk_m_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| ovpk_m_hash | Field |
+
+### get_public_keys
+
+```rust
+get_public_keys(account);
+```
+
+read keys that are not required by the caller can simply be discarded.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| account | AztecAddress |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/keys/getters/test.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/keys/getters/test.md
new file mode 100644
index 000000000000..35208cbe0faa
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/keys/getters/test.md
@@ -0,0 +1,26 @@
+## Standalone Functions
+
+### setup
+
+```rust
+setup();
+```
+
+Takes no parameters.
+
+### test_get_public_keys_unknown
+
+```rust
+test_get_public_keys_unknown();
+```
+
+Takes no parameters.
+
+### test_get_public_keys_known
+
+```rust
+test_get_public_keys_known();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/aztec.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/aztec.md
new file mode 100644
index 000000000000..0d69ebad4e9e
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/aztec.md
@@ -0,0 +1,180 @@
+## Standalone Functions
+
+### aztec
+
+```rust
+aztec(m);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| m | Module |
+
+### generate_contract_interface
+
+```rust
+generate_contract_interface(m);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| m | Module |
+
+### storage_layout
+
+```rust
+storage_layout();
+```
+
+Takes no parameters.
+
+### at
+
+```rust
+at(addr);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| addr | aztec |
+
+### interface
+
+```rust
+interface();
+```
+
+Takes no parameters.
+
+### at
+
+```rust
+at(addr);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| addr | aztec |
+
+### interface
+
+```rust
+interface();
+```
+
+Takes no parameters.
+
+### generate_contract_library_method_compute_note_hash_and_nullifier
+
+```rust
+generate_contract_library_method_compute_note_hash_and_nullifier();
+```
+
+Takes no parameters.
+
+### _compute_note_hash_and_nullifier
+
+```rust
+_compute_note_hash_and_nullifier(packed_note, aztec, storage_slot, note_type_id, contract_address, nonce, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| packed_note | BoundedVec<Field |
+| aztec | |
+| storage_slot | Field |
+| note_type_id | Field |
+| contract_address | aztec |
+| nonce | Field |
+| | |
+
+### _compute_note_hash_and_nullifier
+
+```rust
+_compute_note_hash_and_nullifier(_packed_note, aztec, _storage_slot, _note_type_id, _contract_address, _nonce, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _packed_note | BoundedVec<Field |
+| aztec | |
+| _storage_slot | Field |
+| _note_type_id | Field |
+| _contract_address | aztec |
+| _nonce | Field |
+| | |
+
+### generate_process_log
+
+```rust
+generate_process_log();
+```
+
+Takes no parameters.
+
+### process_log
+
+```rust
+process_log(log_ciphertext, dep, tx_hash, unique_note_hashes_in_tx, dep, first_nullifier_in_tx, recipient, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| log_ciphertext | BoundedVec<Field |
+| dep | |
+| tx_hash | Field |
+| unique_note_hashes_in_tx | BoundedVec<Field |
+| dep | |
+| first_nullifier_in_tx | Field |
+| recipient | aztec |
+| | |
+
+### process_log
+
+```rust
+process_log(_log_ciphertext, dep, _tx_hash, _unique_note_hashes_in_tx, dep, _first_nullifier_in_tx, _recipient, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _log_ciphertext | BoundedVec<Field |
+| dep | |
+| _tx_hash | Field |
+| _unique_note_hashes_in_tx | BoundedVec<Field |
+| dep | |
+| _first_nullifier_in_tx | Field |
+| _recipient | aztec |
+| | |
+
+### generate_note_exports
+
+```rust
+generate_note_exports();
+```
+
+Takes no parameters.
+
+### generate_sync_notes
+
+```rust
+generate_sync_notes();
+```
+
+Takes no parameters.
+
+### sync_notes
+
+```rust
+sync_notes();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/dispatch.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/dispatch.md
new file mode 100644
index 000000000000..d080c5d1f26a
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/dispatch.md
@@ -0,0 +1,142 @@
+## Standalone Functions
+
+### public_dispatch
+
+```rust
+public_dispatch(.);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| . | |
+
+### generate_public_dispatch
+
+```rust
+generate_public_dispatch(m);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| m | Module |
+
+### public_dispatch
+
+```rust
+public_dispatch(selector);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| selector | Field |
+
+### size_in_fields
+
+```rust
+size_in_fields(typ);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| typ | Type |
+
+### array_size_in_fields
+
+```rust
+array_size_in_fields(typ);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| typ | Type |
+
+### bool_size_in_fields
+
+```rust
+bool_size_in_fields(typ);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| typ | Type |
+
+### field_size_in_fields
+
+```rust
+field_size_in_fields(typ);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| typ | Type |
+
+### int_size_in_fields
+
+```rust
+int_size_in_fields(typ);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| typ | Type |
+
+### constant_size_in_fields
+
+```rust
+constant_size_in_fields(typ);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| typ | Type |
+
+### str_size_in_fields
+
+```rust
+str_size_in_fields(typ);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| typ | Type |
+
+### struct_size_in_fields
+
+```rust
+struct_size_in_fields(typ);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| typ | Type |
+
+### tuple_size_in_fields
+
+```rust
+tuple_size_in_fields(typ);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| typ | Type |
+
+### get_type
+
+```rust
+get_type();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/events.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/events.md
new file mode 100644
index 000000000000..745884c771c4
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/events.md
@@ -0,0 +1,44 @@
+## Standalone Functions
+
+### generate_event_interface
+
+```rust
+generate_event_interface(s);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| s | TypeDefinition |
+
+### get_event_type_id
+
+```rust
+get_event_type_id();
+```
+
+Takes no parameters.
+
+### emit
+
+```rust
+emit(self, _emit);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| _emit | fn[Env](Self |
+
+### event
+
+```rust
+event(s);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| s | TypeDefinition |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/abi_export.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/abi_export.md
new file mode 100644
index 000000000000..b559bf7092be
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/abi_export.md
@@ -0,0 +1,13 @@
+## Standalone Functions
+
+### create_fn_abi_export
+
+```rust
+create_fn_abi_export(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/call_interface_stubs.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/call_interface_stubs.md
new file mode 100644
index 000000000000..36ef2917c2a6
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/call_interface_stubs.md
@@ -0,0 +1,113 @@
+## Standalone Functions
+
+### stub_fn
+
+```rust
+stub_fn(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### create_stub_base
+
+```rust
+create_stub_base(f, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+| | |
+
+### create_private_stub
+
+```rust
+create_private_stub(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### create_private_static_stub
+
+```rust
+create_private_static_stub(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### create_private_void_stub
+
+```rust
+create_private_void_stub(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### create_private_static_void_stub
+
+```rust
+create_private_static_void_stub(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### create_public_stub
+
+```rust
+create_public_stub(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### create_public_static_stub
+
+```rust
+create_public_static_stub(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### create_public_void_stub
+
+```rust
+create_public_void_stub(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### create_public_static_void_stub
+
+```rust
+create_public_static_void_stub(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/initialization_utils.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/initialization_utils.md
new file mode 100644
index 000000000000..c3a8e5393fd3
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/initialization_utils.md
@@ -0,0 +1,94 @@
+## Standalone Functions
+
+### mark_as_initialized_public
+
+```rust
+mark_as_initialized_public(context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PublicContext |
+
+### mark_as_initialized_private
+
+```rust
+mark_as_initialized_private(context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PrivateContext |
+
+### assert_is_initialized_public
+
+```rust
+assert_is_initialized_public(context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PublicContext |
+
+### assert_is_initialized_private
+
+```rust
+assert_is_initialized_private(context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PrivateContext |
+
+### compute_unsiloed_contract_initialization_nullifier
+
+```rust
+compute_unsiloed_contract_initialization_nullifier(address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+
+### assert_initialization_matches_address_preimage_public
+
+```rust
+assert_initialization_matches_address_preimage_public(context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | PublicContext |
+
+### assert_initialization_matches_address_preimage_private
+
+```rust
+assert_initialization_matches_address_preimage_private(context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | PrivateContext |
+
+### compute_initialization_hash
+
+```rust
+compute_initialization_hash(init_selector, init_args_hash, );
+```
+
+/ initialized with the correct constructor arguments. Don't hide this unless you implement factory functionality.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| init_selector | FunctionSelector |
+| init_args_hash | Field |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/mod.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/mod.md
new file mode 100644
index 000000000000..2ceb029cffeb
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/mod.md
@@ -0,0 +1,68 @@
+## Standalone Functions
+
+### initializer
+
+```rust
+initializer(_f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _f | FunctionDefinition |
+
+### noinitcheck
+
+```rust
+noinitcheck(_f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _f | FunctionDefinition |
+
+### internal
+
+```rust
+internal(_f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _f | FunctionDefinition |
+
+### view
+
+```rust
+view(_f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _f | FunctionDefinition |
+
+### private
+
+```rust
+private(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### public
+
+```rust
+public(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/stub_registry.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/stub_registry.md
new file mode 100644
index 000000000000..b8d43a524603
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/stub_registry.md
@@ -0,0 +1,25 @@
+## Standalone Functions
+
+### register
+
+```rust
+register(m, stub);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| m | Module |
+| stub | Quoted |
+
+### get
+
+```rust
+get(m);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| m | Module |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/utils.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/utils.md
new file mode 100644
index 000000000000..08934e173332
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/functions/utils.md
@@ -0,0 +1,109 @@
+## Standalone Functions
+
+### transform_private
+
+```rust
+transform_private(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### transform_public
+
+```rust
+transform_public(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### find_and_transform_top_level_unconstrained_fns
+
+```rust
+find_and_transform_top_level_unconstrained_fns(m);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| m | Module |
+
+### transform_top_level_unconstrained
+
+```rust
+transform_top_level_unconstrained(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### create_internal_check
+
+```rust
+create_internal_check(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### create_view_check
+
+```rust
+create_view_check(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### create_assert_correct_initializer_args
+
+```rust
+create_assert_correct_initializer_args(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### create_mark_as_initialized
+
+```rust
+create_mark_as_initialized(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### create_init_check
+
+```rust
+create_init_check(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### create_message_discovery_call
+
+```rust
+create_message_discovery_call();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/notes.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/notes.md
new file mode 100644
index 000000000000..18cc24210af5
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/notes.md
@@ -0,0 +1,284 @@
+# TokenNoteProperties
+
+/ Generates note properties struct for a given note struct `s`. / / Example: / ```
+
+# TokenNoteFields_5695262104
+
+/ Generates note export for a given note struct `s`. The export is a global variable that contains note type id, / note name and information about note fields (field name, index and whether the field is nullable or not). / / Example: / ```
+
+# CustomNote
+
+/ Generates code for a custom note implementation that requires specialized note hash or nullifier computation. / / # Generated Code / - NoteTypeProperties: Defines the structure and properties of note fields / - NoteType trait implementation: Provides the note type ID / - Packable implementation: Enables serialization/deserialization of the note / / # Registration / Registers the note in the global `NOTES` map with: / - Note type ID / - Packed length / - Field indices and nullability / / # Use Cases / Use this macro when implementing a note that needs custom: / - Note hash computation logic / - Nullifier computation logic / / The macro omits generating default NoteHash trait implementation, allowing you to provide your own. / / # Example / ``` / #[custom_note]
+
+## Standalone Functions
+
+### get_next_note_type_id
+
+```rust
+get_next_note_type_id();
+```
+
+Takes no parameters.
+
+### derive_packable_if_not_implemented_and_get_len
+
+```rust
+derive_packable_if_not_implemented_and_get_len(s);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| s | TypeDefinition |
+
+### get_id
+
+```rust
+get_id();
+```
+
+Takes no parameters.
+
+### generate_note_interface
+
+```rust
+generate_note_interface(s, note_type_id);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| s | TypeDefinition |
+| note_type_id | Field |
+
+### get_id
+
+```rust
+get_id();
+```
+
+Takes no parameters.
+
+### compute_note_hash
+
+```rust
+compute_note_hash(self, storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| storage_slot | Field |
+
+### compute_nullifier
+
+```rust
+compute_nullifier(self, context, note_hash_for_nullify);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+| note_hash_for_nullify | Field |
+
+### compute_nullifier_unconstrained
+
+```rust
+compute_nullifier_unconstrained(note_hash_for_nullify);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| note_hash_for_nullify | Field |
+
+### generate_note_hash_trait_impl
+
+```rust
+generate_note_hash_trait_impl(s);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| s | TypeDefinition |
+
+### compute_note_hash
+
+```rust
+compute_note_hash(self, storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| storage_slot | Field |
+
+### compute_nullifier
+
+```rust
+compute_nullifier(self, context, note_hash_for_nullify, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut aztec |
+| note_hash_for_nullify | Field |
+| | |
+
+### compute_nullifier_unconstrained
+
+```rust
+compute_nullifier_unconstrained(self, note_hash_for_nullify, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| note_hash_for_nullify | Field |
+| | |
+
+### properties
+
+```rust
+properties();
+```
+
+Takes no parameters.
+
+### generate_note_properties
+
+```rust
+generate_note_properties(s);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| s | TypeDefinition |
+
+### properties
+
+```rust
+properties();
+```
+
+Takes no parameters.
+
+### generate_note_export
+
+```rust
+generate_note_export(s, note_type_id, fields, u32, bool);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| s | TypeDefinition |
+| note_type_id | Field |
+| fields | [(Quoted |
+| u32 | |
+| bool | |
+
+### register_note
+
+```rust
+register_note(note, note_packed_len, note_type_id, fixed_fields, Type, u32);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| note | TypeDefinition |
+| note_packed_len | u32 |
+| note_type_id | Field |
+| fixed_fields | [(Quoted |
+| Type | |
+| u32 | |
+
+### index_note_fields
+
+```rust
+index_note_fields(s, nullable_fields, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| s | TypeDefinition |
+| nullable_fields | [Quoted] |
+| | |
+
+### note
+
+```rust
+note(s);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| s | TypeDefinition |
+
+### compute_note_hash
+
+```rust
+compute_note_hash(.);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| . | |
+
+### compute_nullifier
+
+```rust
+compute_nullifier(.);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| . | |
+
+### compute_nullifier_unconstrained
+
+```rust
+compute_nullifier_unconstrained(.);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| . | |
+
+### custom_note
+
+```rust
+custom_note(s);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| s | TypeDefinition |
+
+### assert_has_owner
+
+```rust
+assert_has_owner(note);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| note | TypeDefinition |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/storage.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/storage.md
new file mode 100644
index 000000000000..ba8e0747cbc0
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/storage.md
@@ -0,0 +1,97 @@
+# StorageLayoutFields
+
+## Standalone Functions
+
+### storage
+
+```rust
+storage(s);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| s | TypeDefinition |
+
+### init
+
+```rust
+init(context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | Context |
+
+### init
+
+```rust
+init(context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | Context |
+
+### storage_no_init
+
+```rust
+storage_no_init(_s);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _s | TypeDefinition |
+
+### generate_storage_field_constructor
+
+```rust
+generate_storage_field_constructor(typ, slot, parent_is_map, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| typ | Type |
+| slot | Quoted |
+| parent_is_map | bool |
+| | |
+
+### new
+
+```rust
+new(context, slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | Context |
+| slot | Field |
+
+### is_storage_map
+
+```rust
+is_storage_map(typ);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| typ | Type |
+
+### add_context_generic
+
+```rust
+add_context_generic(typ, context_generic);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| typ | Type |
+| context_generic | Type |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/utils.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/utils.md
new file mode 100644
index 000000000000..9072bc32edd8
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/macros/utils.md
@@ -0,0 +1,247 @@
+# Foo
+
+The event selector is computed from the type signature of the struct in the event, similar to how one might type the constructor function. For example, given:
+
+## Standalone Functions
+
+### get_fn_visibility
+
+```rust
+get_fn_visibility(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### is_fn_private
+
+```rust
+is_fn_private(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### is_fn_public
+
+```rust
+is_fn_public(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### is_fn_view
+
+```rust
+is_fn_view(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### is_fn_internal
+
+```rust
+is_fn_internal(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### is_fn_initializer
+
+```rust
+is_fn_initializer(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### fn_has_noinitcheck
+
+```rust
+fn_has_noinitcheck(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### modify_fn_body
+
+```rust
+modify_fn_body(body, prepend, append);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| body | [Expr] |
+| prepend | Quoted |
+| append | Quoted |
+
+### add_to_field_slice
+
+```rust
+add_to_field_slice(slice_name, name, typ);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| slice_name | Quoted |
+| name | Quoted |
+| typ | Type |
+
+### add_to_hasher
+
+```rust
+add_to_hasher(hasher_name, name, typ);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| hasher_name | Quoted |
+| name | Quoted |
+| typ | Type |
+
+### signature_of_type
+
+```rust
+signature_of_type(typ);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| typ | Type |
+
+### as_str_quote
+
+```rust
+as_str_quote(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### as_str_quote
+
+```rust
+as_str_quote(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### compute_fn_selector
+
+```rust
+compute_fn_selector(f);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| f | FunctionDefinition |
+
+### foo
+
+```rust
+foo(a, b);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| a | Field |
+| b | AztecAddress |
+
+### compute_event_selector
+
+```rust
+compute_event_selector(s);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| s | TypeDefinition |
+
+### get_storage_size
+
+```rust
+get_storage_size(typ);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| typ | Type |
+
+### module_has_storage
+
+```rust
+module_has_storage(m);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| m | Module |
+
+### module_has_initializer
+
+```rust
+module_has_initializer(m);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| m | Module |
+
+### is_note
+
+```rust
+is_note(typ);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| typ | Type |
+
+### get_trait_impl_method
+
+```rust
+get_trait_impl_method(typ, target_trait, target_method, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| typ | Type |
+| target_trait | Quoted |
+| target_method | Quoted |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/messaging.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/messaging.md
new file mode 100644
index 000000000000..0e616e73807b
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/messaging.md
@@ -0,0 +1,21 @@
+## Standalone Functions
+
+### process_l1_to_l2_message
+
+```rust
+process_l1_to_l2_message(l1_to_l2_root, contract_address, portal_contract_address, chain_id, version, content, secret, leaf_index, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| l1_to_l2_root | Field |
+| contract_address | AztecAddress |
+| portal_contract_address | EthAddress |
+| chain_id | Field |
+| version | Field |
+| content | Field |
+| secret | Field |
+| leaf_index | Field |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/lifecycle.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/lifecycle.md
new file mode 100644
index 000000000000..33c1f7e97622
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/lifecycle.md
@@ -0,0 +1,46 @@
+## Standalone Functions
+
+### create_note
+
+```rust
+create_note(context, storage_slot, note, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PrivateContext |
+| storage_slot | Field |
+| note | Note |
+| | |
+
+### destroy_note
+
+```rust
+destroy_note(context, retrieved_note, storage_slot, );
+```
+
+Note: This function is currently totally unused.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PrivateContext |
+| retrieved_note | RetrievedNote<Note> |
+| storage_slot | Field |
+| | |
+
+### destroy_note_unsafe
+
+```rust
+destroy_note_unsafe(context, retrieved_note, note_hash_for_read_request, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PrivateContext |
+| retrieved_note | RetrievedNote<Note> |
+| note_hash_for_read_request | Field |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_emission.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_emission.md
new file mode 100644
index 000000000000..8cd2242b4175
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_emission.md
@@ -0,0 +1,72 @@
+## Standalone Functions
+
+### new
+
+```rust
+new(note, storage_slot, note_hash_counter);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| note | Note |
+| storage_slot | Field |
+| note_hash_counter | u32 |
+
+### emit
+
+```rust
+emit(self, _emit);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| _emit | fn[Env](Self |
+
+### discard
+
+```rust
+discard(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### new
+
+```rust
+new(emission);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| emission | Option<NoteEmission<Note>> |
+
+### emit
+
+```rust
+emit(self, _emit);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| _emit | fn[Env](NoteEmission<Note> |
+
+### discard
+
+```rust
+discard(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_field.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_field.md
new file mode 100644
index 000000000000..742217a673e3
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_field.md
@@ -0,0 +1,10 @@
+# NoteField
+
+Used by macros when generating note export.
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub index | u32 |
+| pub nullable | bool |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_getter.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_getter.md
new file mode 100644
index 000000000000..d20a71e3d8cf
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_getter.md
@@ -0,0 +1,162 @@
+## Standalone Functions
+
+### extract_property_value_from_selector
+
+```rust
+extract_property_value_from_selector(packed_note, selector, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| packed_note | [Field; N] |
+| selector | PropertySelector |
+| | |
+
+### check_packed_note
+
+```rust
+check_packed_note(packed_note, selects, N>);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| packed_note | [Field; N] |
+| selects | BoundedVec<Option<Select> |
+| N> | |
+
+### check_notes_order
+
+```rust
+check_notes_order(fields_0, fields_1, sorts, N>, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| fields_0 | [Field; N] |
+| fields_1 | [Field; N] |
+| sorts | BoundedVec<Option<Sort> |
+| N> | |
+| | |
+
+### get_note
+
+```rust
+get_note(context, storage_slot, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PrivateContext |
+| storage_slot | Field |
+| | |
+
+### get_notes
+
+```rust
+get_notes(context, storage_slot, options, N, PREPROCESSOR_ARGS, FILTER_ARGS>, );
+```
+
+/ abstractions such as aztec-nr's state variables should be used instead.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PrivateContext |
+| storage_slot | Field |
+| options | NoteGetterOptions<Note |
+| N | |
+| PREPROCESSOR_ARGS | |
+| FILTER_ARGS> | |
+| | |
+
+### apply_preprocessor
+
+```rust
+apply_preprocessor(notes, preprocessor, PREPROCESSOR_ARGS);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| notes | [Option<Note>; MAX_NOTE_HASH_READ_REQUESTS_PER_CALL] |
+| preprocessor | fn([Option<Note>; MAX_NOTE_HASH_READ_REQUESTS_PER_CALL] |
+| PREPROCESSOR_ARGS | |
+
+### constrain_get_notes_internal
+
+```rust
+constrain_get_notes_internal(context, storage_slot, opt_notes, options, N, PREPROCESSOR_ARGS, FILTER_ARGS>, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PrivateContext |
+| storage_slot | Field |
+| opt_notes | [Option<RetrievedNote<Note>>; MAX_NOTE_HASH_READ_REQUESTS_PER_CALL] |
+| options | NoteGetterOptions<Note |
+| N | |
+| PREPROCESSOR_ARGS | |
+| FILTER_ARGS> | |
+| | |
+
+### get_note_internal
+
+```rust
+get_note_internal(storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| storage_slot | Field |
+
+### get_notes_internal
+
+```rust
+get_notes_internal(storage_slot, options, N, PREPROCESSOR_ARGS, FILTER_ARGS>, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| storage_slot | Field |
+| options | NoteGetterOptions<Note |
+| N | |
+| PREPROCESSOR_ARGS | |
+| FILTER_ARGS> | |
+| | |
+
+### view_notes
+
+```rust
+view_notes(storage_slot, options, N>, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| storage_slot | Field |
+| options | NoteViewerOptions<Note |
+| N> | |
+| | |
+
+### flatten_options
+
+```rust
+flatten_options(selects, N>, sorts, N>, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| selects | BoundedVec<Option<Select> |
+| N> | |
+| sorts | BoundedVec<Option<Sort> |
+| N> | |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_getter/test.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_getter/test.md
new file mode 100644
index 000000000000..71318a2a7526
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_getter/test.md
@@ -0,0 +1,115 @@
+## Standalone Functions
+
+### setup
+
+```rust
+setup();
+```
+
+Takes no parameters.
+
+### build_valid_retrieved_note
+
+```rust
+build_valid_retrieved_note(value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| value | Field |
+
+### assert_equivalent_vec_and_array
+
+```rust
+assert_equivalent_vec_and_array(vec, N>, arr, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| vec | BoundedVec<T |
+| N> | |
+| arr | [Option<T>; N] |
+| | |
+
+### processes_single_note
+
+```rust
+processes_single_note();
+```
+
+Takes no parameters.
+
+### processes_many_notes
+
+```rust
+processes_many_notes();
+```
+
+Takes no parameters.
+
+### collapses_notes_at_the_beginning_of_the_array
+
+```rust
+collapses_notes_at_the_beginning_of_the_array();
+```
+
+Takes no parameters.
+
+### can_return_zero_notes
+
+```rust
+can_return_zero_notes();
+```
+
+Takes no parameters.
+
+### rejects_mote_notes_than_limit
+
+```rust
+rejects_mote_notes_than_limit();
+```
+
+Takes no parameters.
+
+### applies_filter_before_constraining
+
+```rust
+applies_filter_before_constraining();
+```
+
+Takes no parameters.
+
+### rejects_mismatched_address
+
+```rust
+rejects_mismatched_address();
+```
+
+Takes no parameters.
+
+### rejects_mismatched_selector
+
+```rust
+rejects_mismatched_selector();
+```
+
+Takes no parameters.
+
+### rejects_mismatched_desc_sort_order
+
+```rust
+rejects_mismatched_desc_sort_order();
+```
+
+Takes no parameters.
+
+### rejects_mismatched_asc_sort_order
+
+```rust
+rejects_mismatched_asc_sort_order();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_getter_options.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_getter_options.md
new file mode 100644
index 000000000000..312d395739fb
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_getter_options.md
@@ -0,0 +1,178 @@
+# PropertySelector
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub index | u8, // index of the field in the serialized note array |
+| pub offset | u8, // offset in the byte representation of the field (selected with index above) from which to reading |
+| pub length | u8, // number of bytes to read after the offset |
+
+# Select
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub(crate) property_selector | PropertySelector |
+| pub(crate) comparator | u8 |
+| pub(crate) value | Field |
+
+## Methods
+
+### new
+
+The selected property will be the left hand side and value the right hand side of the operation, so e.g. the object created by new(property, Comparator.GT, value) represents 'property > value'.
+
+```rust
+Select::new(property_selector, comparator, value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| property_selector | PropertySelector |
+| comparator | u8 |
+| value | Field |
+
+# SortOrderEnum
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub DESC | u8 |
+| pub ASC | u8 |
+
+# Sort
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub(crate) property_selector | PropertySelector |
+| pub(crate) order | u8 |
+
+## Methods
+
+### new
+
+```rust
+Sort::new(property_selector, order);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| property_selector | PropertySelector |
+| order | u8 |
+
+# NoteStatusEnum
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub ACTIVE | u8 |
+| pub ACTIVE_OR_NULLIFIED | u8 |
+
+## Standalone Functions
+
+### return_all_notes
+
+```rust
+return_all_notes(notes, _p, );
+```
+
+This is the default filter and preprocessor, which does nothing
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| notes | [Option<RetrievedNote<Note>>; MAX_NOTE_HASH_READ_REQUESTS_PER_CALL] |
+| _p | Field |
+| | |
+
+### select
+
+```rust
+select(&mut self, property_selector, comparator, value, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| property_selector | PropertySelector |
+| comparator | u8 |
+| value | T |
+| | |
+
+### sort
+
+```rust
+sort(&mut self, property_selector, order);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| property_selector | PropertySelector |
+| order | u8 |
+
+### set_limit
+
+```rust
+set_limit(&mut self, limit);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| limit | u32 |
+
+### set_offset
+
+```rust
+set_offset(&mut self, offset);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| offset | u32 |
+
+### set_status
+
+```rust
+set_status(&mut self, status);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| status | u8 |
+
+### with_preprocessor
+
+```rust
+with_preprocessor(preprocessor, PREPROCESSOR_ARGS);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| preprocessor | fn([Option<RetrievedNote<Note>>; MAX_NOTE_HASH_READ_REQUESTS_PER_CALL] |
+| PREPROCESSOR_ARGS | |
+
+### with_filter
+
+```rust
+with_filter(filter, FILTER_ARGS);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| filter | fn([Option<RetrievedNote<Note>>; MAX_NOTE_HASH_READ_REQUESTS_PER_CALL] |
+| FILTER_ARGS | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_interface.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_interface.md
new file mode 100644
index 000000000000..e504c595eb76
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_interface.md
@@ -0,0 +1,71 @@
+## Standalone Functions
+
+### get_id
+
+```rust
+get_id();
+```
+
+Takes no parameters.
+
+### compute_note_hash
+
+```rust
+compute_note_hash(self, storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| storage_slot | Field |
+
+### compute_nullifier
+
+```rust
+compute_nullifier(self, context, note_hash_for_nullify);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+| note_hash_for_nullify | Field |
+
+### compute_nullifier_unconstrained
+
+```rust
+compute_nullifier_unconstrained(self, note_hash_for_nullify);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| note_hash_for_nullify | Field |
+
+### properties
+
+```rust
+properties();
+```
+
+Takes no parameters.
+
+### setup_payload
+
+```rust
+setup_payload();
+```
+
+Takes no parameters.
+
+### finalization_payload
+
+```rust
+finalization_payload();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_metadata.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_metadata.md
new file mode 100644
index 000000000000..b718301b1bbf
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_metadata.md
@@ -0,0 +1,226 @@
+# NoteStageEnum
+
+## Fields
+| Field | Type |
+| --- | --- |
+| PENDING_SAME_PHASE | u8 |
+| PENDING_PREVIOUS_PHASE | u8 |
+| SETTLED | u8 |
+
+# NoteMetadata
+
+## Fields
+| Field | Type |
+| --- | --- |
+| stage | u8 |
+| maybe_nonce | Field |
+
+## Methods
+
+### from_raw_data
+
+/ Constructs a `NoteMetadata` object from optional note hash counter and nonce. Both a zero note hash counter and / a zero nonce are invalid, so those are used to signal non-existent values.
+
+```rust
+NoteMetadata::from_raw_data(nonzero_note_hash_counter, maybe_nonce);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| nonzero_note_hash_counter | bool |
+| maybe_nonce | Field |
+
+### is_pending_same_phase
+
+/ Returns true if the note is pending **and** from the same phase, i.e. if it's been created in the current / transaction during the current execution phase (either non-revertible or revertible).
+
+```rust
+NoteMetadata::is_pending_same_phase(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### is_pending_previous_phase
+
+/ Returns true if the note is pending **and** from the previous phase, i.e. if it's been created in the current / transaction during an execution phase prior to the current one. Because private execution only has two phases / with strict ordering, this implies that the note was created in the non-revertible phase, and that the current / phase is the revertible phase.
+
+```rust
+NoteMetadata::is_pending_previous_phase(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### is_settled
+
+/ Returns true if the note is settled, i.e. if it's been created in a prior transaction and is therefore already / in the note hash tree.
+
+```rust
+NoteMetadata::is_settled(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### to_pending_same_phase
+
+/ Asserts that the metadata is that of a pending note from the same phase and converts it accordingly.
+
+```rust
+NoteMetadata::to_pending_same_phase(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### to_pending_previous_phase
+
+/ Asserts that the metadata is that of a pending note from a previous phase and converts it accordingly.
+
+```rust
+NoteMetadata::to_pending_previous_phase(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### to_settled
+
+/ Asserts that the metadata is that of a settled note and converts it accordingly.
+
+```rust
+NoteMetadata::to_settled(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+# PendingSamePhaseNoteMetadata
+
+/ The metadata required to both prove a note's existence and destroy it, by computing the correct note hash for kernel / read requests, as well as the correct nullifier to avoid double-spends. / / This represents a pending same phase note, i.e. a note that was created in the transaction that is currently being / executed during the current execution phase (either non-revertible or revertible).
+
+## Methods
+
+### new
+
+```rust
+PendingSamePhaseNoteMetadata::new();
+```
+
+Takes no parameters.
+
+# PendingPreviousPhaseNoteMetadata
+
+/ The metadata required to both prove a note's existence and destroy it, by computing the correct note hash for kernel / read requests, as well as the correct nullifier to avoid double-spends. / / This represents a pending previous phase note, i.e. a note that was created in the transaction that is currently / being executed, during the previous execution phase. Because there are only two phases and their order is always the / same (first non-revertible and then revertible) this implies that the note was created in the non-revertible phase, / and that the current phase is the revertible phase.
+
+## Fields
+| Field | Type |
+| --- | --- |
+| nonce | Field |
+
+## Methods
+
+### new
+
+```rust
+PendingPreviousPhaseNoteMetadata::new(nonce);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| nonce | Field |
+
+### nonce
+
+```rust
+PendingPreviousPhaseNoteMetadata::nonce(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+# SettledNoteMetadata
+
+/ The metadata required to both prove a note's existence and destroy it, by computing the correct note hash for kernel / read requests, as well as the correct nullifier to avoid double-spends. / / This represents a settled note, i.e. a note that was created in a prior transaction and is therefore already in the / note hash tree.
+
+## Fields
+| Field | Type |
+| --- | --- |
+| nonce | Field |
+
+## Methods
+
+### new
+
+```rust
+SettledNoteMetadata::new(nonce);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| nonce | Field |
+
+### nonce
+
+```rust
+SettledNoteMetadata::nonce(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+## Standalone Functions
+
+### from
+
+```rust
+from(_value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _value | PendingSamePhaseNoteMetadata |
+
+### from
+
+```rust
+from(value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| value | PendingPreviousPhaseNoteMetadata |
+
+### from
+
+```rust
+from(value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| value | SettledNoteMetadata |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_viewer_options.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_viewer_options.md
new file mode 100644
index 000000000000..ca361ad5b74c
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/note_viewer_options.md
@@ -0,0 +1,74 @@
+## Standalone Functions
+
+### new
+
+```rust
+new();
+```
+
+Takes no parameters.
+
+### select
+
+```rust
+select(&mut self, property_selector, comparator, value, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| property_selector | PropertySelector |
+| comparator | u8 |
+| value | T |
+| | |
+
+### sort
+
+```rust
+sort(&mut self, property_selector, order);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| property_selector | PropertySelector |
+| order | u8 |
+
+### set_limit
+
+```rust
+set_limit(&mut self, limit);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| limit | u32 |
+
+### set_offset
+
+```rust
+set_offset(&mut self, offset);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| offset | u32 |
+
+### set_status
+
+```rust
+set_status(&mut self, status);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| status | u8 |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/retrieved_note.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/retrieved_note.md
new file mode 100644
index 000000000000..5bdb3c70e14e
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/retrieved_note.md
@@ -0,0 +1,13 @@
+## Standalone Functions
+
+### serialize
+
+```rust
+serialize(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/utils.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/utils.md
new file mode 100644
index 000000000000..845eb9ed08d8
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/note/utils.md
@@ -0,0 +1,63 @@
+## Standalone Functions
+
+### compute_note_hash_for_read_request
+
+```rust
+compute_note_hash_for_read_request(retrieved_note, storage_slot, );
+```
+
+/ Returns the note hash that must be used to issue a private kernel read request for a note.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| retrieved_note | RetrievedNote<Note> |
+| storage_slot | Field |
+| | |
+
+### compute_note_hash_for_nullify
+
+```rust
+compute_note_hash_for_nullify(retrieved_note, storage_slot, );
+```
+
+/ `NoteHash::compute_nullifier_unconstrained`.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| retrieved_note | RetrievedNote<Note> |
+| storage_slot | Field |
+| | |
+
+### compute_note_hash_for_nullify_from_read_request
+
+```rust
+compute_note_hash_for_nullify_from_read_request(retrieved_note, note_hash_for_read_request, );
+```
+
+/ computed to reduce constraints by reusing this value.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| retrieved_note | RetrievedNote<Note> |
+| note_hash_for_read_request | Field |
+| | |
+
+### compute_siloed_note_nullifier
+
+```rust
+compute_siloed_note_nullifier(retrieved_note, storage_slot, context, );
+```
+
+/ Computes a note's siloed nullifier, i.e. the one that will be inserted into the nullifier tree.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| retrieved_note | RetrievedNote<Note> |
+| storage_slot | Field |
+| context | &mut PrivateContext |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/aes128_decrypt.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/aes128_decrypt.md
new file mode 100644
index 000000000000..f10540e4696a
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/aes128_decrypt.md
@@ -0,0 +1,33 @@
+## Standalone Functions
+
+### aes128_decrypt_oracle
+
+```rust
+aes128_decrypt_oracle(ciphertext, N>, iv, sym_key, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| ciphertext | BoundedVec<u8 |
+| N> | |
+| iv | [u8; 16] |
+| sym_key | [u8; 16] |
+| | |
+
+### aes_encrypt_then_decrypt
+
+```rust
+aes_encrypt_then_decrypt();
+```
+
+Takes no parameters.
+
+### aes_encrypt_then_decrypt_with_bad_sym_key_is_caught
+
+```rust
+aes_encrypt_then_decrypt_with_bad_sym_key_is_caught();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/block_header.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/block_header.md
new file mode 100644
index 000000000000..1998a8e9c487
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/block_header.md
@@ -0,0 +1,59 @@
+## Standalone Functions
+
+### get_block_header_at_oracle
+
+```rust
+get_block_header_at_oracle(_block_number);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _block_number | u32 |
+
+### get_block_header_at_internal
+
+```rust
+get_block_header_at_internal(block_number);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| block_number | u32 |
+
+### get_block_header_at
+
+```rust
+get_block_header_at(block_number, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| block_number | u32 |
+| context | PrivateContext |
+
+### constrain_get_block_header_at_internal
+
+```rust
+constrain_get_block_header_at_internal(header_hint, block_number, last_archive_block_number, last_archive_root, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| header_hint | BlockHeader |
+| block_number | u32 |
+| last_archive_block_number | u32 |
+| last_archive_root | Field |
+| | |
+
+### fetching_a_valid_but_different_header_should_fail
+
+```rust
+fetching_a_valid_but_different_header_should_fail();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/call_private_function.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/call_private_function.md
new file mode 100644
index 000000000000..c6b7fff67fbe
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/call_private_function.md
@@ -0,0 +1,34 @@
+## Standalone Functions
+
+### call_private_function_oracle
+
+```rust
+call_private_function_oracle(_contract_address, _function_selector, _args_hash, _start_side_effect_counter, _is_static_call, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _contract_address | AztecAddress |
+| _function_selector | FunctionSelector |
+| _args_hash | Field |
+| _start_side_effect_counter | u32 |
+| _is_static_call | bool |
+| | |
+
+### call_private_function_internal
+
+```rust
+call_private_function_internal(contract_address, function_selector, args_hash, start_side_effect_counter, is_static_call, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| function_selector | FunctionSelector |
+| args_hash | Field |
+| start_side_effect_counter | u32 |
+| is_static_call | bool |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/capsules.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/capsules.md
new file mode 100644
index 000000000000..e786b2c4ea10
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/capsules.md
@@ -0,0 +1,221 @@
+## Standalone Functions
+
+### store
+
+```rust
+store(contract_address, slot, value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| slot | Field |
+| value | T |
+
+### load
+
+```rust
+load(contract_address, slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| slot | Field |
+
+### delete
+
+```rust
+delete(contract_address, slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| slot | Field |
+
+### copy
+
+```rust
+copy(contract_address, src_slot, dst_slot, num_entries, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| src_slot | Field |
+| dst_slot | Field |
+| num_entries | u32 |
+| | |
+
+### store_oracle
+
+```rust
+store_oracle(contract_address, slot, values, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| slot | Field |
+| values | [Field; N] |
+| | |
+
+### load_oracle
+
+```rust
+load_oracle(contract_address, slot, array_len, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| slot | Field |
+| array_len | u32 |
+| | |
+
+### delete_oracle
+
+```rust
+delete_oracle(contract_address, slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| slot | Field |
+
+### copy_oracle
+
+```rust
+copy_oracle(contract_address, src_slot, dst_slot, num_entries, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| src_slot | Field |
+| dst_slot | Field |
+| num_entries | u32 |
+| | |
+
+### setup
+
+```rust
+setup();
+```
+
+Takes no parameters.
+
+### stores_and_loads
+
+```rust
+stores_and_loads();
+```
+
+Takes no parameters.
+
+### store_overwrites
+
+```rust
+store_overwrites();
+```
+
+Takes no parameters.
+
+### loads_empty_slot
+
+```rust
+loads_empty_slot();
+```
+
+Takes no parameters.
+
+### deletes_stored_value
+
+```rust
+deletes_stored_value();
+```
+
+Takes no parameters.
+
+### deletes_empty_slot
+
+```rust
+deletes_empty_slot();
+```
+
+Takes no parameters.
+
+### copies_non_overlapping_values
+
+```rust
+copies_non_overlapping_values();
+```
+
+Takes no parameters.
+
+### copies_overlapping_values_with_src_ahead
+
+```rust
+copies_overlapping_values_with_src_ahead();
+```
+
+Takes no parameters.
+
+### copies_overlapping_values_with_dst_ahead
+
+```rust
+copies_overlapping_values_with_dst_ahead();
+```
+
+Takes no parameters.
+
+### cannot_copy_empty_values
+
+```rust
+cannot_copy_empty_values();
+```
+
+Takes no parameters.
+
+### cannot_store_other_contract
+
+```rust
+cannot_store_other_contract();
+```
+
+Takes no parameters.
+
+### cannot_load_other_contract
+
+```rust
+cannot_load_other_contract();
+```
+
+Takes no parameters.
+
+### cannot_delete_other_contract
+
+```rust
+cannot_delete_other_contract();
+```
+
+Takes no parameters.
+
+### cannot_copy_other_contract
+
+```rust
+cannot_copy_other_contract();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/enqueue_public_function_call.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/enqueue_public_function_call.md
new file mode 100644
index 000000000000..422c1ec7bb92
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/enqueue_public_function_call.md
@@ -0,0 +1,125 @@
+## Standalone Functions
+
+### notify_enqueued_public_function_call_oracle
+
+```rust
+notify_enqueued_public_function_call_oracle(_contract_address, _calldata_hash, _side_effect_counter, _is_static_call, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _contract_address | AztecAddress |
+| _calldata_hash | Field |
+| _side_effect_counter | u32 |
+| _is_static_call | bool |
+| | |
+
+### notify_enqueued_public_function_call_wrapper
+
+```rust
+notify_enqueued_public_function_call_wrapper(contract_address, calldata_hash, side_effect_counter, is_static_call, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| calldata_hash | Field |
+| side_effect_counter | u32 |
+| is_static_call | bool |
+| | |
+
+### notify_enqueued_public_function_call
+
+```rust
+notify_enqueued_public_function_call(contract_address, calldata_hash, side_effect_counter, is_static_call, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| calldata_hash | Field |
+| side_effect_counter | u32 |
+| is_static_call | bool |
+| | |
+
+### notify_set_public_teardown_function_call_oracle
+
+```rust
+notify_set_public_teardown_function_call_oracle(_contract_address, _calldata_hash, _side_effect_counter, _is_static_call, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _contract_address | AztecAddress |
+| _calldata_hash | Field |
+| _side_effect_counter | u32 |
+| _is_static_call | bool |
+| | |
+
+### notify_set_public_teardown_function_call_wrapper
+
+```rust
+notify_set_public_teardown_function_call_wrapper(contract_address, calldata_hash, side_effect_counter, is_static_call, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| calldata_hash | Field |
+| side_effect_counter | u32 |
+| is_static_call | bool |
+| | |
+
+### notify_set_public_teardown_function_call
+
+```rust
+notify_set_public_teardown_function_call(contract_address, calldata_hash, side_effect_counter, is_static_call, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| calldata_hash | Field |
+| side_effect_counter | u32 |
+| is_static_call | bool |
+| | |
+
+### notify_set_min_revertible_side_effect_counter
+
+```rust
+notify_set_min_revertible_side_effect_counter(counter);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| counter | u32 |
+
+### notify_set_min_revertible_side_effect_counter_oracle_wrapper
+
+```rust
+notify_set_min_revertible_side_effect_counter_oracle_wrapper(counter);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| counter | u32 |
+
+### notify_set_min_revertible_side_effect_counter_oracle
+
+```rust
+notify_set_min_revertible_side_effect_counter_oracle(_counter);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _counter | u32 |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/execution.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/execution.md
new file mode 100644
index 000000000000..bf8e1bfd579c
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/execution.md
@@ -0,0 +1,66 @@
+## Standalone Functions
+
+### get_contract_address_oracle
+
+```rust
+get_contract_address_oracle();
+```
+
+Takes no parameters.
+
+### get_block_number_oracle
+
+```rust
+get_block_number_oracle();
+```
+
+Takes no parameters.
+
+### get_chain_id_oracle
+
+```rust
+get_chain_id_oracle();
+```
+
+Takes no parameters.
+
+### get_version_oracle
+
+```rust
+get_version_oracle();
+```
+
+Takes no parameters.
+
+### get_contract_address
+
+```rust
+get_contract_address();
+```
+
+Takes no parameters.
+
+### get_block_number
+
+```rust
+get_block_number();
+```
+
+Takes no parameters.
+
+### get_chain_id
+
+```rust
+get_chain_id();
+```
+
+Takes no parameters.
+
+### get_version
+
+```rust
+get_version();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/execution_cache.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/execution_cache.md
new file mode 100644
index 000000000000..83aed7fd746d
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/execution_cache.md
@@ -0,0 +1,62 @@
+## Standalone Functions
+
+### store
+
+```rust
+store(values, hash);
+```
+
+/ Stores values represented as slice in execution cache to be later obtained by its hash.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| values | [Field] |
+| hash | Field |
+
+### store_in_execution_cache_oracle_wrapper
+
+```rust
+store_in_execution_cache_oracle_wrapper(values, hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| values | [Field] |
+| hash | Field |
+
+### load
+
+```rust
+load(hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| hash | Field |
+
+### store_in_execution_cache_oracle
+
+```rust
+store_in_execution_cache_oracle(_values, _hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _values | [Field] |
+| _hash | Field |
+
+### load_from_execution_cache_oracle
+
+```rust
+load_from_execution_cache_oracle(_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _hash | Field |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/get_contract_instance.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/get_contract_instance.md
new file mode 100644
index 000000000000..45500bebc27b
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/get_contract_instance.md
@@ -0,0 +1,142 @@
+## Standalone Functions
+
+### get_contract_instance_oracle
+
+```rust
+get_contract_instance_oracle(_address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _address | AztecAddress |
+
+### get_contract_instance_internal
+
+```rust
+get_contract_instance_internal(address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+
+### get_contract_instance
+
+```rust
+get_contract_instance(address);
+```
+
+NOTE: this is for use in private only
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+
+### get_contract_instance_deployer_oracle_avm
+
+```rust
+get_contract_instance_deployer_oracle_avm(_address, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _address | AztecAddress |
+| | |
+
+### get_contract_instance_class_id_oracle_avm
+
+```rust
+get_contract_instance_class_id_oracle_avm(_address, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _address | AztecAddress |
+| | |
+
+### get_contract_instance_initialization_hash_oracle_avm
+
+```rust
+get_contract_instance_initialization_hash_oracle_avm(_address, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _address | AztecAddress |
+| | |
+
+### get_contract_instance_deployer_internal_avm
+
+```rust
+get_contract_instance_deployer_internal_avm(address, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+| | |
+
+### get_contract_instance_class_id_internal_avm
+
+```rust
+get_contract_instance_class_id_internal_avm(address, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+| | |
+
+### get_contract_instance_initialization_hash_internal_avm
+
+```rust
+get_contract_instance_initialization_hash_internal_avm(address, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+| | |
+
+### get_contract_instance_deployer_avm
+
+```rust
+get_contract_instance_deployer_avm(address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+
+### get_contract_instance_class_id_avm
+
+```rust
+get_contract_instance_class_id_avm(address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+
+### get_contract_instance_initialization_hash_avm
+
+```rust
+get_contract_instance_initialization_hash_avm(address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/get_l1_to_l2_membership_witness.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/get_l1_to_l2_membership_witness.md
new file mode 100644
index 000000000000..b4fec4a6095c
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/get_l1_to_l2_membership_witness.md
@@ -0,0 +1,30 @@
+## Standalone Functions
+
+### get_l1_to_l2_membership_witness
+
+```rust
+get_l1_to_l2_membership_witness(contract_address, message_hash, secret, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| message_hash | Field |
+| secret | Field |
+| | |
+
+### get_l1_to_l2_membership_witness_oracle
+
+```rust
+get_l1_to_l2_membership_witness_oracle(_contract_address, _message_hash, _secret, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _contract_address | AztecAddress |
+| _message_hash | Field |
+| _secret | Field |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/get_membership_witness.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/get_membership_witness.md
new file mode 100644
index 000000000000..a27411385a60
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/get_membership_witness.md
@@ -0,0 +1,42 @@
+## Standalone Functions
+
+### get_membership_witness
+
+```rust
+get_membership_witness(_block_number, _tree_id, _leaf_value, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _block_number | u32 |
+| _tree_id | Field |
+| _leaf_value | Field |
+| | |
+
+### get_note_hash_membership_witness
+
+```rust
+get_note_hash_membership_witness(block_number, leaf_value, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| block_number | u32 |
+| leaf_value | Field |
+| | |
+
+### get_archive_membership_witness
+
+```rust
+get_archive_membership_witness(block_number, leaf_value, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| block_number | u32 |
+| leaf_value | Field |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/get_nullifier_membership_witness.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/get_nullifier_membership_witness.md
new file mode 100644
index 000000000000..b75e60b13bf9
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/get_nullifier_membership_witness.md
@@ -0,0 +1,76 @@
+# NullifierMembershipWitness
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub index | Field |
+| pub leaf_preimage | NullifierLeafPreimage |
+| pub path | Field; NULLIFIER_TREE_HEIGHT] |
+
+## Methods
+
+### deserialize
+
+```rust
+NullifierMembershipWitness::deserialize(fields);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| fields | [Field; NULLIFIER_MEMBERSHIP_WITNESS] |
+
+## Standalone Functions
+
+### get_low_nullifier_membership_witness_oracle
+
+```rust
+get_low_nullifier_membership_witness_oracle(_block_number, _nullifier, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _block_number | u32 |
+| _nullifier | Field |
+| | |
+
+### get_low_nullifier_membership_witness
+
+```rust
+get_low_nullifier_membership_witness(block_number, nullifier, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| block_number | u32 |
+| nullifier | Field |
+| | |
+
+### get_nullifier_membership_witness_oracle
+
+```rust
+get_nullifier_membership_witness_oracle(_block_number, _nullifier, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _block_number | u32 |
+| _nullifier | Field |
+| | |
+
+### get_nullifier_membership_witness
+
+```rust
+get_nullifier_membership_witness(block_number, nullifier, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| block_number | u32 |
+| nullifier | Field |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/get_public_data_witness.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/get_public_data_witness.md
new file mode 100644
index 000000000000..87e6d269adc7
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/get_public_data_witness.md
@@ -0,0 +1,37 @@
+# PublicDataWitness
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub index | Field |
+| pub leaf_preimage | PublicDataTreeLeafPreimage |
+| pub path | Field; PUBLIC_DATA_TREE_HEIGHT] |
+
+## Standalone Functions
+
+### get_public_data_witness_oracle
+
+```rust
+get_public_data_witness_oracle(_block_number, _public_data_tree_index, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _block_number | u32 |
+| _public_data_tree_index | Field |
+| | |
+
+### get_public_data_witness
+
+```rust
+get_public_data_witness(block_number, public_data_tree_index, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| block_number | u32 |
+| public_data_tree_index | Field |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/key_validation_request.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/key_validation_request.md
new file mode 100644
index 000000000000..692ba8ccb0a9
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/key_validation_request.md
@@ -0,0 +1,28 @@
+## Standalone Functions
+
+### get_key_validation_request_oracle
+
+```rust
+get_key_validation_request_oracle(_pk_m_hash, _key_index, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _pk_m_hash | Field |
+| _key_index | Field |
+| | |
+
+### get_key_validation_request
+
+```rust
+get_key_validation_request(pk_m_hash, key_index, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| pk_m_hash | Field |
+| key_index | Field |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/keys.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/keys.md
new file mode 100644
index 000000000000..0425c51f9d5c
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/keys.md
@@ -0,0 +1,25 @@
+## Standalone Functions
+
+### get_public_keys_and_partial_address_oracle
+
+```rust
+get_public_keys_and_partial_address_oracle(_address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _address | AztecAddress |
+
+### get_public_keys_and_partial_address
+
+```rust
+get_public_keys_and_partial_address(address, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/logs.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/logs.md
new file mode 100644
index 000000000000..2e538601dd16
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/logs.md
@@ -0,0 +1,30 @@
+## Standalone Functions
+
+### notify_created_contract_class_log
+
+```rust
+notify_created_contract_class_log(contract_address, message, counter, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| message | [Field; N] |
+| counter | u32 |
+| | |
+
+### notify_created_contract_class_log_private_oracle
+
+```rust
+notify_created_contract_class_log_private_oracle(contract_address, message, counter, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| message | [Field; N] |
+| counter | u32 |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/message_discovery.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/message_discovery.md
new file mode 100644
index 000000000000..6c65d7b52d4b
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/message_discovery.md
@@ -0,0 +1,92 @@
+# LogWithTxData
+
+/ The contents of a public log, plus contextual information about the transaction in which the log was emitted. This / is the data required in order to discover notes that are being delivered in a log. TODO(#11639): this could also be used to fetch private logs, but the `BoundedVec` maximum length is that of a public log.
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub log_content | BoundedVec<Field, PUBLIC_LOG_DATA_SIZE_IN_FIELDS> |
+| pub tx_hash | Field |
+| pub unique_note_hashes_in_tx | BoundedVec<Field, MAX_NOTE_HASHES_PER_TX> |
+| pub first_nullifier_in_tx | Field |
+
+## Standalone Functions
+
+### sync_notes
+
+```rust
+sync_notes();
+```
+
+Takes no parameters.
+
+### sync_notes_oracle
+
+```rust
+sync_notes_oracle();
+```
+
+Takes no parameters.
+
+### deliver_note
+
+```rust
+deliver_note(contract_address, storage_slot, nonce, packed_note, MAX_NOTE_PACKED_LEN>, note_hash, nullifier, tx_hash, recipient, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| storage_slot | Field |
+| nonce | Field |
+| packed_note | BoundedVec<Field |
+| MAX_NOTE_PACKED_LEN> | |
+| note_hash | Field |
+| nullifier | Field |
+| tx_hash | Field |
+| recipient | AztecAddress |
+| | |
+
+### get_log_by_tag
+
+```rust
+get_log_by_tag(tag);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| tag | Field |
+
+### deliver_note_oracle
+
+```rust
+deliver_note_oracle(contract_address, storage_slot, nonce, packed_note, MAX_NOTE_PACKED_LEN>, note_hash, nullifier, tx_hash, recipient, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| storage_slot | Field |
+| nonce | Field |
+| packed_note | BoundedVec<Field |
+| MAX_NOTE_PACKED_LEN> | |
+| note_hash | Field |
+| nullifier | Field |
+| tx_hash | Field |
+| recipient | AztecAddress |
+| | |
+
+### get_log_by_tag_oracle
+
+```rust
+get_log_by_tag_oracle(tag);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| tag | Field |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/notes.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/notes.md
new file mode 100644
index 000000000000..24250f5a7a5a
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/notes.md
@@ -0,0 +1,306 @@
+## Standalone Functions
+
+### notify_created_note
+
+```rust
+notify_created_note(storage_slot, note_type_id, packed_note, note_hash, counter, );
+```
+
+/ transaction. This note should only be added to the non-volatile database if found in an actual block.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| storage_slot | Field |
+| note_type_id | Field |
+| packed_note | [Field; N] |
+| note_hash | Field |
+| counter | u32 |
+| | |
+
+### notify_nullified_note
+
+```rust
+notify_nullified_note(nullifier, note_hash, counter);
+```
+
+/ actual block.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| nullifier | Field |
+| note_hash | Field |
+| counter | u32 |
+
+### notify_created_nullifier
+
+```rust
+notify_created_nullifier(nullifier);
+```
+
+/ Notifies the simulator that a non-note nullifier has been created, so that it can be used for note nonces.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| nullifier | Field |
+
+### notify_created_note_oracle_wrapper
+
+```rust
+notify_created_note_oracle_wrapper(storage_slot, note_type_id, packed_note, note_hash, counter, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| storage_slot | Field |
+| note_type_id | Field |
+| packed_note | [Field; N] |
+| note_hash | Field |
+| counter | u32 |
+| | |
+
+### notify_created_note_oracle
+
+```rust
+notify_created_note_oracle(_storage_slot, _note_type_id, _packed_note, _note_hash, _counter, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _storage_slot | Field |
+| _note_type_id | Field |
+| _packed_note | [Field; N] |
+| _note_hash | Field |
+| _counter | u32 |
+| | |
+
+### notify_nullified_note_oracle_wrapper
+
+```rust
+notify_nullified_note_oracle_wrapper(nullifier, note_hash, counter, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| nullifier | Field |
+| note_hash | Field |
+| counter | u32 |
+| | |
+
+### notify_nullified_note_oracle
+
+```rust
+notify_nullified_note_oracle(_nullifier, _note_hash, _counter);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _nullifier | Field |
+| _note_hash | Field |
+| _counter | u32 |
+
+### notify_created_nullifier_oracle_wrapper
+
+```rust
+notify_created_nullifier_oracle_wrapper(nullifier);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| nullifier | Field |
+
+### notify_created_nullifier_oracle
+
+```rust
+notify_created_nullifier_oracle(_nullifier);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _nullifier | Field |
+
+### get_notes_oracle
+
+```rust
+get_notes_oracle(_storage_slot, _num_selects, _select_by_indexes, _select_by_offsets, _select_by_lengths, _select_values, _select_comparators, _sort_by_indexes, _sort_by_offsets, _sort_by_lengths, _sort_order, _limit, _offset, _status, _return_size, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _storage_slot | Field |
+| _num_selects | u8 |
+| _select_by_indexes | [u8; N] |
+| _select_by_offsets | [u8; N] |
+| _select_by_lengths | [u8; N] |
+| _select_values | [Field; N] |
+| _select_comparators | [u8; N] |
+| _sort_by_indexes | [u8; N] |
+| _sort_by_offsets | [u8; N] |
+| _sort_by_lengths | [u8; N] |
+| _sort_order | [u8; N] |
+| _limit | u32 |
+| _offset | u32 |
+| _status | u8 |
+| _return_size | u32 |
+| | |
+
+### get_notes_oracle_wrapper
+
+```rust
+get_notes_oracle_wrapper(storage_slot, num_selects, select_by_indexes, select_by_offsets, select_by_lengths, select_values, select_comparators, sort_by_indexes, sort_by_offsets, sort_by_lengths, sort_order, limit, offset, status, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| storage_slot | Field |
+| num_selects | u8 |
+| select_by_indexes | [u8; N] |
+| select_by_offsets | [u8; N] |
+| select_by_lengths | [u8; N] |
+| select_values | [Field; N] |
+| select_comparators | [u8; N] |
+| sort_by_indexes | [u8; N] |
+| sort_by_offsets | [u8; N] |
+| sort_by_lengths | [u8; N] |
+| sort_order | [u8; N] |
+| limit | u32 |
+| offset | u32 |
+| status | u8 |
+| | |
+
+### get_notes
+
+```rust
+get_notes(storage_slot, num_selects, select_by_indexes, select_by_offsets, select_by_lengths, select_values, select_comparators, sort_by_indexes, sort_by_offsets, sort_by_lengths, sort_order, limit, offset, status, _placeholder_fields, // TODO);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| storage_slot | Field |
+| num_selects | u8 |
+| select_by_indexes | [u8; M] |
+| select_by_offsets | [u8; M] |
+| select_by_lengths | [u8; M] |
+| select_values | [Field; M] |
+| select_comparators | [u8; M] |
+| sort_by_indexes | [u8; M] |
+| sort_by_offsets | [u8; M] |
+| sort_by_lengths | [u8; M] |
+| sort_order | [u8; M] |
+| limit | u32 |
+| offset | u32 |
+| status | u8 |
+| _placeholder_fields | [Field; ORACLE_RETURN_FIELD_LENGTH] |
+| // TODO | Compute this value automatically from MAX_NOTES |
+
+### check_nullifier_exists
+
+```rust
+check_nullifier_exists(inner_nullifier);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| inner_nullifier | Field |
+
+### check_nullifier_exists_oracle
+
+```rust
+check_nullifier_exists_oracle(_inner_nullifier);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _inner_nullifier | Field |
+
+### get_app_tag_as_sender
+
+```rust
+get_app_tag_as_sender(sender, recipient);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| sender | AztecAddress |
+| recipient | AztecAddress |
+
+### get_indexed_tagging_secret_as_sender
+
+```rust
+get_indexed_tagging_secret_as_sender(sender, recipient, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| sender | AztecAddress |
+| recipient | AztecAddress |
+| | |
+
+### get_indexed_tagging_secret_as_sender_oracle
+
+```rust
+get_indexed_tagging_secret_as_sender_oracle(_sender, _recipient, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _sender | AztecAddress |
+| _recipient | AztecAddress |
+| | |
+
+### increment_app_tagging_secret_index_as_sender
+
+```rust
+increment_app_tagging_secret_index_as_sender(sender, recipient);
+```
+
+/ that are not found by the recipient.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| sender | AztecAddress |
+| recipient | AztecAddress |
+
+### increment_app_tagging_secret_index_as_sender_wrapper
+
+```rust
+increment_app_tagging_secret_index_as_sender_wrapper(sender, recipient, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| sender | AztecAddress |
+| recipient | AztecAddress |
+| | |
+
+### increment_app_tagging_secret_index_as_sender_oracle
+
+```rust
+increment_app_tagging_secret_index_as_sender_oracle(_sender, _recipient, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _sender | AztecAddress |
+| _recipient | AztecAddress |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/random.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/random.md
new file mode 100644
index 000000000000..93e89332780f
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/random.md
@@ -0,0 +1,18 @@
+## Standalone Functions
+
+### random
+
+```rust
+random();
+```
+
+Takes no parameters.
+
+### rand_oracle
+
+```rust
+rand_oracle();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/shared_secret.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/shared_secret.md
new file mode 100644
index 000000000000..a7c2273cf25d
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/shared_secret.md
@@ -0,0 +1,26 @@
+## Standalone Functions
+
+### get_shared_secret_oracle
+
+```rust
+get_shared_secret_oracle(address, ephPk);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+| ephPk | Point |
+
+### get_shared_secret
+
+```rust
+get_shared_secret(address, ephPk);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+| ephPk | Point |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/storage.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/storage.md
new file mode 100644
index 000000000000..c01b908f0052
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/oracle/storage.md
@@ -0,0 +1,61 @@
+## Standalone Functions
+
+### storage_read_oracle
+
+```rust
+storage_read_oracle(address, storage_slot, block_number, length, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | Field |
+| storage_slot | Field |
+| block_number | Field |
+| length | Field |
+| | |
+
+### raw_storage_read
+
+```rust
+raw_storage_read(address, storage_slot, block_number, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+| storage_slot | Field |
+| block_number | u32 |
+| | |
+
+### storage_read
+
+```rust
+storage_read(address, storage_slot, block_number, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+| storage_slot | Field |
+| block_number | u32 |
+| | |
+
+### test_raw_storage_read
+
+```rust
+test_raw_storage_read();
+```
+
+Takes no parameters.
+
+### test_storage_read
+
+```rust
+test_storage_read();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/map.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/map.md
new file mode 100644
index 000000000000..1bea61829427
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/map.md
@@ -0,0 +1,39 @@
+## Standalone Functions
+
+### get_storage_slot
+
+```rust
+get_storage_slot(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### new
+
+```rust
+new(context, storage_slot, state_var_constructor, Field);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | Context |
+| storage_slot | Field |
+| state_var_constructor | fn(Context |
+| Field | |
+
+### at
+
+```rust
+at(self, key);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| key | K |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/private_immutable.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/private_immutable.md
new file mode 100644
index 000000000000..0891934dae61
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/private_immutable.md
@@ -0,0 +1,81 @@
+## Standalone Functions
+
+### get_storage_slot
+
+```rust
+get_storage_slot(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### new
+
+```rust
+new(context, storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | Context |
+| storage_slot | Field |
+
+### compute_initialization_nullifier
+
+```rust
+compute_initialization_nullifier(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### initialize
+
+```rust
+initialize(self, note);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| note | Note |
+
+### get_note
+
+```rust
+get_note(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### is_initialized
+
+```rust
+is_initialized(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### view_note
+
+```rust
+view_note(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/private_mutable.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/private_mutable.md
new file mode 100644
index 000000000000..ceacadf858f7
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/private_mutable.md
@@ -0,0 +1,105 @@
+## Standalone Functions
+
+### get_storage_slot
+
+```rust
+get_storage_slot(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### new
+
+```rust
+new(context, storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | Context |
+| storage_slot | Field |
+
+### compute_initialization_nullifier
+
+```rust
+compute_initialization_nullifier(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### initialize
+
+```rust
+initialize(self, note);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| note | Note |
+
+### replace
+
+```rust
+replace(self, new_note);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| new_note | Note |
+
+### initialize_or_replace
+
+```rust
+initialize_or_replace(self, note);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| note | Note |
+
+### get_note
+
+```rust
+get_note(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### is_initialized
+
+```rust
+is_initialized(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### view_note
+
+```rust
+view_note(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/private_mutable/test.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/private_mutable/test.md
new file mode 100644
index 000000000000..ac54d649bf66
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/private_mutable/test.md
@@ -0,0 +1,38 @@
+## Standalone Functions
+
+### setup
+
+```rust
+setup();
+```
+
+Takes no parameters.
+
+### in_private
+
+```rust
+in_private(env, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| env | &mut TestEnvironment |
+| | |
+
+### test_initialize_or_replace_without_nullifier
+
+```rust
+test_initialize_or_replace_without_nullifier();
+```
+
+Takes no parameters.
+
+### test_initialize_or_replace_with_nullifier
+
+```rust
+test_initialize_or_replace_with_nullifier();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/private_set.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/private_set.md
new file mode 100644
index 000000000000..2deb70102a4e
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/private_set.md
@@ -0,0 +1,95 @@
+## Standalone Functions
+
+### get_storage_slot
+
+```rust
+get_storage_slot(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### new
+
+```rust
+new(context, storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | Context |
+| storage_slot | Field |
+
+### insert
+
+```rust
+insert(self, note);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| note | Note |
+
+### pop_notes
+
+```rust
+pop_notes(self, options, N, PREPROCESSOR_ARGS, FILTER_ARGS>, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| options | NoteGetterOptions<Note |
+| N | |
+| PREPROCESSOR_ARGS | |
+| FILTER_ARGS> | |
+| | |
+
+### remove
+
+```rust
+remove(self, retrieved_note);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| retrieved_note | RetrievedNote<Note> |
+
+### get_notes
+
+```rust
+get_notes(self, options, N, PREPROCESSOR_ARGS, FILTER_ARGS>, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| options | NoteGetterOptions<Note |
+| N | |
+| PREPROCESSOR_ARGS | |
+| FILTER_ARGS> | |
+| | |
+
+### view_notes
+
+```rust
+view_notes(self, options, N>, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| options | NoteViewerOptions<Note |
+| N> | |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/public_immutable.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/public_immutable.md
new file mode 100644
index 000000000000..29191e7f2db0
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/public_immutable.md
@@ -0,0 +1,69 @@
+## Standalone Functions
+
+### get_storage_slot
+
+```rust
+get_storage_slot(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### new
+
+```rust
+new(// Note);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| // Note | Passing the contexts to new(.. |
+
+### initialize
+
+```rust
+initialize(self, value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| value | T |
+
+### read
+
+```rust
+read(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### read
+
+```rust
+read(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### read
+
+```rust
+read(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/public_immutable/test.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/public_immutable/test.md
new file mode 100644
index 000000000000..16d7b2df228d
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/public_immutable/test.md
@@ -0,0 +1,53 @@
+## Standalone Functions
+
+### setup
+
+```rust
+setup();
+```
+
+Takes no parameters.
+
+### in_public
+
+```rust
+in_public(env);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| env | TestEnvironment |
+
+### test_uninitialized_by_default
+
+```rust
+test_uninitialized_by_default();
+```
+
+Takes no parameters.
+
+### test_initialize_uninitialized
+
+```rust
+test_initialize_uninitialized();
+```
+
+Takes no parameters.
+
+### test_initialize_already_initialized
+
+```rust
+test_initialize_already_initialized();
+```
+
+Takes no parameters.
+
+### test_read_uninitialized
+
+```rust
+test_read_uninitialized();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/public_mutable.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/public_mutable.md
new file mode 100644
index 000000000000..582851052aad
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/public_mutable.md
@@ -0,0 +1,58 @@
+## Standalone Functions
+
+### get_storage_slot
+
+```rust
+get_storage_slot(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### new
+
+```rust
+new(// Note);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| // Note | Passing the contexts to new(.. |
+
+### read
+
+```rust
+read(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### write
+
+```rust
+write(self, value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| value | T |
+
+### read
+
+```rust
+read(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/shared_mutable.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/shared_mutable.md
new file mode 100644
index 000000000000..9c77c51ce65a
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/shared_mutable.md
@@ -0,0 +1,175 @@
+## Standalone Functions
+
+### get_storage_slot
+
+```rust
+get_storage_slot(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### new
+
+```rust
+new(context, storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | Context |
+| storage_slot | Field |
+
+### schedule_value_change
+
+```rust
+schedule_value_change(self, new_value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| new_value | T |
+
+### schedule_and_return_value_change
+
+```rust
+schedule_and_return_value_change(self, new_value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| new_value | T |
+
+### schedule_delay_change
+
+```rust
+schedule_delay_change(self, new_delay);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| new_delay | u32 |
+
+### get_current_value
+
+```rust
+get_current_value(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_current_delay
+
+```rust
+get_current_delay(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_scheduled_value
+
+```rust
+get_scheduled_value(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_scheduled_delay
+
+```rust
+get_scheduled_delay(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### read_value_change
+
+```rust
+read_value_change(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### read_delay_change
+
+```rust
+read_delay_change(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### write
+
+```rust
+write(self, value_change, delay_change, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| value_change | ScheduledValueChange<T> |
+| delay_change | ScheduledDelayChange<INITIAL_DELAY> |
+| | |
+
+### get_current_value
+
+```rust
+get_current_value(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### historical_read_from_public_storage
+
+```rust
+historical_read_from_public_storage(self, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| | |
+
+### get_current_value
+
+```rust
+get_current_value(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/shared_mutable/test.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/shared_mutable/test.md
new file mode 100644
index 000000000000..60cbc6181075
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/shared_mutable/test.md
@@ -0,0 +1,207 @@
+## Standalone Functions
+
+### setup
+
+```rust
+setup();
+```
+
+Takes no parameters.
+
+### in_public
+
+```rust
+in_public(env, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| env | TestEnvironment |
+| | |
+
+### in_private
+
+```rust
+in_private(env, historical_block_number, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| env | &mut TestEnvironment |
+| historical_block_number | u32 |
+| | |
+
+### in_unconstrained
+
+```rust
+in_unconstrained(env, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| env | TestEnvironment |
+| | |
+
+### test_get_current_value_in_public_initial
+
+```rust
+test_get_current_value_in_public_initial();
+```
+
+Takes no parameters.
+
+### test_get_scheduled_value_in_public
+
+```rust
+test_get_scheduled_value_in_public();
+```
+
+Takes no parameters.
+
+### test_get_current_value_in_public_before_scheduled_change
+
+```rust
+test_get_current_value_in_public_before_scheduled_change();
+```
+
+Takes no parameters.
+
+### test_get_current_value_in_public_at_scheduled_change
+
+```rust
+test_get_current_value_in_public_at_scheduled_change();
+```
+
+Takes no parameters.
+
+### test_get_current_value_in_public_after_scheduled_change
+
+```rust
+test_get_current_value_in_public_after_scheduled_change();
+```
+
+Takes no parameters.
+
+### test_get_current_delay_in_public_initial
+
+```rust
+test_get_current_delay_in_public_initial();
+```
+
+Takes no parameters.
+
+### test_get_scheduled_delay_in_public
+
+```rust
+test_get_scheduled_delay_in_public();
+```
+
+Takes no parameters.
+
+### test_get_current_delay_in_public_before_scheduled_change
+
+```rust
+test_get_current_delay_in_public_before_scheduled_change();
+```
+
+Takes no parameters.
+
+### test_get_current_delay_in_public_at_scheduled_change
+
+```rust
+test_get_current_delay_in_public_at_scheduled_change();
+```
+
+Takes no parameters.
+
+### test_get_current_delay_in_public_after_scheduled_change
+
+```rust
+test_get_current_delay_in_public_after_scheduled_change();
+```
+
+Takes no parameters.
+
+### test_get_current_value_in_private_initial
+
+```rust
+test_get_current_value_in_private_initial();
+```
+
+Takes no parameters.
+
+### test_get_current_value_in_private_before_change
+
+```rust
+test_get_current_value_in_private_before_change();
+```
+
+Takes no parameters.
+
+### test_get_current_value_in_private_immediately_before_change
+
+```rust
+test_get_current_value_in_private_immediately_before_change();
+```
+
+Takes no parameters.
+
+### test_get_current_value_in_private_at_change
+
+```rust
+test_get_current_value_in_private_at_change();
+```
+
+Takes no parameters.
+
+### test_get_current_value_in_private_after_change
+
+```rust
+test_get_current_value_in_private_after_change();
+```
+
+Takes no parameters.
+
+### test_get_current_value_in_private_with_non_initial_delay
+
+```rust
+test_get_current_value_in_private_with_non_initial_delay();
+```
+
+Takes no parameters.
+
+### test_get_current_value_in_unconstrained_initial
+
+```rust
+test_get_current_value_in_unconstrained_initial();
+```
+
+Takes no parameters.
+
+### test_get_current_value_in_unconstrained_before_scheduled_change
+
+```rust
+test_get_current_value_in_unconstrained_before_scheduled_change();
+```
+
+Takes no parameters.
+
+### test_get_current_value_in_unconstrained_at_scheduled_change
+
+```rust
+test_get_current_value_in_unconstrained_at_scheduled_change();
+```
+
+Takes no parameters.
+
+### test_get_current_value_in_unconstrained_after_scheduled_change
+
+```rust
+test_get_current_value_in_unconstrained_after_scheduled_change();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/storage.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/storage.md
new file mode 100644
index 000000000000..4ba439af50c8
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/state_vars/storage.md
@@ -0,0 +1,22 @@
+# Storable
+
+Struct representing an exportable storage variable in the contract Every entry in the storage struct will be exported in the compilation artifact as a Storable entity, containing the storage slot
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub slot | Field |
+
+## Standalone Functions
+
+### get_storage_slot
+
+```rust
+get_storage_slot(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/test/helpers/cheatcodes.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/test/helpers/cheatcodes.md
new file mode 100644
index 000000000000..297d88157f14
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/test/helpers/cheatcodes.md
@@ -0,0 +1,312 @@
+## Standalone Functions
+
+### reset
+
+```rust
+reset();
+```
+
+Takes no parameters.
+
+### get_side_effects_counter
+
+```rust
+get_side_effects_counter();
+```
+
+Takes no parameters.
+
+### set_contract_address
+
+```rust
+set_contract_address(address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+
+### advance_blocks_by
+
+```rust
+advance_blocks_by(blocks);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| blocks | u32 |
+
+### get_private_context_inputs
+
+```rust
+get_private_context_inputs(historical_block_number, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| historical_block_number | u32 |
+| | |
+
+### deploy
+
+```rust
+deploy(path, name, initializer, args, secret, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| path | str<N> |
+| name | str<M> |
+| initializer | str<P> |
+| args | [Field] |
+| secret | Field |
+| | |
+
+### direct_storage_write
+
+```rust
+direct_storage_write(contract_address, storage_slot, fields, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| contract_address | AztecAddress |
+| storage_slot | Field |
+| fields | [Field; N] |
+| | |
+
+### create_account
+
+```rust
+create_account(secret);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| secret | Field |
+
+### add_account
+
+```rust
+add_account(secret);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| secret | Field |
+
+### derive_keys
+
+```rust
+derive_keys(secret);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| secret | Field |
+
+### add_authwit
+
+```rust
+add_authwit(address, message_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+| message_hash | Field |
+
+### assert_public_call_fails
+
+```rust
+assert_public_call_fails(target_address, function_selector, args, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| target_address | AztecAddress |
+| function_selector | FunctionSelector |
+| args | [Field] |
+| | |
+
+### assert_private_call_fails
+
+```rust
+assert_private_call_fails(target_address, function_selector, argsHash, sideEffectsCounter, isStaticCall, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| target_address | AztecAddress |
+| function_selector | FunctionSelector |
+| argsHash | Field |
+| sideEffectsCounter | Field |
+| isStaticCall | bool |
+| | |
+
+### oracle_reset
+
+```rust
+oracle_reset();
+```
+
+Takes no parameters.
+
+### oracle_set_contract_address
+
+```rust
+oracle_set_contract_address(address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+
+### oracle_get_side_effects_counter
+
+```rust
+oracle_get_side_effects_counter();
+```
+
+Takes no parameters.
+
+### oracle_advance_blocks_by
+
+```rust
+oracle_advance_blocks_by(blocks);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| blocks | u32 |
+
+### oracle_get_private_context_inputs
+
+```rust
+oracle_get_private_context_inputs(historical_block_number, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| historical_block_number | u32 |
+| | |
+
+### oracle_deploy
+
+```rust
+oracle_deploy(path, name, initializer, args, secret, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| path | str<N> |
+| name | str<M> |
+| initializer | str<P> |
+| args | [Field] |
+| secret | Field |
+| | |
+
+### direct_storage_write_oracle
+
+```rust
+direct_storage_write_oracle(_contract_address, _storage_slot, _values, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _contract_address | AztecAddress |
+| _storage_slot | Field |
+| _values | [Field; N] |
+| | |
+
+### oracle_create_account
+
+```rust
+oracle_create_account(secret);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| secret | Field |
+
+### oracle_add_account
+
+```rust
+oracle_add_account(secret);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| secret | Field |
+
+### oracle_derive_keys
+
+```rust
+oracle_derive_keys(secret);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| secret | Field |
+
+### oracle_add_authwit
+
+```rust
+oracle_add_authwit(address, message_hash);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| address | AztecAddress |
+| message_hash | Field |
+
+### oracle_assert_public_call_fails
+
+```rust
+oracle_assert_public_call_fails(target_address, function_selector, args, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| target_address | AztecAddress |
+| function_selector | FunctionSelector |
+| args | [Field] |
+| | |
+
+### oracle_assert_private_call_fails
+
+```rust
+oracle_assert_private_call_fails(target_address, function_selector, argsHash, sideEffectsCounter, isStaticCall, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| target_address | AztecAddress |
+| function_selector | FunctionSelector |
+| argsHash | Field |
+| sideEffectsCounter | Field |
+| isStaticCall | bool |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/test/helpers/test_environment.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/test/helpers/test_environment.md
new file mode 100644
index 000000000000..1577c224609d
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/test/helpers/test_environment.md
@@ -0,0 +1,267 @@
+# TestEnvironment
+
+## Methods
+
+### new
+
+```rust
+TestEnvironment::new();
+```
+
+Takes no parameters.
+
+### pending_block_number
+
+```rust
+TestEnvironment::pending_block_number(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### block_number
+
+```rust
+TestEnvironment::block_number(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | Self |
+
+### committed_block_number
+
+```rust
+TestEnvironment::committed_block_number(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | Self |
+
+### contract_address
+
+```rust
+TestEnvironment::contract_address(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### impersonate
+
+```rust
+TestEnvironment::impersonate(_self, address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+| address | AztecAddress |
+
+### advance_block_to
+
+```rust
+TestEnvironment::advance_block_to(&mut self, block_number);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| block_number | u32 |
+
+### advance_block_by
+
+```rust
+TestEnvironment::advance_block_by(_self, blocks);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | &mut Self |
+| blocks | u32 |
+
+### public
+
+```rust
+TestEnvironment::public(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### public_with_args_hash
+
+```rust
+TestEnvironment::public_with_args_hash(_self, args);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+| args | [Field] |
+
+### private
+
+```rust
+TestEnvironment::private(&mut self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+
+### unkonstrained
+
+```rust
+TestEnvironment::unkonstrained(_self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+
+### private_at
+
+```rust
+TestEnvironment::private_at(&mut self, historical_block_number);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| historical_block_number | u32 |
+
+### create_account
+
+```rust
+TestEnvironment::create_account(_self, secret);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+| secret | Field |
+
+### create_account_contract
+
+```rust
+TestEnvironment::create_account_contract(&mut self, secret);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| secret | Field |
+
+### deploy
+
+```rust
+TestEnvironment::deploy(_self, path, name, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+| path | str<N> |
+| name | str<M> |
+| | |
+
+### deploy_self
+
+```rust
+TestEnvironment::deploy_self(_self, name);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+| name | str<M> |
+
+### deploy_with_public_keys
+
+```rust
+TestEnvironment::deploy_with_public_keys(_self, path, name, secret, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+| path | str<N> |
+| name | str<M> |
+| secret | Field |
+| | |
+
+### deploy_self_with_public_keys
+
+```rust
+TestEnvironment::deploy_self_with_public_keys(_self, name, secret, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+| name | str<M> |
+| secret | Field |
+| | |
+
+### assert_public_call_fails
+
+```rust
+TestEnvironment::assert_public_call_fails(_self, call_interface);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+| call_interface | C |
+
+### assert_private_call_fails
+
+```rust
+TestEnvironment::assert_private_call_fails(_self, call_interface);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+| call_interface | C |
+
+### add_note
+
+```rust
+TestEnvironment::add_note(_self, note, storage_slot, contract_address, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+| note | Note |
+| storage_slot | Field |
+| contract_address | AztecAddress |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/test/helpers/utils.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/test/helpers/utils.md
new file mode 100644
index 000000000000..f3a6beb500cb
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/test/helpers/utils.md
@@ -0,0 +1,60 @@
+# TestAccount
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub address | AztecAddress |
+| pub keys | PublicKeys |
+
+## Standalone Functions
+
+### with_private_initializer
+
+```rust
+with_private_initializer(self, call_interface, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| call_interface | C |
+| | |
+
+### with_public_void_initializer
+
+```rust
+with_public_void_initializer(self, call_interface, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| call_interface | C |
+| | |
+
+### with_public_initializer
+
+```rust
+with_public_initializer(self, call_interface, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| call_interface | C |
+| | |
+
+### without_initializer
+
+```rust
+without_initializer(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/test/mocks/mock_note.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/test/mocks/mock_note.md
new file mode 100644
index 000000000000..7210aa8d8cce
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/test/mocks/mock_note.md
@@ -0,0 +1,136 @@
+# MockNote
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub(crate) value | Field |
+
+## Methods
+
+### new
+
+```rust
+MockNote::new(value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| value | Field |
+
+# MockNoteBuilder
+
+## Fields
+| Field | Type |
+| --- | --- |
+| value | Field |
+| contract_address | Option<AztecAddress> |
+| note_metadata | Option<NoteMetadata> |
+
+## Methods
+
+### new
+
+```rust
+MockNoteBuilder::new(value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| value | Field |
+
+### contract_address
+
+```rust
+MockNoteBuilder::contract_address(&mut self, contract_address);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| contract_address | AztecAddress |
+
+### note_metadata
+
+```rust
+MockNoteBuilder::note_metadata(&mut self, note_metadata);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| &mut self | |
+| note_metadata | NoteMetadata |
+
+### build_note
+
+```rust
+MockNoteBuilder::build_note(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### build_retrieved_note
+
+```rust
+MockNoteBuilder::build_retrieved_note(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+## Standalone Functions
+
+### get_id
+
+```rust
+get_id();
+```
+
+Takes no parameters.
+
+### compute_note_hash
+
+```rust
+compute_note_hash(self, storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | Self |
+| storage_slot | Field |
+
+### compute_nullifier
+
+```rust
+compute_nullifier(_self, _context, note_hash_for_nullify, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| _self | Self |
+| _context | &mut PrivateContext |
+| note_hash_for_nullify | Field |
+| | |
+
+### compute_nullifier_unconstrained
+
+```rust
+compute_nullifier_unconstrained(self, note_hash_for_nullify);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| note_hash_for_nullify | Field |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/test/mocks/mock_struct.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/test/mocks/mock_struct.md
new file mode 100644
index 000000000000..3536ea15d81d
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/test/mocks/mock_struct.md
@@ -0,0 +1,104 @@
+# MockStruct
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub a | Field |
+| pub b | Field |
+
+## Methods
+
+### new
+
+```rust
+MockStruct::new(a, b);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| a | Field |
+| b | Field |
+
+## Standalone Functions
+
+### eq
+
+```rust
+eq(self, other);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| other | Self |
+
+### empty
+
+```rust
+empty();
+```
+
+Takes no parameters.
+
+### serialize
+
+```rust
+serialize(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### deserialize
+
+```rust
+deserialize(fields);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| fields | [Field; 2] |
+
+### pack
+
+```rust
+pack(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### unpack
+
+```rust
+unpack(fields);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| fields | [Field; 2] |
+
+### test_serde
+
+```rust
+test_serde();
+```
+
+Takes no parameters.
+
+### test_packable
+
+```rust
+test_packable();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/unencrypted_logs/unencrypted_event_emission.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/unencrypted_logs/unencrypted_event_emission.md
new file mode 100644
index 000000000000..d3f602b1a9cf
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/unencrypted_logs/unencrypted_event_emission.md
@@ -0,0 +1,26 @@
+## Standalone Functions
+
+### emit
+
+```rust
+emit(context, event);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PublicContext |
+| event | Event |
+
+### encode_event
+
+```rust
+encode_event(context, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | &mut PublicContext |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/array/append.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/array/append.md
new file mode 100644
index 000000000000..cee6e53dddb4
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/array/append.md
@@ -0,0 +1,43 @@
+## Standalone Functions
+
+### append
+
+```rust
+append(a, A_LEN>, b, B_LEN>, );
+```
+
+/ large enough to fit all of the elements of both the first and second vectors.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| a | BoundedVec<T |
+| A_LEN> | |
+| b | BoundedVec<T |
+| B_LEN> | |
+| | |
+
+### append_empty_vecs
+
+```rust
+append_empty_vecs();
+```
+
+Takes no parameters.
+
+### append_non_empty_vecs
+
+```rust
+append_non_empty_vecs();
+```
+
+Takes no parameters.
+
+### append_non_empty_vecs_insufficient_max_len
+
+```rust
+append_non_empty_vecs_insufficient_max_len();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/array/collapse.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/array/collapse.md
new file mode 100644
index 000000000000..4aadedd2a54a
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/array/collapse.md
@@ -0,0 +1,147 @@
+## Standalone Functions
+
+### collapse
+
+```rust
+collapse(input);
+```
+
+/ `collapsed: [3, 1]`
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| input | [Option<T>; N] |
+
+### verify_collapse_hints
+
+```rust
+verify_collapse_hints(input, collapsed, N>, collapsed_to_input_index_mapping, N>, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| input | [Option<T>; N] |
+| collapsed | BoundedVec<T |
+| N> | |
+| collapsed_to_input_index_mapping | BoundedVec<u32 |
+| N> | |
+| | |
+
+### get_collapse_hints
+
+```rust
+get_collapse_hints(input, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| input | [Option<T>; N] |
+| | |
+
+### collapse_empty_array
+
+```rust
+collapse_empty_array();
+```
+
+Takes no parameters.
+
+### collapse_non_sparse_array
+
+```rust
+collapse_non_sparse_array();
+```
+
+Takes no parameters.
+
+### collapse_sparse_array
+
+```rust
+collapse_sparse_array();
+```
+
+Takes no parameters.
+
+### collapse_front_padding
+
+```rust
+collapse_front_padding();
+```
+
+Takes no parameters.
+
+### collapse_back_padding
+
+```rust
+collapse_back_padding();
+```
+
+Takes no parameters.
+
+### verify_collapse_hints_good_hints
+
+```rust
+verify_collapse_hints_good_hints();
+```
+
+Takes no parameters.
+
+### verify_collapse_hints_wrong_length
+
+```rust
+verify_collapse_hints_wrong_length();
+```
+
+Takes no parameters.
+
+### verify_collapse_hints_hint_length_mismatch
+
+```rust
+verify_collapse_hints_hint_length_mismatch();
+```
+
+Takes no parameters.
+
+### verify_collapse_hints_out_of_bounds_index_hint
+
+```rust
+verify_collapse_hints_out_of_bounds_index_hint();
+```
+
+Takes no parameters.
+
+### verify_collapse_hints_hint_to_none
+
+```rust
+verify_collapse_hints_hint_to_none();
+```
+
+Takes no parameters.
+
+### verify_collapse_hints_wrong_vec_content
+
+```rust
+verify_collapse_hints_wrong_vec_content();
+```
+
+Takes no parameters.
+
+### verify_collapse_hints_wrong_vec_order
+
+```rust
+verify_collapse_hints_wrong_vec_order();
+```
+
+Takes no parameters.
+
+### verify_collapse_hints_dirty_storage
+
+```rust
+verify_collapse_hints_dirty_storage();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/array/mod.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/array/mod.md
new file mode 100644
index 000000000000..8fcb48b36a3e
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/array/mod.md
@@ -0,0 +1,16 @@
+## Standalone Functions
+
+### for_each_in_bounded_vec
+
+```rust
+for_each_in_bounded_vec(vec, MaxLen>, f, u32);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| vec | BoundedVec<T |
+| MaxLen> | |
+| f | fn[Env](T |
+| u32 | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/array/subarray.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/array/subarray.md
new file mode 100644
index 000000000000..ae6406eead89
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/array/subarray.md
@@ -0,0 +1,57 @@
+## Standalone Functions
+
+### subarray
+
+```rust
+subarray(src, offset, );
+```
+
+/ ```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| src | [T; SRC_LEN] |
+| offset | u32 |
+| | |
+
+### subarray_into_empty
+
+```rust
+subarray_into_empty();
+```
+
+Takes no parameters.
+
+### subarray_complete
+
+```rust
+subarray_complete();
+```
+
+Takes no parameters.
+
+### subarray_different_end_sizes
+
+```rust
+subarray_different_end_sizes();
+```
+
+Takes no parameters.
+
+### subarray_offset_too_large
+
+```rust
+subarray_offset_too_large();
+```
+
+Takes no parameters.
+
+### subarray_bad_return_value
+
+```rust
+subarray_bad_return_value();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/array/subbvec.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/array/subbvec.md
new file mode 100644
index 000000000000..645350dd2f10
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/array/subbvec.md
@@ -0,0 +1,82 @@
+## Standalone Functions
+
+### subbvec
+
+```rust
+subbvec(bvec, SRC_MAX_LEN>, offset, );
+```
+
+/ ```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| bvec | BoundedVec<T |
+| SRC_MAX_LEN> | |
+| offset | u32 |
+| | |
+
+### subbvec_empty
+
+```rust
+subbvec_empty();
+```
+
+Takes no parameters.
+
+### subbvec_complete
+
+```rust
+subbvec_complete();
+```
+
+Takes no parameters.
+
+### subbvec_partial
+
+```rust
+subbvec_partial();
+```
+
+Takes no parameters.
+
+### subbvec_into_empty
+
+```rust
+subbvec_into_empty();
+```
+
+Takes no parameters.
+
+### subbvec_offset_past_len
+
+```rust
+subbvec_offset_past_len();
+```
+
+Takes no parameters.
+
+### subbvec_insufficient_dst_len
+
+```rust
+subbvec_insufficient_dst_len();
+```
+
+Takes no parameters.
+
+### subbvec_dst_len_causes_enlarge
+
+```rust
+subbvec_dst_len_causes_enlarge();
+```
+
+Takes no parameters.
+
+### subbvec_dst_len_too_large_for_offset
+
+```rust
+subbvec_dst_len_too_large_for_offset();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/comparison.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/comparison.md
new file mode 100644
index 000000000000..2755f026ba81
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/comparison.md
@@ -0,0 +1,35 @@
+# ComparatorEnum
+
+## Fields
+| Field | Type |
+| --- | --- |
+| pub EQ | u8 |
+| pub NEQ | u8 |
+| pub LT | u8 |
+| pub LTE | u8 |
+| pub GT | u8 |
+| pub GTE | u8 |
+
+## Standalone Functions
+
+### compare
+
+```rust
+compare(lhs, operation, rhs);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| lhs | Field |
+| operation | u8 |
+| rhs | Field |
+
+### test_compare
+
+```rust
+test_compare();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/conversion/bytes_to_fields.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/conversion/bytes_to_fields.md
new file mode 100644
index 000000000000..f7a08f0e9953
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/conversion/bytes_to_fields.md
@@ -0,0 +1,48 @@
+## Standalone Functions
+
+### bytes_to_fields
+
+```rust
+bytes_to_fields(bytes);
+```
+
+/ Note: N must be a multiple of 31 bytes
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| bytes | [u8; N] |
+
+### bytes_from_fields
+
+```rust
+bytes_from_fields(fields, N>);
+```
+
+/ back together in the order of the original fields.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| fields | BoundedVec<Field |
+| N> | |
+
+### random_bytes_to_fields_and_back
+
+```rust
+random_bytes_to_fields_and_back(input);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| input | [u8; 93] |
+
+### bytes_to_fields_input_length_not_multiple_of_31
+
+```rust
+bytes_to_fields_input_length_not_multiple_of_31();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/conversion/fields_to_bytes.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/conversion/fields_to_bytes.md
new file mode 100644
index 000000000000..8d68f95f9ddc
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/conversion/fields_to_bytes.md
@@ -0,0 +1,67 @@
+## Standalone Functions
+
+### fields_to_bytes
+
+```rust
+fields_to_bytes(fields);
+```
+
+/ indistinguishable from random bytes.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| fields | [Field; N] |
+
+### fields_from_bytes
+
+```rust
+fields_from_bytes(bytes, N>);
+```
+
+/ Note 2: The max value check code was taken from std::field::to_be_bytes function.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| bytes | BoundedVec<u8 |
+| N> | |
+
+### random_fields_to_bytes_and_back
+
+```rust
+random_fields_to_bytes_and_back(input);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| input | [Field; 3] |
+
+### to_fields_assert
+
+```rust
+to_fields_assert();
+```
+
+Takes no parameters.
+
+### fields_from_bytes_max_value
+
+```rust
+fields_from_bytes_max_value();
+```
+
+Takes no parameters.
+
+### fields_from_bytes_overflow
+
+```rust
+fields_from_bytes_overflow(random_value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| random_value | u8 |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/field.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/field.md
new file mode 100644
index 000000000000..28beaf1b4a45
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/field.md
@@ -0,0 +1,166 @@
+## Standalone Functions
+
+### pow
+
+```rust
+pow(x, y);
+```
+
+Adapted from std::field::pow_32.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| x | Field |
+| y | Field |
+
+### is_square
+
+```rust
+is_square(x);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| x | Field |
+
+### tonelli_shanks_sqrt
+
+```rust
+tonelli_shanks_sqrt(x);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| x | Field |
+
+### __sqrt
+
+```rust
+__sqrt(x);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| x | Field |
+
+### sqrt
+
+```rust
+sqrt(x);
+```
+
+Returns (true, sqrt) if there is a square root.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| x | Field |
+
+### validate_sqrt_hint
+
+```rust
+validate_sqrt_hint(x, hint);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| x | Field |
+| hint | Field |
+
+### validate_not_sqrt_hint
+
+```rust
+validate_not_sqrt_hint(x, hint);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| x | Field |
+| hint | Field |
+
+### test_sqrt
+
+```rust
+test_sqrt();
+```
+
+Takes no parameters.
+
+### test_non_square
+
+```rust
+test_non_square();
+```
+
+Takes no parameters.
+
+### test_known_non_residue_is_actually_a_non_residue_in_the_field
+
+```rust
+test_known_non_residue_is_actually_a_non_residue_in_the_field();
+```
+
+Takes no parameters.
+
+### test_sqrt_0
+
+```rust
+test_sqrt_0();
+```
+
+Takes no parameters.
+
+### test_sqrt_1
+
+```rust
+test_sqrt_1();
+```
+
+Takes no parameters.
+
+### test_bad_sqrt_hint_fails
+
+```rust
+test_bad_sqrt_hint_fails();
+```
+
+Takes no parameters.
+
+### test_bad_not_sqrt_hint_fails
+
+```rust
+test_bad_not_sqrt_hint_fails();
+```
+
+Takes no parameters.
+
+### test_0_not_sqrt_hint_fails
+
+```rust
+test_0_not_sqrt_hint_fails();
+```
+
+Takes no parameters.
+
+### test_is_square
+
+```rust
+test_is_square();
+```
+
+Takes no parameters.
+
+### test_is_not_square
+
+```rust
+test_is_not_square();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/point.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/point.md
new file mode 100644
index 000000000000..2c25553784d2
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/point.md
@@ -0,0 +1,75 @@
+## Standalone Functions
+
+### point_to_bytes
+
+```rust
+point_to_bytes(p);
+```
+
+/ to waste the extra byte (encrypted log).
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| p | Point |
+
+### get_sign_of_point
+
+```rust
+get_sign_of_point(p);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| p | Point |
+
+### point_from_x_coord
+
+```rust
+point_from_x_coord(x);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| x | Field |
+
+### point_from_x_coord_and_sign
+
+```rust
+point_from_x_coord_and_sign(x, sign);
+```
+
+/ @param sign - The "sign" of the y coordinate - determines whether y <= (Fr.MODULUS - 1) / 2
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| x | Field |
+| sign | bool |
+
+### test_point_to_bytes_positive_sign
+
+```rust
+test_point_to_bytes_positive_sign();
+```
+
+Takes no parameters.
+
+### test_point_to_bytes_negative_sign
+
+```rust
+test_point_to_bytes_negative_sign();
+```
+
+Takes no parameters.
+
+### test_point_from_x_coord_and_sign
+
+```rust
+test_point_from_x_coord_and_sign();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/random.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/random.md
new file mode 100644
index 000000000000..f9c8315ce4fe
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/random.md
@@ -0,0 +1,10 @@
+## Standalone Functions
+
+### get_random_bytes
+
+```rust
+get_random_bytes();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/secrets.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/secrets.md
new file mode 100644
index 000000000000..9cc5d82705d7
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/secrets.md
@@ -0,0 +1,18 @@
+# SecretAndHash
+
+## Fields
+| Field | Type |
+| --- | --- |
+| secret | Field |
+| hash | Field |
+
+## Methods
+
+### random
+
+```rust
+SecretAndHash::random();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/to_bytes.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/to_bytes.md
new file mode 100644
index 000000000000..215eb5c7d159
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/to_bytes.md
@@ -0,0 +1,26 @@
+## Standalone Functions
+
+### arr_to_be_bytes_arr
+
+```rust
+arr_to_be_bytes_arr(fields);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| fields | [Field; L] |
+
+### str_to_be_bytes_arr
+
+```rust
+str_to_be_bytes_arr(string);
+```
+
+then an ACVM field via the oracle => we recreate here
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| string | str<L> |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/with_hash.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/with_hash.md
new file mode 100644
index 000000000000..4ed8cb274b1c
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/aztec/utils/with_hash.md
@@ -0,0 +1,136 @@
+## Standalone Functions
+
+### new
+
+```rust
+new(value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| value | T |
+
+### get_value
+
+```rust
+get_value(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### get_hash
+
+```rust
+get_hash(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### public_storage_read
+
+```rust
+public_storage_read(context, storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | PublicContext |
+| storage_slot | Field |
+
+### unconstrained_public_storage_read
+
+```rust
+unconstrained_public_storage_read(context, storage_slot, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | UnconstrainedContext |
+| storage_slot | Field |
+| | |
+
+### historical_public_storage_read
+
+```rust
+historical_public_storage_read(header, address, storage_slot, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| header | BlockHeader |
+| address | AztecAddress |
+| storage_slot | Field |
+| | |
+
+### pack
+
+```rust
+pack(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### unpack
+
+```rust
+unpack(packed);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| packed | [Field; N + 1] |
+
+### create_and_recover
+
+```rust
+create_and_recover();
+```
+
+Takes no parameters.
+
+### read_uninitialized_value
+
+```rust
+read_uninitialized_value();
+```
+
+Takes no parameters.
+
+### read_initialized_value
+
+```rust
+read_initialized_value();
+```
+
+Takes no parameters.
+
+### test_bad_hint_uninitialized_value
+
+```rust
+test_bad_hint_uninitialized_value();
+```
+
+Takes no parameters.
+
+### test_bad_hint_initialized_value
+
+```rust
+test_bad_hint_initialized_value();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/compressed-string/compressed_string.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/compressed-string/compressed_string.md
new file mode 100644
index 000000000000..d4716b947670
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/compressed-string/compressed_string.md
@@ -0,0 +1,99 @@
+## Standalone Functions
+
+### from_string
+
+```rust
+from_string(input_string);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| input_string | str<M> |
+
+### to_bytes
+
+```rust
+to_bytes(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### eq
+
+```rust
+eq(self, other, M>);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| other | CompressedString<N |
+| M> | |
+
+### serialize
+
+```rust
+serialize(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### deserialize
+
+```rust
+deserialize(input);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| input | [Field; N] |
+
+### test_short_string
+
+```rust
+test_short_string();
+```
+
+Takes no parameters.
+
+### test_long_string
+
+```rust
+test_long_string();
+```
+
+Takes no parameters.
+
+### test_long_string_work_with_too_many_fields
+
+```rust
+test_long_string_work_with_too_many_fields();
+```
+
+Takes no parameters.
+
+### test_serde
+
+```rust
+test_serde();
+```
+
+Takes no parameters.
+
+### test_long_string_fail_with_too_few_fields
+
+```rust
+test_long_string_fail_with_too_few_fields();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/compressed-string/field_compressed_string.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/compressed-string/field_compressed_string.md
new file mode 100644
index 000000000000..5d30c34e5eaf
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/compressed-string/field_compressed_string.md
@@ -0,0 +1,54 @@
+# FieldCompressedString
+
+## Fields
+| Field | Type |
+| --- | --- |
+| value | Field |
+
+## Methods
+
+### is_eq
+
+```rust
+FieldCompressedString::is_eq(self, other);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| other | FieldCompressedString |
+
+### from_field
+
+```rust
+FieldCompressedString::from_field(input_field);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| input_field | Field |
+
+### from_string
+
+```rust
+FieldCompressedString::from_string(input_string);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| input_string | str<31> |
+
+### to_bytes
+
+```rust
+FieldCompressedString::to_bytes(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/easy-private-state/easy_private_uint.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/easy-private-state/easy_private_uint.md
new file mode 100644
index 000000000000..2bcaf4e848ad
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/easy-private-state/easy_private_uint.md
@@ -0,0 +1,44 @@
+## Standalone Functions
+
+### new
+
+```rust
+new(context, storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| context | Context |
+| storage_slot | Field |
+
+### add
+
+```rust
+add(self, addend, owner, sender);
+```
+
+Very similar to `value_note::utils::increment`.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| addend | u64 |
+| owner | AztecAddress |
+| sender | AztecAddress |
+
+### sub
+
+```rust
+sub(self, subtrahend, owner, sender);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| subtrahend | u64 |
+| owner | AztecAddress |
+| sender | AztecAddress |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/macro_compilation_failure_tests/failure_contracts/marked_private_unconstrained/main.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/macro_compilation_failure_tests/failure_contracts/marked_private_unconstrained/main.md
new file mode 100644
index 000000000000..df0bdc4a3ba5
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/macro_compilation_failure_tests/failure_contracts/marked_private_unconstrained/main.md
@@ -0,0 +1,10 @@
+## Standalone Functions
+
+### unconstrained_private_function
+
+```rust
+unconstrained_private_function();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/macro_compilation_failure_tests/failure_contracts/marked_public_unconstrained/main.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/macro_compilation_failure_tests/failure_contracts/marked_public_unconstrained/main.md
new file mode 100644
index 000000000000..8b5844a94f17
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/macro_compilation_failure_tests/failure_contracts/marked_public_unconstrained/main.md
@@ -0,0 +1,10 @@
+## Standalone Functions
+
+### unconstrained_public_function
+
+```rust
+unconstrained_public_function();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/uint-note/uint_note.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/uint-note/uint_note.md
new file mode 100644
index 000000000000..117879825cdf
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/uint-note/uint_note.md
@@ -0,0 +1,208 @@
+# UintNote
+
+## Fields
+| Field | Type |
+| --- | --- |
+| owner | AztecAddress |
+| randomness | Field |
+| value | u128 |
+
+## Methods
+
+### new
+
+```rust
+UintNote::new(value, owner);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| value | u128 |
+| owner | AztecAddress |
+
+### get_value
+
+```rust
+UintNote::get_value(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### partial
+
+/ Creates a partial note that will hide the owner and storage slot but not the value, since the note will be later / completed in public. This is a powerful technique for scenarios in which the value cannot be known in private / (e.g. because it depends on some public state, such as a DEX). /// The returned `PartialUintNote` value must be sent to public execution via a secure channel, since it is not / possible to verify the integrity of its contents due to it hiding information. The recommended ways to do this / are to retrieve it from public storage, or to receive it in an internal public function call. /// Each partial note should only be used once, since otherwise multiple notes would be linked together and known to / belong to the same owner. /// As part of the partial note creation process, a log will be sent to `recipient` from `sender` so that they can / discover the note. `recipient` will typically be the same as `owner`.
+
+```rust
+UintNote::partial(owner, storage_slot, context, recipient, sender, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| owner | AztecAddress |
+| storage_slot | Field |
+| context | &mut PrivateContext |
+| recipient | AztecAddress |
+| sender | AztecAddress |
+| | |
+
+# UintPartialNotePrivateContent
+
+## Fields
+| Field | Type |
+| --- | --- |
+| owner | AztecAddress |
+| randomness | Field |
+
+## Methods
+
+### compute_partial_commitment
+
+```rust
+UintPartialNotePrivateContent::compute_partial_commitment(self, storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| storage_slot | Field |
+
+# PrivateUintPartialNotePrivateLogContent
+
+## Fields
+| Field | Type |
+| --- | --- |
+| public_log_tag | Field |
+| owner | AztecAddress |
+| randomness | Field |
+
+# PartialUintNote
+
+## Fields
+| Field | Type |
+| --- | --- |
+| commitment | Field |
+
+## Methods
+
+### commitment
+
+```rust
+PartialUintNote::commitment(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
+### complete
+
+/ Completes the partial note, creating a new note that can be used like any other UintNote.
+
+```rust
+PartialUintNote::complete(self, value, context);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| value | u128 |
+| context | &mut PublicContext |
+
+### compute_note_completion_log
+
+```rust
+PartialUintNote::compute_note_completion_log(self, value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| value | u128 |
+
+### compute_complete_note_hash
+
+```rust
+PartialUintNote::compute_complete_note_hash(self, value);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| value | u128 |
+
+## Standalone Functions
+
+### compute_note_hash
+
+```rust
+compute_note_hash(self, storage_slot);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| storage_slot | Field |
+
+### compute_nullifier
+
+```rust
+compute_nullifier(self, context, note_hash_for_nullify, );
+```
+
+#[note] macro.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| context | &mut PrivateContext |
+| note_hash_for_nullify | Field |
+| | |
+
+### compute_nullifier_unconstrained
+
+```rust
+compute_nullifier_unconstrained(self, note_hash_for_nullify);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+| note_hash_for_nullify | Field |
+
+### get_id
+
+```rust
+get_id();
+```
+
+Takes no parameters.
+
+### note_hash_matches_completed_partial_note_hash
+
+```rust
+note_hash_matches_completed_partial_note_hash();
+```
+
+Takes no parameters.
+
+### unpack_from_partial_note_encoding
+
+```rust
+unpack_from_partial_note_encoding();
+```
+
+Takes no parameters.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/value-note/balance_utils.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/value-note/balance_utils.md
new file mode 100644
index 000000000000..92d907a67802
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/value-note/balance_utils.md
@@ -0,0 +1,28 @@
+## Standalone Functions
+
+### get_balance
+
+```rust
+get_balance(set, UnconstrainedContext>);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| set | PrivateSet<ValueNote |
+| UnconstrainedContext> | |
+
+### get_balance_with_offset
+
+```rust
+get_balance_with_offset(set, UnconstrainedContext>, offset, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| set | PrivateSet<ValueNote |
+| UnconstrainedContext> | |
+| offset | u32 |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/value-note/filter.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/value-note/filter.md
new file mode 100644
index 000000000000..8302a1a0be48
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/value-note/filter.md
@@ -0,0 +1,15 @@
+## Standalone Functions
+
+### filter_notes_min_sum
+
+```rust
+filter_notes_min_sum(notes, min_sum, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| notes | [Option<RetrievedNote<ValueNote>>; MAX_NOTE_HASH_READ_REQUESTS_PER_CALL] |
+| min_sum | Field |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/value-note/utils.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/value-note/utils.md
new file mode 100644
index 000000000000..7c3c3db432bc
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/value-note/utils.md
@@ -0,0 +1,66 @@
+## Standalone Functions
+
+### create_note_getter_options_for_decreasing_balance
+
+```rust
+create_note_getter_options_for_decreasing_balance(amount, );
+```
+
+Pick the fewest notes whose sum is equal to or greater than `amount`.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| amount | Field |
+| | |
+
+### increment
+
+```rust
+increment(// docs, &mut PrivateContext>, amount, recipient, // docs, );
+```
+
+Inserts it to the recipient's set of notes.
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| // docs | start |
+| &mut PrivateContext> | |
+| amount | Field |
+| recipient | AztecAddress |
+| // docs | end |
+| | |
+
+### decrement
+
+```rust
+decrement(balance, &mut PrivateContext>, amount, owner, sender, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| balance | PrivateSet<ValueNote |
+| &mut PrivateContext> | |
+| amount | Field |
+| owner | AztecAddress |
+| sender | AztecAddress |
+| | |
+
+### decrement_by_at_most
+
+```rust
+decrement_by_at_most(balance, &mut PrivateContext>, max_amount, owner, sender, );
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| balance | PrivateSet<ValueNote |
+| &mut PrivateContext> | |
+| max_amount | Field |
+| owner | AztecAddress |
+| sender | AztecAddress |
+| | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/value-note/value_note.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/value-note/value_note.md
new file mode 100644
index 000000000000..b6166af3bf68
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/aztec-nr/value-note/value_note.md
@@ -0,0 +1,34 @@
+# ValueNote
+
+## Fields
+| Field | Type |
+| --- | --- |
+| value | Field |
+| owner | AztecAddress |
+| randomness | Field |
+
+## Methods
+
+### new
+
+```rust
+ValueNote::new(value, owner);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| value | Field |
+| owner | AztecAddress |
+
+### value
+
+```rust
+ValueNote::value(self);
+```
+
+#### Parameters
+| Name | Type |
+| --- | --- |
+| self | |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/contract_artifact.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/contract_artifact.md
new file mode 100644
index 000000000000..9c9fbbce73c0
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/contract_artifact.md
@@ -0,0 +1,110 @@
+---
+title: "Contract Artifact Reference"
+tags: [contracts]
+---
+
+After compiling a contract you'll get a Contract Artifact file, that contains the data needed to interact with a specific contract, including its name, functions that can be executed, and the interface and code of those functions. Since private functions are not published in the Aztec network, you'll need this artifact file to be able to call private functions of contracts.
+
+The artifact file can be used with `aztec.js` to instantiate contract objects and interact with them.
+
+## Contract Artifact Structure
+
+The structure of a contract artifact is as follows:
+```json
+{
+ "name": "CardGame",
+ "functions": [
+ {
+ "name": "constructor",
+ "functionType": "private",
+ "isInternal": false,
+ "parameters": [],
+ "returnTypes": [],
+ "bytecode": "...",
+ "verificationKey": "..."
+ },
+ {
+ "name": "on_card_played",
+ "functionType": "public",
+ "isInternal": true,
+ "parameters": [
+ {
+ "name": "game",
+ "type": {
+ "kind": "integer",
+ "sign": "unsigned",
+ "width": 32
+ },
+ "visibility": "private"
+ },
+ {
+ "name": "player",
+ "type": {
+ "kind": "field"
+ },
+ "visibility": "private"
+ },
+ {
+ "name": "card_as_field",
+ "type": {
+ "kind": "field"
+ },
+ "visibility": "private"
+ }
+ ],
+ "returnTypes": [
+ ...
+ ],
+ "bytecode": "...",
+ "verificationKey": "..."
+ },
+ ...
+ ]
+}
+
+```
+
+### `name`
+It is a simple string that matches the name that the contract developer used for this contract in noir. It's used for logs and errors.
+
+### `functions`
+A contract is a collection of several functions that can be called. Each function has the following properties:
+
+#### `function.name`
+A simple string that matches the name that the contract developer used for this function in noir. For logging and debugging purposes.
+
+#### `function.functionType`
+The function type can have one of the following values:
+
+- Private: The function is ran and proved locally by the clients, and its bytecode not published to the network.
+- Public: The function is ran and proved by the sequencer, and its bytecode is published to the network.
+- Unconstrained: The function is ran locally by the clients to generate digested information useful for the user. It's not meant to be transacted against.
+
+#### `function.isInternal`
+The is internal property is a boolean that indicates whether the function is internal to the contract and cannot be called from outside.
+
+#### `function.parameters`
+Each function can have multiple parameters that are arguments to execute the function. Parameters have a name, and type (like integers, strings, or complex types like arrays and structures).
+
+#### `function.returnTypes`
+The return types property defines the types of values that the function returns after execution.
+
+#### `function.bytecode`
+The bytecode is a string representing the compiled ACIR of the function, ready for execution on the network.
+
+#### `function.verificationKey`
+The verification key is an optional property that contains the verification key of the function. This key is used to verify the proof of the function execution.
+
+### `debug` (Optional)
+Although not significant for non-developer users, it is worth mentioning that there is a debug section in the contract artifact which helps contract developers to debug and test their contracts. This section mainly contains debug symbols and file maps that link back to the original source code.
+
+## Understanding Parameter and Return Types
+To make the most of the functions, it's essential to understand the types of parameters and return values. Here are some common types you might encounter:
+
+ - `field`: A basic type representing a field element in the finite field of the curve used in the Aztec protocol.
+ - `boolean`: A simple true/false value.
+ - `integer`: Represents whole numbers. It has attributes defining its sign (positive or negative) and width (the number of bits representing the integer).
+ - `array`: Represents a collection of elements, all of the same type. It has attributes defining its length and the type of elements it holds.
+ - `string`: Represents a sequence of characters with a specified length.
+ - `struct`: A complex type representing a structure with various fields, each having a specific type and name.
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/dependencies.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/dependencies.md
new file mode 100644
index 000000000000..0ec28c2686b9
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/dependencies.md
@@ -0,0 +1,55 @@
+---
+title: Importing Aztec.nr
+tags: [contracts]
+sidebar_position: 5
+---
+
+On this page you will find information about Aztec.nr libraries and up-to-date paths for use in your `Nargo.toml`.
+
+## Aztec
+
+```toml
+aztec = { git="https://github.com/AztecProtocol/aztec-packages/", tag="v0.82.2", directory="noir-projects/aztec-nr/aztec" }
+```
+
+This is the core Aztec library that is required for every Aztec.nr smart contract.
+
+## Authwit
+
+```toml
+authwit = { git="https://github.com/AztecProtocol/aztec-packages/", tag="v0.82.2", directory="noir-projects/aztec-nr/authwit"}
+```
+
+This allows you to use authentication witnesses in your contract. Read a guide of how to use it [here](../../guides/smart_contracts/writing_contracts/authwit.md).
+
+## Address note
+
+```toml
+address_note = { git="https://github.com/AztecProtocol/aztec-packages/", tag="v0.82.2", directory="noir-projects/aztec-nr/address-note" }
+```
+
+This is a library for utilizing notes that hold addresses. Find it on [GitHub](https://github.com/AztecProtocol/aztec-packages/tree/master/noir-projects/aztec-nr/address-note/src).
+
+## Easy private state
+
+```toml
+easy_private_state = { git="https://github.com/AztecProtocol/aztec-packages/", tag="v0.82.2", directory="noir-projects/aztec-nr/easy-private-state" }
+```
+
+This is an abstraction library for using private variables like [`EasyPrivateUint` (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/6c20b45993ee9cbd319ab8351e2722e0c912f427/noir-projects/aztec-nr/easy-private-state/src/easy_private_state.nr#L17).
+
+## Protocol Types
+
+```toml
+protocol_types = { git="https://github.com/AztecProtocol/aztec-packages/", tag="v0.82.2", directory="noir-projects/noir-protocol-circuits/crates/types"}
+```
+
+This library contains types that are used in the Aztec protocol. Find it on [GitHub](https://github.com/AztecProtocol/aztec-packages/tree/master/noir-projects/noir-protocol-circuits/crates/types/src).
+
+## Value note
+
+```toml
+value_note = { git="https://github.com/AztecProtocol/aztec-packages/", tag="v0.82.2", directory="noir-projects/aztec-nr/value-note" }
+```
+
+This is a library for a note that stores one arbitrary value. You can see an example of how it might be used in the [crowdfunding contract codealong tutorial](../../tutorials/codealong/contract_tutorials/crowdfunding_contract.md).
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/globals.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/globals.md
new file mode 100644
index 000000000000..88580df40866
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/globals.md
@@ -0,0 +1,86 @@
+---
+title: Global Variables
+description: Documentation of Aztec's Global Variables in the Public and Private Contexts
+sidebar_position: 2
+---
+
+# Global Variables
+
+For developers coming from solidity, this concept will be similar to how the global `block` variable exposes a series of block values. The idea is the same in Aztec. Developers can access a namespace of values made available in each function.
+
+`Aztec` has two execution environments, Private and Public. Each execution environment contains a different global variables object.
+
+## Private Global Variables
+
+```rust title="tx-context" showLineNumbers
+pub struct TxContext {
+ pub chain_id: Field,
+ pub version: Field,
+ pub gas_settings: GasSettings,
+}
+```
+> Source code: noir-projects/noir-protocol-circuits/crates/types/src/transaction/tx_context.nr#L8-L14
+
+
+The private global variables are equal to the transaction context and contain:
+
+### Chain Id
+
+The chain id differs depending on which Aztec instance you are on ( NOT the Ethereum hardfork that the rollup is settling to ). On original deployment of the network, this value will be 1.
+
+```rust
+context.chain_id();
+```
+
+### Version
+
+The version number indicates which Aztec hardfork you are on. The Genesis block of the network will have the version number 1.
+
+```rust
+context.version();
+```
+
+### Gas Settings
+
+The gas limits set by the user for the transaction, the max fee per gas, and the inclusion fee.
+
+## Public Global Variables
+
+```rust title="global-variables" showLineNumbers
+pub struct GlobalVariables {
+ pub chain_id: Field,
+ pub version: Field,
+ pub block_number: Field,
+ pub slot_number: Field,
+ pub timestamp: u64,
+ pub coinbase: EthAddress,
+ pub fee_recipient: AztecAddress,
+ pub gas_fees: GasFees,
+}
+```
+> Source code: noir-projects/noir-protocol-circuits/crates/types/src/abis/global_variables.nr#L9-L20
+
+
+The public global variables contain the values present in the `private global variables` described above, with the addition of:
+
+### Timestamp
+
+The timestamp is the unix timestamp in which the block has been executed. The value is provided by the block's proposer (therefore can have variance). This value will always increase.
+
+```rust
+context.timestamp();
+```
+
+### Block Number
+
+The block number is a sequential identifier that labels each individual block of the network. This value will be the block number of the block the accessing transaction is included in.
+The block number of the genesis block will be 1, with the number increasing by 1 for every block after.
+
+```rust
+context.block_number();
+```
+
+:::info _Why do the available global variables differ per execution environment?_
+The global variables are constrained by the proving environment. In the case of public functions, they are executed on a sequencer that will know the timestamp and number of the next block ( as they are the block producer ).
+In the case of private functions, we cannot be sure which block our transaction will be included in, hence we can not guarantee values for the timestamp or block number.
+:::
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/macros.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/macros.md
new file mode 100644
index 000000000000..cabe9000e99c
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/macros.md
@@ -0,0 +1,22 @@
+---
+title: Aztec macros
+sidebar_position: 6
+tags: [contracts, functions]
+---
+
+## All Aztec macros
+
+In addition to the function macros in Noir, Aztec also has its own macros for specific functions. An Aztec contract function can be annotated with more than 1 macro.
+It is also worth mentioning Noir's `unconstrained` function type [here (Noir docs page)](https://noir-lang.org/docs/noir/concepts/unconstrained/).
+
+- `#[aztec]` - Defines a contract, placed above `contract ContractName{}`
+- `#[public]` or `#[private]` - Whether the function is to be executed from a public or private context (see Further Reading)
+- `#[initializer]` - If one or more functions are marked as an initializer, then one of them must be called before any non-initializer functions
+- `#[noinitcheck]` - The function is able to be called before an initializer (if one exists)
+- `#[view]` - Makes calls to the function static
+- `#[internal]` - Function can only be called from within the contract
+- `#[note]` - Creates a custom note
+- `#[storage]` - Defines contract storage
+
+## Further reading
+[How do Aztec macros work?](../../../aztec/smart_contracts/functions/function_transforms.md)
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/portals/_category_.json b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/portals/_category_.json
new file mode 100644
index 000000000000..3a04a4bcda85
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/portals/_category_.json
@@ -0,0 +1,6 @@
+{
+ "label": "Portals",
+ "position": 4,
+ "collapsible": true,
+ "collapsed": true
+}
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/portals/data_structures.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/portals/data_structures.md
new file mode 100644
index 000000000000..fbb8e874ca00
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/portals/data_structures.md
@@ -0,0 +1,139 @@
+---
+title: Data Structures
+---
+
+The `DataStructures` are structs that we are using throughout the message infrastructure and registry.
+
+**Links**: [Implementation (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/master/l1-contracts/src/core/libraries/DataStructures.sol).
+
+## `L1Actor`
+
+An entity on L1, specifying the address and the chainId for the entity. Used when specifying sender/recipient with an entity that is on L1.
+
+```solidity title="l1_actor" showLineNumbers
+/**
+ * @notice Actor on L1.
+ * @param actor - The address of the actor
+ * @param chainId - The chainId of the actor
+ */
+struct L1Actor {
+ address actor;
+ uint256 chainId;
+}
+```
+> Source code: l1-contracts/src/core/libraries/DataStructures.sol#L11-L21
+
+
+| Name | Type | Description |
+| -------------- | ------- | ----------- |
+| `actor` | `address` | The L1 address of the actor |
+| `chainId` | `uint256` | The chainId of the actor. Defines the blockchain that the actor lives on. |
+
+
+## `L2Actor`
+
+An entity on L2, specifying the address and the version for the entity. Used when specifying sender/recipient with an entity that is on L2.
+
+```solidity title="l2_actor" showLineNumbers
+/**
+ * @notice Actor on L2.
+ * @param actor - The aztec address of the actor
+ * @param version - Ahe Aztec instance the actor is on
+ */
+struct L2Actor {
+ bytes32 actor;
+ uint256 version;
+}
+```
+> Source code: l1-contracts/src/core/libraries/DataStructures.sol#L23-L33
+
+
+| Name | Type | Description |
+| -------------- | ------- | ----------- |
+| `actor` | `bytes32` | The aztec address of the actor. |
+| `version` | `uint256` | The version of Aztec that the actor lives on. |
+
+## `L1ToL2Message`
+
+A message that is sent from L1 to L2.
+
+```solidity title="l1_to_l2_msg" showLineNumbers
+/**
+ * @notice Struct containing a message from L1 to L2
+ * @param sender - The sender of the message
+ * @param recipient - The recipient of the message
+ * @param content - The content of the message (application specific) padded to bytes32 or hashed if larger.
+ * @param secretHash - The secret hash of the message (make it possible to hide when a specific message is consumed on L2).
+ * @param index - Global leaf index on the L1 to L2 messages tree.
+ */
+struct L1ToL2Msg {
+ L1Actor sender;
+ L2Actor recipient;
+ bytes32 content;
+ bytes32 secretHash;
+ uint256 index;
+}
+```
+> Source code: l1-contracts/src/core/libraries/DataStructures.sol#L35-L51
+
+
+| Name | Type | Description |
+| -------------- | ------- | ----------- |
+| `sender` | `L1Actor` | The actor on L1 that is sending the message. |
+| `recipient` | `L2Actor` | The actor on L2 that is to receive the message. |
+| `content` | `field (~254 bits)` | The field element containing the content to be sent to L2. |
+| `secretHash` | `field (~254 bits)` | The hash of a secret pre-image that must be known to consume the message on L2. Use [`computeSecretHash` (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/master/yarn-project/aztec.js/src/utils/secrets.ts) to compute it from a secret. |
+
+## `L2ToL1Message`
+
+A message that is sent from L2 to L1.
+
+```solidity title="l2_to_l1_msg" showLineNumbers
+/**
+ * @notice Struct containing a message from L2 to L1
+ * @param sender - The sender of the message
+ * @param recipient - The recipient of the message
+ * @param content - The content of the message (application specific) padded to bytes32 or hashed if larger.
+ * @dev Not to be confused with L2ToL1Message in Noir circuits
+ */
+struct L2ToL1Msg {
+ DataStructures.L2Actor sender;
+ DataStructures.L1Actor recipient;
+ bytes32 content;
+}
+```
+> Source code: l1-contracts/src/core/libraries/DataStructures.sol#L53-L66
+
+
+| Name | Type | Description |
+| -------------- | ------- | ----------- |
+| `sender` | `L2Actor` | The actor on L2 that is sending the message. |
+| `recipient` | `L1Actor` | The actor on L1 that is to receive the message. |
+| `content` | `field (~254 bits)` | The field element containing the content to be consumed by the portal on L1. |
+
+## `RegistrySnapshot`
+
+A snapshot of the registry values.
+
+```solidity title="registry_snapshot" showLineNumbers
+/**
+ * @notice Struct for storing address of cross communication components and the block number when it was updated
+ * @param rollup - The address of the rollup contract
+ * @param blockNumber - The block number of the snapshot
+ */
+struct RegistrySnapshot {
+ address rollup;
+ uint256 blockNumber;
+}
+```
+> Source code: l1-contracts/src/governance/libraries/DataStructures.sol#L14-L24
+
+
+| Name | Type | Description |
+| -------------- | ------- | ----------- |
+| `rollup` | `address` | The address of the rollup contract for the snapshot. |
+| `blockNumber` | `uint256` | The block number at which the snapshot was created. |
+
+
+
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/portals/inbox.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/portals/inbox.md
new file mode 100644
index 000000000000..79d840a2d3d6
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/portals/inbox.md
@@ -0,0 +1,72 @@
+---
+title: Inbox
+tags: [portals, contracts]
+---
+
+The `Inbox` is a contract deployed on L1 that handles message passing from L1 to the rollup (L2)
+
+**Links**: [Interface (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/master/l1-contracts/src/core/interfaces/messagebridge/IInbox.sol), [Implementation (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/master/l1-contracts/src/core/messagebridge/Inbox.sol).
+
+## `sendL2Message()`
+
+Sends a message from L1 to L2.
+
+```solidity title="send_l1_to_l2_message" showLineNumbers
+/**
+ * @notice Inserts a new message into the Inbox
+ * @dev Emits `MessageSent` with data for easy access by the sequencer
+ * @param _recipient - The recipient of the message
+ * @param _content - The content of the message (application specific)
+ * @param _secretHash - The secret hash of the message (make it possible to hide when a specific message is consumed on L2)
+ * @return The key of the message in the set and its leaf index in the tree
+ */
+function sendL2Message(
+ DataStructures.L2Actor memory _recipient,
+ bytes32 _content,
+ bytes32 _secretHash
+) external returns (bytes32, uint256);
+```
+> Source code: l1-contracts/src/core/interfaces/messagebridge/IInbox.sol#L21-L35
+
+
+
+| Name | Type | Description |
+| -------------- | ------- | ----------- |
+| Recipient | `L2Actor` | The recipient of the message. This **MUST** match the rollup version and an Aztec contract that is **attached** to the contract making this call. If the recipient is not attached to the caller, the message cannot be consumed by it. |
+| Content | `field` (~254 bits) | The content of the message. This is the data that will be passed to the recipient. The content is limited to be a single field for rollup purposes. If the content is small enough it can just be passed along, otherwise it should be hashed and the hash passed along (you can use our [`Hash` (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/master/l1-contracts/src/core/libraries/Hash.sol) utilities with `sha256ToField` functions) |
+| Secret Hash | `field` (~254 bits) | A hash of a secret that is used when consuming the message on L2. Keep this preimage a secret to make the consumption private. To consume the message the caller must know the pre-image (the value that was hashed) - so make sure your app keeps track of the pre-images! Use [`computeSecretHash` (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/master/yarn-project/aztec.js/src/utils/secrets.ts) to compute it from a secret. |
+| ReturnValue | `bytes32` | The message hash, used as an identifier |
+
+#### Edge cases
+
+- Will revert with `Inbox__ActorTooLarge(bytes32 actor)` if the recipient is larger than the field size (~254 bits).
+- Will revert with `Inbox__ContentTooLarge(bytes32 content)` if the content is larger than the field size (~254 bits).
+- Will revert with `Inbox__SecretHashTooLarge(bytes32 secretHash)` if the secret hash is larger than the field size (~254 bits).
+
+## `consume()`
+
+Allows the `Rollup` to consume multiple messages in a single transaction.
+
+```solidity title="consume" showLineNumbers
+/**
+ * @notice Consumes the current tree, and starts a new one if needed
+ * @dev Only callable by the rollup contract
+ * @dev In the first iteration we return empty tree root because first block's messages tree is always
+ * empty because there has to be a 1 block lag to prevent sequencer DOS attacks
+ *
+ * @param _toConsume - The block number to consume
+ *
+ * @return The root of the consumed tree
+ */
+function consume(uint256 _toConsume) external returns (bytes32);
+```
+> Source code: l1-contracts/src/core/interfaces/messagebridge/IInbox.sol#L37-L49
+
+
+| Name | Type | Description |
+| -------------- | ----------- | -------------------------- |
+| ReturnValue | `bytes32` | Root of the consumed tree. |
+
+#### Edge cases
+
+- Will revert with `Inbox__Unauthorized()` if `msg.sender != ROLLUP` (rollup contract is sometimes referred to as state transitioner in the docs).
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/portals/outbox.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/portals/outbox.md
new file mode 100644
index 000000000000..a4ef4b7f9d97
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/portals/outbox.md
@@ -0,0 +1,113 @@
+---
+title: Outbox
+tags: [portals, contracts]
+---
+
+The `Outbox` is a contract deployed on L1 that handles message passing from the rollup and to L1.
+
+**Links**: [Interface (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/master/l1-contracts/src/core/interfaces/messagebridge/IOutbox.sol), [Implementation (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/master/l1-contracts/src/core/messagebridge/Outbox.sol).
+
+## `insert()`
+
+Inserts the root of a merkle tree containing all of the L2 to L1 messages in a block specified by _l2BlockNumber.
+
+```solidity title="outbox_insert" showLineNumbers
+/**
+ * @notice Inserts the root of a merkle tree containing all of the L2 to L1 messages in
+ * a block specified by _l2BlockNumber.
+ * @dev Only callable by the rollup contract
+ * @dev Emits `RootAdded` upon inserting the root successfully
+ * @param _l2BlockNumber - The L2 Block Number in which the L2 to L1 messages reside
+ * @param _root - The merkle root of the tree where all the L2 to L1 messages are leaves
+ * @param _minHeight - The min height of the merkle tree that the root corresponds to
+ */
+function insert(uint256 _l2BlockNumber, bytes32 _root, uint256 _minHeight) external;
+```
+> Source code: l1-contracts/src/core/interfaces/messagebridge/IOutbox.sol#L22-L33
+
+
+
+| Name | Type | Description |
+| -------------- | ------- | ----------- |
+| `_l2BlockNumber` | `uint256` | The L2 Block Number in which the L2 to L1 messages reside |
+| `_root` | `bytes32` | The merkle root of the tree where all the L2 to L1 messages are leaves |
+| `_minHeight` | `uint256` | The minimum height of the merkle tree that the root corresponds to |
+
+#### Edge cases
+
+- Will revert with `Outbox__Unauthorized()` if `msg.sender != ROLLUP_CONTRACT`.
+- Will revert with `Errors.Outbox__RootAlreadySetAtBlock(uint256 l2BlockNumber)` if the root for the specific block has already been set.
+- Will revert with `Errors.Outbox__InsertingInvalidRoot()` if the rollup is trying to insert bytes32(0) as the root.
+
+## `consume()`
+
+Allows a recipient to consume a message from the `Outbox`.
+
+```solidity title="outbox_consume" showLineNumbers
+/**
+ * @notice Consumes an entry from the Outbox
+ * @dev Only useable by portals / recipients of messages
+ * @dev Emits `MessageConsumed` when consuming messages
+ * @param _message - The L2 to L1 message
+ * @param _l2BlockNumber - The block number specifying the block that contains the message we want to consume
+ * @param _leafIndex - The index inside the merkle tree where the message is located
+ * @param _path - The sibling path used to prove inclusion of the message, the _path length directly depends
+ * on the total amount of L2 to L1 messages in the block. i.e. the length of _path is equal to the depth of the
+ * L1 to L2 message tree.
+ */
+function consume(
+ DataStructures.L2ToL1Msg calldata _message,
+ uint256 _l2BlockNumber,
+ uint256 _leafIndex,
+ bytes32[] calldata _path
+) external;
+```
+> Source code: l1-contracts/src/core/interfaces/messagebridge/IOutbox.sol#L35-L53
+
+
+
+| Name | Type | Description |
+| -------------- | ------- | ----------- |
+| `_message` | `L2ToL1Msg` | The L2 to L1 message we want to consume |
+| `_l2BlockNumber` | `uint256` | The block number specifying the block that contains the message we want to consume |
+| `_leafIndex` | `uint256` | The index inside the merkle tree where the message is located |
+| `_path` | `bytes32[]` | The sibling path used to prove inclusion of the message, the _path length directly depends |
+
+#### Edge cases
+
+- Will revert with `Outbox__InvalidRecipient(address expected, address actual);` if `msg.sender != _message.recipient.actor`.
+- Will revert with `Outbox__InvalidChainId()` if `block.chainid != _message.recipient.chainId`.
+- Will revert with `Outbox__NothingToConsumeAtBlock(uint256 l2BlockNumber)` if the root for the block has not been set yet.
+- Will revert with `Outbox__AlreadyNullified(uint256 l2BlockNumber, uint256 leafIndex)` if the message at leafIndex for the block has already been consumed.
+- Will revert with `Outbox__InvalidPathLength(uint256 expected, uint256 actual)` if the supplied height is less than the existing minimum height of the L2 to L1 message tree, or the supplied height is greater than the maximum (minimum height + log2(maximum messages)).
+- Will revert with `MerkleLib__InvalidRoot(bytes32 expected, bytes32 actual, bytes32 leaf, uint256 leafIndex)` if unable to verify the message existence in the tree. It returns the message as a leaf, as well as the index of the leaf to expose more info about the error.
+
+
+## `hasMessageBeenConsumedAtBlockAndIndex()`
+
+Checks to see if an index of the L2 to L1 message tree for a specific block has been consumed.
+
+```solidity title="outbox_has_message_been_consumed_at_block_and_index" showLineNumbers
+/**
+ * @notice Checks to see if an index of the L2 to L1 message tree for a specific block has been consumed
+ * @dev - This function does not throw. Out-of-bounds access is considered valid, but will always return false
+ * @param _l2BlockNumber - The block number specifying the block that contains the index of the message we want to check
+ * @param _leafIndex - The index of the message inside the merkle tree
+ */
+function hasMessageBeenConsumedAtBlockAndIndex(uint256 _l2BlockNumber, uint256 _leafIndex)
+ external
+ view
+ returns (bool);
+```
+> Source code: l1-contracts/src/core/interfaces/messagebridge/IOutbox.sol#L55-L66
+
+
+
+| Name | Type | Description |
+| -------------- | ------- | ----------- |
+| `_l2BlockNumber` | `uint256` | The block number specifying the block that contains the index of the message we want to check |
+| `_leafIndex` | `uint256` | The index of the message inside the merkle tree |
+
+#### Edge cases
+
+- This function does not throw. Out-of-bounds access is considered valid, but will always return false.
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/portals/registry.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/portals/registry.md
new file mode 100644
index 000000000000..5cebf42a17ad
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/portals/registry.md
@@ -0,0 +1,102 @@
+---
+title: Registry
+tags: [portals, contracts]
+---
+
+The registry is a contract deployed on L1, that contains addresses for the `Rollup`. It also keeps track of the different versions that have been deployed and let you query prior deployments easily.
+
+**Links**: [Interface (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/master/l1-contracts/src/governance/interfaces/IRegistry.sol), [Implementation (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/master/l1-contracts/src/governance/Registry.sol).
+
+## `numberOfVersions()`
+
+Retrieves the number of versions that have been deployed.
+
+```solidity title="registry_number_of_versions" showLineNumbers
+function numberOfVersions() external view returns (uint256);
+```
+> Source code: l1-contracts/src/governance/interfaces/IRegistry.sol#L32-L34
+
+
+| Name | Description |
+| -------------- | ----------- |
+| ReturnValue | The number of versions that have been deployed |
+
+## `getRollup()`
+Retrieves the current rollup contract.
+
+```solidity title="registry_get_rollup" showLineNumbers
+function getRollup() external view returns (address);
+```
+> Source code: l1-contracts/src/governance/interfaces/IRegistry.sol#L13-L15
+
+
+| Name | Description |
+| -------------- | ----------- |
+| ReturnValue | The current rollup |
+
+## `getVersionFor(address _rollup)`
+
+Retrieve the version of a specific rollup contract.
+
+```solidity title="registry_get_version_for" showLineNumbers
+function getVersionFor(address _rollup) external view returns (uint256);
+```
+> Source code: l1-contracts/src/governance/interfaces/IRegistry.sol#L17-L19
+
+
+| Name | Description |
+| -------------- | ----------- |
+| `_rollup` | The address of the rollup to lookup |
+| ReturnValue | The version number of `_rollup` |
+
+#### Edge cases
+Will revert with `Registry__RollupNotRegistered(_rollup)` if the rollup have not been registered.
+
+## `getSnapshot(uint256 _version)`
+
+Retrieve the snapshot of a specific version.
+
+```solidity title="registry_snapshot" showLineNumbers
+/**
+ * @notice Struct for storing address of cross communication components and the block number when it was updated
+ * @param rollup - The address of the rollup contract
+ * @param blockNumber - The block number of the snapshot
+ */
+struct RegistrySnapshot {
+ address rollup;
+ uint256 blockNumber;
+}
+```
+> Source code: l1-contracts/src/governance/libraries/DataStructures.sol#L14-L24
+
+```solidity title="registry_get_snapshot" showLineNumbers
+function getSnapshot(uint256 _version)
+ external
+ view
+ returns (DataStructures.RegistrySnapshot memory);
+```
+> Source code: l1-contracts/src/governance/interfaces/IRegistry.sol#L21-L26
+
+
+| Name | Description |
+| -------------- | ----------- |
+| `_version` | The version number to fetch data for |
+| ReturnValue.rollup | The address of the `rollup` for the `_version` |
+| ReturnValue.blockNumber | The block number of the snapshot creation |
+
+
+## `getCurrentSnapshot()`
+
+Retrieves the snapshot for the current version.
+
+```solidity title="registry_get_current_snapshot" showLineNumbers
+function getCurrentSnapshot() external view returns (DataStructures.RegistrySnapshot memory);
+```
+> Source code: l1-contracts/src/governance/interfaces/IRegistry.sol#L28-L30
+
+
+| Name | Description |
+| -------------- | ----------- |
+| ReturnValue.rollup | The address of the `rollup` for the current `_version` |
+| ReturnValue.blockNumber | The block number of the snapshot creation |
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/storage/_category_.json b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/storage/_category_.json
new file mode 100644
index 000000000000..25edf7aa1c2e
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/storage/_category_.json
@@ -0,0 +1,6 @@
+{
+ "position": 1,
+ "collapsible": true,
+ "collapsed": true,
+ "label": "Storage"
+}
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/storage/index.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/storage/index.md
new file mode 100644
index 000000000000..95e6f2a11039
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/storage/index.md
@@ -0,0 +1,114 @@
+---
+title: Storage
+---
+
+Smart contracts rely on storage, acting as the persistent memory on the blockchain. In Aztec, because of its hybrid, privacy-first architecture, the management of this storage is more complex than other blockchains like Ethereum.
+
+To learn how to define a storage struct, read [this guide](../../../guides/smart_contracts/writing_contracts/storage/index.md).
+To learn more about storage slots, read [this explainer in the Concepts section](../../../../aztec/concepts/storage/index.md).
+
+You control this storage in Aztec using a struct annotated with `#[storage]`. This struct serves as the housing unit for all your smart contract's state variables - the data it needs to keep track of and maintain.
+
+These state variables come in two forms: [public](./public_state.md) and [private](./private_state.md). Public variables are visible to anyone, and private variables remain hidden within the contract. A state variable with both public and private components is said to be [shared](./shared_state.md).
+
+Aztec.nr has a few abstractions to help define the type of data your contract holds. These include PrivateMutable, PrivateImmutable, PublicMutable, PublicImmutable, PrivateSet, and SharedMutable.
+
+On this and the following pages in this section, you’ll learn:
+
+- How to manage a smart contract's storage structure
+- The distinctions and applications of public and private state variables
+- How to use PrivateMutable, PrivateImmutable, PrivateSet, PublicMutable, SharedMutable and Map
+- An overview of 'notes' and the UTXO model
+- Practical implications of Storage in real smart contracts
+ In an Aztec.nr contract, storage is to be defined as a single struct, that contains both public and private state variables.
+
+## The `Context` parameter
+
+Aztec contracts have three different modes of execution: private, public, and top-level unconstrained. How storage is accessed depends on the execution mode: for example, `PublicImmutable` can be read in all execution modes but only initialized in public, while `PrivateMutable` is entirely unavailable in public.
+
+Aztec.nr prevents developers from calling functions unavailable in the current execution mode via the `context` variable that is injected into all contract functions. Its type indicates the current execution mode:
+
+- `&mut PrivateContext` for private execution
+- `&mut PublicContext` for public execution
+- `UncontrainedContext` for top-level unconstrained execution
+
+All state variables are generic over this `Context` type, and expose different methods in each execution mode. In the example above, `PublicImmutable`'s `initialize` function is only available with a public execution context, and so the following code results in a compilation error:
+
+```rust
+#[storage]
+struct Storage {
+ variable: PublicImmutable,
+}
+
+#[private]
+fn some_private_function() {
+ storage.variable.initialize(0);
+ // ^ ERROR: Expected type PublicImmutable<_, &mut PublicContext>, found type PublicImmutable
+}
+```
+
+The `Context` generic type parameter is not visible in the code above as it is automatically injected by the `#[storage]` macro, in order to reduce boilerplate. Similarly, all state variables in that struct (e.g. `PublicImmutable`) similarly have that same type parameter automatically passed to them.
+
+## Map
+
+A `map` is a state variable that "maps" a key to a value. It can be used with private or public storage variables.
+
+:::info
+In Aztec.nr, keys are always `Field`s, or types that can be serialized as Fields, and values can be any type - even other maps. `Field`s are finite field elements, but you can think of them as integers.
+:::
+
+It includes a `Context` to specify the private or public domain, a `storage_slot` to specify where in storage the map is stored, and a `start_var_constructor` which tells the map how it should operate on the underlying type. This includes how to serialize and deserialize the type, as well as how commitments and nullifiers are computed for the type if it's private.
+
+You can view the implementation in the Aztec.nr library [here (GitHub link)](https://github.com/AztecProtocol/aztec-packages/tree/master/noir-projects/aztec-nr).
+
+You can have multiple `map`s in your contract that each have a different underlying note type, due to note type IDs. These are identifiers for each note type that are unique within a contract.
+
+#### As private storage
+
+When declaring a mapping in private storage, we have to specify which type of Note to use. In the example below, we are specifying that we want to use the `PrivateMutable` note which will hold `ValueNote` types.
+
+In the Storage struct:
+
+```rust
+numbers: Map>,
+```
+
+#### Public Example
+
+When declaring a public mapping in Storage, we have to specify that the type is public by declaring it as `PublicState` instead of specifying a note type like with private storage above.
+
+```rust title="storage_minters" showLineNumbers
+minters: Map, Context>,
+```
+> Source code: noir-projects/noir-contracts/contracts/token_contract/src/main.nr#L74-L76
+
+
+### `at`
+
+When dealing with a Map, we can access the value at a given key using the `::at` method. This takes the key as an argument and returns the value at that key.
+
+This function behaves similarly for both private and public maps. An example could be if we have a map with `minters`, which is mapping addresses to a flag for whether they are allowed to mint tokens or not.
+
+```rust title="read_minter" showLineNumbers
+assert(storage.minters.at(context.msg_sender()).read(), "caller is not minter");
+```
+> Source code: noir-projects/noir-contracts/contracts/token_contract/src/main.nr#L198-L200
+
+
+Above, we are specifying that we want to get the storage in the Map `at` the `msg_sender()`, read the value stored and check that `msg_sender()` is indeed a minter. Doing a similar operation in Solidity code would look like:
+
+```solidity
+require(minters[msg.sender], "caller is not minter");
+```
+
+## Further Reading
+
+- [Public State](./public_state.md)
+- [Private State](./private_state.md)
+- [Shared State](./shared_state.md)
+
+## Concepts mentioned
+
+- [State Model](../../../../aztec/concepts/storage/state_model.md)
+- [Public-private execution](../../../../aztec/smart_contracts/functions/public_private_calls.md)
+- [Function Contexts](../../../../aztec/smart_contracts/functions/context.md)
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/storage/private_state.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/storage/private_state.md
new file mode 100644
index 000000000000..170572b8ae0d
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/storage/private_state.md
@@ -0,0 +1,572 @@
+---
+title: Private State
+---
+
+On this page we will look at how to manage private state in Aztec contracts. We will look at how to declare private state, how to read and write to it, and how to use it in your contracts.
+
+For a higher level overview of the state model in Aztec, see the [hybrid state model](../../../../aztec/concepts/storage/state_model.md) page.
+
+## Overview
+
+In contrast to public state, private state is persistent state that is **not** visible to the whole world. Depending on the logic of the smart contract, a private state variable's current value will only be known to one entity, or a closed group of entities.
+
+The value of a private state variable can either be shared via an encrypted log, or offchain via web2, or completely offline: it's up to the app developer.
+
+Aztec private state follows a [UTXO](https://en.wikipedia.org/wiki/Unspent_transaction_output)-based model. That is, a private state's current value is represented as one or many notes.
+
+To greatly simplify the experience of writing private state, Aztec.nr provides three different types of private state variable:
+
+- [PrivateMutable\](#privatemutablenotetype)
+- [PrivateImmutable\](#privateimmutablenotetype)
+- [PrivateSet\](#privatesetnotetype)
+
+These three structs abstract-away many of Aztec's protocol complexities, by providing intuitive methods to modify notes in the utxo tree in a privacy-preserving way.
+
+:::info
+An app can also choose to emit data via unencrypted log, or to define a note whose data is easy to figure out, then the information is technically not private and could be visible to anyone.
+:::
+
+### Notes
+
+Unlike public state variables, which can be arbitrary types, private state variables operate on `NoteType`.
+
+Notes are the fundamental elements in the private world.
+
+A note has to implement the following traits:
+
+```rust title="note_interfaces" showLineNumbers
+pub trait NoteType {
+ /// Returns the unique identifier for the note type. This is typically used when processing note logs.
+ fn get_id() -> Field;
+}
+
+pub trait NoteHash {
+ /// Returns the non-siloed note hash, i.e. the inner hash computed by the contract during private execution. Note
+ /// hashes are later siloed by contract address and nonce by the kernels before being committed to the state tree.
+ ///
+ /// This should be a commitment to the packed note, including the storage slot (for indexing) and some random
+ /// value (to prevent brute force trial-hashing attacks).
+ fn compute_note_hash(self, storage_slot: Field) -> Field;
+
+ /// Returns the non-siloed nullifier (also called inner-nullifier), which will be later siloed by contract address
+ /// by the kernels before being committed to the state tree.
+ ///
+ /// This function MUST be called with the correct note hash for consumption! It will otherwise silently fail and
+ /// compute an incorrect value. The reason why we receive this as an argument instead of computing it ourselves
+ /// directly is because the caller will typically already have computed this note hash, and we can reuse that value
+ /// to reduce the total gate count of the circuit.
+ ///
+ /// This function receives the context since nullifier computation typically involves proving nullifying keys, and
+ /// we require the kernel's assistance to do this in order to prevent having to reveal private keys to application
+ /// circuits.
+ fn compute_nullifier(self, context: &mut PrivateContext, note_hash_for_nullify: Field) -> Field;
+
+ /// Like `compute_nullifier`, except this variant is unconstrained: there are no guarantees on the returned value
+ /// being correct. Because of that it doesn't need to take a context (since it won't perform any kernel key
+ /// validation requests).
+ unconstrained fn compute_nullifier_unconstrained(self, note_hash_for_nullify: Field) -> Field;
+}
+```
+> Source code: noir-projects/aztec-nr/aztec/src/note/note_interface.nr#L5-L37
+
+
+The interplay between a private state variable and its notes can be confusing. Here's a summary to aid intuition:
+
+A private state variable (of type `PrivateMutable`, `PrivateImmutable` or `PrivateSet`) may be declared in storage and the purpose of private state variables is to manage notes (inserting their note hashes into the note hash tree, obtaining the notes, grouping the notes together using the storage slot etc.).
+
+:::info
+Note that storage slots in private state are not real.
+They do not point to a specific leaf in a merkle tree (as is the case in public).
+Instead, in the case of notes they can be understood only as a tag that is used to associate notes with a private state variable.
+The state variable storage slot can commonly represent an owner, as is the case when using the `at(...)` function of a `Map<>` with an `AztecAddress` as the key.
+:::
+
+A private state variable points to one or many notes (depending on the type). The note(s) are all valid private state if the note(s) haven't yet been nullified.
+
+An `PrivateImmutable` will point to _one_ note over the lifetime of the contract. This note is a struct of information that is persisted forever.
+
+A `PrivateMutable` may point to _one_ note at a time. But since it's not "immutable", the note that it points to may be [replaced](#replace) by functions of the contract. The current value of a `PrivateMutable` is interpreted as the one note which has not-yet been nullified. The act of replacing a PrivateMutable's note is how a `PrivateMutable` state may be modified by functions.
+
+`PrivateMutable` is a useful type when declaring a private state variable which may only ever be modified by those who are privy to the current value of that state.
+
+A `PrivateSet` may point to _multiple_ notes at a time. The "current value" of a private state variable of type `PrivateSet` is some accumulation of all not-yet nullified notes which belong to the `PrivateSet`.
+
+:::note
+The term "some accumulation" is intentionally vague. The interpretation of the "current value" of a `PrivateSet` must be expressed by the smart contract developer. A common use case for a `PrivateSet` is to represent the sum of a collection of values (in which case 'accumulation' is 'summation').
+
+Think of a ZCash balance (or even a Bitcoin balance). The "current value" of a user's ZCash balance is the sum of all unspent (not-yet nullified) notes belonging to that user. To modify the "current value" of a `PrivateSet` state variable, is to [`insert`](#insert) new notes into the `PrivateSet`, or [`remove`](#remove) notes from that set.
+:::
+
+Interestingly, if a developer requires a private state to be modifiable by users who _aren't_ privy to the value of that state, a `PrivateSet` is a very useful type. The `insert` method allows new notes to be added to the `PrivateSet` without knowing any of the other notes in the set! (Like posting an envelope into a post box, you don't know what else is in there!).
+
+## `PrivateMutable`
+
+PrivateMutable (formerly known as `Singleton`) is a private state variable that is unique in a way. When a PrivateMutable is initialized, a note is created to represent its value. And the way to update the value is to destroy the current note, and create a new one with the updated value.
+
+Like for public state, we define the struct to have context and a storage slot. You can view the implementation [here (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/master/noir-projects/aztec-nr/aztec/src/state_vars/private_mutable.nr).
+
+An example of `PrivateMutable` usage in the account contracts is keeping track of public keys. The `PrivateMutable` is added to the `Storage` struct as follows:
+
+```rust title="storage-private-mutable-declaration" showLineNumbers
+legendary_card: PrivateMutable,
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr#L39-L41
+
+
+### `new`
+
+As part of the initialization of the `Storage` struct, the `PrivateMutable` is created as follows at the specified storage slot.
+
+```rust title="start_vars_private_mutable" showLineNumbers
+legendary_card: PrivateMutable::new(context, 3),
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr#L66-L68
+
+
+### `initialize`
+
+As mentioned, the PrivateMutable is initialized to create the first note and value.
+
+When this function is called, a nullifier of the storage slot is created, preventing this PrivateMutable from being initialized again.
+
+:::danger Privacy-Leak
+Beware that because this nullifier is created only from the storage slot without randomness it leaks privacy. This means that it is possible for an external observer to determine when the note is nullified.
+
+For example, if the storage slot depends on the an address then it is possible to link the nullifier to the address. If the PrivateMutable is part of a `map` with an `AztecAddress` as the key then the nullifier will be linked to the address.
+:::
+
+Unlike public states, which have a default initial value of `0` (or many zeros, in the case of a struct, array or map), a private state (of type `PrivateMutable`, `PrivateImmutable` or `PrivateSet`) does not have a default initial value. The `initialize` method (or `insert`, in the case of a `PrivateSet`) must be called.
+
+:::info
+Extend on what happens if you try to use non-initialized state.
+:::
+
+### `is_initialized`
+
+An unconstrained method to check whether the PrivateMutable has been initialized or not. It takes an optional owner and returns a boolean. You can view the implementation [here (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/v0.82.2/noir-projects/aztec-nr/aztec/src/state_vars/private_mutable.nr).
+
+```rust title="private_mutable_is_initialized" showLineNumbers
+unconstrained fn is_legendary_initialized() -> bool {
+ storage.legendary_card.is_initialized()
+}
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr#L287-L291
+
+
+### `replace`
+
+To update the value of a `PrivateMutable`, we can use the `replace` method. The method takes a new note as input, and replaces the current note with the new one. It emits a nullifier for the old value, and inserts the new note into the data tree.
+
+An example of this is seen in a example card game, where we create a new note (a `CardNote`) containing some new data, and replace the current note with it:
+
+```rust title="state_vars-PrivateMutableReplace" showLineNumbers
+storage.legendary_card.replace(new_card).emit(encode_and_encrypt_note(
+ &mut context,
+ context.msg_sender(),
+ context.msg_sender(),
+));
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr#L243-L249
+
+
+If two people are trying to modify the PrivateMutable at the same time, only one will succeed as we don't allow duplicate nullifiers! Developers should put in place appropriate access controls to avoid race conditions (unless a race is intended!).
+
+### `get_note`
+
+This function allows us to get the note of a PrivateMutable, essentially reading the value.
+
+```rust title="state_vars-PrivateMutableGet" showLineNumbers
+let card = storage.legendary_card.get_note().note;
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr#L237-L239
+
+
+#### Nullifying Note reads
+
+To ensure that a user's private execution always uses the latest value of a PrivateMutable, the `get_note` function will nullify the note that it is reading. This means that if two people are trying to use this function with the same note, only one will succeed (no duplicate nullifiers allowed).
+
+This also makes read operations indistinguishable from write operations and allows the sequencer to verifying correct execution without learning anything about the value of the note.
+
+### `view_note`
+
+Functionally similar to [`get_note`](#get_note), but executed in unconstrained functions and can be used by the wallet to fetch notes for use by front-ends etc.
+
+## `PrivateImmutable`
+
+`PrivateImmutable` (formerly known as `ImmutableSingleton`) represents a unique private state variable that, as the name suggests, is immutable. Once initialized, its value cannot be altered. You can view the implementation [here (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/v0.82.2/noir-projects/aztec-nr/aztec/src/state_vars/private_immutable.nr).
+
+### `new`
+
+As part of the initialization of the `Storage` struct, the `PrivateMutable` is created as follows, here at storage slot 1.
+
+```rust title="storage-private-immutable-declaration" showLineNumbers
+private_immutable: PrivateImmutable,
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr#L47-L49
+
+
+### `initialize`
+
+When this function is invoked, it creates a nullifier for the storage slot, ensuring that the PrivateImmutable cannot be initialized again.
+
+:::danger Privacy-Leak
+Beware that because this nullifier is created only from the storage slot without randomness it leaks privacy. This means that it is possible for an external observer to determine when the note is nullified.
+
+For example, if the storage slot depends on the an address then it is possible to link the nullifier to the address. If the PrivateImmutable is part of a `map` with an `AztecAddress` as the key then the nullifier will be linked to the address.
+:::
+
+Set the value of an PrivateImmutable by calling the `initialize` method:
+
+```rust title="initialize-private-mutable" showLineNumbers
+#[private]
+fn initialize_private_immutable(randomness: Field, points: u8) {
+ let new_card = CardNote::new(points, randomness, context.msg_sender());
+
+ storage.private_immutable.initialize(new_card).emit(encode_and_encrypt_note(
+ &mut context,
+ context.msg_sender(),
+ context.msg_sender(),
+ ));
+}
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr#L167-L178
+
+
+Once initialized, an PrivateImmutable's value remains unchangeable. This method can only be called once.
+
+### `is_initialized`
+
+An unconstrained method to check if the PrivateImmutable has been initialized. Takes an optional owner and returns a boolean. You can find the implementation [here (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/v0.82.2/noir-projects/aztec-nr/aztec/src/state_vars/private_immutable.nr).
+
+### `get_note`
+
+Similar to the `PrivateMutable`, we can use the `get_note` method to read the value of an PrivateImmutable.
+
+Use this method to retrieve the value of an initialized PrivateImmutable.
+
+```rust title="get_note-private-immutable" showLineNumbers
+#[private]
+fn get_imm_card() -> CardNote {
+ storage.private_immutable.get_note()
+}
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr#L292-L297
+
+
+Unlike a `PrivateMutable`, the `get_note` function for an PrivateImmutable doesn't nullify the current note in the background. This means that multiple accounts can concurrently call this function to read the value.
+
+This function will throw if the `PrivateImmutable` hasn't been initialized.
+
+### `view_note`
+
+Functionally similar to `get_note`, but executed unconstrained and can be used by the wallet to fetch notes for use by front-ends etc.
+
+## `PrivateSet`
+
+`PrivateSet` is used for managing a collection of notes. All notes in a `PrivateSet` are of the same `NoteType`. But whether these notes all belong to one entity, or are accessible and editable by different entities, is up to the developer. The set is a collection of notes inserted into the data-tree, but notes are never removed from the tree itself, they are only nullified.
+
+You can view the implementation [here (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/v0.82.2/noir-projects/aztec-nr/aztec/src/state_vars/private_set.nr).
+
+And can be added to the `Storage` struct as follows. Here adding a set for a custom note.
+
+```rust title="storage-set-declaration" showLineNumbers
+set: PrivateSet,
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr#L44-L46
+
+
+### `new`
+
+The `new` method tells the contract how to operate on the underlying storage.
+
+We can initialize the set as follows:
+
+```rust title="storage-set-init" showLineNumbers
+set: PrivateSet::new(context, 5),
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr#L77-L79
+
+
+### `insert`
+
+Allows us to modify the storage by inserting a note into the `PrivateSet`.
+
+A hash of the note will be generated, and inserted into the note hash tree, allowing us to later use in contract interactions. Recall that the content of the note should be shared with the owner to allow them to use it, as mentioned this can be done via an encrypted log or offchain via web2, or completely offline.
+
+```rust title="insert" showLineNumbers
+self.set.insert(addend_note).emit(encode_and_encrypt_note(self.context, owner, sender));
+```
+> Source code: noir-projects/aztec-nr/easy-private-state/src/easy_private_uint.nr#L31-L33
+
+
+### `insert_from_public`
+
+The `insert_from_public` allow public function to insert notes into private storage. This is very useful when we want to support private function calls that have been initiated in public.
+
+The usage is similar to using the `insert` method with the difference that this one is called in public functions.
+
+### `pop_notes`
+
+This function pops (gets, removes and returns) the notes the account has access to based on the provided filter.
+
+The kernel circuits are constrained to a maximum number of notes this function can return at a time. Check [here (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/v0.82.2/noir-projects/noir-protocol-circuits/crates/types/src/constants.nr) and look for `MAX_NOTE_HASH_READ_REQUESTS_PER_CALL` for the up-to-date number.
+
+Because of this limit, we should always consider using the second argument `NoteGetterOptions` to limit the number of notes we need to read and constrain in our programs. This is quite important as every extra call increases the time used to prove the program and we don't want to spend more time than necessary.
+
+An example of such options is using the [filter_notes_min_sum (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/v0.82.2/noir-projects/aztec-nr/value-note/src/filter.nr) to get "enough" notes to cover a given value. Essentially, this function will return just enough notes to cover the amount specified such that we don't need to read all our notes. For users with a lot of notes, this becomes increasingly important.
+
+```rust title="pop_notes" showLineNumbers
+let options = NoteGetterOptions::with_filter(filter_notes_min_sum, subtrahend as Field);
+let notes = self.set.pop_notes(options);
+```
+> Source code: noir-projects/aztec-nr/easy-private-state/src/easy_private_uint.nr#L38-L41
+
+
+### `get_notes`
+
+This function has the same behavior as `pop_notes` above but it does not delete the notes.
+
+### `remove`
+
+Will remove a note from the `PrivateSet` if it previously has been read from storage, e.g. you have fetched it through a `get_notes` call. This is useful when you want to remove a note that you have previously read from storage and do not have to read it again.
+
+Note that if you obtained the note you are about to remove via `get_notes` it's much better to use `pop_notes` as `pop_notes` results in significantly fewer constraints since it doesn't need to check that the note has been previously read, as it reads and deletes at once.
+
+### `view_notes`
+
+Functionally similar to [`get_notes`](#get_notes), but executed unconstrained and can be used by the wallet to fetch notes for use by front-ends etc.
+
+```rust title="view_notes" showLineNumbers
+let mut options = NoteViewerOptions::new();
+let notes = set.view_notes(options.set_offset(offset));
+```
+> Source code: noir-projects/aztec-nr/value-note/src/balance_utils.nr#L16-L19
+
+
+There's also a limit on the maximum number of notes that can be returned in one go. To find the current limit, refer to [this file (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/v0.82.2/noir-projects/aztec-nr/aztec/src/note/constants.nr) and look for `MAX_NOTES_PER_PAGE`.
+
+The key distinction is that this method is unconstrained. It does not perform a check to verify if the notes actually exist, which is something the [`get_notes`](#get_notes) method does under the hood. Therefore, it should only be used in an unconstrained contract function.
+
+This function requires a `NoteViewerOptions`. The `NoteViewerOptions` is essentially similar to the [`NoteGetterOptions`](#notegetteroptions), except that it doesn't take a custom filter.
+
+## `NoteGetterOptions`
+
+`NoteGetterOptions` encapsulates a set of configurable options for filtering and retrieving a selection of notes from a data oracle. Developers can design instances of `NoteGetterOptions`, to determine how notes should be filtered and returned to the functions of their smart contracts.
+
+You can view the implementation [here (GitHub link)](https://github.com/AztecProtocol/aztec-packages/blob/v0.82.2/noir-projects/aztec-nr/aztec/src/note/note_getter_options.nr).
+
+### `selects: BoundedVec, N>`
+
+`selects` is a collection of filtering criteria, specified by `Select { property_selector: PropertySelector, comparator: u8, value: Field }` structs. It instructs the data oracle to find notes whose serialized field (as specified by the `PropertySelector`) matches the provided `value`, according to the `comparator`. The PropertySelector is in turn specified as having an `index` (nth position of the selected field in the serialized note), an `offset` (byte offset inside the selected serialized field) and `length` (bytes to read of the field from the offset). These values are not expected to be manually computed, but instead specified by passing functions autogenerated from the note definition.
+
+### `sorts: BoundedVec, N>`
+
+`sorts` is a set of sorting instructions defined by `Sort { property_selector: PropertySelector, order: u2 }` structs. This directs the data oracle to sort the matching notes based on the value of the specified PropertySelector and in the indicated order. The value of order is **1** for _DESCENDING_ and **2** for _ASCENDING_.
+
+### `limit: u32`
+
+When the `limit` is set to a non-zero value, the data oracle will return a maximum of `limit` notes.
+
+### `offset: u32`
+
+This setting enables us to skip the first `offset` notes. It's particularly useful for pagination.
+
+### `preprocessor: fn ([Option; MAX_NOTE_HASH_READ_REQUESTS_PER_CALL], PREPROCESSOR_ARGS) -> [Option; MAX_NOTE_HASH_READ_REQUESTS_PER_CALL]`
+
+Developers have the option to provide a custom preprocessor.
+This allows specific logic to be applied to notes that meet the criteria outlined above.
+The preprocessor takes the notes returned from the oracle and `preprocessor_args` as its parameters.
+
+An important distinction from the filter function described below is that preprocessor is applied first and unlike filter it is applied in an unconstrained context.
+
+### `preprocessor_args: PREPROCESSOR_ARGS`
+
+`preprocessor_args` provides a means to furnish additional data or context to the custom preprocessor.
+
+### `filter: fn ([Option; MAX_NOTE_HASH_READ_REQUESTS_PER_CALL], FILTER_ARGS) -> [Option; MAX_NOTE_HASH_READ_REQUESTS_PER_CALL]`
+
+Just like preprocessor just applied in a constrained context (correct execution is proven) and applied after the preprocessor.
+
+### `filter_args: FILTER_ARGS`
+
+`filter_args` provides a means to furnish additional data or context to the custom filter.
+
+### `status: u2`
+
+`status` allows the caller to retrieve notes that have been nullified, which can be useful to prove historical data. Note that when querying for both active and nullified notes the caller cannot know if each note retrieved has or has not been nullified.
+
+### Methods
+
+Several methods are available on `NoteGetterOptions` to construct the options in a more readable manner:
+
+### `fn new() -> NoteGetterOptions`
+
+This function initializes a `NoteGetterOptions` that simply returns the maximum number of notes allowed in a call.
+
+### `fn with_filter(filter, filter_args) -> NoteGetterOptions`
+
+This function initializes a `NoteGetterOptions` with a [`filter`](#filter-fn-optionnote-max_note_hash_read_requests_per_call-filter_args---optionnote-max_note_hash_read_requests_per_call) and [`filter_args`](#filter_args-filter_args).
+
+### `.select`
+
+This method adds a [`Select`](#selects-boundedvecoptionselect-n) criterion to the options.
+
+### `.sort`
+
+This method adds a [`Sort`](#sorts-boundedvecoptionsort-n) criterion to the options.
+
+### `.set_limit`
+
+This method lets you set a limit for the maximum number of notes to be retrieved.
+
+### `.set_offset`
+
+This method sets the offset value, which determines where to start retrieving notes.
+
+### `.set_status`
+
+This method sets the status of notes to retrieve (active or nullified).
+
+### Examples
+
+#### Example 1
+
+The following code snippet creates an instance of `NoteGetterOptions`, which has been configured to find the cards that belong to an account with nullifying key hash equal to `account_npk_m_hash`. The returned cards are sorted by their points in descending order, and the first `offset` cards with the highest points are skipped.
+
+```rust title="state_vars-NoteGetterOptionsSelectSortOffset" showLineNumbers
+pub fn create_npk_card_getter_options(
+ account: AztecAddress,
+ offset: u32,
+) -> NoteGetterOptions
+where
+ CardNote: Packable,
+{
+ let mut options = NoteGetterOptions::new();
+ options
+ .select(CardNote::properties().owner, Comparator.EQ, account)
+ .sort(CardNote::properties().points, SortOrder.DESC)
+ .set_offset(offset)
+}
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/options.nr#L14-L28
+
+
+The first value of `.select` and `.sort` indicates the property of the note we're looking for. For this we use helper functions that are autogenerated from the note definition. `CardNote` that has the following fields:
+
+```rust title="state_vars-CardNote" showLineNumbers
+// We derive the Serialize trait because this struct is returned from a contract function. When returned,
+// the struct is serialized using the Serialize trait and added to a hasher via the `add_to_hasher` utility.
+// We use a hash rather than the serialized struct itself to keep circuit inputs constant.
+#[note]
+#[derive(Eq, Serialize)]
+pub struct CardNote {
+ points: u8,
+ randomness: Field,
+ owner: AztecAddress,
+}
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/types/card_note.nr#L3-L14
+
+
+`CardNote::properties()` will return a struct with the values to pass for each field, which are related to their indices inside the `CardNote` struct, internal offset and length.
+
+In the example, `.select(CardNote::properties().npk_m_hash, Comparator.EQ, account_npk_m_hash)` matches notes which have the `npk_m_hash` field set to `account_npk_m_hash`. In this case we're using the equality comparator, but other operations exist in the `Comparator` utility struct.
+
+`.sort(0, SortOrder.DESC)` sorts the 0th field of `CardNote`, which is `points`, in descending order.
+
+There can be as many conditions as the number of fields a note type has. The following example finds cards whose fields match the three given values:
+
+```rust title="state_vars-NoteGetterOptionsMultiSelects" showLineNumbers
+pub fn create_exact_card_getter_options(
+ points: u8,
+ secret: Field,
+ account: AztecAddress,
+) -> NoteGetterOptions
+where
+ CardNote: Packable,
+{
+ let mut options = NoteGetterOptions::new();
+ options
+ .select(CardNote::properties().points, Comparator.EQ, points as Field)
+ .select(CardNote::properties().randomness, Comparator.EQ, secret)
+ .select(CardNote::properties().owner, Comparator.EQ, account)
+}
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/options.nr#L30-L45
+
+
+While `selects` lets us find notes with specific values, `filter` lets us find notes in a more dynamic way. The function below picks the cards whose points are at least `min_points`, although this now can be done by using the select function with a GTE comparator:
+
+```rust title="state_vars-OptionFilter" showLineNumbers
+pub fn filter_min_points(
+ cards: [Option>; MAX_NOTE_HASH_READ_REQUESTS_PER_CALL],
+ min_points: u8,
+) -> [Option>; MAX_NOTE_HASH_READ_REQUESTS_PER_CALL] {
+ let mut selected_cards = [Option::none(); MAX_NOTE_HASH_READ_REQUESTS_PER_CALL];
+ let mut num_selected = 0;
+ for i in 0..cards.len() {
+ if cards[i].is_some() & cards[i].unwrap_unchecked().note.points >= min_points {
+ selected_cards[num_selected] = cards[i];
+ num_selected += 1;
+ }
+ }
+ selected_cards
+}
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/options.nr#L47-L62
+
+
+We can use it as a filter to further reduce the number of the final notes:
+
+```rust title="state_vars-NoteGetterOptionsFilter" showLineNumbers
+pub fn create_cards_with_min_points_getter_options(
+ min_points: u8,
+) -> NoteGetterOptions
+where
+ CardNote: Packable,
+{
+ NoteGetterOptions::with_filter(filter_min_points, min_points).sort(
+ CardNote::properties().points,
+ SortOrder.ASC,
+ )
+}
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/options.nr#L64-L76
+
+
+One thing to remember is, `filter` will be applied on the notes after they are picked from the database, so it is more efficient to use select with comparators where possible. Another side effect of this is that it's possible that the actual notes we end up getting are fewer than the limit.
+
+The limit is `MAX_NOTE_HASH_READ_REQUESTS_PER_CALL` by default. But we can set it to any value **smaller** than that:
+
+```rust title="state_vars-NoteGetterOptionsPickOne" showLineNumbers
+pub fn create_largest_card_getter_options() -> NoteGetterOptions
+where
+ CardNote: Packable,
+{
+ let mut options = NoteGetterOptions::new();
+ options.sort(CardNote::properties().points, SortOrder.DESC).set_limit(1)
+}
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/options.nr#L78-L86
+
+
+#### Example 2
+
+An example of how we can use a Comparator to select notes when calling a Noir contract from aztec.js is below.
+
+```typescript title="state_vars-NoteGetterOptionsComparatorExampleTs" showLineNumbers
+contract.methods.read_note(Comparator.GTE, 5).simulate(),
+```
+> Source code: yarn-project/end-to-end/src/e2e_note_getter.test.ts#L58-L60
+
+
+In this example, we use the above typescript code to invoke a call to our Noir contract below. This Noir contract function takes an input to match with, and a comparator to use when fetching and selecting notes from storage.
+
+```rust title="state_vars-NoteGetterOptionsComparatorExampleNoir" showLineNumbers
+unconstrained fn read_note(comparator: u8, amount: Field) -> BoundedVec {
+ let mut options = NoteViewerOptions::new();
+ storage.set.view_notes(options.select(CardNote::properties().points, comparator, amount))
+}
+```
+> Source code: noir-projects/noir-contracts/contracts/docs_example_contract/src/main.nr#L214-L219
+
diff --git a/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/storage/public_state.md b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/storage/public_state.md
new file mode 100644
index 000000000000..8876fca816cc
--- /dev/null
+++ b/docs/versioned_docs/version-v0.82.2-alpha-testnet.5/developers/reference/smart_contract_reference/storage/public_state.md
@@ -0,0 +1,214 @@
+---
+title: Public State
+---
+
+On this page we will look at how to manage public state in Aztec contracts. We will look at how to declare public state, how to read and write to it, and how to use it in your contracts.
+
+For a higher level overview of the state model in Aztec, see the [state model](../../../../aztec/concepts/storage/state_model.md) concepts page.
+
+## `PublicMutable`
+
+The `PublicMutable` (formerly known as `PublicState`) struct is generic over the variable type `T`. The type _must_ implement Serialize and Deserialize traits, as specified here:
+
+```rust title="serialize" showLineNumbers
+/// Trait for serializing Noir types into arrays of Fields.
+///
+/// An implementation of the Serialize trait has to follow Noir's intrinsic serialization (each member of a struct
+/// converted directly into one or more Fields without any packing or compression). This trait (and Deserialize) are
+/// typically used to communicate between Noir and TypeScript (via oracles and function arguments).
+///
+/// # On Following Noir's Intrinsic Serialization
+/// When calling a Noir function from TypeScript (TS), first the function arguments are serialized into an array
+/// of fields. This array is then included in the initial witness. Noir's intrinsic serialization is then used
+/// to deserialize the arguments from the witness. When the same Noir function is called from Noir this Serialize trait
+/// is used instead of the serialization in TS. For this reason we need to have a match between TS serialization,
+/// Noir's intrinsic serialization and the implementation of this trait. If there is a mismatch, the function calls
+/// fail with an arguments hash mismatch error message.
+///
+/// # Type Parameters
+/// * `N` - The length of the output Field array, known at compile time
+///
+/// # Example
+/// ```
+/// impl Serialize for str {
+/// fn serialize(self) -> [Field; N] {
+/// let bytes = self.as_bytes();
+/// let mut fields = [0; N];
+/// for i in 0..bytes.len() {
+/// fields[i] = bytes[i] as Field; // Each byte gets its own Field
+/// }
+/// fields
+/// }
+/// }
+/// ```
+#[derive_via(derive_serialize)]
+pub trait Serialize {
+ fn serialize(self) -> [Field; N];
+}
+```
+> 
+
2. Storage contract address
diff --git a/docs/docs/aztec/smart_contracts/functions/public_private_calls.md b/docs/docs/aztec/smart_contracts/functions/public_private_calls.md
index bf8727943536..0e4c5667b5c4 100644
--- a/docs/docs/aztec/smart_contracts/functions/public_private_calls.md
+++ b/docs/docs/aztec/smart_contracts/functions/public_private_calls.md
@@ -39,7 +39,7 @@ In this model, instead of informing the builder of our intentions, we construct
On the left-hand side of the diagram below, we see the fully public world where storage is shared, while on the right-hand side, we see the private world where all reads are historical.
-
+