- \n
- Created artwork for LPI based on a CC-licensed image of the popular Tux penguin representing Linux<\/li>\n
- Created NFTs with a customized Solidity contract<\/a><\/li>\n
- Deployed and verified the contract on a public test network (testnet)<\/li>\n
- Minted NFTs that our testers could manage in their wallets<\/li>\n<\/ul>\n
The rest of this posting walks through how we created a series of NFTs using entirely open-source tools.<\/p>\n
Creating the Images<\/h2>\n
For the artwork, we adopted the method common to many popular existing NFTs (e.g., CryptoPunks<\/a> and CryptoKitties<\/a>): Generating a random combination of attributes to customize a base image. This process creates several variations of a common character or theme in a series of NFTs.<\/p>\n
Alex created the images for the base Tux and additional attributes using GIMP<\/a> and GraphicsMagick<\/a>. The images were organized into designated directories (Figure 1) for each area of Tux that Alex customized: shirts, pants, hats, beak, flippers, and so on.<\/p>\n
![\"Figure](\"https:\/\/www.lpi.org\/sites\/default\/files\/nft-figure-1_02.jpg\")
Figure 1: Component image layout (partial)<\/figcaption><\/figure>\n<\/p>\n The final images were created using a Bash script. First, the script randomly selected one out of several base images of Tux. Then the script overlaid one attribute from each attribute directory onto the base image and saved the final, combined image. Since we were picking random attributes, the script also checks before saving the new image that the new combination of attributes did not repeat an existing combination. The entire process is repeated until the desired number of images is fulfilled.<\/p>\n
The GraphicsMagick gm composite<\/span><\/a> command combined the images. Since the gm command works with one base image and only one overlay image at a time, the script made wrapped calls to the command in a loop (Figure 2) to have the resulting image include multiple attributes.<\/p>\n
![\"Figure](\"https:\/\/www.lpi.org\/sites\/default\/files\/nft-figure-2-02.jpg\")
Figure 2: Layering process<\/figcaption><\/figure>\n<\/p>\n The key command-line tools used in the script were:\u00a0<\/p>\n
- \n
- sort<\/span><\/a>: Used with the little-known –random-sort or -R option, this command returns the attributes in each directory in a randomized order.<\/li>\n
- head<\/a><\/span>: This command selects the first image from the previously mentioned, randomly ordered \u00a0list.<\/li>\n
- sed<\/a><\/span>: A streaming text editor, this command creates the metadata file from the template (shown below), by replacing ##TOKENNUM##<\/span> and ##TOKENURI##<\/span> with the current number and URI for the image the script is currently generating.<\/li>\n<\/ul>\n
Each NFT was supplemented by documentation specifying its title, description, and image URI (similar to an address). These details were implemented in our smart contract using a metadata file specified in the ERC-721 JSON standard<\/a> for NFTs, as seen in the following sample:<\/p>\n
{
\n\u00a0 \u00a0 “title”: “MyToken”,
\n\u00a0 \u00a0 “type”: “object”,
\n\u00a0 \u00a0 “properties”: {
\n\u00a0 \u00a0 \u00a0 \u00a0 “name”: {
\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 “type”: “string”,
\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 “description”: “MyToken ###TOKENNUM##”
\n\u00a0 \u00a0 \u00a0 \u00a0 },
\n\u00a0 \u00a0 \u00a0 \u00a0 “description”: {
\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 “type”: “string”,
\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 “description”: “MyToken ###TOKENNUM##”
\n\u00a0 \u00a0 \u00a0 \u00a0 },
\n\u00a0 \u00a0 \u00a0 \u00a0 “image”: {
\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 “type”: “string”,
\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 “description”: “##TOKENURI##”
\n\u00a0 \u00a0 \u00a0 \u00a0 }
\n\u00a0 \u00a0 }
\n}<\/span><\/p>\nExample 1: NFT template metadata file for sed to transform<\/em><\/p>\n
While we opted for our metadata files to solely contain the base provided by the ERC-721 standard, you may want to include different, unique features in your own.\u00a0<\/p>\n
Writing an NFT Contract<\/h2>\n
Smart contracts are software programs that are stored and executed on a blockchain network. This software is used to add additional features to transactions, such as allowing the licensee to transfer NFTs to other people. Smart contracts can serve a wide variety of possible functions, including facilitating the storage of transaction information on the network, verifying ownerships, and transferring tokens.\u00a0<\/p>\n
The main tools and resources that I used to create the contracts were:\u00a0<\/p>\n
- \n
- OpenZeppellin<\/a>: Described on Zeppelin’s<\/a> website as \u201can open-source framework for building secure smart contracts<\/a>\u201d, this project provides documentation, libraries, and support for the construction of smart contracts on decentralized blockchain networks.<\/li>\n
- Solidity<\/a>: Used by me to create our smart contracts, this is the programming language for both the sample work and OpenZeppelin\u2019s Contracts Wizard<\/a>. It is also commonly known for its usage in writing and implementing smart contracts in general.<\/li>\n
- Truffle<\/a>: Described as a \u201cpersonal blockchain for Ethereum development you can use to deploy contracts, develop your applications, and run tests<\/a>\u201d, Truffle provides an isolated environment to test smart contracts prior to deployment on an active blockchain. You can use Truffle to compile, deploy, and interact with your software on your local system.\u00a0<\/li>\n
- Ganache<\/a>: A subset of the Truffle ecosystem, this \u00a0is a developer environment and command-line tool that assists in the development, testing, and deployment of safe (that is, secure) smart contracts on a local (personal) Truffle blockchain network. Developers using Ganache gain the added benefit of not requiring personal test or real ether (ETH), the cryptocurrency used on the Ethereum blockchain. Avoiding ether is convenient for reasons outlined in the following sections.<\/li>\n
- Ropsten<\/a>: This is a public Ethereum testnet. We used it in our final testing phase, as it has the closest resemblance to the Ethereum Mainnet. Ropsten is the only proof-of-work<\/a> testnet. It requires developers to have personal test cryptocurrency.<\/li>\n
- Etherscan<\/a>: This is a search engine that allows you to view contracts, tokens, accounts, transactions, and blocks stored on Ethereum Mainnet or testnets. Because Etherscan can search for smart contracts, it can be used after deploying your own to verify that the contract has successfully become active.<\/li>\n
- MetaMask<\/a>: A blockchain wallet\u2013much like those in real life\u2013that acts as digital storage for information that provides access to assets (the assets themselves are stored on a blockchain). Metamask is a wallet specified for the Ethereum blockchain in the form of a browser plugin and mobile app that allows users to view or transfer (and swap<\/a>, when on the Mainnet) assets.<\/li>\n<\/ul>\n
Creating and interacting with a smart contract for an NFT is very manageable using OpenZeppellin\u2019s smart contracts documentation<\/a> and Contract Wizard<\/a>, with or without knowledge of Solidity. However, with a working knowledge of Solidity, a programmer can easily add their own customizations to the generated contracts.<\/p>\n
For example, the code produced by the wizard for a contract includes a function for minting the tokens, safeMint. The function mints only one token at a time. Thus, to mint 10,000 tokens, you have to call the mint function 10,000 times. I added the following code written to a contract to handle multiple mints at once:\u00a0<\/p>\n
function mintMany(uint256 num, address to) public onlyOwner {
\n\u00a0 \u00a0 for (uint256 i = 0; i < num; i++){
\n\u00a0 \u00a0 \u00a0 \u00a0 safeMint(to);
\n\u00a0 \u00a0 }
\n}<\/span><\/p>\nExample 2: Basic custom contract function sample<\/em><\/p>\n
One of the more important features to note on the Contract Wizard is selecting your contract\u2019s token standard<\/a>. Standards have been developed for tokens to keep their contracts compatible with each other and to ensure that they provide the basic functionality (ex. minting, owning, transferring, tracking, etc). ERC-721<\/a> is the standard interface when creating non-fungible tokens\u2013that is, tokens that cannot be used interchangeably but are each unique\u2013and was what we selected when creating a contract with the wizard.\u00a0<\/p>\n
Transactions on a blockchain network have an associated cost in a given cryptocurrency. This fee is commonly referred to as gas<\/a>. For the Ethereum blockchain, ether is the currency used to pay the gas fee in the unit of gwei<\/em>, equivalent to 10E-9 ether.\u00a0<\/p>\n
With the current market value of ether (ETH, the coin used on the Ethereum blockchain), it is relatively expensive to deploy contracts. So when you do it on the Ethereum Mainnet, you\u2019d want to be certain there won\u2019t be any issues or errors that would cause you to have to redo a transaction. You pay the gas whether or not a transaction is successful<\/a>.\u00a0<\/p>\n
Taking the financial costs into account, if you\u2019re just learning how to interact with blockchain networks, you wouldn\u2019t want to do your practice on the Mainnet. Instead, you would likely do so on a testnet where you can pay gas fees with test ether that has no real value<\/a>.<\/p>\n
Therefore, in order of testing, we first learned the basics of deploying and interacting with the sample contracts provided by OpenZeppellin on Ganache, a local, personal network. Then, after some practice, we moved to Ropsten, a public test network.<\/p>\n
Because our testnet of choice was Ropsten, we needed currency to use on the network\u2013in this case, ropsten ether (rETH)<\/a>. Unlike normal ETH, rETH can be obtained for free using rETH faucets. These faucets allow you to enter the address you wish to transfer the test ether to, typically once every 24 hours. This delay is part of what makes Ganache\u2019s wait-free network ideal for initial experimentation. There are various faucets that drip different amounts at different time intervals. The faucets we used were:<\/p>\n
- \n
- MyCrypto<\/a>: Can request \u00a00.01 RopstenETH as frequently as you\u2019d like\u00a0<\/li>\n
- Dimensions Network Faucet<\/a>: Can request 5 rETH every 24 hours<\/li>\n
- Ropsten Ethereum Faucet<\/a>: Can request 1 rETH every 24 hours\u00a0<\/li>\n<\/ul>\n
After you have your test ether to cover the gas price, you can then proceed with deployment to your chosen public testnet. You can confirm and see your work using Etherscan and MetaMask by using the contract address from the deployment receipt (see the following Javascript output from deploying the contract) to search for your contract (Figure 3) and import your tokens to your wallet (Figure 4).\u00a0<\/p>\n
2_deploy.js
\n===========<\/span><\/p>\n\u00a0 \u00a0 Deploying \u2018MyToken\u2019
\n\u00a0 \u00a0 – – – – – – – –\u00a0
\n\u00a0 \u00a0 > transaction hash:\u00a0\u00a0 \u00a00x1b2f67de68204ae3c137985379103ce8435a51a45452f624487e13b182ab2052
\n\u00a0 \u00a0 > Blocks: 1\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0Seconds: 18
\n\u00a0 \u00a0 > contract address: \u00a0\u00a0 \u00a00x3dd50Bcb9E125f1B7537f257fB6f4C165a02cB0f
\n\u00a0 \u00a0 > block number:\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a010822250
\n\u00a0 \u00a0 > block timestamp:\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a01628784232
\n\u00a0 \u00a0 > account:\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a00x6dfA9B40F8a6AC500BcD0F09Bfa7709c6bD74dBC
\n\u00a0 \u00a0 > balance:\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a016.44630489
\n\u00a0 \u00a0 > gas used:\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a03171561 (0x3064e9)
\n\u00a0 \u00a0 > gas price:\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a020 gwei
\n\u00a0 \u00a0 > value sent:\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a00 ETH
\n\u00a0 \u00a0 > total cost:\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a00.06343122 ETH<\/span><\/p>\n\u00a0 \u00a0 > Saving artifacts\u00a0
\n\u00a0 \u00a0 – – – – – – – – – – – – – – – – – – – – –\u00a0
\n\u00a0 \u00a0 > Total cost:\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a00.06343122 ETH<\/span><\/p>\nExample 3: JS output (deployment receipt) from deploying MyToken contract<\/em><\/p>\n
![\"Figure](\"https:\/\/www.lpi.org\/sites\/default\/files\/nft-figure-3-02.jpg\")
Figure 3: MyToken<\/a> Contract on Etherscan<\/figcaption><\/figure>\n<\/p>\n ![\"Figure](\"https:\/\/www.lpi.org\/sites\/default\/files\/nft-figure-4-02.jpg\")
Figure 4: Test NFT called MyToken (MTK)<\/a>, viewed in a MetaMask wallet<\/figcaption><\/figure>\n<\/p>\n You can verify your deployed contract manually on Etherscan; however, we had difficulties doing so as our contract had imported files. Running the following Truffle<\/a> command on the command line was successful and effortless:<\/p>\n
truffle run verify
–network <\/span><\/p>\n Verifying your contract makes the code public on Etherscan, allows for transparency with users, and gives them the ability to query and write to available public functions<\/a>. Although there are various functions to have publicly accessible in your smart contract, the only one we included in our test contract was for non-owners to be able to transfer their NFT.
\n\u00a0 \u00a0\u00a0
\nWhile testing, the first way we found to transfer a token from one owner to another was by connecting to Web3<\/a>, via MetaMask or WalletConnect<\/a> (both Web3 wallets), on Etherscan and using the safeTransferFrom<\/span> function with the wallet account number of the NFT owner, the account to transfer to, and the NFT\u2019s ID. We successfully transferred an MTK token<\/a> (after a 0.00010114 rETH gas fee) using this method.\u00a0<\/p>\nAn alternative method, which is potentially more user friendly, is MetaMask\u2019s own \u201cSend<\/a>\u201d feature. Noting that this functionally is currently available only on the mobile app and not the extension.\u00a0<\/p>\n
We noted with concern that functions that should only be usable for the contract owner were publicly available functions \u2013 specifically the ownership and the minting functions. While all functions can and should be publically viewable for transparency, only the NFT owner should have access to privileged functions. So I attempted to use the previously mentioned mintMany<\/a> function with an account that was not the owner of the contract, and appropriately, the transaction was not successful. To its credit, MetaMask advised against attempting the transaction, warning, \u201cThis transaction is expected to fail. Trying to execute it is expected to be expensive but fail, and is not recommended.\u201d After we continued anyway, the transaction did indeed report \u00a0\u201cFail with error ‘Ownable: caller is not the owner<\/a>‘\u201d.<\/p>\n
Conclusion\u00a0<\/h2>\n
While we have made significant progress in developing our understanding of NFTs, smart contracts, and testnets, this work has been only the beginning of our understanding of the development and implementation of NFTs. NFTs and other smart contracts can be very intricate, flaws can be subtle and dangerous, and there are always more features to add. However, changing a contract once it is deployed is quite difficult.<\/p>\n
This was a fun project for us as interns. \u00a0It gave us the opportunity to demystify a lot of the jargon and confusion around NFTs, and to learn how to create them. Given the enormous interest in cryptocurrencies and smart contracts, the knowledge we obtained can be very useful in our development as young IT professionals. \u00a0We definitely learned a lot from our internships at LPI, and hopefully will get another project to work on in this area someday
\n\u00a0<\/p>\n","protected":false},"excerpt":{"rendered":" - Dimensions Network Faucet<\/a>: Can request 5 rETH every 24 hours<\/li>\n
- Solidity<\/a>: Used by me to create our smart contracts, this is the programming language for both the sample work and OpenZeppelin\u2019s Contracts Wizard<\/a>. It is also commonly known for its usage in writing and implementing smart contracts in general.<\/li>\n
- head<\/a><\/span>: This command selects the first image from the previously mentioned, randomly ordered \u00a0list.<\/li>\n