ScreeningPolicyAddress

A customer address exception, belonging to the (environment, vendor) pair rather than to one policy — a denylist should have one answer to "is this actor blocked?" whichever screening moment is being resolved. Matched by a chain-aware fold of the address, not a plain lowercase, because base58 and base32 chains are case-significant. An absent chain applies the entry to every chain.

id · string · required

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

address · string · required

The address, in the casing it was submitted with.

appliesToScope · enum<string> · required

Which scopes an address entry applies to. Separate from ScreeningPolicyScopeEnum because ALL is meaningful here and meaningless on a policy row. ALL is the default and the overwhelmingly common intent — a blocked actor is normally blocked everywhere — and narrowing is available for the customer who wants it.

Available options: ALL, SIGN_IN, TRANSACTION

disposition · enum<string> · required

Whether the entry exempts the address from the customer's own rules, or blocks it. Both evaluate below the sanctions floor, so ALLOW can never unblock a sanctioned address.

Available options: ALLOW, DENY

chain · enum<string>

Available options: ETH, EVM, FLOW, SOL, ALGO, STARK, COSMOS, BTC, ECLIPSE, SUI, SPARK, TRON, APTOS, TON, STELLAR, ALEO, TEMPO, MIDNIGHT

note · string

Human-readable label to identify this entry in the dashboard.

Maximum string length: 255

createdAt · string<date-time>

ISO 8601 timestamp of when the entry was added.