🛠️ Решение проблем (Troubleshooting)¶

Практическое руководство по диагностике и решению типичных проблем на платформе Saga.

Быстрая диагностика¶

Перед тем как паниковать, проверьте эти 5 вещей:

1-минутный чек-лист¶

✓ Интернет работает?
✓ MetaMask подключен?
✓ Правильная сеть (Saga Testnet - 1337)?
✓ Достаточно ETH для gas?
✓ Достаточно USDC для операции?

Если всё ✓ - переходите к разделу с вашей проблемой.

Если есть ✗ - решите это сначала.

🦊 MetaMask проблемы¶

Не могу подключить MetaMask к Saga¶

Симптомы:

Кнопка "Connect Wallet" не реагирует
MetaMask не всплывает при клике
Ошибка "MetaMask not detected"

Диагностика пошагово:

Шаг 1: Проверьте установку MetaMask¶

1. Откройте браузер (Chrome, Firefox, Brave)
2. Проверьте расширения:
   - Chrome: Три точки → More tools → Extensions
   - Firefox: Menu → Add-ons
3. Ищите "MetaMask"
   - ✅ Должен быть установлен и ENABLED
   - ❌ Если нет - установите с metamask.io

Шаг 2: Разблокируйте MetaMask¶

1. Кликните на иконку MetaMask в браузере (лиса)
2. Введите пароль
3. Убедитесь что кошелек разблокирован (видите баланс)

Шаг 3: Обновите страницу¶

F5 или Ctrl+R (Windows/Linux)
Cmd+R (Mac)

Затем снова нажмите "Connect Wallet"

Шаг 4: Проверьте блокировку popup'ов¶

Адресная строка браузера → справа может быть 🚫 иконка
Если есть:
  1. Кликните на иконку
  2. Разрешите popup'ы для saga.surf
  3. Перезагрузите страницу

Шаг 5: Очистите кэш¶

Chrome: Ctrl+Shift+Delete → Очистить кэш
Firefox: Ctrl+Shift+Delete → Очистить кэш

Выберите:
- ✓ Cached images and files
- ✓ Последний час
- Нажмите "Clear data"

Если ничего не помогло:

🔧 Радикальное решение:

1. Выйдите из MetaMask (Lock)
2. Закройте ВСЕ вкладки браузера
3. Полностью закройте браузер
4. Откройте браузер заново
5. Разблокируйте MetaMask
6. Перейдите на app.saga.surf
7. Connect Wallet

Wrong network / Подключен к неправильной сети¶

Симптомы:

"Please connect to Saga Testnet"
"Wrong network detected"
Баланс показывает 0 хотя должны быть средства

Решение (2 минуты):

Вариант 1: Переключитесь вручную¶

1. Откройте MetaMask
2. Вверху видите название сети (например "Ethereum Mainnet")
3. Кликните на название
4. В dropdown найдите "Saga Testnet"
5. Выберите Saga Testnet

Если "Saga Testnet" нет в списке:

Вариант 2: Добавьте сеть¶

1. MetaMask → Клик на сеть
2. Scroll вниз → "Add network"
3. "Add a network manually"
4. Введите данные:

   Network Name: Saga Testnet
   RPC URL: https://faucet.saga.surf/api/blockchain/rpc
   Chain ID: 1337
   Currency Symbol: ETH
   Block Explorer URL: (оставьте пустым)

5. Нажмите "Save"
6. Переключитесь на Saga Testnet

Быстрая проверка правильности сети:

✓ Название: Saga Testnet
✓ Chain ID: 1337
✓ В правом верхнем углу app.saga.surf должна быть зеленая точка

Недостаточно ETH для gas¶

Симптомы:

"Insufficient funds for gas"
Транзакция не отправляется
MetaMask показывает ошибку при approve

Решение:

Шаг 1: Проверьте баланс ETH¶

MetaMask → Assets → ETH

Минимум нужно: 0.005 ETH (~$10)
Рекомендуем: 0.01-0.02 ETH (~$20-40)

Шаг 2: Получите ETH¶

Вариант A: Faucet (для тестирования):

