@settlemint/sdk-thegraph
TypeScript icon, indicating that this package has built-in type declarations

2.2.2 • Public • Published

SettleMint logo

SettleMint SDK

https://settlemint.com
Integrate SettleMint into your application with ease.

CI status License npm stars

Documentation   •   NPM   •   Issues

Table of Contents

About

The SettleMint TheGraph SDK provides a seamless way to interact with TheGraph APIs for blockchain data indexing and querying. It enables you to easily create and manage subgraphs, define schemas, and query indexed blockchain data using GraphQL from your SettleMint-powered blockchain networks.

The SDK offers a type-safe interface for all TheGraph operations, with comprehensive error handling and validation. It integrates smoothly with modern TypeScript applications while providing a simple and intuitive developer experience.

API Reference

Functions

createTheGraphClient()

createTheGraphClient<Setup>(options, clientOptions?): object

Defined in: sdk/thegraph/src/thegraph.ts:90

Creates a TheGraph GraphQL client with proper type safety using gql.tada

Type Parameters
Type Parameter
Setup extends AbstractSetupSchema
Parameters
Parameter Type Description
options { accessToken: string; cache?: "default" | "force-cache" | "no-cache" | "no-store" | "only-if-cached" | "reload"; instances: string[]; subgraphName: string; } Configuration options for the client including instance URLs, access token and subgraph name
options.accessToken string -
options.cache? "default" | "force-cache" | "no-cache" | "no-store" | "only-if-cached" | "reload" -
options.instances? string[] -
options.subgraphName? string -
clientOptions? RequestConfig Optional GraphQL client configuration options
Returns

object

An object containing: - client: The configured GraphQL client instance - graphql: The initialized gql.tada function for type-safe queries

Name Type Defined in
client GraphQLClient sdk/thegraph/src/thegraph.ts:94
graphql initGraphQLTada<Setup> sdk/thegraph/src/thegraph.ts:95
Throws

Will throw an error if the options fail validation against ClientOptionsSchema

Example
import { createTheGraphClient } from '@settlemint/sdk-thegraph';
import type { introspection } from '@schemas/the-graph-env-kits';
import { createLogger, requestLogger } from '@settlemint/sdk-utils/logging';

const logger = createLogger();

const { client, graphql } = createTheGraphClient<{
  introspection: introspection;
  disableMasking: true;
  scalars: {
    Bytes: string;
    Int8: string;
    BigInt: string;
    BigDecimal: string;
    Timestamp: string;
  };
}>({
  instances: JSON.parse(process.env.SETTLEMINT_THEGRAPH_SUBGRAPHS_ENDPOINTS || '[]'),
  accessToken: process.env.SETTLEMINT_ACCESS_TOKEN!,
  subgraphName: 'kits'
}, {
  fetch: requestLogger(logger, "the-graph-kits", fetch) as typeof fetch,
});

// Making GraphQL queries
const query = graphql(`
  query SearchAssets {
    assets {
      id
      name
      symbol
    }
  }
`);

const result = await client.request(query);

Type Aliases

ClientOptions

ClientOptions = object

Defined in: sdk/thegraph/src/thegraph.ts:25

Type definition for client options derived from the ClientOptionsSchema

Type declaration
Name Type Default value Defined in
accessToken string ApplicationAccessTokenSchema sdk/thegraph/src/thegraph.ts:17
cache? "default" | "force-cache" | "no-cache" | "no-store" | "only-if-cached" | "reload" - sdk/thegraph/src/thegraph.ts:19
instances string[] - sdk/thegraph/src/thegraph.ts:16
subgraphName string - sdk/thegraph/src/thegraph.ts:18

RequestConfig

RequestConfig = ConstructorParameters<typeof GraphQLClient>[1]

Defined in: sdk/thegraph/src/thegraph.ts:10

Type definition for GraphQL client configuration options

Variables

ClientOptionsSchema

const ClientOptionsSchema: ZodObject<ClientOptions>

Defined in: sdk/thegraph/src/thegraph.ts:15

Schema for validating client options for the TheGraph client.

Contributing

We welcome contributions from the community! Please check out our Contributing guide to learn how you can help improve the SettleMint SDK through bug reports, feature requests, documentation updates, or code contributions.

License

The SettleMint SDK is released under the FSL Software License. See the LICENSE file for more details.

Package Sidebar

Install

npm i @settlemint/sdk-thegraph

Weekly Downloads

3,656

Version

2.2.2

License

FSL-1.1-MIT

Unpacked Size

34 kB

Total Files

9

Last publish

Collaborators

  • roderik
  • patrickmualaba
  • janb87