Help Center/Governance, RBAC & Security Desk/How to create an award compliance rule
Governance, RBAC & Security Desk•Last updated: 2026-10-20•3 min read

How to create an award compliance rule

The "New rule" panel defines a rule by code, covered currencies and sources, optional minimum amount, action and severity.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Open the form

On /admin/compliance click "New rule". The panel "Create compliance rule" opens (hint: code is immutable once created).

2

Enter code and name

"Rule code (A-Z 0-9 _)" must be 3-64 characters of capital letters, digits and underscore (it is upper-cased as you type), for example SIGNUP_NO_I8I_USDT. "Name" must be 3-120 characters.

3

Describe the rule

Fill "Description (why the rule exists)" (up to 1000 characters).

4

Pick currencies and sources

In "Currencies the rule covers" and "Award sources the rule covers" click chips to toggle them, or click "* all" to cover everything. Currencies come from the ledger list (I8I, I8X, USDT, CREDITS, BNB, USDC); the source chips are SIGNUP, ADMIN, MANUAL_CREDIT, REFERRAL and DEVICE. ACTIVATION is a retired source (the account-activation flow was removed) and is no longer offered for new coverage; an old rule that already lists it still shows it.

5

Set threshold, action and severity

"Minimum amount (optional)" leaves "any amount" if empty. "Action" is "BLOCK — refuse the award" or "FLAG — allow and record". "Severity" is INFO, WARNING or CRITICAL.

6

Create

Click "Create rule". A green banner confirms "Compliance rule <CODE> created." and the rule joins the Rule set, enabled.

Expected Operational Outcome

The rule is stored as enabled and applies to the next matching award.

Troubleshooting & Failure Modes

Symptom: Rule code must be 3-64 characters of A-Z, 0-9 and underscore.
Likely Cause: The code format is invalid.
Resolution: Use only capitals, digits and underscores.
Symptom: A rule with code X already exists.
Likely Cause: Codes are unique.
Resolution: Pick another code or edit the existing rule.

Was this guide helpful?

Help us refine our platform documentation