# StablePro Wallet - Waitlist Widget Integration Guide

This document provides instructions for integrating the StablePro Wallet waitlist widget on external websites.

## Overview

The waitlist widget allows users to sign up for the StablePro Wallet waitlist from any website. The widget communicates with our API at `https://wl.stableprowallet.io` using CORS (Cross-Origin Resource Sharing).

**Key Points:**
- Works on any domain (cross-origin support)
- No server-side code required on your website
- Email validation handled automatically
- Validation emails sent from our servers

---

## Integration of Widget 


### API Client (Custom UI)

If you want to keep your own form design, use our lightweight API client:

```html
<script src="https://wl.stableprowallet.io/api-client.js"></script>
```


```html
<form id="myWaitlistForm">
  <input type="email" name="email" placeholder="Enter your email" required>
  <button type="submit">Join Waitlist</button>
</form>
<div id="myMessage"></div>

<script src="https://wl.stableprowallet.io/api-client.js"></script>
<script>
  StableProAPI.attachToForm('#myWaitlistForm', {
    emailSelector: 'input[type="email"]',
    messageSelector: '#myMessage',
    loadingText: 'Submitting...',
    onSuccess: function(email, result) {
      // Handle success
      console.log('Signed up:', email);
    },
    onError: function(error) {
      // Handle error
      console.error('Error:', error.message);
    }
  });
</script>
```


---

# CORS Configuration

To use this widget on your domain, your domain must be whitelisted. The following domains are pre-approved:

- `https://stableprowallet.io`
- `https://www.stableprowallet.io`
- `https://stableprotocol.io`
- `https://www.stableprotocol.io`


---

## User Flow

1. User enters email on your website
2. API validates email and creates pending record
3. Validation email sent to user (from `noreply@stableprowallet.io`)
4. User clicks link in email: `https://wl.stableprowallet.io/validate.php?token=...&email=...`
5. User sees confirmation page and is redirected back to main site

---