Document Class Hashes

docs/modules/ROOT/nav.adoc

@@ -30,4 +30,6 @@
 // * xref:udc.adoc[Universal Deployer Contract]
 // * xref:utilities.adoc[Utilities]
 
+* xref:/presets.adoc[Presets]
+
 * xref:contracts::index.adoc[Contracts for Solidity]

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

@@ -272,6 +272,14 @@ use openzeppelin::presets::Account;
 
 Basic account contract leveraging xref:#AccountComponent[AccountComponent].
 
+:class-hashes: xref:presets.adoc[Compiled class hash]
+
+[.contract-index]
+.{class-hashes}
+--
+0x016c6081eb34ad1e0c5513234ed0c025b3c7f305902d291bad534cd6474c85bc
+--
+
 [.contract-index]
 .Constructor
 --

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

@@ -484,6 +484,14 @@ use openzeppelin::presets::ERC20;
 
 Basic ERC20 contract leveraging xref:#ERC20Component[ERC20Component] with a fixed-supply mechanism for token distribution.
 
+:class-hashes: xref:presets.adoc[Compiled class hash]
+
+[.contract-index]
+.{class-hashes}
+--
+0x01d7085cee580ba542cdb5709bda80ebfe8bdede664261a3e6af92994d9a1de7
+--
+
 [.contract-index]
 .Constructor
 --
@@ -509,5 +517,4 @@ Basic ERC20 contract leveraging xref:#ERC20Component[ERC20Component] with a fixe
 [[ERC20-constructor]]
 ==== `[.contract-item-name]#++constructor++#++(ref self: ContractState, name: felt252, symbol: felt252, fixed_supply: u256, recipient: ContractAddress)++` [.item-kind]#constructor#
 
-Sets the `name` and `symbol`.
-Mints `fixed_supply` tokens to `recipient`.
+Sets the `name` and `symbol` and mints `fixed_supply` tokens to `recipient`.

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

@@ -190,8 +190,8 @@ ERC721 component implementing <<IERC721,IERC721>> and <<IERC721Metadata,IERC721M
 
 NOTE: Implementing xref:api/introspection.adoc#SRC5Component[SRC5Component] is a requirement for this component to be implemented.
 
-[.contract-index]
-.External functions
+[.contract-index#ERC721Component-Embeddable-Impls]
+.Embeddable Implementations
 --
 .IERC721Impl
 * xref:#IERC721-balance_of[`++balance_of(self, account)++`]
@@ -209,8 +209,8 @@ NOTE: Implementing xref:api/introspection.adoc#SRC5Component[SRC5Component] is a
 * xref:#IERC721Metadata-token_uri[`++token_uri(self, token_id)++`]
 --
 
-[.contract-index]
-.camelCase support
+[.contract-index#ERC721Component-Embeddable-Impls-camelCase]
+.Embeddable implementations (camelCase)
 --
 .ER721CamelOnlyImpl
 * xref:#ERC721-balanceOf[`++balanceOf(self, account)++`]
@@ -597,3 +597,55 @@ Interface for contracts that support receiving `safe_transfer_from` transfers.
 ==== `[.contract-item-name]#++on_erc721_received++#++(operator: ContractAddress, from: ContractAddress, token_id: u256, data Span<felt252>) -> felt252++` [.item-kind]#external#
 
 Whenever an IERC721 `token_id` token is transferred to this non-account contract via <<IERC721-safe_transfer_from,IERC721::safe_transfer_from>> by `operator` from `from`, this function is called.
+
+== Presets
+
+[.contract]
+[[ERC721]]
+=== `++ERC721++` link:https://github.com/OpenZeppelin/cairo-contracts/blob/release-v0.8.0-beta.0/src/presets/erc721.cairo[{github-icon},role=heading-link]
+
+```javascript
+use openzeppelin::presets::ERC721;
+```
+
+Basic ERC721 contract leveraging xref:#ERC721Component[ERC721Component].
+
+:class-hashes: xref:presets.adoc[Compiled class hash]
+
+[.contract-index]
+.{class-hashes}
+--
+0x04376782cbcd20a05f8e742e96150757383dab737ab3e791b8505ad856756907
+--
+
+[.contract-index]
+.Constructor
+--
+* xref:#ERC721-constructor[`++constructor(self, name, symbol, recipient, token_ids, token_uris)++`]
+--
+
+[.contract-index]
+.Embedded Implementations
+--
+.ERC721Component
+
+* xref:#ERC721Component-Embeddable-Impls[`++ERC721Impl++`]
+* xref:#ERC721Component-Embeddable-Impls[`++ERC721MetadataImpl++`]
+* xref:#ERC721Component-Embeddable-Impls-camelCase[`++ERC721CamelOnly++`]
+* xref:#ERC721Component-Embeddable-Impls-camelCase[`++ERC721MetadataCamelOnly++`]
+
+.SRC5Component
+
+* xref:api/introspection.adoc#SRC5Component-Embeddable-Impls[`++SRC5Impl++`]
+--
+
+[#ERC721-constructor-section]
+==== Constructor
+
+[.contract-item]
+[[ERC721-constructor]]
+==== `[.contract-item-name]#++constructor++#++(ref self: ContractState, name: felt252, symbol: felt252, recipient: ContractAddress, token_ids: Span<u256>, token_uris: Span<felt252>)++` [.item-kind]#constructor#
+
+Sets the `name` and `symbol`.
+
+Mints `token_ids` tokens with each corresponding URI from `token_uris` to `recipient`.

docs/modules/ROOT/pages/presets.adoc

@@ -0,0 +1,33 @@
+:cairo-version: https://crates.io/crates/cairo-lang-compiler/2.3.1[cairo 2.3.1]
+:scarb: https://docs.swmansion.com/scarb[scarb]
+
+= Presets
+
+List of "ready-to-deploy" presets available and their corresponding class hashes.
+
+:account: xref:/api/account.adoc#Account[Account.cairo]
+:erc20: xref:/api/erc20.adoc#ERC20[ERC20.cairo]
+:erc721: xref:/api/erc721.adoc#ERC721[ERC721.cairo]
+:cairo-and-sierra: https://docs.starknet.io/documentation/architecture_and_concepts/Smart_Contracts/cairo-and-sierra/[Cairo and Sierra]
+
+NOTE: Class hashes were computed using {cairo-version}.
+
+|===
+| Name | Compiled Class Hash
+
+| `{account}`
+| `0x016c6081eb34ad1e0c5513234ed0c025b3c7f305902d291bad534cd6474c85bc`
+
+| `{erc20}`
+| `0x01d7085cee580ba542cdb5709bda80ebfe8bdede664261a3e6af92994d9a1de7`
+
+| `{erc721}`
+| `0x04376782cbcd20a05f8e742e96150757383dab737ab3e791b8505ad856756907`
+|===
+
+:starkli: https://book.starkli.rs/introduction[starkli]
+
+To understand the compiled class hash term, check {cairo-and-sierra}.
+
+TIP: {starkli} class-hash command can be used to compute the class hash from a compiled artifact. To obtain the artifact
+using {scarb}, set the `casm = true` option under `\[[target.starknet-contract]]` in the `Scarb.toml` file.