1. Откройте https://faucet.saga.surf
2. Подключите MetaMask
3. Запросите тестовые ETH
4. Подождите 1-2 минуты
5. Проверьте баланс в MetaMask

Вариант B: Покупка на бирже:

1. Binance, Coinbase, Kraken:
   - Купите ETH
   - Выведите на адрес вашего MetaMask

2. ⚠️ ВАЖНО: Выберите правильную сеть
   - Saga Testnet не поддерживается exchanges
   - Купите ETH на Ethereum Mainnet
   - Используйте bridge для перевода в Saga

Вариант C: Bridge из другой сети:

1. Если у вас есть ETH на Ethereum Mainnet
2. Используйте официальный Saga bridge:
   https://bridge.saga.surf
3. Bridge ETH → Saga Testnet
4. Комиссия: ~$5-10

MetaMask зависает / тормозит¶

Симптомы:

MetaMask медленно открывается
Popup'ы появляются с задержкой
Транзакции не отправляются

Диагностика:

Проблема 1: Слишком много аккаунтов¶

Решение:
1. MetaMask → Account icon (круг вверху справа)
2. Settings → Advanced
3. "Reset Account"
4. Подтвердите

⚠️ ЭТО НЕ УДАЛИТ СРЕДСТВА
Просто очистит transaction history

Проблема 2: Старая версия MetaMask¶

Проверка версии:
1. MetaMask → Settings → About
2. Смотрите Version

Должна быть: 11.0+ (2024)
Если меньше - обновите:
  - Chrome: Extensions → Update
  - Firefox: Add-ons → Update

Проблема 3: Конфликт с другими расширениями¶

Диагностика:
1. Откройте браузер в режиме Incognito
2. Включите только MetaMask расширение
3. Попробуйте операцию снова

Если работает:
  - Значит конфликт с другим расширением
  - Отключайте по одному чтобы найти виновника

Радикальное решение: Переустановка¶

⚠️ ТОЛЬКО ЕСЛИ ЕСТЬ BACKUP СЕКРЕТНОЙ ФРАЗЫ!

1. Запишите секретную фразу:
   MetaMask → Settings → Security & Privacy
   → Reveal Secret Recovery Phrase

2. Удалите расширение MetaMask

3. Переустановите с metamask.io

4. Импортируйте кошелек через секретную фразу

Проблемы с транзакциями¶

Транзакция зависла в "Pending"¶

Симптомы:

Транзакция показывает "Pending" больше 10 минут
Нет подтверждения
Баланс не обновился

Диагностика по шагам:

Шаг 1: Проверьте статус в Etherscan¶

1. MetaMask → Activity → Клик на pending транзакцию
2. "View on block explorer" или скопируйте TX hash
3. Откройте https://etherscan.io/
4. Вставьте TX hash

Возможные статусы:
✓ Success - транзакция прошла (обновите Saga страницу)
⏳ Pending - ещё обрабатывается (ждите или Speed Up)
❌ Failed - провалилась (читайте ошибку)
❓ Not found - проблема с отправкой

Шаг 2: Speed Up транзакцию¶

Если Pending > 10 минут:

1. MetaMask → Activity → Pending транзакция
2. Нажмите "Speed Up"
3. Увеличьте gas price:
   - Low → Medium (+50% gas)
   - Medium → High (+100% gas)
4. Confirm

Транзакция пройдет за 1-3 минуты

Шаг 3: Cancel транзакцию¶

Если не хотите ждать:

1. MetaMask → Activity → Pending транзакция
2. Нажмите "Cancel"
3. Подтвердите cancel транзакцию
4. Gas fee ~$1-3 для отмены

⚠️ Средства вернутся на кошелек
Но gas fee за первую транзакцию НЕ вернется

Превентивные меры:

Чтобы избежать зависаний:
✓ Используйте "Medium" или "Fast" gas
✓ Проверяйте gas цены: https://etherscan.io/gastracker
✓ Не транзакции в пиковые часы (США дневное время)
✓ Не отправляйте много транзакций подряд

Транзакция Failed¶

Симптомы:

Красный X в MetaMask
"Transaction failed" уведомление
Средства не ушли с кошелька (кроме gas fee)

Распространенные причины и решения:

Error: "Insufficient funds"¶

Причина: Недостаточно USDC или ETH

Решение:

1. Проверьте балансы:
   MetaMask → Assets
   - USDC: должно быть >= сумме депозита
   - ETH: должно быть >= gas fee (~$2-5)

2. Пополните недостающий токен

3. Повторите операцию

Error: "Execution reverted"¶

Причина: Смарт-контракт отклонил транзакцию

Возможные подпричины:

A. Не сделан Approve:
   Решение: Сначала Approve, потом Stake

B. Slippage слишком низкий:
   Решение: Увеличьте slippage tolerance

C. Недостаточно баланса контракта:
   Решение: Обратитесь в поддержку

D. Контракт на паузе (emergency):
   Решение: Следите за новостями в

Error: "Gas limit too low"¶

Причина: Установлен слишком маленький gas limit

Решение:

1. MetaMask → Advanced gas controls (включите в Settings)
2. При отправке транзакции:
   - Кликните "Advanced"
   - Gas Limit: увеличьте на 20-30%
3. Confirm

Error: "Nonce too high"¶

Причина: Рассинхронизация nonce счетчика

Решение:

1. MetaMask → Settings → Advanced
2. "Reset Account"
3. Подтвердите
4. Отправьте транзакцию заново

⚠️ Это безопасно, средства не потеряются

Общая стратегия для Failed транзакций:

1. Прочитайте ошибку в MetaMask внимательно
2. Исправьте проблему (баланс, approve, gas)
3. Повторите транзакцию
4. Если ошибка повторяется > 3 раз:
   → Email support@saga.surf или создайте GitHub Issue

Очень высокие gas fees¶

Симптомы:

MetaMask показывает $50+ за транзакцию
Gas fee больше чем сумма депозита
"This transaction will cost..."

Причины:

1. Пиковая загруженность сети¶

Диагностика:

Проверьте gas цены: https://etherscan.io/gastracker

Текущий gas price:
- < 50 Gwei: Нормально ✓
- 50-100 Gwei: Выше среднего ⚠️
- 100-200 Gwei: Высокий 🔴
- > 200 Gwei: ОЧЕНЬ высокий 🚨

Решение:

⏰ Подождите более спокойного времени:
  - Ночь по UTC (00:00 - 06:00)
  - Выходные дни
  - Избегайте США рабочих часов

Экономия: 50-80% на gas fees

2. Gas limit слишком высокий¶

Диагностика:

MetaMask popup → "Edit" → "Advanced"

Gas Limit для Saga операций:
- Approve: ~50,000 gas
- Stake: ~100,000 gas
- Unstake: ~80,000 gas

Если видите 500,000+ - что-то не так

Решение:

1. Reject транзакцию
2. MetaMask → Settings → Advanced
   - "Advanced gas controls": ON
3. Отправьте транзакцию снова
4. Edit gas limit вручную:
   - Approve: 60,000
   - Stake: 120,000
   - Unstake: 100,000

3. NFT минт или hot event¶

Диагностика:

Если gas внезапно взлетел:
1. Проверьте Twitter crypto trends
2. Смотрите Etherscan gas tracker

Обычно:
- Популярный NFT минт
- Новый DeFi протокол запуск
- Airdrop claim event

Решение:

⏸️ Просто подождите 1-2 часа
Ажиотаж спадет, gas вернется к норме

Калькулятор gas fees:

Простая формула:
Total Gas Fee = Gas Limit × Gas Price

Пример:
Gas Limit: 100,000
Gas Price: 50 Gwei
Total: 100,000 × 50 = 5,000,000 Gwei = 0.005 ETH ≈ $10

Если видите $50+:
100,000 × 250 Gwei = 25,000,000 Gwei = 0.025 ETH ≈ $50
    ↑ Это НЕ нормально! Подождите.

Оптимизация gas fees:

