bitpro가 원문에서 글자만 모은 내용이에요. 표·그림·수식은 빠지거나 깨질 수 있어요. 전체 75쪽 중 1쪽
# Aztec Protocol Documentation
> Build private smart contracts on Ethereum's leading privacy-first L2 zkRollup.
- [Aztec Protocol Documentation](/index.md)
## developers
- [AI Tooling](/developers/testnet/ai_tooling.md): Set up AI coding tools like Claude Code, Cursor, and Codex for Aztec and Noir development.
- [Aztec.js](/developers/testnet/docs/aztec-js.md): Complete guide to Aztec.js library for managing accounts and interacting with contracts on the Aztec network, including installation, importing, and core workflow functions.
- [Reference](/developers/testnet/docs/aztec-js/aztec_js_reference.md): Comprehensive auto-generated reference for the Aztec.js TypeScript library with all classes, interfaces, types, and functions.
- [Connect to Local Network](/developers/testnet/docs/aztec-js/how_to_connect_to_local_network.md): Connect your application to the Aztec local network and interact with accounts.
- [Creating Accounts](/developers/testnet/docs/aztec-js/how_to_create_account.md): Step-by-step guide to creating and deploying new user accounts in Aztec.js applications.
- [Deploying Contracts](/developers/testnet/docs/aztec-js/how_to_deploy_contract.md): Deploy smart contracts to Aztec using generated TypeScript classes.
- [Paying Fees](/developers/testnet/docs/aztec-js/how_to_pay_fees.md): Pay transaction fees on Aztec, understand mana costs, estimate gas, and retrieve fees from receipts.
- [Reading Contract Data](/developers/testnet/docs/aztec-js/how_to_read_data.md): How to read data from contracts including simulating functions, reading logs, and retrieving events.
- [Sending Transactions](/developers/testnet/docs/aztec-js/how_to_send_transaction.md): Send transactions to Aztec contracts using Aztec.js with various options and error handling
- [Simulate without signing prompts](/developers/testnet/docs/aztec-js/how_to_simulate_without_signing.md): How to call .simulate() on a view function or estimate gas without prompting the user to sign authentication witnesses.
- [Testing Smart Contracts](/developers/testnet/docs/aztec-js/how_to_test.md): Learn how to write and run tests for your Aztec smart contracts using Aztec.js and a local network.
- [Using Authentication Witnesses](/developers/testnet/docs/aztec-js/how_to_use_authwit.md): Step-by-step guide to implementing authentication witnesses in Aztec.js for delegated transactions.
- [Pay Fees Privately](/developers/testnet/docs/aztec-js/how_to_use_private_fee_juice.md): Learn how private fee payment works on Aztec and walk through an example using a community-built fully private Fee Payment Contract.
- [TypeScript API Reference](/developers/testnet/docs/aztec-js/typescript_api_reference.md): API reference documentation for Aztec TypeScript packages including aztec.js, accounts, PXE, and core libraries.
- [Overview](/developers/testnet/docs/aztec-nr.md): Comprehensive guide to writing smart contracts for the Aztec network using Noir.
- [Aztec.nr API Reference](/developers/testnet/docs/aztec-nr/api.md): Auto-generated API reference documentation for the Aztec.nr smart contract framework.
- [Compiling Contracts](/developers/testnet/docs/aztec-nr/compiling_contracts.md): Compile your Aztec smart contracts into deployable artifacts using aztec command.
- [Contract Deployment Reference](/developers/testnet/docs/aztec-nr/contract_readiness_states.md): A practical guide to determine which deployment steps your Aztec contract needs and when functions become callable.
- [Debugging Aztec Code](/developers/testnet/docs/aztec-nr/debugging.md): This guide shows you how to debug issues in your Aztec contracts.
- [Profiling Transactions](/developers/testnet/docs/aztec-nr/framework-description/advanced/how_to_profile_transactions.md): How to profile Aztec transactions and identify performance bottlenecks using aztec profile, aztec-wallet, and aztec.js.
- [Proving historic state](/developers/testnet/docs/aztec-nr/framework-description/advanced/how_to_prove_history.md): Prove historical notes, nullifiers, contract deployment, and public storage in your Aztec smart contracts.
- [Retrieving and Filtering Notes](/developers/testnet/docs/aztec-nr/framework-description/advanced/how_to_retrieve_filter_notes.md): Step-by-step guide to retrieving, filtering, and sorting notes from private storage in Aztec contracts.
- [Using Capsules](/developers/testnet/docs/aztec-nr/framework-description/advanced/how_to_use_capsules.md): Learn how to use capsules for per-contract non-volatile storage in the PXE.
- [Partial notes](/developers/testnet/docs/aztec-nr/framework-description/advanced/partial_notes.md): How partial notes work, how they are completed, and how they enable use cases like AMM swaps and payment endpoints.
- [Partial notes as payment endpoints](/developers/testnet/docs/aztec-nr/framework-description/advanced/partial_notes_as_payment_endpoints.md): Using partial notes as a recipient's offer to be paid, enabling naming-service style flows with no recipient action at payment time.
- [Oracle Functions](/developers/testnet/docs/aztec-nr/framework-description/advanced/protocol_oracles.md): Learn about oracles in Aztec, which provide external data to smart contracts during execution.
- [Writing Efficient Contracts](/developers/testnet/docs/aztec-nr/framework-description/advanced/writing_efficient_contracts.md): Best practices and techniques for writing gas-efficient contracts on Aztec, optimizing for both proving and execution costs.
- [Authentication Witnesses](/developers/testnet/docs/aztec-nr/framework-description/authentication_witnesses.md): Enable contracts to execute actions on behalf of user accounts using authentication witnesses.
- [Calling Other Contracts](/developers/testnet/docs/aztec-nr/framework-description/calling_contracts.md): Call functions in other contracts from your Aztec smart contracts to enable composability.
- [Contract Artifacts](/developers/testnet/docs/aztec-nr/framework-description/contract_artifact.md): Understand the structure and contents of Aztec smart contract artifacts.
- [Contract Structure](/developers/testnet/docs/aztec-nr/framework-description/contract_structure.md): Learn the fundamental structure of Aztec smart contracts including the contract keyword, directory layout, and how contracts manage state and functions.
- [Contract Upgrades](/developers/testnet/docs/aztec-nr/framework-description/contract_upgrades.md): Understand contract upgrade patterns in Aztec and how to implement upgradeable contracts.
- [Custom notes](/developers/testnet/docs/aztec-nr/framework-description/custom_notes.md): Learn how to create and use custom note types for specialized private data storage in Aztec contracts
- [Data Packing and Serialization](/developers/testnet/docs/aztec-nr/framework-description/data_packing.md): Understand Serialize, Deserialize, and Packable traits, when each is used, how to write custom packing, and the cost implications.
- [Aztec.nr Dependencies](/developers/testnet/docs/aztec-nr/framework-description/dependencies.md): Reference list of available Aztec.nr libraries and their Nargo.toml dependency paths.
- [Ethereum<>Aztec Messaging](/developers/testnet/docs/aztec-nr/framework-description/ethereum_aztec_messaging.md): Send messages and data between L1 and L2 contracts using portal contracts and cross-chain messaging.
- [Events and Logs](/developers/testnet/docs/aztec-nr/framework-description/events_and_logs.md): Learn how to emit events from your Aztec smart contracts for offchain applications to consume.
- [Defining Functions](/developers/testnet/docs/aztec-nr/framework-description/functions.md): Overview of Aztec contract functions, including private, public, and utility function types.
- [Attributes and Macros](/developers/testnet/docs/aztec-nr/framework-description/functions/attributes.md): Reference for Aztec contract attributes that control function visibility, execution context, storage, and notes.
- [Understanding Function Context](/developers/testnet/docs/aztec-nr/framework-description/functions/context.md): Learn about the execution context available to Aztec contract functions, including caller information and block data.
- [Inner Workings of Functions](/developers/testnet/docs/aztec-nr/framework-description/functions/function_transforms.md): Understand how Aztec transforms contract functions during compilation for privacy and efficiency.
- [How to Define Functions](/developers/testnet/docs/aztec-nr/framework-description/functions/how_to_define_functions.md): Define different types of functions in your Aztec contracts for private, public, and utility execution.
- [Visibility](/developers/testnet/docs/aztec-nr/framework-description/functions/visibility.md): Understand function visibility modifiers in Aztec and how they affect function execution and accessibility.
- [Global Variables](/developers/testnet/docs/aztec-nr/framework-description/globals.md): Access chain ID, block number, timestamps, and gas information in your Aztec contracts
- [Immutables via Salt](/developers/testnet/docs/aztec-nr/framework-description/immutables.md): Commit immutable values into a contract's address salt, eliminating initialization transactions.
- [Aztec Macros](/developers/testnet/docs/aztec-nr/framework-description/macros.md): Learn about macros available in Aztec.nr for code generation and abstraction.
- [Note Delivery](/developers/testnet/docs/aztec-nr/framework-description/note_delivery.md): Learn how to deliver notes to recipients in Aztec smart contracts using different delivery modes to balance proving time, transaction costs, and delivery guarantees.
- [Offchain message delivery](/developers/testnet/docs/aztec-nr/framework-description/offchain_message_delivery.md): Deliver notes and events to recipients through your own channel with offchain message delivery, avoiding data availability costs entirely.
- [State Variables](/developers/testnet/docs/aztec-nr/framework-description/state_variables.md): Define and manage storage state in your Aztec smart contracts using various storage types.
- [Noir VSCode Extension](/developers/testnet/docs/aztec-nr/installation.md): Learn how to install and configure the Noir Language Server for a better development experience.
- [Logging from Contracts](/developers/testnet/docs/aztec-nr/logging.md): Add log statements to your Aztec contracts and control log verbosity in tests and local networks.
- [Aztec Contract Standards](/developers/testnet/docs/aztec-nr/standards.md): Overview of Aztec Improvement Proposal (AIP) contract standards maintained by DeFi Wonderland.
- [AIP-20: Fungible Token](/developers/testnet/docs/aztec-nr/standards/aip-20.md): Fungible token standard with private balances, partial-note transfers, and recursive note consumption.
- [AIP-4626: Tokenized Vault](/developers/testnet/docs/aztec-nr/standards/aip-4626.md): Yield-bearing vault standard with share conversion across private and public contexts.
- [AIP-721: Non-Fungible Token](/developers/testnet/docs/aztec-nr/standards/aip-721.md): Non-fungible token standard with private ownership, partial-note support, and commitment-based transfers.
- [Dripper (Development Faucet)](/developers/testnet/docs/aztec-nr/standards/dripper.md): Convenience faucet for minting tokens into private or public balances during development.
- [Escrow](/developers/testnet/docs/aztec-nr/standards/escrow.md): Minimal token and NFT custody contract with salt-based authorization.
- [Generic Proxy](/developers/testnet/docs/aztec-nr/standards/generic-proxy.md): Forwarding layer for account abstraction that routes calls by argument count.
- [Testing Contracts](/developers/testnet/docs/aztec-nr/testing_contracts.md): Write and run tests for your Aztec smart contracts using Noir's TestEnvironment.
- [Aztec CLI Reference](/developers/testnet/docs/cli/aztec_cli_reference.md): Comprehensive auto-generated reference for the Aztec CLI with all commands and options.
- [Aztec Up CLI Reference](/developers/testnet/docs/cli/aztec_up_cli_reference.md): Comprehensive auto-generated reference for the Aztec Version Manager with all commands and options.
- [Aztec Wallet CLI Reference](/developers/testnet/docs/cli/aztec_wallet_cli_reference.md): Comprehensive auto-generated reference for the Aztec Wallet CLI with all commands and options.
- [Aztec Overview](/developers/testnet/docs/foundational-topics.md): Overview of Aztec, a privacy-first Layer 2 on Ethereum supporting smart contracts with private and public state and execution.
- [Understanding Accounts in Aztec](/developers/testnet/docs/foundational-topics/accounts.md): Deep dive into Aztec's native account abstraction system - understanding how smart contract accounts work, their architecture, key management, and authorization mechanisms in a privacy-preserving blockchain.
- [Keys](/developers/testnet/docs/foundational-topics/accounts/keys.md): Understand the specialized key pairs used in Aztec accounts - nullifier keys, incoming viewing keys, and signing keys - and how they enable privacy, security, and flexible authentication.
- [Authentication Witness (Authwit)](/developers/testnet/docs/foundational-topics/advanced/authwit.md): Learn about Aztec's Authentication Witness scheme that enables secure third-party actions on behalf of users, providing a privacy-preserving alternative to traditional token approvals.
- [Circuits](/developers/testnet/docs/foundational-topics/advanced/circuits.md): Explore Aztec's core protocol circuits that enforce privacy rules and transaction validity through zero-knowledge proofs, enabling private state and function execution.
- [AVM Cryptographic Compatibility](/developers/testnet/docs/foundational-topics/advanced/circuits/avm_compatibility.md): Which Noir cryptographic primitives work in public (AVM) functions vs private, and workarounds for unsupported operations.
- [Private Kernel Circuit](/developers/testnet/docs/foundational-topics/advanced/circuits/private_kernel.md): Learn about the Private Kernel Circuit, the only zero-knowledge circuit in Aztec that handles private data and ensures transaction privacy by executing on user devices.
- [Public Execution (AVM)](/developers/testnet/docs/foundational-topics/advanced/circuits/public_execution.md): Learn how the Aztec Virtual Machine (AVM) executes public functions and manages public state transitions.
- [Rollup Circuits](/developers/testnet/docs/foundational-topics/advanced/circuits/rollup_circuits.md): Learn how Rollup Circuits compress transactions into a single proof using a hierarchical tree topology for efficient verification on Ethereum.
- [Indexed Merkle Tree (Nullifier Tree)](/developers/testnet/docs/foundational-topics/advanced/storage/indexed_merkle_tree.md): Learn about indexed merkle trees, an efficient data structure for nullifier trees that enables fast non-membership proofs and batch insertions in Aztec.
- [Note Discovery](/developers/testnet/docs/foundational-topics/advanced/storage/note_discovery.md): Understand how Aztec's note tagging system allows users to efficiently discover and decrypt notes that belong to them without relying on brute force or offchain communication.
- [Storage Slots](/developers/testnet/docs/foundational-topics/advanced/storage/storage_slots.md): Understand how storage slots work in Aztec for both public and private state, including siloing mechanisms and note hash commitments.
- [Call Types](/developers/testnet/docs/foundational-topics/call_types.md): Understand the different types of contract calls in Aztec, including private and public execution modes, and how they compare to Ethereum's call types.
- [Contract Deployment](/developers/testnet/docs/foundational-topics/contract_creation.md): Learn how contract classes and instances are created and deployed on the Aztec network.
- [L1-L2 Communication (Portals)](/developers/testnet/docs/foundational-topics/ethereum-aztec-messaging.md): A conceptual introduction to Portals and how Aztec communicates with L1 (Ethereum)
- [Data Structures](/developers/testnet/docs/foundational-topics/ethereum-aztec-messaging/data_structures.md): Learn about the data structures used in Aztec portals for L1-L2 communication.
- [Inbox](/developers/testnet/docs/foundational-topics/ethereum-aztec-messaging/inbox.md): Learn about the inbox mechanism in Aztec portals for receiving messages from L1.
- [Outbox](/developers/testnet/docs/foundational-topics/ethereum-aztec-messaging/outbox.md): Learn about the outbox mechanism in Aztec portals for sending messages to L1.
- [Registry](/developers/testnet/docs/foundational-topics/ethereum-aztec-messaging/registry.md): Learn about the portal registry and how it manages L1-L2 contract mappings.
- [Fees](/developers/testnet/docs/foundational-topics/fees.md): Understand Aztec's fee system including mana-based transaction pricing, Aztec token and Fee Juice payments, and how L1 and L2 costs are transparently calculated for users.
- [Private Execution Environment (PXE)](/developers/testnet/docs/foundational-topics/pxe.md): Explore the PXE, a client-side library that handles private function execution, proof generation, secret management, and transaction orchestration in Aztec.
- [Execution hooks](/developers/testnet/docs/foundational-topics/pxe/execution_hooks.md): How wallets use PXE execution hooks to apply custom policies during client-side simulation.
- [Kernelless simulations](/developers/testnet/docs/foundational-topics/pxe/kernelless_simulations.md): How the PXE simulates transactions without running the private kernel circuits, why it is the default for .simulate(), and what it skips.
- [State Management](/developers/testnet/docs/foundational-topics/state_management.md): How public and private state work in Aztec, including storage slots, notes, and the UTXO model
- [Transactions](/developers/testnet/docs/foundational-topics/transactions.md): Comprehensive guide to the Aztec transaction lifecycle, covering private execution, PXE interactions, kernel circuits, and the step-by-step process from user request to L1 settlement.
- [Wallets](/developers/testnet/docs/foundational-topics/wallets.md): Overview of wallet responsibilities in Aztec including account management, private state tracking, transaction execution, key management, and authorization handling.
- [Community Calls](/developers/testnet/docs/resources/community_calls.md): Join live calls to connect with the Aztec team and other builders.
- [Limitations](/developers/testnet/docs/resources/considerations/limitations.md): Understand the current limitations of the Aztec network and its implications for developers.
- [Privacy Considerations](/developers/testnet/docs/resources/considerations/privacy_considerations.md): Learn about key privacy considerations when building applications on Aztec.
- [Glossary](/developers/testnet/docs/resources/glossary.md): Comprehensive glossary of terms used throughout the Aztec documentation and protocol.
- [Migration notes](/developers/testnet/docs/resources/migration_notes.md): Read about migration notes from previous versions, which could solve problems while updating
- [Video lessons](/developers/testnet/docs/resources/video_lessons.md): Learn Aztec through short video explainers covering what Aztec is, private and public state, private composability, and getting started.
- [Counter contract](/developers/testnet/docs/tutorials/contract_tutorials/counter_contract.md): Code-along tutorial for creating a simple counter contract on Aztec.
- [Verify Noir Proofs in Aztec Contracts](/developers/testnet/docs/tutorials/contract_tutorials/recursive_verification.md): Learn to generate offchain ZK proofs with Noir and verify them onchain in Aztec private smart contracts
- [Private Token Contract](/developers/testnet/docs/tutorials/contract_tutorials/token_contract.md): Build a privacy-preserving token for employee mental health benefits that keeps spending habits confidential.
- [Deposit to Aave from Aztec](/developers/testnet/docs/tutorials/js_tutorials/aave_bri프로젝트로 돌아가기