SettleMint SDK

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

Table of Contents

• About
• API Reference
• Contributing
• License

About

The SettleMint Blockscout SDK provides a seamless way to interact with Blockscout APIs for blockchain data exploration and analysis. It enables you to easily query transaction data, blocks, addresses, smart contracts and more from your SettleMint-powered blockchain networks.

For detailed information about using Blockscout with the SettleMint platform, check out our official documentation.

API Reference

Functions

createBlockscoutClient()

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

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

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

Type Parameters

Parameters

Returns

object

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

Throws

Will throw an error if the options fail validation against ClientOptionsSchema

Example

// Server-side usage
const { client } = createBlockscoutClient({
  instance: 'https://your-blockscout-instance.com',
  accessToken: 'your-access-token'
});

// Browser-side usage
const { client } = createBlockscoutClient({});

// Making GraphQL queries
const { client, graphql } = createBlockscoutClient({
  instance: 'https://your-blockscout-instance.com',
  accessToken: 'your-access-token'
});

const query = graphql(`
  query GetTransaction($hash: String!) {
    transaction(hash: $hash) {
      hash
      blockNumber
      value
      gasUsed
    }
  }
`);

const result = await client.request(query, {
  hash: "0x123abc..."
});

Type Aliases

ClientOptions

ClientOptions: z.infer<*typeof* ClientOptionsSchema>

Defined in: sdk/blockscout/src/blockscout.ts:32

Type definition for client options derived from the ClientOptionsSchema.

RequestConfig

RequestConfig: ConstructorParameters<*typeof* GraphQLClient>[1]

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

Options for configuring the GraphQL client, excluding 'url' and other configuration options.

Variables

ClientOptionsSchema

const ClientOptionsSchema: ZodDiscriminatedUnion<"runtime", [ZodObject<{ accessToken: ZodString; instance: ZodUnion<[ZodString, ZodString]>; runtime: ZodLiteral<"server">; }, "strip", { accessToken: string; instance: string; runtime: "server"; }, { accessToken: string; instance: string; runtime: "server"; }>, ZodObject<{ runtime: ZodLiteral<"browser">; }, "strip", { runtime: "browser"; }, { runtime: "browser"; }>]>

Defined in: sdk/blockscout/src/blockscout.ts:18

Schema for validating client options for the Blockscout client. Defines two possible runtime configurations:

1. Server-side with instance URL and access token
2. Browser-side with no additional configuration needed

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.