Creating a dWallet

🚧 Under Construction 🚧

This SDK is still in an experimental phase. We advise you use the SDK with localnet.

Creating a dWallet requires completing the full Distributed Key Generation (DKG) process. Here are all the essential steps:

Prerequisites

• Initialized IkaClient instance
• UserShareEncryptionKeys for cryptographic operations
• IKA and SUI tokens for transaction fees

Important Notes

• All 4 steps are required to create a functional dWallet
• State transitions require waiting/polling between steps
• The capability determines who can use the dWallet for signing
• Always verify secret shares and public outputs in production

Step 1: Register Encryption Key

First, register your encryption key, if you did before with your UserShareEncryptionKeys, you can skip this step.

import { Curve, IkaTransaction } from '@ika.xyz/sdk';

const tx = new Transaction();
const ikaTx = new IkaTransaction({
	ikaClient,
	transaction: tx,
	userShareEncryptionKeys,
});

await ikaTx.registerEncryptionKey({
	curve: Curve.SECP256K1,
});

await signAndExecuteTransaction(tx);

Step 2: DKG First Round

Choose one approach based on whether you want to keep or transfer the dWallet capability:

Use dWallet Capability as you want

const tx = new Transaction();
const ikaTx = new IkaTransaction({
	ikaClient,
	transaction: tx,
	userShareEncryptionKeys,
});

const dwalletCap = await ikaTx.requestDWalletDKGFirstRoundAsync({
	curve: Curve.SECP256K1,
	ikaCoin: userIkaCoin, // You can use your own IKA coin
	suiCoin: tx.splitCoins(tx.gas, [1000000]),
});

// Mockup contract
tx.moveCall({
	target: '0x...',
	typeArguments: ['0x...'],
	function: 'deposit_dwallet_for_user',
	arguments: [dwalletCap],
});

await signAndExecuteTransaction(tx);

Step 3: DKG Second Round

Complete the key generation process:

import { prepareDKGSecondRoundAsync } from '@ika.xyz/sdk';

const dkgSecondRoundInput = await prepareDKGSecondRoundAsync(
	ikaClient,
	dWallet,
	sessionIdentifierPreimage,
	userShareEncryptionKeys,
);

const tx = new Transaction();
const ikaTx = new IkaTransaction({
	ikaClient,
	transaction: tx,
	userShareEncryptionKeys,
});

ikaTx.requestDWalletDKGSecondRound({
	dWalletCap: dWallet.dwallet_cap_id,
	dkgSecondRoundRequestInput: dkgSecondRoundInput,
	ikaCoin: userIkaCoin, // You can use your own IKA coin or create a new one
	suiCoin: tx.splitCoins(tx.gas, [1000000]),
});

await signAndExecuteTransaction(tx);

Step 4: Accept User Share

Accept your encrypted share to complete the process:

const tx = new Transaction();
const ikaTx = new IkaTransaction({
	ikaClient,
	transaction: tx,
	userShareEncryptionKeys,
});

await ikaTx.acceptEncryptedUserShare({
	dWallet: awaitingSignaturedWallet,
	userPublicOutput,
	encryptedUserSecretKeyShareId: encryptedUserShareId,
});

await signAndExecuteTransaction(tx);

Complete Example

For a complete working example of the dWallet creation process, see the official zero-trust dWallet example:

Creating dWallet Example

This example demonstrates the complete flow including all 4 steps with proper error handling, state transitions, and best practices for creating dWallets in a production environment.