RITCOIN — DOCUMENTATION

مستندات کامل RITCOIN

ارز داخلی و زیرساخت اقتصادی اکوسیستم RITM — نماد: RTC

۱ · معرفی پروژه

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

RITCOIN در نسخهٔ اولیه یک رمزارز عمومی یا توکن قابل معامله در صرافی‌ها نیست. این پروژه یک سیستم مالی متمرکز، مستقل و قابل توسعه است که مدیریت کامل آن در اختیار زیرساخت مرکزی RITM قرار دارد.

۲ · هویت و مشخصات

۳ · RiTid و کیف پول

هر کاربر هنگام ثبت‌نام یک RiTid یکتا (قالب RIT-XXXXXX) و یک کیف پول RTC می‌گیرد. RiTid قابل جستجو است و برای دریافت RTC از دیگران استفاده می‌شود.

• موجودی RTC و موجودی تومانی، هر دو در یک کیف پول
• تاریخچهٔ کامل تراکنش‌ها و اعلان‌ها
• دریافت با QR و کپی RiTid
• قابلیت مخفی‌کردن موجودی
• پشتیبانی از مقادیر اعشاری (تا ۶ رقم اعشار)
• کیف پول مستقل از محصولات دیگر — با یک حساب در همهٔ اکوسیستم

۴ · انتقال و کارمزد

انتقال RTC بین کاربران با RiTid انجام می‌شود و ۱ درصد کارمزد دارد. کارمزد سمت سرور محاسبه می‌شود و کلاینت هیچ نقشی در محاسبهٔ آن ندارد.

• شناسه یکتای تراکنش، ثبت زمان دقیق، فرستنده و گیرنده
• پردازش اتمیک (Atomic) — تراکنش یا کامل انجام می‌شود یا کلاً نه
• جلوگیری از تراکنش تکراری با کلید Idempotency
• جلوگیری از انتقال بیش از موجودی (قفل سطری هنگام پردازش)
• وضعیت تراکنش و ثبت تاریخچهٔ کامل

۵ · تبدیل RTC ↔ تومان

کاربران هم‌زمان موجودی تومانی هم دارند. تبدیل دوطرفه در نرخ مرجع فعلی انجام می‌شود و ۱ درصد کارمزد دارد.

• RTC → تومان: معادل تومانی منهای ۱٪ به موجودی تومانی اضافه می‌شود
• تومان → RTC: معادل RTC منهای ۱٪ به موجودی RTC اضافه می‌شود
• نرخ مرجع توسط ادمین به‌صورت دستی تعیین می‌شود (مقدار اولیه: ۱۰۰۰ تومان)

۶ · برداشت تومانی

تبدیل موجودی تومانی به «پول واقعی» (برداشت) ۵ درصد کارمزد دارد که از خودِ مبلغ درخواستی کسر میشود؛ باقیمانده به کارت کاربر واریز میشود. برای ثبت درخواست، کاربر باید موارد زیر را وارد کند:

• مبلغ درخواستی (تومان)
• شماره تلفن موبایل — اعتبارسنجی سروری با الگوی 09xxxxxxxxx
• شماره کارت بانکی ۱۶ رقمی — اعتبارسنجی سروری؛ در لیست ادمین فقط ۴ رقم آخر نمایش داده میشود

درخواست‌ها در صف ادمین (پرداخت‌شده / رد‌شده) مدیریت میشوند و هر مرحله در لاگ حسابرسی ثبت میگردد.

۷ · امنیت و Ledger

• Ledger دوطرفهٔ فقطافزودنی — هر تغییر مالی یک ردیف بدهکار/بستانکار متوازن ثبت می‌کند و هیچ‌کس اجازهٔ ویرایش یا حذف آن را ندارد
• موجودی کاربران هرگز با دستور مستقیم تغییر نمی‌کند؛ فقط از عملیات مالی معتبر ناشی می‌شود
• منطق مالی داخل توابع SECURITY DEFINER سمت سرور است — کلاینت فقط فراخوانی می‌کند
• قفل سطری (Row Lock) هنگام انتقال، ضد درخواست‌های هم‌زمان
• گزارش حسابرسی کامل عملیات مدیریتی
• Rate Limiting و کنترل دسترسی مبتنی بر نقش

