feat: integrate The Graph support into EAS client

.bun-version

@@ -1 +1 @@
-1.2.20
+1.2.22

.github/workflows/e2e-reset.yml

@@ -24,6 +24,8 @@ jobs:
 
       - name: Load secrets
         uses: 1password/load-secrets-action@13f58eec611f8e5db52ec16247f58c508398f3e6 # v3
+        with:
+          export-env: true
         env:
           E2E_GITHUB_TOKEN: "op://platform/SDK E2E/github-token"
           SETTLEMINT_ACCESS_TOKEN_E2E_TESTS: "op://platform/SDK E2E/pat-token"

.github/workflows/e2e.yml

@@ -28,6 +28,8 @@ jobs:
 
       - name: Load secrets
         uses: 1password/load-secrets-action@13f58eec611f8e5db52ec16247f58c508398f3e6 # v3
+        with:
+          export-env: true
         env:
           E2E_GITHUB_TOKEN: "op://platform/SDK E2E/github-token"
           SETTLEMINT_ACCESS_TOKEN_E2E_TESTS: "op://platform/SDK E2E/pat-token"
@@ -39,7 +41,7 @@ jobs:
         uses: namespacelabs/nscloud-checkout-action@953fed31a6113cc2347ca69c9d823743c65bc84b # v7
 
       - name: Setup caches
-        uses: namespacelabs/nscloud-cache-action@305bfa7ea980a858d511af4899414a84847c7991 # v1
+        uses: namespacelabs/nscloud-cache-action@a289cf5d2fcd6874376aa92f0ef7f99dc923592a # v1
         with:
           path: |
             ./.turbo
@@ -51,7 +53,7 @@ jobs:
           bun-version-file: .bun-version
 
       - name: Install Node.js
-        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
+        uses: actions/setup-node@a0853c24544627f65ddf259abe73b1d18a591444 # v5
         with:
           node-version-file: package.json
           token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/qa.yml

@@ -72,6 +72,8 @@ jobs:
       - name: Load all secrets
         id: secrets
         uses: 1password/load-secrets-action@13f58eec611f8e5db52ec16247f58c508398f3e6 # v3
+        with:
+          export-env: true
         env:
           SLACK_BOT_TOKEN: op://platform/slack-bot/SLACK_BOT_TOKEN
           SLACK_CHANNEL_ID: op://platform/slack-bot/SLACK_CHANNEL_ID
@@ -118,6 +120,10 @@ jobs:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           npm_token: ${{ env.NPM_TOKEN }}
           disable_node: "true"
+
+      - name: Inject slug/short variables
+        uses: rlespinasse/github-slug-action@c33ff65466c58d57e4d796f88bb1ae0ff26ee453 # v5
+
       - name: Update package versions
         if: github.event_name == 'pull_request' || github.event_name == 'push' || github.event_name == 'release'
         id: package-version
@@ -231,6 +237,8 @@ jobs:
                 | SDK IPFS | `@settlemint/sdk-ipfs@${{ env.VERSION }}` | |
                 | SDK Blockscout | `@settlemint/sdk-blockscout@${{ env.VERSION }}` | |
                 | SDK MCP | `@settlemint/sdk-mcp@${{ env.VERSION }}` | |
+                | SDK Viem | `@settlemint/sdk-viem@${{ env.VERSION }}` | |
+                | SDK EAS | `@settlemint/sdk-eas@${{ env.VERSION }}` | |
 
       - name: Auto-commit updated package versions
         uses: stefanzweifel/git-auto-commit-action@778341af668090896ca464160c2def5d1d1a3eb0 # v6
@@ -380,6 +388,8 @@ jobs:
 
       - name: Load Slack secrets
         uses: 1password/load-secrets-action@13f58eec611f8e5db52ec16247f58c508398f3e6 # v3
+        with:
+          export-env: true
         env:
           SLACK_BOT_TOKEN: op://platform/slack-bot/SLACK_BOT_TOKEN
           SLACK_CHANNEL_ID: op://platform/slack-bot/SLACK_CHANNEL_ID
