This repository is a quick starter for Dark Forest plugin developers who want to deploy contracts that interact with the core Dark Forest contracts. This repository allows you to quickly get up and running with the ability to:

• Compile a Solidity contract with references to the core Dark Forest contracts
• Synchronise the source code of the Dark Forest core contracts from the official contract repository
• Deploy your Solidity contract to the XDai net, and initialise the contract with the address of the core contract

Do once:

• yarn install
• cp .env.example .env and change the env file to include the mnemonic of your XDai account from which you want to deploy your contract
• yarn sync-core-contracts will download the latest version of the core contracts to the local directory and move them to the right place

To check that your contract compiles correctly:

• yarn compile

To deploy your contract to the XDai chain (make sure to have ran the Do once steps)

• yarn deploy
• Copy the contract address somewhere

To use your contract in the Dark Forest client with a plugin

• Upload the ./ContractABI.json file generated when deploying the contract to GithubGist/CDN/S3/Whatever
• Use df.loadContract(ContractAddres, ABIUrl) in your plugin to get an interface to your contract

An example achievement contract can be found in ./contracts/Contract.sol. It is an ERC721 implementation of a simple achievement system. This contrat calls the Dark Forest core contract to verify the claim of the users requesting an achievement. An example plugin interacting with this contract can be found in ./example/plugin.js