> ## 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.

# Setup Social Vault

> Protect your funds with timelock and guardian security

# Setup Social Vault

Protect your crypto with timelock, guardians, and anti-kidnapping features.

## What is Social Vault?

Social Vault is an optional security layer that protects your funds:

<CardGroup cols={2}>
  <Card title="Daily Limits" icon="calendar">
    Instant withdrawals only up to a limit
  </Card>

  <Card title="Timelock" icon="clock">
    Large withdrawals require a waiting period
  </Card>

  <Card title="Guardian Approval" icon="users">
    Multi-signature for big transactions
  </Card>

  <Card title="Duress PIN" icon="shield">
    Emergency lock if you're forced to withdraw
  </Card>
</CardGroup>

## Why Use Social Vault?

| Threat            | Protection                     |
| ----------------- | ------------------------------ |
| Wallet hacked     | Timelock gives time to respond |
| Phone stolen      | Daily limit caps losses        |
| Physical coercion | Duress PIN locks everything    |
| Lost access       | Guardians can help recover     |

## Setup Guide

### Prerequisites

Before setting up Social Vault:

* Have at least 1 guardian added (recommended: 2-3)
* Decide on your security parameters

### Step-by-Step Setup

<Steps>
  <Step title="Navigate to Social Vault">
    Go to **Dashboard** > **Social Vault**
  </Step>

  <Step title="Click Setup Vault">
    Click the **Create Social Vault** button
  </Step>

  <Step title="Set Daily Limit">
    Choose your instant withdrawal limit:

    | Risk Tolerance | Suggested Limit |
    | -------------- | --------------- |
    | Low            | \$50-100        |
    | Medium         | \$100-500       |
    | High           | \$500-1000      |

    <Tip>
      This is the max you can withdraw instantly without guardian approval.
    </Tip>
  </Step>

  <Step title="Set Timelock Duration">
    Choose how long to wait for large withdrawals:

    | Duration | Use Case                       |
    | -------- | ------------------------------ |
    | 1 hour   | Quick access, basic protection |
    | 24 hours | Recommended for most users     |
    | 72 hours | High security                  |
    | 7 days   | Maximum protection             |
  </Step>

  <Step title="Set Required Signatures">
    Choose how many guardians must approve:

    | Guardians | Suggested Threshold  |
    | --------- | -------------------- |
    | 1         | 1-of-1               |
    | 2         | 2-of-2 or 1-of-2     |
    | 3         | 2-of-3 (recommended) |
  </Step>

  <Step title="Create Duress PIN">
    Create a secret 4-6 digit PIN.

    <Warning>
      This PIN locks your vault instantly. Only use in emergencies!
      Never share this PIN with anyone.
    </Warning>
  </Step>

  <Step title="Confirm and Sign">
    Review settings and sign with your wallet.
  </Step>
</Steps>

## Using Your Social Vault

### Deposit Funds

<Steps>
  <Step title="Go to Social Vault">
    **Dashboard** > **Social Vault** > **Deposit**
  </Step>

  <Step title="Enter Amount">
    Enter USDC amount to deposit
  </Step>

  <Step title="Confirm">
    Approve and confirm the transaction
  </Step>
</Steps>

### Instant Withdrawal

For amounts within your daily limit:

1. Go to **Social Vault** > **Withdraw**
2. Enter amount (within limit)
3. Enter recipient address
4. Click **Withdraw Instantly**
5. Confirm transaction

### Large Withdrawal

For amounts exceeding daily limit:

<Steps>
  <Step title="Request Withdrawal">
    Enter amount and recipient, click **Request Withdrawal**
  </Step>

  <Step title="Wait for Approvals">
    Your guardians receive notifications.
    They must approve the withdrawal.
  </Step>

  <Step title="Wait for Timelock">
    After approvals, wait for timelock period.
  </Step>

  <Step title="Execute">
    Once timelock expires, click **Execute Withdrawal**
  </Step>
</Steps>

```
Timeline Example (24h timelock, 2-of-3 guardians):

Hour 0:  Request submitted
Hour 2:  Guardian 1 approves
Hour 5:  Guardian 2 approves (threshold met!)
Hour 24: Timelock expires
Hour 24+: You can execute withdrawal
```

## Duress PIN (Emergency Lock)

If you're being forced to make a withdrawal:

1. Go to any withdrawal screen
2. Enter your **duress PIN** instead of completing withdrawal
3. Vault locks immediately
4. All pending withdrawals cancelled
5. Guardians notified silently

<Warning>
  The duress PIN:

  * Looks like a normal transaction to an attacker
  * Locks your vault completely
  * Alerts your guardians through secure channels
  * Requires guardian recovery to unlock
</Warning>

### Recovery After Lock

If your vault is locked (either by duress PIN or guardian action):

1. Guardians must initiate recovery
2. Majority of guardians must approve
3. Waiting period for recovery
4. New owner address can be set if needed

## Best Practices

<AccordionGroup>
  <Accordion title="Choose the Right Daily Limit" icon="scale-balanced">
    Set it to cover typical daily needs, but low enough to limit theft impact.
  </Accordion>

  <Accordion title="Test the System" icon="flask">
    Do a small withdrawal to make sure everything works before depositing large amounts.
  </Accordion>

  <Accordion title="Communicate with Guardians" icon="comments">
    Make sure your guardians know:

    * They're your guardians
    * How to approve withdrawals
    * How to reach you for verification
  </Accordion>

  <Accordion title="Memorize Your Duress PIN" icon="brain">
    Keep it in your head only. Don't write it down digitally.
  </Accordion>

  <Accordion title="Review Regularly" icon="calendar-check">
    Check your guardian list and settings periodically.
  </Accordion>
</AccordionGroup>

## Configuration Examples

### Casual User

```
Daily Limit: $100
Timelock: 24 hours
Guardians: 2
Required: 1-of-2
```

### Moderate Holdings

```
Daily Limit: $200
Timelock: 48 hours
Guardians: 3
Required: 2-of-3
```

### High Security

```
Daily Limit: $50
Timelock: 7 days
Guardians: 3
Required: 2-of-3
```

## FAQ

<AccordionGroup>
  <Accordion title="What if I forget my duress PIN?">
    You can reset it through a guardian-approved process.
  </Accordion>

  <Accordion title="Can I change settings later?">
    Yes. Changes to security settings require guardian approval.
  </Accordion>

  <Accordion title="What if all my guardians are unavailable?">
    Keep multiple guardians in different locations/circles. Emergency procedures exist for extreme cases.
  </Accordion>

  <Accordion title="Is there a fee for Social Vault?">
    Creating and using Social Vault only costs gas fees on BASE (minimal).
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Add More Guardians" icon="users" href="/guides/users/add-guardians">
    Strengthen your security
  </Card>

  <Card title="Social Vault Technical" icon="file-contract" href="/smart-contracts/social-vault">
    How it works technically
  </Card>
</CardGroup>