Repository files navigation

Account plugin for theSafe Multisig wallet (previously known as Gnosis Safe).

• python3 version 3.9 up to 3.12.

You can install using theape built-in plugin manager:

$ ape plugins install safe

You can install the latest release viapip:

$ pip install ape-safe

You can clone the repository and usesetuptools for the most up-to-date version:

$ git clone https://github.com/ApeWorX/ape-safe.git$cd ape-safe$ python3 setup.py install

To use the plugin, first use the CLI extension to add a safe you created:

ape safe add --network ethereum:mainnet"my-safe.eth" my-safe

If you made a mistake or just need to remove the safe, use theremove command:

ape safe remove my-safe --yes

NOTE--yes is a way to skip the prompt.

If you only add one safe, you will not have to specify which safe to use other commands.Otherwise, for mostpending commands, you specify the safe to use (by alias) via the--safe option.

Additionally, you can configure a safe to use as the default in yourape-config.yaml file:

safe:default_safe:my-safe

NOTE: Also, to avoid always needing to specify--network, you can set a default ecosystem, network, and provider in your config file.The rest of the guide with not specify--network on each command but assume the correct one is set in the config file.Here is an example:

default_ecosystem:optimismethereum:default_network:sepoliasepolia:default_provider:infura

Once you have a safe, you can view pending transactions:

ape safe pending list

It should show transactions like this:

Transaction 8 rejection (1/2) safe_tx_hash=0x09ab9a229fc60da66ec0fa8fa886ab7c95902fdf5df5a5009ba06010fbb9a9a7Transaction 8 transfer  (1/2) safe_tx_hash=0xed43d80255bcd5ffacb755e8f51bee825913373705d6baea006419d2a33a0a5b

NOTE: Use the--verbose flag to see more information about each transaction.

ape safe pending list --verbose

There are several operations you can do on a pending transaction.One of them is "approve" which adds your local signers' signatures to the transaction.

ape safe pending approve 0x09ab9a229fc60da66ec0fa8fa886ab7c95902fdf5df5a5009ba06010fbb9a9a7

NOTE: Here we are using the transaction hash0x09ab9a229fc60da66ec0fa8fa886ab7c95902fdf5df5a5009ba06010fbb9a9a7 to specify the transaction because there are more than one.However, you can also use the nonce if there is only a single transaction.

If you want to both execute and approve at the same time, you can use the--execute option on approve and specify a sender:

ape safe pending approve 2 --execute my_account

Else, you can use theexecute command directly:

ape safe pending execute 2

NOTE:execute requires a full signed transaction ready to be submitted on-chain.

The last main operation isreject.Rejecting a transaction replaces that transaction with a zero-value transfer from the safe to itself.

ape safe pending reject 2

The following example shows how to use multisend:

fromape_safeimportmultisendfromapeimportaccountsfromape_tokensimporttokenssafe=accounts.load("my-safe")# Load some contracts (here using ape-tokens)dai=tokens["DAI"]vault=tokens["yvDAI"]amount=dai.balanceOf(safe)# How much we want to deposit# Create a multisend transaction (a transaction that executes multiple calls)txn=multisend.MultiSend()txn.add(dai.approve,vault,amount)txn.add(vault.deposit,amount)# Fetch signatures from any local signers, and broadcast if confirmations are met# Note that in case the user intends to only stage a transaction, then `submit=False` argument can also be added# It is normal that when a user only intend to stage a transaction, an error is thrown# this can be ignored by including the necessary try-catch (from ape.exceptions import SignatureError)# Note that transaction is automatically prompted for execution if enough signers are available in localtxn(sender=safe,gas=0)

Please see thecontributing guide to learn more how to contribute to this project.Comments, questions, criticisms and pull requests are welcomed.

This package was inspired bythe original ape-safe bybanteg.For versions prior to v0.6.0, the original package should be referenced.