Policy Engine Conditions

Reference guide for all available policy conditions in the Tholos Policy Engine.

The Policy Engine evaluates the following conditions whenever a transaction is initiated. If one or more policies apply, the lowest required approval threshold among the applicable policies is enforced. Cooldowns apply per policy as configured.

Transaction Value

Adjusts the required approvals based on the USD value of the transaction at initiation. Typical use: Fewer approvals for low-value transfers; stricter thresholds for higher-value transactions.

Example:

  • Less than or equal to $25,000 → 2 approvals
  • $25,000-$250,000 → 3 approvals
  • Greater than $250,000 → 5 approvals

Contact

Applies a specific threshold when the recipient matches a saved Contact in your organization. Typical use: Set tailored thresholds for trusted counterparties (e.g., exchanges, payroll, OTC desks).

Example:

  • Recipient is “Prime Exchange” (saved Contact) → 2 approvals
  • Recipient is “Treasury Cold Vault” (saved Contact) → 4 approvals

Signing Method

Enforces a threshold when a transaction uses a specified signing method (e.g., personal_sign). Typical use: Differentiate simple message signatures from actions that generally warrant more scrutiny.

Example:

  • personal_sign → 1 approval
  • eth_signTypedData_v4 → 2 approvals

Blockchain

Applies when the transaction is on a specific blockchain. Typical use: Use stricter thresholds on newer or less frequently used blockchains while keeping common networks efficient.

Example:

  • Ethereum → 3 approvals
  • Arbitrum → 2 approvals

Smart Contract

Applies when the transaction interacts with designated smart contracts or specific contract methods. Typical use: Whitelist known contracts with streamlined thresholds or require more approvals for sensitive methods.

Example:

  • Interacts with your payroll contract → 2 approvals
  • Calls upgradeTo on protocol admin contract → 5 approvals

Notes:

  • Each policy defines its own threshold and optional cooldown.
  • When multiple policies match, the engine uses the lowest applicable threshold; policies in cooldown are ignored until their cooldown ends.