$QMATIC is an ERC-20 token that will be used as the main currency in all of the QPoker services.
- Deployed at: 0xa9A2a92970C2430B88df6cABB01Dc40bE6aB710E
- Deployment transaction hash: 0xb47...0443
- Deployer wallet address: 0x76de186cc58f75Bb425E6072C8E3AaFC3948080D
QPoker is a decentralized iGaming venture that leverages the power of blockchain technology and decentralized finance to form the first truly cosmopolitan iGaming experience without geographical restrictions. The QPoker platform uses the ERC-20 token called $QMATIC that is built on the Polygon blockchain. With QMatic the players can compete against one another on skill-based games like QPoker and QBetting, trade and speculate on the exchanges, and purchase NFTs from our incoming marketplace. The QMatic is based on Solidity, a programming language that is commonly used for writing smart contracts on the Polygon blockchain. QMatic's smart contract code is open-source and available in the official QMatic repository. The QPoker project also uses Python with the Brownie framework, a development environment for building, testing, and deploying smart contracts on the Polygon Mainnet. In addition, we use two important tools for analyzing and improving the security for our smart contracts:
-
Slither: A static analysis tool that helps to detect security vulnerabilities and potential bugs in the Solidity code.
-
Solhint: A linter for Solidity code that checks for common mistakes and enforces the best practices.
The players can connect to QPoker platform by using any of their Web3 wallet (e.g. MetaMask) and start playing right away. The QPoker players can also earn rewards by referring new users in the game platform or just by staying active in the social media. All of the users activities will get tracked on real time by our high-tech managament tools (e.g. QPoker Airdrop). All the QPoker services are designed to be upstanding and transparent with minimal gas fees. Naturally, all the transactions will be recorded on the blockchain.
We strongly believe that decentralized GameFi will lead the future for iGaming, and QPoker will play significant role in this transformation. Decentralized finance will provide a new paradigm for global iGaming that is more engaging, righteous, and cost-efficient for players all over the world.
├── QMatic # QMatic project.
│ ├── adapters # contains the adapters.
│ ├── contracts # contains contract `.sol` files.
│ ├── schemas # contains QMatic schemas such as structs, events,etc.
│ ├── scripts # contains the deploy scripts.
│ ├── tests # contains all the utilities and test functions.
As opened up on the whitepaper QMatic has a twofold locking mechanism for all of the token distribution phases before the public exchange listing: Airdrop, Private Sale & Pre-sale. These two functions are familiarized under names: Cliff & Vesting Schedule.
- Cliff means that after transferring the token into the wallet, the user cannot transfer predefined part of the locked tokens till the end of the cliff period. Every cliff has a specified starting and ending time.
- Vesting schedule means that after the cliff period, the blocked tokens will be released through a period of time and the releasing will take place linearly.
Hereby, the locking mechanism consists of three different combinations of locking:
- Only Cliff
- Only Vesting Schedule
- Cliff + Vesting Schedule.
In the 2nd option, “Only Vesting Schedule”, the mechanism will be put into effect immediately after transferring the predetermined tokens.
Note: The abovementioned locking mechanisms can be accompanied with TGE release which means that a predefined share (%) of the tokens will release immediately after the transfer and the locking mechanisms will have no impact on that TGE proportion.
classDiagram
class ERC20 {
- _name: string
- _symbol: string
- _decimals: uint8
- _totalSupply: uint256
- _balances: mapping [address => uint256]
- _allowances: mapping [address => mapping [address => uint256]]
+ name(): string
+ symbol(): string
+ decimals(): uint8
+ totalSupply(): uint256
+ balanceOf(account: address): uint256
+ transfer(to: address, value: uint256): bool
+ allowance(owner: address, spender: address): uint256
+ approve(spender: address, value: uint256): bool
+ transferFrom(sender: address, recipient: address, amount: uint256): bool
+ increaseAllowance(spender: address, addedValue: uint256): bool
+ decreaseAllowance(spender: address, subtractedValue: uint256): bool
+ _mint(account: address, amount: uint256): void
+ _burn(account: address, amount: uint256): void
+ _approve(owner: address, spender: address, amount: uint256): void
+ _beforeTokenTransfer(from: address, to: address, amount: uint256): void
}
class Ownable {
- _owner: address
+ owner(): address
+ isOwner(): bool
+ renounceOwnership(): void
+ transferOwnership(newOwner: address): void
+ _transferOwnership(newOwner: address): void
+ _beforeTokenTransfer(from: address, to: address, amount: uint256): void
}
class ERC20Burnable {
+ burn(amount: uint256): void
+ burnFrom(account: address, amount: uint256): void
}
class Pausable {
- _paused: bool
+ paused(): bool
+ pause(): void
+ unpause(): void
- _pause(): void
- _unpause(): void
}
class QMatic{
+ MAX_SUPPLY:uint256
+ IS_DEVELOPMENT:bool
+ is_migrated:bool
+ CONTRACT_SHIFT_DAYS:uint256
+ lastMechanismId:uint256
+ isMechanismActivated:bool
+ walletsAffectedByLockingMechanism:mapping [address => WalletBalanceLockingMechanism
+ activeBalanceLockingMechanism:GeneralActiveBalanceLockingMechanismStructure
- _initWalletBalanceLockingMechanismFor(receiverAddress:address,amount:uint256):(WalletBalanceLockingMechanism)
- ^_beforeTokenTransfer(from:address, to:address, amount:uint256):void
+ ^name(): string
+ initActiveBalanceLockingMechanism(cliffDurationInDays:uint256,linearReleasePeriodInDays:uint256, linearReleaseDividend:uint256, linearReleaseDivisor:uint256, releasingTGEDividendOn100:uint256):void
+ deactivateBalanceLockingMechanism():void
+ contractLockingForUpgrade(newQMaticAddress:address,reportURL:string):void
+ mint(to:address, amount:uint256):void
+ getLinearReleaseDividendAndDivisorOf(account:address):(dividend:uint256, divisor:uint256)
+ getLinearReleasePeriodAndAmountOf(account:address):(periodInDays:uint256 , releaseAmountPerPeriod:uint256 )
+ getRemainingSecondsToFinishingTheCliffOf(account:address):(remainingSeconds:uint256)
+ getRemainingBlockedTokensAtNowOf(account:address):(remainingTokens:uint256)
+ changeDateOfContract(shiftDays:uint256):void
+ turnDevelopmentModeOff():void
+ transferWithLocking(to:address, amount:uint256):(bool)
}
class WalletBalanceLockingMechanism{
+ startedDate:uint256
+ totalAffectedTokens:uint256
+ linearReleaseTokensPerPeriod:uint256
+ mechanism:GeneralActiveBalanceLockingMechanismStructure
}
class GeneralActiveBalanceLockingMechanismStructure{
+ cliffDurationInDays:uint256
+ linearReleasePeriodInDays:uint256
+ linearReleaseDividend:uint256
+ linearReleaseDivisor:uint256
+ releasingTGEDividendOn100:uint256
}
class UpgradingQMatic_event{
+ newQMaticAddress:address
+ upgradeDate: uint256
+ eventReportUrl: string
}
class BalanceLockingMechanismUpdateLog_event{
+ indexed mechanismId:uint256
+ cliffDurationInDays:uint256
+ linearReleasePeriodInDays:uint256
+ linearReleaseDividend:uint256
+ linearReleaseDivisor:uint256
+ releasingTGEDividendOn100:uint256
+ indexed isActive:bool
}
class InvestmentWithLockingMechanismScenario_event{
+ indexed mechanismId:uint256
+ indexed account:address
+ startedDate:uint256
+ linearReleaseTokensPerPeriod:uint256
+ amountOfInvestInQMatic:uint256
+ totalAffectedTokens:uint256
}
GeneralActiveBalanceLockingMechanismStructure <.. WalletBalanceLockingMechanism
GeneralActiveBalanceLockingMechanismStructure <.. QMatic
WalletBalanceLockingMechanism <.. QMatic
UpgradingQMatic_event<.. QMatic
BalanceLockingMechanismUpdateLog_event <.. QMatic
InvestmentWithLockingMechanismScenario_event <.. QMatic
ERC20<|--ERC20Burnable
ERC20<|--QMatic
ERC20Burnable<|--QMatic
Ownable<|--QMatic
Pausable<|--QMatic
Made with Mermaid.
To get started with the $QMatic token, you will need to have:
- python 3.9.12
- poetry
- yarn
You can find the code for $QMatic in this repository. We recommend using the Brownie framework to test the smart contract code.
$ poetry install
$ poetry shell$ brownie testthis command will compile all the solidity codes for the first time but if you want to compile solidity code you could enter brownie compile.
$ brownie test -Cfor checking the project by slither and solhint needs to install dependencies first by:
$ yarn install$ yarn run slither# To check lint errors
$ yarn run lint
# To fix most common lint errors
# Note that it might not fix all errors, some need manual intervention
$ yarn run lint:fixShould you have any technical questions or want to share feedback about our project, feel free to email: m.r.mousavi.n@gmail.com. We would love to hear from you!
QPoker Contracts are released under the MIT License.