QubicKit Docs
SDKWallets

HD Path Recipes

Common derivation schemes for QubicKit wallets.

HD path recipes

resolveWallet and createWalletTools accept any HD path because they reuse the FourQ derivation logic from @qubiq/core. Below are a few patterns you can adapt:

App-specific accounts

await resolveWallet({
  seed: process.env.QUBIQ_SEED,
  hdPath: "m/44'/609'/0'/0/0",
});

Use the final index (.../0) to represent different apps or services. Keep a naming scheme documented so you can reproduce wallets later.

Custody rotation

const rotationPath = `m/44'/609'/${rotationIndex}'/0/0`;
const wallet = await resolveWallet({ seed, hdPath: rotationPath });

Increment rotationIndex whenever you rotate custody or issue new payouts.

Derived wallets via WalletTools

const tools = createWalletTools(await resolveWallet({ seed }));
const hotWallet = await tools?.derivePath("m/44'/609'/0'/1/0");

derivePath is useful when you need to keep the root seed in memory but still issue short-lived wallets for automation workers.