SettleMint SDK
✨ https://settlemint.com ✨
Integrate SettleMint into your application with ease.
Table of Contents
About
The SettleMint JavaScript SDK provides a type-safe wrapper around the SettleMint platform's GraphQL API. It enables you to interact with the platform's services in a fully typed manner, providing compile-time safety and autocompletion support.
API Reference
Functions
createSettleMintClient()
createSettleMintClient(options
): SettlemintClient
Defined in: settlemint.ts:216
Creates a SettleMint client with the provided options. The client provides methods to interact with
various SettleMint resources like workspaces, applications, blockchain networks, blockchain nodes, middleware,
integration tools, storage, private keys, insights and custom deployments.
Parameters
Parameter | Type | Description |
---|
options | SettlemintClientOptions | Configuration options for the client including access token and instance URL |
Returns
SettlemintClient
A SettleMint client object with resource-specific methods
Throws
If options are invalid or if called in browser environment
Throws
If provided options fail schema validation
Example
import { createSettleMintClient } from '@settlemint/sdk-js';
const client = createSettleMintClient({
accessToken: process.env.SETTLEMINT_ACCESS_TOKEN,
instance: process.env.SETTLEMINT_INSTANCE,
});
const workspaces = await client.workspace.list();
const workspace = await client.workspace.read('workspace-unique-name');
Interfaces
SettlemintClient
Defined in: settlemint.ts:111
Client interface for interacting with the SettleMint platform.
SettlemintClientOptions
Defined in: settlemint.ts:103
Options for the Settlemint client.
Extends
Properties
Property | Type | Default value | Description | Inherited from | Defined in |
---|
accessToken | string | AccessTokenSchema | The access token used to authenticate with the SettleMint platform | ClientOptions.accessToken | helpers/client-options.schema.ts:9 |
anonymous? | boolean | undefined | Whether to allow anonymous access (no access token required) | - | settlemint.ts:105 |
instance | string | UrlSchema | The URL of the SettleMint instance to connect to | ClientOptions.instance | helpers/client-options.schema.ts:11 |
Type Aliases
Application
Application: ResultOf
<typeof ApplicationFragment
>
Defined in: graphql/application.ts:24
Type representing an application entity.
BlockchainNetwork
BlockchainNetwork: ResultOf
<typeof BlockchainNetworkFragment
>
Defined in: graphql/blockchain-network.ts:32
Type representing a blockchain network entity.
BlockchainNode
BlockchainNode: ResultOf
<typeof BlockchainNodeFragment
>
Defined in: graphql/blockchain-node.ts:51
Type representing a blockchain node entity.
CustomDeployment
CustomDeployment: ResultOf
<typeof CustomDeploymentFragment
>
Defined in: graphql/custom-deployment.ts:33
Type representing a custom deployment entity.
Insights
Insights: ResultOf
<typeof InsightsFragment
>
Defined in: graphql/insights.ts:37
Type representing an insights entity.
IntegrationTool
IntegrationTool: ResultOf
<typeof IntegrationFragment
>
Defined in: graphql/integration-tool.ts:35
Type representing an integration tool entity.
Middleware
Middleware: ResultOf
<typeof MiddlewareFragment
>
Defined in: graphql/middleware.ts:43
Type representing a middleware entity.
MiddlewareWithSubgraphs
MiddlewareWithSubgraphs: ResultOf
<typeof getGraphMiddlewareSubgraphs
>["middlewareByUniqueName"
]
Defined in: graphql/middleware.ts:101
Type representing a middleware entity with subgraphs.
PlatformConfig
PlatformConfig: ResultOf
<typeof getPlatformConfigQuery
>["config"
]
Defined in: graphql/platform.ts:45
Type representing the platform configuration.
PrivateKey
PrivateKey: ResultOf
<typeof PrivateKeyFragment
>
Defined in: graphql/private-key.ts:27
Type representing a private key entity.
Storage
Storage: ResultOf
<typeof StorageFragment
>
Defined in: graphql/storage.ts:35
Type representing a storage entity.
Workspace
Workspace: ResultOf
<typeof WorkspaceFragment
>
Defined in: graphql/workspace.ts:26
Type representing a workspace entity.
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.