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

# ssUSD Compliance & Regulatory

> Complete guide to StateSet USD compliance, KYC/AML requirements, and regulatory framework

# ssUSD Compliance & Regulatory Guide

StateSet USD (ssUSD) will be issued under the GENIUS Act, making it a federally-regulated stablecoin with comprehensive compliance requirements.

<Warning>
  All ssUSD operations are subject to regulatory compliance. Failure to meet requirements may result in transaction blocks or account restrictions.
</Warning>

## 🏛️ Regulatory Framework

### GENIUS Act Compliance

<CardGroup cols={2}>
  <Card title="Federal Oversight" icon="building-columns">
    Regulated by the Office of the Comptroller of the Currency (OCC)
  </Card>

  <Card title="Criminal Penalties" icon="gavel">
    C-suite executives face criminal liability for misreporting reserves
  </Card>

  <Card title="Monthly Attestations" icon="file-certificate">
    CPA-signed reserve reports published on-chain monthly
  </Card>

  <Card title="Segregated Assets" icon="vault">
    Customer funds held separately from corporate assets
  </Card>
</CardGroup>

### Jurisdictional Coverage

| Region         | Status               | Requirements               |
| -------------- | -------------------- | -------------------------- |
| United States  | ✅ Fully Compliant    | KYC/AML required           |
| European Union | ✅ MiCA Compliant     | KYC/AML required           |
| United Kingdom | ✅ FCA Registered     | Enhanced due diligence     |
| Singapore      | ✅ MAS Licensed       | KYC/AML required           |
| Japan          | ✅ FSA Approved       | Strict wallet requirements |
| Canada         | ✅ FINTRAC Registered | KYC/AML required           |

## 👤 KYC Requirements

### Individual Accounts

```javascript theme={null}
// KYC verification for individuals
const kycResult = await stateset.compliance.verifyIndividual({
  personal_info: {
    first_name: 'John',
    last_name: 'Smith',
    date_of_birth: '1985-06-15',
    ssn_last4: '1234' // US only
  },
  address: {
    street: '123 Main St',
    city: 'San Francisco',
    state: 'CA',
    postal_code: '94105',
    country: 'US'
  },
  documents: {
    id_front: 'base64_encoded_image',
    id_back: 'base64_encoded_image',
    proof_of_address: 'base64_encoded_pdf'
  }
});

if (kycResult.status === 'approved') {
  // Enable ssUSD transactions
  await stateset.accounts.enableStablecoin({
    account_id: kycResult.account_id,
    limits: kycResult.approved_limits
  });
}
```

### Business Accounts

```javascript theme={null}
// Enhanced KYC for businesses
const businessKYC = await stateset.compliance.verifyBusiness({
  business_info: {
    legal_name: 'Acme Corporation',
    dba_name: 'Acme',
    tax_id: '12-3456789',
    formation_date: '2015-01-01',
    business_type: 'corporation'
  },
  beneficial_owners: [
    {
      name: 'Jane Doe',
      ownership_percentage: 51,
      date_of_birth: '1980-01-01',
      ssn_last4: '5678'
    }
  ],
  documents: {
    formation_docs: 'base64_encoded_pdf',
    tax_certificate: 'base64_encoded_pdf',
    bank_statement: 'base64_encoded_pdf'
  }
});
```

## 🛡️ AML Monitoring

### Transaction Screening

```javascript theme={null}
// Real-time transaction monitoring
const screening = await stateset.compliance.screenTransaction({
  from: 'stateset1sender...',
  to: 'stateset1recipient...',
  amount: '50000.00',
  purpose: 'B2B payment'
});

if (screening.risk_level === 'high') {
  // Enhanced review required
  await stateset.compliance.requestEnhancedReview({
    transaction_id: screening.transaction_id,
    reason: screening.risk_factors
  });
}

// Risk levels and actions
switch(screening.risk_level) {
  case 'low':
    // Proceed with transaction
    break;
  case 'medium':
    // May require additional information
    break;
  case 'high':
    // Manual review required
    break;
  case 'blocked':
    // Transaction cannot proceed
    throw new Error('Transaction blocked for compliance');
}
```

### Sanctions Screening

```javascript theme={null}
// Check against sanctions lists
const sanctionsCheck = await stateset.compliance.checkSanctions({
  entities: [
    {
      type: 'individual',
      name: 'John Smith',
      date_of_birth: '1985-06-15',
      nationality: 'US'
    }
  ],
  lists: ['OFAC', 'EU', 'UN', 'UK']
});

// Response
{
  "screening_id": "scr_123",
  "status": "clear",
  "matches": [],
  "lists_checked": ["OFAC_SDN", "EU_SANCTIONS", "UN_SANCTIONS", "UK_SANCTIONS"],
  "timestamp": "2024-06-25T12:00:00Z"
}
```

## 📊 Transaction Limits

### Individual Limits

| Transaction Type | Daily Limit | Monthly Limit | Per Transaction |
| ---------------- | ----------- | ------------- | --------------- |
| Standard         | \$10,000    | \$50,000      | \$5,000         |
| Verified         | \$100,000   | \$500,000     | \$50,000        |
| Premium          | \$1,000,000 | \$10,000,000  | \$500,000       |

