null], CloudMoney::cents($expectedAmount), null, null ); } /** * @param array $targets */ public static function adminExact(int $instanceId, int $actorUserId, string $requestKey, array $targets): self { return self::make( 'admin_manual', $instanceId, $actorUserId, $requestKey, self::normalizeTargets($targets), null, null, null ); } /** * The batch coordinator owns aggregation; this command freezes only one * exact per-instance target and its immutable batch-item association. * * @param array $targets */ public static function poolReplacement(int $instanceId, int $actorUserId, string $requestKey, int $parentJobId, int $batchItemId, array $targets): self { if ($parentJobId < 1 || $batchItemId < 1) { throw new \InvalidArgumentException( 'Public-network batch identity is invalid.' ); } return self::make( 'pool_replacement', $instanceId, $actorUserId, $requestKey, self::normalizeTargets($targets), null, $batchItemId, $parentJobId ); } private static function make(string $kind, int $instanceId, int $actorUserId, string $requestKey, array $targets, ?int $priceCents, ?int $batchItemId, ?int $parentJobId): self { if (!in_array($kind, ['user_paid', 'admin_manual', 'pool_replacement'], true) || $instanceId < 1 || $actorUserId < 1 || preg_match('/^[A-Za-z0-9_.-]{16,128}$/D', $requestKey) !== 1 || $targets === [] || ($kind === 'user_paid' && ($priceCents === null || $priceCents < 1 || $batchItemId !== null || $parentJobId !== null)) || ($kind === 'admin_manual' && ($priceCents !== null || $batchItemId !== null || $parentJobId !== null)) || ($kind === 'pool_replacement' && ($priceCents !== null || $batchItemId === null || $parentJobId === null || $parentJobId < 1))) { throw new \InvalidArgumentException( 'Public-network transition command is invalid.' ); } $identity = [ 'kind' => $kind, 'instance_id' => $instanceId, 'actor_user_id' => $actorUserId, 'targets' => $targets, 'price_cents' => $priceCents, 'batch_item_id' => $batchItemId, 'parent_job_id' => $parentJobId, ]; $fingerprint = hash('sha256', json_encode( $identity, JSON_THROW_ON_ERROR | JSON_UNESCAPED_SLASHES )); $transitionKey = substr(hash( 'sha256', implode("\0", [ 'public-network-transition-v1', (string) $actorUserId, $requestKey, ]) ), 0, 32); return new self( $kind, $instanceId, $actorUserId, $requestKey, $transitionKey, $fingerprint, $targets, $priceCents, $batchItemId, $parentJobId ); } /** @return array */ private static function normalizeTargets(array $targets): array { $result = []; foreach ($targets as $familyKey => $target) { $family = filter_var($familyKey, FILTER_VALIDATE_INT); if (!in_array($family, [4, 6], true) || isset($result[$family]) || !is_array($target) || count($target) !== 2 || !array_key_exists('pool_key', $target) || !array_key_exists('address_cidr', $target) || !is_string($target['pool_key']) || preg_match('/^[a-f0-9]{32}$/D', $target['pool_key']) !== 1) { throw new \InvalidArgumentException( 'Public-network target is invalid.' ); } $prefix = CloudIpPrefix::address($target['address_cidr'] ?? null); if ($prefix->family() !== $family) { throw new \InvalidArgumentException( 'Public-network target family is invalid.' ); } $result[$family] = [ 'pool_key' => $target['pool_key'], 'address_cidr' => $prefix->canonical(), ]; } ksort($result, SORT_NUMERIC); if ($result === []) { throw new \InvalidArgumentException( 'Public-network target is required.' ); } return $result; } public function kind(): string { return $this->kind; } public function instanceId(): int { return $this->instanceId; } public function actorUserId(): int { return $this->actorUserId; } public function requestKey(): string { return $this->requestKey; } public function transitionKey(): string { return $this->transitionKey; } public function fingerprint(): string { return $this->fingerprint; } public function targets(): array { return $this->targets; } public function priceCents(): ?int { return $this->priceCents; } public function batchItemId(): ?int { return $this->batchItemId; } public function parentJobId(): ?int { return $this->parentJobId; } }