Update erc721 docs

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

@@ -39,9 +39,6 @@ Interface of the IERC721 standard as defined in {eip721}.
 * xref:#IERC721-set_approval_for_all[`++set_approval_for_all(operator, approved)++`]
 * xref:#IERC721-get_approved[`++get_approved(token_id)++`]
 * xref:#IERC721-is_approved_for_all[`++is_approved_for_all(owner, operator)++`]
-
-.ISRC5
-* xref:/api/introspection.adoc#ISRC5-supports_interface[`++supports_interface(interface_id)++`]
 --
 
 [.contract-index]
@@ -70,7 +67,7 @@ Returns the owner address of `token_id`.
 [[IERC721-safe_transfer_from]]
 ==== `[.contract-item-name]#++safe_transfer_from++#++(from: ContractAddress, to: ContractAddress, token_id: u256, data: Span<felt252>)++` [.item-kind]#external#
 
-Safely transfer ownership of `token_id` from `from` to `to`, checking first that `to` is aware of the ERC721 protocol to prevent tokens being locked forever.
+Transfer ownership of `token_id` from `from` to `to`, checking first that `to` is aware of the ERC721 protocol to prevent tokens being locked forever.
 For information regarding how contracts communicate their awareness of the ERC721 protocol, see {receiving-tokens}.
 
 Emits a <<IERC721-Transfer,Transfer>> event.
@@ -143,8 +140,7 @@ Emitted when `token_id` token is transferred from `from` to `to`.
 use openzeppelin::token::erc721::interface::IERC721Metadata;
 ```
 
-ERC721 extension that allows your smart contract to be interrogated for its name and for details about the assets which the NFTs represent.
-See {eip721}.
+Interface for the optional metadata functions in {eip721}.
 
 [.contract-index]
 .{inner-src5}
@@ -156,31 +152,8 @@ See {eip721}.
 .Functions
 --
 * xref:#IERC721Metadata-name[`++name()++`]
-* xref:#IERC721Metadata-owner_of[`++symbol()++`]
+* xref:#IERC721Metadata-symbol[`++symbol()++`]
 * xref:#IERC721Metadata-token_uri[`++token_uri(token_id)++`]
-
-.IERC721
-* xref:#IERC721-balance_of[`++balance_of(account)++`]
-* xref:#IERC721-owner_of[`++owner_of(token_id)++`]
-* xref:#IERC721-safe_transfer_from[`++safe_transfer_from(from, to, token_id, data)++`]
-* xref:#IERC721-transfer_from[`++transfer_from(from, to, token_id)++`]
-* xref:#IERC721-approve[`++approve(to, token_id)++`]
-* xref:#IERC721-set_approval_for_all[`++set_approval_for_all(operator, approved)++`]
-* xref:#IERC721-get_approved[`++get_approved(token_id)++`]
-* xref:#IERC721-is_approved_for_all[`++is_approved_for_all(owner, operator)++`]
-
-.ISRC5
-* xref:/api/introspection.adoc#ISRC5-supports_interface[`++supports_interface(interface_id)++`]
---
-
-[.contract-index]
-.Events
---
-.IERC721
-
-* xref:#IERC721-Approval[`++Approval(owner, approved, token_id)++`]
-* xref:#IERC721-ApprovalForAll[`++ApprovalForAll(owner, operator, approved)++`]
-* xref:#IERC721-Transfer[`++Transfer(from, to, token_id)++`]
 --
 
 ==== Functions
@@ -205,20 +178,17 @@ Returns the Uniform Resource Identifier (URI) as a short string for the `token_i
 If the URI is not set for `token_id`, the return value will be `0`.
 
 [.contract]
-[[ERC721]]
-=== `++ERC721++` link:https://github.com/OpenZeppelin/cairo-contracts/blob/cairo-2/src/token/erc721/erc721.cairo#L7[{github-icon},role=heading-link]
+[[ERC721Component]]
+=== `++ERC721Component++` link:https://github.com/OpenZeppelin/cairo-contracts/blob/cairo-2/src/token/erc721/erc721.cairo#L7[{github-icon},role=heading-link]
 
 [.hljs-theme-dark]
 ```javascript
-use openzeppelin::token::erc721::ERC721;
+use openzeppelin::token::erc721::ERC721Component;
 ```
 
