Skip to main content
motifs contains the structural patterns that the ParaLens engine identified inside the transaction. Each motif is a named, evidence-backed pattern — a swap hop, a closed value loop, a transfer arc. Together, they compose into the top-level classification.intent_kind.

​
Example

​
Fields

​
number
required
Motif identifier within this report.
​
string
required
Motif type. See the Common motif kinds table below for possible values.
​
string
required
Verification status of the motif. One of:
  • Proven — the pattern was confirmed with sufficient structural evidence.
  • Suspected — the pattern was inferred but not fully corroborated.
​
string
required
Engine confidence in the motif. One of High, Medium, or Low.
​
number
required
Structural scope where the motif was found. Group by this value to visualize routes or isolate sub-transactions within a complex trace.
​
string | null
Motif-level actor address when available. May be null if the engine could not resolve a specific actor for this pattern.

​
Common motif kinds

Treat unknown kind values as opaque — new motif types may be added as the ParaLens engine is updated.

​
Usage guidance

  • Route visualization — Group motifs by scope_id to build route or scope visualizations. Each scope represents a coherent structural unit within the trace.
  • Intent explanation — Show why a transaction was classified by listing the discovered motifs[].kind values. This gives users a human-readable evidence trail behind classification.intent_kind.
  • MEV analysis — Look for ClosedValueFlow motifs. They indicate value that left and returned to the same actor, a reliable profit signal in sandwich attacks and arbitrage.
  • Display density — Collapse duplicate kind values for display in dense transactions where the same pattern repeats across multiple scopes.
  • Forward compatibility — Do not hard-code exhaustive checks against kind. New motif types may be introduced without a breaking change.