Nifties Exchange is a dApp for incentivize the tourism on distant and not well-known attractions within big Cities, while at the same time being a useful tool for crypto onboard the masses. Its logic is basically a NFT exchange game with on-chain logic that simulates the market price of each tourism stamp artificially based on user demand and some sort of entropy found in past block hashes within the blockchain.
Come and join the adventure to know new unknown places within big Cities around the globe. You will be able to claim digital stamps when visiting this places and benefit both from unique rewards on discounted attractions and by selling it later on an exchange-based game so you can earn some tokens and other people can also benefit from its availability.
-
As a director of the local tourism department, you may want to incentivize people to meet some places that aren't well-known but offer attractive activities for the local/foreign visitors. So you can deploy a StampCollectible smart contract, put some funds in the
Prize pot, and mint some stamps with a limited supply. Tourists can claim one of them via a QR code located in-place, and later use it to buy discounted goods/services on awesome attractions. A Limited supply of stamps allows you to program short-to-medium scale campaigns and incentivize people to sell them later through the built-in exchange game for a small reward based on market price which is taken from thePrize pot. In that way, other people can also benefit from these stamps in the future. -
As a tourist, you may want to have a more fun experience during travelling that allows you to know awesome places. Through Nifties exchange, you can find a digital guide that recommends you to visit interesting places and get rewarded for it. You just need to collect or buy digital stamps through the dApp, playing with them using and exchange-based game, use them to get discounts on local attractions and get some profit at the end by selling them at the current market value.
-
As a blockchain community member, you may want to find more suitable ways to onboard crypto and decentralized applications to the masses. according to the latest UNWTO World Tourism Barometer, more than 1.4 billion of international tourist arrivals around the world have happened in 2018. Why not try to onboard that many people to blockchain? Nifties exchange allows you to do it within your locality.
- Node v10.5.0+ (How-to install)
- truffle v5.x.x
- MythX
- Solc 0.5.0+
- Local testnet (e.g. Ganache, ganache-cli, truffle develop, Geth, Parity, etc.) with a RPC running at http://localhost:8545
- Any Web3 enabled browser (e.g. with Metamask plugin installed) browser
- OpenZeppelin SDK (optional to test smart contract upgradability)
- Most of the installation requirements can be installed by executing the following command:
$ npm install -g truffle truffle-security ganache-cli- Additionally, you can also install OpenZeppelin SDK if you want to deploy upgradable contracts:
npm install -g @openzeppelin/cliIn order to setup the project to be run/deploy, you need to clone/download this repo and run the following commands within the project folder:
$ npm install
$ cd client && npm installIf developing/running the dApp in your local computer, you need to deploy a local ganache in a separate terminal by running the following command:
$ ganache-cliThis will deploy a local in-memory Ethereum node on http:localhost:8545. Make sure you copy one or more of the generated accounts PKs, so you can import them on Metamask to interact with the web dApp later.
$ truffle migrate --reset # deploy to a local testnet
$ npm run migrate-rinkeby # deploy to Rinkeby testnetTo deploy the initial smart contracts:
sh migrate-oz.shTo upgrate the StampCollectible smart contract (NOTE: remember to not to execute the initialize method as it was already executed for this contract):
oz upgrade StampCollectible -n developmentTo run all developed smart contract test cases, you need to run the following command:
truffle testIn order to perform an automated smart contract security analysis using MythX, you need to execute the following commands:
$ export MYTHX_ETH_ADDRESS=0x1234567891235678900000000000000000000000
$ export MYTHX_PASSWORD='Put your password in here!'
$ truffle run verify [contract]After the smart contract were migrated to your preferred Ethereum blockchain, you need to run the following commands in a terminal:
$ cd client && npm startThis will deploy the dApp locally on http:localhost:3000
Currently, all smart contracts are deployed on the Ethereum Rinkeby testnet. You can find the corresponding addresses and Etherscan URLs pointing to the verified code in deployed_addresses
In case you want to test the deployment to Rinkeby, make sure you fund your test account using the Faucet server. Then, copy the mnemonic words of your Metamask account and paste them in a .secret file on the root directory of the project. Finally, you can run the following migration command:
Smart contracts and unit tests were properly documented using the natspec style guidelines for comments. A detailed explanation of each test suite is provided on each of the test source code files in the test directory.
A detailed explanation of the design patterns used in the dApp can be found here
A detailed explanation of what measures were taken to ensure that Nifties Exchange contracts are not susceptible to common attacks can be found here