Account plugin for the Safe Multisig wallet (previously known as Gnosis Safe).
- python3 version 3.9 up to 3.12.
You can install using the ape built-in plugin manager:
$ ape plugins install safeYou can install the latest release via pip:
$ pip install ape-safeYou can clone the repository and use setuptools for the most up-to-date version:
$ git clone https://github.com/ApeWorX/ape-safe.git
$ cd ape-safe
$ python3 setup.py installTo use the plugin, first use the CLI extension to add a safe you created:
ape safe add --network ethereum:mainnet "my-safe.eth" my-safeIf you made a mistake or just need to remove the safe, use the remove command:
ape safe remove my-safe --yesNOTE --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 most pending 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 your ape-config.yaml file:
safe:
default_safe: my-safeNOTE: 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: optimism
ethereum:
default_network: sepolia
sepolia:
default_provider: infuraOnce you have a safe, you can view pending transactions:
ape safe pending listIt should show transactions like this:
Transaction 8 rejection (1/2) safe_tx_hash=0x09ab9a229fc60da66ec0fa8fa886ab7c95902fdf5df5a5009ba06010fbb9a9a7
Transaction 8 transfer (1/2) safe_tx_hash=0xed43d80255bcd5ffacb755e8f51bee825913373705d6baea006419d2a33a0a5bNOTE: Use the --verbose flag to see more information about each transaction.
ape safe pending list --verboseThere 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 0x09ab9a229fc60da66ec0fa8fa886ab7c95902fdf5df5a5009ba06010fbb9a9a7NOTE: Here we are using the transaction hash 0x09ab9a229fc60da66ec0fa8fa886ab7c95902fdf5df5a5009ba06010fbb9a9a7 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_accountElse, you can use the execute command directly:
ape safe pending execute 2NOTE: execute requires a full signed transaction ready to be submitted on-chain.
The last main operation is reject.
Rejecting a transaction replaces that transaction with a zero-value transfer from the safe to itself.
ape safe pending reject 2The following example shows how to use multisend:
from ape_safe import multisend
from ape import accounts
from ape_tokens import tokens
safe = 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 local
txn(sender=safe,gas=0)Please see the contributing guide to learn more how to contribute to this project. Comments, questions, criticisms and pull requests are welcomed.
This package was inspired by the original ape-safe by banteg. For versions prior to v0.6.0, the original package should be referenced.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent