Skip to main content
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:179 High-level TypeScript client for Gen JSON-RPC, activation submission, views, simulation, and trace polling.

Constructors

Constructor

new GenClient(rpcClient, config?): GenClient
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:183 Creates a client wrapping an existing RPC transport with optional config overrides.

Parameters

rpcClient
GenRpcClient
config?
GenClientConfigInit | GenClientConfig

Returns

GenClient

Methods

newHttp()

static newHttp(url, options?): GenClient
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:194 Creates an HTTP-backed client with the SDK’s default JSON-RPC headers.

Parameters

url
string
options?
GenClientHttpOptions = {}

Returns

GenClient

newHttpWithoutDefaultHeaders()

static newHttpWithoutDefaultHeaders(url, options?): GenClient
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:201 Creates an HTTP client without adding the SDK’s default JSON-RPC headers.

Parameters

url
string
options?
GenClientHttpOptions = {}

Returns

GenClient

rpc()

rpc(): GenRpcClient
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:241 Returns the underlying generated JSON-RPC client.

Returns

GenRpcClient

config()

config(): GenClientConfig
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:248 Returns the resolved client configuration used for headers and polling.

Returns

GenClientConfig

getFreshValidUntilBlock()

getFreshValidUntilBlock(): Promise<bigint>
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:266 Fetches a fresh validUntilBlock from the current finalized block index plus the SDK’s short validity buffer. Retries on transient “latest finalized block index is not cached yet” JSON-RPC errors.

Returns

Promise<bigint>

buildSignableActivation()

buildSignableActivation(signerPublicKey, payload, options?): Promise<SignableGenExternalActivation>
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:308 Builds an unsigned activation with optional per-submission header options. When validUntilBlock is not supplied in options, the client fetches the current finalized block and adds the SDK’s short validity buffer.

Parameters

signerPublicKey
GenPublicKey
payload
ActivationPayload
options?
ActivationOptionsInit

Returns

Promise<SignableGenExternalActivation>

submitActivation()

submitActivation(activation): Promise<ActivationId>
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:327 Submits a pre-signed activation and returns its activation ID.

Parameters

activation
GenExternalActivation

Returns

Promise<ActivationId>

signAndSubmitActivation()

signAndSubmitActivation(signer, payload, options?): Promise<ActivationId>
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:339 Signs an activation with the provided signer and submits it.

Parameters

signer
EddsaSigner
payload
ActivationPayload
options?
ActivationOptionsInit

Returns

Promise<ActivationId>

waitForTraceCompletion()

waitForTraceCompletion(activationId): Promise<ActivationTrace>
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:357 Collects the full activation trace by BFS traversal of continuations.

Parameters

activationId
ActivationId

Returns

Promise<ActivationTrace>

wait()

wait(activationId): Promise<TraceOutcome>
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:367 Waits for the activation trace and resolves the terminal result event.

Parameters

activationId
ActivationId

Returns

Promise<TraceOutcome>

submitActivationAndWait()

submitActivationAndWait(activation): Promise<TraceOutcome>
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:374 Submits a pre-signed activation and waits for the terminal result event.

Parameters

activation
GenExternalActivation

Returns

Promise<TraceOutcome>

signAndSubmitActivationAndWait()

signAndSubmitActivationAndWait(signer, payload, options?): Promise<TraceOutcome>
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:381 Signs, submits, and waits for the terminal result event.

Parameters

signer
EddsaSigner
payload
ActivationPayload
options?
ActivationOptionsInit

Returns

Promise<TraceOutcome>

createAccount()

createAccount(account): Promise<ActivationId>
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:394 Submits the built-in account creation flow using the faucet signer.

Parameters

account
GvmAccount

Returns

Promise<ActivationId>

faucet()

faucet(account, amount, options?): Promise<ActivationId>
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:404 Submits the built-in faucet transfer flow using the faucet signer.

Parameters

account
GvmAccount
amount
bigint
options?
FaucetTransferOptionsInit = {}

Returns

Promise<ActivationId>

view()

view(payload): Promise<Uint8Array<ArrayBufferLike>>
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:419 Executes a read-only activation and returns the raw response bytes.

Parameters

payload
ViewPayload

Returns

Promise<Uint8Array<ArrayBufferLike>>

simulateActivation()

simulateActivation(payload, signerPublicKey, blockIndex?, options?): Promise<SimulateActivationResponse>
Defined in: metacomputer/gen-framework/client-and-test-utils/client-sdk-ts/packages/client-sdk/src/client.ts:432 Simulates an activation without submitting it to the chain.

Parameters

payload
ActivationPayload
signerPublicKey
GenPublicKey
blockIndex?
string | number | bigint
options?
ActivationOptionsInit

Returns

Promise<SimulateActivationResponse>