Run a virtual iPhone on an Apple Silicon Mac.
Swift
Install Irisin bootstrap through vphoned API
Lakra150aaa87ffc
diff --git a/Research/vphoned_http_api.md b/Research/vphoned_http_api.mdindex 6ba4bb5f..ce23bd28 100644--- a/Research/vphoned_http_api.md+++ b/Research/vphoned_http_api.md@@ -28,6 +28,26 @@ notch and cutout drawn by the host VM window.extracts the archive, then calls vphone's signer on the temporary app bundlebefore IcliKit copies it into a container, registers it, and owns rollback.`apps.uninstall` delegates removal to IcliKit and requires `force=true`.+`POST /v1/bootstrap/install` (or RPC method `bootstrap.install`) accepts+`{"layout":"rootless"}` or `{"layout":"roothide"}` and installs the latest+published `Lakr233/Irisin` release as the selected bootstrap's initial app.+Rootless uses `/var/jb`. RootHide reuses the sole valid `.jbroot-<16 hex>` under+`/var/containers/Bundle/Application`, or creates+`.jbroot-000114514191980C` when none exists. The selected stem is zero padded+and its final byte carries RootHide's XOR checksum. Missing bootstrap directories are created.+It selects the matching architecture, verifies the release+asset's GitHub SHA-256 digest and Debian control fields, then uses IcliKit to+extract the `.deb` into a temporary directory. It copies the full payload+into the bootstrap, creates Irisin's mobile-owned data directory, registers+the app with IcliKit, and loads the daemon through IcliKit. It also attempts+to start the daemon; a launchd start error is returned as+`service_start_warning` while the installed bootstrap remains available.+RootHide's plist gets a physical daemon path and `__Patched`+marker before launchd reads it. This is a manual payload install: no maintainer+script runs and the dpkg database is not changed. The reply includes the tag,+bootstrap path, registration record, and launchd status. A successful bootstrap+writes `.vphoned-boostrap-completed` beside the running vphoned binary; later+requests refuse to bootstrap again when that marker exists.## HTTP and WebSocket contractdiff --git a/VPhoneDaemon/Daemon/GuestAPI.swift b/VPhoneDaemon/Daemon/GuestAPI.swiftindex a7b1ca51..6d52621f 100644--- a/VPhoneDaemon/Daemon/GuestAPI.swift+++ b/VPhoneDaemon/Daemon/GuestAPI.swift@@ -62,6 +62,7 @@ enum GuestAPI {"location","keychain","ipa_install",+ "bootstrap_install","port_forward","camera","screenshot",@@ -196,6 +197,12 @@ enum GuestAPI {let id = result["bundle_id"] as? String ?? "app"result["msg"] = "Installed \(id) as a \(registration.rawValue) app."return result+ case "bootstrap.install":+ let layout = try string(params, "layout")+ return try GuestIrisinInstaller.install(+ jailbreak: jailbreakInfo(),+ layout: layout,+ )case "input.touch":guard let phase = (params["phase"] as? String).flatMap(TouchPhase.init(rawValue:)) else {throw GuestAPIError.invalidRequest("phase must be down, move or up")diff --git a/VPhoneDaemon/Daemon/GuestHyperTextHandler.swift b/VPhoneDaemon/Daemon/GuestHyperTextHandler.swiftindex 1cad8206..8f69faaf 100644--- a/VPhoneDaemon/Daemon/GuestHyperTextHandler.swift+++ b/VPhoneDaemon/Daemon/GuestHyperTextHandler.swift@@ -174,6 +174,7 @@ final class GuestHyperTextHandler: ChannelInboundHandler, RemovableChannelHandlecase (.GET, "/v1/apps/foreground"): "apps.foreground"case (.POST, "/v1/apps/open-url"): "apps.open_url"case (.POST, "/v1/apps/install"): "apps.install"+ case (.POST, "/v1/bootstrap/install"): "bootstrap.install"case (.POST, "/v1/input/touch"): "input.touch"case (.POST, "/v1/input/hid"): "input.hid"case (.GET, "/v1/location"): "location.current"diff --git a/VPhoneDaemon/Daemon/GuestIrisinInstaller.swift b/VPhoneDaemon/Daemon/GuestIrisinInstaller.swiftnew file mode 100644index 00000000..3083802f--- /dev/null+++ b/VPhoneDaemon/Daemon/GuestIrisinInstaller.swift@@ -0,0 +1,365 @@+import CryptoKit+import Darwin+import Foundation+import IcliKit+import IcliSystem++/// Installs the published Irisin payload without dpkg or maintainer scripts.+enum GuestIrisinInstaller {+ private static let releaseURL = URL(string: "https://api.github.com/repos/Lakr233/Irisin/releases/latest")!+ private static let serviceLabel = "wiki.qaq.irisind"+ private static let installLock = NSLock()+ private static let completionMarker = Bundle.main.executableURL!+ .deletingLastPathComponent()+ .appendingPathComponent(".vphoned-boostrap-completed")++ static func install(jailbreak: [String: Any], layout: String) throws -> [String: Any] {+ installLock.lock()+ defer { installLock.unlock() }+ guard !itemExists(completionMarker) else {+ throw GuestAPIError.operationFailed("Irisin bootstrap already completed: \(completionMarker.path)")+ }++ let detectedLayout = jailbreak["layout"] as? String+ guard layout == "rootless" || layout == "roothide" else {+ throw GuestAPIError.invalidRequest("layout must be rootless or roothide")+ }+ if let detectedLayout, layout != detectedLayout {+ throw GuestAPIError.invalidRequest("Requested layout does not match the guest bootstrap")+ }+ let root = try bootstrapRoot(layout: layout, detected: jailbreak["jbroot"] as? String)+ try FileManager.default.createDirectory(atPath: root, withIntermediateDirectories: true,+ attributes: [.posixPermissions: 0o755])+ try FileManager.default.createDirectory(atPath: root + "/usr/lib", withIntermediateDirectories: true,+ attributes: [.posixPermissions: 0o755])+ guard isDirectory(root) else {+ throw GuestAPIError.operationFailed("Jailbreak root is not a directory: \(root)")+ }++ let architecture = layout == "roothide" ? "iphoneos-arm64e" : "iphoneos-arm64"+ let release = try releaseAsset(architecture: architecture)+ let work = FileManager.default.temporaryDirectory+ .appendingPathComponent("vphoned-irisin-\(UUID().uuidString)", isDirectory: true)+ try FileManager.default.createDirectory(at: work, withIntermediateDirectories: true)+ defer { try? FileManager.default.removeItem(at: work) }++ let package = work.appendingPathComponent(release.name)+ let packageData = try fetch(release.url)+ let digest = SHA256.hash(data: packageData).map { String(format: "%02x", $0) }.joined()+ guard digest == release.digest else {+ throw GuestAPIError.operationFailed("Irisin release asset SHA-256 mismatch")+ }+ try packageData.write(to: package, options: .atomic)++ let metadata = try readDeb(package.path)+ let control = metadata["control"] as? [String: String] ?? [:]+ guard control["Package"] == "wiki.qaq.irisin",+ control["Version"] == release.version,+ control["Architecture"] == architecture+ else { throw GuestAPIError.operationFailed("Irisin package metadata does not match the release") }++ let extracted = work.appendingPathComponent("extracted", isDirectory: true)+ _ = try extractDeb(package.path, to: extracted.path)+ let payload = layout == "rootless"+ ? extracted.appendingPathComponent("var/jb", isDirectory: true)+ : extracted+ let app = payload.appendingPathComponent("Applications/irisin.app", isDirectory: true)+ let daemon = payload.appendingPathComponent("usr/libexec/irisind")+ let helper = payload.appendingPathComponent("usr/libexec/irisin-install")+ let plist = payload.appendingPathComponent("Library/LaunchDaemons/\(serviceLabel).plist")+ try validatePayload(app: app, daemon: daemon, helper: helper, plist: plist,+ version: release.version, architecture: architecture, layout: layout)++ if layout == "roothide" {+ try prepareRootHidePlist(plist, executable: root + "/usr/libexec/irisind")+ }+ try prepareAppData()++ let rootURL = URL(fileURLWithPath: root, isDirectory: true)+ let installedApp = rootURL.appendingPathComponent("Applications/irisin.app", isDirectory: true)+ let installedPlist = rootURL.appendingPathComponent("Library/LaunchDaemons/\(serviceLabel).plist")+ let hadApp = itemExists(installedApp)+ let components = try payloadComponents(from: payload, to: rootURL, app: app)+ let hadService = itemExists(installedPlist)+ if hadService {+ _ = try loadServices([installedPlist.path], load: false, override: false)+ }++ var replaced: [(target: URL, backup: URL?)] = []+ do {+ for (source, target) in components {+ replaced.append(try replace(source, at: target))+ }+ let registration = try registerApp(installedApp.path)+ let loaded = try loadServices([installedPlist.path], load: true, override: false)+ var started: [String: Any]?+ var startWarning: String?+ do {+ started = try startService(serviceLabel)+ } catch {+ // Some VM launchd builds can load the job but cannot start it+ // until the service-configure hook is available. The app and+ // bootstrap payload are still usable in that state.+ startWarning = String(describing: error)+ }+ let status = try serviceStatus(serviceLabel)+ guard status["loaded"] as? Bool == true else {+ throw GuestAPIError.operationFailed("Irisin daemon is not loaded")+ }+ let marker = ["tag": release.tag, "layout": layout, "jbroot": root]+ try JSONSerialization.data(withJSONObject: marker).write(to: completionMarker, options: .atomic)+ for entry in replaced {+ if let backup = entry.backup { try? FileManager.default.removeItem(at: backup) }+ }+ var result: [String: Any] = [+ "tag": release.tag,+ "version": release.version,+ "architecture": architecture,+ "layout": layout,+ "jbroot": root,+ "app_path": installedApp.path,+ "registration": registration,+ "service_load": loaded,+ "service_status": status,+ "maintainer_scripts_executed": false,+ "dpkg_database_updated": false,+ ]+ if let started { result["service_start"] = started }+ if let startWarning { result["service_start_warning"] = startWarning }+ return result+ } catch {+ if itemExists(installedPlist) {+ _ = try? loadServices([installedPlist.path], load: false, override: false)+ }+ if !hadApp, itemExists(installedApp) {+ _ = try? unregisterApp(installedApp.path, force: true)+ }+ for entry in replaced.reversed() {+ try? FileManager.default.removeItem(at: entry.target)+ if let backup = entry.backup {+ try? FileManager.default.moveItem(at: backup, to: entry.target)+ }+ }+ if itemExists(installedApp) { _ = try? registerApp(installedApp.path) }+ if hadService { _ = try? loadServices([installedPlist.path], load: true, override: false) }+ throw error+ }+ }++ // MARK: - Release and payload++ private static func bootstrapRoot(layout: String, detected: String?) throws -> String {+ if layout == "rootless" { return "/var/jb" }+ if let detected { return detected }++ let parent = "/private/var/containers/Bundle/Application"+ let names = try FileManager.default.contentsOfDirectory(atPath: parent)+ .filter { roothideName($0) && isDirectory(parent + "/" + $0) }+ guard names.count <= 1 else {+ throw GuestAPIError.operationFailed("Multiple RootHide bootstrap roots exist")+ }+ if let name = names.first { return parent + "/" + name }++ // User-selected stem, zero-padded to 16 hex digits with RootHide's+ // XOR checksum in the final byte (0C instead of the proposed 10).+ let name = ".jbroot-000114514191980C"+ guard roothideName(name) else {+ throw GuestAPIError.operationFailed("Configured RootHide bootstrap name is invalid")+ }+ return parent + "/" + name+ }++ private static func roothideName(_ name: String) -> Bool {+ guard name.range(of: "^\\.jbroot-[0-9a-fA-F]{16}$", options: .regularExpression) != nil,+ let value = UInt64(name.dropFirst(8), radix: 16)+ else { return false }+ let check = (1 ... 7).reduce(UInt8(0)) {+ $0 ^ UInt8(truncatingIfNeeded: value >> ($1 * 8))+ }+ return check == UInt8(truncatingIfNeeded: value)+ }++ private struct Asset {+ let tag: String+ let version: String+ let name: String+ let url: URL+ let digest: String+ }++ private static func releaseAsset(architecture: String) throws -> Asset {+ let data = try fetch(releaseURL)+ guard let json = try JSONSerialization.jsonObject(with: data) as? [String: Any],+ let tag = json["tag_name"] as? String,+ tag.range(of: "^v[0-9]+(\\.[0-9]+){2,3}$", options: .regularExpression) != nil,+ let assets = json["assets"] as? [[String: Any]]+ else { throw GuestAPIError.operationFailed("GitHub did not return a valid Irisin release") }+ let version = String(tag.dropFirst())+ let name = "wiki.qaq.irisin_\(version)_\(architecture).deb"+ guard let asset = assets.first(where: { $0["name"] as? String == name }),+ let address = asset["browser_download_url"] as? String,+ let url = URL(string: address), url.scheme == "https", url.host == "github.com",+ url.path == "/Lakr233/Irisin/releases/download/\(tag)/\(name)",+ let rawDigest = asset["digest"] as? String,+ rawDigest.range(of: "^sha256:[0-9a-f]{64}$", options: .regularExpression) != nil+ else { throw GuestAPIError.operationFailed("The latest Irisin release has no verified \(architecture) package") }+ return Asset(tag: tag, version: version, name: name, url: url,+ digest: String(rawDigest.dropFirst("sha256:".count)))+ }++ private static func validatePayload(+ app: URL, daemon: URL, helper: URL, plist: URL,+ version: String, architecture: String, layout: String+ ) throws {+ let info = NSDictionary(contentsOf: app.appendingPathComponent("Info.plist"))+ guard info?["CFBundleIdentifier"] as? String == "wiki.qaq.irisin",+ info?["CFBundleShortVersionString"] as? String == version,+ info?["IrisinCurrentArchitecture"] as? String == architecture,+ FileManager.default.isExecutableFile(atPath: app.appendingPathComponent("irisin").path),+ FileManager.default.isExecutableFile(atPath: daemon.path),+ FileManager.default.isExecutableFile(atPath: helper.path),+ let properties = NSDictionary(contentsOf: plist) as? [String: Any],+ properties["Label"] as? String == serviceLabel,+ let arguments = properties["ProgramArguments"] as? [String],+ arguments == [layout == "roothide" ? "/usr/libexec/irisind" : "/var/jb/usr/libexec/irisind"]+ else { throw GuestAPIError.operationFailed("Irisin release payload is incomplete or has the wrong layout") }+ }++ private static func prepareRootHidePlist(_ url: URL, executable: String) throws {+ let data = try Data(contentsOf: url)+ guard var plist = try PropertyListSerialization.propertyList(from: data, format: nil) as? [String: Any] else {+ throw GuestAPIError.operationFailed("Irisin launchd plist is invalid")+ }+ plist["ProgramArguments"] = [executable]+ plist["__Patched"] = true+ let updated = try PropertyListSerialization.data(fromPropertyList: plist, format: .xml, options: 0)+ try updated.write(to: url, options: .atomic)+ }++ private static func prepareAppData() throws {+ let path = "/var/mobile/Documents/wiki.qaq.irisin"+ try FileManager.default.createDirectory(atPath: path, withIntermediateDirectories: true,+ attributes: [.posixPermissions: 0o755])+ guard chown(path, 501, 501) == 0 else {+ throw GuestAPIError.operationFailed("Could not assign Irisin app data to mobile")+ }+ }++ // MARK: - Installation++ private static func payloadComponents(from payload: URL, to root: URL, app: URL) throws -> [(URL, URL)] {+ let files = FileManager.default+ var components: [(URL, URL)] = []++ func collect(_ source: URL, _ destination: URL) throws {+ var info = stat()+ guard lstat(source.path, &info) == 0 else {+ throw GuestAPIError.operationFailed("Could not inspect Irisin payload: \(source.path)")+ }+ if info.st_mode & mode_t(S_IFMT) == mode_t(S_IFDIR), source != app {+ let children = try files.contentsOfDirectory(at: source, includingPropertiesForKeys: nil)+ .sorted { $0.lastPathComponent < $1.lastPathComponent }+ if children.isEmpty {+ try files.createDirectory(at: destination, withIntermediateDirectories: true)+ }+ for child in children {+ try collect(child, destination.appendingPathComponent(child.lastPathComponent))+ }+ } else {+ components.append((source, destination))+ }+ }++ for source in try files.contentsOfDirectory(at: payload, includingPropertiesForKeys: nil)+ .sorted(by: { $0.lastPathComponent < $1.lastPathComponent })+ where source.lastPathComponent != "DEBIAN"+ {+ try collect(source, root.appendingPathComponent(source.lastPathComponent))+ }+ return components+ }++ private static func isDirectory(_ path: String) -> Bool {+ var directory: ObjCBool = false+ return FileManager.default.fileExists(atPath: path, isDirectory: &directory) && directory.boolValue+ }++ private static func itemExists(_ url: URL) -> Bool {+ var info = stat()+ return lstat(url.path, &info) == 0+ }++ private static func replace(_ source: URL, at target: URL) throws -> (target: URL, backup: URL?) {+ let files = FileManager.default+ let parent = target.deletingLastPathComponent()+ try files.createDirectory(at: parent, withIntermediateDirectories: true,+ attributes: [.posixPermissions: 0o755])+ let suffix = UUID().uuidString+ let candidate = parent.appendingPathComponent(".\(target.lastPathComponent).vphoned-\(suffix)")+ let backup = parent.appendingPathComponent(".\(target.lastPathComponent).backup-\(suffix)")+ try files.copyItem(at: source, to: candidate)+ var old: URL?+ do {+ if itemExists(target) {+ var info = stat()+ guard lstat(target.path, &info) == 0, info.st_mode & mode_t(S_IFMT) != mode_t(S_IFLNK) else {+ throw GuestAPIError.operationFailed("Irisin destination is a symlink: \(target.path)")+ }+ try files.moveItem(at: target, to: backup)+ old = backup+ }+ try files.moveItem(at: candidate, to: target)+ return (target, old)+ } catch {+ try? files.removeItem(at: candidate)+ if let old { try? files.moveItem(at: old, to: target) }+ throw error+ }+ }++ // MARK: - HTTPS++ private final class HTTPResult: @unchecked Sendable {+ let semaphore = DispatchSemaphore(value: 0)+ var value: Result<(Data, URLResponse), Error>?++ func finish(data: Data?, response: URLResponse?, error: Error?) {+ if let error {+ value = .failure(error)+ } else if let data, let response {+ value = .success((data, response))+ } else {+ value = .failure(GuestAPIError.operationFailed("Empty Irisin download response"))+ }+ semaphore.signal()+ }+ }++ private static func fetch(_ url: URL) throws -> Data {+ let configuration = URLSessionConfiguration.ephemeral+ configuration.timeoutIntervalForRequest = 30+ configuration.timeoutIntervalForResource = 180+ let session = URLSession(configuration: configuration)+ defer { session.invalidateAndCancel() }+ var request = URLRequest(url: url)+ request.setValue("application/vnd.github+json", forHTTPHeaderField: "Accept")+ request.setValue("vphoned-Irisin-installer", forHTTPHeaderField: "User-Agent")+ let result = HTTPResult()+ let task = session.dataTask(with: request) { data, response, error in+ result.finish(data: data, response: response, error: error)+ }+ task.resume()+ guard result.semaphore.wait(timeout: .now() + 190) == .success else {+ task.cancel()+ throw GuestAPIError.operationFailed("Irisin download timed out")+ }+ let (data, response) = try result.value!.get()+ guard let http = response as? HTTPURLResponse, http.statusCode == 200 else {+ throw GuestAPIError.operationFailed("Irisin download returned HTTP \((response as? HTTPURLResponse)?.statusCode ?? 0)")+ }+ guard data.count <= 64 * 1024 * 1024 else {+ throw GuestAPIError.operationFailed("Irisin download exceeds 64 MiB")+ }+ return data+ }+}