Visual Guide - Sead SimpleSDK

🏗️ System Architecture

Complete System Overview

Your Wallet

Frontend integration with SimpleSDK bundle

Client-Side Crypto

All encryption happens locally

Sead API

Quota and payment management only

📦 SDK Bundle Composition (1.1MB)

Crypto Libraries - Encryption Tools

Secret Sharing - Split & Recover

QR Generator - QR Creation

API Client - Backend Calls

BIP39 Validator - Seed Validation

🔄 Data Flow Diagrams

Complete Backup & Restore Sequence

⚠️ Important: Seed phrase NEVER leaves your device!

All cryptographic operations happen locally in the browser.

API Communication Pattern

✅ What IS Sent

• User ID (anonymous hash)
• API Key for authentication
• Quota check requests
• Payment proofs (if required)

❌ What is NEVER Sent

• Seed phrases
• Private keys
• Share contents
• Passwords

🔒 Security Model

Security Boundaries

🛡️ Threat Protection

Protected Against

Single Point Failure

Secret splitting prevents total loss

Server Compromise

Client-side crypto protects secrets

Network Interception

TLS + no secrets transmitted

Security Features

256-bit Encryption

AES-256-GCM for optional passwords

Secret Sharing

Cryptographically secure splitting

Zero Knowledge

Server never sees your secrets

👤 User Journey Maps

First-Time User Backup Journey

Open Wallet

User sees backup prompt

Choose Settings

Select shares (3) and threshold (2)

Optional Password

Add extra encryption layer

Generate Shares

Create QR codes locally

Save Shares

Store in different locations

✓

Backup Complete!

Wallet is now recoverable

Recovery Journey

📱

Lost Device

User needs to restore wallet

🔍

Gather Shares

Collect minimum threshold

✅

Restore Success

Wallet fully recovered

💰 Payment Flows

Quota System Overview

🏢 Wallet Level

• 25,000 free backups per partner
• 180-day free period from registration
• Configurable per partner
• Shared across all users

👤 User Level

• 3 free backups per user
• Anonymous user tracking
• Per-device fingerprint
• Resets never

Payment Decision Flow

Backup Request → Check Wallet Quota

Has Quota ✓

Check user quota → Proceed

No Quota

Check free period → Payment

Payment Required

• Show payment UI

• Process transaction

• Submit proof

🎯 Integration Patterns

Automatic Backup on Creation

1 Create new wallet
2 Generate seed phrase
3 Auto-trigger backup
4 Show QR codes
✓ Confirm saved

Periodic Backup Reminders

Never backed up

Show urgent alert

> 30 days old

Show reminder

< 30 days old

No action needed

Multi-Wallet Management

Wallet 1 Backed up

Wallet 2 Not backed up

Wallet 3 Outdated

Import Flow Integration

Import seed phrase

Validate BIP39

Prompt for backup

Generate shares

Display QR codes

📱 UI/UX Guidelines

Mobile-First Design

🔐 Backup Wallet

Main Screen

QR Code Display

Save Actions

Desktop Layout

Configuration

Total Shares: 3

Threshold: 2

Password: ***

QR Codes

Instructions

1. Save each QR
2. Store separately
3. Test restore

Visual Status Indicators

✅

Success

⚠️

Warning

❌

Error

ℹ️

Information