Smart account providers

Set evm.account.type in createAccount to choose the EVM smart account implementation. If you configure evm.owners and omit evm.account, the SDK uses Nexus 1.2.1. The provider configuration contributes to the counterfactual account address. Choose it before funding or deploying the account, and keep the same configuration on every chain.

Supported providers

Type	Configuration	Notes
Nexus	`{ type: 'nexus', version?, salt? }`	Default. Versions `1.2.0` and `1.2.1` are supported.
Safe	`{ type: 'safe', version?, adapter?, nonce? }`	Safe `1.4.1`; adapter `1.0.0` or `2.0.0`.
Kernel	`{ type: 'kernel', version?, salt? }`	Kernel `3.3`.
Startale	`{ type: 'startale', version?, salt? }`	Default `1.0.1`; legacy `1.0.0` is supported explicitly.
HCA	`{ type: 'hca', factory? }`	Hierarchical account intended for ENS validator configurations.

Configure the SDK

SDK-level configuration, including authentication and RPC providers, is shared by every account created from the instance. Keep API-key authentication server-side:

import { RhinestoneSDK } from '@rhinestone/sdk'

const rhinestone = new RhinestoneSDK({
  auth: {
    mode: 'apiKey',
    apiKey: process.env.RHINESTONE_API_KEY!,
  },
})

Use short-lived JWTs as described in security when the SDK runs in a browser.

Select an implementation

The owner shown below is any viem-compatible account from account setup.

const account = await rhinestone.createAccount({
  evm: {
    account: {
      type: 'nexus',
      version: '1.2.1',
    },
    owners: { type: 'ecdsa', accounts: [owner] },
  },
})

const account = await rhinestone.createAccount({
  evm: {
    account: {
      type: 'safe',
      version: '1.4.1',
      adapter: '2.0.0',
    },
    owners: { type: 'ecdsa', accounts: [owner] },
  },
})

const account = await rhinestone.createAccount({
  evm: {
    account: {
      type: 'kernel',
      version: '3.3',
    },
    owners: { type: 'ecdsa', accounts: [owner] },
  },
})

const account = await rhinestone.createAccount({
  evm: {
    account: { type: 'startale', version: '1.0.1' },
    owners: { type: 'ecdsa', accounts: [owner] },
  },
})

Defaults are suitable for new accounts. To restore an existing account, preserve its original version and derivation settings. Upgrading a pinned Nexus 1.2.0 account to 1.2.1 changes its derived address. For an existing Startale 1.0.0 account, explicitly set version: '1.0.0' and preserve its original factory metadata. Do not switch it to the 1.0.1 default: the version affects account identity and signing domain. Address-only initData does not supply factory evidence for restoring that identity. To attach an account that already exists, follow bring your own account.

Account setup

Recovery

Signing

Configuration

Integration

SDK reference

Smart account providers

Supported providers

Configure the SDK

Select an implementation

​Supported providers

​Configure the SDK

​Select an implementation

Supported providers

Configure the SDK

Select an implementation