allocate

suspend fun allocate(driver: SigningDriver, synchronizerId: String, partyHint: String, userId: String? = null): AllocatedExternalParty

Onboards a new external party whose signing key is driver's, running the three steps in the class doc. partyHint is the readable prefix of the resulting party id; userId, when given, is passed through as the allocation request's user_id.

Return

the allocated party id and the canonical fingerprint of the driver's key — store both with the wallet record, since the fingerprint is what later signatures must be marked signed_by.