Interacting with Aragon Agent
Last updated
Was this helpful?
Aragon Legacy Documentation
Last updated
Was this helpful?
dao act is the main way we'll interact with Aragon Agent. It's the command we use to perform transactions with the Agent app directly from aragonCLI.
According to the documentation:
Like dao exec it takes at least three arguments:
The address of the Agent app you want to use to perform an action.
The address of an external contract or the address of an app within a DAO.
The of the method we wish to execute in either the external contract or the app we specified in the second argument -- note that by the full signature we mean the .
The remaining arguments are the parameters which the method we specified will be executed with.
Don't worry if it's not completely clear to you how dao act works at this stage. The following use cases will help you develop some intuition for it!
Let's start by seeing how we can use the Agent app to allow one Aragon organization to participate as a stakeholder in another.
The first step is to create another Democracy DAO. Exactly the same as before, head over to and choose the following defaults:
Support: 100%
Min. Approval: 0%
Duration: 168 hours (or 1 week)
We've now created two Democracy DAOs -- let's call them A and B. A has an Agent app, B doesn't. We want to allow A to vote in B.
Remember that A needs to be a tokenholder of B to be able to vote in B. And that A's Agent app acts its external interface.
In other words, A's Agent app allows it to participate as a stakeholder in B.
This means that to allow A to vote in B we need to mint a token for A's Agent app in B.
To do this run:
Remember, you can find the addresses of the apps in any of your DAOs by running:
dao apps <dao-address-or-name> --all --use-frame --env aragon:rinkeby
Warning
If execution of the command fails with the error: → No functions specified in artifact for..
Or with the error: → Cannot find transaction path for executing action
Make sure the address you sign the transaction with has both created the DAO and is owner of DAO tokens.
In our case the receiver is A's Agent App, and the amount of tokens to be created is 1.
However, you should notice that instead of writing 1 as the second argument to mint we've gone with 1000000000000000000.
In order to mint a full token from the CLI we need to pass the full number, which will then be interpreted with 18 decimals. In our case this is a 1 followed by eighteen 0s, or 1000000000000000000.
Finally, the usual warning: running the above command will trigger a vote in B to create and send a token to A's Agent App: we'll need to vote Yes to confirm the minting of the token.
You can do this either directly through the UI in the web browser or by running:
On the UI, the vote will look something like this.
Once you've voted Yes, switch over to the Token Manager app (click on Tokens in the left sidebar).
You should see that you've successfully added another token holder (your Agent app)! 🎉😊
As in step 2, we'll run dao exec again, except this time the first argument to mint will be the address of the third entity we want to add to B.
Running the above will create an open vote in B. Again we'll need to vote yes to confirm the minting.
As before, you can either do this through the UI or run the same command we ran at the end of step 2 with one small modification:
This time the first argument to vote will be a 1 and not a 0, since the id of this new vote is 1. Remember that vote ids start at zero and increment by one each time a vote is created.
If you go to the Voting app after you've voted, you'll see that the Yes vote is only 50%.
That's because only one out of two token holders have voted. The other token holder (A's Agent app) still has to vote.
In order to close and enact the vote, we'll use A's Agent app to vote yes to adding a third entity to B.
To do this we need to use the dao act command we introduced at the beginning of this section.
Remember that dao act takes at least three arguments:
The first is the address of the Agent app you want to use to perform an action. In our case, this is the address of A's Agent app.
Finally, the remaining arguments are the arguments which the method -- in our case vote -- will be executed with. We can see from the signature that vote takes three arguments: an integer, a boolean, and a boolean. In our case we will pass in: 1, true and true.
The first (1) is the id for the vote we want to interact with. This is always an integer. Remember that vote ids start at 0 and increment by 1 each time a vote is created.
The second (true) specifies which way we want to vote: true means yes and false means no.
And the third (true) specifies whether the contract should check if a vote already has enough support to be executed. If it does, the Voting app will perform the action that was being voted on, and the vote will be close. true means check if this vote can be executed, false means don't check.
So in our case, we run:
The result of this command will be to trigger a vote in A on whether to allow A's Agent app to execute the vote in B.
The final step is to confirm the vote in A.
Again, we can do this either through the UI or by running:
Note that we passed in a vote id of 2 as the first argument to vote. That's because this is the third vote created in A, and vote ids start at 0.
Once you've confirmed the vote, if you head over to B's voting app again you should see that the vote to mint one token for your chosen third entity now has 100% support.
Finally, to double check that your chosen entity has really been added as a stakeholder in B, click on B's Token Manager (named Tokens in left panel).
You should see there are now three tokenholders, each with equivalent stakes.
If you've made it this far, congratulations! 😊🎉
You've just used the Agent app to allow one Aragon organization to participate as a stakeholder in another!
On the next iteration of this guide we will explain 3 new use cases:
Interacting with Compound
Creating an Aragon Trust
Opening a Maker CDP
Stay tuned!
If you're not sure how to do that, please have a look .
For this step it is necessary to install Frame Wallet. You can import the Metamask wallet you used to setup your DAO into Frame Wallet. you can read how.
As you can see, we are using the dao exec command to interact with the mint method of B's app.
is used to create new tokens and assign them to a receiver. It takes two arguments: a receiver address, and the amount of tokens to be created.
This is because the token created by the has 18 decimals, so 1 unit of a token is actually 0.000000000000000001 tokens. This is not what we want.
The second is the address of an external contract or the address of an app within a DAO. In our case this is the address of B's .
The third is the of the method we wish to execute in either the external contract or the app we specified in the second argument. In our case the method is and its full signature is vote(unint256,bool,bool).
