Signing with an Imported key dWallet

🚧 Under Construction 🚧

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

Sign messages using an imported dWallet that was created from existing cryptographic keys. The process is similar to zero-trust dWallet signing but uses imported key credentials.

Prerequisites

• An active imported dWallet (created through Importing a dWallet)
• Your encrypted user share from the import process
• UserShareEncryptionKeys used during import
• IKA and SUI tokens for transaction fees

Step 1: Request Presign

Create a presign request to optimize signing performance:

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

const tx = new Transaction();
const ikaTx = new IkaTransaction({
	ikaClient,
	transaction: tx,
	userShareEncryptionKeys, // Same keys used during import
});

const unverifiedPresignCap = ikaTx.requestPresign({
	dWallet: importeddWallet,
	signatureAlgorithm: SignatureAlgorithm.ECDSA,
	ikaCoin: userIkaCoin,
	suiCoin: tx.splitCoins(tx.gas, [1000000]),
});

// Keep the presign cap for later use
tx.transferObjects([unverifiedPresignCap], [yourKeypair.toSuiAddress()]);

// Or deposit into your contract
tx.moveCall({
	target: '0x...',
	typeArguments: ['0x...'],
	arguments: [unverifiedPresignCap],
});

await signAndExecuteTransaction(tx);

Step 2: Sign with Imported dWallet

Sign using your imported dWallet's encrypted user share:

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

const tx = new Transaction();
const ikaTx = new IkaTransaction({
	ikaClient,
	transaction: tx,
	userShareEncryptionKeys, // Required for imported dWallet signing
});

// Approve the message for imported dWallet (uses different approval method)
const importedKeyMessageApproval = ikaTx.approveImportedKeyMessage({
	dWalletCap: importeddWallet.dwallet_cap_id,
	signatureAlgorithm: SignatureAlgorithm.ECDSA,
	hashScheme: Hash.KECCAK256,
	message: messageBytes, // Your message as Uint8Array
});

// Verify the presign capability
const verifiedPresignCap = ikaTx.verifyPresignCap({
	presign: completedPresign,
});

// Sign with imported dWallet (uses specialized method)
await ikaTx.requestSignWithImportedKey({
	dWallet: importeddWallet,
	encryptedUserSecretKeyShare: importedEncryptedUserShare,
	presign: completedPresign,
	hashScheme: Hash.KECCAK256,
	message: messageBytes,
	importedKeyMessageApproval,
	verifiedPresignCap,
	ikaCoin: userIkaCoin,
	suiCoin: tx.splitCoins(tx.gas, [1000000]),
});

await signAndExecuteTransaction(tx);

Working Example

For a complete working example of imported dWallet signing, see:

Imported dWallet Signing Example

This example demonstrates the complete flow from importing existing keys through signing with proper error handling and state management.