1Hive's Token Request app allows users to create a vote which requests an Organization's tokens in exchange for payment. For example a user may request minting 100 organization tokens in exchange for 100 DAI. The request would require a vote to approve, if the vote is rejected the user would receive their payment back and if it is approved the payment would be deposited in the organization's vault.
🚨 Security review status: Contracts audited
How does it work
The Token Request App should be granted the
Create Votes permission on an instance of the Aragon
Voting app. When a user makes a request they should transfer the payment to the Token Request app which will hold them in escrow while the vote is created and executed. If the vote duration passes and the payment is still in the Token Request app, the user should be able to claim their tokens. If the vote passes then executing the vote should transfer the users tokens from the Token Request app to the organizations vault, and mint tokens from the token manager for the user.
The token request app is initialized by passing the address of a
token manager instance, the address of a
_vault instance, and an array of addresses
_acceptedDepositTokens array must be less than the
MAX_ACCEPTED_DEPOSIT_TOKENS variable which is set to 100.
The Token Request application should implement the following roles:
- Finalise token requests
- Change Vault Address
- Change Token Manager Address
- Add/remove offered tokens to/from the accepted offered token list
We do not need to provide an interface for changing parameters as this can be done by power users using the aragonCLI.
The interface allows users to request tokens, where they would specify the amount and the associated payment. It also allows for withdrawing their requests at any time.
For a detailed view of the flow of the app check out our user-guide
How to run Token Request app locally
First make sure that you have node, npm, and the aragonCLI installed and working. Instructions on how to set that up can be found here. You'll also need to have Metamask or some kind of web wallet enabled to sign transactions in the browser.
Git clone this repo.
git clone https://github.com/1Hive/token-request-app.git
Navigate into the
Install npm dependencies.
Deploy a dao with Lock app installed on your local environment.
npm run start:template
How to deploy to an organization
Token Request app has been published to APM on Mainnet and Rinkeby at
To deploy to an Aragon DAO you can use the Aragon CLI.
aragon dao install <dao-address> token-request.aragonpm.eth --app-init-args <vault-address> <token-manager-address>
We welcome community contributions!
Please check out our open Issues to get started.
If you discover something that could potentially impact security, please notify us immediately. The quickest way to reach us is via the #dev channel in our team Keybase chat. Just say hi and that you discovered a potential security vulnerability and we'll DM you to discuss details.