Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.fireblocks.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Initialize the EW SDK

  1. Initialize a new EmbeddedWallet SDK instance
  2. Call ew.assignWallet() - the wallet is created if doesn’t exist yet.
When creating a new instance, provide the following parameters:
  • authClientId: Your OAuth client ID configured in the Fireblocks Console
  • authTokenRetriever: Provides a method to fetch the end user’s IDP token (via getAuthToken()).
  • reporting(optional): When enabled, the SDK sends error reports to Fireblocks to help diagnose failures.
const ew = new EmbeddedWallet({
  env: ENV_CONFIG.NCW_SDK_ENV,
  logLevel: 'INFO',
  logger,
  authClientId: ENV_CONFIG.AUTH_CLIENT_ID,
  authTokenRetriever: {
    getAuthToken: () => this._rootStore.userStore.getAccessToken(),
  },
  reporting: {
    enabled: true,
  },
});

const wallet = await ew.assignWallet();

​
Initialize the EW Core SDK

Generate a deviceId. This value is unique per SDK instance. Each embedded wallet (EW) walletId correlates to one or more deviceId: 
// generate a device Id, do it only once per SDK instance

const deviceId = FireblocksNCW.generateDeviceId()
When creating a new SDK instance, provide the following parameters:

​
Example

const coreOptions: ICoreOptions = {
  deviceId,
  eventsHandler,
  secureStorageProvider,
  storageProvider,
};

const ewCore =
      getFireblocksNCWInstance(coreOptions.deviceId) ?? (await ew.initializeCore(coreOptions));

​
Note

All SDKs (JS, Android, iOS) can be initialized with one of the following environments: sandbox, production.The environment initialization value will affect the selection of the correct root certificate in the SDK. If your tenant resides in the production environment (whether it be testnet or mainnet), then choose production. If you are exploring NCW using the sandbox, then simply choose sandbox.

​
Device ID

A deviceId is a UUID you generate to uniquely identify a client device. It must be provided when initializing the EW Core SDK. Store the deviceId locally and reuse it on every SDK initialization for that device. When to generate a new deviceId:
  • New wallet on a new device.
  • Adding a new device to an existing wallet.
When to reuse an existing deviceId:
  • Same device and wallet — retrieve from local storage.
  • Recovering a lost device using the last backup.
To recover keys from a lost device, initialize the SDK with the same deviceId used during the last backup. You can retrieve this info via ew.getLatestBackup().

​
Note

If a wallet is fully initialized with a given deviceId, its key share can only be transferred to a new device via the recovery procedure. After recovery, the original device will no longer be able to participate in MPC operations.