Add a Safe multisig

Goal

Bring a Safe your organization already uses into Mezzanine, so its balance shows in All Accounts and counts toward your totals.

How it works

You paste the Safe’s address and choose which of your entities owns it. Mezzanine checks the address on each network and reads the Safe’s owners and threshold from the chain.

Before you start

• You have the Manage entities permission. (Who can use it)
• The entity that owns the Safe exists in Mezzanine. If not, add it first under Legal & Compliance → Entities.
• You have the Safe’s address, and you know which networks it’s deployed on.

Steps

1. In the sidebar, click All Accounts.
   You see the list of your accounts.
2. Click Actions at the top right, then Add Account.
   A window opens titled Add account.
3. Under Crypto, click Safe.
   The window changes to Add Safe: Choose how to add the Safe.
4. Click Paste an address.
   You see a form: We read the owners and threshold from the chain.
5. Under Legal entity, choose the entity that owns the Safe. If your organization has one entity, it’s already filled in.
6. Under Account name, give it a name you’ll recognise, e.g. Foundation Treasury Safe.
7. Under Safe address, paste the address.
   If it isn’t a valid address, you see Please enter a valid Ethereum address (0x…).
8. Under Networks, choose the networks the Safe is on. Or leave it on All Networks: Mezzanine checks Ethereum, Base, Arbitrum, Optimism, Avalanche and Hyperliquid, and adds the Safe wherever it finds it.
9. Click Add Safe.
   The window closes. The Safe appears in All Accounts with Wallet · Safe under Type, one row for each network it was added on.

Panel closed? When no account is open in the panel on the right, it lists ways to add one. Click Safe to go straight to step 4.

Let Mezzanine find your Safes. On step 4, click Auto-detect instead. Mezzanine looks for Safes where your connected wallets are a signer or proposer. Click Add wallet to connect another one. Tick the Safes and networks you want, rename them if you like, and click Add Safe (it shows how many, e.g. Add 2 Safes). Auto-detect doesn’t ask which entity owns the Safes, so if your organization has more than one entity, use Paste an address.

Need a new Safe? On step 4, click Create a new Safe. Choose the Network, Owners and Threshold, then click Continue. Check the summary on Confirm new Safe and click Deploy Safe. Sign the deployment in your wallet when it asks. You see Safe deployed: The Safe is onchain and added to your accounts.

If something goes wrong

You see	Why	What to do
This address is not a Safe on the selected network. Please check the address and network. (or …on any of the selected networks…)	No Safe exists at that address on the networks you chose	Check the address, and choose the right networks or leave All Networks
This Safe account already exists in your organization.	The Safe is already in All Accounts on that network	Search for it in the table
Added 1 Safe(s). 1 already existed. or similar	Some networks were added; the rest were already there or failed	Check the table. If it says some failed, add those networks again
Could not reach the server to validate the Safe address. Please try again.	The address couldn’t be checked	Wait a moment and click Add Safe again
Account name is required	The name is empty	Enter a name
Please create a legal entity on the Entities page before adding an account.	Your organization has no entity to own the Safe	Add one under Legal & Compliance → Entities, then start again
No Safes found (Auto-detect)	None of your connected wallets is a signer or proposer on a Safe	Click Add wallet to connect another, or use Paste an address
Failed to deploy the Safe. Please try again.	The deployment didn’t go through, for example because you rejected it in your wallet	Click Deploy Safe again
You do not have permission to manage entities	You don’t have Manage entities	Ask an admin, or request it from the message