diff --git a/.github/workflows/deploy_switch_ensnode_environment.yml b/.github/workflows/deploy_switch_ensnode_environment.yml index 2b5255beb..b6fc48590 100644 --- a/.github/workflows/deploy_switch_ensnode_environment.yml +++ b/.github/workflows/deploy_switch_ensnode_environment.yml @@ -86,6 +86,9 @@ jobs: redis-cli -u $REDIS_URL SET traefik/http/routers/lb-header-sepolia-api-router/service "${TARGET_ENVIRONMENT}-sepolia-api" redis-cli -u $REDIS_URL SET traefik/http/routers/lb-header-sepolia-indexer-router/service "${TARGET_ENVIRONMENT}-sepolia-indexer" + # ENSDB PLAYGROUND + redis-cli -u $REDIS_URL SET traefik/http/routers/ensdb-playground-router/service "${TARGET_ENVIRONMENT}-ensdb-playground" + # ENSRAINBOW redis-cli -u $REDIS_URL SET traefik/http/routers/ensrainbow-api-router/service "${TARGET_ENVIRONMENT}-ensrainbow-api" diff --git a/docs/ensnode.io/config/integrations/starlight/sidebar-topics/integrate.ts b/docs/ensnode.io/config/integrations/starlight/sidebar-topics/integrate.ts index 0fc00d46e..edfb489f9 100644 --- a/docs/ensnode.io/config/integrations/starlight/sidebar-topics/integrate.ts +++ b/docs/ensnode.io/config/integrations/starlight/sidebar-topics/integrate.ts @@ -173,6 +173,10 @@ export const integrateSidebarTopic = { }, ], }, + { + label: "Interactive Playground", + link: "/docs/integrate/unigraph/interactive-playground", + }, { label: "Schema Reference", link: "/docs/integrate/unigraph/schema-reference", diff --git a/docs/ensnode.io/src/content/docs/docs/integrate/unigraph/interactive-playground.mdx b/docs/ensnode.io/src/content/docs/docs/integrate/unigraph/interactive-playground.mdx new file mode 100644 index 000000000..214aff96f --- /dev/null +++ b/docs/ensnode.io/src/content/docs/docs/integrate/unigraph/interactive-playground.mdx @@ -0,0 +1,41 @@ +--- +title: ENSDb Interactive Playground +description: Use an interactive ENSDb playground to query the ENS Unigraph from a read-only ENSDb Snapshot. +tableOfContents: false +sidebarDocked: true +--- + +import { LinkCard } from "@astrojs/starlight/components"; + +Use an interactive ENSDb playground to query the [ENS Unigraph](/docs/integrate/unigraph/concepts#indexed-data-model) from a read-only [ENSDb Snapshot](/docs/integrate/integration-options/ensdb-cli). + + + +## Get started + +1. Click the "_ENSDb Alpha (read-only snapshot)_" button below to connect to a read-only ENSDb Snapshot Server. + + :::caution[This playground hosts a point-in-time snapshot, not a live ENSDb] + This interactive playground hosts a [point-in-time snapshot](/docs/integrate/integration-options/ensdb-cli) of an [ENSDb instance](/docs/services/ensdb/concepts/database-schemas#ensdb-instance), and does not expose a live ENSDb with the current state of ENS. However, it is still a convenient way to explore the ENS Unigraph data model and run some test queries without needing to deploy ENSNode in order to access your own live ENSDb instance. + + This snapshot was taken at a single point in time from the [ENSNode Alpha `v1.16.0` hosted instance](/docs/hosted-instances#ensnode-alpha). + ::: + +2. Browse tables in the [ENSDb Writer Schema](/docs/services/ensdb/concepts/database-schemas#ensdb-writer-schema) (named as `alpha` in this example ENSDb instance) and the [ENSNode Schema](/docs/services/ensdb/concepts/database-schemas#ensnode-schema) (always named as `ensnode`). + +3. Use the "_SQL Console_" to explore possible queries against the ENS Unigraph data model. + +4. Use "_Schema_" to view the schema of each table, including columns and indexes. + +:::caution[Interactive Playground Performance] + +The interactive playground is powered by a [Drizzle Gateway](https://gateway.drizzle.team/) instance. Occasional slow query performance is a known limitation of Drizzle Gateway and is not indicative of an issue with ENSNode or the underlying ENSDb instance. If you experience this, please try again shortly. + +::: + +