From 38fb4b4faeddcbe58a4e34ce88d1d7da24dae449 Mon Sep 17 00:00:00 2001
From: Austin <austin@flipsidecrypto.com>
Date: Fri, 11 Jul 2025 09:40:59 -0400
Subject: [PATCH] updates

---
 .../core__ez_decoded_traces.yml               | 65 +++++++++++++++++++
 models/doc_descriptions/core/balances.md      |  4 +-
 ...decoded_traces.md => ez_decoded_traces.md} | 12 ++--
 .../governance/{l2.md => ez_l2.md}            | 30 ++++-----
 models/doc_descriptions/protocols/maker.md    | 64 +++++++++---------
 5 files changed, 122 insertions(+), 53 deletions(-)
 create mode 100644 models/decoder_package/decoded_traces/core__ez_decoded_traces.yml
 rename models/doc_descriptions/core/{decoded_traces.md => ez_decoded_traces.md} (59%)
 rename models/doc_descriptions/governance/{l2.md => ez_l2.md} (67%)

diff --git a/models/decoder_package/decoded_traces/core__ez_decoded_traces.yml b/models/decoder_package/decoded_traces/core__ez_decoded_traces.yml
new file mode 100644
index 00000000..2ff7a8ee
--- /dev/null
+++ b/models/decoder_package/decoded_traces/core__ez_decoded_traces.yml
@@ -0,0 +1,65 @@
+version: 2
+models:
+  - name: core__ez_decoded_traces
+    description: '{{ doc("ez_decoded_traces_table_doc") }}'
+
+    columns:
+      - name: BLOCK_NUMBER
+        description: '{{ doc("general_block_number") }}'   
+      - name: TX_HASH
+        description: '{{ doc("general_tx_hash") }}' 
+      - name: BLOCK_TIMESTAMP
+        description: '{{ doc("general_block_timestamp") }}'
+      - name: TX_POSITION
+        description: '{{ doc("general_tx_position") }}'
+      - name: TRACE_INDEX
+        description: '{{ doc("fact_traces_trace_index") }}'
+      - name: FROM_ADDRESS
+        description: '{{ doc("fact_traces_from_address") }}'
+      - name: FROM_ADDRESS_NAME
+        description: The name of the address that initiated the trace, if the contract has a name() function.
+      - name: TO_ADDRESS
+        description: '{{ doc("fact_traces_to_address") }}'
+      - name: TO_ADDRESS_NAME
+        description: The name of the address that received the trace, if the contract has a name() function.
+      - name: VALUE
+        description: '{{ doc("general_value") }}'
+      - name: VALUE_PRECISE_RAW
+        description: '{{ doc("general_value_precise_raw") }}'
+      - name: VALUE_PRECISE
+        description: '{{ doc("general_value_precise") }}'
+      - name: GAS
+        description: '{{ doc("fact_traces_gas") }}'
+      - name: GAS_USED
+        description: '{{ doc("fact_traces_gas_used") }}'
+      - name: TYPE
+        description: '{{ doc("fact_traces_type") }}'
+      - name: TRACE_ADDRESS
+        description: '{{ doc("fact_traces_trace_address") }}' 
+      - name: SUB_TRACES
+        description: '{{ doc("fact_traces_sub_traces") }}' 
+      - name: ERROR_REASON
+        description: '{{ doc("fact_traces_error_reason") }}'
+      - name: TX_SUCCEEDED
+        description: '{{ doc("general_tx_succeeded") }}'
+      - name: TRACE_SUCCEEDED
+        description: '{{ doc("fact_traces_trace_succeeded") }}' 
+      - name: INPUT
+        description: '{{ doc("fact_traces_input") }}'
+      - name: OUTPUT
+        description: '{{ doc("fact_traces_output") }}'   
+      - name: FUNCTION_NAME
+        description: '{{ doc("ez_decoded_traces_function_name") }}'
+      - name: DECODED_INPUT_DATA
+        description: '{{ doc("ez_decoded_traces_decoded_input_data") }}'
+      - name: DECODED_OUTPUT_DATA  
+        description: '{{ doc("ez_decoded_traces_decoded_output_data") }}'
+      - name: FULL_DECODED_TRACE
+        description: '{{ doc("ez_decoded_traces_full_decoded_trace") }}'
+      - name: EZ_DECODED_TRACES_ID
+        description: '{{ doc("general_pk") }}'   
+      - name: INSERTED_TIMESTAMP
+        description: '{{ doc("general_inserted_timestamp") }}'   
+      - name: MODIFIED_TIMESTAMP
+        description: '{{ doc("general_modified_timestamp") }}' 
+     
\ No newline at end of file
diff --git a/models/doc_descriptions/core/balances.md b/models/doc_descriptions/core/balances.md
index 9ca4b335..3b359015 100644
--- a/models/doc_descriptions/core/balances.md
+++ b/models/doc_descriptions/core/balances.md
@@ -1,4 +1,4 @@
-{% docs evm_current_bal_table_doc %}
+{% docs ez_current_balances_table_doc %}
 
 This table contains the current, non-zero balances for wallets on this EVM blockchain. Symbol, name, and price are joined where possible. Prices are calculated as of the last activity date and as of the most recently recorded hourly price. ERC721s are included.
 
