Skip to content

Commit 79d0bf0

Browse files
committed
Update shield wordings
1 parent bfedf29 commit 79d0bf0

5 files changed

Lines changed: 45 additions & 28 deletions

File tree

.cursor/rules/product-agent-wallet.mdc

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,8 @@ alwaysApply: false
1616

1717
- **server-wallet** — private keys are held securely in a TEE-backed environment.
1818
- **Bring your own wallet** — user supplies a BIP-39 mnemonic. CLI flag: `byok`.
19-
- **Guard Mode (Recommended)** — trading mode (`--mode guard`). Designed for everyday traders. Enforces security check, network allowlist, token recipient allowlist, address allowlist, and rolling 24h outflow limit. 2-factor authentication on policy violations, malicious transactions, and raising outflow limit.
20-
- **Beast Mode** — trading mode (`--mode beast`). Designed for power users. Security check guardrail only. 2-factor authentication on malicious transactions and risky contracts.
19+
- **Guard Mode (Recommended)** — trading mode (`--mode guard`). Designed for everyday traders. Enforces threat scanning, network allowlist, token recipient allowlist, address allowlist, and rolling 24h outflow limit. 2-factor authentication on policy violations, malicious transactions, and raising outflow limit.
20+
- **Beast Mode** — trading mode (`--mode beast`). Designed for power users. Threat scanning guardrail only. 2-factor authentication on malicious transactions and risky contracts.
2121

2222
Users choose wallet and trading modes during interactive `mm init` or by prompting their agent.
2323
Mark Guard Mode as **Recommended**; do not describe modes as opt-in, default, or preferred in other ways.
@@ -29,13 +29,17 @@ CLI flags use `server-wallet`, `byok`, `guard`, and `beast`.
2929

3030
Use these terms consistently when describing the security stack:
3131

