# Setting up COTI Snap with your MetaMask wallet

Last updated: October 2025\
Estimated time: 5 minutes\
Requirements: MetaMask (desktop), COTI Mainnet connection

\
Stage 1 — Install the COTI Snap

#### What you’ll need

* MetaMask wallet (desktop browser extension)
* Access to the official COTI Snap install link

Mobile browsers are not supported yet.\\

#### Step 1 — Connect your wallet

1. Navigate to metamask.coti.io.
2. Click Connect Wallet.
3. MetaMask will open a prompt asking:\\

<figure><img src="https://2557786554-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeC83qbrBhITO4kE7kTNB%2Fuploads%2Fgit-blob-37b7c226ae26afc3172c0b676b02a158d6969fe9%2Funknown.png?alt=media" alt="" width="337"><figcaption></figcaption></figure>

This step allows MetaMask to enable private token support through the Snap.

#### Step 2 — Install the COTI Snap

1. Click Install COTI MetaMask Snap.
2. If you don’t already have the Snap installed, MetaMask will prompt you automatically.
3. Approve the installation.\
   \
   \\

   <figure><img src="https://2557786554-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeC83qbrBhITO4kE7kTNB%2Fuploads%2Fgit-blob-eb3c8c78c0f52fbbafd71fe1f97d3d1de4830943%2Funknown.png?alt=media" alt="" width="365"><figcaption></figcaption></figure>

#### Step 3 — Approve connection

1. MetaMask will ask for permission to connect the Snap to your wallet.
2. Click Approve when prompted.

\\

<figure><img src="https://2557786554-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeC83qbrBhITO4kE7kTNB%2Fuploads%2Fgit-blob-27ec4340202c3d8ff8e709c118776648549f7658%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

\\

#### Step 4 — Choose your account and connect

Select the account you wish to use with the Snap (recommended: your COTI Mainnet account) and click Connect.

You’ve successfully added the COTI Snap to MetaMask!

### Stage 2 — View your COTI Private Token balances

#### Step 5 — Confirm Snap installation

1. In MetaMask, click your Profile icon → Settings → Snaps.
2. You should now see COTI Snap listed and active.\
   \\

<figure><img src="https://2557786554-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeC83qbrBhITO4kE7kTNB%2Fuploads%2Fgit-blob-2861cdac7f4828e1668803faa1dd3bd431ea9fa4%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

\
\\

<figure><img src="https://2557786554-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeC83qbrBhITO4kE7kTNB%2Fuploads%2Fgit-blob-1631f9d000dd81c1bc799f773aba969f15a59d5f%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

#### Step 6 — Onboard your account

1. In MetaMask, click Onboard Account.
2. MetaMask will open a popup to register your account with the Snap.
3. Click Confirm when prompted.\
   \
   \
   \\

   <figure><img src="https://2557786554-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeC83qbrBhITO4kE7kTNB%2Fuploads%2Fgit-blob-fbac08fab86be21cdbccbd7acaa2708d234d73a3%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

#### Step 7 — Sign and authorize

MetaMask will display a Signature Request popup.\
Click Confirm to authorize the onboarding.\
The message may appear encrypted — this is expected.\
This simply verifies your ownership and uses a small amount of COTI for gas.\
\
\\

<figure><img src="https://2557786554-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeC83qbrBhITO4kE7kTNB%2Fuploads%2Fgit-blob-b57ab9a676a9b024b2ec40b5c5a8923de57831b2%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

#### Step 8 — Approve the connection

1. MetaMask will display the request from snap.coti.io on the COTI Mainnet.
2. Click Confirm to proceed.

\\

<figure><img src="https://2557786554-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeC83qbrBhITO4kE7kTNB%2Fuploads%2Fgit-blob-f22ec470c0ee83f656f1c428ad23e17f08093974%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

#### Step 9 — Grant AES key access

1. The COTI app will now request access to your AES Key — used for decrypting your private balances.
2. Click Request, and when MetaMask pops up, choose Approve.

Without this step, you can hold private tokens, but you won’t be able to view balances.\\

<figure><img src="https://2557786554-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeC83qbrBhITO4kE7kTNB%2Fuploads%2Fgit-blob-f34c218d5a8c8009b58c250ea0ac84f82d3b7481%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

#### Step 10 — Launch the dApp

Click Launch dApp to open the COTI Snap application and view your private token balances.\
\\

<figure><img src="https://2557786554-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeC83qbrBhITO4kE7kTNB%2Fuploads%2Fgit-blob-7ee7606c80be8e65c3f2c6e78b9792e12e6625f3%2Funknown.png?alt=media" alt="" width="326"><figcaption></figcaption></figure>

You’ve completed Stage 2 — your COTI Snap is live and connected!

\\

### Stage 3 — Send and Receive Private Tokens

Private ERC-20 tokens on COTI are not standard ERC-20s — they include encrypted data and special logic.\
Some wallet or explorer behaviors may differ from standard tokens.

#### Step 13 — Import your private token

1. In MetaMask Snap, click Import Tokens.
2. Paste the private token’s contract address
3. Click Next → Import and confirm in MetaMask.\
   \\

<figure><img src="https://2557786554-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeC83qbrBhITO4kE7kTNB%2Fuploads%2Fgit-blob-e40324a6096f2489f96f26cf5d5672dac794c4fa%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

#### Step 14 — View token details

Once imported, the token will appear in your Assets list.\
Click it to open details and balance (shown through the Snap’s decryption layer).\
\\

<figure><img src="https://2557786554-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeC83qbrBhITO4kE7kTNB%2Fuploads%2Fgit-blob-9172ae0ba88809d730065d95696f2d3be1825b83%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

#### Step 15 — Send your private token

1. Click Send Token in the COTI dApp or Snap interface.
2. Enter the recipient’s address and confirm.
3. Approve the request in MetaMask.

<figure><img src="https://2557786554-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeC83qbrBhITO4kE7kTNB%2Fuploads%2Fgit-blob-f4096436a8bfaaa3d60f8783bf6f16b2a66a7446%2Funknown.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

The transaction is now live on-chain — encrypted and private.

\\


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.coti.io/coti-documentation/build-on-coti/guides/setting-up-coti-snap-with-your-metamask-wallet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.