@@ -432,6 +442,8 @@ jobs:
 
       - name: Load Slack secrets
         uses: 1password/load-secrets-action@13f58eec611f8e5db52ec16247f58c508398f3e6 # v3
+        with:
+          export-env: true
         env:
           SLACK_BOT_TOKEN: op://platform/slack-bot/SLACK_BOT_TOKEN
           SLACK_CHANNEL_ID: op://platform/slack-bot/SLACK_CHANNEL_ID

.node-version

@@ -1 +1 @@
-24.6.0
+24.8.0

biome.json

@@ -9,7 +9,17 @@
       "!contracts/artifacts",
       "!**/graphql-env.d.ts",
       "!**/graphql-cache.d.ts",
-      "!**/sdk/js/schema.graphql"
+      "!**/sdk/js/schema.graphql",
+      "!sdk/eas/subgraph/generated",
+      "!sdk/eas/subgraph/build",
+      "!sdk/eas/subgraph/abis",
+      "!sdk/portal/src/examples/schemas/portal-schema.graphql"
+    ],
+    "experimentalScannerIgnores": [
+      "sdk/eas/subgraph/generated/**",
+      "sdk/eas/subgraph/build/**",
+      "sdk/eas/subgraph/abis/**",
+      "sdk/portal/src/examples/schemas/portal-schema.graphql"
     ]
   },
   "linter": {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdk",
-  "version": "2.5.7",
+  "version": "2.6.2",
   "private": true,
   "license": "FSL-1.1-MIT",
   "author": {
@@ -42,15 +42,16 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "0.18.2",
-    "@biomejs/biome": "2.2.0",
-    "@types/bun": "1.2.20",
+    "@biomejs/biome": "2.2.4",
+    "@types/bun": "1.2.21",
     "@types/mustache": "4.2.6",
-    "knip": "5.62.0",
+    "bun-types": "1.2.22-canary.20250910T140559",
+    "knip": "5.63.1",
     "mustache": "4.2.0",
     "publint": "0.3.12",
-    "tsdown": "^0.14.0",
+    "tsdown": "^0.15.0",
     "turbo": "2.5.6",
-    "typedoc": "0.28.10",
+    "typedoc": "0.28.13",
     "typedoc-plugin-markdown": "4.8.1",
     "typedoc-plugin-merge-modules": "7.0.0",
     "typedoc-plugin-zod": "1.4.2",
@@ -80,7 +81,9 @@
     "ws": "8.18.3",
     "adm-zip": "0.5.16",
     "react-is": "19.1.1",
-    "undici": "7.14.0"
+    "undici": "7.16.0"
   },
-  "dependencies": {}
+  "dependencies": {
+    "@graphprotocol/graph-cli": "0.97.1"
+  }
 }

scripts/generate-readme.ts

