zillion-whales-smart-contracts

PROXY:

RELEASED UNIT NFT (PROXY based ERC721):

• OUTDATED Saigon tx: 0x8c68a4173f1c05d61790424e8e0d23289359b3d7f4e180451fc61e78c2eb918f, deployed at 0xD560ad4De2e06Bbdc22929Ba81CCe7436B3659a6
• Saigon deployed at 0x75696c1b60630d77DfC28f39Ad0Ec3834677ee93
• Ronin tx: 0x760be494f59a01cc852dcba590d9c9c4043537579b574122af1ca59c0ef81f6c, deployed at 0xa038C593115f6FCd673f6833E15462B475994879

---

Self Claim

• Saigon deployed at 0x9a83490FB12281aD1338a19f70172569d5d5F5F2
• Ronin deployed at 0xc2f81D4f3AAC3FD49768E418E290e850D1d3aC8b

---

RELEASED SKIN NFT (PROXY based ERC721):

• Saigon tx: 0x07922116bb5f70d5fe29204c4eea53539cc909f5ba05aa84e61ff9895b1935ce, deployed at 0x8d31c370b677fe84503d9299F08F6801EB05894B
• Ronin tx: 0xe879c7dd66dcdbc749a7e5fc4ef56bc94f20cde97f08f48e054b739272ca0732, deployed at 0xa899849929E113315200609Be208e6a0858F645C

---

Self Claim

• Saigon deployed at 0x74046d7168D5b95AC8BbF32a58D34bD0aFeFA918
• Ronin deployed at 0xc42cA096E60d997B6f6E2B937253F5b69A6FA6aa

---

RELEASED LORD NFT (PROXY based ERC721):

• Saigon tx: 0xebab85aed76c4bbd6e711e21399049efc0dd3fdaf97043de067b88bcdbd5baec, deployed at 0x178C38A06773ca0370Cc818a98810D7BC717d057
• Ronin tx: 0xc0d98dd4cf15e539d74882b5636037608f2aeeafc3de2afa7b0e7154a70853f8, deployed at 0xA1cE53B661be73bf9a5EdD3F0087484f0E3E7363

RELEASED LORD STAKE (PROXY custom):

• Saigon deployed at 0xaec833B058E12286bda73A26D2d25FB28D3A819E
• Ronin tx: 0xf950c41eeade8e6cfd5e39b23add2e0b819831e16c6e6590c6e77813f416bad2, deployed at 0xfB597d6Fa6C08f5434e6eCf69114497343aE13Dd

RELEASE PACK NFT (PROXY based ERC1155):

• Saigon tx: 0xecde996089a0a29a720f8e83fd2186d5d7a6be4cb2099b7f93a5727996cbc159, deployed at 0xC8D431503c18D5b3A414eDEbbb5551f1AE7Bb251
• Ronin tx: 0x9161b7e0fe094fc4a99bea7bf97d067558e09929e1fe454706ffee24ae8cc32e, deployed at 0x0328b534d094B097020B4538230F998027a54dB0

Beta Unit NFT (ERC721):

• Saigon tx: 0x289de444ee28c9171013eaad49e2923f7f07053cb86c717c6534d030f2c69f06, deployed at 0xD560ad4De2e06Bbdc22929Ba81CCe7436B3659a6
• Ronin tx: 0xef7c573b5619d37dc788338de14d689d90d3e01f5279bdc0166ea28a53c53791, deployed at 0xF6C5f9a72e6D46F30c7223a4CfF854F94C7E95AA
• OUTDATED Ronin (Live) tx: 0xd8505e79202110e2ecdd4240fbc72cfd8caf415ca4c04a2ea4394a37082c8d8a, deployed at 0x4B7B799C5B21623c810E6d2EF3Ad89643D02fF86

---

Self Claim

• Saigon deployed at 0xe65f9B074aCaC85923BB19Fb70Ad10f5Ef3FE2E2
• Ronin deployed at 0x078e97a332dcD862F5355ffeAdbC1fbf2De40d65

---

Beta $WF Tokens (ERC20):

• Saigon tx: 0x9e9e5c8855bf1dc6937cc99b5b2efba48beeb54005fc668f4a380555260e1faa, deployed at 0x61b832F8Fe4fF691f605b3c6862C76B6793B962d
• Ronin tx: 0xa0b10a79817682ace71a3a61aab06c5237c8b3514891d86d528727bc2897657e, deployed at 0x363C3b97152e161Cea85e0E5Dc52dfDCa01A2dB1

---

Self Claim

• Saigon deployed at 0x382be0e87D13fb1fd6026d16C2822A5Ed94205e8
• Ronin deployed at 0x8B3156fb4504CbCF41c8E63Aa9eF596383C6480e

---

SIGNAL FIRE (PROXY custom):

• Saigon tx: 0xe78f3e51d922e8743405fb9666efd257391ed9bf21ede9c1535325ac6f39f22a, deployed at 0x3B43F19D8F4f7513fd57db1cA6679Ad94F27b118
• Ronin tx: 0x59eb7c1e607466b87246f63f9098672cd700b3391a3e50e43f52a21852bb868a , deployed at 0x1136DAC182AB639632a38540c6F33c01e02E51a6