💡 Лучшие практики:
1. Транзакции в off-peak hours (ночь UTC)
2. Используйте "Low" priority если не спешите
3. Batch операции (1 большой депозит vs 10 маленьких)
4. Approve заранее когда gas низкий
5. Мониторьте gas: https://etherscan.io/gastracker

💵 Проблемы с балансом¶

Баланс не обновляется¶

Симптомы:

Сделали депозит, но баланс показывает 0
Вывели средства, но баланс не уменьшился
Дашборд показывает старые данные

Решения:

Решение 1: Hard refresh страницы¶

Ctrl+Shift+R (Windows/Linux)
Cmd+Shift+R (Mac)

Это принудительно обновит все данные

Решение 2: Проверьте транзакцию¶

1. MetaMask → Activity
2. Найдите вашу транзакцию
3. Кликните → "View on block explorer"
4. Статус должен быть "Success" ✓

Если Pending:
  - Подождите подтверждения
  - Или Speed Up

Если Failed:
  - Баланс ПРАВИЛЬНО показывает 0
  - Транзакция не прошла
  - Нужно повторить

Решение 3: Переподключите кошелек¶

1. app.saga.surf → Disconnect Wallet
2. Закройте вкладку
3. Откройте app.saga.surf заново
4. Connect Wallet
5. Проверьте баланс

Решение 4: Проверьте правильность сети¶

MetaMask → Сеть должна быть "Saga Testnet" (1337)

Если другая сеть:
  - Баланс будет 0 (это нормально!)
  - Переключитесь на Saga Testnet
  - Баланс появится

Если ничего не помогло:

🔍 Детальная проверка:

1. Найдите ваш TX hash в MetaMask
2. Проверьте на Etherscan: успешность
3. Проверьте что адрес правильный
4. Скриншот проблемы
5. Email support@saga.surf или создайте GitHub Issue

Приложите:
- TX hash
- Wallet address
- Скриншот баланса
- Что ожидали vs что видите

Не вижу stUSDC токены в MetaMask¶

Симптомы:

Сделали депозит
Транзакция Success
Но stUSDC не появились в Assets

Это нормально! Нужно добавить токен вручную.

Решение: Import token в MetaMask¶

Для stUSDC5 (стратегия 5%):

1. MetaMask → Assets (внизу)
2. Scroll вниз → "Import tokens"
3. Вкладка "Custom token"
4. Введите данные:

   Token Contract Address:
   0x9fE46736679d2D9a65F0992F2272dE9f3c7fa6e0

   Token Symbol: stUSDC5
   Token Decimal: 18

5. Нажмите "Add Custom Token"
6. Confirm

Для stUSDC10 (стратегия 10%):

Token Contract Address:
0xDc64a140Aa3E981100a9becA4E685f962f0cF6C9

Token Symbol: stUSDC10
Token Decimal: 18

Для stUSDC20 (стратегия 20%):

Token Contract Address:
0x0165878A594ca255338adfa4d48449f69242Eb8F

Token Symbol: stUSDC20
Token Decimal: 18

После добавления:

✓ Токены появятся в Assets
✓ Баланс будет правильный
✓ Можете отслеживать рост стоимости

⚠️ Количество stUSDC НЕ меняется
Только курс обмена растет!

Быстрая проверка:

Ваш депозит: 1,000 USDC
Должны увидеть: 1,000 stUSDC5 (или 10, 20)

Если видите меньше/больше:
  - Проверьте TX hash
  - Курс обмена на момент депозита
  - Или обратитесь в support

Разница между балансом в Saga и MetaMask¶

Симптомы:

app.saga.surf показывает 1,050 USDC
MetaMask показывает 1,000 stUSDC5
Почему разные цифры?

Это НОРМАЛЬНО! Вот почему:

Понимание механизма:¶

MetaMask показывает:
  КОЛИЧЕСТВО stUSDC токенов (не меняется)

Saga Dashboard показывает:
  СТОИМОСТЬ ваших stUSDC в USDC (растет ежедневно)

Пример:
  День 0:   1,000 stUSDC5 × 1.0 = 1,000 USDC (MetaMask vs Saga)
  День 30:  1,000 stUSDC5 × 1.004 = 1,004 USDC
              ↑ MetaMask          ↑ Saga Dashboard

