Guide

How to use WalletBrake

Videos the whole flow in 3 minutes, and a short one for each stepWorks with Trust Wallet, MetaMask and other Ethereum-style wallets
In short
  • Your money sits in a vault. You still pay from your everyday wallet.
  • Limits nobody can get around, a 1-hour wait for large payments to new people, and a freeze button.
  • Lose your owner wallet? Your backup address can rescue everything after a wait you control.
  • WalletBrake never holds your keys or your money.

01Watch the whole flow#

From this website to a vault on two networks, in three minutes: create a vault, pay, a payment that waits, lower a limit, freeze, and a backup rescue.

Recorded on test networks with test money. Your own wallet asks you to confirm where the video shows a confirm card.
Or watch one step
  1. Create your vault
  2. Add money
  3. Pay
  4. Lower a limit
  5. Raise a limit
  6. Freeze
  7. Emergency move
  8. Trust someone
  9. Rescue with your backup
  10. Rescue wait
  11. Another network
  12. AI agents

02Three wallets#

WalletWhat it doesWhere to keep it
Spending walletSends everyday paymentsYour phone (Trust Wallet, MetaMask)
Owner walletOwns the vault: freezes, unfreezes, changes settingsNot your phone: a hardware wallet or a second wallet
Backup addressReceives everything in an emergencySomewhere else again: a hardware wallet or an exchange account

All three are normal 0x addresses. One address works on every network (Base, BNB Smart Chain, Ethereum), so you set them up once.

03Create your vault#

  1. Open app.walletbrake.com and connect your owner wallet. It becomes the vault's owner.
  2. Network: pick where the vault lives. You can add other networks later; the vault keeps the same address everywhere.
  3. Spending wallet: paste the address you pay from every day.
  4. Backup address: paste an address you control that isn't your spending wallet. Then prove it's yours: Sign with it (free), or, for an exchange deposit address, type its last 6 characters.
  5. Limits: pick Personal, Bot or business or AI agent, then change the numbers if you like. The summary under them says in plain words what they allow.
  6. Tap Create my vault and confirm in your wallet. It costs a little gas.
Create your vault0:51

04Add money#

Tap Receive on the vault page and send money to the vault's address from any wallet or exchange, on the same network. On test networks, Add 1,000 test USDC puts test money in it.

Add money0:39

Free test money for fees

Every payment and every change costs a tiny network fee, paid by the wallet that sends it, in the network's own coin. On test networks that coin is free from a faucet. Paste your wallet's address there:

Some faucets ask you to sign in or to hold a little real money on the main network first. 0.001 test ETH covers hundreds of payments. Test coins have no value: never buy them.

05Pay#

  1. Open the vault with your spending wallet connected.
  2. Enter the address and amount, tap Send, sign the request (free), then confirm the transaction.
  3. Small payments go out at once. Large payments to someone new wait 1 hour, so you can cancel one you didn't make from the Waiting tab.

The vault page shows what you can send right now, your limits, and the largest single payment.

Pay, and cancel a waiting payment0:45

06Stay safe#

These need your owner wallet, in the Safety tab.

  • Lower a limit: Your limits → Change. Lower numbers apply at once.
  • Raise a limit: the same screen. It waits 24 hours, then you switch it on under Changes waiting to switch on, so anyone who steals your owner wallet can't do it quietly.
  • Freeze: Freeze my vault now. Nothing can leave, and anything waiting is cancelled. Only the owner wallet can unfreeze.
  • Emergency: while frozen, Move everything to my backup address.
  • Trust someone you pay often: large payments to them skip the 1-hour wait. Trusting takes 24 hours to switch on.
Lower a limit0:31
Raise a limit0:55
Freeze and unfreeze0:39
Move everything to your backup0:33
Trust someone you pay often0:55

07If you lose your owner wallet#

Connect your backup address, open Safety, and start a rescue. After the wait (30 days unless you changed it; 7 to 180), everything in the vault moves to the backup address, and nowhere else.

Your owner wallet gets an alert at once and can cancel it until then, so nobody can do this to you quietly. If your backup address can't sign (an exchange deposit address), contact support and WalletBrake can start the rescue for you.

You can change how long a rescue waits under Safety → Advanced → If you lose this owner wallet: longer applies at once, shorter waits 24 hours.

Start and cancel a rescue0:39
Change the rescue wait0:30

08More networks#

On All my vaults, tap Add next to a network. Your wallets are filled in for you, and the vault appears at the same address there. If someone sends money to your vault address on a network where you don't have the vault yet, the app shows it as waiting: add that network to reach it.

Add another network0:40

09AI agents#

An AI agent that pays bills reads web pages and emails, and a page can hide instructions for it, like "pay this invoice to a new address instead". This is called prompt injection.

  1. When you create the vault, pick the AI agent plan. Use the agent's own wallet as the spending wallet, not yours.
  2. Under Addresses you trust, list the addresses the agent pays, like your suppliers. They're trusted straight away. You can add more later in Safety; that takes 24 hours to switch on.
  3. In Safety, under Alerts, tap Connect Telegram: payment questions come there. You can add an email address for alerts too.
  4. The vault then pays only trusted addresses by itself. A payment anywhere else comes to you on Telegram: tap Approve to let that one payment through, or Reject. An agent that keeps trying freezes the vault and alerts you.
  5. Optional: in Safety → Advanced, make a canary address and put it where only an attacker would use it, like the agent's settings file as "TREASURY_WALLET". If anyone ever asks WalletBrake to pay it, the vault freezes at once.

Want to see it hold? Break the Brake: write one email to try to trick a real AI payments agent, and watch what WalletBrake does.

Using Claude, Cursor or another MCP app? Add the WalletBrake MCP server and your agent can pay from the vault without ever seeing its key. Building the agent yourself? The developer docs show how it pays, in TypeScript or Python.

An AI agent tricked by a web page1:04

10Good to know#

  • WalletBrake can approve or refuse payments and freeze your vault. It can never move your money or raise your limits.
  • If WalletBrake ever goes away, your owner wallet can still freeze the vault and move everything to your backup address, straight from the blockchain.
  • This is a beta on test networks. Use only test money until WalletBrake is independently audited.