# HTTPDNS iOS SDK (Edge Service v1.0.0)

## 1. Init

Import the umbrella header and initialize the `HttpdnsEdgeService`.

```objc
#import <NewHttpDNS/NewHttpDNS.h>

HttpdnsEdgeService *service = [[HttpdnsEdgeService alloc]
    initWithAppId:@"app1flndpo9"
          apiUrl:@"https://httpdns.deepwaf.xyz:8445"
      signSecret:@"your-sign-secret"];
```

## 2. Resolve

Support for `A` and `AAAA` query types.

```objc
[service resolveHost:@"demo.cloudxdr.com" queryType:@"A" completion:^(HttpdnsEdgeResolveResult * _Nullable result, NSError * _Nullable error) {
    if (error != nil) {
        NSLog(@"Resolve error: %@", error.localizedDescription);
        return;
    }
    NSLog(@"requestId=%@ ipv4=%@ ipv6=%@ ttl=%ld", result.requestId, result.ipv4s, result.ipv6s, (long)result.ttl);
}];
```

> [!NOTE]
> If you need to resolve both IPv4 and IPv6 simultaneously (Dual Stack), please perform two separate requests or implement concurrent logic, as the Edge backend strictly validates `qtype` as either `A` or `AAAA`.

## 3. Business Request (SNI Support)

Use the built-in request adapter to connect to resolved IPs via HTTPS while preserving the `Host` header for SNI validation.

```objc
NSURL *url = [NSURL URLWithString:@"https://demo.cloudxdr.com/v1/ping"];
[service requestURL:url method:@"GET" headers:@{@"Accept": @"application/json"} body:nil completion:^(NSData * _Nullable data, NSHTTPURLResponse * _Nullable response, NSError * _Nullable error) {
    if (error != nil) {
        return;
    }
    NSLog(@"status=%ld", (long)response.statusCode);
}];
```

## 4. Key Improvements
- **Security Policy**: Automatically handles certificate validation for IP-based HTTPS requests (no SNI mismatch).
- **Modern API**: Asynchronous block-based API for efficient network operations.
- **Clean Configuration**: Uses HMAC-SHA256 signing for secure resolution requests.

## 5. Deprecated Parameters

Do NOT use legacy parameters from `HttpDnsService`:
- `accountId`
- `secretKey`
- `aesSecretKey`
- `serviceDomain` (use `dn` parameter or `host` in API)