Количество токенов (1,000) НЕ меняется
Курс обмена (1.004) растет ежедневно

Формула пересчета:

USDC Balance = stUSDC количество × Exchange Rate

Проверить Exchange Rate:
1. app.saga.surf → ваша стратегия
2. "Current Exchange Rate: 1.XXXXX"
3. Умножьте ваши stUSDC на этот курс
4. Должно совпасть с балансом в Saga

Практический пример:

Ситуация:
- MetaMask: 1,000 stUSDC10
- Saga Dashboard: 1,025.50 USDC
- Прошло 3 месяца

Проверка:
Exchange Rate (через 3 месяца при 10% APY):
≈ 1.02550

1,000 × 1.02550 = 1,025.50 USDC ✓

Ваш доход: 25.50 USDC (2.55% за 3 месяца)

Если цифры НЕ совпадают:

Проверьте:
1. Правильный ли токен смотрите (stUSDC5 vs 10 vs 20)?
2. Актуальный ли exchange rate (обновите страницу)?
3. Добавлены ли stUSDC токены в MetaMask?

Если все правильно но разница > 1%:
→ Обратитесь в support с деталями

Проблемы со стейкингом¶

Не могу сделать депозит¶

Симптомы:

Кнопка "Deposit" неактивна (серая)
Клик не работает
Ошибка при попытке депозита

Пошаговая диагностика:

Проблема 1: Недостаточно USDC¶

Проверка:
1. MetaMask → Assets → USDC
2. Баланс должен быть >= сумме депозита

Минимум: 100 USDC
Рекомендуем: 500+ USDC

Если недостаточно:
→ Купите USDC на бирже
→ Или используйте faucet для тестирования

Проблема 2: USDC не добавлен в MetaMask¶

Если не видите USDC в Assets:

1. MetaMask → Assets → "Import tokens"
2. Custom token:

   Contract Address:
   0x5FbDB2315678afecb367f032d93F642f64180aa3

   Symbol: USDC
   Decimals: 6

3. Add Custom Token

Проблема 3: Approve не сделан¶

Первый депозит требует Approve:

Процесс:
1. Нажмите "Deposit"
2. ПЕРВАЯ транзакция: Approve
   - MetaMask popup → Confirm
   - Подождите ~1 минуту
3. ВТОРАЯ транзакция: Stake
   - MetaMask popup → Confirm
   - Подождите ~1-2 минуты
4. Success!

Последующие депозиты:
- Approve НЕ нужен (уже сделан)
- Только одна транзакция (Stake)

Проблема 4: Недостаточно ETH для gas¶

Проверка:
MetaMask → Assets → ETH
Должно быть: минимум 0.005 ETH (~$10)

Если меньше:
→ Получите ETH через faucet
→ Или купите на бирже

Проблема 5: Неправильная сеть¶

app.saga.surf должен показывать зеленую точку вверху справа

Если красная:
1. MetaMask → переключитесь на Saga Testnet (1337)
2. Обновите страницу (F5)
3. Попробуйте депозит снова

Checklist перед депозитом:

✓ Подключен к Saga Testnet (1337)
✓ USDC баланс >= сумме депозита
✓ ETH баланс >= 0.005 ETH
✓ MetaMask разблокирован
✓ Интернет стабильный

Не могу вывести средства¶

Симптомы:

Кнопка "Withdraw" неактивна
Ошибка при попытке вывода
Транзакция Unstake fails

Диагностика:

Проблема 1: Недостаточно stUSDC¶

Проверка:
1. app.saga.surf → ваша стратегия → баланс
2. Или MetaMask → Assets → stUSDC5/10/20

Убедитесь что:
  Баланс stUSDC >= сумме вывода

Если видите 0:
  - Проверьте что токен добавлен в MetaMask
  - Проверьте правильную стратегию
  - Проверьте правильную сеть

Проблема 2: Approve unstake не сделан¶

Первый вывод требует Approve:

