> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usmewe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Duress PIN

> Protection against physical coercion

# Duress PIN

The Duress PIN is a secret alternative PIN that protects you when forced to make a transfer under threat.

<Warning>
  **This feature saves lives.** Take time to set it up properly and memorize your Duress PIN.
</Warning>

## How It Works

When you enter your **Duress PIN** instead of your regular PIN:

<Steps>
  <Step title="Fake Success">
    The app shows a completely normal "Transaction Successful" screen
  </Step>

  <Step title="Fake Balance">
    Your displayed balance decreases as if the transfer happened
  </Step>

  <Step title="Silent Alert">
    All Guardians receive a silent emergency notification
  </Step>

  <Step title="Funds Protected">
    In reality, no funds are moved - they remain safely locked
  </Step>
</Steps>

## Setup

<Steps>
  <Step title="Navigate to Security">
    Go to **Settings** > **Security** > **Duress PIN**
  </Step>

  <Step title="Choose PIN">
    Select a 6-digit PIN different from your regular PIN
  </Step>

  <Step title="Confirm">
    Enter the PIN twice to confirm
  </Step>

  <Step title="Optional: Emergency Contacts">
    Configure automatic notification to authorities
  </Step>
</Steps>

<Note>
  Choose a PIN you can remember under stress, but that's not obvious (like your regular PIN + 1).
</Note>

## Duress Mode Behavior

| Action          | Normal PIN       | Duress PIN           |
| --------------- | ---------------- | -------------------- |
| Screen shown    | Real transaction | Fake transaction     |
| Balance display | Real balance     | Fake reduced balance |
| Funds moved     | Yes              | No                   |
| Guardian alert  | No               | Yes (silent)         |
| History shown   | Real             | Fake entry added     |

## Guardian Alert

When Duress PIN is activated, Guardians receive:

```json theme={null}
{
  "type": "DURESS_ALERT",
  "severity": "CRITICAL",
  "message": "Emergency: Possible coercion detected",
  "user": "user_123",
  "location": {
    "lat": 40.7128,
    "lng": -74.0060,
    "accuracy": "GPS"
  },
  "timestamp": "2025-01-15T14:30:00Z",
  "instructions": [
    "Do not contact the user directly",
    "Consider contacting authorities",
    "Monitor for further activity"
  ]
}
```

## Emergency Services Integration

Optionally configure automatic alerts to:

* Local emergency services (911/112)
* Trusted contact phone numbers
* Private security services

<Warning>
  False activations can have serious consequences. Only enable emergency services integration if you understand the implications.
</Warning>

## Recovery After Duress

After a duress situation:

<Steps>
  <Step title="Safe Location">
    Once you're safe, contact your Guardians
  </Step>

  <Step title="Report Incident">
    File a report with local authorities if applicable
  </Step>

  <Step title="Reset Duress Mode">
    Go to Settings > Security > Reset Duress Mode
  </Step>

  <Step title="Change PIN">
    Update both your regular PIN and Duress PIN
  </Step>
</Steps>

## Testing

You can test your Duress PIN setup:

<Steps>
  <Step title="Enable Test Mode">
    Settings > Security > Duress PIN > Test Mode
  </Step>

  <Step title="Attempt Transfer">
    Try a small transfer using your Duress PIN
  </Step>

  <Step title="Verify">
    Confirm fake success screen appears
  </Step>

  <Step title="Check Guardians">
    Verify Guardians received (marked as test) alert
  </Step>
</Steps>

<Info>
  Test Mode clearly marks alerts as tests to avoid confusion.
</Info>

## Best Practices

<AccordionGroup>
  <Accordion title="Memorize, Don't Write" icon="brain">
    Never write down your Duress PIN. Memorize it completely.
  </Accordion>

  <Accordion title="Practice Calmly" icon="spa">
    Practice entering your Duress PIN so it becomes automatic under stress.
  </Accordion>

  <Accordion title="Brief Your Guardians" icon="comments">
    Make sure your Guardians know what a Duress Alert means and how to respond.
  </Accordion>

  <Accordion title="Update Regularly" icon="rotate">
    Change your Duress PIN every 6 months for security.
  </Accordion>
</AccordionGroup>