DotNetSteward

0.2.0

Private/Discovery.ps1

function Get-DotNetProductType {
    param(
        [Parameter(Mandatory = $true)]
        [AllowEmptyString()]
        [string] $DisplayName
    )

    if ([string]::IsNullOrWhiteSpace($DisplayName)) {
        return $null
    }

    if ($DisplayName.IndexOf('.NET Core SDK', [StringComparison]::OrdinalIgnoreCase) -ge 0 -or
        $DisplayName.IndexOf('Microsoft .NET SDK', [StringComparison]::OrdinalIgnoreCase) -ge 0) {
        return 'Sdk'
    }

    if ($DisplayName.IndexOf('ASP.NET', [StringComparison]::OrdinalIgnoreCase) -ge 0 -and
        ($DisplayName.IndexOf('Runtime', [StringComparison]::OrdinalIgnoreCase) -ge 0 -or
        $DisplayName.IndexOf('Shared Framework', [StringComparison]::OrdinalIgnoreCase) -ge 0)) {
        return 'AspNetCoreRuntime'
    }

    if ($DisplayName.IndexOf('Windows Desktop Runtime', [StringComparison]::OrdinalIgnoreCase) -ge 0 -or
        $DisplayName.IndexOf(
            'Dotnet Shared Framework for Windows Desktop',
            [StringComparison]::OrdinalIgnoreCase
        ) -ge 0) {
        return 'WindowsDesktopRuntime'
    }

    if ($DisplayName.IndexOf('.NET Core Runtime', [StringComparison]::OrdinalIgnoreCase) -ge 0 -or
        $DisplayName.IndexOf('Microsoft .NET Runtime', [StringComparison]::OrdinalIgnoreCase) -ge 0) {
        return 'Runtime'
    }

    return $null
}

function Get-DotNetVersionFromDisplayName {
    param(
        [Parameter(Mandatory = $true)]
        [AllowEmptyString()]
        [string] $DisplayName
    )

    if ([string]::IsNullOrWhiteSpace($DisplayName)) {
        return $null
    }

    if ($DisplayName -match '(?i)(?<core>\d+\.\d+\.\d+)\s+(?<label>preview|alpha|rc)\s*(?<number>\d+(?:\.\d+)*)') {
        return '{0}-{1}.{2}' -f
            $Matches.core,
            $Matches.label.ToLowerInvariant(),
            $Matches.number
    }

    if ($DisplayName -match '(?<version>\d+\.\d+\.\d+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?)') {
        return $Matches.version
    }

    return $null
}

function Get-DotNetBundleIdentity {
    param(
        [Parameter(Mandatory = $true)]
        [string] $DisplayName,

        [AllowEmptyString()]
        [string] $BundleCachePath,

        [AllowEmptyString()]
        [string] $UninstallString
    )

    $productType = Get-DotNetProductType -DisplayName $DisplayName
    if ($null -eq $productType) {
        return $null
    }

    $version = $null
    $architecture = $null
    $identityText = "$BundleCachePath`n$UninstallString"
    if ($identityText -match '(?i)(?:dotnet-sdk|dotnet-runtime|aspnetcore-runtime|windowsdesktop-runtime)-(?<version>\d+\.\d+\.\d+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?)-win-(?<architecture>x64|x86|arm64)\.exe') {
        $version = $Matches.version
        $architecture = $Matches.architecture.ToLowerInvariant()
    }
    elseif ($identityText -match '(?i)dotnet-(?:dev-)?win-(?<architecture>x64|x86)\.(?<version>\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)\.exe') {
        $version = $Matches.version
        $architecture = $Matches.architecture.ToLowerInvariant()
    }

    if ([string]::IsNullOrWhiteSpace($version)) {
        $version = Get-DotNetVersionFromDisplayName -DisplayName $DisplayName
    }
    if ([string]::IsNullOrWhiteSpace($architecture) -and
        $DisplayName -match '(?i)\((?<architecture>x64|x86|arm64)\)') {
        $architecture = $Matches.architecture.ToLowerInvariant()
    }

    if ([string]::IsNullOrWhiteSpace($version) -or
        [string]::IsNullOrWhiteSpace($architecture)) {
        return $null
    }

    [pscustomobject] @{
        ProductType = $productType
        Version = $version
        Architecture = $architecture
        Rid = "win-$architecture"
    }
}

