Skip to content
docsv0.2.0

HumanVerifier

The `human_verify` verifier (D8 / T089): the reference implementation of the core {@see VerifierInterface} whose verdict is supplied by a human or agent out-of-band. `verify()` cannot decide synchronously, so it returns a PENDING result and announces `verification.requested`; the verdict arrives later via {@see grant()} / {@see reject()}, which emit `verification.granted` / `verification.rejected`. No Doctrine, opaque principals.

HumanVerifier::__construct()

public function __construct(?Milpa\Interfaces\Event\MilpaEventDispatcherInterface $dispatcher = null):

Parameters

Parameters of __construct()
NameTypeDescription
$dispatcher?Milpa\Interfaces\Event\MilpaEventDispatcherInterface

HumanVerifier::verify()

public function verify(Milpa\ValueObjects\Verification\VerificationRequest $request, Milpa\ValueObjects\Verification\VerificationContext $context): Milpa\ValueObjects\Verification\VerificationResult

Open a verification request and announce it out-of-band; never resolves synchronously. Always returns a PENDING result and dispatches `verification.requested` — the actual verdict arrives later via {@see grant()} or {@see reject()}.

Parameters

Parameters of verify()
NameTypeDescription
$requestMilpa\ValueObjects\Verification\VerificationRequest
$contextMilpa\ValueObjects\Verification\VerificationContext

HumanVerifier::grant()

public function grant(Milpa\ValueObjects\Verification\VerificationRequest $request, string $principal, ?string $reason = null): Milpa\ValueObjects\Verification\VerificationResult

Human/agent grants the verification.

Parameters

Parameters of grant()
NameTypeDescription
$requestMilpa\ValueObjects\Verification\VerificationRequest
$principalstring
$reason?string

HumanVerifier::reject()

public function reject(Milpa\ValueObjects\Verification\VerificationRequest $request, string $principal, string $reason): Milpa\ValueObjects\Verification\VerificationResult

Human/agent rejects the verification.

Parameters

Parameters of reject()
NameTypeDescription
$requestMilpa\ValueObjects\Verification\VerificationRequest
$principalstring
$reasonstring