🃏🎮A NFT(ERC721) card game build on Ethereum, Truffle, Ganache and hosting on IPFS.

Open issuesOpen issues7
Last updateLast update2022-01-07

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.


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.


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).



You can find contract detail under contracts/ directory:

Technical stack


  • React
  • Redux
  • Saga
  • Web3(MetaMask)


  • Sass
  • Material-UI

Smart contract/Solidity

  • Truffle

Test environment/Private chain

  • ganache


  • 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


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

Contract Token address Transaction hash
CryptoHerosGame 0xb4FF27d8cD1C5b1e3D4BD8A8FFEBdA9BE9517a4b 0x49bb8698e2951a0c7eb091038b500694cdf37c74ec51d6c98d91823dc9595b95
CryptoHerosToken 0xa82Bc392bF65d03A796E1666d27594fB31De4B93 0xf41868e6b59020965831aac218e1a521b283ab4975f10a44cf0908f6ce586ad7

Card List

See CARD.md for more information.


See CONTRIBUTING.md for how to help out.


See LICENSE for details.