۸ · بلاکچین

در نسخهٔ اولیه استفاده از بلاکچین ضروری نیست. RITCOIN ارز داخلی اکوسیستم تحت مدیریت RITM است و معماری متمرکز با پایگاه‌دادهٔ امن و Ledger قابل حسابرسی انتخاب منطقی‌تری است. بررسی مهاجرت به بلاکچین در آینده ممکن است ولی جزو الزامات فعلی نیست.

۹ · پنل مدیریت

دسترسی با نام کاربری و رمز اختصاصی. امکانات:

• مشاهدهٔ همهٔ کاربران و کیف پول‌ها (موجودی RTC و تومانی)
• صدور و سوزاندن RTC برای هر کاربر
• فریز یا رفع فریز حساب کاربران
• تعیین دستی نرخ RTC و درصدهای کارمزد
• ارسال پیام همگانی به همهٔ کاربران
• پردازش درخواست‌های برداشت
• صدور و ابطال کلیدهای API
• پایش تراکنش‌ها و گزارش حسابرسی

۱۰ · API برای اتصال اپ‌ها

اپ‌های اکوسیستم RITM (مالک یا اشخاص ثالث تأییدشده) با کلید API صادرشده از پنل مدیریت به هستهٔ RITCOIN متصل می‌شوند. هیچ اپی مستقیماً به موجودی کاربران دسترسی ندارد؛ همه‌چیز از مسیر رسمی هسته عبور می‌کند.

در فاز فعلی، اتصال از طریق توابع هسته انجام می‌شود:

import { createClient } from 'https://cdn.jsdelivr.net/npm/@supabase/supabase-js@2';

const sb = createClient(WALLET_SUPABASE_URL, WALLET_ANON_KEY);

// پرداخت داخل اپ شما (کلید API ادمین باید سمت سرور اپ شما باشد)
const { data } = await sb.rpc('ritcoin_transfer', {
  p_to_ritid: 'RIT-XXXXXX',
  p_amount_units: 2500000,   // 2.5 RTC
  p_note: 'payment for order #42',
  p_idem: 'order-42-idempotency-key'
});

// استعلام موجودی
const me = await sb.rpc('ritcoin_me');

هرگز کلید service-role یا کلیدهای API را در کد فرانت‌اند عمومی قرار ندهید. عملیات مالی اپ شما باید از بک‌اند خودِ اپ به هستهٔ RITCOIN برسد.

نقشهٔ راه فاز بعدی API

• POST /api/v1/transactions/transfer — با هدر X-RTC-API-Key
• GET /api/v1/wallet/balance?ritid=
• Rate Limiting سمت سرور برای هر کلید
• Webhook برای اطلاع‌رسانی تراکنش به اپ‌ها

۱۱ · اقتصاد

ارزش پایه هر RTC هنگام صدور اولیه ۱٬۰۰۰ تومان در نظر گرفته شده و از داخل پنل ادمین قابل تنظیم است؛ هر تغییری با ثبت در حسابرسی اعلام میشود:

• تغییر نرخ RTC ↔ تومان
• صدور (Issue) و سوزاندن (Burn)
• درصدهای کارمزد انتقال و برداشت
• پاداش و کمپین‌های تشویقی (فاز آینده)

سیستم سود یا بازدهی تا زمان طراحی و تأیید مدل اقتصادی و قانونی آن فعال نخواهد شد.

۱۲ · فناوری

هرگونه تغییر در ارزش یا عرضه باید ثبت‌شده، قابل بررسی و تحت کنترل سیاست‌های اقتصادی RITCOIN باشد.

بازگشت به کیف پول