@sports-manager/contracts v0.0.3
@sports-manager/contracts
Background
SportsManager 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, SportsManager attempt to bootstrap identity, community, governance and a treasury that can be used by the community for the creation of long-term value.
One SportsManager is generated and auctioned every day, forever. All SportsManager artwork is stored and rendered on-chain. See more information at sportsmanager.wtf.
Contracts
Contract | Description | Address |
---|---|---|
SportsManagerToken | This is the SportsManager ERC721 Token contract. Unlike other SportsManager 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 SportsManager minting/burning. This contract contains two main roles - minter and owner . The minter will be set to the SportsManager Auction House in the constructor and ownership will be transferred to the SportsManager DAO following deployment. | 0x9C8fF314C9Bc7F6e59A9d9225Fb22946427eDC03 |
SportsManagerSeeder | This contract is used to determine SportsManager traits during the minting process. It can be replaced to allow for future trait generation algorithm upgrades. Additionally, it can be locked by the SportsManager DAO to prevent any future updates. Currently, SportsManager traits are determined using pseudo-random number generation: keccak256(abi.encodePacked(blockhash(block.number - 1), sports managerId)) . Trait generation is not truly random. Traits can be predicted when minting a SportsManager on the pending block. | 0xCC8a0FB5ab3C7132c1b2A0109142Fb112c4Ce515 |
SportsManagerDescriptor | This contract is used to store/render SportsManager artwork and build token URIs. SportsManager '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, SportsManager 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 |
SportsManagerAuctionHouse | This contract acts as a self-sufficient sports manager generation and distribution mechanism, auctioning one sports manager every 24 hours, forever. 100% of auction proceeds (ETH) are automatically deposited in the SportsManager DAO treasury, where they are governed by sports manager owners. Each time an auction is settled, the settlement transaction will also cause a new sports manager 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 sportsmanager as long as Ethereum is operational and there are interested bidders. | 0xF15a943787014461d94da08aD4040f79Cd7c124e |
SportsManagerDAOExecutor | This contract is a fork of Compound's Timelock . It acts as a timelocked treasury for the SportsManager DAO. This contract is controlled by the governance contract (SportsManagerDAOProxy ). | 0x0BC3807Ec262cB779b38D65b38158acC3bfedE10 |
SportsManagerDAOProxy | This contract is a fork of Compound's GovernorBravoDelegator . It can be used to create, vote on, and execute governance proposals. | 0x6f3E6272A167e8AcCb32072d08E0957F9c79223d |
SportsManagerDAOLogicV1 | This contract is a fork of Compound's GovernorBravoDelegate . It's the logic contract used by the SportsManagerDAOProxy . | 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
# Compile Solidity
yarn build:sol
# Command Help
yarn task:[task-name] --help
# Deploy & Configure for Local Development (Hardhat)
yarn task:run-local
# Deploy & Configure (Testnet/Mainnet)
# This task deploys and verifies the contracts, populates the descriptor, and transfers contract ownership.
# For parameter and flag information, run `yarn task:deploy-and-configure --help`.
yarn task:deploy-and-configure --network [network] --update-configs
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.