feat(tokens): materialize tokens_gnosis_suicide_events staging table

dbt_subprojects/tokens/models/transfers_and_balances/gnosis/_schema.yml

@@ -66,6 +66,52 @@ models:
       - name: _updated_at
         description: "Timestamp when this row was last written"
 
+  - name: tokens_gnosis_suicide_events
+    description: "Ordered SELFDESTRUCT (SUICIDE) trace events on the Gnosis blockchain with deterministic per-address event_sequence and previous_block_time. Staging table shared by tokens_gnosis_suicide_transfers to avoid rescanning gnosis.traces on every hourly build."
+    meta:
+      blockchain: gnosis
+      sector: tokens
+      contributors: ['0xRob', 'hdser']
+    config:
+      tags: ['tokens', 'suicide', 'events', 'gnosis']
+    data_tests:
+      - dbt_utils.unique_combination_of_columns:
+          arguments:
+            combination_of_columns:
+              - address
+              - event_sequence
+    columns:
+      - name: block_month
+        description: "The month of the block in which the SELFDESTRUCT was executed."
+      - name: block_date
+        description: "The date of the block in which the SELFDESTRUCT was executed."
+      - name: block_time
+        description: "The exact time when the block was mined."
+      - name: block_number
+        description: "The number of the block in the blockchain."
+      - name: tx_hash
+        description: "The hash of the transaction containing the SELFDESTRUCT."
+      - name: tx_index
+        description: "The transaction index within the block."
+      - name: trace_address
+        description: "The trace address of the SELFDESTRUCT trace within the transaction."
+      - name: tx_from
+        description: "The transaction sender."
+      - name: tx_to
+        description: "The transaction receiver."
+      - name: address
+        description: "The self-destructing contract address."
+        data_tests:
+          - not_null
+      - name: refund_address
+        description: "The refund address that receives the contract's remaining native balance."
+      - name: event_sequence
+        description: "1-based ordinal of this SELFDESTRUCT among all SELFDESTRUCTs for this address, using a deterministic total order (block_time, block_number, tx_index, trace_address)."
+        data_tests:
+          - not_null
+      - name: previous_block_time
+        description: "The block_time of the previous SELFDESTRUCT for this address under the same deterministic order, or NULL for the first."
+
   - name: tokens_gnosis_suicide_transfers
     description: "Token transfers related to account destruction or contract suicide on the Gnosis blockchain."
     meta:

dbt_subprojects/tokens/models/transfers_and_balances/gnosis/tokens_gnosis_suicide_events.sql

@@ -0,0 +1,43 @@
+{{ config(
+    schema = 'tokens_gnosis',
+    alias = 'suicide_events',
+    materialized = 'table',
+    file_format = 'delta',
+    )
+}}
+
+-- Ordered SUICIDE (SELFDESTRUCT) trace events on Gnosis.
+-- Staging table shared by tokens_gnosis_suicide_transfers so that each hourly
+-- build reads this small table (~117K rows total) instead of scanning the full
+-- gnosis.traces partition three times.
+--
+-- The ORDER BY includes (block_number, tx_index, trace_address) as a tiebreaker
+-- after block_time so per-address event_sequence is deterministic even when the
+-- same address is self-destructed multiple times inside the same block.
+
+SELECT
+     cast(date_trunc('month', block_time) as date) AS block_month
+    , cast(date_trunc('day', block_time) as date) AS block_date
+    , block_time
+    , block_number
+    , tx_hash
+    , tx_index
+    , trace_address
+    , tx_from
+    , tx_to
+    , address
+    , refund_address
+    , ROW_NUMBER() OVER (
+          PARTITION BY address
+          ORDER BY block_time, block_number, tx_index, trace_address
+      ) AS event_sequence
+    , LAG(block_time) OVER (
+          PARTITION BY address
+          ORDER BY block_time, block_number, tx_index, trace_address
+      ) AS previous_block_time
+FROM
+    {{ source('gnosis', 'traces') }}
+WHERE
+    type = 'suicide'
+    AND
+    success

dbt_subprojects/tokens/models/transfers_and_balances/gnosis/tokens_gnosis_suicide_transfers.sql

@@ -13,36 +13,6 @@
 
 WITH 
 
-suicide AS (
-    SELECT 
-         cast(date_trunc('month', block_time) as date) AS block_month
-        , cast(date_trunc('day', block_time) as date) AS block_date
-        , block_time
-        , block_number
-        , tx_hash
-        , tx_index
-        , trace_address
-        , tx_from
-        , tx_to
-        , address 
-        , refund_address 
-    FROM 
-        {{ source('gnosis', 'traces') }}
-    WHERE
-        type = 'suicide'
-        AND
-        success
-),
-
-suicide_events AS (
-    SELECT
-        *
-        ,ROW_NUMBER() OVER (PARTITION BY address ORDER BY block_time) AS event_sequence
-        ,LAG(block_time) OVER (PARTITION BY address ORDER BY block_time) AS previous_block_time
-    FROM
-        suicide
-),
-
 tokens_gnosis_base_without_suicide_transfers AS (
     SELECT
         address
@@ -56,7 +26,7 @@ tokens_gnosis_base_without_suicide_transfers AS (
         FROM    
             {{ ref('tokens_gnosis_base_without_suicide_transfers') }} t1
         INNER JOIN
-            suicide_events t2
+            {{ ref('tokens_gnosis_suicide_events') }} t2
             ON 
             t2.address = t1."from"
         WHERE  
@@ -75,7 +45,7 @@ tokens_gnosis_base_without_suicide_transfers AS (
         FROM    
             {{ ref('tokens_gnosis_base_without_suicide_transfers') }} t1
         INNER JOIN
-            suicide_events t2
+            {{ ref('tokens_gnosis_suicide_events') }} t2
             ON 
             t2.address = t1."to"
         WHERE  
@@ -122,7 +92,7 @@ SELECT
 FROM 
     suicide_balances t1
 INNER JOIN
-    suicide_events t2
+    {{ ref('tokens_gnosis_suicide_events') }} t2
     ON 
     t2.address = t1.address
     AND