### Business Limits

| Business Type | Daily Limit | Monthly Limit | Per Transaction |
| ------------- | ----------- | ------------- | --------------- |
| Startup       | \$50,000    | \$250,000     | \$25,000        |
| SMB           | \$500,000   | \$5,000,000   | \$250,000       |
| Enterprise    | Custom      | Custom        | Custom          |

### Limit Management

```javascript theme={null}
// Check current limits
const limits = await stateset.compliance.getLimits({
  account_id: 'acc_123'
});

// Request limit increase
const increaseRequest = await stateset.compliance.requestLimitIncrease({
  account_id: 'acc_123',
  requested_limits: {
    daily: '500000.00',
    monthly: '5000000.00'
  },
  justification: 'Business growth requiring higher payment volumes',
  supporting_docs: ['bank_statements.pdf', 'financial_projections.pdf']
});
```

## 🚨 Suspicious Activity Reporting

### Automatic SAR Filing

```javascript theme={null}
// System automatically files SARs for suspicious patterns
const sarTriggers = {
  rapid_movement: {
    threshold: '$10000_in_1_hour',
    action: 'auto_file_sar'
  },
  structuring: {
    pattern: 'multiple_9999_transactions',
    action: 'auto_file_sar'
  },
  unusual_pattern: {
    detection: 'ml_anomaly_detection',
    action: 'manual_review'
  }
};

// Manual SAR filing
const sar = await stateset.compliance.fileSAR({
  account_id: 'acc_123',
  transaction_ids: ['tx_456', 'tx_789'],
  suspicious_activity: 'Unusual transaction pattern',
  narrative: 'Customer made 50 transactions of $9,999 each within 24 hours'
});
```

## 🌍 Cross-Border Compliance

### FATF Travel Rule

```javascript theme={null}
// Include required information for cross-border transfers
const crossBorderTransfer = await stateset.stablecoin.transfer({
  amount: '15000.00',
  to: 'stateset1recipient...',
  travel_rule_info: {
    originator: {
      name: 'John Smith',
      account: 'stateset1sender...',
      address: '123 Main St, San Francisco, CA 94105',
      national_id: 'US123456789'
    },
    beneficiary: {
      name: 'Acme Corp',
      account: 'stateset1recipient...',
      address: '456 Business Ave, London, UK'
    }
  }
});
```

### Currency Controls

```javascript theme={null}
// Check country-specific restrictions
const restrictions = await stateset.compliance.checkRestrictions({
  from_country: 'US',
  to_country: 'CN',
  amount: '50000.00',
  purpose: 'trade_payment'
});

if (restrictions.requires_declaration) {
  await stateset.compliance.fileDeclaration({
    type: restrictions.declaration_type,
    amount: '50000.00',
    purpose: 'Import payment for electronics'
  });
}
```

## 📋 Compliance Dashboard

### Real-Time Monitoring

```javascript theme={null}
// Get compliance overview
const dashboard = await stateset.compliance.getDashboard({
  period: '30d'
});

// Response
{
  "compliance_score": 98.5,
  "total_transactions": 15234,
  "flagged_transactions": 23,
  "resolved_flags": 20,
  "pending_reviews": 3,
  "sar_filed": 1,
  "sanctions_hits": 0,
  "kyc_verifications": {
    "total": 234,
    "approved": 225,
    "rejected": 5,
    "pending": 4
  },
  "risk_distribution": {
    "low": 14890,
    "medium": 321,
    "high": 23
  }
}
```

### Audit Trail

```javascript theme={null}
// Export compliance audit trail
const auditTrail = await stateset.compliance.exportAuditTrail({
  start_date: '2024-01-01',
  end_date: '2024-06-30',
  include: ['kyc_decisions', 'transaction_reviews', 'sar_filings'],
  format: 'csv'
});

// Immutable on-chain record
const proof = await stateset.compliance.recordAuditProof({
  period: 'Q2_2024',
  hash: auditTrail.hash,
  attestor: 'chief_compliance_officer'
});
```

## 🔐 Data Privacy

### GDPR Compliance

```javascript theme={null}
// Handle data subject requests
const gdprRequest = await stateset.compliance.processGDPR({
  type: 'access_request',
  subject_id: 'user_123',
  verify_identity: true
});

// Right to be forgotten (with regulatory retention)
const deletion = await stateset.compliance.deletePersonalData({
  subject_id: 'user_123',
  retain_for_compliance: true,
  retention_period: '7_years'
});
```

## 🔗 Resources

<CardGroup cols={2}>
  <Card title="Compliance Policies" icon="book" href="/policies/compliance">
    Detailed compliance procedures
  </Card>

  <Card title="Regulatory Updates" icon="newspaper" href="/compliance/updates">
    Latest regulatory changes
  </Card>

  <Card title="Training Center" icon="graduation-cap" href="/compliance/training">
    Compliance training materials
  </Card>

  <Card title="API Reference" icon="code" href="/api/compliance">
    Compliance API documentation
  </Card>
</CardGroup>
