Add udc docs

CHANGELOG.md

@@ -13,6 +13,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - UDC preset contract (#919)
 - ERC1155Component and ERC1155ReceiverComponent mixins (#941)
 - ERC721ReceiverComponent documentation (#945)
+- UDC docs (#954)
+- Util functions to precompute addresses (#954)
 
 ### Changed
 

docs/modules/ROOT/nav.adoc

@@ -7,7 +7,6 @@
 ** xref:presets.adoc[Presets]
 ** xref:interfaces.adoc[Interfaces and Dispatchers]
 ** xref:guides/deployment.adoc[Counterfactual Deployments]
-// ** xref:udc.adoc[Universal Deployer Contract]
 
 * Modules
 
@@ -37,6 +36,8 @@
 *** xref:/api/upgrades.adoc[API Reference]
 
 ** xref:utilities.adoc[Utilities]
+*** xref:udc.adoc[Universal Deployer Contract]
+**** xref:/api/udc.adoc[API Reference]
 
 * xref:backwards-compatibility.adoc[Backwards Compatibility]
 * xref:contracts::index.adoc[Contracts for Solidity]

docs/modules/ROOT/pages/api/udc.adoc

@@ -0,0 +1,86 @@
+:github-icon: pass:[<svg class="icon"><use href="#github-icon"/></svg>]
+
+= Universal Deployer
+
+Reference of the Universal Deployer Contract (UDC) interface and preset contract.
+
+== Core
+
+[.contract]
+[[IUniversalDeployer]]
+=== `++IUniversalDeployer++` link:https://github.com/OpenZeppelin/cairo-contracts/blob/release-v0.10.0/src/utils/universal_deployer/interface.cairo#L7[{github-icon},role=heading-link]
+
+```javascript
+use openzeppelin::utils::universal_deployer::interface::IUniversalDeployer;
+```
+
+[.contract-index]
+.Functions
+--
+* xref:#IUniversalDeployer-deploy_contract[`++deploy_contract(class_hash, salt, from_zero, calldata)++`]
+--
+
+[.contract-index]
+.Events
+--
+* xref:#IUniversalDeployer-ContractDeployed[`++ContractDeployed(address, deployer, from_zero, class_hash, calldata, salt)++`]
+--
+
+[#IUniversalDeployer-Functions]
+==== Functions
+
+[.contract-item]
+[[IUniversalDeployer-deploy_contract]]
+==== `[.contract-item-name]#++deploy_contract++#++(class_hash: ClassHash, salt: felt252, from_zero: bool, calldata: Span<felt252>) → ContractAddress++` [.item-kind]#external#
+
+Deploys a contract through the Universal Deployer Contract.
+
+[#IUniversalDeployer-Events]
+==== Events
+
+[.contract-item]
+[[IUniversalDeployer-ContractDeployed]]
+==== `[.contract-item-name]#++ContractDeployed++#++(address: ContractAddress, deployer: ContractAddress, from_zero: bool, class_hash: ClassHash, calldata: Span<felt252>, salt: felt252)++` [.item-kind]#event#
+
+Emitted when `deployer` deploys a contract through the Universal Deployer Contract.
+
+== Presets
+
+:origin-dependent: xref:/udc.adoc#origin_dependent[origin-dependent]
+:origin-independent: xref:/udc.adoc#origin_independent[origin-independent]
+
+[.contract]
+[[UniversalDeployer]]
+=== `++UniversalDeployer++` link:https://github.com/OpenZeppelin/cairo-contracts/blob/release-v0.10.0/src/presets/universal_deployer.cairo[{github-icon},role=heading-link]
+
+```javascript
+use openzeppelin::presets::UniversalDeployer;
+```
+
+The standard Universal Deployer Contract.
+
+include::../utils/_class_hashes.adoc[]
+
+[.contract-index]
+.{presets-page}
+--
+{UniversalDeployer-class-hash}
+--
+
+[.contract-index]
+.Embedded Implementations
+--
+.UniversalDeployerImpl
+* xref:#UniversalDeployer-deploy_contract[`++deploy_contract(self, address, deployer, from_zero, class_hash, calldata, salt)++`]
+--
+
+[.contract-item]
+[[UniversalDeployer-deploy_contract]]
+==== `[.contract-item-name]#++deploy_contract++#++(ref self: ContractState, address: ContractAddress, deployer: ContractAddress, from_zero: bool, class_hash: ClassHash, calldata: Span<felt252>, salt: felt252) -> ContractAddress++` [.item-kind]#external#
+
+Deploys a contract through the Universal Deployer Contract.
+
+When `from_zero` is `false`, the deployment type is {origin-dependent}.
+When `from_zero` is `true`, the deployment type is {origin-independent}.
+
+Emits an <<IUniversalDeployer-ContractDeployed,ContractDeployed>> event.