-Implementation of ERC721 which includes the IERC721Metadata extension as specified in https://eips.ethereum.org/EIPS/eip-721[EIP-721].
-
-[.contract-index]
-.Constructor
+ERC721 component implementing <<IERC721,IERC721>> and <<IERC721Metadata,IERC721Metadata>>.
 
-* xref:#ERC721-constructor[`++constructor(self, name, symbol)++`]
+NOTE: Implementing xref:api/introspection.adoc#SRC5Component[SRC5Component] is a requirement for this component to be implemented.
 
 [.contract-index]
 .External functions
@@ -233,9 +203,6 @@ Implementation of ERC721 which includes the IERC721Metadata extension as specifi
 * xref:#IERC721-get_approved[`++get_approved(self, token_id)++`]
 * xref:#IERC721-is_approved_for_all[`++is_approved_for_all(self, owner, operator)++`]
 
-.ISRC5Impl
-* xref:/api/introspection.adoc#ISRC5-supports_interface[`++supports_interface(self, interface_id)++`]
-
 .IERC721MetadataImpl
 * xref:#IERC721Metadata-name[`++name(self)++`]
 * xref:#IERC721Metadata-symbol[`++symbol(self)++`]
@@ -245,7 +212,7 @@ Implementation of ERC721 which includes the IERC721Metadata extension as specifi
 [.contract-index]
 .camelCase support
 --
-.ER721CamelImpl
+.ER721CamelOnlyImpl
 * xref:#ERC721-balanceOf[`++balanceOf(self, account)++`]
 * xref:#ERC721-ownerOf[`++ownerOf(self, tokenId)++`]
 * xref:#ERC721-safeTransferFrom[`++safeTransferFrom(self, from, to, tokenId, data)++`]
@@ -254,9 +221,6 @@ Implementation of ERC721 which includes the IERC721Metadata extension as specifi
 * xref:#ERC721-getApproved[`++getApproved(self, tokenId)++`]
 * xref:#ERC721-isApprovedForAll[`++isApprovedForAll(self, owner, operator)++`]
 
-.SRC5CamelImpl
-* xref:/api/introspection.adoc#ISRC5-supports_interface[`++supportsInterface(self, interfaceId)++`]
-
 .ERC721MetadataCamelOnlyImpl
 * xref:#ERC721-tokenURI[`++tokenURI(self, tokenId)++`]
 --
@@ -288,20 +252,7 @@ Implementation of ERC721 which includes the IERC721Metadata extension as specifi
 * xref:#IERC721-Transfer[`++Transfer(from, to, token_id)++`]
 --
 
-==== Constructor
-
-:src5: xref:introspection.adoc#src5[SRC5]
-:ierc721: xref:/api/erc721.adoc#IERC721[IERC721]
-:ierc721metadata: xref:/api/erc721.adoc#IERC721Metadata[IERC721Metadata]
-
-[.contract-item]
-[[ERC721-constructor]]
-==== `[.contract-item-name]#++constructor++#++(ref self: ContractState, name: felt252, symbol: felt252)++` [.item-kind]#constructor#
-
-Initializes the state of the ERC721 contract by setting the token name and symbol.
-The constructor also registers the {ierc721} and {ierc721metadata} interface ids according to {src5}.
-
-==== External functions
+==== Embeddable functions
 
 [.contract-item]
 [[ERC721-balance_of]]
@@ -416,18 +367,18 @@ See <<IERC721-balance_of,IERC721::balance_of>>.
 
 See <<IERC721-owner_of,IERC721::owner_of>>.
 
-[.contract-item]
-[[ERC721-transferFrom]]
-==== `[.contract-item-name]#++transferFrom++#++(ref self: ContractState, from: ContractAddress, to: ContractAddress, tokenId: u256)++` [.item-kind]#external#
-
-See <<IERC721-transfer_from,IERC721::transfer_from>>.
-
 [.contract-item]
 [[ERC721-safeTransferFrom]]
 ==== `[.contract-item-name]#++safeTransferFrom++#++(ref self: ContractState, from: ContractAddress, to: ContractAddress, tokenId: u256, data: Span<felt252>)++` [.item-kind]#external#
 
 See <<IERC721-safe_transfer_from,IERC721::safe_transfer_from>>.
 
