POST [/instances/$INSTANCE]/orders/$ORDER_ID/unclaim

Wallet releases ownership over an order. By unclaiming an order, it becomes possible for another wallet to claim it. This is useful if a user abandons buying the order with one wallet but then wants to pay with a different wallet.

@since protocol v26.

Request:

The request must be an UnclaimRequest.

Response:

204 No content:

The client has successfully unclaimed the order.

403 Forbidden:

The signature is invalid.

404 Not found:

The backend is unaware of the instance or order.

409 Conflict:

The order was already paid, and thus cannot be unclaimed anymore.

Details:

interface UnclaimRequest {
  // Signature using the key of the claim nonce
  // to affirm unclaiming of the order.
  unclaim_sig: EddsaSignature;

  // Nonce to identify the wallet that claimed the order,
  // public key matching unclaim_sig.
  nonce: EddsaPublicKey;

  // Hash of the order's contract terms, used
  // to enable signature verification without
  // database access.
  h_contract: HashCode;
}