nifty-game

nifty-game copied to clipboard

Non-fungible token game

This project is a crypto card game that uses OpenZepplin.

The contract is compiled and deployed under the ERC-721 non-fungible token standard with truffle framework. After deploying onto the Ethereum blockchain, users will be able to play the game by interacting with the smart contract through DAPP’s front-end interface.

Acquiring game card: Users can acquire game cards using ETH. Every game card will have a game point on it, which will be used to determine the winner later in the game.

Roles

Card Collection

Players can aquire card using ether. Each card will have a random points on it, which will be used to deternmine the winner in the card game.

Card Battle

Once entered the game, players will need to choose a card to play for the round. Each round, the smart contract will randomly decide either card with larger or smaller point wins the round. At the same time, the smart contract will also randomly generate a number in order to compete with the player. Winner of the game will receive the price.

Dashboard

You can view the card battle history about all the games you played.

ERC-721 Token

ERC-721 non-fungible token: ERC-721 is a free, open standard that describes how to build non-fungible or unique tokens on the Ethereum blockchain. While most tokens are fungible (every token is the same as every other token), ERC-721 tokens are all unique (with unique ID).

Reference

Contracts

You can find contract detail under contracts/ directory:

• CryptoHerosGame.sol: The implementation of game execution and rule.

• CryptoHerosToken.sol: The implementation of game cards purchase and generation.

Technical stack

Frontend

• React
• Redux
• Saga
• Web3(MetaMask)

UI

• Sass
• Material-UI

Smart contract/Solidity

• Truffle

Test environment/Private chain

• ganache

Requirements

• NodeJS 8.0+ recommended.
• Windows, Linux or Mac OS X.

How To Install Dependencies

First install required dependencies:

You'll need local ethereum node, I recommend ganache-cli. You can install it from npm.

npm install -g ganache-cli

Install truffle:

npm install -g truffle

Then install contract dependencies:

npm install

How To Test

First make sure that local ethereum node is running. Execute:

ganache-cli --gasLimit 0xffffffffff -p 8545

Now you can compile and deploy contracts:

truffle compile && truffle migrate

Run contract tests:

truffle test

Playground

We already deployed contracts to Ropsten network. You can play with them RIGHT NOW.

Card List

See CARD.md for more information.

Contributing

See CONTRIBUTING.md for how to help out.

Licence

See LICENSE for details.