+[.contract-item]
+[[ERC721-transferFrom]]
+==== `[.contract-item-name]#++transferFrom++#++(ref self: ContractState, from: ContractAddress, to: ContractAddress, tokenId: u256)++` [.item-kind]#external#
+
+See <<IERC721-transfer_from,IERC721::transfer_from>>.
+
 [.contract-item]
 [[ERC721-setApprovalForAll]]
 ==== `[.contract-item-name]#++setApprovalForAll++#++(ref self: ContractState, operator: ContractAddress, approved: bool)++` [.item-kind]#external#
@@ -516,8 +467,6 @@ Requirements:
 [[ERC721-_mint]]
 ==== `[.contract-item-name]#++_mint++#++(ref self: ContractState, to: ContractAddress, token_id: u256)++` [.item-kind]#internal#
 
-WARNING: Usage of this method is discouraged, use <<IERC721-_safe_mint,_safe_mint>> whenever possible.
-
 Internal function that mints `token_id` and transfers it to `to`.
 
 Emits an <<IERC721-Transfer,Transfer>> event.
@@ -559,21 +508,21 @@ Requirements:
 [[ERC721-_safe_mint]]
 ==== `[.contract-item-name]#++_safe_mint++#++(ref self: ContractState, to: ContractAddress, token_id: u256, data: Span<felt252>)++` [.item-kind]#internal#
 
-Internal function that safely mints `token_id` and transfers it to `to`.
+Internal function that mints `token_id` and transfers it to `to`.
 If `to` is not an account contract, `to` must support <<IERC721Receiver,IERC721Receiver>>; otherwise, the transaction will fail.
 
 Emits an <<IERC721-Transfer,Transfer>> event.
 
 Requirements:
 
-- `token_id` exists.
+- `token_id` does not already exist.
 - `to` is either an account contract or supports the <<IERC721Receiver,IERC721Receiver>> interface.
 
 [.contract-item]
 [[ERC721-_safe_transfer]]
 ==== `[.contract-item-name]#++_safe_transfer++#++(ref self: ContractState, from: ContractAddress, to: ContractAddress, token_id: u256, data: Span<felt252>)++` [.item-kind]#internal#
 
-Safely transfers `token_id` token from `from` to `to`, checking first that contract recipients are aware of the ERC721 protocol to prevent tokens from being forever locked.
+Internal function that transfers `token_id` token from `from` to `to`, checking first that contract recipients are aware of the ERC721 protocol to prevent tokens from being forever locked.
 
 `data` is additional data, it has no specified format and it is sent in call to `to`.
 
@@ -592,7 +541,7 @@ Requirements:
 [[ERC721-_set_token_uri]]
 ==== `[.contract-item-name]#++_set_token_uri++#++(ref self: ContractState, token_id: u256, token_uri: felt252)++` [.item-kind]#internal#
 
-Sets the `token_uri` of `token_id`.
+Internal function that sets the `token_uri` of `token_id`.
 
 Requirements:
 
@@ -627,6 +576,8 @@ See <<IERC721-Transfer,Transfer>>.
 use openzeppelin::token::erc721::interface::IERC721Receiver;
 ```
 
+Interface for any contract that wants to support safe token transfers from ERC721 asset contracts.
+
 [.contract-index]
 .{inner-src5}
 --

docs/modules/ROOT/pages/erc20.adoc

@@ -90,6 +90,8 @@ mod MyToken {
     impl ERC20Impl = ERC20Component::ERC20Impl<ContractState>;
     #[abi(embed_v0)]
     impl ERC20MetadataImpl = ERC20Component::ERC20MetadataImpl<ContractState>;
+    #[abi(embed_v0)]
+    impl ERC20CamelOnlyImpl = ERC20Component::ERC20CamelOnlyImpl<ContractState>;
     impl ERC20InternalImpl = ERC20Component::InternalImpl<ContractState>;
 
     #[storage]
@@ -179,6 +181,8 @@ mod MyToken {
 
     #[abi(embed_v0)]
     impl ERC20Impl = ERC20Component::ERC20Impl<ContractState>;
+    #[abi(embed_v0)]
+    impl ERC20CamelOnlyImpl = ERC20Component::ERC20CamelOnlyImpl<ContractState>;
     impl ERC20InternalImpl = ERC20Component::InternalImpl<ContractState>;
 
     #[storage]