Процесс:
1. Нажмите "Withdraw"
2. ПЕРВАЯ транзакция: Approve Unstake
   - Разрешаете контракту сжечь ваши stUSDC
   - Confirm в MetaMask
3. ВТОРАЯ транзакция: Unstake
   - Фактический вывод
   - Confirm в MetaMask
4. USDC вернутся на кошелек

Последующие выводы:
  - Approve unstake уже сделан
  - Только транзакция Unstake

Проблема 3: Недостаточно ETH для gas¶

Вывод требует gas для двух транзакций:
  1. Approve unstake: ~50,000 gas
  2. Unstake: ~80,000 gas

Итого: ~130,000 gas ≈ $3-5

Проверьте ETH баланс:
  MetaMask → Assets → ETH
  Должно быть: минимум 0.01 ETH

Проблема 4: Контракт на паузе (редко)¶

В emergency ситуациях контракт может быть поставлен на паузу

Проверка:
1. 2. app.saga.surf → banner с уведомлением

Если контракт на паузе:
  - Подождите официального объявления
  - Средства в безопасности
  - Вывод возобновится после исправления

Emergency вывод:

Если есть критическая необходимость:

1. Email: security@saga.surf (критические проблемы)
2. Email: support@saga.surf (общие вопросы)

Опишите:
  - Wallet address
  - Сумму для вывода
  - Причину срочности

Exchange rate не обновляется¶

Симптомы:

Exchange rate показывает то же значение неделю
Баланс не растет
Нет начисления процентов

Это может быть нормально! Вот почему:

Причина 1: Проценты начисляются ночью¶

Обновление exchange rate происходит:
  Ежедневно в 00:00 UTC

Если смотрите днем:
  - Курс обновится ночью
  - Баланс увеличится утром (по UTC)

Проверьте завтра утром!

Причина 2: Слишком маленькая сумма¶

Если депозит очень маленький (< 100 USDC):
  Дневное начисление может быть < $0.01
  Округление может скрыть изменение

Пример:
  50 USDC × 5% APY / 365 дней = $0.0068 в день
  Может показывать как $0.00 из-за округления

Подождите неделю - увидите изменение

Причина 3: Кэш браузера¶

Решение:
1. Ctrl+Shift+R (hard refresh)
2. Или очистите кэш
3. Переподключите кошелек
4. Проверьте exchange rate снова

Проблема 4: Реальная проблема контракта¶

Если exchange rate НЕ обновлялся > 48 часов:

1. Проверьте 
2. Email support@saga.surf

Если это баг:
  - Команда уже работает над исправлением
  - Ваши средства в безопасности
  - Начисления догонят пропущенные дни

Как проверить правильность начислений:

Формула дневного роста:
Daily Rate = (1 + APY)^(1/365) - 1

Для 10% APY:
(1.10)^(1/365) - 1 = 0.000261 (0.0261% в день)

Проверка:
Exchange Rate сегодня - Exchange Rate вчера
Должно быть ≈ 0.0261% от текущего курса

Если совпадает ± 0.01%:
  → Всё работает правильно ✓

Проблемы с сайтом¶

Сайт не загружается¶

Симптомы:

"Site can't be reached"
"Connection timed out"
Пустая страница

Решения:

Шаг 1: Проверьте интернет¶

Простая проверка:
1. Откройте google.com
2. Откройте twitter.com
3. Если работают - интернет OK

Если не работают:
→ Проблема с вашим интернетом
→ Перезагрузите роутер
→ Проверьте Wi-Fi подключение

Шаг 2: Проверьте правильность URL¶

Правильные адреса:
✓ https://saga.surf
✓ https://app.saga.surf
✓ https://docs.saga.surf

Неправильные (scam):
❌ saga.com
❌ saga.io
❌ saga-defi.com
❌ sagas.surf

Всегда проверяйте URL!

Шаг 3: Попробуйте другой браузер¶

Если Safari не работает:
→ Попробуйте Chrome
→ Попробуйте Firefox
→ Попробуйте Brave

Часто это решает проблему

Шаг 4: Очистите кэш и cookies¶

Chrome:
Ctrl+Shift+Delete → Last hour → Clear data

