> For the complete documentation index, see [llms.txt](https://doc.lockerprotocol.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.lockerprotocol.com/browser-extension/sign-what-a-dapp-asks.md).

# Sign what a dApp asks (the overlay)

The overlay shows exactly what the site wants signed, then runs the QR loop.

When a connected site asks for a signature, the wallet draws an **overlay** on top of the page. Its banner says it all: *Verify every detail on your Locker Vault before signing - this screen is transport only.*

{% stepper %}
{% step %}

### A transaction

**Transaction to sign**: **From**, **To**, **Amount**, **Network**, **Nonce**, **Max fee**, **Data**. For known contracts, **Decoded call** names the function. A red **UNLIMITED approval** label means the site wants permission to move *all* of a token, forever.

<figure><img src="https://3674012151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2jyfPJ4rcVavAvTU9nL%2Fuploads%2Fgit-blob-cf90ccf148a7f2a911d975d2d364d51d02f6b422%2F01-overlay-tx.png?alt=media" alt="overlay tx"><figcaption><p>A transaction request in the overlay.</p></figcaption></figure>
{% endstep %}

{% step %}

### A message

**Message to sign** shows the **Signer** and the **Message**. *Sign in to {site}* requests are the common login pattern.

<figure><img src="https://3674012151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2jyfPJ4rcVavAvTU9nL%2Fuploads%2Fgit-blob-4fffc81174e798cd15aa170505ba9d7d4965dfa1%2F02-overlay-message.png?alt=media" alt="overlay message"><figcaption><p>A message request.</p></figcaption></figure>
{% endstep %}

{% step %}

### Typed data (EIP-712)

**Typed data to sign** shows the **Domain**, the **Primary type** and the fields.

<figure><img src="https://3674012151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2jyfPJ4rcVavAvTU9nL%2Fuploads%2Fgit-blob-b07866028b0857fc0b5f2cd3637a791ac8e6fced%2F03-overlay-typed-data.png?alt=media" alt="overlay typed data"><figcaption><p>A typed-data request.</p></figcaption></figure>
{% endstep %}

{% step %}

### Risk analysis

Above the details, the wallet's local analysis: **verified** (nothing to report), **caution** (review the findings), or **danger** (*signing stays locked until you acknowledge the warnings below*, with the checkbox *I have reviewed the warnings above and accept the risk*). The Vault runs its own analysis too.

<figure><img src="https://3674012151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2jyfPJ4rcVavAvTU9nL%2Fuploads%2Fgit-blob-fd287cc61e5c879bbc14b189cb41080b56e9bcd3%2F04-decoded-call.png?alt=media" alt="decoded call"><figcaption><p>A decoded call with a caution finding.</p></figcaption></figure>
{% endstep %}

{% step %}

### Unlimited approvals

Prefer to **Cancel** and look for a site option to approve an exact amount. If you did approve, you can undo it later with [Revoke a token approval](https://doc.lockerprotocol.com/browser-extension/revoke-an-approval.md).

<figure><img src="https://3674012151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2jyfPJ4rcVavAvTU9nL%2Fuploads%2Fgit-blob-803309084b1d3860f2c68f8ba10db3ba2b8ef0a2%2F05-unlimited-approval.png?alt=media" alt="unlimited approval"><figcaption><p>An UNLIMITED approval flagged in red.</p></figcaption></figure>
{% endstep %}

{% step %}

### The animated QR

Continue: *Point your air-gapped vault's camera at this animated code until every frame is read.* The **Frame** counter shows progress. Scan it on the Vault's Sign tab and read the Vault's review.

<figure><img src="https://3674012151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2jyfPJ4rcVavAvTU9nL%2Fuploads%2Fgit-blob-755d533d6918b9f777a1f2464f0c204db2821dd9%2F06-animated-qr.png?alt=media" alt="animated qr"><figcaption><p>The animated request QR.</p></figcaption></figure>
{% endstep %}

{% step %}

### Scan the signed QR, in the wallet

**Scan the signed QR** opens the scanner **on the wallet's own surface**: the side panel, or a wallet tab when there is no panel. The card on the page stays where it is and says *The wallet is open. Scan the signed QR there; this card closes by itself once the site has its answer.*

That is deliberate. Scanning inside the page would ask the browser *"this site wants to use your camera"*, and that permission would be granted to the **site**, durably. The wallet keeps it instead.

<figure><img src="https://3674012151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2jyfPJ4rcVavAvTU9nL%2Fuploads%2Fgit-blob-bcb4c92e03e9c9227a85b85a9c9bdfe5510a1bb2%2F07-scan-response.png?alt=media" alt="scan response"><figcaption><p>Scanning the Vault's answer.</p></figcaption></figure>

Under the button, one link: **Scan with this page's camera instead**, with the plain warning *the site would then hold your camera permission.* It is there for the rare page where the wallet surface is awkward, and it says what it costs.
{% endstep %}

{% step %}

### While the QR is up

Three controls stay in reach: **Show the request QR again** (when the Vault needs another look), **Extra frame** (the frame counter, so you can tell the animation apart from a freeze) and **Cancel signing**, which ends the ceremony without an answer.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**If something goes wrong**

* *That QR does not answer this request:* you showed a signature for a different request. Redo the loop.
* *That code could not be read in full. Present it again, slowly:* hold the Vault still, closer, and try again.
* *Blank page after the signature on an auto-translated site:* browser translation can crash the page. Disable translation for this site and reload.
* *The camera is not available on this page:* the card says why, in one line: the browser blocks the camera for this site, the site does not allow the camera on its pages, the page is not served over HTTPS, or the camera shows one flat picture. Every one of them ends in the same place, **Continue in the wallet**.
* **Paste fallback** (*Paste the response instead (dev)*) exists only in development builds, never in the store release.
  {% endhint %}

## Learn more

* [Sign a transaction (Vault side)](https://doc.lockerprotocol.com/vault/sign-a-transaction.md)
* [Risk warnings explained](https://doc.lockerprotocol.com/reference/risk-warnings-explained.md)
