Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
146 changes: 73 additions & 73 deletions skills/metamask-agent-wallet/SKILL.md

Large diffs are not rendered by default.

70 changes: 35 additions & 35 deletions skills/metamask-agent-wallet/references/auth.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,12 @@ Use these commands to initialize wallet mode, sign in, inspect authentication st

## `init` Command

Initialize the project by selecting wallet mode and trading mode. Requires an authenticated session — run `mm-dev login` first.
Initialize the project by selecting wallet mode and trading mode. Requires an authenticated session — run `mm login` first.

### Syntax

```bash
mm-dev init [--wallet <mode>] [--mode <mode>] [--mnemonic <phrase>] [--password <password>]
mm init [--wallet <mode>] [--mode <mode>] [--mnemonic <phrase>] [--password <password>]
```

### Supported Flags
Expand All @@ -24,14 +24,14 @@ mm-dev init [--wallet <mode>] [--mode <mode>] [--mnemonic <phrase>] [--password
### Example

```bash
mm-dev init
mm-dev init --wallet server-wallet --mode beast
mm init
mm init --wallet server-wallet --mode beast
export MM_MNEMONIC="word1 word2 ..."
mm-dev init --wallet byok
mm init --wallet byok

export MM_MNEMONIC="word1 word2 ..."
export MM_PASSWORD="mypassword"
mm-dev init --wallet byok
mm init --wallet byok
```

## `init show` Command
Expand All @@ -41,7 +41,7 @@ Display the current initialization settings (wallet mode, trading mode, policies
### Syntax

```bash
mm-dev init show
mm init show
```

### Supported Flags
Expand All @@ -51,17 +51,17 @@ This command does not support additional flags beyond output format options.
### Example

```bash
mm-dev init show
mm init show
```

## `login` Command

Sign in to the CLI. On a TTY, bare `mm-dev login` shows a method picker (QR, Google, or email). QR is recommended but not auto-selected.
Sign in to the CLI. On a TTY, bare `mm login` shows a method picker (QR, Google, or email). QR is recommended but not auto-selected.

### Syntax

```bash
mm-dev login [qr | google | email] [--token <token>] [--timeout <seconds>] [--no-wait]
mm login [qr | google | email] [--token <token>] [--timeout <seconds>] [--no-wait]
```

### Supported Flags
Expand All @@ -70,24 +70,24 @@ mm-dev login [qr | google | email] [--token <token>] [--timeout <seconds>] [--no
| --- | --- | --- |
| `--token` | No | Pre-minted CLI token in `cliToken:cliRefreshToken` format [env: `MM_CLI_TOKEN`] |
| `--timeout` | No | Seconds to wait for QR or browser callback |
| `--no-wait` | No | Print the sign-in URL and exit without waiting (for non-interactive/CI use). Not supported with QR login. Complete later with `mm-dev login --token` |
| `--no-wait` | No | Print the sign-in URL and exit without waiting (for non-interactive/CI use). Not supported with QR login. Complete later with `mm login --token` |

### Example

```bash
mm-dev login --no-wait
mm-dev login google --no-wait
mm-dev login email --no-wait
mm-dev login --token "cliToken:cliRefreshToken"
mm login --no-wait
mm login google --no-wait
mm login email --no-wait
mm login --token "cliToken:cliRefreshToken"
```

### Note

- If already authenticated, the CLI returns `ALREADY_AUTHENTICATED`. Run `mm-dev logout` first, then log in again.
- `mm-dev login qr` returns `COMING_SOON`. Use Google or email sign-in instead.
- If already authenticated, the CLI returns `ALREADY_AUTHENTICATED`. Run `mm logout` first, then log in again.
- `mm login qr` returns `COMING_SOON`. Use Google or email sign-in instead.
- Pairing codes tolerate `-` and whitespace separators (e.g. `608-225` is equivalent to `608225`).
- Use `mm-dev login google --no-wait` or `mm-dev login email --no-wait` for non-interactive/CI flows. Bare `mm-dev login --no-wait` fails without a TTY because no method is selected.
- `--no-wait` is not supported with QR login. Complete authentication later with `mm-dev login --token`.
- Use `mm login google --no-wait` or `mm login email --no-wait` for non-interactive/CI flows. Bare `mm login --no-wait` fails without a TTY because no method is selected.
- `--no-wait` is not supported with QR login. Complete authentication later with `mm login --token`.

## `auth status` Command

Expand All @@ -96,7 +96,7 @@ Show the current authentication status.
### Syntax

```bash
mm-dev auth status [--toon]
mm auth status [--toon]
```

### Supported Flags
Expand All @@ -106,8 +106,8 @@ This command does not support additional flags beyond output format options.
### Example

```bash
mm-dev auth status
mm-dev auth status --toon
mm auth status
mm auth status --toon
```

## `logout` Command
Expand All @@ -117,7 +117,7 @@ Sign out and clear auth credentials plus local init state, wallet selection, and
### Syntax

```bash
mm-dev logout
mm logout
```

### Supported Flags
Expand All @@ -127,7 +127,7 @@ This command does not support flags.
### Example

```bash
mm-dev logout
mm logout
```

## `reset` Command
Expand All @@ -137,7 +137,7 @@ Clear the local CLI session entirely.
### Syntax

```bash
mm-dev reset
mm reset
```

### Supported Flags
Expand All @@ -147,7 +147,7 @@ This command does not support flags.
### Example

```bash
mm-dev reset
mm reset
```

## `wallet password set` Command
Expand All @@ -157,7 +157,7 @@ Set a password to encrypt the BYOK mnemonic at rest. Only available in BYOK mode
### Syntax

```bash
mm-dev wallet password set [--new <password>]
mm wallet password set [--new <password>]
```

### Supported Flags
Expand All @@ -169,8 +169,8 @@ mm-dev wallet password set [--new <password>]
### Example

```bash
mm-dev wallet password set
mm-dev wallet password set --new "mypassword"
mm wallet password set
mm wallet password set --new "mypassword"
```

## `wallet password change` Command
Expand All @@ -180,7 +180,7 @@ Change the BYOK mnemonic encryption password. Only available when the mnemonic i
### Syntax

```bash
mm-dev wallet password change [--current <password>] [--new <password>]
mm wallet password change [--current <password>] [--new <password>]
```

### Supported Flags
Expand All @@ -193,8 +193,8 @@ mm-dev wallet password change [--current <password>] [--new <password>]
### Example

```bash
mm-dev wallet password change
mm-dev wallet password change --current "oldpassword" --new "newpassword"
mm wallet password change
mm wallet password change --current "oldpassword" --new "newpassword"
```

## `wallet password remove` Command
Expand All @@ -204,7 +204,7 @@ Remove the BYOK mnemonic encryption password, storing the mnemonic as plaintext.
### Syntax

```bash
mm-dev wallet password remove [--current <password>]
mm wallet password remove [--current <password>]
```

### Supported Flags
Expand All @@ -216,8 +216,8 @@ mm-dev wallet password remove [--current <password>]
### Example

```bash
mm-dev wallet password remove
mm-dev wallet password remove --current "mypassword"
mm wallet password remove
mm wallet password remove --current "mypassword"
```

## Wallet Modes
Expand Down
6 changes: 3 additions & 3 deletions skills/metamask-agent-wallet/references/chain.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ List all supported EVM blockchain networks (EIP-155).
### Syntax

```bash
mm-dev chains list [--toon]
mm chains list [--toon]
```

### Supported Flags
Expand All @@ -19,8 +19,8 @@ This command does not support additional flags beyond output format options.
### Example

```bash
mm-dev chains list
mm-dev chains list --toon
mm chains list
mm chains list --toon
```

## Supported Namespaces
Expand Down
10 changes: 5 additions & 5 deletions skills/metamask-agent-wallet/references/decode.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,10 @@ Decode hex-encoded EVM calldata into its function name, parameters, and a plain-
### Syntax

```bash
mm-dev decode --payload <0x-calldata> [--toon]
mm decode --payload <0x-calldata> [--toon]
```

The payload can also be passed positionally: `mm-dev decode <0x-calldata>`.
The payload can also be passed positionally: `mm decode <0x-calldata>`.

### Supported Flags

Expand All @@ -31,11 +31,11 @@ The payload can also be passed positionally: `mm-dev decode <0x-calldata>`.
### Example

```bash
mm-dev decode --payload 0x095ea7b3000000000000000000000000...
mm-dev decode 0x095ea7b3000000000000000000000000... --toon
mm decode --payload 0x095ea7b3000000000000000000000000...
mm decode 0x095ea7b3000000000000000000000000... --toon
```

## Notes

- Use this before `mm-dev wallet send-transaction` whenever the calldata is unfamiliar or was not constructed by you, to confirm what the transaction actually does.
- Use this before `mm wallet send-transaction` whenever the calldata is unfamiliar or was not constructed by you, to confirm what the transaction actually does.
- If the selector is not recognized, `intent` falls back to `Call unknown function`. Treat unrecognized calldata as higher risk and warn the user before proceeding.
6 changes: 3 additions & 3 deletions skills/metamask-agent-wallet/references/errors.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ This reference lists error codes the CLI actually emits. SDK-only or remapped co

| Code | Meaning |
| --- | --- |
| `ALREADY_AUTHENTICATED` | Valid session already exists; run `mm-dev logout` before logging in again |
| `ALREADY_AUTHENTICATED` | Valid session already exists; run `mm logout` before logging in again |
| `AUTH_FAILED` | Authentication failed (includes missing refresh token cases) |
| `AUTH_ERROR` | Generic authentication error (includes missing auth token cases) |
| `TOKEN_INVALID` | Invalid CLI token, token pair, or project ID |
Expand Down Expand Up @@ -72,13 +72,13 @@ This reference lists error codes the CLI actually emits. SDK-only or remapped co
| Code | Meaning |
| --- | --- |
| `ABORTED` | Operation aborted by user |
| `NOT_INITIALIZED` | Project not initialized — run `mm-dev init` |
| `NOT_INITIALIZED` | Project not initialized — run `mm init` |
| `NO_MNEMONIC` | Mnemonic not stored |
| `NO_TTY` | No TTY available for interactive prompts |
| `MISSING_ID` | Missing ID parameter |
| `MISSING_QUOTE_ID` | Missing quote ID |
| `MISSING_SWAP_PARAMS` | Missing swap parameters |
| `COMING_SOON` | Feature not yet available (e.g. `mm-dev login qr`) |
| `COMING_SOON` | Feature not yet available (e.g. `mm login qr`) |

## Swap & Bridge Errors

Expand Down
Loading
Loading