Skip to content

Latest commit

 

History

History

mojos-contracts

@mojos/contracts

Background

Mojos are an experimental attempt to improve the formation of on-chain avatar communities. While projects such as Cryptopunks have attempted to bootstrap digital community and identity, Mojos attempt to bootstrap identity, community, governance and a treasury that can be used by the community for the creation of long-term value.

Two Mojo is generated and auctioned every day, forever. All Mojo artwork is stored and rendered on-chain. See more information at 1980.network.

Contracts

Contract Description Address
MojosToken This is the Mojos ERC721 Token contract. Unlike other Mojos contracts, it cannot be replaced or upgraded. Beyond the responsibilities of a standard ERC721 token, it is used to lock and replace periphery contracts, store checkpointing data required by our Governance contracts, and control Mojo minting/burning. This contract contains two main roles - minter and owner. The minter will be set to the Mojos Auction House in the constructor and ownership will be transferred to the Mojos DAO following deployment. 0x9C8fF314C9Bc7F6e59A9d9225Fb22946427eDC03
MojosSeeder This contract is used to determine Mojo traits during the minting process. It can be replaced to allow for future trait generation algorithm upgrades. Additionally, it can be locked by the Mojos DAO to prevent any future updates. Currently, Mojo traits are determined using pseudo-random number generation: keccak256(abi.encodePacked(blockhash(block.number - 1), mojoId)). Trait generation is not truly random. Traits can be predicted when minting a Mojo on the pending block. 0xCC8a0FB5ab3C7132c1b2A0109142Fb112c4Ce515
MojosDescriptor This contract is used to store/render Mojo artwork and build token URIs. Mojo 'parts' are compressed in the following format before being stored in their respective byte arrays: Palette Index, Bounds [Top (Y), Right (X), Bottom (Y), Left (X)] (4 Bytes), [Pixel Length (1 Byte), Color Index (1 Byte)][]. When tokenURI is called, Mojo parts are read from storage and converted into a series of SVG rects to build an SVG image on-chain. Once the entire SVG has been generated, it is base64 encoded. The token URI consists of base64 encoded data URI with the JSON contents directly inlined, including the SVG image. 0x0Cfdb3Ba1694c2bb2CFACB0339ad7b1Ae5932B63
MojosAuctionHouse This contract acts as a self-sufficient mojo generation and distribution mechanism, auctioning one mojo every 24 hours, forever. 100% of auction proceeds (ETH) are automatically deposited in the Mojos DAO treasury, where they are governed by mojo owners. Each time an auction is settled, the settlement transaction will also cause a new mojo to be minted and a new 24 hour auction to begin. While settlement is most heavily incentivized for the winning bidder, it can be triggered by anyone, allowing the system to trustlessly auction mojos as long as Ethereum is operational and there are interested bidders. 0xF15a943787014461d94da08aD4040f79Cd7c124e
MojosDAOExecutor This contract is a fork of Compound's Timelock. It acts as a timelocked treasury for the Mojos DAO. This contract is controlled by the governance contract (MojosDAOProxy). 0x0BC3807Ec262cB779b38D65b38158acC3bfedE10
MojosDAOProxy This contract is a fork of Compound's GovernorBravoDelegator. It can be used to create, vote on, and execute governance proposals. 0x6f3E6272A167e8AcCb32072d08E0957F9c79223d
MojosDAOLogicV1 This contract is a fork of Compound's GovernorBravoDelegate. It's the logic contract used by the MojosDAOProxy. 0xa43aFE317985726E4e194eb061Af77fbCb43F944

Development

Install dependencies

yarn

Compile typescript, contracts, and generate typechain wrappers

yarn build

Run tests

yarn test

Environment Setup

Copy .env.example to .env and fill in fields

Commands

# compiling
npx hardhat compile

# deploying
npx hardhat run --network rinkeby scripts/deploy.js

# verifying on etherscan
npx hardhat verify --network rinkeby {DEPLOYED_ADDRESS}

# replace `rinkeby` with `mainnet` to productionize

Automated Testnet Deployments

The contracts are deployed to Rinkeby on each push to master and each PR using the account 0x387d301d92AE0a87fD450975e8Aef66b72fBD718. This account's mnemonic is stored in GitHub Actions as a secret and is injected as the environment variable MNEMONIC. This mnemonic shouldn't be considered safe for mainnet use.