سازمان، کیف پول و آدرس

این چند کلمه در همه‌ی API تکرار می‌شوند.

سازمان
└── کیف پول
    ├── آدرس اصلی
    ├── آدرس جمع‌آوری (sweep)
    └── گروه آدرس (مثلاً users)
        └── آدرس واریز هر کاربر

سازمان حساب صرافی شما در روموست. اعضا، قانون‌ها و کلیدهای API مال سازمان هستند.

کیف پول جایی است که دارایی‌ها در آن نگه داشته می‌شوند. پیش از کار کردن این وضعیت‌ها را می‌گذراند:

status	یعنی
keygen	کیف پول در حال ساخته شدن است
awaiting_backup_confirmation	باید پشتیبان گرفته و تأیید شود
active	آماده است
frozen	قفل شده. با پیشنهاد مدیر و ذکر دلیل دوباره باز می‌شود
retired	دیگر استفاده نمی‌شود

شبکه. هر کیف پول روی یک یا چند شبکه کار می‌کند. پاسخ GET /v1/wallets همه‌ی آن‌ها را با آدرس هر کدام در networks می‌دهد. شبکه‌ی تازه کمی طول می‌کشد تا آماده شود. تا آن موقع readiness آن preparing است، آدرس ندارد و برداشت روی آن رد می‌شود.

آدرس. نوع هر آدرس در kind می‌آید:

kind	کارش	چه کسی می‌سازد
main	آدرس اصلی کیف پول	خودکار
deposit	آدرس واریز هر کاربر	API یا کنسول
sweep	جایی که واریزها جمع می‌شوند	خودکار یا کنسول
fee	ایستگاه کارمزد	خودکار

گروه آدرس برای دسته‌بندی است. قانون جمع‌آوری پول روی گروه نوشته می‌شود. گروهی که قانون ندارد جمع نمی‌شود.

نام دارایی‌ها

هر دارایی یک نام دارد: نام شبکه و نماد با هم، مثل TRON_USDT یا BSC_USDT⁠. همین نام همه‌جا به کار می‌رود: برداشت، واریز، موجودی، فیلترها و Webhook.

همه‌ی دارایی‌ها در دارایی‌های پشتیبانی‌شده هستند.

کلید API

هر کلید فقط کارهایی را می‌تواند که به او داده‌اید: کدام دسترسی، کدام کیف پول و از کدام IP.

دسترسی	چه کاری
read	دیدن کیف پول، تراکنش، واریز، آدرس و مصرف
withdraw	ثبت و لغو برداشت
approve-read	دیدن وضعیت تأییدها
addresses	ساختن و مدیریت آدرس واریز
sweep	نوشتن قانون جمع‌آوری پول

کلیدی که withdraw⁠، addresses یا sweep دارد باید کیف پول‌هایش مشخص باشد. برای هر کار یک کلید جدا بسازید.

کلید ویرایش نمی‌شود. برای تغییر، کلید تازه بسازید و قبلی را باطل کنید. باطل کردن فوری است و تأیید نمی‌خواهد. عمر کلید حداکثر یک سال است و فرم کلید به‌طور پیش‌فرض «یک سال» را می‌گذارد.