Skip to main content
Version: v1.11

ExitRecombineError

Defined in: errors.ts:494

Thrown by Exit.recombineExitBlobs when it cannot produce an exit signature that verifies against the validator public key. Nothing is returned in that case.

The codes are those of v3's exits.aggregate:

  • EXIT_NOT_ENOUGH_SHARES: with options.clusterConfig, fewer than threshold partial signatures verify against their operators' public shares. validShares and invalidShares say which.
  • EXIT_PARTIAL_SIGNATURE_INVALID: the aggregated signature does not verify against the validator public key. Despite the name this is about the aggregate: at least one input of the aggregation is wrong, and the SDK cannot tell which. Without options.clusterConfig that is too few partials, an invalid partial, another network or another exit message; with it (the partials did verify) the public shares are not this validator's. Also used, without options.clusterConfig, for a partial that is not a valid signature encoding.

hint names the likely causes for the case at hand. All share lists are 1-based share indices (operator index + 1).

Extends​

Properties​

PropertyModifierTypeDescriptionOverridesInherited fromDefined in
hint?publicstringShort, actionable suggestion for the caller.-ObolSdkError.hinterrors.ts:333
codereadonlyExitRecombineErrorCodeStable identifier of the failed check.ObolSdkError.code-errors.ts:496
publicKeyreadonlystringThe validator public key of the exit (0x-prefixed, lowercase).--errors.ts:498
providedSharesreadonlynumber[]Share indices a partial signature was provided for.--errors.ts:500
validSharesreadonlynumber[]Share indices whose partial signature verified against its public share. Empty without options.clusterConfig (nothing to check against).--errors.ts:505
invalidSharesreadonlynumber[]Share indices whose partial signature did not verify against its public share. Empty without options.clusterConfig.--errors.ts:510
stackTraceLimitstaticnumberThe Error.stackTraceLimit property specifies the number of stack frames collected by a stack trace (whether generated by new Error().stack or Error.captureStackTrace(obj)). The default value is 10 but may be set to any valid JavaScript number. Changes will affect any stack trace captured after the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames.-ObolSdkError.stackTraceLimitnode_modules/@types/node/globals.d.ts:68

Methods​

captureStackTrace()​

static captureStackTrace(targetObject, constructorOpt?): void

Defined in: node_modules/@types/node/globals.d.ts:52

Creates a .stack property on targetObject, which when accessed returns a string representing the location in the code at which Error.captureStackTrace() was called.

const myObject = {};
Error.captureStackTrace(myObject);
myObject.stack; // Similar to `new Error().stack`

The first line of the trace will be prefixed with ${myObject.name}: ${myObject.message}.

The optional constructorOpt argument accepts a function. If given, all frames above constructorOpt, including constructorOpt, will be omitted from the generated stack trace.

The constructorOpt argument is useful for hiding implementation details of error generation from the user. For instance:

function a() {
b();
}

function b() {
c();
}

function c() {
// Create an error without stack trace to avoid calculating the stack trace twice.
const { stackTraceLimit } = Error;
Error.stackTraceLimit = 0;
const error = new Error();
Error.stackTraceLimit = stackTraceLimit;

// Capture the stack trace above function b
Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
throw error;
}

a();

Parameters​

ParameterType
targetObjectobject
constructorOpt?Function

Returns​

void

Inherited from​

ObolSdkError.captureStackTrace


prepareStackTrace()​

static prepareStackTrace(err, stackTraces): any

Defined in: node_modules/@types/node/globals.d.ts:56

Parameters​

ParameterType
errError
stackTracesCallSite[]

Returns​

any

See​

https://v8.dev/docs/stack-trace-api#customizing-stack-traces

Inherited from​

ObolSdkError.prepareStackTrace