رفتن به محتوا

قانون‌ها برای توسعه‌دهنده

این صفحه می‌گوید سیستم شما از قانون‌ها چه می‌بیند. خود قانون‌ها را در قانون‌ها و تأییدها بخوانید.

API قانون‌ها را فقط می‌خواند. قانون از کنسول نوشته و در اپ تأیید می‌شود.

شرط‌های یک قانون

بخش «شرط‌های یک قانون»

همه‌ی شرط‌های یک قانون باید با هم درست باشند. شرطی که ننوشته‌اید یعنی «هر چیزی».

شرط نمونه
کیف پول همه، یا چند کیف پول مشخص
آغازگر کلید API مشخص، کاربر کنسول یا کاربر اپ
مقصد داخل یا بیرون یک دسته از آدرس‌های مجاز، یا آدرس خود سازمان
دارایی توکن‌های مشخص
مبلغ به دلار هر تراکنش، یا جمع در یک پنجره‌ی غلتان، مثلاً 24 ساعت گذشته

چون شرط «آغازگر» وجود دارد، می‌توانید برای هر کلید API رفتار جدا تعریف کنید. مثلاً کلید پرداخت خودکار تا سقف مشخص برود و بقیه تأیید بخواهند.

  • فیلد policy هر تراکنش: تصمیم در decision و قانون منطبق در matched_rule⁠.
  • GET /v1/transactions/approvals?id=⁠: حدنصاب‌ها و رأی‌ها، با دسترسی approve-read⁠.
  • فیلد approvals در فهرست تراکنش‌ها: در ردیف‌های با stage برابر waiting_approval⁠، تعداد تأیید و تعداد لازم.

نام قانون در بدنه‌ی Webhook نمی‌آید. آن را از فیلد policy تراکنش بخوانید.

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

چه کسی چه تغییری را تأیید می‌کند

بخش «چه کسی چه تغییری را تأیید می‌کند»

در صفحه‌ی قانون‌های سازمان، بخش «تأییدکننده‌ها» برای هر کار حساس می‌گوید چند نفر باید در اپ تأیید کنند. کارها: قانون‌های برداشت، آدرس‌های مجاز، اعضا و نقش‌ها، کیف پول‌ها، خاموش کردن قفل اضطراری، کلیدهای API، آدرس خبررسانی به سامانه‌ی شما، نودها و کلیدها، نرخ ارزها، و خود این جدول («جدول تأییدها»).

  • تعداد تأیید «جدول تأییدها» از هیچ کار دیگری کمتر نمی‌شود.
  • «اعضا و نقش‌ها»، «نودها و کلیدها» و «جدول تأییدها» همیشه یک تعداد تأیید دارند.
  • کسی که تغییر را خواسته شمرده نمی‌شود، مگر تنها فرد مجاز باشد.
  • هر پیشنهاد مهلت دارد و پس از آن منقضی می‌شود.

تغییر قانون اول در یک پیش‌نویس می‌ماند. پس از پیشنهاد و تأیید اجرا می‌شود. چند تغییر حساس پس از تأیید 24 یا 48 ساعت صبر می‌کنند، مثل برداشتن گوشی مدیر. آدرس تازه‌ی مجاز هم اگر سازمان «زمان انتظار» گذاشته باشد، تا پایان آن به حساب نمی‌آید.

قفل اضطراری دو شکل دارد:

شکل یعنی
همه‌ی برداشت‌ها بسته همه‌ی برداشت‌ها رد می‌شوند
تأیید اضافه برداشت فقط با تأیید اضافه‌ی قفل اضطراری می‌رود

قفل اضطراری بالاتر از همه‌ی قانون‌هاست، روی همه‌ی کیف پول‌ها و همه‌ی آغازگرها، حتی برداشت‌های در راه. روشن کردنش با یک مدیر (Admin) ممکن است و خاموش کردنش تأییدِ جدول تأییدها را می‌خواهد. «همه‌ی برداشت‌ها بسته» جلوی sweep و شارژ ایستگاه کارمزد را نمی‌گیرد.

وقتی قیمت دلاری نیست

بخش «وقتی قیمت دلاری نیست»

مبلغ دلاری «ناشناخته» می‌شود. در این حالت:

  • هیچ برداشتی خودکار نمی‌رود.
  • قانونی که فقط روی مبلغ رد می‌کند، رد نمی‌کند و برداشت برای تأیید آدم‌ها می‌رود.
  • قانونی که با دلیل دیگر رد می‌کند، مثل مقصد بیرون از دسته‌ی آدرس‌های مجاز، باز هم رد می‌کند.

اگر قیمت ناگهان زیاد جابه‌جا شود (بیش از 10٪ در یک گام یا 25٪ در یک ساعت)، آن قیمت تا تأیید شما معتبر حساب نمی‌شود. مدیر کنار دارایی «قیمت ندارد» دکمه‌ی «پذیرش نرخ» را می‌بیند و این کار هم در اپ تأیید می‌شود.