setActiveAccount

Make accountId the active account.

Resolves the keypairs from config.keyring, records the id in state.activeAccountId, refreshes the bearer token (unless skipped or the account is partial — i.e. not registered in state.accounts), and (re)starts the JWT refresh timer.

Import

import { setActiveAccount } from "@0xcurvy/curvy-sdk/actions";

Usage

await setActiveAccount({ accountId });

Signature

function setActiveAccount(parameters: SetActiveAccountParameters): Promise<void>

Returns

Promise<void>

The action resolves or returns the value shown in the signature.

Parameters

accountId

• Type: string
• Required: yes

The account to make active.

await setActiveAccount({
  accountId, 
});

skipBearerTokenUpdate

• Type: boolean
• Required: no

Whether to skip bearer-token refresh when activating a registered account.

await setActiveAccount({
  accountId,
  skipBearerTokenUpdate, 
});

config

• Type: CurvyConfig
• Required: no

Curvy config to use. Defaults to the ambient config.

await setActiveAccount({
  accountId,
  config, 
});

Errors

Errors from config resolution and the underlying SDK operation are propagated to the caller.

Related

• Authentication guide
• addAccount — Decompose a CurvyAccount DTO into the runtime stores, make it active, and persist it.
• addPartialAccount — Add a partial (handle-less, owner-less) account built from a subset of keypairs and make it active.
• removeAccount — Evict an account from the runtime without re-pointing the session.

Source

packages/@0xcurvy/sdk/src/actions/account/setActiveAccount.ts