OUTDATED SMART-CONTRACTS (before we switched to Proxy):

NFTs (Skins):

• Saigon tx: 0x94503c4f35c8db8f456b438e4d61dcc07f104331a89d33d2cd6bdb609c921a8d, deployed at 0x7B3e4c79E7e20f4a58B66dDBE74dBFd04c7E463C
• Ronin (Live) tx: 0x48edc2d983d2de1714fdc3dfa2eb1de61eb38f6a0ed9d404dd8434b254bf97a8, deployed at 0xf13Dfd9c4Ad78A94fC8e0F46b10f947f593EFC61

NFTs (Packs):

• Saigon tx: 0x06f621c16330a43482e6d0930a9e424b0f29f53b53bec3e99f18ef99cc81dde1, deployed at 0xe67E2B9da4cCd8229Ed0e2030bBE84877522dba3
• Ronin (Live) tx: 0x690a03977877a9efed341f7ad163d9a83e94011d99f562afe0435ce23f462591, deployed at 0x56bf1139e562be570ccf378fe8d37025a1d1b2a8

NFTs (Packs ERC1155):

• Saigon tx: 0x374a0d571dffecb6fc0af118caeac9f169097e67288f55016b47d12598a28b02, deployed at 0x6C235Ec577398Ac1a043C4971B11aEe3CB44d7C0
• Ronin (Live)

NFT With defined tokenURI (Lords):

• Saigon tx: 0x2828d463088941e15c2500e15524861f14510b1efa69f21467df5ec2deb7201d, deployed at 0xb39BFea8894aB4AcDE03f8ECEb47a6962a1e98ce
• Ronin (Live) tx: 0x774cf4229f3840bf18fd3e2ddc6fa559b211c1f33fb802503c0f519fe9587c74, deployed at 0xdd645C1093bE18C9667E1e79957a89B62cc3cba6

NFT With Time lock:

• Saigon tx: 0x8b3a89cf4c13706429e1a6fe3df0305379b023ff648bd6e8259a2d4257ec2e00, deployed at 0x14E5Bd1FdE726e94471C898ba2f8aEAB31310dD7
• Ronin ronin:aaaaaa

Medals (ERC1155):

• Saigon tx: 0x71c9e6936164b97025668553c45fbca52e758dcb9684c0f22fdf29085ccc1356, deployed at 0x5fb726A9ecD215d8F230E6dB0464730499A964Da
• Ronin (live) tx: 0x9c107095641f6b9ab91f77582bec69a01cdc5d0a12a0cf7274ed336a2047354e, deployed at 0x9D758A29834C77C84B92a645F6BBc2139854BA92

Sales Factory:

• Saigon tx: 0xa7c132cabba3b9c5fb5f744d9d26a4c4e206ae3eb80a9819bc10e88b96679db0, deployed at 0x0894da68349daDB094D537A94715Bc60cCbfC346
• Ronin ronin:aaaaaa

EXAMPLE OF SALE:

• Saigon tx: 0xce9eb55d9a7b17d5d9ac567f44bd43a7ad218dff6e1529dc373a96f84e475220, deployed at 0x04E2e4508d5A05EFe8A87e7f2510886b8Da5F268
• Ronin ronin:aaaaaa

Install

npm i

Api keys (Not Required for Ronin network)

You will need some api keys in your env to be able to deploy/verify the contract on different chain

• Alchemy
• Etherscan
• Polygonscan
• ETH
• Ronin/SKY_MAVIS

Faucets (testnets)

You will need have a wallet with some balance to be able to deploy to different networks

• Goerli
• Mumbai
• Saigon

Slither (the smart contract static analyzer)

Source Github

Install:

pip3 install slither-analyzer

Run with MD format report:

slither . --checklist

Usage

TODO: provide example url

Example of an minted NFT on Saigon: https://

TODO: provide example url To interract with the contract in javascript you will need the ABI file (scroll to the bottom, and copy the ABI).

Deploy

Deploy the contract on the desired chain

npm run deploy # deploying on localhost (hardhat VM)

npm run hardhat -- --network mumbai deploy
npm run hardhat -- --network <network> deploy # deploying to one of the configured network

Networks configuration

In the hardhat.config.js

{
  networks: {
    goerli: {
      url: "<rpc url>",
      accounts: [privateKey]
    }
  }
}

Compile Manually

You can compile the contract by running

npm run compile

Test & Coverage

Test are provided by chai whith matchers included in Hardhat, the coverage is also included.

npm test

You can also run the test with a summary of Gas used

npm run gasreport

Prettier & Lint

npm run Format # format the code
npm run lint # check with solhint

Verification

Verify the contract on etherscan

npm run hardhat -- verify --network mumbai <DEPLOYED_CONTRACT_ADDRESS>

Verify the contract on Saigon network

npm run hardhat --network saigon sourcify --endpoint https://sourcify.roninchain.com/server