Skip to main content

Deploying Your Wallet

This guide walks you through deploying your first Kleidi wallet using the web app. The whole process takes about 5 minutes.

Before You Start​

Make sure you have:

  • A Web3 wallet installed (MetaMask, Rainbow, etc.)
  • ETH for gas fees on your chosen network
  • The addresses of any additional signers if setting up a multisig

Tip: Start with a smaller timelock delay (3-7 days) for your first deployment to get familiar with how the system works.

Step 1: Connect Your Wallet​

Go to app.kleidi.io/onboarding and click "Get Started".

Click the "Connect Wallet" button. Choose your wallet from the list. Most people use MetaMask.

Approve the connection in your wallet when prompted.

Step 2: Start the Setup​

Once connected, click "Get Started" from the dashboard.

This starts the deployment wizard that will guide you through wallet configuration and deployment.

Step 3: Select Your Network​

Choose which network you want to deploy on:

  • Ethereum
  • Base
  • Optimism

Pick the network where you plan to hold your assets. You can always deploy additional wallets on other networks later.

Step 4: Configure Signers​

This is where you set up who can control the wallet.

Add Signer Addresses​

Enter the Ethereum addresses that will be signers on this wallet. These are your "cold signers" that can propose transactions.

Tips:

  • Use hardware wallet addresses for maximum security
  • Double-check each address before moving forward
  • You can add 1-10 signers

Set the Threshold​

The threshold is how many signers need to approve a transaction before it can be scheduled.

Common setups:

  • Solo wallet: 1 of 1
  • Shared wallet: 2 of 3 or 3 of 5
  • DAO treasury: 4 of 7 or higher

Step 5: Configure Timelock Delay​

Choose how long transactions must wait before they can be executed. This is the core security feature of Kleidi.

Recommended delays:

  • Testing: 1-3 days
  • Personal wallet: 7-14 days
  • High value: 21-30 days

The longer the delay, the more time you have to catch and cancel unauthorized transactions. But it also means waiting longer for every transaction you make.

Remember: You can change this later through a timelocked proposal, but the change itself will require waiting through your current delay.

Step 6: Review Your Configuration​

Double-check everything before deploying. You cannot change most of these settings after deployment.

Verify:

  • All signer addresses are correct
  • Threshold makes sense for your use case
  • Timelock delay matches your security needs
  • You're deploying on the right network

Step 7: Deploy Contracts​

Click "Deploy Wallet" to start the deployment.

This will trigger a transaction that:

  1. Deploys your Timelock contract
  2. Deploys your Safe with all signers
  3. Connects the Guard contract
  4. Sets up all the security measures

Sign the transaction in your wallet when prompted.

The deployment happens in one atomic transaction. If anything fails, nothing gets deployed.

Step 8: Wait for Confirmation​

The transaction usually takes 10-60 seconds to confirm depending on the network.

Once confirmed, you'll see your new wallet dashboard.

Step 9: Verify Deployment​

After deployment, verify everything is set up correctly:

Check these things:

  • Your Safe address is displayed
  • All signers are listed correctly
  • Timelock delay is set properly
  • Guard is active

Save your Safe address somewhere safe. You'll need it to access your wallet.

What's Next?​

Now that your wallet is deployed, you can:

  1. Send funds to your Safe address - Start with a small test amount
  2. Create your first transaction - Practice scheduling and executing
  3. Explore the settings - See what you can configure

Learn how to use your portfolio →

Create your first transaction →

Troubleshooting​

Transaction Failed​

If the deployment fails:

  • Check you have enough ETH for gas
  • Make sure all signer addresses are valid
  • Try again with a higher gas limit

Wrong Network​

If you deployed on the wrong network, you'll need to deploy again on the correct one. There's no way to migrate a deployment between networks.

Can't See My Wallet​

Make sure you're connected with one of the signer addresses you configured. The wallet will only show up for signers.

Common Questions​

Do I need multiple people to deploy a Kleidi wallet?

No. You can deploy with a single signer (yourself) or multiple signers. It's up to you.

Can I deploy without the web app?

Yes theoretically it is possible, but it's much more complex and not recommended.

What if I make a mistake during deployment?

If the deployment transaction hasn't been sent yet, just go back and fix it. If it's already deployed, you can change most settings through timelocked transactions.

How much does deployment cost?

Gas costs vary by network and current gas prices. Budget:

  • ~$50-200 on Ethereum (depends heavily on gas price)
  • ~$1-5 on Base
  • ~$1-5 on Optimism

Can I add more signers later?

Yes, but it requires scheduling a proposal through the timelock. The change will take effect after your configured delay period.

What if I lose access to a signer?

This is serious. Kleidi has no recovery mechanism. If you lose enough signers that you can't meet the threshold, your funds are permanently locked. Always keep secure backups of all signer keys.

Can I change the timelock delay?

Yes, through a timelocked proposal. But the change itself requires waiting through your current delay period first.