Policies

​

Anatomy of a Policy

1. A signer group that governs the policy itself. Future mutations of the policy — adding rules, deleting it, updating limits — must be signed by members of this group via the endorsed-request flow. It can be the same group attached to the wallet, or a separate admin group for stricter compartmentalization.
2. One or more rules. Each rule has a rule_type, an action (allow or deny), and a definition whose shape depends on the rule type.
3. Metadata. A human-readable name and optional description.

{
  "id": "pol_2LfQm5KMnRvLFtRP7nJJug4zJEP",
  "client_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "signer_group_id": "grp_2LfPqT9VmQzKDvQP9rGHth3yHCN",
  "version": 1,
  "name": "Treasury default policy",
  "description": "Single-signature for transfers under $10k; two signatures otherwise",
  "rules": [
    { "rule_type": "approval_threshold", "action": "allow",
      "definition": { "threshold": 1 } },
    { "rule_type": "amount_threshold",   "action": "deny",
      "definition": {
        "min_amount": 1000000,
        "threshold": 0,
        "asset": { "id": "USD", "name": "US Dollar" }
      } }
  ],
  "created_at": 1640995200,
  "updated_at": 1640995200
}

​

Rule Types

​

approval_threshold

{
  "rule_type": "approval_threshold",
  "action": "allow",
  "definition": { "threshold": 2, "description": "Requires 2-of-N approval" }
}

• threshold — minimum number of signers required.
• The rule always applies to every transaction (it’s a count check, not a conditional).
• If the threshold is met → emit the rule’s action (allow or deny). If not met → emit the inverted action.

​

amount_threshold

{
  "rule_type": "amount_threshold",
  "action": "deny",
  "definition": {
    "min_amount": 1000000,
    "threshold": 0,
    "asset": { "id": "USD", "name": "US Dollar" }
  }
}

• min_amount — integer in the smallest currency unit (USD → cents). The example above is $10,000.00.
• threshold — number of approvals required to override. 0 means hard deny; higher values mean N approvers can let it through.
• asset — object with id (asset symbol, e.g. USD) and name (display name).
• The rule applies only when the transaction’s amount in asset is at or above min_amount. Below the threshold, the rule does not apply (does not contribute allow or deny).

​

address_list

{
  "rule_type": "address_list",
  "action": "allow",
  "definition": {
    "addresses": [
      "0x742d35Cc6634C0532925a3b8D404fA40b5398Ad2",
      "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
    ]
  }
}

• The rule applies only when the destination address is in the addresses list.
• For an allow-list, set action: allow and pair with a default-deny in another rule (or rely on the policy engine’s default-deny on no-applicable-policy).
• For a deny-list, set action: deny and the listed addresses are blocked outright.

​

Evaluation Order

1. Loads every policy attached to the wallet. If zero policies, return deny immediately ("No policies found for wallet").
2. For each policy, evaluates each rule in turn. A rule produces one of: applied + allow, applied + deny, or not-applicable.
3. Aggregates per policy: if any rule denies → policy = deny. Else if any rule allows → policy = allow. Else (no rule applied) → policy = not-applicable.
4. Aggregates across policies: if any policy denies → transaction = deny. Else if any policy allows → transaction = allow. Else (no applicable policy) → transaction = deny (default).

​

Lifecycle

​

Practical Examples

​

”Default permissive” — single signature, no restrictions

{
  "name": "Default single-signature policy",
  "signer_group_id": "grp_admin",
  "rules": [
    { "rule_type": "approval_threshold", "action": "allow",
      "definition": { "threshold": 1 } }
  ]
}

​

“Tiered approval by amount” — single-sig under $10k, dual-sig above

{
  "name": "Tiered approval policy",
  "signer_group_id": "grp_admin",
  "rules": [
    { "rule_type": "approval_threshold", "action": "allow",
      "definition": { "threshold": 1 } },
    { "rule_type": "amount_threshold", "action": "deny",
      "definition": {
        "min_amount": 1000000,
        "threshold": 0,
        "asset": { "id": "USD", "name": "US Dollar" }
      } },
    { "rule_type": "approval_threshold", "action": "allow",
      "definition": { "threshold": 2 } }
  ]
}

​

”Sanctions deny-list” — block specific addresses outright

{
  "name": "OFAC blocklist",
  "signer_group_id": "grp_compliance",
  "rules": [
    { "rule_type": "address_list", "action": "deny",
      "definition": { "addresses": ["0xSanctionedAddress1", "0xSanctionedAddress2"] } }
  ]
}

​

Related

• Common Flows — Create a Policy — happy-path curl walk-through.
• Wallet Transaction Signing — endorsed-request flow for mutating an existing policy or attaching/detaching to a wallet.
• Wallets — architectural overview of signer groups, policies, and intents.