Skip to main content
Version: v0.19.2

Client

Obol sdk Client can be used for creating, managing and activating distributed validators.

Extends

  • Base

Constructors

new Client(config, signer)

new Client(config, signer?): Client

Parameters

ParameterTypeDescription
configObjectClient configurations
config.baseUrl?stringobol-api url
config.chainId?numberBlockchain network ID
signer?SignerethersJS Signer

Returns

Client

Obol-SDK Client instance

An example of how to instantiate obol-sdk Client: obolClient

Overrides

Base.constructor

Source

index.ts:30

Methods

createClusterDefinition()

createClusterDefinition(newCluster): Promise< string >

Creates a cluster definition which contains cluster configuration.

Parameters

ParameterTypeDescription
newClusterClusterPayloadThe new unique cluster.

Returns

Promise< string >

config_hash.

Throws

On duplicate entries, missing or wrong cluster keys.

An example of how to use createClusterDefinition: createObolCluster

Source

index.ts:45


acceptClusterDefinition()

acceptClusterDefinition(operatorPayload, configHash): Promise< ClusterDefintion >

Approves joining a cluster with specific configuration.

Parameters

ParameterTypeDescription
operatorPayloadOperatorPayloadThe operator data including signatures.
configHashstringThe config hash of the cluster which the operator confirms joining to.

Returns

Promise< ClusterDefintion >

The cluster definition.

Throws

On unauthorized, duplicate entries, missing keys, not found cluster or invalid data.

An example of how to use acceptClusterDefinition: acceptClusterDefinition

Source

index.ts:96


getClusterDefinition()

getClusterDefinition(configHash): Promise< ClusterDefintion >

Parameters

ParameterTypeDescription
configHashstringThe configuration hash returned in createClusterDefinition

Returns

Promise< ClusterDefintion >

The cluster definition for config hash

Throws

On not found config hash.

An example of how to use getClusterDefinition: getObolClusterDefinition

Source

index.ts:136


getClusterLock()

getClusterLock(configHash): Promise< ClusterLock >

Parameters

ParameterTypeDescription
configHashstringThe configuration hash in cluster-definition

Returns

Promise< ClusterLock >

The matched cluster details (lock) from DB

Throws

On not found cluster definition or lock.

An example of how to use getClusterLock: getObolClusterLock

Source

index.ts:152