Deploy a multisig Safe

Agree on the owners, fund deployment, then deploy and verify. See Need Help for support.

Prerequisites: complete setup, an agreed owner list and threshold, and a chain with the required Safe factory and modules. Use test funds while validating a new integration.

Agree on the Owners

1. Each owner independently derives and verifies their own EOA address.
2. Agree on the entire owner list, threshold and optional salt before predicting the Safe.
3. Keep the same chain, modules and owner configuration on every device.

Use WalletAccountMultisigSafe with predicted options rather than an existing address:

import { WalletAccountMultisigSafe } from '@tetherto/wdk-wallet-multisig-safe'
function requiredEnv(name) {
  const value = process.env[name]
  if (!value) throw new Error(`Missing ${name}`)
  return value
}

const config = {
  provider: requiredEnv('EVM_RPC_URL'),
  chainId: BigInt(requiredEnv('CHAIN_ID')),
  bundlerUrl: requiredEnv('BUNDLER_URL'),
  txServiceUrl: requiredEnv('SAFE_TX_SERVICE_URL'),
  safeModulesVersion: '0.2.0',
  useNativeCoins: true
}

const predicted = new WalletAccountMultisigSafe(
  requiredEnv('WDK_SEED_PHRASE'), "0'/0/0", {
    ...config,
    safeOptions: {
      owners: requiredEnv('SAFE_OWNERS').split(',').map(value => value.trim()),
      threshold: Number(requiredEnv('SAFE_THRESHOLD'))
    }
  }
)
console.log('Predicted Safe:', await predicted.getAddress())

Threshold must be at least one and no greater than the owner count. Independently validate owner uniqueness and address accuracy before deployment.

Fund Deployment

The owner's EOA pays for deployment, even when future operations will be sponsored or token-paid. The Safe address and owner address have separate balances.

Use getSignerAddress() and quoteDeploy() to identify the payer and estimate native gas:

console.log('Fund owner EOA:', await predicted.getSignerAddress())
console.log('Estimated native wei:', (await predicted.quoteDeploy()).fee)

Fund that EOA on the configured chain and leave enough for fee changes. The quote does not cap the later transaction.

Deploy and Verify

Deploying spends native funds and creates the Safe. Review the predicted address and owner configuration before this step.

Use deploy() after confirming the Safe is not already deployed:

if (await predicted.isDeployed()) throw new Error('Safe already exists')
const deployment = await predicted.deploy()
console.log('Deployment transaction:', deployment.hash)

Wait for the EVM deployment receipt before continuing. Then use isDeployed() and getMultisigInfo() to verify the deployed state. Fund the Safe for its intended payments and operating fee mode. Never treat the returned hash alone as confirmation.

Next Steps

• Usage
• Configuration
• API reference

Need Help?