clockworklabs/SpacetimeDB · error · Error

SpacetimeDBQueryClient can only handle spacetimedb queries,

Error message

SpacetimeDBQueryClient can only handle spacetimedb queries, got: ${prefix}

What it means

Error "SpacetimeDBQueryClient can only handle spacetimedb queries, got: ${prefix}" thrown in clockworklabs/SpacetimeDB.

Source

Thrown at crates/bindings-typescript/src/tanstack/SpacetimeDBQueryClient.ts:135

          }
        }
      });
  }

  queryFn: QueryFunction<any[], QueryKey> = async ({
    queryKey,
  }: {
    queryKey: QueryKey;
  }) => {
    const keyStr = JSON.stringify(queryKey);
    const [prefix, accessorName, querySql] = queryKey as [
      string,
      string,
      string,
    ];

    if (prefix !== 'spacetimedb') {
      throw new Error(
        `SpacetimeDBQueryClient can only handle spacetimedb queries, got: ${prefix}`
      );
    }

    const registered = queryRegistry.get(querySql);
    const whereExpr = registered?.whereExpr;

    const existingSub = this.subscriptions.get(keyStr);
    if (existingSub?.applied) {
      return this.getTableData(existingSub.tableInstance, whereExpr);
    }

    // queue query if connection not ready yet
    if (!this.connection) {
      return new Promise<any[]>(resolve => {
        const pending = this.pendingQueries.get(keyStr) || [];
        pending.push({ resolve, querySql, whereExpr });
        this.pendingQueries.set(keyStr, pending);

View on GitHub (pinned to 524b4487d9)

When it happens

Trigger: Thrown at crates/bindings-typescript/src/tanstack/SpacetimeDBQueryClient.ts:135 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of clockworklabs/SpacetimeDB@524b4487d9 (2026-08-16). Data as JSON: /api/errors/a8abef0b9156d41b. Report an issue: GitHub.