AN-5294/table-column-audit

models/doc_descriptions/core/balances.md

@@ -26,7 +26,7 @@ This is an absolutely massive view, which is why filters must be applied if you
 
 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. 
 
-Please note - the underlying data for this is large. If you want your query to run quickly, please use filters as much as possible. Using at least `block_timestamp::date` as a filter will lead to optimal query performance.
+Please note - the underlying data for this is large. If you want your query to run quickly, please use filters as much as possible. For optimal query performance, filter by `block_timestamp::date`.
 
 If you want to take this data and make it daily, you can do so with the query below. You must use a `block_timestamp::date` filter here at a minimum. Other filters will help query runtime. 
 
@@ -149,14 +149,14 @@ ORDER BY
 
 {% docs evm_has_decimal %}
 
-Whether the token has a decimal or not, either TRUE or FALSE.
+Boolean flag indicating whether token decimal information is available for this token (TRUE or FALSE).
 
 {% enddocs %}
 
 
 {% docs evm_has_price %}
 
-Whether the token has an hourly price or not, either TRUE or FALSE.
+Boolean flag indicating whether hourly price data for this token is available (TRUE or FALSE).
 
 {% enddocs %}
 
@@ -190,14 +190,14 @@ The contract address of the token (null for native asset).
 
 {% docs evm_current_balances_current_bal_unadj %}
 
-The current token or native asset balance for this address, without a decimal adjustment.
+The current raw token or native asset balance for this address, without a decimal adjustment.
 
 {% enddocs %}
 
 
 {% docs evm_current_balances_current_bal %}
 
-The decimal adjusted current token or native asset balance.
+The current decimal adjusted token or native asset balance.
 
 {% enddocs %}
 
@@ -218,35 +218,35 @@ The value of the tokens or native asset in USD, as of the most recently recorded
 
 {% docs evm_current_balances_symbol %}
 
-The symbol of the token contract, or native asset.
+The symbol of the token contract, or native asset. Please note this is not necessarily unique. 
 
 {% enddocs %}
 
 
 {% docs evm_current_balances_token_name %}
 
-The name of the token contract, or native asset.
+The name of the token contract, or native asset. Please note this is not necessarily unique. 
 
 {% enddocs %}
 
 
 {% docs evm_current_balances_decimals %}
 
-The decimals for the token contract.
+The number of decimal places specified by the token contract for representing token amounts.
 
 {% enddocs %}
 
 
 {% docs evm_current_balances_has_decimal %}
 
-Whether the token has a decimal or not, either TRUE or FALSE.
+Boolean flag indicating whether token decimal information is available for this token (TRUE or FALSE).
 
 {% enddocs %}
 
 
 {% docs evm_current_balances_has_price %}
 
-Whether the token has an hourly price or not, either TRUE or FALSE.
+Boolean flag indicating whether hourly price data for this token is available (TRUE or FALSE).
 
 {% enddocs %}
 

models/doc_descriptions/core/blocks.md

@@ -5,20 +5,6 @@ This table contains block level data for this EVM blockchain. This table can be
 {% enddocs %}
 
 
-{% docs evm_block_header_json %}
-
-This JSON column contains the block header details.
-
-{% enddocs %}
-
-
-{% docs evm_blockchain %}
-
-The blockchain on which transactions are being confirmed.
-
-{% enddocs %}
-
-
 {% docs evm_blocks_hash %}
 
 The hash of the block header for a given block.
@@ -35,7 +21,7 @@ Block nonce is a value used during mining to demonstrate proof of work for a giv
 
 {% docs evm_difficulty %}
 
-The effort required to mine the block.
+The computational effort required to mine the block.
 
 {% enddocs %}
 
@@ -56,7 +42,7 @@ Total gas limit provided by all transactions in the block.
 
 {% docs evm_gas_used %}
 
-Total gas used in the block.
+Total gas used by all transactions in the block.
 
 {% enddocs %}
 

models/doc_descriptions/core/contract_abis.md