function Get-DotNetBundleInventory {
    $registryHive = [Microsoft.Win32.RegistryHive]::LocalMachine
    # Official .NET Burn bundles register in the 32-bit Add/Remove Programs view.
    $registryView = [Microsoft.Win32.RegistryView]::Registry32
    $uninstallPath = 'SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall'
    $bundles = New-Object System.Collections.Generic.List[object]
    $baseKey = $null
    $uninstallKey = $null

    try {
        $baseKey = [Microsoft.Win32.RegistryKey]::OpenBaseKey($registryHive, $registryView)
        $uninstallKey = $baseKey.OpenSubKey($uninstallPath)
        if ($null -eq $uninstallKey) {
            return @()
        }

        foreach ($subkeyName in $uninstallKey.GetSubKeyNames()) {
            $bundleKey = $uninstallKey.OpenSubKey($subkeyName)
            if ($null -eq $bundleKey) {
                continue
            }

            try {
                $displayName = [string] $bundleKey.GetValue('DisplayName')
                $displayVersion = [string] $bundleKey.GetValue('DisplayVersion')
                $bundleVersion = [string] $bundleKey.GetValue('BundleVersion')
                $publisher = [string] $bundleKey.GetValue('Publisher')
                $uninstallString = [string] $bundleKey.GetValue('UninstallString')
                $quietUninstallString = [string] $bundleKey.GetValue('QuietUninstallString')
                $bundleCachePath = [string] $bundleKey.GetValue('BundleCachePath')

                $productType = Get-DotNetProductType -DisplayName $displayName
                $isVisualStudioOwned =
                    $displayName.IndexOf('Visual Studio', [StringComparison]::OrdinalIgnoreCase) -ge 0 -or
                    $displayName.IndexOf('VS 2015', [StringComparison]::OrdinalIgnoreCase) -ge 0 -or
                    $displayName.IndexOf('Local Feed', [StringComparison]::OrdinalIgnoreCase) -ge 0
                $isExeBundle =
                    $uninstallString.IndexOf('.exe', [StringComparison]::OrdinalIgnoreCase) -ge 0 -and
                    $uninstallString.IndexOf('msiexec', [StringComparison]::OrdinalIgnoreCase) -lt 0

                if ($null -eq $productType -or -not $isExeBundle -or
                    $publisher -cne 'Microsoft Corporation' -or
                    [string]::IsNullOrWhiteSpace($displayVersion) -or
                    [string]::IsNullOrWhiteSpace($bundleVersion)) {
                    continue
                }

                $identity = Get-DotNetBundleIdentity -DisplayName $displayName `
                    -BundleCachePath $bundleCachePath -UninstallString $uninstallString
                if ($null -eq $identity) {
                    Write-Warning "Ignoring .NET bundle '$displayName' because its version or architecture could not be determined."
                    continue
                }

                try {
                    $versionInfo = New-SdkVersionInfo -Text $identity.Version
                }
                catch {
                    Write-Warning "Ignoring .NET bundle '$displayName' because version '$($identity.Version)' is invalid."
                    continue
                }

                $bundleProviderKey = [string] $bundleKey.GetValue('BundleProviderKey')
                if ([string]::IsNullOrWhiteSpace($bundleProviderKey)) {
                    $bundleProviderKey = $subkeyName
                }

                $bundles.Add([pscustomobject] @{
                    PSTypeName = 'DotNetSteward.Installation'
                    ProductType = $identity.ProductType
                    Version = $versionInfo.Text
                    VersionInfo = $versionInfo
                    Architecture = $identity.Architecture
                    Rid = $identity.Rid
                    InstallerKind = 'Bundle'
                    ManagementSource = if ($isVisualStudioOwned) { 'VisualStudio' } else { 'Standalone' }
                    ManagedByVisualStudio = $isVisualStudioOwned
                    Owners = @($displayName)
                    IsUpdateable = -not $isVisualStudioOwned
                    IsUninstallable = -not $isVisualStudioOwned
                    DisplayName = $displayName
                    DisplayVersion = $displayVersion
                    BundleVersion = $bundleVersion
                    BundleId = $bundleProviderKey
                    BundleUpgradeCode = @($bundleKey.GetValue('BundleUpgradeCode'))
                    BundleCachePath = $bundleCachePath
                    UninstallString = $uninstallString
                    QuietUninstallString = $quietUninstallString
                    RegistryView = [string] $registryView
                    RegistrySubkey = "$uninstallPath\$subkeyName"
                })
            }
            finally {
                $bundleKey.Dispose()
            }
        }
    }
    finally {
        if ($null -ne $uninstallKey) {
            $uninstallKey.Dispose()
        }
        if ($null -ne $baseKey) {
            $baseKey.Dispose()
        }
    }

    return $bundles.ToArray()
}

function Get-DotNetSdkBundleInventory {
    return @(
        Get-DotNetInstallationInventory |
            Where-Object {
                $_.ProductType -eq 'Sdk' -and
                    $_.InstallerKind -eq 'Bundle' -and
                    $_.IsUpdateable
            }
    )
}

function Get-DotNetDependencyMap {
    $dependencyPath = 'SOFTWARE\Classes\Installer\Dependencies'
    $byProductCode = @{}

    foreach ($registryView in @(
        [Microsoft.Win32.RegistryView]::Registry32,
        [Microsoft.Win32.RegistryView]::Registry64
    )) {
        $baseKey = [Microsoft.Win32.RegistryKey]::OpenBaseKey(
            [Microsoft.Win32.RegistryHive]::LocalMachine,
            $registryView
        )
        $dependenciesKey = $baseKey.OpenSubKey($dependencyPath)
        try {
            if ($null -eq $dependenciesKey) {
                continue
            }

            foreach ($providerName in $dependenciesKey.GetSubKeyNames()) {
                $providerKey = $dependenciesKey.OpenSubKey($providerName)
                if ($null -eq $providerKey) {
                    continue
                }
                try {
                    $productCode = [string] $providerKey.GetValue($null)
                    if ($productCode -notmatch '^\{[0-9A-Fa-f-]{36}\}$') {
                        continue
                    }

                    $dependentsKey = $providerKey.OpenSubKey('Dependents')
                    try {
                        $dependents = if ($null -ne $dependentsKey) {
                            @($dependentsKey.GetSubKeyNames())
                        }
                        else {
                            @()
                        }
                    }
                    finally {
                        if ($null -ne $dependentsKey) {
                            $dependentsKey.Dispose()
                        }
                    }

                    $mapKey = $productCode.ToUpperInvariant()
                    if (-not $byProductCode.ContainsKey($mapKey)) {
                        $byProductCode[$mapKey] = [pscustomobject] @{
                            ProviderKeys = New-Object System.Collections.Generic.List[string]
                            Dependents = New-Object System.Collections.Generic.List[string]
                        }
                    }

                    if (-not $byProductCode[$mapKey].ProviderKeys.Contains($providerName)) {
                        $byProductCode[$mapKey].ProviderKeys.Add($providerName)
                    }
                    foreach ($dependent in $dependents) {
                        if (-not $byProductCode[$mapKey].Dependents.Contains($dependent)) {
                            $byProductCode[$mapKey].Dependents.Add($dependent)
                        }
                    }
                }
                finally {
                    $providerKey.Dispose()
                }
            }
        }
        finally {
            if ($null -ne $dependenciesKey) {
                $dependenciesKey.Dispose()
            }
            $baseKey.Dispose()
        }
    }

    return $byProductCode
}

function Get-DotNetInstallRoot {
    param(
        [Parameter(Mandatory = $true)]
        [ValidateSet('x64', 'x86', 'arm64')]
        [string] $Architecture
    )

    $setupPath = "SOFTWARE\dotnet\Setup\InstalledVersions\$Architecture"
    foreach ($registryView in @(
        [Microsoft.Win32.RegistryView]::Registry64,
        [Microsoft.Win32.RegistryView]::Registry32
    )) {
        $baseKey = [Microsoft.Win32.RegistryKey]::OpenBaseKey(
            [Microsoft.Win32.RegistryHive]::LocalMachine,
            $registryView
        )
        $setupKey = $baseKey.OpenSubKey($setupPath)
        try {
            if ($null -ne $setupKey) {
                $installLocation = [string] $setupKey.GetValue('InstallLocation')
                if (-not [string]::IsNullOrWhiteSpace($installLocation)) {
                    return $installLocation
                }
            }
        }
        finally {
            if ($null -ne $setupKey) {
                $setupKey.Dispose()
            }
            $baseKey.Dispose()
        }
    }

    return $null
}

function Resolve-DotNetPayloadVersion {
    param(
        [Parameter(Mandatory = $true)]
        [ValidateSet('Sdk', 'Runtime', 'AspNetCoreRuntime', 'WindowsDesktopRuntime')]
        [string] $ProductType,

        [Parameter(Mandatory = $true)]
        [object] $VersionInfo,

        [Parameter(Mandatory = $true)]
        [ValidateSet('x64', 'x86', 'arm64')]
        [string] $Architecture,

        [AllowEmptyCollection()]
        [object[]] $OwnerBundles = @()
    )

    if ($VersionInfo.IsStable) {
        return $VersionInfo
    }

    $installRoot = Get-DotNetInstallRoot -Architecture $Architecture
    if ([string]::IsNullOrWhiteSpace($installRoot)) {
        return $VersionInfo
    }

    if ($ProductType -eq 'Sdk') {
        $frameworkPath = Join-Path $installRoot 'sdk'
    }
    else {
        $frameworkName = switch ($ProductType) {
            'Runtime' { 'Microsoft.NETCore.App' }
            'AspNetCoreRuntime' { 'Microsoft.AspNetCore.App' }
            'WindowsDesktopRuntime' { 'Microsoft.WindowsDesktop.App' }
        }
        $frameworkPath = Join-Path (Join-Path $installRoot 'shared') $frameworkName
    }

    if (-not (Test-Path -LiteralPath $frameworkPath -PathType Container)) {
        return $VersionInfo
    }

    $matches = New-Object System.Collections.Generic.List[object]
    foreach ($directory in Get-ChildItem -LiteralPath $frameworkPath -Directory -ErrorAction Stop) {
        if ($directory.Name -ne $VersionInfo.Text -and
            -not $directory.Name.StartsWith("$($VersionInfo.Text).", [StringComparison]::OrdinalIgnoreCase)) {
            continue
        }

        try {
            $matches.Add([pscustomobject] @{
                VersionInfo = New-SdkVersionInfo -Text $directory.Name
            })
        }
        catch {
            continue
        }
    }

    if ($matches.Count -eq 0) {
        return $VersionInfo
    }

    foreach ($ownerBundle in $OwnerBundles) {
        if ($ownerBundle.ProductType -eq $ProductType -and
            ($ownerBundle.VersionInfo.Text -eq $VersionInfo.Text -or
            $ownerBundle.VersionInfo.Text.StartsWith(
                "$($VersionInfo.Text).",
                [StringComparison]::OrdinalIgnoreCase
            ))) {
            return $ownerBundle.VersionInfo
        }

        if ($ownerBundle.VersionInfo.Major -eq $VersionInfo.Major -and
            $ownerBundle.VersionInfo.Minor -eq $VersionInfo.Minor -and
            -not [string]::IsNullOrWhiteSpace($ownerBundle.VersionInfo.Prerelease)) {
            $ownerMatch = @($matches | Where-Object {
                $_.VersionInfo.Prerelease -ceq $ownerBundle.VersionInfo.Prerelease
            })
            if ($ownerMatch.Count -eq 1) {
                return $ownerMatch[0].VersionInfo
            }
        }
    }

    if ($matches.Count -eq 1) {
        return $matches[0].VersionInfo
    }

    return $VersionInfo
}

function Get-DotNetPayloadInventory {
    param(
        [Parameter(Mandatory = $true)]
        [AllowEmptyCollection()]
        [object[]] $Bundles
    )

    $uninstallPath = 'SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall'
    $visualStudioDependent = 'VS.{AEF703B8-D2CC-4343-915C-F54A30B90937}'
    $dependencyMap = Get-DotNetDependencyMap
    $bundleById = @{}
    foreach ($bundle in $Bundles) {
        $bundleById[$bundle.BundleId.ToUpperInvariant()] = $bundle
    }
    $payloads = New-Object System.Collections.Generic.List[object]

    foreach ($registryView in @(
        [Microsoft.Win32.RegistryView]::Registry32,
        [Microsoft.Win32.RegistryView]::Registry64
    )) {
        $baseKey = [Microsoft.Win32.RegistryKey]::OpenBaseKey(
            [Microsoft.Win32.RegistryHive]::LocalMachine,
            $registryView
        )
        $uninstallKey = $baseKey.OpenSubKey($uninstallPath)
        try {
            if ($null -eq $uninstallKey) {
                continue
            }

            foreach ($subkeyName in $uninstallKey.GetSubKeyNames()) {
                $productKey = $uninstallKey.OpenSubKey($subkeyName)
                if ($null -eq $productKey) {
                    continue
                }
                try {
                    $displayName = [string] $productKey.GetValue('DisplayName')
                    $publisher = [string] $productKey.GetValue('Publisher')
                    $uninstallString = [string] $productKey.GetValue('UninstallString')
                    $productType = Get-DotNetProductType -DisplayName $displayName
                    if ($null -eq $productType -or $publisher -cne 'Microsoft Corporation' -or
                        $uninstallString.IndexOf('msiexec', [StringComparison]::OrdinalIgnoreCase) -lt 0) {
                        continue
                    }

                    $version = Get-DotNetVersionFromDisplayName -DisplayName $displayName
                    if ([string]::IsNullOrWhiteSpace($version) -or
                        $displayName -notmatch '(?i)\((?<architecture>x64|x86|arm64)\)') {
                        continue
                    }
                    $architecture = $Matches.architecture.ToLowerInvariant()

                    $productCode = $subkeyName.ToUpperInvariant()
                    $providerKeys = @()
                    $dependentIds = @()
                    if ($dependencyMap.ContainsKey($productCode)) {
                        $providerKeys = $dependencyMap[$productCode].ProviderKeys.ToArray()
                        $dependentIds = $dependencyMap[$productCode].Dependents.ToArray()
                    }

                    $managedByVisualStudio = $false
                    $owners = New-Object System.Collections.Generic.List[string]
                    $ownerBundles = New-Object System.Collections.Generic.List[object]
                    foreach ($dependentId in $dependentIds) {
                        if ($dependentId -eq $visualStudioDependent) {
                            $managedByVisualStudio = $true
                            if (-not $owners.Contains('Visual Studio')) {
                                $owners.Add('Visual Studio')
                            }
                            continue
                        }

                        $dependentKey = $dependentId.ToUpperInvariant()
                        if ($bundleById.ContainsKey($dependentKey)) {
                            $ownerBundle = $bundleById[$dependentKey]
                            $ownerName = $ownerBundle.DisplayName
                            if (-not $ownerBundles.Contains($ownerBundle)) {
                                $ownerBundles.Add($ownerBundle)
                            }
                        }
                        else {
                            $ownerName = $dependentId
                        }
                        if (-not $owners.Contains($ownerName)) {
                            $owners.Add($ownerName)
                        }
                    }

                    try {
                        $versionInfo = New-SdkVersionInfo -Text $version
                    }
                    catch {
                        Write-Warning "Ignoring .NET payload '$displayName' because version '$version' is invalid."
                        continue
                    }

                    try {
                        $versionInfo = Resolve-DotNetPayloadVersion -ProductType $productType `
                            -VersionInfo $versionInfo -Architecture $architecture `
                            -OwnerBundles $ownerBundles.ToArray()
                    }
                    catch {
                        Write-Warning "Could not refine the prerelease version for .NET payload '$displayName'; using '$version'. $($_.Exception.Message)"
                    }

                    $managementSource = if ($managedByVisualStudio) {
                        'VisualStudio'
                    }
                    elseif ($owners.Count -gt 0) {
                        'SharedInstaller'
                    }
                    else {
                        'WindowsInstaller'
                    }

                    $payloads.Add([pscustomobject] @{
                        PSTypeName = 'DotNetSteward.Installation'
                        ProductType = $productType
                        Version = $versionInfo.Text
                        VersionInfo = $versionInfo
                        Architecture = $architecture
                        Rid = "win-$architecture"
                        InstallerKind = 'Payload'
                        ManagementSource = $managementSource
                        ManagedByVisualStudio = $managedByVisualStudio
                        Owners = $owners.ToArray()
                        IsUpdateable = $false
                        IsUninstallable = $false
                        DisplayName = $displayName
                        DisplayVersion = [string] $productKey.GetValue('DisplayVersion')
                        ProductCode = $subkeyName
                        DependencyProviderKeys = $providerKeys
                        RegistryView = [string] $registryView
                        RegistrySubkey = "$uninstallPath\$subkeyName"
                    })
                }
                finally {
                    $productKey.Dispose()
                }
            }
        }
        finally {
            if ($null -ne $uninstallKey) {
                $uninstallKey.Dispose()
            }
            $baseKey.Dispose()
        }
    }

    return $payloads.ToArray()
}

function Get-DotNetInstallationInventory {
    $bundles = @(Get-DotNetBundleInventory)
    $payloads = @(Get-DotNetPayloadInventory -Bundles $bundles)
    $payloadsByIdentity = @{}

    foreach ($payload in $payloads) {
        $identity = "$($payload.ProductType)|$($payload.Version)|$($payload.Architecture)"
        if (-not $payloadsByIdentity.ContainsKey($identity)) {
            $payloadsByIdentity[$identity] = New-Object System.Collections.Generic.List[object]
        }
        $payloadsByIdentity[$identity].Add($payload)
    }

    $installations = New-Object System.Collections.Generic.List[object]
    foreach ($bundle in $bundles) {
        $identity = "$($bundle.ProductType)|$($bundle.Version)|$($bundle.Architecture)"
        if ($payloadsByIdentity.ContainsKey($identity)) {
            foreach ($payload in $payloadsByIdentity[$identity]) {
                if ($payload.ManagedByVisualStudio) {
                    $bundle.ManagedByVisualStudio = $true
                    $bundle.ManagementSource = 'StandaloneAndVisualStudio'
                    $bundle.IsUpdateable = $false
                    $bundle.IsUninstallable = $false
                }
                $bundle.Owners = @($bundle.Owners + $payload.Owners | Sort-Object -Unique)
            }
            $payloadsByIdentity.Remove($identity)
        }
        $installations.Add($bundle)
    }

    foreach ($remainingPayloads in $payloadsByIdentity.Values) {
        foreach ($payload in $remainingPayloads) {
            $installations.Add($payload)
        }
    }

    return $installations.ToArray()
}

function Sort-DotNetInstallations {
    param(
        [Parameter(Mandatory = $true)]
        [AllowEmptyCollection()]
        [object[]] $Installations
    )

    $sorted = New-Object System.Collections.Generic.List[object]
    foreach ($installation in $Installations) {
        $insertAt = $sorted.Count
        for ($index = 0; $index -lt $sorted.Count; $index++) {
            $comparison = [string]::CompareOrdinal(
                [string] $installation.ProductType,
                [string] $sorted[$index].ProductType
            )
            if ($comparison -eq 0) {
                $comparison = [string]::CompareOrdinal(
                    [string] $installation.Architecture,
                    [string] $sorted[$index].Architecture
                )
            }
            if ($comparison -eq 0) {
                $comparison = Compare-SdkVersion -Left $installation.VersionInfo `
                    -Right $sorted[$index].VersionInfo
            }
            if ($comparison -lt 0) {
                $insertAt = $index
                break
            }
        }
        $sorted.Insert($insertAt, $installation)
    }

    return $sorted.ToArray()
}

