pwap/docs/presale/PRESALE_TESTING.md

# Presale System Testing Checklist

## Test Environment Setup
- [ ] Runtime compiled with presale pallet
- [ ] Frontend build successful
- [ ] Dev node running
- [ ] Test accounts with wUSDT funded

## Pallet Tests (Backend)

### 1. Start Presale
- [ ] Only sudo can start presale
- [ ] PresaleActive storage updated to true
- [ ] PresaleStartBlock recorded
- [ ] PresaleStarted event emitted
- [ ] Cannot start if already started

### 2. Contribute
- [ ] User can contribute wUSDT
- [ ] wUSDT transferred from user to treasury
- [ ] Contribution recorded in Contributions storage
- [ ] Contributor added to Contributors list (first time)
- [ ] TotalRaised incremented correctly
- [ ] Contributed event emitted
- [ ] Cannot contribute zero amount
- [ ] Cannot contribute if presale not active
- [ ] Cannot contribute if presale ended
- [ ] Cannot contribute if paused

### 3. Finalize Presale
- [ ] Only sudo can finalize
- [ ] Cannot finalize before presale ends
- [ ] PEZ distributed to all contributors
- [ ] Distribution calculation correct (1 wUSDT = 20 PEZ)
- [ ] Decimal conversion correct (wUSDT 6 decimals → PEZ 12 decimals)
- [ ] PresaleActive set to false
- [ ] PresaleFinalized event emitted
- [ ] Distributed events for each contributor

### 4. Emergency Functions
- [ ] Only sudo can pause
- [ ] Paused flag prevents contributions
- [ ] Only sudo can unpause
- [ ] EmergencyPaused/Unpaused events emitted

### 5. Edge Cases
- [ ] Multiple contributions from same user accumulate
- [ ] Large numbers don't overflow
- [ ] Contributors list doesn't exceed MaxContributors
- [ ] Treasury has sufficient PEZ for distribution

## Frontend Tests (UI)

### 1. Pre-Sale Not Started
- [ ] Shows "not started" message
- [ ] Displays pre-sale details (duration, rate, token)
- [ ] No contribution form visible

### 2. Pre-Sale Active
- [ ] Stats grid displays:
  - [ ] Time remaining (countdown)
  - [ ] Total raised (in USDT)
  - [ ] Contributors count
  - [ ] User's contribution
- [ ] Progress bar shows percentage
- [ ] Conversion rate displays correctly (1 wUSDT = 20 PEZ)

### 3. Contribution Form
- [ ] Wallet connection required
- [ ] wUSDT balance displayed
- [ ] Amount input validation
- [ ] PEZ calculation preview (amount × 20)
- [ ] Submit button disabled when:
  - [ ] No wallet connected
  - [ ] No amount entered
  - [ ] Presale paused
  - [ ] Loading state
- [ ] Success toast on contribution
- [ ] Error toast on failure
- [ ] Balance warning if insufficient wUSDT

### 4. Paused State
- [ ] Yellow alert banner shows
- [ ] Contribution disabled
- [ ] Message: "temporarily paused"

### 5. Real-time Updates
- [ ] Data refreshes every 10 seconds
- [ ] Countdown updates
- [ ] Stats update after contribution
- [ ] No memory leaks (interval cleanup)

## Integration Tests

### 1. End-to-End Flow
- [ ] User bridges USDT to wUSDT
- [ ] Connects wallet to presale page
- [ ] Enters contribution amount
- [ ] Transaction signed and submitted
- [ ] Contribution recorded on-chain
- [ ] UI updates with new values
- [ ] After 45 days, receives PEZ

### 2. Multi-User Scenario
- [ ] Multiple users contribute
- [ ] Contributors count increases
- [ ] Total raised accumulates
- [ ] Each user sees own contribution
- [ ] Finalization distributes to all

### 3. Error Scenarios
- [ ] Insufficient wUSDT balance → error toast
- [ ] Network error → retry mechanism
- [ ] Transaction rejected → graceful failure
- [ ] Invalid amount → validation error

## Performance Tests

- [ ] Load time acceptable (<3s)
- [ ] Transaction completion time (<30s)
- [ ] Query performance with 1000+ contributors
- [ ] Frontend responsive on mobile
- [ ] No console errors
- [ ] Build size reasonable

## Security Checks

- [ ] Only root can start/finalize/pause
- [ ] Users can't withdraw contributed wUSDT
- [ ] PEZ distribution only after 45 days
- [ ] No integer overflow in calculations
- [ ] Treasury account properly secured
- [ ] Events emitted for audit trail

## Documentation

- [ ] README explains presale process
- [ ] User guide for participation
- [ ] Admin guide for starting/finalizing
- [ ] API documentation for extrinsics
- [ ] Frontend component documentation

## Deployment Checklist

- [ ] Runtime upgrade tested on testnet
- [ ] Frontend deployed to staging
- [ ] Conversion rate confirmed (20x)
- [ ] Treasury pre-funded with PEZ
- [ ] Monitoring alerts configured
- [ ] Backup plan for emergencies

## Known Issues / Limitations

- Mock runtime tests disabled (frame_system compatibility)
- Benchmarks use estimated weights (not real hardware)
- Max 10,000 contributors (MaxContributors limit)

## Test Results

| Test Category | Pass | Fail | Notes |
|--------------|------|------|-------|
| Pallet Logic | TBD  | TBD  |       |
| Frontend UI  | TBD  | TBD  |       |
| Integration  | TBD  | TBD  |       |
| Performance  | TBD  | TBD  |       |
| Security     | TBD  | TBD  |       |

---

**Testing Status**: In Progress
**Last Updated**: 2025-01-20
**Tester**: Claude Code