32-
- **Transaction Protection** — guarantee for transactions deemed safe (up to $10,000 loss coverage).
33-
Frame as backing for "security by default," not as a standalone scanning feature. Link eligibility
32+
- **Threat scanning** — powered by Blockaid; production-tested across millions of MetaMask
33+
transactions. Malicious transactions get auto-bounced. Do not conflate with Transaction Shield.
34+
- **Transaction Protection** — guarantee for eligible transactions deemed safe (up to $10,000/month
35+
loss coverage). Frame as optional coverage backing, not as a scanning feature. Link eligibility
3436
and terms to
3537
[Transaction Shield support](https://support.metamask.io/manage-crypto/transactions/transaction-shield/).
36-
- **Transaction Shield** — automated security checks for malicious contracts and scams. Link to
37-
[Transaction Shield support](https://support.metamask.io/manage-crypto/transactions/transaction-shield/).
38-
Do not lead with vendor names.
38+
- **Transaction Shield** — MetaMask subscription pairing Transaction Protection with priority support.
39+
Link to
40+
[Transaction Shield support](https://support.metamask.io/manage-crypto/transactions/transaction-shield/)
41+
for subscription details, eligibility, and terms. Do not describe Transaction Shield as a security
42+
or threat-scanning feature.
3943
- **Smart Transactions** — optimizes how trades land onchain (fewer fails, better gas, built-in MEV
4044
protection). Link to
4145
[Smart Transactions support](https://support.metamask.io/manage-crypto/transactions/smart-transactions/).

agent-wallet/README.mdx

Lines changed: 12 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -33,23 +33,26 @@ After setup, prompt your agent in plain language:
3333
## MetaMask safety-checks every transaction before it lands
3434

3535
Security by default, not configuration.
36-
Supported EVM transactions pass through a mandatory 3-step security pipeline.
37-
Backed by Transaction Protection: transactions through Agent Wallet deemed safe are guaranteed
38-
against loss up to $10,000.\*
36+
Supported EVM transactions pass through a mandatory 3-step pipeline before they land onchain.
3937

4038
1. **Transaction simulation**: What will this transaction actually do? Balance changes, approvals,
4139
and gas are surfaced before signing.
42-
2. **[Transaction Shield](https://support.metamask.io/manage-crypto/transactions/transaction-shield/)**:
43-
Automated security checks flag malicious contracts and scams; flagged transactions require your
44-
approval before they execute.
40+
2. **Threat scanning**: Powered by Blockaid and production-tested across millions of MetaMask
41+
transactions. Malicious transactions get auto-bounced. Flagged transactions require your approval
42+
before they execute.
4543
3. **[Smart Transactions](https://support.metamask.io/manage-crypto/transactions/smart-transactions/)**:
4644
Smart transaction execution with built-in MEV protection, fewer fails, and better gas where
4745
supported on the target chain.
4846

47+
Eligible transactions deemed safe are backed by
48+
[Transaction Protection](https://support.metamask.io/manage-crypto/transactions/transaction-shield/)
49+
coverage up to $10,000/month.\*
50+
4951
:::note
5052

51-
Learn more in [Architecture](reference/architecture.md). See [Transaction Shield](https://support.metamask.io/manage-crypto/transactions/transaction-shield/)
52-
for eligibility, coverage limits, and terms.
53+
Learn more in [Architecture](reference/architecture.md). See
54+
[Transaction Shield](https://support.metamask.io/manage-crypto/transactions/transaction-shield/) for
55+
subscription details, eligibility, coverage limits, and terms.
5356

5457
:::
5558

@@ -96,7 +99,7 @@ See [Supported chains](reference/supported-chains.md) for typical networks.
9699
href: '/agent-wallet/reference/architecture',
97100
title: 'Architecture',
98101
description:
99-
'Wallet modes, Transaction Protection, Transaction Shield, Smart Transactions, and 2FA.',
102+
'Wallet modes, threat scanning, Transaction Protection, Smart Transactions, and 2FA.',
100103
},
101104
{
102105
href: '/agent-wallet/guides/trade-perpetuals',

agent-wallet/quickstart.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -89,10 +89,10 @@ During `mm init`, choose a wallet mode and, for server-wallet, a trading mode.
8989

9090
#### Trading mode (server wallet only):
9191

92-
- **Guard Mode (Recommended)**: designed for everyday traders. Enforces security checks, network
92+
- **Guard Mode (Recommended)**: designed for everyday traders. Enforces threat scanning, network
9393
and recipient allowlists, address allowlists, and a rolling 24-hour outflow limit. Transactions
9494
outside your policy limits require 2-factor authentication before they execute.
95-
- **Beast Mode**: designed for power users. Keeps the security check guardrail only. Malicious
95+
- **Beast Mode**: designed for power users. Keeps the threat scanning guardrail only. Malicious
9696
transactions and risky contracts are blocked and surfaced for 2-factor authentication approval.
9797

9898
See [Trading modes](reference/architecture.md#trading-modes) for guardrails and approval conditions.

agent-wallet/reference/architecture.md

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ keywords:
99
server-wallet,
1010
polling,
1111
Transaction Protection,
12-
Transaction Shield,
12+
threat scanning,
1313
Smart Transactions,
1414
2FA,
1515
]
@@ -61,13 +61,23 @@ Optionally encrypt the mnemonic at rest with `MM_PASSWORD` or `mm wallet passwor
6161
Before a transaction executes, the CLI simulates it to surface reverts, unexpected state changes,
6262
and other failures early.
6363

64-
## Transaction Shield
64+
## Threat scanning
6565

66-
[Transaction Shield](https://support.metamask.io/manage-crypto/transactions/transaction-shield/)
67-
runs automated security checks on each transaction, including malicious contracts and scams.
66+
Threat scanning is powered by Blockaid and production-tested across millions of MetaMask
67+
transactions.
68+
Malicious transactions get auto-bounced.
6869
When a transaction is flagged, it requires your approval before it executes.
6970
You receive details in the CLI output and through the approval flow.
7071

72+
## Transaction Protection
73+
74+
Eligible transactions deemed safe are backed by Transaction Protection coverage up to
75+
$10,000/month.
76+
[Transaction Shield](https://support.metamask.io/manage-crypto/transactions/transaction-shield/) is
77+
MetaMask's subscription that pairs Transaction Protection with priority support.
78+
See [Transaction Shield](https://support.metamask.io/manage-crypto/transactions/transaction-shield/)
79+
for subscription details, eligibility, coverage limits, and terms.
80+
7181
## Smart Transactions
7282

7383
[Smart Transactions](https://support.metamask.io/manage-crypto/transactions/smart-transactions/)
@@ -93,7 +103,7 @@ Transactions outside your policy limits require 2-factor authentication approval
93103

94104
**Guardrails**
95105

96-
- Security check
106+
- Threat scanning
97107
- Network allowlist
98108
- Token recipient allowlist
99109
- Address allowlist
@@ -114,7 +124,7 @@ Malicious transactions are still blocked and surfaced for 2-factor authenticatio
114124

115125
**Guardrails**
116126

117-
- Security check
127+
- Threat scanning
118128

119129
**Approval required for**
120130

@@ -140,8 +150,8 @@ See [Trading modes](../use-the-cli-directly.md#trading-modes-server-wallet-only)
140150
When you submit a signing or transaction request in server-wallet mode:
141151

142152
1. The CLI submits the request to the wallet service.
143-
2. The service may simulate the transaction, run Transaction Shield, and evaluate policies.
144-
3. If policy requires 2-factor authentication or Transaction Shield flags the transaction, the job
153+
2. The service may simulate the transaction, run threat scanning, and evaluate policies.
154+
3. If policy requires 2-factor authentication or threat scanning flags the transaction, the job
145155
enters an `AWAITING_MFA` state until you approve via MetaMask Mobile or email.
146156
4. The CLI returns a `pollingId` unless you pass `--wait`.
147157

agent-wallet/use-the-cli-directly.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -78,11 +78,11 @@ Optionally encrypt the mnemonic at rest with `mm wallet password set`.
7878
| Guard Mode (Recommended) | `--mode guard` | Designed for everyday traders. Transactions outside your policy limits require 2FA approval. |
7979
| Beast Mode | `--mode beast` | Designed for power users. Malicious transactions are still blocked and surfaced for 2FA approval. |
8080

81-
Guard Mode enforces security checks, network and recipient allowlists, address allowlists, and a
81+
Guard Mode enforces threat scanning, network and recipient allowlists, address allowlists, and a
8282
rolling 24-hour outflow limit.
8383
2FA is required for malicious transactions, allowlist violations, and raising your outflow limit.
8484

85-
Beast Mode keeps only the security check guardrail.
85+
Beast Mode keeps only the threat scanning guardrail.
8686
2FA is required for malicious transactions and risky contracts.
8787

8888
See [Trading modes](reference/architecture.md#trading-modes) for the full guardrail and approval

0 commit comments

Comments
 (0)