PR1S0N ART NFT Contract

Uses IPFS to store contract and image metadata.

Contract Features: Mintable with Auto Increment Ids, Burnable, Enumerable, URI Storage

Access Control: Ownable

Quick start

Install Yarn

npm install -g yarn

git clone https://github.com/PrisonArt/erc721-opensea-hardhat
cd erc721-opensea-hardhat
yarn install
# list hardhat tasks:
npx hardhat

Install hardhat-shorthand

npm i -g hardhat-shorthand
hardhat-completion install
# hh == npx hardhat

Create Infura and Etherscan Accounts

Create free accounts on:

• https://infura.io
• https://etherscan.io

Create .env (listed in .gitignore). Important, never check in .env to public repo!

cp .env.sample .env

enter the following values into .env:

• INFURA_API_KEY=
• ETHERSCAN_API_KEY=

Deploy and test locally

Clean, compile and test:

hh clean
TS_NODE_TRANSPILE_ONLY=1 hh compile
hh compile
hh test
hh coverage

Local deployment

hh node

In a new terminal, go to the repository's root folder and run this to deploy your contract:

hh deploy --network localhost

update LOCALHOST_CONTRACT_ADDRESS .env with address of newly deployed contract.

hh mint-token --network localhost --metadata-uri ar://8_NZWr4K9d6N8k4TDbMzLAkW6cNQnSQMLeoShc8komM

hh burn-token --network localhost --token-id 0

Set up Metadata for Contract

TODO: change to IPFS

Verify image and fee_recipient values in prisart-contract.json. Deploy prisart-contract.json:

npx arweave deploy assets/prisart-contract.json

Update "contractURI" in contracts/PRISART.sol with URL result from above.

Set up Metadata and Images for First Minted Work

TODO: change to Arkb

Upload image as a 480x480 animated gif:

ffmpeg -i prisart-0.mp4 -vf scale=480:-1 prisart-0.gif
npx arweave deploy assets/prisart-0.gif

After Arweave deployment, update "image" with the resulting Arweave URL (ar://HASH) in prisart-0.json.

Upload animation_url as a 1024x1024 mp4 with vcodec H.264, pixel format YUV 4:2:0, and CRF 25. Arweave image or video should be less than 10MB:

npx arweave deploy assets/prisart-0.mp4

After Arweave deployment, update "animation_url" with the resulting Arweave URL (ar://HASH) in prisart-0.json. Deploy prisart-0.json:

npx arweave deploy assets/prisart-0.json

Note new Arweave path (ar://HASH) to token metadata file for minting

Deploy to Rinkeby

Get ether on Rinkeby: https://faucet.rinkeby.io/

Supply the private key of the contract owner in .env:

• RINKEBY_PRIVATE_KEY=

Deploy contract to Rinkeby:

hh deploy --network rinkeby

Note the deployed contract's address and update value in .env:

• RINKEBY_CONTRACT_ADDRESS=

Verify on Rinkeby

Run the following command, by providing the new contract address:

hh verify --network rinkeby --contract contracts/PRISART.sol:PRISART <contract-address>

Check code and abi on Rinkeby

Visit the following URL, by providing the new contract address: https://rinkeby.etherscan.io/address/_contract-address_

Mint to Rinkeby

hh mint-token --network rinkeby --metadata-uri ar://8_NZWr4K9d6N8k4TDbMzLAkW6cNQnSQMLeoShc8komM

Check contract on TestNet OpenSea

Go to https://testnets.opensea.io/ connect wallet using the Rinkeby network. Choose "My Collections" and "Import an existing smart contract". Enter the Rinkeby Contract Address.

Burn Token on Rinkeby

hh burn-token --network rinkeby --token-id 22

Token will be transferred to the zero address and marked as nonexistent token

Deploy to mainnet

hh deploy --network mainnet

note the depoloyed contract's address and update value in .env:

• MAINNET_CONTRACT_ADDRESS=

Verify on mainnet

Run the following command, by providing the new contract address:

hh verify --network mainnet --contract contracts/PRISART.sol:PRISART <contract-address>

Check code and abi on mainnet

Visit the following URL, by providing the new contract address: https://etherscan.io/address/_contract-address_#code

Mint to mainnet

hh mint-token --network mainnet --metadata-uri ar://8_NZWr4K9d6N8k4TDbMzLAkW6cNQnSQMLeoShc8komM

Burn Token on mainnet

hh burn-token --network mainnet --token-id 22

Token will be transferred to the zero address and marked as nonexistent token

Check contract on OpenSea

Go to https://opensea.io/ and connect wallet using the mainnet network. Choose "My Collections" and "Import an existing smart contract". Enter the mainnet Contract Address.

Recommended Visual Studio Code Extensions

• https://github.com/juanfranblanco/vscode-solidity by Juan Blanco
• ESLint by Dirk Baeumer

References

https://github.com/Dynamiculture/erc721-opensea-hardhat-template