The upcoming version of EVMcrispr is almost ready, and as the previous month, we would like to let the Aragon Community choose the code name for EVMcrispr v0.5.x.
This version comes with significantly refactoring of the code, moving most of the AragonOS-related code to its module. This means that from now on, EVMcrispr can be used for more than just creating AragonOS votes. It is now a tool to create scripts that perform transactions to EVM-compatible blockchains, including AragonOS votes. So now we are closer to a more general tool that can be used to claim your farming rewards or send funds to multiple addresses, and both things can be done from an address or a DAO.
Knowing that we ask for your help to name this milestone. The options are:
- “wonderful possibilities” - because this release opens the door to future integrations
- “total rewiring” - due to the major refactoring the code experimented
- “unplugged expressions” - because we do not need to be plugged to a DAO to use EVMcrispr anymore
3 Likes
June 2022 EOM Report
@daniel-ospina @lee0007 @fartunov
Deliverables
We released the EVMcrispr v0.5.0 “unplugged expressions” with the following features:
- We restructured the EVMcrispr library in modules to make it easier to extend with other frameworks in the future - Completed
- We separated the code between the
std
(standard) module and the aragonos
module.
- The
std
module contains the generic exec
command and the @token
, @me
, @id
, and @date
helpers.
- The
aragonos
module contains all the Aragon-specific commands (connect
, install
, upgrade
, grant
, revoke
, exec
, and act
) and the @aragonEns
helper.
- We introduced
@id
and @date
helpers. - Completed
- The
@id
helper can be used to obtain the hash of a string
- The
@date
helper is a more powerful helper than the @now
helper (that we will not need to implement):
- We can use
@date(now)
to get the current time
- We can also use a date in ISO 8601 format to specify an exact date, for instance,
@date(2022-02-02Z)
to obtain the timestamp for 2nd February 2022.
- We can also add or remove periods to those dates. Examples:
@date(now,+3d)
for three days from now, and @date(2015-07-30Z,-2y-4m)
for 2 years and 4 months ago from the Ethereum genesis block date.
- We introduced major support to named parameters in commands. - Completed
- New
--oracle
option in grant
command, replacing the @params
and @params.oracle
helpers we had planned. It allows an EVMcrispr user to set up permissions only available when the oracle returns true. An excellent example of that is the 1hive token oracle Aragon app, which is an ACL oracle that returns true when the address that acts has a specific token.# grant any entity permission to create votes if they have a specific token
grant ANY_ENTITY voting CREATE_VOTES_ROLE voting --oracle token-oracle.open
- New
--version
option in command install
, so we can choose to install a different version, not just the last one. Example:# install voting v1.0.0
install voting:new @token(HNY) $support $quorum $duration --version 1.0.0
- New positional options in command
upgrade
make it optional and allow to specify a specific version. Example:# upgrade voting to the latest version
upgrade voting
# downgrade voting to 1.0.0
upgrade voting 1.0.0
# upgrade voting to a different contract (be very careful with this one)
upgrade voting 0x...
-
(From 0.7.x deliverable) Allow multi-transaction sending scripts, so we can create many votes in many different DAOs in just one script. - Completed
- This is the first version in which we can use EVMcrispr to execute any transaction in the blockchain, without having to be attached to a DAO. Do you want to claim and re-stake your Unipool rewards? Easy:
# No DAO needed; these actions are performed directly from your address
exec $contract getReward()
exec $contract stake(uint256) @token.balance(@me)
- You can also create many votes in the same script!
connect dao1 token-manager voting (
# <actions to normal Aragon DAO>
)
connect dao2 disputable-voting.open --context "Optional link" (
# <actions to Gardens>
)
- On top of that, you can even interact with the DAO apps from your address without forwarding.
connect dao1 (
# Cast a vote on vote #1 directly from your address, voting yes
exec voting vote 1 true true
)
Additional deliverables
- We researched how to properly create a Little Language (more known as Domain-Specific Language), and started implementing an interpreter to create an Abstract Syntax Tree. It will make it easier to interpret, highlight, and autocomplete the user scripts. - Ongoing
- New option to command
new
to create DAOs: new dao <aragonId>
. - Ongoing
- It creates an empty DAO. Once available in the graph, you can install as many apps as you want and grant them permissions within a
connect
command.
- Connecting to the DAO just after creating it does not work yet; it needs to be done in a different script.
- New
@aragonEns
helper to find the addresses pointed by subdomains of aragonpm.eth
and aragonid.eth
. Real example used last week: - Completedset $repo @aragonEns(hooked-token-manager-no-controller.open.aragonpm.eth)
exec $repo newVersion(uint16[3],address,bytes) [2,0,0] 0x7cdB48CBF25F4f044eEaE83187E3825Ae301C93d ipfs:Qma2cVx7i9eTu9VSBexWVbfqeS1qwKc8zFFnwV4zrjTMUJ
- We migrated the UI to use Chakra React components, which will make it easier to expand the frontend next to the subsequent iterations. - Completed
Funding Request
- USDC (90%): $15,000
- ANT (10%): $1,667
We request a relation of 90% USDC / 10% ANT instead of 70% USDC / 30% ANT because of the Financial Guild Proposal to reduce the spending in ANT.
Next steps
We will keep reading the Crafting Interpreters book from Robert Nystrom, and rebuilding EVMcrispr to be more efficient and powerful based on it.
We also are going to start working on the next version (v0.6.0), which will include the following:
- Retrieve external contracts ABI from external sources (i. e. etherscan).
- Introduce
@ipfs
, @calc
, and @get
helpers.
- And everything else we can do during the next month!
Thanks to everyone who attended the AMA on 10th June; it was very cool to see that this project is taking traction!
4 Likes
Great work Sem! Everything coming along really nicely 
Happy to sign off on this again on behalf of NFTX 
Thanks for the thorough overview. Some awesome features being added.
1 Like
1/3 approved cc @Ricktik6
2 Likes
Thank you @sembrestels!
Appreciate your validation @gausman
Approved 2/3 cc @Ricktik6
2 Likes
Another version is going to be released (v0.6.0) focusing on making it easier to interact with contract ABIs, IPFS, numeric parameters, and blockchain data in general.
How should we call it? I’m curious on what values do you feel more identified with.
- “genuine courage” - we are what we do repeatedly, and we are courageous when our acts have part of our heart in them.
- “fearless authenticity” - we can avoid lots of problems by not staying true to our principles, but staying with the majority won’t allow us to be ourselves.
- “truthful deepness” - the truth is deep like a fractal; only truth can be zoomed in indefinitely and still be interesting.
3 Likes
July 2022 EOM Report
@daniel-ospina @lee0007 @fartunov
Deliverables
We released the EVMcrispr v0.6.0 “fearless authenticity” with the following features:
- It reads the ABI from Etherscan API, so we do not need to know the entire function signature to use the
exec
command - Completed
- If we want to use this feature, we need to set the
$etherscanAPI
variable with a valid API key.
- Now, instead of writing the entire signature, we can write the function name. Example
exec @token(WETH) withdraw 40
instead of exec @token(WETH) withdraw(uint256) 40
.
- It supports EIP1822, EIP1967, and other kinds of proxies.
- We introduced
@ipfs
, @calc
, and @get
helpers. - Completed
- The
@ipfs
helper can be used to obtain the CID hash of a string that has been pinned in Pinata. To use this feature, we need to set $ipfs.jwt
with the Pinata JWT key. Example: set $foo @ipfs(Hello world)
.
- The
@calc
helper allows calculating big number expressions using +
, -
, *
, and /
. It takes care of the order of the operations and accepts environment variables. Example: @calc(2+8e18*13/$bar)
.
- We can use
@get
to get any value exposed in a contract. Example: set $abi name():(string); set $var @get($weth,$abi)
. It calls the name
function of the WETH contract and returns the “Wrapped Ether” string.
Additional deliverables
- We have been working on an enhanced version of the interpreter, much more potent than the current one. It is still immature and needs much testing before its release, but it is already available at https://next.evmcrispr.blossom.software and this git branch. - Ongoing
- It allows much more complex scripts, allowing DAO2DAO connections, or interacting with other protocols in the future.
- It also encapsulates the commands and helpers in modules that can be loaded within the script, keeping the evmcrispr core functionalities much simpler.
- We added a new
raw
command that allows sending a transaction to an address with a custom data field. - Completed
Funding Request
- USDC (90%): $15,000
- ANT (10%): $1,667
We request a relation of 90% USDC / 10% ANT instead of 70% USDC / 30% ANT because of the Financial Guild Proposal to reduce the spending in ANT.
Next steps
For the next version (v0.7.0), we will stabilize the new interpreter which will allow to create more complex and powerful scripts, while trying to make it as backward-compatible as possible with the current ones.
The new interpreter will be able to load modules, packages containing commands, and helpers that will make our life easier.
We will also introduce the switch
command, allowing us to change our connected account or the chain in the middle of a script to operate with different chains and accounts.
4 Likes
1/3 Approved cc @Ricktik6 pending NFTX review
2 Likes
Love these deliverables. ABI/Etherscan API stuff is super cool, as well as all the other features and interpreter improvements.
Great stuff, Sem. All looks really solid to me.
NFTX review 
3 Likes
This is what shipping code looks like… outstanding work. Also your work has been helping some exciting new developers take Aragon to the credit world Introduction to Chelo - Chelo User Guide has been able to leverage your tooling. thanks again
4 Likes