@@ -2,14 +2,14 @@
 
 This table contains the contract ABIs that we have sourced from Etherscan, the community, or bytecode matched. This table is the source of ABIs used in the `core__ez_decoded_event_logs` table.
 We first try to source ABIs from Etherscan. If we cannot find an ABI on Etherscan, we will rely on user submissions. To add a contract to this table, please visit [here](https://science.flipsidecrypto.xyz/abi-requestor/).
-If we are unable to locate an ABI for a contract from Etherscan or the community, we will try to find an ABI to use by matching the contract bytecode to a known contract bytecode we do have an ABI for.
+If we are unable to locate an ABI for a contract from Etherscan or the community, we will try to find an ABI to use by matching the contract bytecode with known contracts.
 
 {% enddocs %}
 
 
 {% docs abi %}
 
-The JSON ABI for the contract.
+The ABI for the contract in JSON, defining the contract's functions and events.
 
 {% enddocs %}
 

models/doc_descriptions/core/contract_reads.md

@@ -7,14 +7,14 @@ This table contains contract reads for a variety of functions and contracts on t
 
 {% docs evm_contract_reads_contract_address %}
 
-The address of the contract read.
+The address of the smart contract being read.
 
 {% enddocs %}
 
 
 {% docs evm_contract_reads_block_number %}
 
-The block number the contract address was read at.
+The block number at which the contract read operation was performed.
 
 {% enddocs %}
 
@@ -28,21 +28,21 @@ The function signature called by this read. See `dim_function_signatures` for te
 
 {% docs evm_contract_reads_function_input %}
 
-The function inputs called in this read, if applicable.
+The input parameters provided to the function call, if applicable.
 
 {% enddocs %}
 
 
 {% docs evm_read_output %}
 
-The return of the contract call.
+The raw output returned by the contract function call.
 
 {% enddocs %}
 
 
 {% docs evm_segmented_output %}
 
-The return of the contract call, segmented into 64 character strings.
+The raw output returned by the contract function call, segmented into 64 character strings.
 
 {% enddocs %}
 

models/doc_descriptions/core/contracts.md

@@ -26,13 +26,6 @@ The unique address of the deployed contract.
 {% enddocs %}
 
 
-{% docs evm_contracts_metadata %}
-
-This JSON column contains other relevant details for each contract. 
-
-{% enddocs %}
-
-
 {% docs evm_contracts_name %}
 
 The name of the deployed contract. Please note this is not necessarily unique. 
@@ -49,7 +42,7 @@ The symbol used to represent this contract. Please note this is not necessarily
 
 {% docs evm_creator_address %}
 
-The address of the contract creator. 
+The address that deployed/created the contract (also known as the deployer address). 
 
 {% enddocs %}
 
@@ -68,13 +61,13 @@ Internal column.
 
 {% docs evm_token_convention %}
 
-The token standard utilized by this contract. 
+The token standard implemented by the contract (e.g. ERC20, ERC721, ERC1155).
 
 {% enddocs %}
 
 {% docs evm_decimals %}
 
-The decimals for the token contract.
+The number of decimal places used by the token contract for representing token amounts
 
 {% enddocs %}
 

models/doc_descriptions/core/decoded_traces.md

@@ -14,14 +14,14 @@ The name of the function called in the trace.
 
 {% docs evm_decoded_input_data %}
 
-Decoded input data for the trace.
+The decoded input parameters provided to the function call in this trace.
 
 {% enddocs %}
 
 
 {% docs evm_decoded_output_data %}
 
-Decoded output data for the trace.
+The decoded output data from the function call in this trace.
 
 {% enddocs %}
 

models/doc_descriptions/core/event_logs.md

@@ -20,7 +20,7 @@ The decoded event inputs for a given event.
 
 {% docs evm_event_removed %}
 
-Whether the event has been removed from the transaction.
+Boolean flag indicating whether the event has been removed from the transaction (TRUE or FALSE).
 
 {% enddocs %}
 
@@ -34,7 +34,7 @@ This is the primary key for this table. This is a concatenation of the transacti
 
 {% docs evm_logs_contract_address %}
 
-The address interacted with for a given event.
+The address of the contract that emitted this event.
 
 {% enddocs %}
 
@@ -48,7 +48,7 @@ The name of the contract or token, where possible.
 
 {% docs evm_logs_data %}
 
-The un-decoded event data.
+The raw (un-decoded) data contained in the event log.
 
 {% enddocs %}
 
@@ -62,7 +62,7 @@ Transaction hash is a unique 66-character identifier that is generated when a tr
 
 {% docs evm_topics %}
 
-The un-decoded event input topics.
+The raw (un-decoded) event topics, which are indexed parameters of the event.
 
 {% enddocs %}
 

models/doc_descriptions/core/prices.md

@@ -127,14 +127,14 @@ The unique identifier of the Blockchain, Network, or Platform for this asset.
 
 {% docs evm_prices_is_native %}
 
-A flag indicating assets native to this EVM blockchain.
+Boolean flag indicating whether the asset is native to this EVM blockchain (TRUE or FALSE).
 
 {% enddocs %}
 
 
 {% docs evm_prices_is_deprecated %}
 
-A flag indicating if the asset is deprecated or no longer supported by the provider.
+Boolean flag indicating whether the asset is deprecated or no longer supported by the provider (TRUE or FALSE).
 
 {% enddocs %}
 
@@ -155,7 +155,7 @@ Deprecating soon! Please use the decimals column in `ez_asset_metadata` or join
 
 {% docs evm_prices_is_imputed %}
 
-A flag indicating if the price was imputed, or derived, from the last arriving record. This is generally used for tokens with low-liquidity or inconsistent reporting.
+Boolean flag indicating whether the price was imputed, or derived, from the last available record (TRUE or FALSE). Commonly used for low-liquidity tokens or those with inconsistent reporting.
 
 {% enddocs %}
 

models/doc_descriptions/core/traces.md

@@ -54,13 +54,6 @@ The gas used for this trace.
 {% enddocs %}
 
 
-{% docs evm_traces_identifier %}
-
-This field represents the position and type of the trace within the transaction. 
-
-{% enddocs %}
-
-
 {% docs evm_trace_index %}
 
 The index of the trace within the transaction.
@@ -111,7 +104,7 @@ The type of internal transaction. Common trace types are `CALL`, `DELEGATECALL`,
 
 {% docs evm_trace_succeeded %}
 
-The boolean value representing if the trace succeeded.
+Boolean flag indicating whether the trace succeeded (TRUE or FALSE).
 
 {% enddocs %}