Firefox:
Ctrl+Shift+Delete → Last hour → Clear

Safari:
Cmd+Option+E (Empty caches)

Шаг 5: Проверьте статус Saga¶

Status page: https://status.saga.surf

Смотрите:
- ✅ All systems operational
- ⚠️ Partial outage (некоторые проблемы)
- 🔴 Major outage (сайт down)

Если down:
  - Подождите восстановления
  - Следите за 
  - Проверьте GitHub Issues

Если ничего не помогает:

🔍 Дополнительная диагностика:

1. Проверьте firewall/antivirus
   - Временно отключите
   - Попробуйте загрузить сайт

2. Попробуйте VPN
   - Иногда ISP блокирует крипто сайты
   - VPN может помочь

3. Попробуйте мобильный интернет
   - Hotspot с телефона
   - Если работает - проблема с Wi-Fi

Баланс показывает $0 / данные не загружаются¶

Симптомы:

Dashboard показывает все нули
"Loading..." бесконечно
Стратегии не отображаются

Решения:

Проблема 1: Кошелек не подключен¶

Проверка:
Правый верхний угол app.saga.surf

Должно быть:
✓ "0x1234...5678" (ваш адрес)
✓ Зеленая точка (правильная сеть)

Если "Connect Wallet":
1. Нажмите "Connect Wallet"
2. Выберите MetaMask
3. Approve подключение
4. Данные загрузятся

Проблема 2: Неправильная сеть¶

Проверка:
Красная точка вверху справа = wrong network

Решение:
1. MetaMask → переключитесь на Saga Testnet (1337)
2. Обновите страницу (F5)
3. Баланс загрузится

Проблема 3: RPC node проблемы¶

Иногда RPC node может быть недоступен

Решение:
1. MetaMask → Settings → Networks
2. Saga Testnet → Edit
3. Попробуйте альтернативные RPC:

   Primary:
   https://faucet.saga.surf/api/blockchain/rpc

   Fallback (если не работает):
   http://188.42.218.164:8545

4. Save и перезагрузите страницу

Проблема 4: Browser extension конфликт¶

Диагностика:
1. Откройте Incognito mode
2. Установите только MetaMask
3. Попробуйте app.saga.surf

Если работает:
  → Конфликт с другим расширением
  → Отключайте по одному

Типичные виновники:
  - AdBlockers
  - Privacy Badger
  - Другие crypto кошельки

Проблемы безопасности¶

Подозрение на компрометацию кошелька¶

Симптомы:

Неизвестные транзакции в истории
Баланс уменьшился без вашего участия
Кто-то получил доступ к секретной фразе

НЕМЕДЛЕННЫЕ ДЕЙСТВИЯ:

ШАГ 1: НЕ ПАНИКУЙТЕ, ДЕЙСТВУЙТЕ БЫСТРО¶

⏱️ У вас есть минуты для спасения средств!

1. НЕ закрывайте MetaMask
2. НЕ выключайте компьютер
3. Следуйте инструкциям ниже

ШАГ 2: Создайте новый безопасный кошелек¶

1. Откройте ДРУГОЙ браузер (не тот где MetaMask)
2. Установите MetaMask заново
3. Создайте НОВЫЙ кошелек
4. Запишите секретную фразу НАДЕЖНО
5. Скопируйте адрес нового кошелька

ШАГ 3: Переведите ВСЕ средства¶

Из скомпрометированного кошелька:

1. Выведите все stUSDC:
   app.saga.surf → Withdraw → Max → новый адрес

2. Переведите все USDC:
   MetaMask → Send → новый адрес → Max

3. Переведите все другие токены

4. Оставьте минимум ETH для gas

⚠️ Делайте быстро! Атакующий может опередить

ШАГ 4: Уведомите команду¶

Сразу после перевода средств:

Email: security@saga.surf

Предоставьте:
- Скомпрометированный адрес
- Новый безопасный адрес
- TX hashes подозрительных транзакций
- Как произошла компрометация (если знаете)

ШАГ 5: Ревизия безопасности¶

После спасения средств:

1. Смените все пароли:
   - Email
   - Биржи
   - Twitter

