README.md

---
sdk: gradio
emoji: 🏆
colorFrom: blue
colorTo: blue
pinned: true
sdk_version: 5.49.1
---
# BSC Address Checker + Optional BEP20 Transfer (Gradio Space)

این پروژه یک اپ ساده Gradio است که:
- موجودی BNB (BSC) و ETH (Ethereum) را برای یک آدرس نمایش می‌دهد.
- جستجوی ساده برای دو توکن رایج (BUSD و WETH_BEP20) انجام می‌دهد.
- **اختیاری**: انتقال BEP20 را در شبکه BSC با وارد کردن کلید خصوصی انجام می‌دهد.

## هشدارهای امنیتی
- هرگز کلید خصوصی خود را در یک Space عمومی قرار ندهید.
- اگر می‌خواهید عملیات ارسال را فعال کنید، Space را خصوصی نگه دارید یا اپ را محلی اجرا کنید.
- توصیه می‌شود از Wallet-based signing یا پل‌های امن استفاده کنید.

## Deploy در Hugging Face Spaces
1. ساخت یک Space جدید (Gradio).
2. آپلود فایل‌های `app.py` و `requirements.txt`.
3. تنظیم متغیرهای محیطی (در Settings -> Secrets):
   - `BSC_RPC` (اختیاری; پیش‌فرض: https://bsc-dataseed.binance.org/)
   - `ETH_RPC` (اختیاری)
4. اگر خواستی قابلیت ارسال را ایمن کنی، از Secrets برای قرار دادن `PRIVATE_KEY` استفاده کن، یا بهتر: اجازه نده کاربران کی‌ها را وارد کنند.

## اجرا محلی
1. pip install -r requirements.txt
2. export BSC_RPC=...
3. python app.py