In this tutorial, we will guide you through the step-by-step process of creating Rentable NFT smart contracts. If you are not familiar with the concept of rentable NFTs, Read this <a href="https://www.buildbear.io/resources/guides-and-tutorials/ERC-4907_The_NFT_Rental_Standard">Article</a>. Unlike other articles, this one will focus solely on practical development without theoretical discussions.To help you get started swiftly, we have pre-configured everything for you. Let's begin by cloning the repository.<h3>Step 1: Cloning the Tutorial Repo</h3>1.1 Forking the Tutorial Repository:<ul><li>Head over to our&nbsp;<a href="https://github.com/BuildBearLabs/Tutorials">Tutorial Repository</a>&nbsp;and click on the “Fork” button to create a copy of the repository on your own account. Wait for the forking process to finish before proceeding.</li></ul>1.2 Cloning the repository locally:<ul><li>Go to your forked repository on GitHub.</li><li>Click the “Code” button and copy the HTTPS or SSH URL.</li><li>Open your terminal or Git Bash.</li><li>Navigate to the directory where you want to clone the repository.</li><li>Run the below command to clone the Repo.</li></ul><pre><code class="language-javascript">git clone &lt;paste the URL you copied&gt;
</code></pre><ul><li>Wait for the cloning process to complete. Once it’s done, you should see a new directory with the name of the repository in the directory.</li><li>To move into the cloned repository, use this command<code>cd &lt;Name of the cloned Repo&gt;</code>&nbsp;, then move to the RentableNFTs folder using this command<code>cd RentableNFTs</code>&nbsp;.</li></ul><h3>Step 2: Developing the smart contract</h3><figure class="image image_resized" style="width:74.26%;"><img src="https://strapi.buildbear.io/uploads/carbon_10_1_cf5ea8e122.png?updated_at=2023-05-27T16:51:06.335Z"></figure>There’s a lot to unpack here!The contract imports two external libraries: ERC721 and Counters from the OpenZeppelin library. These libraries provide implementations for the ERC721 standard and a counter for generating unique token IDs.First, let’s dive into the contract variables:<ul><li><code>_tokenIdCounter</code>: This is an instance of the <code>Counters.Counter</code> struct from the OpenZeppelin library. It is used to generate unique token IDs for each minted NFT. The variable keeps track of the current token ID counter.</li><li><code>_users</code>: This is a mapping that associates each token ID with a <code>UserInfo</code> struct. It stores the user and expiration information for each NFT. The keys are token IDs, and the values are <code>UserInfo</code> structs containing the user's address and the expiration timestamp.</li><li><code>UserInfo</code>: This is a struct that represents the user information for an NFT. It has two fields:<ul><li><code>user</code>: The address of the user who has rented the NFT.</li><li><code>expires</code>: The Unix timestamp indicating when the user's rental period expires.</li></ul></li></ul>Next, we’ll go over the functions<ul><li><code>setUser(uint256 tokenId, address user, uint64 expires)</code>: This function allows the owner or an approved address to set the user and expiration information for a specific NFT. It requires the caller to be the owner or approved to modify the NFT. The function takes three parameters: <code>tokenId</code> (the ID of the NFT), <code>user</code> (the address of the user who will rent the NFT), and <code>expires</code> (the Unix timestamp indicating when the user's rental period expires). The function checks that the NFT doesn't already have a user assigned and that the expiration timestamp is in the future. If the conditions are met, the function updates the user and expiration information for the NFT and emits an "UpdateUser" event.</li><li><code>userOf(uint256 tokenId)</code>: This function returns the address of the user who has rented a specific NFT. It takes the <code>tokenId</code> of the NFT as a parameter. If the NFT has no user or the user's rental period has expired, it returns the zero address.</li><li><code>userExpires(uint256 tokenId)</code>: This function returns the expiration timestamp for the user who has rented a specific NFT. It takes the <code>tokenId</code> of the NFT as a parameter. If the NFT has no user, it returns the value zero.</li><li><code>supportsInterface(bytes4 interfaceId)</code>: This function overrides the <code>supportsInterface</code> function from the ERC721 contract. It checks if the provided <code>interfaceId</code> is equal to the interface ID of the IERC4907 interface or if it's supported by the ERC721 contract. It returns <code>true</code> if the interface is supported, and <code>false</code> otherwise.</li><li><code>nftMint()</code>: This function allows the caller to mint a new NFT and assigns it to them. It increments the token ID counter, mints the NFT using the <code>_safeMint</code> function inherited from ERC721, emits the "NFTMinted" event with the caller's address and the token ID, and returns the token ID of the minted NFT.</li><li><code>_beforeTokenTransfer(address from, address to, uint256 tokenId, uint256 batchSize)</code>: This internal function is invoked before a token transfer occurs. It is called by the ERC721 contract. It checks if the user information for the token is present and if the user's rental period has expired. If both conditions are met, it deletes the user information for the token and emits an "UpdateUser" event with the zero address and zero expiration timestamp.</li><li><code>totalSupply()</code>: This function returns the total number of NFTs that have been minted. It retrieves the current value of the token ID counter and returns it as the total supply of NFTs.</li></ul><h3>Step 3: Getting up the infra needed to deploy and test our smart contract</h3>3.1. Visit the&nbsp;<a href="https://buildbear.io/">BuildBear App</a>&nbsp;(why BuildBear: Read article&nbsp;<a href="https://medium.com/@thomas_90087/a-thank-you-to-buildbear-5873b8394da5">here</a>).3.2. Create your Private Testnet forking from the Ethereum Mainnet, feel free to fork any Chain.<figure class="image image_resized" style="width:54.27%;"><img src="https://strapi.buildbear.io/uploads/Untitled_16_cf352b2e5a.png" alt="Untitled (16).png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_16_cf352b2e5a.png 245w,https://strapi.buildbear.io/uploads/small_Untitled_16_cf352b2e5a.png 500w,https://strapi.buildbear.io/uploads/medium_Untitled_16_cf352b2e5a.png 750w,https://strapi.buildbear.io/uploads/large_Untitled_16_cf352b2e5a.png 1000w," sizes="100vw"></figure>3.3. Add your Private Testnet to your MetaMask wallet by using the “Add to Metamask” button:<figure class="image image_resized" style="width:53.93%;"><img src="https://strapi.buildbear.io/uploads/Untitled_17_2579244a59.png" alt="Untitled (17).png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_17_2579244a59.png 245w,https://strapi.buildbear.io/uploads/small_Untitled_17_2579244a59.png 500w,https://strapi.buildbear.io/uploads/medium_Untitled_17_2579244a59.png 750w,https://strapi.buildbear.io/uploads/large_Untitled_17_2579244a59.png 1000w," sizes="100vw"></figure><h3>Step 4: Deploying the Smart Contract</h3>For installing the necessary packages, please execute the following command.<pre><code class="language-plaintext">npm install
</code></pre>4.1 Update the<code>hardhat.config.js</code>&nbsp;.<ul><li>Head to your Dashboard and click on “verify contract”.</li></ul><figure class="image image_resized" style="width:63.05%;"><img src="https://strapi.buildbear.io/uploads/Untitled_18_1296ff130b.png" alt="Untitled (18).png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_18_1296ff130b.png 245w,https://strapi.buildbear.io/uploads/small_Untitled_18_1296ff130b.png 500w,https://strapi.buildbear.io/uploads/medium_Untitled_18_1296ff130b.png 750w,https://strapi.buildbear.io/uploads/large_Untitled_18_1296ff130b.png 1000w," sizes="100vw"></figure><figure class="image image_resized" style="width:64.24%;"><img src="https://strapi.buildbear.io/uploads/Untitled_19_4d72d868c1.png" alt="Untitled (19).png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_19_4d72d868c1.png 184w,https://strapi.buildbear.io/uploads/small_Untitled_19_4d72d868c1.png 500w,https://strapi.buildbear.io/uploads/medium_Untitled_19_4d72d868c1.png 750w," sizes="100vw"></figure><ul><li>Copy the BuildBear and Etherscan objects, and update the&nbsp;<code>hardhat.config.js</code>&nbsp;file.</li></ul>4.2 To deploy the&nbsp;<code>RentableNFTs.sol</code>&nbsp;the smart contract runs the deploy command.&nbsp;<code>npx hardhat deploy</code>&nbsp;This will run the deployment and verification scripts in&nbsp;<code>deploy/00_deploy_rentable.js</code>,&nbsp;&nbsp;and saves the deployment details along with ABI and Contract address in the&nbsp;<code>deployments</code>&nbsp;folder.<figure class="image image_resized" style="width:82.9%;"><img src="https://strapi.buildbear.io/uploads/Untitled_20_74423dc87f.png" alt="Untitled (20).png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_20_74423dc87f.png 245w,https://strapi.buildbear.io/uploads/small_Untitled_20_74423dc87f.png 500w,https://strapi.buildbear.io/uploads/medium_Untitled_20_74423dc87f.png 750w,https://strapi.buildbear.io/uploads/large_Untitled_20_74423dc87f.png 1000w," sizes="100vw"></figure><ul><li>Click on the link provided in the terminal to see the Contract on Explore page.</li></ul>WOOT WOOT&nbsp;🎉 🎉4.3 Minting and Renting an NFT.<figure class="image image_resized" style="width:83.74%;"><img src="https://strapi.buildbear.io/uploads/carbon_11_1_1aff950ae1.png" alt="carbon (11) (1).png" srcset="https://strapi.buildbear.io/uploads/thumbnail_carbon_11_1_1aff950ae1.png 245w,https://strapi.buildbear.io/uploads/small_carbon_11_1_1aff950ae1.png 500w,https://strapi.buildbear.io/uploads/medium_carbon_11_1_1aff950ae1.png 750w,https://strapi.buildbear.io/uploads/large_carbon_11_1_1aff950ae1.png 1000w," sizes="100vw"></figure>In this script, we mint a new NFT by calling the <code>nftMint()</code> function of the contract and retrieving the ID of the minted NFT.Then, it calculates the expiration time for renting the NFT, which is set to one day from the current block's timestamp.The script assigns the rented NFT to a specific address using the <code>setUser()</code> function, indicating the address and expiration time.Finally, it confirms the successful rental by checking the assigned user of the NFT and prints a message indicating the successful rental.The script is configured in the&nbsp;<code>scripts/mintandrent.js</code>&nbsp;. To execute the scripts, please run the following command.<pre><code class="language-plaintext">npx hardhat run scripts/mintandrent.js
</code></pre><figure class="image image_resized" style="width:62.07%;"><img src="https://strapi.buildbear.io/uploads/Untitled_21_15b7b2c9b2.png" alt="Untitled (21).png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_21_15b7b2c9b2.png 245w,https://strapi.buildbear.io/uploads/small_Untitled_21_15b7b2c9b2.png 500w,https://strapi.buildbear.io/uploads/medium_Untitled_21_15b7b2c9b2.png 750w,https://strapi.buildbear.io/uploads/large_Untitled_21_15b7b2c9b2.png 1000w," sizes="100vw"></figure>&nbsp;NFT has been successfully minted and Rented to the User.<h3>Step 5: Testing the smart contract</h3>Testing smart contracts is a crucial aspect of the development process to ensure that the contracts function correctly and are error-free. In this section, we are going to test the smart contract whether it is working as intended or not.Navigate to the <code>Rentnft.test.js</code> file in the <code>test</code> folder.<figure class="image image_resized" style="width:76.02%;"><img src="https://strapi.buildbear.io/uploads/carbon_12_1_d01ec8daa1.png?updated_at=2023-05-27T16:35:30.693Z"></figure>In each test case, the code is testing the following:<ol><li>Minting NFT:<ul><li>The test case mints 1 NFT using the <code>nftMint()</code> function of the contract.</li><li>It then checks the balance of the user by verifying the total supply of NFTs using the <code>totalSupply()</code> function, expecting it to be equal to 1.</li></ul></li><li>Renting an NFT:<ul><li>The test case mints 1 NFT using the <code>nftMint()</code> function of the contract.</li><li>It calculates the expiration time for renting the NFT and assigns it to a user using the <code>setUser()</code> function.</li><li>Finally, it checks whether the assigned user of the NFT matches the expected address.</li></ul></li><li>Renting the same NFT twice:<ul><li>The test case mints 1 NFT using the <code>nftMint()</code> function of the contract.</li><li>It calculates the expiration time for renting the NFT and assigns it to a user using the <code>setUser()</code> function.</li><li>Then, it tries to rent the same NFT to a different user again, expecting the transaction to be reverted with the error message "User already assigned".</li></ul></li><li>User NFT transfer:<ul><li>The test case mints 1 NFT using the <code>nftMint()</code> function of the contract.</li><li>It calculates the expiration time for renting the NFT and assigns it to a user using the <code>setUser()</code> function.</li><li>It attempts to transfer the NFT to another user, expecting the transaction to be reverted with the error message "ERC721: the caller is not token owner or approved".</li></ul></li><li>NFT rent expires:<ul><li>The test case mints 1 NFT using the <code>nftMint()</code> function of the contract.</li><li>It calculates the expiration time for renting the NFT and assigns it to a user using the <code>setUser()</code> function.</li><li>It checks whether the expiration time of the NFT is less than one day (the specified duration).</li></ul></li></ol>These test cases cover different aspects of the "RentableNFT" contract, including minting NFTs, assigning them to users for rent, preventing double rentals, restricting user NFT transfers, and checking expiration times.To run all the tests in your project, open your terminal and type the following command:<pre><code class="language-plaintext">npx hardhat test
</code></pre>This command will execute each test case in the project and output the results to the terminal.If all tests pass successfully, you should see a long list of passing test results displayed in the terminal, like the example shown below:<figure class="image image_resized" style="width:58.45%;"><img src="https://strapi.buildbear.io/uploads/Untitled_22_5ad44080f4.png" alt="Untitled (22).png" srcset="https://strapi.buildbear.io/uploads/thumbnail_Untitled_22_5ad44080f4.png 245w,https://strapi.buildbear.io/uploads/small_Untitled_22_5ad44080f4.png 500w,https://strapi.buildbear.io/uploads/medium_Untitled_22_5ad44080f4.png 750w," sizes="100vw"></figure>If you appreciate what we are doing, please follow us on&nbsp;<a href="https://twitter.com/_BuildBear">Twitter</a>, and&nbsp;<a href="https://www.linkedin.com/company/build-bear/">LinkedIn</a>&nbsp;and&nbsp;<a href="https://t.me/+6mjOnBFUR9xjN2U1">Join the Telegram</a>&nbsp;group if you haven’t done yet.And please give us a clap 👏 if you like our work.Github Repo :&nbsp;<a href="https://github.com/BuildBearLabs/Tutorials">Buildbear Tutorials</a>About BuildBear:BuildBear is a platform for testing dApps at scale, for teams. It provides users with their own private Testnet to test their smart contracts and dApps, which can be forked from any EVM chain. It also provides a Faucet, Explorer, and RPC for testing purposes.<blockquote>BuildBear aims to build an ecosystem of tools for testing dApps at scale for the teams.</blockquote>Authors:&nbsp;<a href="https://twitter.com/chandan1_">Chandan</a>

Twitter post - 9 (1).png

In this tutorial, we will guide you through the step-by-step process of creating Rentable NFT smart contracts. If you are not familiar with the concept of rentable NFTs, Read this Article. Unlike other articles, this one will focus solely on practical development without theoretical discussions.

Create Rentable NFTs Using ERC-4907 Standard

BUILDBEAR // TUTORIALS

Create Rentable NFTs Using ERC-4907 Standard

Let’s get started then, Shall we?

Let’s get started then, Shall we?

Test DApps at Scale.