Files
QFT/ios/QFT/Core/PeerPairing.swift
T
zhy200308 eae24000e9 优化IOS
2026-08-19 09:31:21 +08:00

158 lines
6.5 KiB
Swift
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import Foundation
import CryptoKit
import Security
/// 队列里的一个文件。
struct PeerFileMeta: Equatable {
let name: String
let size: UInt64
let sha256: String
var json: [String: Any] {
["name": name, "size": NSNumber(value: size), "sha256": sha256]
}
static func parse(_ object: [String: Any]) -> PeerFileMeta? {
guard let rawName = (object["name"] as? String)?.trimmingCharacters(in: .whitespaces),
PairingProtocol.isValidFileName(rawName),
!rawName.hasPrefix("."),
let size = (object["size"] as? NSNumber)?.uint64Value,
let hash = (object["sha256"] as? String)?.lowercased(),
PairingProtocol.isValidSHA256(hash) else { return nil }
return PeerFileMeta(name: rawName, size: size, sha256: hash)
}
}
/// 隔空投送式点对点配对码(QFTP2P2)。
///
/// 与 QFTPAIR2/QFTSEND2 的关键区别:那两个是「连到某个 IP」,
/// 这个是「连到某个 Bonjour 服务实例,并用二维码里的预共享密钥做 TLS 认证」。
/// 二维码在这里充当带外信道——和隔空投送用 BLE 交换身份是同一个作用,
/// 只是我们把身份交换搬到了用户可见的扫码动作上,不需要任何配对弹窗。
///
/// 多文件时**文件清单不进二维码**,只放一个 SHA-256 摘要:
/// 十几个文件的元数据会让二维码密到扫不动。清单在 TLS 建立之后才传,
/// 接收端拿摘要比对——扫码这一下依然锁定了「你看到的就是你收到的」。
struct PeerPairing: Equatable {
static let prefix = "QFTP2P2:"
static let serviceType = "_qft-p2p._tcp"
let version: Int
/// 32 字节预共享密钥。既是 TLS-PSK,也是服务实例的唯一凭据。
let key: Data
/// Bonjour 服务实例名,由发送端随机生成
let instance: String
let senderName: String
/// 文件数与总字节数,用于扫码后立刻显示「3 个文件 · 1.2 GB」
let fileCount: Int
let totalSize: UInt64
/// 清单帧原始字节的 SHA-256(十六进制小写)
let queueDigest: String
/// 第一个文件名,纯展示用
let previewName: String
func encode() -> String {
let object: [String: Any] = [
"v": version,
"k": Base64URL.encode(key),
"i": instance,
"n": senderName,
"c": fileCount,
"z": NSNumber(value: totalSize),
"d": queueDigest,
"f": previewName,
]
let data = (try? JSONSerialization.data(withJSONObject: object)) ?? Data()
return Self.prefix + Base64URL.encode(data)
}
static func isPeerText(_ text: String) -> Bool { text.hasPrefix(prefix) }
static func parse(_ text: String) -> PeerPairing? {
guard text.hasPrefix(prefix), text.count <= 4096 else { return nil }
guard let data = Base64URL.decode(String(text.dropFirst(prefix.count))),
data.count <= 2048,
let object = (try? JSONSerialization.jsonObject(with: data)) as? [String: Any] else {
return nil
}
guard (object["v"] as? Int) == 2 else { return nil }
guard let keyText = object["k"] as? String,
let key = Base64URL.decode(keyText), key.count == 32 else { return nil }
guard let instance = object["i"] as? String, isValidInstance(instance) else { return nil }
guard let count = object["c"] as? Int, (1...512).contains(count) else { return nil }
guard let total = (object["z"] as? NSNumber)?.uint64Value else { return nil }
guard let digest = (object["d"] as? String)?.lowercased(),
PairingProtocol.isValidSHA256(digest) else { return nil }
let preview = (object["f"] as? String)?.trimmingCharacters(in: .whitespaces) ?? ""
guard preview.isEmpty || PairingProtocol.isValidFileName(preview) else { return nil }
return PeerPairing(
version: 2,
key: key,
instance: instance,
senderName: String(((object["n"] as? String) ?? "iPhone").prefix(80)),
fileCount: count,
totalSize: total,
queueDigest: digest,
previewName: String(preview.prefix(180))
)
}
/// Bonjour 实例名:只允许我们自己生成的字符集,避免把任意字符串
/// 交给 mDNS 解析。
static func isValidInstance(_ value: String) -> Bool {
guard (8...48).contains(value.count) else { return false }
for scalar in value.unicodeScalars {
switch scalar {
case "A"..."Z", "a"..."z", "0"..."9", "-": continue
default: return false
}
}
return true
}
static func newKey() -> Data {
var bytes = [UInt8](repeating: 0, count: 32)
_ = SecRandomCopyBytes(kSecRandomDefault, bytes.count, &bytes)
return Data(bytes)
}
static func newInstance() -> String {
let alphabet = Array("abcdefghijklmnopqrstuvwxyz0123456789")
var bytes = [UInt8](repeating: 0, count: 16)
_ = SecRandomCopyBytes(kSecRandomDefault, bytes.count, &bytes)
return "qft-" + String(bytes.map { alphabet[Int($0) % alphabet.count] })
}
}
/// 清单帧的编解码。
///
/// 摘要是对**帧的原始字节**取的,不是对重新序列化的结果——重新序列化
/// 会因为键顺序或数字格式的差异而算出不同的摘要,那种「几乎总是对」的
/// 校验在真机上迟早会咬人。
enum PeerQueue {
static func encode(sender: String, files: [PeerFileMeta]) throws -> Data {
let object: [String: Any] = ["v": 2, "sender": sender, "files": files.map(\.json)]
return try JSONSerialization.data(withJSONObject: object, options: [.sortedKeys])
}
static func decode(_ data: Data) -> (sender: String, files: [PeerFileMeta])? {
guard let object = (try? JSONSerialization.jsonObject(with: data)) as? [String: Any],
(object["v"] as? Int) == 2,
let rawFiles = object["files"] as? [[String: Any]], !rawFiles.isEmpty else { return nil }
var files: [PeerFileMeta] = []
for raw in rawFiles {
guard let file = PeerFileMeta.parse(raw) else { return nil }
files.append(file)
}
let sender = String(((object["sender"] as? String) ?? "iPhone").prefix(80))
return (sender, files)
}
static func digest(of data: Data) -> String {
SHA256.hash(data: data).map { String(format: "%02x", $0) }.joined()
}
}