# SIG # Begin signature block
# MII9KgYJKoZIhvcNAQcCoII9GzCCPRcCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDSyyPg9T3BVSZz
# U8gEDlplm4kK4VC2ruyO+bxIb9JoWqCCIewwggXMMIIDtKADAgECAhBUmNLR1FsZ
# lUgTecgRwIeZMA0GCSqGSIb3DQEBDAUAMHcxCzAJBgNVBAYTAlVTMR4wHAYDVQQK
# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xSDBGBgNVBAMTP01pY3Jvc29mdCBJZGVu
# dGl0eSBWZXJpZmljYXRpb24gUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAy
# MDAeFw0yMDA0MTYxODM2MTZaFw00NTA0MTYxODQ0NDBaMHcxCzAJBgNVBAYTAlVT
# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xSDBGBgNVBAMTP01pY3Jv
# c29mdCBJZGVudGl0eSBWZXJpZmljYXRpb24gUm9vdCBDZXJ0aWZpY2F0ZSBBdXRo
# b3JpdHkgMjAyMDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBALORKgeD
# Bmf9np3gx8C3pOZCBH8Ppttf+9Va10Wg+3cL8IDzpm1aTXlT2KCGhFdFIMeiVPvH
# or+Kx24186IVxC9O40qFlkkN/76Z2BT2vCcH7kKbK/ULkgbk/WkTZaiRcvKYhOuD
# PQ7k13ESSCHLDe32R0m3m/nJxxe2hE//uKya13NnSYXjhr03QNAlhtTetcJtYmrV
# qXi8LW9J+eVsFBT9FMfTZRY33stuvF4pjf1imxUs1gXmuYkyM6Nix9fWUmcIxC70
# ViueC4fM7Ke0pqrrBc0ZV6U6CwQnHJFnni1iLS8evtrAIMsEGcoz+4m+mOJyoHI1
# vnnhnINv5G0Xb5DzPQCGdTiO0OBJmrvb0/gwytVXiGhNctO/bX9x2P29Da6SZEi3
# W295JrXNm5UhhNHvDzI9e1eM80UHTHzgXhgONXaLbZ7LNnSrBfjgc10yVpRnlyUK
# xjU9lJfnwUSLgP3B+PR0GeUw9gb7IVc+BhyLaxWGJ0l7gpPKWeh1R+g/OPTHU3mg
# trTiXFHvvV84wRPmeAyVWi7FQFkozA8kwOy6CXcjmTimthzax7ogttc32H83rwjj
# O3HbbnMbfZlysOSGM1l0tRYAe1BtxoYT2v3EOYI9JACaYNq6lMAFUSw0rFCZE4e7
# swWAsk0wAly4JoNdtGNz764jlU9gKL431VulAgMBAAGjVDBSMA4GA1UdDwEB/wQE
# AwIBhjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTIftJqhSobyhmYBAcnz1AQ
# T2ioojAQBgkrBgEEAYI3FQEEAwIBADANBgkqhkiG9w0BAQwFAAOCAgEAr2rd5hnn
# LZRDGU7L6VCVZKUDkQKL4jaAOxWiUsIWGbZqWl10QzD0m/9gdAmxIR6QFm3FJI9c
# Zohj9E/MffISTEAQiwGf2qnIrvKVG8+dBetJPnSgaFvlVixlHIJ+U9pW2UYXeZJF
# xBA2CFIpF8svpvJ+1Gkkih6PsHMNzBxKq7Kq7aeRYwFkIqgyuH4yKLNncy2RtNwx
# AQv3Rwqm8ddK7VZgxCwIo3tAsLx0J1KH1r6I3TeKiW5niB31yV2g/rarOoDXGpc8
# FzYiQR6sTdWD5jw4vU8w6VSp07YEwzJ2YbuwGMUrGLPAgNW3lbBeUU0i/OxYqujY
# lLSlLu2S3ucYfCFX3VVj979tzR/SpncocMfiWzpbCNJbTsgAlrPhgzavhgplXHT2
# 6ux6anSg8Evu75SjrFDyh+3XOjCDyft9V77l4/hByuVkrrOj7FjshZrM77nq81YY
# uVxzmq/FdxeDWds3GhhyVKVB0rYjdaNDmuV3fJZ5t0GNv+zcgKCf0Xd1WF81E+Al
# GmcLfc4l+gcK5GEh2NQc5QfGNpn0ltDGFf5Ozdeui53bFv0ExpK91IjmqaOqu/dk
# ODtfzAzQNb50GQOmxapMomE2gj4d8yu8l13bS3g7LfU772Aj6PXsCyM2la+YZr9T
# 03u4aUoqlmZpxJTG9F9urJh4iIAGXKKy7aIwggajMIIEi6ADAgECAhMzAAbGfXzU
# a/1I5WGiAAAABsZ9MA0GCSqGSIb3DQEBDAUAMFoxCzAJBgNVBAYTAlVTMR4wHAYD
# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKzApBgNVBAMTIk1pY3Jvc29mdCBJ
# RCBWZXJpZmllZCBDUyBFT0MgQ0EgMDMwHhcNMjYwOTIzMDcxNzAwWhcNMjYwOTI2
# MDcxNzAwWjBnMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjERMA8G
# A1UEBxMISXNzYXF1YWgxFzAVBgNVBAoTDkRhbWlhbiBFZHdhcmRzMRcwFQYDVQQD
# Ew5EYW1pYW4gRWR3YXJkczCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGB
# AKaYeanVPgf4YNEbTUMESBv8dy4YdU3G5xRp5v+PjIZldxEpUp9pCggXXtxLiWEA
# Kg3wV20SwP4yYLvyXgV6l3ck+8lMFRcCOTypprLYzhCb1GI+7yhN99YmNpZeEXa7
# zuOtcDeMuESQMFd1tOuMoaqaPRJqeffbsGTeMMJ7s26J79T9qlhKhYNRBkz/nA7C
# 9ghH0lcyJi4sS05lJ2svut4hutvjosZjzo1vNpwvbm4odqynFJi3O8VKlM2lg3bA
# zz+MDF0C1mrxGMdGv1rcmbapNu83lTt4LYUbz5/m73QgCbHeQbJojKzdKtmZyhQY
# TIFH5p9dtSETLXj0+jNlDCeP9fSzI2jEIcIq8Pk6bx4OeB2INYZ7RtNRQXRMY9Do
# h55Uf1CRILZvKrnAUM7wSVm5PPBglT5vSFFGtNcWZeXMiV+EnQPKsXd9XSeRu0jw
# MVXlt2dbRYEbdK+M/RlFZ3Q0atJPn6odM0rGZuVabXMMzPp4GxMIKrLfKg5ROns1
# HQIDAQABo4IB0zCCAc8wDAYDVR0TAQH/BAIwADAOBgNVHQ8BAf8EBAMCB4AwOgYD
# VR0lBDMwMQYKKwYBBAGCN2EBAAYIKwYBBQUHAwMGGSsGAQQBgjdh8PiHLKGwwBPl
# htEVg5ShoiEwHQYDVR0OBBYEFMW3TrLRqeh49nU+GPNyNUgU+9D9MB8GA1UdIwQY
# MBaAFGtepTTDBcViSiFajqtzYGLUrGOFMGcGA1UdHwRgMF4wXKBaoFiGVmh0dHA6
# Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMElEJTIw
# VmVyaWZpZWQlMjBDUyUyMEVPQyUyMENBJTIwMDMuY3JsMHQGCCsGAQUFBwEBBGgw
# ZjBkBggrBgEFBQcwAoZYaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9j
# ZXJ0cy9NaWNyb3NvZnQlMjBJRCUyMFZlcmlmaWVkJTIwQ1MlMjBFT0MlMjBDQSUy
# MDAzLmNydDBUBgNVHSAETTBLMEkGBFUdIAAwQTA/BggrBgEFBQcCARYzaHR0cDov
# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRvcnkuaHRtMA0G
# CSqGSIb3DQEBDAUAA4ICAQBBOh3LeUTPZzfMxsVll3DcSHl6k2i2j9YM24fUNx3B
# rEereGW9bTncJqU8uLNV6x710962keG4vVJNGstWhtpBSviagx4E7LghO3R9JVgl
# 58PUt8EXE45ZPrQsqvGGO9O+3cf4r97jBaxhKRlrydC1/EJUiiprbRP/rk5zv5+L
# kMgQawE+3ntxmpDJc2voY+k7ey5rr8TQXOijvh8mecMf6ar3XoVmllcTIWssxtV4
# acJA7zu+XqE9vMBinJLPqy/vleI2A1iO2PyB8wTVogPmfZQF0J/058FivRrRxoln
# dASOd86YjQLPWsATVaF9xf1zNHx+VNqg51AEo5ei9lQpyFUEXGOPEZ8TH3/pBwsV
# k8SHyr/3vlaJTLlO8wWPVlURyFItfM6dtgookzJBEqtjsxPGmUmNTLu6dxXkd0jY
# ewGdTI8nSo2e5rxFkSthH7gjwbj6sieQCz0i2I1gu4O4WSMHEVFYxbtnNaHU8Oa8
# JGJkp2i8xU5fvfDHJvjN3HYvOUBP5kllgwNHUdKwVcPVB7Hrd/ZsOt/n7y+LP88s
# uKAWzKkTGxIAt8vbhCowGMP5Xd5zhwAXCyvF1HNajb20RDTcyvlzQ+pcYYO7Jmml
# 6xcA/HYLcon3CzsQbtl4SU52TaIVoIzfG8fi6kFuttXZQYx2Ie5Xm6xEygvjSp5m
# 9jCCBqMwggSLoAMCAQICEzMABsZ9fNRr/UjlYaIAAAAGxn0wDQYJKoZIhvcNAQEM
# BQAwWjELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv
# bjErMCkGA1UEAxMiTWljcm9zb2Z0IElEIFZlcmlmaWVkIENTIEVPQyBDQSAwMzAe
# Fw0yNjA5MjMwNzE3MDBaFw0yNjA5MjYwNzE3MDBaMGcxCzAJBgNVBAYTAlVTMRMw
# EQYDVQQIEwpXYXNoaW5ndG9uMREwDwYDVQQHEwhJc3NhcXVhaDEXMBUGA1UEChMO
# RGFtaWFuIEVkd2FyZHMxFzAVBgNVBAMTDkRhbWlhbiBFZHdhcmRzMIIBojANBgkq
# hkiG9w0BAQEFAAOCAY8AMIIBigKCAYEApph5qdU+B/hg0RtNQwRIG/x3Lhh1Tcbn
# FGnm/4+MhmV3ESlSn2kKCBde3EuJYQAqDfBXbRLA/jJgu/JeBXqXdyT7yUwVFwI5
# PKmmstjOEJvUYj7vKE331iY2ll4RdrvO461wN4y4RJAwV3W064yhqpo9Emp599uw
# ZN4wwnuzbonv1P2qWEqFg1EGTP+cDsL2CEfSVzImLixLTmUnay+63iG62+OixmPO
# jW82nC9ubih2rKcUmLc7xUqUzaWDdsDPP4wMXQLWavEYx0a/WtyZtqk27zeVO3gt
# hRvPn+bvdCAJsd5BsmiMrN0q2ZnKFBhMgUfmn121IRMtePT6M2UMJ4/19LMjaMQh
# wirw+TpvHg54HYg1hntG01FBdExj0OiHnlR/UJEgtm8qucBQzvBJWbk88GCVPm9I
# UUa01xZl5cyJX4SdA8qxd31dJ5G7SPAxVeW3Z1tFgRt0r4z9GUVndDRq0k+fqh0z
# SsZm5VptcwzM+ngbEwgqst8qDlE6ezUdAgMBAAGjggHTMIIBzzAMBgNVHRMBAf8E
# AjAAMA4GA1UdDwEB/wQEAwIHgDA6BgNVHSUEMzAxBgorBgEEAYI3YQEABggrBgEF
# BQcDAwYZKwYBBAGCN2Hw+IcsobDAE+WG0RWDlKGiITAdBgNVHQ4EFgQUxbdOstGp
# 6Hj2dT4Y83I1SBT70P0wHwYDVR0jBBgwFoAUa16lNMMFxWJKIVqOq3NgYtSsY4Uw
# ZwYDVR0fBGAwXjBcoFqgWIZWaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9w
# cy9jcmwvTWljcm9zb2Z0JTIwSUQlMjBWZXJpZmllZCUyMENTJTIwRU9DJTIwQ0El
# MjAwMy5jcmwwdAYIKwYBBQUHAQEEaDBmMGQGCCsGAQUFBzAChlhodHRwOi8vd3d3
# Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMElEJTIwVmVy
# aWZpZWQlMjBDUyUyMEVPQyUyMENBJTIwMDMuY3J0MFQGA1UdIARNMEswSQYEVR0g
# ADBBMD8GCCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3Bz
# L0RvY3MvUmVwb3NpdG9yeS5odG0wDQYJKoZIhvcNAQEMBQADggIBAEE6Hct5RM9n
# N8zGxWWXcNxIeXqTaLaP1gzbh9Q3HcGsR6t4Zb1tOdwmpTy4s1XrHvXT3raR4bi9
# Uk0ay1aG2kFK+JqDHgTsuCE7dH0lWCXnw9S3wRcTjlk+tCyq8YY7077dx/iv3uMF
# rGEpGWvJ0LX8QlSKKmttE/+uTnO/n4uQyBBrAT7ee3GakMlza+hj6Tt7LmuvxNBc
# 6KO+HyZ5wx/pqvdehWaWVxMhayzG1XhpwkDvO75eoT28wGKcks+rL++V4jYDWI7Y
# /IHzBNWiA+Z9lAXQn/TnwWK9GtHGiWd0BI53zpiNAs9awBNVoX3F/XM0fH5U2qDn
# UASjl6L2VCnIVQRcY48RnxMff+kHCxWTxIfKv/e+VolMuU7zBY9WVRHIUi18zp22
# CiiTMkESq2OzE8aZSY1Mu7p3FeR3SNh7AZ1MjydKjZ7mvEWRK2EfuCPBuPqyJ5AL
# PSLYjWC7g7hZIwcRUVjFu2c1odTw5rwkYmSnaLzFTl+98Mcm+M3cdi85QE/mSWWD
# A0dR0rBVw9UHset39mw63+fvL4s/zyy4oBbMqRMbEgC3y9uEKjAYw/ld3nOHABcL
# K8XUc1qNvbRENNzK+XND6lxhg7smaaXrFwD8dgtyifcLOxBu2XhJTnZNohWgjN8b
# x+LqQW621dlBjHYh7lebrETKC+NKnmb2MIIHKDCCBRCgAwIBAgITMwAAABUFPm4Z
# jpMp2QAAAAAAFTANBgkqhkiG9w0BAQwFADBjMQswCQYDVQQGEwJVUzEeMBwGA1UE
# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTQwMgYDVQQDEytNaWNyb3NvZnQgSUQg
# VmVyaWZpZWQgQ29kZSBTaWduaW5nIFBDQSAyMDIxMB4XDTI2MDMyNjE4MTEyOFoX
# DTMxMDMyNjE4MTEyOFowWjELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29m
# dCBDb3Jwb3JhdGlvbjErMCkGA1UEAxMiTWljcm9zb2Z0IElEIFZlcmlmaWVkIENT
# IEVPQyBDQSAwMzCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAOD0yz0C
# qi8Ocx4+8w574rJuEJ3z6WiTNg5GVLeQFVex55xvIbAFyx6eWblsu0wY+OIgUvMF
# AX6CGVVX9Tb2rkZx14QQEIdNMaEvaSgistzhSuWIxFxu/2Y4y1H+Xv/ECa/QXHgE
# kefV0e3ft++sGpeYqMp8Z/kOnI7/6GdXtMSt4y1LX2I75uNn/0eemDc8KTR7thJt
# FMWTH3sVnBFakLizc16lF9FdCH9YwCPsmaxh5VmiGLhMXnJbYkyslmrAdzLMlli0
# PYeWejlkQmR2JlwRrEc6hubA7TpnUn1zbemz08YiEZqrWwosQDP0OhzmsuRhYa14
# OuxwqECnaQhz+hiUf0iPoGQ6qqBYg0SQS0Lxk0bUxqT6HejrlqPSJAqZ3Fbshloc
# 7ly7KgyL4q1h9d4giDexUhtLYQvyRS2wMZ0So2oCr+KypOLWNeot7qIqnWeLVI92
# 89b0bTcJOxgXrxv/K4hBHBt2gEJd6Yw0kJLR2isJFjhvZYADLieDtIA1wSCsGBl/
# nfn5B8tTmEbOsqMilsxptq5ZvkUpZQqQyw9xcWRdFY7iego+bgpaUXKmo6lsn8o4
# 1VF4iXEdBF6AA4HMiFEHuCv0gNDWxzYyA6BD7FUZbiirgcPSZ8CLCLIuyRmuRpDs
# mhqdiME1xH1FLbpjEBVtwG0uK0VPMIgSDll1AgMBAAGjggHcMIIB2DAOBgNVHQ8B
# Af8EBAMCAYYwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFGtepTTDBcViSiFa
# jqtzYGLUrGOFMFQGA1UdIARNMEswSQYEVR0gADBBMD8GCCsGAQUFBwIBFjNodHRw
# Oi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9yeS5odG0w
# GQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwEgYDVR0TAQH/BAgwBgEB/wIBADAf
# BgNVHSMEGDAWgBTZQSmwDw9jbO9p1/XNKZ6kSGow5jBwBgNVHR8EaTBnMGWgY6Bh
# hl9odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQl
# MjBJRCUyMFZlcmlmaWVkJTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDIxLmNy
# bDB9BggrBgEFBQcBAQRxMG8wbQYIKwYBBQUHMAKGYWh0dHA6Ly93d3cubWljcm9z
# b2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwSUQlMjBWZXJpZmllZCUy
# MENvZGUlMjBTaWduaW5nJTIwUENBJTIwMjAyMS5jcnQwDQYJKoZIhvcNAQEMBQAD
# ggIBAF1uIjzPBctfyCUkSH/xDbZQwJSFYE7jpn0U+HA5HeZ2WpFUuRg6if8xzNTC
# uMOHHdf31I8fk9J+WQahO+c71lYczlgVVik7s1i4H6Z9VIYAZnCIY4BJaTSLYHu+
# f2cSUkmaiJfG6B8flh0GytSBO3QAU1eTOapOCT5LUfFvW7/QcKoQdVk+TYD/p4ld
# hu2lEzkVzPTSOKxSX0FFmBJ5s4NXzlsHM696rILd/Q+ccLFEk2ExvzE/+wH9Ujul
# /auF5JXvOpRK/y+f98gxuVd5pUiWmqirxI/0EkyMT8KhVcnGeRlBEzUVruQ33LO2
# 9F46HFKA+ClnH9eX+OTDIQVUlMF8GnexOB8hz+maq/Z6G1qQvYASPvwSY49CiHEl
# PfDJf4/vwYDbm0ukC/OPdEwwd3zPXxm65WL7rQwDMak4BIfUvw2Wvd9lFmdA76nL
# J7YMK9iYdoh91SBgmqfuejHEZW/z35FoROHW2AIO/A2kUJIbu+XkDhqSj7Z/HjT2
# v1NaNcLs6J/UhDlknMHhF/wa8GIdiO8yYemV52nUUZEt1JEVWkLf84qlljpq8ipm
# nv7yk/9ZA/3TcN2Cu8BPpbjE84HFc9ri0aSw3dK6olqIVgdI3J4G5+fyKx66Nbgh
# sFJscPgE+psXepn7ucb13938bb8vHiQf1wKYF+axl1KQea6QMIIHnjCCBYagAwIB
# AgITMwAAAAeHozSje6WOHAAAAAAABzANBgkqhkiG9w0BAQwFADB3MQswCQYDVQQG
# EwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMUgwRgYDVQQDEz9N
# aWNyb3NvZnQgSWRlbnRpdHkgVmVyaWZpY2F0aW9uIFJvb3QgQ2VydGlmaWNhdGUg
# QXV0aG9yaXR5IDIwMjAwHhcNMjEwNDAxMjAwNTIwWhcNMzYwNDAxMjAxNTIwWjBj
# MQswCQYDVQQGEwJVUzEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTQw
# MgYDVQQDEytNaWNyb3NvZnQgSUQgVmVyaWZpZWQgQ29kZSBTaWduaW5nIFBDQSAy
# MDIxMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAsvDArxmIKOLdVHpM
# SWxpCFUJtFL/ekr4weslKPdnF3cpTeuV8veqtmKVgok2rO0D05BpyvUDCg1wdsoE
# tuxACEGcgHfjPF/nZsOkg7c0mV8hpMT/GvB4uhDvWXMIeQPsDgCzUGzTvoi76YDp
# xDOxhgf8JuXWJzBDoLrmtThX01CE1TCCvH2sZD/+Hz3RDwl2MsvDSdX5rJDYVuR3
# bjaj2QfzZFmwfccTKqMAHlrz4B7ac8g9zyxlTpkTuJGtFnLBGasoOnn5NyYlf0xF
# 9/bjVRo4Gzg2Yc7KR7yhTVNiuTGH5h4eB9ajm1OCShIyhrKqgOkc4smz6obxO+Hx
# KeJ9bYmPf6KLXVNLz8UaeARo0BatvJ82sLr2gqlFBdj1sYfqOf00Qm/3B4XGFPDK
# /H04kteZEZsBRc3VT2d/iVd7OTLpSH9yCORV3oIZQB/Qr4nD4YT/lWkhVtw2v2s0
# TnRJubL/hFMIQa86rcaGMhNsJrhysLNNMeBhiMezU1s5zpusf54qlYu2v5sZ5zL0
# KvBDLHtL8F9gn6jOy3v7Jm0bbBHjrW5yQW7S36ALAt03QDpwW1JG1Hxu/FUXJbBO
# 2AwwVG4Fre+ZQ5Od8ouwt59FpBxVOBGfN4vN2m3fZx1gqn52GvaiBz6ozorgIEjn
# +PhUXILhAV5Q/ZgCJ0u2+ldFGjcCAwEAAaOCAjUwggIxMA4GA1UdDwEB/wQEAwIB
# hjAQBgkrBgEEAYI3FQEEAwIBADAdBgNVHQ4EFgQU2UEpsA8PY2zvadf1zSmepEhq
# MOYwVAYDVR0gBE0wSzBJBgRVHSAAMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cu
# bWljcm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTAZBgkrBgEE
# AYI3FAIEDB4KAFMAdQBiAEMAQTAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaA
# FMh+0mqFKhvKGZgEByfPUBBPaKiiMIGEBgNVHR8EfTB7MHmgd6B1hnNodHRwOi8v
# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBJZGVudGl0
# eSUyMFZlcmlmaWNhdGlvbiUyMFJvb3QlMjBDZXJ0aWZpY2F0ZSUyMEF1dGhvcml0
# eSUyMDIwMjAuY3JsMIHDBggrBgEFBQcBAQSBtjCBszCBgQYIKwYBBQUHMAKGdWh0
# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIw
# SWRlbnRpdHklMjBWZXJpZmljYXRpb24lMjBSb290JTIwQ2VydGlmaWNhdGUlMjBB
# dXRob3JpdHklMjAyMDIwLmNydDAtBggrBgEFBQcwAYYhaHR0cDovL29uZW9jc3Au
# bWljcm9zb2Z0LmNvbS9vY3NwMA0GCSqGSIb3DQEBDAUAA4ICAQB/JSqe/tSr6t1m
# CttXI0y6XmyQ41uGWzl9xw+WYhvOL47BV09Dgfnm/tU4ieeZ7NAR5bguorTCNr58
# HOcA1tcsHQqt0wJsdClsu8bpQD9e/al+lUgTUJEV80Xhco7xdgRrehbyhUf4pkeA
# hBEjABvIUpD2LKPho5Z4DPCT5/0TlK02nlPwUbv9URREhVYCtsDM+31OFU3fDV8B
# mQXv5hT2RurVsJHZgP4y26dJDVF+3pcbtvh7R6NEDuYHYihfmE2HdQRq5jRvLE1E
# b59PYwISFCX2DaLZ+zpU4bX0I16ntKq4poGOFaaKtjIA1vRElItaOKcwtc04CBrX
# SfyL2Op6mvNIxTk4OaswIkTXbFL81ZKGD+24uMCwo/pLNhn7VHLfnxlMVzHQVL+b
# Ha9KhTyzwdG/L6uderJQn0cGpLQMStUuNDArxW2wF16QGZ1NtBWgKA8Kqv48M8Hf
# FqNifN6+zt6J0GwzvU8g0rYGgTZR8zDEIJfeZxwWDHpSxB5FJ1VVU1LIAtB7o9PX
# bjXzGifaIMYTzU4YKt4vMNwwBmetQDHhdAtTPplOXrnI9SI6HeTtjDD3iUN/7ygb
# ahmYOHk7VB7fwT4ze+ErCbMh6gHV1UuXPiLciloNxH6K4aMfZN1oLVk6YFeIJEok
# uPgNPa6EnTiOL60cPqfny+Fq8UiuZzGCGpQwghqQAgEBMHEwWjELMAkGA1UEBhMC
# VVMxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjErMCkGA1UEAxMiTWlj
# cm9zb2Z0IElEIFZlcmlmaWVkIENTIEVPQyBDQSAwMwITMwAGxn181Gv9SOVhogAA
# AAbGfTANBglghkgBZQMEAgEFAKBeMBAGCisGAQQBgjcCAQwxAjAAMBkGCSqGSIb3
# DQEJAzEMBgorBgEEAYI3AgEEMC8GCSqGSIb3DQEJBDEiBCD2W1SahzW4jHjwxubd
# SrxkJLM/H4ulHsXAJM01vS5lfjANBgkqhkiG9w0BAQEFAASCAYBVL+MaFlIBrGwG
# jQgpViX3uFjtYyJ1boDwoVZx8BVf8xW4Ie/26CdCR+EHDeSd/QaQlLZlyhfcqazf
# m+TadkNlDLjMovSIDa0dnzrprBHHWbW+zFapj9OzFKx0yIQNQfHxg/fOLEOkQpAR
# b3QfT7MUo/8Z3tRdEvdoYIlFbklvV00AVRLFMyJZc8rCgMm5fimlJZTyocwJhOrh
# fWsVmGhtMJ+I1zn/i5FZ5xNHltZupj+NdAeF3tNxKRllEvIValGGAShUKn6No5kS
# CX1HUQLzcoM+fDwiAZ4awYk67S8oM38qHOorggwca0yB4KBTFDANQoQrlMoDx132
# vDuJSBODjPCzMQu7wfkZnTuDuDDBi0YvmNUKTDoEwN6qjdD/wPJS2gw1eA2bQzXK
# lj0h7DLfeinnTvw/Tpf/5fuWAhdCS5IGXKr7noS1CTYAV1msIuTx0hATcaC6dOK+
# 22er8KjkCIgjbCBXnD24lllLh5n9I0P/gK2VqD0YS3l2yRYjZqWhghgUMIIYEAYK
# KwYBBAGCNwMDATGCGAAwghf8BgkqhkiG9w0BBwKgghftMIIX6QIBAzEPMA0GCWCG
# SAFlAwQCAQUAMIIBYgYLKoZIhvcNAQkQAQSgggFRBIIBTTCCAUkCAQEGCisGAQQB
# hFkKAwEwMTANBglghkgBZQMEAgEFAAQgGPplERwwVTz6HqT3mOwyxSlwP3O4m6iB
# 0yY2NYlmjxACBmqpeBPG0xgTMjAyNjA5MjQyMTQ0MjkuMjMyWjAEgAIB9KCB4aSB
# 3jCB2zELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT
# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UE
# CxMcTWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVs
# ZCBUU1MgRVNOOjdEMDAtMDVFMC1EOTQ3MTUwMwYDVQQDEyxNaWNyb3NvZnQgUHVi
# bGljIFJTQSBUaW1lIFN0YW1waW5nIEF1dGhvcml0eaCCDyEwggeCMIIFaqADAgEC
# AhMzAAAABeXPD/9mLsmHAAAAAAAFMA0GCSqGSIb3DQEBDAUAMHcxCzAJBgNVBAYT
# AlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xSDBGBgNVBAMTP01p
# Y3Jvc29mdCBJZGVudGl0eSBWZXJpZmljYXRpb24gUm9vdCBDZXJ0aWZpY2F0ZSBB
# dXRob3JpdHkgMjAyMDAeFw0yMDExMTkyMDMyMzFaFw0zNTExMTkyMDQyMzFaMGEx
# CzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAw
# BgNVBAMTKU1pY3Jvc29mdCBQdWJsaWMgUlNBIFRpbWVzdGFtcGluZyBDQSAyMDIw
# MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAnnznUmP94MWfBX1jtQYi
# oxwe1+eXM9ETBb1lRkd3kcFdcG9/sqtDlwxKoVIcaqDb+omFio5DHC4RBcbyQHjX
# CwMk/l3TOYtgoBjxnG/eViS4sOx8y4gSq8Zg49REAf5huXhIkQRKe3Qxs8Sgp02K
# HAznEa/Ssah8nWo5hJM1xznkRsFPu6rfDHeZeG1Wa1wISvlkpOQooTULFm809Z0Z
# YlQ8Lp7i5F9YciFlyAKwn6yjN/kR4fkquUWfGmMopNq/B8U/pdoZkZZQbxNlqJOi
# BGgCWpx69uKqKhTPVi3gVErnc/qi+dR8A2MiAz0kN0nh7SqINGbmw5OIRC0EsZ31
# WF3Uxp3GgZwetEKxLms73KG/Z+MkeuaVDQQheangOEMGJ4pQZH55ngI0Tdy1bi69
# INBV5Kn2HVJo9XxRYR/JPGAaM6xGl57Ei95HUw9NV/uC3yFjrhc087qLJQawSC3x
# zY/EXzsT4I7sDbxOmM2rl4uKK6eEpurRduOQ2hTkmG1hSuWYBunFGNv21Kt4N20A
# KmbeuSnGnsBCd2cjRKG79+TX+sTehawOoxfeOO/jR7wo3liwkGdzPJYHgnJ54Uxb
# ckF914AqHOiEV7xTnD1a69w/UTxwjEugpIPMIIE67SFZ2PMo27xjlLAHWW3l1CEA
# FjLNHd3EQ79PUr8FUXetXr0CAwEAAaOCAhswggIXMA4GA1UdDwEB/wQEAwIBhjAQ
# BgkrBgEEAYI3FQEEAwIBADAdBgNVHQ4EFgQUa2koOjUvSGNAz3vYr0npPtk92yEw
# VAYDVR0gBE0wSzBJBgRVHSAAMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWlj
# cm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAK
# BggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAPBgNVHRMBAf8E
# BTADAQH/MB8GA1UdIwQYMBaAFMh+0mqFKhvKGZgEByfPUBBPaKiiMIGEBgNVHR8E
# fTB7MHmgd6B1hnNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9N
# aWNyb3NvZnQlMjBJZGVudGl0eSUyMFZlcmlmaWNhdGlvbiUyMFJvb3QlMjBDZXJ0
# aWZpY2F0ZSUyMEF1dGhvcml0eSUyMDIwMjAuY3JsMIGUBggrBgEFBQcBAQSBhzCB
# hDCBgQYIKwYBBQUHMAKGdWh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv
# Y2VydHMvTWljcm9zb2Z0JTIwSWRlbnRpdHklMjBWZXJpZmljYXRpb24lMjBSb290
# JTIwQ2VydGlmaWNhdGUlMjBBdXRob3JpdHklMjAyMDIwLmNydDANBgkqhkiG9w0B
# AQwFAAOCAgEAX4h2x35ttVoVdedMeGj6TuHYRJklFaW4sTQ5r+k77iB79cSLNe+G
# zRjv4pVjJviceW6AF6ycWoEYR0LYhaa0ozJLU5Yi+LCmcrdovkl53DNt4EXs87KD
# ogYb9eGEndSpZ5ZM74LNvVzY0/nPISHz0Xva71QjD4h+8z2XMOZzY7YQ0Psw+ety
# NZ1CesufU211rLslLKsO8F2aBs2cIo1k+aHOhrw9xw6JCWONNboZ497mwYW5EfN0
# W3zL5s3ad4Xtm7yFM7Ujrhc0aqy3xL7D5FR2J7x9cLWMq7eb0oYioXhqV2tgFqbK
# HeDick+P8tHYIFovIP7YG4ZkJWag1H91KlELGWi3SLv10o4KGag42pswjybTi4to
# QcC/irAodDW8HNtX+cbz0sMptFJK+KObAnDFHEsukxD+7jFfEV9Hh/+CSxKRsmnu
# iovCWIOb+H7DRon9TlxydiFhvu88o0w35JkNbJxTk4MhF/KgaXn0GxdH8elEa2Im
# q45gaa8D+mTm8LWVydt4ytxYP/bqjN49D9NZ81coE6aQWm88TwIf4R4YZbOpMKN0
# CyejaPNN41LGXHeCUMYmBx3PkP8ADHD1J2Cr/6tjuOOCztfp+o9Nc+ZoIAkpUcA/
# X2gSMkgHAPUvIdtoSAHEUKiBhI6JQivRepyvWcl+JYbYbBh7pmgAXVswggeXMIIF
# f6ADAgECAhMzAAAAVdndaSYo+fjiAAAAAABVMA0GCSqGSIb3DQEBDAUAMGExCzAJ
# BgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNV
# BAMTKU1pY3Jvc29mdCBQdWJsaWMgUlNBIFRpbWVzdGFtcGluZyBDQSAyMDIwMB4X
# DTI1MTAyMzIwNDY0OVoXDTI2MTAyMjIwNDY0OVowgdsxCzAJBgNVBAYTAlVTMRMw
# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
# aWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVyaWNh
# IE9wZXJhdGlvbnMxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo3RDAwLTA1RTAt
# RDk0NzE1MDMGA1UEAxMsTWljcm9zb2Z0IFB1YmxpYyBSU0EgVGltZSBTdGFtcGlu
# ZyBBdXRob3JpdHkwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC9uR+S
# HllIs/QwJRZp9rD8pmhVm72JDHyvknCFm92tSLzpSMIIVA42NBqesjEYX2FEYhkt
# BnnSAessL7h+lQQl9/m3ThXAHJYLb9tY66To2ZpOH0mk9kNwbM1H3lCWvKN8SO2X
# 6DGPXbM08R0AM+mVV/O3xxhFYUHH8Vt9yHTyTo/2nuNfarWMU9tTFZgn7E7IYLVo
# qEMZjlv7zAvf2/qoLQcUjH+/fL5t6n5oReigrxWh5Yr6zN9oWNejxhNy9DxQvizO
# 70cVO5k2/q++gnsm76jlpOPnWymH7T4VdbfxOUv+sMF3mJrv2OyQu054dsOORuWO
# KXDN6BzG/2Lj0XTlmtL/kQtkIJjVVqo7sQ4spVrHF0A7mjLW9vQHHRlFVfWbEWNj
# NrLYQLTnWTrIYkebnzLWh7YgpFr9IzX4FMax7q8c2LlDZ3lmehH0A4BQMPAkgipE
# jitnPYxKKeHXVatdMb26sXa6jJ3lV77yHF6z0AF4/Y9hAqVdhMDG91p5qcNND+/C
# acz7JNxbOtWbzhnfxdUXDgbun9k1naexy+/q6u7YB69dzJXW3yFruJaaGGBNYE0G
# tWK4OVzeI+87PZJU9s96qHJj81fA1kICBzYfmk7O27ozBDEMiO17dcz8WQoHEeh9
# LZps1P/Qcb7Fm0WpQkNrGBslrqU3XOHuymO5DwIDAQABo4IByzCCAccwHQYDVR0O
# BBYEFFYEXxBt3AgD8Mi/qckWysHXrGW2MB8GA1UdIwQYMBaAFGtpKDo1L0hjQM97
# 2K9J6T7ZPdshMGwGA1UdHwRlMGMwYaBfoF2GW2h0dHA6Ly93d3cubWljcm9zb2Z0
# LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUyMFB1YmxpYyUyMFJTQSUyMFRpbWVz
# dGFtcGluZyUyMENBJTIwMjAyMC5jcmwweQYIKwYBBQUHAQEEbTBrMGkGCCsGAQUF
# BzAChl1odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY3Jv
# c29mdCUyMFB1YmxpYyUyMFJTQSUyMFRpbWVzdGFtcGluZyUyMENBJTIwMjAyMC5j
# cnQwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcDCDAOBgNVHQ8B
# Af8EBAMCB4AwZgYDVR0gBF8wXTBRBgwrBgEEAYI3TIN9AQEwQTA/BggrBgEFBQcC
# ARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRv
# cnkuaHRtMAgGBmeBDAEEAjANBgkqhkiG9w0BAQwFAAOCAgEAUh7hklR72pQpxZ5b
# KlyEHnx9cT9kha/YPlc/n+T+0HssI30G+Y1JUpndV5yVAz3vzB8S+690xBJS/pjb
# RuggzwMrUrUhT1w/bUwbQTGIfFqqOuKR/apt+tciKngR/e/Zs1gpDELE3dJzOnVJ
# fQfu6orYvk6F8MSJd/XmKi7mGH4Q9pqqnj1zM1CkkM5H+98mCFRz+pyyUM+GgJml
# nHxvY4O/LAZA1fCqVuyYJLbi4aYSRDdQfklR43pz3XJqxVyFLvyuIyubpH1mkCI7
# ml80owZTYwubUDemnT3wNxsVMBz3keHpC+SH//bwX9d7ZswVvoMvtLDRk73m/SC/
# RlPIl/FL8sLF+tp4Qgj0VIU4oAwSnXM0VKza57QYaMG33IQQxTC/Gr0TEXPRpnNi
# byK8l99+khUOdf/6tVFNhzEiRDIViyUiFiVYX1KMLDmvj2pqSMxE2Hxb07tpqiiV
# JVmV5BmMa3QrwnMyXKnqGnaVtbpepHHZw4dtvEkPGYQ3OiEZTOIjXeUjaDYF/mqJ
# t8Lhso1Gkmj2VsTwdRtjSomITy7dJTx4NBrJI9c4SEmPFEJDDA696NiYEbk/sJyR
# A0FKeeXXb4UpEqA+iPQy/7Pk4yGP3PYy2luccsCR6nSh1AKUTLIIb+5Hm0rmtbqZ
# kfk6rnpRZLQ0jo1XUkZLsmuLqMUxggdGMIIHQgIBATB4MGExCzAJBgNVBAYTAlVT
# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jv
# c29mdCBQdWJsaWMgUlNBIFRpbWVzdGFtcGluZyBDQSAyMDIwAhMzAAAAVdndaSYo
# +fjiAAAAAABVMA0GCWCGSAFlAwQCAQUAoIIEnzARBgsqhkiG9w0BCRACDzECBQAw
# GgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMBwGCSqGSIb3DQEJBTEPFw0yNjA5
# MjQyMTQ0MjlaMC8GCSqGSIb3DQEJBDEiBCDhCLaUkMDyVGjFqG/wfmeH5JJyjKTr
# ReNWagyDcfoJTDCBuQYLKoZIhvcNAQkQAi8xgakwgaYwgaMwgaAEINi5PJdkhmK7
# v33+/g9qqyZ5LMHGHSuqRiruxhhq+P7NMHwwZaRjMGExCzAJBgNVBAYTAlVTMR4w
# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29m
# dCBQdWJsaWMgUlNBIFRpbWVzdGFtcGluZyBDQSAyMDIwAhMzAAAAVdndaSYo+fji
# AAAAAABVMIIDYQYLKoZIhvcNAQkQAhIxggNQMIIDTKGCA0gwggNEMIICLAIBATCC
# AQmhgeGkgd4wgdsxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw
# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x
# JTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMxJzAlBgNVBAsT
# Hm5TaGllbGQgVFNTIEVTTjo3RDAwLTA1RTAtRDk0NzE1MDMGA1UEAxMsTWljcm9z
# b2Z0IFB1YmxpYyBSU0EgVGltZSBTdGFtcGluZyBBdXRob3JpdHmiIwoBATAHBgUr
# DgMCGgMVAB07VAGCZb+24FlXkQaOF+xXhw3qoGcwZaRjMGExCzAJBgNVBAYTAlVT
# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jv
# c29mdCBQdWJsaWMgUlNBIFRpbWVzdGFtcGluZyBDQSAyMDIwMA0GCSqGSIb3DQEB
# CwUAAgUA7l/UATAiGA8yMDI2MDkyNDE2NTMyMVoYDzIwMjYwOTI1MTY1MzIxWjB3
# MD0GCisGAQQBhFkKBAExLzAtMAoCBQDuX9QBAgEAMAoCAQACAgtqAgH/MAcCAQAC
# AhLAMAoCBQDuYSWBAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKg
# CjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBADCa0H3G
# d1bNZsmlCD7q8OP/ulYEMc/KHcjrVKu/tWKYiIn4tGvm6+WgeN/ExtLvL4tFQ3yJ
# tU6tqToHu5LAjKFBDwtDenz0ZSvaM8iIfUCMNn0e4rFw5EB2hIMfOsKMPrBfwxSd
# nDaS3XR4mHF8ibuRF31UD7AP/ErixXtZAxJdkmKcuxQ87NPOqwsly5okmxNxosUD
# PK2NX+81PwYiwzPiOtbiumC+t8GJjJ1s66nRnAwkmBneiScbxHc+UI++/D6sAoLj
# 2N5mbvAlACqIajYnL4KHPjEL0BOqOGS/2F6bfk+Dx8uZxL/9krQrT/SF1daEI1CJ
# 4xJqHMKE1e6cZagwDQYJKoZIhvcNAQEBBQAEggIATt9AdmDu9zxgV/7DYhPrWzSv
# K/TFm+dXCEU/TvfS8nf1VnFO5dW8hVWWDgMaIg5jj+FFGV2wp9HJb8m9N6UBQJUT
# PC5pBf2M5yt+eXaAhzKE07O/B5sEqdLFh+hSeEbJh1Rl/sji8HLQ55w7KEyVDdI+
# +qBw7sctCdAzxFsu7LTHTWOdn4txVRmZpcEC1a4ugmDAr5oBSCkgTtLwu6mb/7vt
# 7FwNqjepnK07kuiifpLLoCIRipbLJKxk4YVa6wQO7ExR1w8/kzg0CPdTxNt5Vb9p
# 2SM8BO9YLhN2vhInnxgJEQcBFu2PddmZwX0UqGaerzvGytT0oAMZIRDyXFn1H+q+
# blM5I1ohMs485IxO7gG2DpA6aD9A1RC96GmObJ6a97sGGa0w5U755f0tcyqmWRS8
# DAHx0KnJ2GG6ituBeyDWV2ZDK1OiMn45o+3B7YNQx59Ov79NHTXprN/H8+ntBNQV
# xplUKt7wbPuVP5m8I22F5i/gvlQ/v9iYVcambiepNG/iqhkwDUyzMjKUa+ukL9eJ
# Z+lKHtGh4sqMmZxddA4Cmj+tgoC9Wme4Fj4/K0Plnc+NH9Qz5IJwfxzMyxLi/6Ke
# l/1RGKY4WCN3Jl09hKh7P7H0UIafFV9J0gB3DOMDsQO9R0KEGR2p/PQDcQcOBAc3
# 8zSm32y0buorZpNsV8E=
# SIG # End signature block