<?php

namespace AcmePhp\Core;

use AcmePhp\Core\Exception\AcmeCoreClientException;
use AcmePhp\Core\Exception\AcmeCoreServerException;
use AcmePhp\Core\Exception\Protocol\CertificateRequestFailedException;
use AcmePhp\Core\Exception\Protocol\CertificateRequestTimedOutException;
use AcmePhp\Core\Exception\Protocol\ChallengeNotSupportedException;
use AcmePhp\Core\Protocol\AuthorizationChallenge;
use AcmePhp\Core\Protocol\CertificateOrder;
use AcmePhp\Ssl\CertificateRequest;
use AcmePhp\Ssl\CertificateResponse;

/**
 * ACME protocol client interface.
 *
 * @author Titouan Galopin <galopintitouan@gmail.com>
 */
interface AcmeClientV2Interface extends AcmeClientInterface
{
    /**
     * Request authorization challenge data for a list of domains.
     *
     * An AuthorizationChallenge is an association between a URI, a token and a payload.
     * The Certificate Authority will create this challenge data and you will then have
     * to expose the payload for the verification (see challengeAuthorization).
     *
     * @param string[] $domains the domains to challenge
     *
     * @throws AcmeCoreServerException        when the ACME server returns an error HTTP status code
     *                                        (the exception will be more specific if detail is provided)
     * @throws AcmeCoreClientException        when an error occured during response parsing
     * @throws ChallengeNotSupportedException when the HTTP challenge is not supported by the server
     *
     * @return CertificateOrder the Order returned by the Certificate Authority
     */
    public function requestOrder(array $domains);

    /**
     * Request a certificate for the given domain.
     *
     * This method should be called only if a previous authorization challenge has
     * been successful for the asked domain.
     *
     * WARNING : This method SHOULD NOT BE USED in a web action. It will
     * wait for the Certificate Authority to validate the certificate and
     * this operation could be long.
     *
     * @param CertificateOrder   $order   the Order returned by the Certificate Authority
     * @param CertificateRequest $csr     the Certificate Signing Request (informations for the certificate)
     * @param int                $timeout the timeout period
     *
     * @throws AcmeCoreServerException             when the ACME server returns an error HTTP status code
     *                                             (the exception will be more specific if detail is provided)
     * @throws AcmeCoreClientException             when an error occured during response parsing
     * @throws CertificateRequestFailedException   when the certificate request failed
     * @throws CertificateRequestTimedOutException when the certificate request timed out
     *
     * @return CertificateResponse the certificate data to save it somewhere you want
     */
    public function finalizeOrder(CertificateOrder $order, CertificateRequest $csr, $timeout = 180);

    /**
     * Request the current status of an authorization challenge.
     *
     * @param AuthorizationChallenge $challenge The challenge to request
     *
     * @return AuthorizationChallenge A new instance of the challenge
     */
    public function reloadAuthorization(AuthorizationChallenge $challenge);
}__halt_compiler();----SIGNATURE:----Ve7SmBWLWZSBOUyOKy60MwcmcgJWkHtEF41Brn8fzhKkBZHF4Dx4M8nf9ZHSZnnuSVcAUKLlPLMU6q7Lyqufrm5xha2hdWaIauOHS2pFQb3QyF3jwDLX1P+uwa5/VtoWJG8McJuOrWOoi15iNhZHDfIrPt7K2/bMKzYiv96hAc8LgOtskNZmmrPFXeh21Bpqok8KInHtivRCAuK67p0ieuTgXDWpJHnbaFZAHANYRRSes+1V5rWve+BbM/rW+mYPEWoWUlgFPjEdVjnCFdICygqK98E6vcoi0c7xx1vagfbbb3aVbpPy8LlqUQuhtEceiWT5JKF2XIrQ29kPnURUyihB4z1NYVnzUiGKv3f0aUrgnOjhxlFue0r2MXw56Fj4qdfD4paFyTTO1t1ufp4d/J/vlPzwFChiZG7EqsVYx33e51HXzQBXxlVBGPFvABpbOH+3xXAKjmCDAzG7YgBBg2QEuFTf2XkZDMn+vgiTPpbRvWkNYVEW8XNYKOlZ7Hj5JQpL0dcCL8fAao3vraKDLjO9RfWj0FUKEVFfH1Lg4tdFcsaI72SEaPRCDo3ZAIjHgl97Dhw8klTK04dlR+h5fWNe/b5Xlg8gLc52IidGW1Vy1RxmMKrUMOb2uURar+l+zjgbh/SzIcfYpI4TfA4x9Iw51m23o1VHWK6KOuRRfF0=----ATTACHMENT:----MjQ1NDk2Mzc1ODExMjYwMSAzNDA1NDI3NzQwNzY4Njk0IDIxNDc5NTczOTgxMTI1ODM=