IntentGuard User Guide

How to use IntentGuard protected execution in your wallet

This guide walks you through setting up IntentGuard with wallets like MetaMask so your transactions are protected by your security rules.

What is IntentGuard?

IntentGuard adds Execution Security to your wallet. You define rules (e.g. "never lose more than X of token Y", "require at least Z inflow") and IntentGuard enforces them before your transactions are submitted. If a transaction would violate your rules, it is blocked — your wallet is protected.

Step 1: Set up your security policy

Before you can use protected execution, you need to configure your protection rules.

1. Go to the Control Console

   • Open https://control.intentguard.xyz in your browser.

2. Connect your wallet

   • Click Connect Wallet and approve the connection in MetaMask (or your wallet).

3. Select your network

   • Choose the network you want to protect (e.g. Sepolia for testing, Ethereum Mainnet for production).

4. Add your constraints

   • Max outflow: Maximum amount of a token you are willing to lose in a transaction (e.g. 0 to forbid any loss).
   • Min inflow: Minimum amount of a token you must receive (e.g. 100 USDC for a swap).
   • You can add multiple tokens and rules (up to 10 constraints).

5. Sign and activate

   • The console will ask you to sign a transaction to activate your policy on-chain.
   • Approve the transaction in your wallet.
   • Once confirmed, your policy is active.

Step 2: Add IntentGuard RPC to your wallet

To route your transactions through IntentGuard, you need to use the IntentGuard RPC endpoint. Here’s how to add it in MetaMask.

MetaMask (Browser Extension)

1. Open MetaMask and click the network dropdown at the top (e.g. "Ethereum Mainnet" or "Sepolia Testnet").

2. Add a network

   • Click Add network or Add a network manually.
   • If you want to add IntentGuard as a custom RPC for an existing network, choose that network first, then go to Settings → Networks and edit it. Or add a new network with the same chain ID and the IntentGuard RPC.

3. Enter network details

   For Sepolia (testnet):

   • Network name: IntentGuard Sepolia (or any name you prefer)
   • RPC URL: https://rpc.intentguard.xyz
   • Chain ID: 11155111
   • Currency symbol: ETH
   • Block explorer: https://sepolia.etherscan.io (optional)

   For Ethereum Mainnet:

   • Network name: IntentGuard Ethereum
   • RPC URL: https://rpc.intentguard.xyz
   • Chain ID: 1
   • Currency symbol: ETH
   • Block explorer: https://etherscan.io (optional)

4. Save

   • Click Save or Add network.
   • Select the new network from the dropdown.

Alternative: Use IntentGuard RPC for an existing network

If you prefer to keep your existing network and only change the RPC:

1. In MetaMask, click the network dropdown.
2. Click the Settings (gear) icon next to your network (e.g. Sepolia).
3. Scroll to New RPC URL.
4. Replace the current URL with: https://rpc.intentguard.xyz
5. Save.

⚠️ Note: This sends all RPC traffic (including reads and sends) through IntentGuard. Your balances and chain data will work as before; only eth_sendRawTransaction is handled by IntentGuard.

Step 3: Send transactions as usual

Once your RPC is set to IntentGuard and your policy is active:

1. Use your wallet normally — swap, transfer, approve, etc.
2. Sign the transaction in MetaMask as you always do.
3. IntentGuard checks your transaction against your policy before it is submitted.
4. If it passes — your transaction is submitted and you get a transaction hash as usual.
5. If it fails — you’ll see a clear error (e.g. "IntentGuard protected your wallet" or "Transaction didn't meet your protection criteria"). Your transaction is not submitted and your nonce is not used, so you can retry or adjust.

Understanding error messages

Message	Meaning	What to do
IntentGuard protected your wallet	Your transaction would have violated your rules.	Adjust the transaction (e.g. change amount, slippage) or update your policy at control.intentguard.xyz.
Nonce too high	You have pending transactions.	Wait for them to confirm, or re-sign with the correct nonce.
IntentGuard couldn't protect this transaction right now	Temporary relay or network issue.	Retry in a few seconds.
No active policy found	No policy is set for your address on this network.	Set up your policy at control.intentguard.xyz.

Frequently asked questions

Do I need to change my RPC for every transaction?
No. Once you’ve added the IntentGuard RPC and selected that network, all transactions on that network go through IntentGuard as long as you stay on that network.

Can I switch back to a normal RPC?
Yes. In MetaMask, change the RPC URL back to your previous provider (e.g. Infura, Alchemy, or the default) in the network settings. Or switch to a different network that uses a different RPC.

What if my transaction is blocked?
Your transaction was not submitted. Your nonce is not used, so you can try again with a different transaction or adjust your policy.

Is my policy stored on-chain?
Yes. Your policy is registered on-chain. The Control Console helps you create and sign the activation transaction.

Which networks are supported?
Sepolia and Ethereum Mainnet are supported when configured. Check control.intentguard.xyz for the current list.

Quick reference

Item	Value
Control Console	https://control.intentguard.xyz
RPC URL	https://rpc.intentguard.xyz
Sepolia Chain ID	11155111
Ethereum Mainnet Chain ID	1

For developers integrating IntentGuard into wallets or dApps, see the IntentGuard - Execution Security - Wallet Integration.