Get started[edit]
About Zodiac Pilot[edit]
Zodiac Pilot is a Chrome extension that enables users to simulate, record, and batch dapp transactions on behalf of a DAO. By using the Pilot extension, owners of a Safe (avatar) or any address designated in a mod like the Roles Modifier can verify dapp interactions before submitting them as a multi-send batch transaction for gas savings and easy signing. Learn more about the Zodiac Pilot Extension.
Note: To use Zodiac Pilot, you must either be an owner on the Safe or have an address with whitelisted permissions set in a modifier like the Roles Modifier or Delay Modifier.
Install Zodiac Pilot[edit]
Visit the Zodiac Pilot website and click on "Install Extension."
This will take you to the Chrome Web Store, where you can install the extension on any Chrome-enabled browser (Google Chrome, Brave, Opera, Edge).
Once installed, find the app in your browser's extension list or visit the Zodiac Pilot homepage.
Add a connection[edit]
When you open the Zodiac Pilot extension, it will look like this:
In order to simulate and batch transactions, you must create a connection.
Note: Connection settings are automatically saved during creation. You can view and adjust connection settings at any time from the Zodiac Pilot homepage.
Configure Accounts and Settings[edit]
- Connection label: Enter a name for the connection.
- Pilot Account: This account refers to the specific address intended to act as the pilot for the Safe (avatar). To be a pilot, you must either be an owner on the Safe or have an address with whitelisted permissions set in the Roles Modifier. To connect the Pilot Account, log in via WalletConnect or MetaMask.
- Piloted Safe: This account refers to the address of the Safe from which transactions will be executed. Once the Pilot Account is connected, any associated Safe addresses will appear in the dropdown menu, but you can also input any Safe address in the field.
- Zodiac Mod: This section allows you to specify whether you'd like to submit the multi-send transaction directly to the Safe or through a Zodiac mod. The dropdown menu will automatically include any compatible Zodiac mod already attached to the Piloted Safe (supported mods include the Roles Modifier and Delay Modifier).
❗ If the Pilot Account is an owner, choose "No mod — Direct execution" to submit transactions directly to the Safe.
❗ If the Pilot Account is not an owner, the transaction should be routed through a Zodiac modifier:
- Routing through the Roles Modifier allows owners to set the Pilot Account to an address with granular permissions specified in the mod. Be sure to choose the correct Role ID associated with the Pilot Account.
- Routing through the Delay Modifier allows owners to set the Pilot Account to a module — including an EOA — enabled on the mod. Submitted transactions will be pre-authorized but will need triggering after the configured delay.
In the example below, transactions will be submitted directly to the Safe.
Your connection is now set.
Remember: Connection settings are automatically saved during creation. You can view and adjust connection settings at any time from the Zodiac Pilot homepage.
Launch Zodiac Pilot[edit]
Once you have adjusted the settings and specified the correct accounts, you are ready to start using Zodiac Pilot.
Click the Launch button at the top-right of the app or click on the connection name if you're on the Pilot homepage.
While Pilot works with almost every dapp that uses an injected wallet, we provide a list of confirmed working dapps in the connection toolbar. You may also enter the URL of a dapp directly in Pilot’s URL bar. (Note: If you run into problems with a dapp, let us know. We may be able to add support for it in an upcoming release.)
Simulate and record transactions[edit]
From here, how Zodiac Pilot is used will depend on the dapp.
Generally speaking, the Pilot Account impersonates the Piloted Safe while interacting with the dapp. Transactions will be recorded in the right panel and automatically simulated in a temporary blockchain fork. That way it appears to the dapp that any submitted transaction is immediately signed and mined.
✔️ Here is a screenshot of the Zodiac Pilot UI connected to Lido, which shows that the transaction simulation and role permission in this interaction are successful:
❌ Here is a screenshot of the Zodiac Pilot UI connected to Balancer, which shows that the transaction simulation was successful but the role permission was NOT successful. (In this example, the Roles Modifier wasn't configured to allow the Pilot Account to execute this specific transaction.)
Submitting transactions[edit]
Once the transactions are verified, the Pilot Account can then sign and submit them as a multi-send batch to the Safe by hitting "Submit" at the bottom of the right panel.
From there, the normal Safe mechanism for approving a transaction bundle will take over.
Questions?[edit]
If you need support or have questions about Zodiac, join the Gnosis Guild Discord.