@@ -22,7 +22,7 @@ This is an absolutely massive view, which is why filters must be applied if you
 {% enddocs %}
 
 
-{% docs evm_diffs_table_doc %}
+{% docs ez_balance_diffs_table_doc %}
 
 This table contains the block level balance changes for both tokens (including ERC721s) and the native asset on this EVM blockchain for all wallets and contracts. If a token or the native asset is moved, we will read the balance of the involved wallets at that block, and carry forward the previous balance into the current record. Symbol, name, and price are joined where possible. ERC721s are included. 
 
diff --git a/models/doc_descriptions/core/decoded_traces.md b/models/doc_descriptions/core/ez_decoded_traces.md
similarity index 59%
rename from models/doc_descriptions/core/decoded_traces.md
rename to models/doc_descriptions/core/ez_decoded_traces.md
index 408169b2..f6131708 100644
--- a/models/doc_descriptions/core/decoded_traces.md
+++ b/models/doc_descriptions/core/ez_decoded_traces.md
@@ -1,28 +1,32 @@
-{% docs evm_decoded_traces_table_doc %}
+{% docs ez_decoded_traces_table_doc %}
 
 This model contains decoded data for traces on this EVM blockchain. It will not contain all records, but only those for which we have a valid ABI. If you are interested in submitting a contract for decoding, please visit [here](https://science.flipsidecrypto.xyz/abi-requestor/).
 
 {% enddocs %}
 
 
-{% docs evm_function_name %}
+{% docs ez_decoded_traces_function_name %}
 
 The name of the function called in the trace.
 
 {% enddocs %}
 
 
-{% docs evm_decoded_input_data %}
+{% docs ez_decoded_traces_decoded_input_data %}
 
 Decoded input data for the trace.
 
 {% enddocs %}
 
 
-{% docs evm_decoded_output_data %}
+{% docs ez_decoded_traces_decoded_output_data %}
 
 Decoded output data for the trace.
 
 {% enddocs %}
 
+{% docs ez_decoded_traces_full_decoded_trace %}
 
+The full json object of the decoded trace, including both input and output data.
+
+{% enddocs %}
\ No newline at end of file
diff --git a/models/doc_descriptions/governance/l2.md b/models/doc_descriptions/governance/ez_l2.md
similarity index 67%
rename from models/doc_descriptions/governance/l2.md
rename to models/doc_descriptions/governance/ez_l2.md
index b4bc2a41..06395e03 100644
--- a/models/doc_descriptions/governance/l2.md
+++ b/models/doc_descriptions/governance/ez_l2.md
@@ -1,88 +1,88 @@
-{% docs evm_l2_ez_data_availability_table %}
+{% docs ez_data_availability_table_doc %}
 
 This table contains the data availability submissions for various L2 chains, including Optimistic Rollups (OP Stack and Arbitrum) and ZK Rollups (Scroll).
 
 {% enddocs %}
 
-{% docs evm_l2_chain %}
+{% docs l2_chain %}
 
 The name of the L2 chain.
 
 {% enddocs %}
 
-{% docs evm_l2_chain_category %}
+{% docs l2_chain_category %}
 
 The category of the L2 chain.
 
 {% enddocs %}
 
-{% docs evm_l2_data_availability_address %}
+{% docs l2_data_availability_address %}
 
 The address where the data availability submission was made to.
 
 {% enddocs %}
 
-{% docs evm_l2_submission_type %}
+{% docs l2_submission_type %}
 
 The type of the data availability submission.
 
 {% enddocs %}
 
-{% docs evm_l2_blob_count %}
+{% docs l2_blob_count %}
 
 The number of blobs submitted in this transaction.
 
 {% enddocs %}
 
-{% docs evm_l2_blob_gas_used %}
+{% docs l2_blob_gas_used %}
 
 The total amount of blob gas used in this transaction.
 
 {% enddocs %}
 
-{% docs evm_l2_blob_gas_price %}
+{% docs l2_blob_gas_price %}
 
 The price paid per unit of blob gas, denominated in wei.
 
 {% enddocs %}
 
-{% docs evm_l2_blob_fee %}
+{% docs l2_blob_fee %}
 
 The total blob fee paid for this transaction, denominated in ETH.
 
 {% enddocs %}
 
-{% docs evm_l2_ez_state_validation_table %}
+{% docs ez_state_validation_table_doc %}
 
 This table contains the state validation for various L2 chains, including Optimistic Rollups (OP Stack) and Optimium (Mantle).
 
 {% enddocs %}
 
-{% docs evm_l2_state_validation_address %}
+{% docs l2_state_validation_address %}
 
 The address where the state validation was made to.
 
 {% enddocs %}
 
-{% docs evm_l2_state_validation_type %}
+{% docs l2_state_validation_type %}
 
 The type of the state validation.
 
 {% enddocs %}
 
-{% docs evm_l2_state_validation_data %}
+{% docs l2_state_validation_data %}
 
 The data of the state validation.
 
 {% enddocs  %}
 
-{% docs evm_l2_state_validation_data_type %}
+{% docs l2_state_validation_data_type %}
 
 The data type of the state validation.
 
 {% enddocs %}
 
-{% docs evm_l2_state_validation_data_json %}
+{% docs l2_state_validation_data_json %}
 
 The JSON data of the state validation based on the validation type.
 
diff --git a/models/doc_descriptions/protocols/maker.md b/models/doc_descriptions/protocols/maker.md
index f5a20615..07414135 100644
--- a/models/doc_descriptions/protocols/maker.md
+++ b/models/doc_descriptions/protocols/maker.md
@@ -1,76 +1,76 @@
-{% docs evm_maker_ilk %}
+{% docs maker_ilk %}
 
 The collateral type of the CDP.
 
 {% enddocs %}
 
-{% docs evm_maker_urn_address %}
+{% docs maker_urn_address %}
 
 A specific CDP.
 
 {% enddocs %}
 
-{% docs evm_maker_art %}
+{% docs maker_art %}
 
 Normalized outstanding stablecoin debt.
 
 {% enddocs %}
 
-{% docs evm_maker_ink %}
+{% docs maker_ink %}
 
 Collateral balance.
 
 {% enddocs %}
 
-{% docs evm_maker_tab %}
+{% docs maker_tab %}
 
 Total dai wanted from the auction / total dai to be raised (in flip auction)
 
 {% enddocs %}
 
-{% docs evm_maker_id %}
+{% docs maker_id %}
 
 ID of the auction in the Flipper
 
 {% enddocs %}
 
-{% docs evm_maker_cdp %}
+{% docs maker_cdp %}
 
 The CDP vault number.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_cat_bite %}