@@ -27,7 +27,11 @@ async function generateReadme() {
     const sdkDir = join(__dirname, "..", "sdk");
     console.log(`Scanning SDK directory: ${sdkDir}`);
     const sdkDirEntries = await readdir(sdkDir, { withFileTypes: true });
-    const packages = sdkDirEntries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+    const packages = sdkDirEntries
+      .filter((entry) => entry.isDirectory())
+      .map((entry) => entry.name)
+      .filter((entry) => entry !== "test")
+      .sort();
     console.log(`Found ${packages.length} packages`);
 
     // Generate README for each package

sdk/blockscout/README.md

@@ -50,7 +50,7 @@ The SettleMint Blockscout SDK provides a seamless way to interact with Blockscou
 
 > **createBlockscoutClient**\<`Setup`\>(`options`, `clientOptions?`): `object`
 
-Defined in: [sdk/blockscout/src/blockscout.ts:76](https://github.com/settlemint/sdk/blob/v2.5.7/sdk/blockscout/src/blockscout.ts#L76)
+Defined in: [sdk/blockscout/src/blockscout.ts:76](https://github.com/settlemint/sdk/blob/v2.6.2/sdk/blockscout/src/blockscout.ts#L76)
 
 Creates a Blockscout GraphQL client with proper type safety using gql.tada
 
@@ -77,8 +77,8 @@ An object containing the GraphQL client and initialized gql.tada function
 
 | Name | Type | Defined in |
 | ------ | ------ | ------ |
-| `client` | `GraphQLClient` | [sdk/blockscout/src/blockscout.ts:80](https://github.com/settlemint/sdk/blob/v2.5.7/sdk/blockscout/src/blockscout.ts#L80) |
-| `graphql` | `initGraphQLTada`\<`Setup`\> | [sdk/blockscout/src/blockscout.ts:81](https://github.com/settlemint/sdk/blob/v2.5.7/sdk/blockscout/src/blockscout.ts#L81) |
+| `client` | `GraphQLClient` | [sdk/blockscout/src/blockscout.ts:80](https://github.com/settlemint/sdk/blob/v2.6.2/sdk/blockscout/src/blockscout.ts#L80) |
+| `graphql` | `initGraphQLTada`\<`Setup`\> | [sdk/blockscout/src/blockscout.ts:81](https://github.com/settlemint/sdk/blob/v2.6.2/sdk/blockscout/src/blockscout.ts#L81) |
 
 ##### Throws
 
@@ -136,24 +136,24 @@ const result = await client.request(query, {
 
 > **ClientOptions** = `object`
 
-Defined in: [sdk/blockscout/src/blockscout.ts:24](https://github.com/settlemint/sdk/blob/v2.5.7/sdk/blockscout/src/blockscout.ts#L24)
+Defined in: [sdk/blockscout/src/blockscout.ts:24](https://github.com/settlemint/sdk/blob/v2.6.2/sdk/blockscout/src/blockscout.ts#L24)
 
 Type definition for client options derived from the ClientOptionsSchema
 
-##### Type declaration
+##### Type Declaration
 
 | Name | Type | Default value | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="accesstoken"></a> `accessToken?` | `string` | - | [sdk/blockscout/src/blockscout.ts:18](https://github.com/settlemint/sdk/blob/v2.5.7/sdk/blockscout/src/blockscout.ts#L18) |
-| <a id="instance"></a> `instance` | `string` | `UrlOrPathSchema` | [sdk/blockscout/src/blockscout.ts:17](https://github.com/settlemint/sdk/blob/v2.5.7/sdk/blockscout/src/blockscout.ts#L17) |
+| <a id="accesstoken"></a> `accessToken?` | `string` | - | [sdk/blockscout/src/blockscout.ts:18](https://github.com/settlemint/sdk/blob/v2.6.2/sdk/blockscout/src/blockscout.ts#L18) |
+| <a id="instance"></a> `instance` | `string` | `UrlOrPathSchema` | [sdk/blockscout/src/blockscout.ts:17](https://github.com/settlemint/sdk/blob/v2.6.2/sdk/blockscout/src/blockscout.ts#L17) |
 
 ***
 
 #### RequestConfig
 
 > **RequestConfig** = `ConstructorParameters`\<*typeof* `GraphQLClient`\>\[`1`\]
 
-Defined in: [sdk/blockscout/src/blockscout.ts:11](https://github.com/settlemint/sdk/blob/v2.5.7/sdk/blockscout/src/blockscout.ts#L11)
+Defined in: [sdk/blockscout/src/blockscout.ts:11](https://github.com/settlemint/sdk/blob/v2.6.2/sdk/blockscout/src/blockscout.ts#L11)
 
 Type definition for GraphQL client configuration options
 
@@ -163,7 +163,7 @@ Type definition for GraphQL client configuration options
 
 > `const` **ClientOptionsSchema**: `ZodObject`\<[`ClientOptions`](#clientoptions)\>
 
-Defined in: [sdk/blockscout/src/blockscout.ts:16](https://github.com/settlemint/sdk/blob/v2.5.7/sdk/blockscout/src/blockscout.ts#L16)
+Defined in: [sdk/blockscout/src/blockscout.ts:16](https://github.com/settlemint/sdk/blob/v2.6.2/sdk/blockscout/src/blockscout.ts#L16)
 
 Schema for validating client options for the Blockscout client.
 

sdk/cli/README.md

@@ -249,7 +249,7 @@ settlemint scs subgraph deploy --accept-defaults <subgraph-name>
 
 ## API Reference
 
-See the [documentation](https://github.com/settlemint/sdk/tree/v2.5.7/sdk/cli/docs/settlemint.md) for available commands.
+See the [documentation](https://github.com/settlemint/sdk/tree/v2.6.2/sdk/cli/docs/settlemint.md) for available commands.
 
 ## Contributing
 

sdk/cli/docs/settlemint/codegen.md

@@ -18,6 +18,7 @@ Options:
   --prod                                         Connect to your production environment
   --thegraph-subgraph-names <subgraph-names...>  The name(s) of the TheGraph subgraph(s) to generate (skip if you want to generate all)
   --generate-viem                                Generate Viem resources
+  --bun                                          Generate Bun SQL code instead of PostgreSQL pool for Hasura
   -h, --help                                     display help for command
 </pre>
 

sdk/cli/package.json

@@ -44,33 +44,33 @@
   },
   "dependencies": {
     "@gql.tada/cli-utils": "1.7.1",
-    "@inquirer/core": "10.1.15",
+    "@inquirer/core": "10.2.2",
     "node-fetch-native": "1.6.7",
     "zod": "^4"
   },
   "devDependencies": {
     "@commander-js/extra-typings": "14.0.0",
-    "commander": "14.0.0",
-    "@inquirer/confirm": "5.1.15",
-    "@inquirer/input": "4.2.1",
-    "@inquirer/password": "4.0.17",
-    "@inquirer/select": "4.3.1",
+    "commander": "14.0.1",
+    "@inquirer/confirm": "5.1.18",
+    "@inquirer/input": "4.2.4",
+    "@inquirer/password": "4.0.20",
+    "@inquirer/select": "4.3.4",
     "@settlemint/sdk-hasura": "workspace:*",
     "@settlemint/sdk-js": "workspace:*",
     "@settlemint/sdk-utils": "workspace:*",
     "@settlemint/sdk-viem": "workspace:*",
-    "@types/node": "24.3.0",
-    "@types/semver": "7.7.0",
+    "@types/node": "24.5.2",
+    "@types/semver": "7.7.1",
     "@types/which": "3.0.4",
     "get-tsconfig": "4.10.1",
     "giget": "2.0.0",
     "is-in-ci": "2.0.0",
     "semver": "7.7.2",
     "slugify": "1.6.6",
-    "viem": "2.33.3",
+    "viem": "2.37.6",
     "which": "5.0.0",
     "yaml": "2.8.1",
-    "yoctocolors": "2.1.1",
+    "yoctocolors": "2.1.2",
     "yocto-spinner": "^1.0.0"
   },
   "peerDependencies": {

sdk/cli/src/commands/codegen.ts

@@ -1,14 +1,14 @@
+import { Command } from "@commander-js/extra-typings";
+import { generateOutput } from "@gql.tada/cli-utils";
+import { loadEnv } from "@settlemint/sdk-utils/environment";
+import { intro, note, outro, spinner } from "@settlemint/sdk-utils/terminal";
+import type { DotEnv } from "@settlemint/sdk-utils/validation";
 import { codegenHasura } from "@/commands/codegen/codegen-hasura";
 import { codegenPortal } from "@/commands/codegen/codegen-portal";
 import { codegenTheGraph } from "@/commands/codegen/codegen-the-graph";
 import { codegenTsconfig } from "@/commands/codegen/codegen-tsconfig";
 import { subgraphPrompt } from "@/prompts/smart-contract-set/subgraph.prompt";
 import { createExamples } from "@/utils/commands/create-examples";
-import { Command } from "@commander-js/extra-typings";
-import { generateOutput } from "@gql.tada/cli-utils";
-import { loadEnv } from "@settlemint/sdk-utils/environment";
-import { intro, note, outro, spinner } from "@settlemint/sdk-utils/terminal";
-import type { DotEnv } from "@settlemint/sdk-utils/validation";
 import { codegenBlockscout } from "./codegen/codegen-blockscout";
 import { codegenIpfs, shouldCodegenIpfs } from "./codegen/codegen-ipfs";
 import { codegenMinio, shouldCodegenMinio } from "./codegen/codegen-minio";
@@ -31,6 +31,7 @@ export function codegenCommand(): Command {
         "The name(s) of the TheGraph subgraph(s) to generate (skip if you want to generate all)",
       )
       .option("--generate-viem", "Generate Viem resources")
+      .option("--bun", "Generate Bun SQL code instead of PostgreSQL pool for Hasura")
       // Set the command description
       .description("Generate GraphQL and REST types and queries")
       .usage(
@@ -50,7 +51,7 @@ export function codegenCommand(): Command {
         ]),
       )
       // Define the action to be executed when the command is run
-      .action(async ({ prod, thegraphSubgraphNames, generateViem }) => {
+      .action(async ({ prod, thegraphSubgraphNames, generateViem, bun }) => {
         intro("Generating GraphQL types and queries for your dApp");
         const env: DotEnv = await loadEnv(true, !!prod);
 
@@ -78,7 +79,7 @@ export function codegenCommand(): Command {
 
         if (hasura) {
           note("Generating Hasura resources");
-          await codegenHasura(env);
+          await codegenHasura(env, bun);
         }
         if (portal) {
           note("Generating Portal resources");

sdk/cli/src/commands/codegen/codegen-blockscout.ts

@@ -1,13 +1,13 @@
 import { rm, writeFile } from "node:fs/promises";
 import { basename, resolve } from "node:path";
-import { writeTemplate } from "@/commands/codegen/utils/write-template";
-import { getApplicationOrPersonalAccessToken } from "@/utils/get-app-or-personal-token";
 import { generateSchema } from "@gql.tada/cli-utils";
 import { projectRoot } from "@settlemint/sdk-utils/filesystem";
 import { appendHeaders, graphqlFetchWithRetry } from "@settlemint/sdk-utils/http";
 import { installDependencies, isPackageInstalled } from "@settlemint/sdk-utils/package-manager";
 import { note } from "@settlemint/sdk-utils/terminal";
 import { type DotEnv, LOCAL_INSTANCE, STANDALONE_INSTANCE } from "@settlemint/sdk-utils/validation";
+import { writeTemplate } from "@/commands/codegen/utils/write-template";
+import { getApplicationOrPersonalAccessToken } from "@/utils/get-app-or-personal-token";
 
 const PACKAGE_NAME = "@settlemint/sdk-blockscout";
 
@@ -167,6 +167,18 @@ import { createLogger, requestLogger, type LogLevel } from '@settlemint/sdk-util
 
 const logger = createLogger({ level: process.env.SETTLEMINT_LOG_LEVEL as LogLevel });
 
+// Validate required environment variables
+const blockscoutEndpoint = process.env.SETTLEMINT_BLOCKSCOUT_ENDPOINT;
+const blockscoutUiEndpointVar = process.env.SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT;
+
+if (!blockscoutEndpoint) {
+  throw new Error('SETTLEMINT_BLOCKSCOUT_ENDPOINT environment variable is required');
+}
+
+if (!blockscoutUiEndpointVar) {
+  throw new Error('SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT environment variable is required');
+}
+
 export const { client: blockscoutClient, graphql: blockscoutGraphql } = createBlockscoutClient<{
   introspection: introspection;
   disableMasking: true;
@@ -189,13 +201,13 @@ export const { client: blockscoutClient, graphql: blockscoutGraphql } = createBl
     Wei: string;
   };
 }>({
-  instance: process.env.SETTLEMINT_BLOCKSCOUT_ENDPOINT!,
+  instance: blockscoutEndpoint,
   accessToken: process.env.SETTLEMINT_ACCESS_TOKEN,
 }, {
   fetch: requestLogger(logger, "blockscout", fetch) as typeof fetch,
 });
 
-export const blockscoutUiEndpoint = process.env.SETTLEMINT_BLOCKSCOUT_UI_ENDPOINT!;`;
+export const blockscoutUiEndpoint = blockscoutUiEndpointVar;`;
 
   await writeTemplate(template, "/lib/settlemint", "blockscout.ts");