@settlemint/sdk-blockscout/dist/blockscout.cjs

Blockscout integration module for SettleMint SDK, enabling blockchain explorer and analytics functionality

/* SettleMint Blockscout SDK - Blockchain Explorer */
let _settlemint_sdk_utils_http = require("@settlemint/sdk-utils/http");
let _settlemint_sdk_utils_runtime = require("@settlemint/sdk-utils/runtime");
let _settlemint_sdk_utils_validation = require("@settlemint/sdk-utils/validation");
let gql_tada = require("gql.tada");
let graphql_request = require("graphql-request");
let zod = require("zod");

//#region src/blockscout.ts
/**
* Schema for validating client options for the Blockscout client.
*/
const ClientOptionsSchema = zod.z.object({
	instance: _settlemint_sdk_utils_validation.UrlOrPathSchema,
	accessToken: _settlemint_sdk_utils_validation.ApplicationAccessTokenSchema.optional()
});
/**
* Creates a Blockscout GraphQL client with proper type safety using gql.tada
*
* @param options - Configuration options for the client
* @param clientOptions - Optional GraphQL client configuration options
* @returns An object containing the GraphQL client and initialized gql.tada function
* @throws Will throw an error if the options fail validation
* @example
* import { createBlockscoutClient } from '@settlemint/sdk-blockscout';
* import type { introspection } from "@schemas/blockscout-env";
* import { createLogger, requestLogger } from '@settlemint/sdk-utils/logging';
*
* const logger = createLogger();
*
* const { client, graphql } = createBlockscoutClient<{
*   introspection: introspection;
*   disableMasking: true;
*   scalars: {
*     AddressHash: string;
*     Data: string;
*     DateTime: string;
*     Decimal: string;
*     FullHash: string;
*     Json: string;
*     NonceHash: string;
*     Wei: string;
*   };
* }>({
*   instance: process.env.SETTLEMINT_BLOCKSCOUT_ENDPOINT,
*   accessToken: process.env.SETTLEMINT_ACCESS_TOKEN
* }, {
*   fetch: requestLogger(logger, "blockscout", fetch) as typeof fetch,
* });
*
* // Making GraphQL queries
* const query = graphql(`
*   query GetTransaction($hash: String!) {
*     transaction(hash: $hash) {
*       hash
*       blockNumber
*       value
*       gasUsed
*     }
*   }
* `);
*
* const result = await client.request(query, {
*   hash: "0x123abc..."
* });
*/
function createBlockscoutClient(options, clientOptions) {
	(0, _settlemint_sdk_utils_runtime.ensureServer)();
	const validatedOptions = (0, _settlemint_sdk_utils_validation.validate)(ClientOptionsSchema, options);
	const graphql = (0, gql_tada.initGraphQLTada)();
	const fullUrl = new URL(validatedOptions.instance).toString();
	return {
		client: new graphql_request.GraphQLClient(fullUrl, {
			...clientOptions,
			headers: (0, _settlemint_sdk_utils_http.appendHeaders)(clientOptions?.headers, { "x-auth-token": validatedOptions.accessToken })
		}),
		graphql
	};
}

//#endregion
exports.ClientOptionsSchema = ClientOptionsSchema;
exports.createBlockscoutClient = createBlockscoutClient;
Object.defineProperty(exports, 'readFragment', {
  enumerable: true,
  get: function () {
    return gql_tada.readFragment;
  }
});
//# sourceMappingURL=blockscout.cjs.map