+{% docs maker_fact_cat_bite %}
 
 The Cat is the system's liquidation agent: it enables keepers to mark positions as unsafe and send them to be auctioned.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_vat_file %}
+{% docs maker_fact_vat_file %}
 
 Admin function to modify the system parameters.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_vat_flux %}
+{% docs maker_fact_vat_flux %}
 
 Transfers of internal collateral balance of collateral type ilk within Vat from src to dst address.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_vat_fold %}
+{% docs maker_fact_vat_fold %}
 
 Fold increases rate of a collateral type i to proportionally increase the outstanding debt of all its vaults, typically to assess the stability fee. It also increases the dai balance of address u to add a surplus to the Vow contract.
 
 {% enddocs %}
 
-{% docs evm_maker_rate %}
+{% docs maker_rate %}
 
 Stablecoin debt multiplier (accumulated stability fees)
 
 {% enddocs %}
 
-{% docs evm_maker_fact_vat_fork %}
+{% docs maker_fact_vat_fork %}
 
 Moves locked collateral and/or outstanding debt from one vault src to another vault dst by dink and dart amounts.
 
@@ -78,31 +78,31 @@ This is a public function that can be called by an address that is authorized by
 
 {% enddocs %}
 
-{% docs evm_maker_vat_fork_dink %}
+{% docs maker_vat_fork_dink %}
 
 Amount of collateral to exchange.
 
 {% enddocs %}
 
