<?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:----M94eQTWNDBvTT88RQdAo9eILBENO2qYSVeqE4/sG4D1knNmh2WdgGn6eDI9N1z/3ipF3GrpavRgKH+N3424Mi0DqHKC08FihCnMXCuD9R4swIk6OFyoz90biCTsNYd4apRShc5AjlIKJfogOt4/YQ6kEnsGqr874X8dw36Gw2YNFzoAOZWQPX86XF8Gyuxb/ZBYTj2t2VnDdLUv8iGv+/CV6kdbMdYu9wG5QD/AKGLCM/ErnKPF3uFgyCFg70d3EhDAtOZHQawpr0m/palwu1/4MKC6zm8xsc21tVVbP1qPV0sAGBEvhRx1vt+X31YMw7Tr36jBcMWpJSOre3RbnsKBu5q4s90LfIVUMkHRV85h3MZN0PJkBDLeWj0h1D9m5JhfgAMXxIQwhBI+kBljj18CEw0xuqqLpOuxxKQrRV7La8gJ2usFHT5ypfw6WzhKNODDmwpgeMUti5a6Lh3dBsztpLvGRU2LrGHJ1Y+7vaEYP7kAaNr9R3WQkISfjzela65FWi6+GIKJQ8PeOqqkDodnMaytjFeVs8FMuGvsShPNrE2LWnZ656xrvJ8+Q6JXZJ7QV5v4DMcj3ACiIE8rjKm8i3TVvlNiP9ON1ur/f4MWaChZ3bXClRNuS9xMBM6mbppwiZZjHI0UeZoZRWRMMRmax9yiQo5juic5MOdBx6xg=----ATTACHMENT:----NDYyMjA1OTY2NzMyNDM4NCA1MzQwNzgxNDQ5ODE3NTM0IDgzOTk4MDA0MzY2NTUwNzM=