diff --git a/apps/docs/blog/2024-02-28-arbitrum-impact-pools/index.mdx b/apps/docs/blog/2024-02-28-arbitrum-impact-pools/index.mdx
index 9c2a2a107..7537dca8d 100644
--- a/apps/docs/blog/2024-02-28-arbitrum-impact-pools/index.mdx
+++ b/apps/docs/blog/2024-02-28-arbitrum-impact-pools/index.mdx
@@ -29,7 +29,7 @@ First, our data platform is still in active development. We just recently connec
Second, we are continuously iterating on our impact metrics. We hope the metrics included here illustrate what's possible to quickly identify trends among projects and relative performance levels. However, the metrics we chose should not be viewed as applicable to all projects or battle-tested against gamification. Similarly, the coefficients used to weight metrics in our impact pools are only intended to serve as starting points for further analysis.
-If you have ideas for how to test and iterate on these types of impact metrics and pools, check out [our docs](https://docs.opensource.observer/docs/contribute/impact-models) and send us a note.
+If you have ideas for how to test and iterate on these types of impact metrics and pools, check out [our docs](https://docs.opensource.observer/docs/contribute/data-models) and send us a note.
## How pools are constructed
diff --git a/apps/docs/blog/2024-07-16-oso-data-portal/index.md b/apps/docs/blog/2024-07-16-oso-data-portal/index.md
index 2fc212023..a8aef4f14 100644
--- a/apps/docs/blog/2024-07-16-oso-data-portal/index.md
+++ b/apps/docs/blog/2024-07-16-oso-data-portal/index.md
@@ -116,7 +116,7 @@ where passport_address = '0xd8da6bf26964af9d7eed9e03e53415d37aa96045'
When you’ve developed a novel impact metrics or data model,
we encourage you to
-[contribute back to the OSO data pipeline](https://docs.opensource.observer/docs/contribute/impact-models),
+[contribute back to the OSO data pipeline](https://docs.opensource.observer/docs/contribute/data-models),
which is continuously deployed from our
[open source repository](https://github.com/opensource-observer/oso/).
diff --git a/apps/docs/docs/contribute/connect-data/dagster-config.mdx b/apps/docs/docs/contribute/connect-data/dagster-config.mdx
index e5406103f..3b9c69ab7 100644
--- a/apps/docs/docs/contribute/connect-data/dagster-config.mdx
+++ b/apps/docs/docs/contribute/connect-data/dagster-config.mdx
@@ -98,4 +98,4 @@ from {{ source("ethereum", "transactions") }}
- [**SQL Query Guide**](../../integrate/query-data.mdx): run queries against the data you just loaded
- [**Connect OSO to 3rd Party tools**](../../integrate/3rd-party.mdx): explore your data using tools like Hex.tech, Tableau, and Metabase
-- [**Write a dbt model**](../impact-models.md): contribute new impact and data models to our data pipeline
+- [**Write a dbt model**](../data-models.md): contribute new impact and data models to our data pipeline
diff --git a/apps/docs/docs/contribute/impact-models.md b/apps/docs/docs/contribute/data-models.md
similarity index 100%
rename from apps/docs/docs/contribute/impact-models.md
rename to apps/docs/docs/contribute/data-models.md
diff --git a/apps/docs/docs/contribute/index.mdx b/apps/docs/docs/contribute/index.mdx
index 482bd03a7..f27be11e5 100644
--- a/apps/docs/docs/contribute/index.mdx
+++ b/apps/docs/docs/contribute/index.mdx
@@ -55,7 +55,7 @@ There are a variety of ways you can contribute to OSO. This doc features some of
+ Help develop impact metrics for allocating retroactive funding to open source projects.
+
+
Data Scientists, Analysts
+
Share Insights
diff --git a/apps/docs/docs/contribute/join-team.mdx b/apps/docs/docs/contribute/join-team.mdx
index ba424292d..7be7f7110 100644
--- a/apps/docs/docs/contribute/join-team.mdx
+++ b/apps/docs/docs/contribute/join-team.mdx
@@ -1,6 +1,6 @@
---
-title: Join the team
-sidebar_position: 10
+title: Join the Team
+sidebar_position: 8
---
{" "}
-- Code License: [Apache-2.0](https://github.com/opensource-observer/oso/blob/main/LICENSE)
-- Data governed by the OSO
-[terms of service](https://www.opensource.observer/terms)
-
-OSO is proud to provide public datasets for the Superchain,
-backed by our partners at
-[Goldsky](https://goldsky.com/).
-
-We currently provide blocks, transactions, and traces for the following networks:
-
-- [Optimism mainnet](https://www.optimism.io/)
-([Reference docs](https://models.opensource.observer/#!/source_list/superchain)
-, [Updated daily](https://dagster.opensource.observer/assets/optimism))
-- [Base](https://www.base.org/)
-([Reference docs](https://models.opensource.observer/#!/source_list/base)
-, [Updated daily](https://dagster.opensource.observer/assets/base))
-- [Frax](https://www.frax.com/)
-([Reference docs](https://models.opensource.observer/#!/source_list/frax)
-, [Updated daily](https://dagster.opensource.observer/assets/frax))
-- [Metal](https://metall2.com/)
-([Reference docs](https://models.opensource.observer/#!/source_list/metal)
-, [Updated daily](https://dagster.opensource.observer/assets/metal))
-- [Mode](https://www.mode.network/)
-([Reference docs](https://models.opensource.observer/#!/source_list/mode)
-, [Updated daily](https://dagster.opensource.observer/assets/mode))
-- [PGN](https://publicgoods.network/)
-([Reference docs](https://models.opensource.observer/#!/source_list/pgn)
-, [Updated daily](https://dagster.opensource.observer/assets/pgn))
-- [Zora](https://zora.co/)
-([Reference docs](https://models.opensource.observer/#!/source_list/zora)
-, [Updated daily](https://dagster.opensource.observer/assets/zora))
-
-
-For example, to get deployed contracts from a particular address on the Base network:
+- Data on every OP Stack chain, maintained by [OP Labs PBC](https://www.oplabs.co/)
+[code of conduct](https://github.com/ethereum-optimism/op-analytics?tab=coc-ov-file#readme)
+- For more details on the ETL process please visit the [op-analytics](https://static.optimism.io/op-analytics) documentation site.
+- Visit the Optimism docs to learn more about the [Superchain](https://docs.optimism.io/stack/explainer).
+
+All tables are partitioned by date (`dt`) and clustered by chain name (`chain`). Data is updated daily with an approximate latency of 24 hrs.
+Data is sourced from [Goldsky](https://docs.goldsky.com/introduction) using the [Mirror platform](https://docs.goldsky.com/mirror/introduction), which fetches and delivers onchain data from RPC nodes to ClickHouse.
+From there, the OP Labs team runs an incremental ingestion process based on block number.
+
+For example, to get all transactions to the 4337 EntryPoint contracts for all OP Stack chains:
```sql
-select
- traces.block_timestamp,
- traces.transaction_hash,
- txs.from_address as originating_address,
- txs.to_address as originating_contract,
- traces.from_address as factory_address,
- traces.to_address as contract_address
-from `YOUR_PROJECT_NAME.superchain.base_traces` as traces
-inner join transactions as txs
- on txs.hash = traces.transaction_hash
-where
- LOWER(traces.from_address) != "0x3fab184622dc19b6109349b94811493bf2a45362"
- and LOWER(trace_type) in ("create", "create2")
+ select
+ dt,
+ chain,
+ count(*) as txns
+ from `optimism_superchain_raw_onchain_data.transactions`
+ where
+ dt >= '2024-10-01'
+ and to_address in (
+ "0x5ff137d4b0fdcd49dca30c7cf57e578a026d2789",
+ "0x0000000071727de22e5e9d8baf0edac6f37da032"
+ )
+ group by dt, chain
+ order by dt, chain
```
-**Remember to replace 'YOUR_PROJECT_NAME' with the name of your project in the query.**
-
### Arbitrum Data
@@ -335,7 +311,7 @@ where
- [Source documentation](https://docs.goldsky.com/introduction)
- [Updated weekly](https://github.com/opensource-observer/oso/blob/main/warehouse/oso_dagster/assets/arbitrum.py)
-[Arbitrum](https://arbitrum.foundation/) is a Layer 2 scaling solution for Ethereum. We currently provide blocks, transactions, and traces for Arbitrum's flagship network, Arbitrum One.
+[Arbitrum](https://arbitrum.foundation/) is a Layer 2 scaling solution for Ethereum. We currently provide blocks, transactions, and traces for Arbitrum's flagship network, Arbitrum One. This public dataset is maintained by our partners at [Goldsky](https://goldsky.com/).
For example, to get the average gas per transaction for each block on Arbitrum One on September 1st, 2024:
diff --git a/apps/docs/docs/integrate/overview/op.png b/apps/docs/docs/integrate/overview/op.png
new file mode 100644
index 000000000..563d7703b
Binary files /dev/null and b/apps/docs/docs/integrate/overview/op.png differ
diff --git a/apps/docs/docs/integrate/python-notebooks.md b/apps/docs/docs/integrate/python-notebooks.md
index 96fa13dea..e2d706502 100644
--- a/apps/docs/docs/integrate/python-notebooks.md
+++ b/apps/docs/docs/integrate/python-notebooks.md
@@ -508,7 +508,7 @@ The complete specification for an impact metric is available [here](../how-oso-w
#### 2. Define the Metric and Selection Criteria
-- **Metric**: Get inspiration from some of our [impact metrics](../how-oso-works/impact-metrics/index.mdx) or [propose a new metric](../contribute/impact-models.md). Examples: "Number of Full-Time Developer Months", "Number of Dependent Onchain Apps", "Layer 2 Gas Fees", "Number of New Contributors".
+- **Metric**: Get inspiration from some of our [impact metrics](../how-oso-works/impact-metrics/index.mdx) or [propose a new metric](../contribute/data-models.md). Examples: "Number of Full-Time Developer Months", "Number of Dependent Onchain Apps", "Layer 2 Gas Fees", "Number of New Contributors".
- **Time Period**: Specify a time interval for applying the metric. Examples: "Last 6 months", "Since the project's inception".
- **Selection Filter**: Make explicit the criteria to identify which projects are eligible (or ineligible) to be included in the analysis. Examples: "Projects with developer activity in the last 90 days", "Projects with NPM packages used by at least 5 onchain projects", "Projects with a permissive open source license (e.g., MIT, Apache 2.0) and a codebase that is at least 6 months old".
diff --git a/apps/docs/docs/integrate/query-data.mdx b/apps/docs/docs/integrate/query-data.mdx
index 3bf0e3c5c..1133159a6 100644
--- a/apps/docs/docs/integrate/query-data.mdx
+++ b/apps/docs/docs/integrate/query-data.mdx
@@ -93,4 +93,4 @@ If there is an intermediate model addition
(such as a new event type or aggregation)
that you think could help save costs for others in the future,
please consider contributing to our
-[data models](../contribute/impact-models.md).
+[data models](../contribute/data-models.md).