Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/portalnetwork/nifty-game
🃏🎮A NFT(ERC721) card game build on Ethereum, Truffle, Ganache and hosting on IPFS.
https://github.com/portalnetwork/nifty-game
blockchain dapp decentralized etheruem ganache ipfs react redux saga serverless smart-contracts truffle
Last synced: 2 days ago
JSON representation
🃏🎮A NFT(ERC721) card game build on Ethereum, Truffle, Ganache and hosting on IPFS.
- Host: GitHub
- URL: https://github.com/portalnetwork/nifty-game
- Owner: PortalNetwork
- License: mit
- Created: 2018-07-23T07:44:03.000Z (about 6 years ago)
- Default Branch: develop
- Last Pushed: 2021-08-22T06:29:50.000Z (about 3 years ago)
- Last Synced: 2024-09-23T00:32:30.465Z (10 days ago)
- Topics: blockchain, dapp, decentralized, etheruem, ganache, ipfs, react, redux, saga, serverless, smart-contracts, truffle
- Language: JavaScript
- Homepage: http://game.portal.network
- Size: 59.7 MB
- Stars: 281
- Watchers: 10
- Forks: 150
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
> Non-fungible token game
This project is a crypto card game that uses [OpenZepplin](https://github.com/OpenZeppelin/openzeppelin-solidity).
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](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md)
## Contracts
You can find contract detail under `contracts/` directory:
- [`CryptoHerosGame.sol`](./contracts/CryptoHerosGame.sol):
The implementation of game execution and rule.
- [`CryptoHerosToken.sol`](./contracts/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](https://ropsten.etherscan.io/) network. You can play with them RIGHT NOW.
| Contract | Token address | Transaction hash
|------------------|---------------|---------------------
| CryptoHerosGame | [0xb4FF27d8cD1C5b1e3D4BD8A8FFEBdA9BE9517a4b](https://ropsten.etherscan.io/address/0xb4ff27d8cd1c5b1e3d4bd8a8ffebda9be9517a4b) | [0x49bb8698e2951a0c7eb091038b500694cdf37c74ec51d6c98d91823dc9595b95](https://ropsten.etherscan.io/tx/0x49bb8698e2951a0c7eb091038b500694cdf37c74ec51d6c98d91823dc9595b95)
| CryptoHerosToken | [0xa82Bc392bF65d03A796E1666d27594fB31De4B93](https://ropsten.etherscan.io/address/0xa82bc392bf65d03a796e1666d27594fb31de4b93) | [0xf41868e6b59020965831aac218e1a521b283ab4975f10a44cf0908f6ce586ad7](https://ropsten.etherscan.io/tx/0xf41868e6b59020965831aac218e1a521b283ab4975f10a44cf0908f6ce586ad7)
## Card List
See [CARD.md](./dapp/CARD.md) for more information.
## Contributing
See [CONTRIBUTING.md](./CONTRIBUTING.md) for how to help out.
## Licence
See [LICENSE](./LICENSE) for details.