Exceptions Reference

This is a single page collecting all relevant exception kinds related to the Digital Key Platform with an explanation of it and possible causes.

io.vouch.data.ledger


forbidden

An exception kind that occurs when the device sending the tx is not authorized to perform the operation.


unauthorized

An exception kind that occurs when the platform does not recognize the signature produced by the User Device keys.

Possible causes:

  • Wrong initialization of the SDK;
  • Potential client compromise;
  • Payload tampering.

io.vouch.data.ledger.complete-task-tx


missing-task-id

Exception kind thrown in case SDK fails in its validation process and sends the request to dk-api with empty/null asset-persona-task/id or dk-api fails in sending correct asset-persona-task/id to dk-abci.


asset-not-found

This exception kind is not expected to happen, it can happen if the associated asset was not created for some reason.


asset-device-not-found

This exception kind is not expected to happen, it can happen if the associated asset-device was not created for some reason.


persona-not-found

This exception kind is not expected to happen, it can happen if the associated persona does not get created for some reason.


persona-revoked

Exception kind thrown if the referenced persona has the status "revoked".

Possible scenario:

  1. Given that an Owner has Digital Key already setup over a VIN
  2. And the Owner has shared Digital Key with Friend for VIN
  3. And Friend receives the Key Share pop-up
  4. But Friend doesn't accept or reject it
  5. And Owner revokes key share to Friend over VIN
  6. When Friend doesn't call sync and tries to accept or reject the key
  7. Then the app returns "400 - Persona revoked(kind: persona-revoked)" error

task-not-found

This exception kind is not expected to happen, it can happen if the SDK is forced to send an arbitrary asset-persona-task/id.


workflow-not-found

This exception kind is not expected to happen, it can happen if the workflow [Exceptions Reference]()


task-already-completed

Exception kind thrown if key share was already handled by accepting or rejecting it.

Possible scenario:

  1. Given that an Owner has Digital Key already setup over a VIN
  2. And the Owner has shared Digital Key with Friend for VIN
  3. And Friend receives the invite and accepts it
  4. When Friend tries to accept or reject the same invite again
  5. Then the app returns "400 - kind: task-already-completed" error.