taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

post-auditors-AUDITOR_PUB-H_DENOM_PUB.rst (1973B)

      1 .. http:post:: /auditors/$AUDITOR_PUB/$H_DENOM_PUB
      2 
      3   This is used to add an auditor signature to the ``/keys`` response. It
      4   affirms to wallets and merchants that this auditor is indeed auditing
      5   the coins issued by the respective denomination.  There is no "delete"
      6   operation for this, as auditors can only stop auditing a denomination
      7   when it expires.
      8 
      9   **Request:**
     10 
     11   The request must be a `AuditorSignatureAddMessage`.
     12 
     13   **Response:**
     14 
     15   :http:statuscode:`204 No content`:
     16     The backend has successfully stored the auditor signature.
     17   :http:statuscode:`403 Forbidden`:
     18     The auditor signature is invalid.
     19   :http:statuscode:`404 Not found`:
     20     The denomination key for which the auditor is providing a signature is unknown.
     21     The response will be a `DenominationUnknownMessage`.
     22   :http:statuscode:`410 Gone`:
     23     This auditor is no longer supported by the exchange.
     24   :http:statuscode:`412 Precondition failed`:
     25     This auditor is not yet known to the exchange.
     26 
     27   **Details:**
     28 
     29   .. ts:def:: DenominationUnknownMessage
     30 
     31     interface DenominationUnknownMessage {
     32 
     33       // Taler error code
     34       // ``TALER_EC_EXCHANGE_GENERIC_DENOMINATION_KEY_UNKNOWN``
     35       code: Integer;
     36 
     37       // Signature by the exchange over a
     38       // `TALER_DenominationUnknownAffirmationPS`.
     39       // Must have purpose ``TALER_SIGNATURE_EXCHANGE_AFFIRM_DENOM_UNKNOWN``.
     40       exchange_sig: EddsaSignature;
     41 
     42       // Public key of the exchange used to create
     43       // the 'exchange_sig.
     44       exchange_pub: EddsaPublicKey;
     45 
     46       // Hash of the denomination public key that is unknown.
     47       h_denom_pub: HashCode;
     48 
     49       // When was the signature created.
     50       timestamp: Timestamp;
     51 
     52     }
     53 
     54   .. ts:def:: AuditorSignatureAddMessage
     55 
     56     interface AuditorSignatureAddMessage {
     57 
     58       // Signature by the auditor over a
     59       // `TALER_ExchangeKeyValidityPS`.
     60       // Must have purpose ``TALER_SIGNATURE_AUDITOR_EXCHANGE_KEYS``.
     61       auditor_sig: EddsaSignature;
     62 
     63     }