Ika dWallet Instructions

Veil integrates Ika’s dWallet infrastructure  to allow native Bitcoin and Ethereum to be used as collateral on Solana without bridging. A dWallet is a programmable cross-chain wallet governed jointly by the user and Ika’s decentralised MPC network.

How it works:

1. User creates a dWallet on the Ika network (via Ika SDK or the Veil frontend wizard)
2. User transfers the dWallet’s authority to Veil’s CPI PDA
3. User calls IkaRegister — Veil verifies authority and creates an IkaDwalletPosition
4. The dWallet can now only sign Bitcoin/Ethereum transactions if Veil approves (via IkaSign)
5. When the user wants to exit, IkaRelease transfers authority back and closes the position

Veil CPI Authority PDA: seeds ["__ika_cpi_authority"] on the Veil program ID

Ika Program ID: 87W54kGYFQ1rgWqMeu4XTPHWXWmXSQCcjm8vCTfiq1oY

IkaDwalletPosition Account

Discriminator: VEILIKA! · Size: 128 bytes

PDA: seeds ["ika_pos", pool, user]

Curve Types

Signature Schemes

IkaRegister

Discriminator: 0x11 (17)

Register a dWallet as collateral. Verifies that the dWallet’s authority has been transferred to Veil’s CPI PDA, then creates an IkaDwalletPosition.

Accounts

Instruction Data

Validation

The instruction verifies:

1. dwallet.discriminator == 2 (Ika account type = dWallet)
2. dwallet.state == 1 (Active — DKG complete)
3. dwallet.authority == cpi_authority — Veil already controls this dWallet

Example

import { ikaRegisterIx } from './lib/ika/instructions';
import { findCpiAuthority, findIkaPosition } from './lib/ika/pda';
import { DWalletCurve, SignatureScheme } from './lib/ika/types';
import { PROGRAM_ID } from './lib/veil/constants';
 
const [cpiAuthority, cpiAuthorityBump] = await findCpiAuthority(PROGRAM_ID);
const [ikaPosition, positionBump] = await findIkaPosition(pool, user, PROGRAM_ID);
 
const ix = ikaRegisterIx(
  user,
  pool,
  dwalletAddress,
  ikaPosition,
  cpiAuthority,
  1_200_000n,              // $12,000.00 in cents
  DWalletCurve.SECP256K1,
  SignatureScheme.ECDSA_SHA256,
  positionBump,
  cpiAuthorityBump,
);

IkaRelease

Discriminator: 0x12 (18)

Release a registered dWallet. CPIs transfer_dwallet on the Ika program to return authority to the user, then marks the position as Released.

Accounts

Instruction Data

Example

import { ikaReleaseIx } from './lib/ika/instructions';
import { PROGRAM_ID } from './lib/veil/constants';
import { IKA_PROGRAM_ID } from './lib/ika/types';
 
const ix = ikaReleaseIx(
  user,
  pool,
  dwalletAddress,
  ikaPosition,
  PROGRAM_ID,
  cpiAuthority,
  cpiAuthorityBump,
);

IkaSign

Discriminator: 0x13 (19)

Approve a cross-chain message for signing by the Ika MPC network. CPIs approve_message on the Ika program, which creates a MessageApproval account that the Ika nodes observe and sign.

This is used for on-chain governance of Bitcoin/Ethereum transactions: only Veil can approve messages for a registered dWallet, so the MPC network won’t sign any transaction unless Veil’s program logic permits it.

Accounts

Instruction Data

Total instruction data: 101 bytes

Example

import { ikaSignIx } from './lib/ika/instructions';
import { findCoordinator, findMessageApproval } from './lib/ika/pda';
import { SignatureScheme } from './lib/ika/types';
import { PROGRAM_ID } from './lib/veil/constants';
 
const messageDigest = sha256(bitcoinTransaction);   // 32 bytes
const metadataDigest = new Uint8Array(32);           // zeros if unused
 
const [coordinator] = await findCoordinator();
const [messageApproval, msgApprovalBump] = await findMessageApproval(
  dwalletAddress,
  messageDigest,
  metadataDigest,
  SignatureScheme.ECDSA_SHA256,
);
 
const ix = ikaSignIx(
  user,
  coordinator,
  messageApproval,
  dwalletAddress,
  ikaPosition,
  PROGRAM_ID,
  cpiAuthority,
  messageDigest,
  metadataDigest,
  user.toBytes(),
  SignatureScheme.ECDSA_SHA256,
  msgApprovalBump,
  cpiAuthorityBump,
);