Request Types

Pre-Alpha Disclaimer: This is an early pre-alpha release for exploring the SDK and starting development only. There is no real MPC signing — all signatures are generated by a single mock signer, not a distributed network. Do not submit any real transactions for signing or rely on any security guarantees. The dWallet keys, trust model, and signing protocol are not final; do not rely on any key material until mainnet. All interfaces, APIs, and data formats are subject to change without notice. The Solana program and all on-chain data will be wiped periodically and everything will be deleted when we transition to Ika Alpha 1. This software is provided “as is” without warranty of any kind; use is entirely at your own risk and dWallet Labs assumes no liability for any damages arising from its use.

DWalletRequest Enum

All operations are encoded as variants of the DWalletRequest enum, BCS-serialized inside SignedRequestData.request.

#![allow(unused)]
fn main() {
pub enum DWalletRequest {
    DKG { ... },                            // Supported in mock
    DKGWithPublicShare { ... },             // Supported in mock
    Sign { ... },                           // Supported in mock
    ImportedKeySign { ... },                // Supported in mock (same as Sign)
    Presign { ... },                        // Supported in mock
    PresignForDWallet { ... },              // Supported in mock
    ImportedKeyVerification { ... },        // Not yet implemented
    ReEncryptShare { ... },                 // Not yet implemented
    MakeSharePublic { ... },                // Not yet implemented
    FutureSign { ... },                     // Not yet implemented
    SignWithPartialUserSig { ... },         // Not yet implemented
    ImportedKeySignWithPartialUserSig { ... }, // Not yet implemented
}
}

Mock Support

Supported Curves

DKG

Create a new dWallet via Distributed Key Generation.

#![allow(unused)]
fn main() {
DWalletRequest::DKG {
    dwallet_network_encryption_public_key: Vec<u8>,
    curve: DWalletCurve,
    centralized_public_key_share_and_proof: Vec<u8>,
    encrypted_centralized_secret_share_and_proof: Vec<u8>,
    encryption_key: Vec<u8>,
    user_public_output: Vec<u8>,
    signer_public_key: Vec<u8>,
}
}

Response: TransactionResponseData::Attestation with the DKG output and NOA attestation.

DKGWithPublicShare

Alternative DKG variant where the user provides a public share instead of an encrypted secret.

#![allow(unused)]
fn main() {
DWalletRequest::DKGWithPublicShare {
    dwallet_network_encryption_public_key: Vec<u8>,
    curve: DWalletCurve,
    centralized_public_key_share_and_proof: Vec<u8>,
    public_user_secret_key_share: Vec<u8>,
    signer_public_key: Vec<u8>,
}
}

Sign

Sign a message using an existing dWallet.

#![allow(unused)]
fn main() {
DWalletRequest::Sign {
    message: Vec<u8>,
    curve: DWalletCurve,
    signature_algorithm: DWalletSignatureAlgorithm,
    hash_scheme: DWalletHashScheme,
    presign_id: Vec<u8>,
    message_centralized_signature: Vec<u8>,
    approval_proof: ApprovalProof,
}
}

Response: TransactionResponseData::Signature with the completed signature.

ApprovalProof

The approval proof ties the gRPC signing request to an on-chain MessageApproval:

#![allow(unused)]
fn main() {
pub enum ApprovalProof {
    Solana {
        transaction_signature: Vec<u8>, // Solana tx signature
        slot: u64,                       // Slot of the transaction
    },
    Sui {
        effects_certificate: Vec<u8>,    // Sui effects certificate
    },
}
}

Presign

Allocate a global presign (usable with any dWallet).

#![allow(unused)]
fn main() {
DWalletRequest::Presign {
    curve: DWalletCurve,
    signature_algorithm: DWalletSignatureAlgorithm,
}
}

Response: TransactionResponseData::Presign with presign ID and data.

PresignForDWallet

Allocate a presign bound to a specific dWallet.

#![allow(unused)]
fn main() {
DWalletRequest::PresignForDWallet {
    dwallet_id: Vec<u8>,
    curve: DWalletCurve,
    signature_algorithm: DWalletSignatureAlgorithm,
}
}

Cryptographic Parameter Enums

DWalletCurve

DWalletSignatureAlgorithm

DWalletHashScheme

ChainId

SignatureScheme