2. Проверьте компьютер:
   - Антивирус scan
   - Malware scan (Malwarebytes)
   - Проверьте browser extensions

3. Включите 2FA везде где можно

4. НИКОГДА больше не используйте старый кошелек

Как компрометация происходит (избегайте):

❌ Фишинг сайты:
   saga-defi.com вместо saga.surf
   Всегда проверяйте URL!

❌ Вредоносные расширения:
   Fake MetaMask extensions
   Устанавливайте только с официальных сайтов

❌ Скриншоты секретной фразы:
   Хранятся в облаке → хакеры крадут
   Только бумага!

❌ Подозрительные DApps:
   Approve unlimited permissions
   Проверяйте что approve'ите

❌ Публичный Wi-Fi:
   MITM атаки
   Используйте VPN

🎣 Как распознать фишинг¶

Распространенные схемы:

Схема 1: Fake support в DM¶

Атакующий пишет:
"Привет, я из Saga support. Видим у вас проблемы.
Отправьте секретную фразу для проверки."

🚨 ЭТО SCAM!

Saga НИКОГДА:
❌ Не пишет первыми в DM
❌ Не просит секретные фразы
❌ Не просит private keys
❌ Не просит переводы на личные адреса

Схема 2: Fake сайты¶

Атакующие создают клоны:
❌ saga-defi.com
❌ sagas.surf
❌ saga.io
❌ app-saga.surf

Настоящие сайты:
✓ saga.surf
✓ app.saga.surf
✓ docs.saga.surf

ВСЕГДА проверяйте URL!
Добавьте в закладки официальные сайты

Схема 3: Airdrop scams¶

"Congratulations! Claim 1000 SAGA tokens"
"Limited time: connect wallet to claim"

🚨 ЭТО SCAM!

Saga:
✓ Объявляет airdrops в официальных каналах
✓ Никогда не просит "urgent action"
✓ Не требует unlimited approvals

Схема 4: Fake support emails¶

Атакующие могут подделывать email:
❌ support@saga-defi.com
❌ security@sagafinance.io

Настоящие адреса:
✓ support@saga.surf
✓ security@saga.surf

Проверяйте:
- Домен ВСЕГДА .surf
- Отправитель в email headers
- Подозрительные запросы

Защита от фишинга:

✓ Проверяйте URL ВСЕГДА
✓ Bookmark официальные сайты
✓ Не кликайте случайные ссылки в email
✓ Проверяйте домены (только .surf)
✓ Включите 2FA везде
✓ Никому НИКОГДА не давайте секретную фразу

📞 Когда обращаться в поддержку¶

Обращайтесь если:

✅ Технические проблемы: - Транзакция stuck > 1 часа - Баланс неправильный после success транзакции - Exchange rate не обновляется > 48 часов - Контракт ошибки которые не понимаете

✅ Безопасность: - Подозрение на баг в контракте - Подозрительная активность кошелька - Потенциальный exploit

✅ Финансовые расхождения: - Средства пропали после транзакции - Неправильные начисления - Проблемы с выводом

НЕ обращайтесь если:

❌ Типичные вопросы: - "Как сделать депозит?" → Getting Started - "Какая лучшая стратегия?" → Staking Guide - "Что такое gas fees?" → FAQ

❌ Проблемы которые вы можете решить сами: - MetaMask не подключается → перезагрузите браузер - Pending транзакция → Speed Up или Cancel - Неправильная сеть → переключитесь на Saga Testnet

Дополнительные ресурсы¶

Документация:

Getting Started Guide - базовая настройка
Staking Guide - детали стейкинга
FAQ - частые вопросы
DeFi Basics - обучение DeFi

Поддержка:

📧 Email: support@saga.surf
🐦
💻 GitHub Issues: Bug reports

Статус системы:

📊 Status Page: status.saga.surf
🔍 Blockchain Explorer: etherscan.io

Помните: Большинство проблем решаются простой перезагрузкой браузера или переподключением кошелька. Не паникуйте - ваши средства в безопасности в блокчейне! 🔒

👉 Вернуться в приложение Saga