Summary
Passing this proposal gives the Coinhall team the ability to upload CosmWasm contracts to Osmosis mainnet relating to Genie, a campaign reward platform, without seeking further governance approval. Genie brings superior incentive and distribution mechanisms to Osmosis and is a proud recipient of the Osmosis Grant Program (Batch 15).
About Genie
The Genie platform first launched on Terra (phoenix-1) at 27 January 2023, and has since successfully ran 28+ campaigns over the past 8 months. The Coinhall team is now bringing this gamification of incentives and identity to Osmosis.
Genie allows anyone on Osmosis to create and run on-chain campaigns and reward users with any token on Osmosis. Engagement of communities and driving on-chain actions are made easy with this integration.
Creators are free to decide the parameters of their choice: which wallets to target, what on-chain mission to set, and what rewards to provide. Only eligible wallets that have completed the missions can claim their due rewards. This opens possibilities of use cases such as bonus rewards for long-term liquidity providers, retroactive airdrops, re-targeting inactive users, loyalty program, cross-platform partnerships, giveaways, and many more.
Other more powerful features are being worked on and will be released in due time.
Technical Details
Genie is made up of two contracts:
genie-airdrop
: the contract to be instantiated per campaign, and which end users claim rewards fromgenie-airdrop-factory
: the factory contract which creators will use to instantiate thegenie-airdrop
contract
There is a one-to-one relationship between campaigns and genie-airdrop
contracts. Every new campaign should instantiate a new genie-airdrop
contract by executing the CreateAirdrop
message to the genie-airdrop-factory
contract. Creators who instantiate the reward contracts are the only parties allowed to withdraw from or deposit into the contracts (with certain limitations to protect the end user). For more information regarding the exact technical details, refer to the source code’s various READMEs at https://github.com/coinhall/genie-contracts.
While this proposal gives authority for osmo1yp8qwkfs964pkg3rge3k6ree2e6lrttgzs4r45
to permissionlessly upload any CosmWasm contracts to Osmosis, the passing of this proposal only signals approval for contracts relating to the function of the Genie platform to be uploaded.
Audit
The contracts have undergone Oak Security’s audit and the full report can be found here: https://github.com/oak-security/audit-reports/blob/master/Coinhall/2023-09-26 Audit Report - Coinhall Genie v1.0.pdf.
For full disclosure, a few commits for various bug fixes and feature improvements have been made after the audit. Most notably, a new “Lootbox” feature, which gives every claim a probabilistic chance of earning different amount of rewards, has been added. Users are free to view our open-sourced contract located at https://github.com/coinhall/genie-contracts.
Links
- Forum: [Edited] Allow Genie contracts to be uploaded - #2 by JohnnyWyles
- Website (create campaigns): https://genie.coinhall.org
- Website (claim rewards): Genie: Web3 Reward Campaigns
- User docs: https://www.notion.so/coinhall/Genie-Docs-470702baf64e4a29b90452a7b12191cc
- Contract source code: https://github.com/coinhall/genie-contracts
Contacts
- Twitter: https://twitter.com/coinhall_org
- Telegram: Telegram: Contact @coinhall_org