# کیف پول نقدی و اتصال والت عمومی

تفاوت موجودی ثبت‌شده، آدرس تأییدشده و امکان انتقال وجه.

وضعیت: نیازمند پیکربندی | مخاطب: کاربران دارای حساب
بازبینی مستندات: ۲۰۲۶/۰۹/۲۴ · ۲ مهر ۱۴۰۵

## موجودی نقدی واحد

موجودی نقدی جدید با واحد ریال صحیح ثبت می‌شود؛ رکوردهای قدیمی تومان حفظ و برای نمایش فقط یک‌بار در مجموع منظور می‌شوند. هر تومان ده ریال است. موجودی کل، قفل‌شده و قابل‌استفاده جدا نمایش داده می‌شوند.

شروع یک حساب جدید با موقعیت صفر ریالی، اعتبار رایگان یا شارژ واقعی ایجاد نمی‌کند. نبود رکورد معتبر با صفر یکسان نیست و رابط نباید ارزش توکن پروژه را پول نقد تلقی کند.

## شارژ و برداشت امروز

صفحهٔ شارژ، مبلغ و سابقهٔ خصوصی پرداخت را نمایش می‌دهد. API تاریخچه اکنون enabled:false و provider:null برمی‌گرداند. ارسال مبلغ معتبر هنوز پاسخ 503 دارد و نه درخواست پرداخت، نه هدایت درگاه و نه تغییر موجودی ایجاد می‌کند.

پایهٔ دفتر پرداخت و اعتباردهی یک‌باره در پایگاه داده طراحی شده است، اما آداپتور درگاه، تأیید مستقل پرداخت، تطبیق مالی، برداشت و بازپرداخت به سرویس عملیاتی نیاز دارند.

## اتصال آدرس عمومی

MetaMask، Trust Wallet و والت‌های تزریقی استاندارد EVM از رابط قابل انتخاب‌اند. اتصال QR از WalletConnect به شناسهٔ پروژهٔ معتبر و تنظیم دامنه نیاز دارد. کاربر باید وارد حساب باشد و پیام اتصال را در والت تأیید کند.

سرور پیام EIP-4361 محدود به حساب و دامنه می‌سازد و امضای شخصی را بررسی می‌کند. پیام پنج دقیقه اعتبار دارد و استفادهٔ مجدد یا امضای نامنطبق رد می‌شود. حداکثر ده والت عمومی برای هر حساب تعریف شده است.

## اتصال آدرس چه مجوزی نمی‌دهد؟

ثبت آدرس، موجودی زنجیره را خودکار وارد دفتر حساب نمی‌کند و مجوز خرج توکن، انتقال وجه یا ایجاد تراکنش نیست. عبارت بازیابی یا کلید خصوصی دریافت نمی‌شود. نشست موقت QR پس از پایان جریان بسته می‌شود؛ آدرس تأییدشده می‌تواند در حساب بماند.

ثبت نتیجهٔ صدور دارایی در کیف پول داخلی، مسیر جداگانهٔ پروندهٔ توکنایزیشن است و به نصب مهاجرت و فعال‌سازی سرویس بررسی رسید نیاز دارد. اعتبارسنجی قراردادهای EIP-1271، شبکه‌های غیر EVM و نمایه‌سازی خودکار موجودی از آدرس متصل در این جریان فعال نیستند.

## حساب بانکی و آدرس والت

حساب بانکی و والت در بخش /account/banks کنار هم مدیریت می‌شوند، اما تأیید آدرس والت با تطبیق شبا و کد ملی متفاوت است. ثبت هرکدام شواهد و مسیر مستقل دارد.

سوابق شارژ و آدرس‌ها خصوصی‌اند و از نشست همان کاربر خوانده می‌شوند. هیچ مجوز عمومی برای ویرایش مستقیم موجودی از این APIها وجود ندارد.

## مراجع پیاده‌سازی

- components/public-wallet-connect.tsx
- components/cash-wallet.tsx
- lib/cash-wallet.ts
- app/api/deposits/route.ts
- app/api/wallet-connect/route.ts
- supabase/functions/_shared/wallet-link.ts
- supabase/migrations/202609080006_public_wallets.sql
- PUBLIC_WALLETS.md
- CASH_WALLET.md