-{% docs evm_maker_vat_fork_dart %}
+{% docs maker_vat_fork_dart %}
 
 Amount of stablecoin debt to exchange.
 
 {% enddocs %}
 
-{% docs evm_maker_vat_frob_dink %}
+{% docs maker_vat_frob_dink %}
 
 Change in collateral.
 
 {% enddocs %}
 
-{% docs evm_maker_vat_frob_dart %}
+{% docs maker_vat_frob_dart %}
 
 Change in debt.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_vat_frob %}
+{% docs maker_fact_vat_frob %}
 
 Manipulates the locked collateral and outstanding debt balance of a vault u with collateral balance from address v and dai balance of address w
 
@@ -110,85 +110,85 @@ Positive dink and dart values add to the existing balances while negative value
 
 {% enddocs %}
 
-{% docs evm_maker_fact_vat_move %}
+{% docs maker_fact_vat_move %}
 
 Used to transfer internal dai balance of user within Vat to another address.
 
 {% enddocs %}
 
-{% docs evm_maker_rad %}
+{% docs maker_rad %}
 
 DAI amount.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_vat_slip %}
+{% docs maker_fact_vat_slip %}
 
 Used to modify the internal collateral balance of a collateral type within Vat.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_pot_exit %}
+{% docs maker_fact_pot_exit %}
 
 Used when users want to "exit" their Dai from the Pot.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_pot_join %}
+{% docs maker_fact_pot_join %}
 
 Used when users want to join their Dai to the Pot.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_vat_suck %}
+{% docs maker_fact_vat_suck %}
 
 Generates dai on address u and accounted as bad debt on address v without opening a vault.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_urns %}
+{% docs maker_fact_urns %}
 
 Urn addresses are read by calling the urns function on the CDP manager contract for each created vault.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_dog_bark %}
+{% docs maker_fact_dog_bark %}
 
 This is the v1 liquidation function. Recent liquidations use the Cat contract.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_dai_join_join %}
+{% docs maker_fact_dai_join_join %}
 
 Enters collateral into the system.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_dai_join_exit %}
+{% docs maker_fact_dai_join_exit %}
 
 Removes collateral into the system.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_cdp_newcdp %}
+{% docs maker_fact_cdp_newcdp %}
 
 Creates a new CDP.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_cdp_move %}
+{% docs maker_fact_cdp_move %}
 
 Transfers of DAI from the cdp address to a dst address.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_cdp_frob %}
+{% docs maker_fact_cdp_frob %}
 
 Modifications of the collateral and debt balance of a CDP.
 
 {% enddocs %}
 
-{% docs evm_maker_fact_cdp_flux %}
+{% docs maker_fact_cdp_flux %}
 
 Wad amounts of CDP collateral from the cdp address to a dst address.