Xuanxue - Vibe-coded SSH Key library for Swift Programming Language.
Xuanxue (玄学, pinyin: xuán xué) is a Chinese term that literally translates to "dark learning" or "mysterious learning." Historically, it refers to a Wei and Jin dynasty philosophical school that blended Taoist and Confucian ideals, often translated as "Neo-Taoism" or "metaphysics."
In modern Chinese internet slang—especially among programmers—玄学 has taken on a humorous, self-deprecating meaning. It describes phenomena in programming that seem to defy logic:
- Bugs that mysteriously appear or disappear without any code changes
- Code that works for reasons no one can fully explain
- The classic programmer wisdom: "If it works, don't touch it"
- Ritualistic behaviors like "rebooting to fix everything" or adding "Buddha bless this code" comments
This library is named Xuanxue because it was built entirely through vibe coding—a development approach where code emerges through conversation with AI, intuition, and iterative experimentation rather than traditional upfront design. Sometimes the code just... works, and we're not entirely sure why. That's the essence of 玄学.
In the spirit of 玄学编程 (metaphysical programming): if the tests pass and the signatures verify, we don't question it too deeply.
import Xuanxue
let publicKeyText = """
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDWur/C6nWpMXT4XfmgqvROM8dAd/iY71G2osffZ8u/XQDE7BEWybKDa3Q4cuhWmFmpuU8J2SqrdY0gAAi/ty3+MIqGC9L7u3PIG5ODuAnuzELX1Gv2DD4ob5e9DpzGtvwZ/uTIfHn6wLWzmHFuP9XBGHN3wIJLz8Seey39E/ESZPMWlXQoFbj17Puwo/m6Dw+DlhVcvmXTVWsA/cUuTYWiOUs5b8c+63Rp0Qab84UyyCJgpL0c4hm0QbLXTLqjDpKFIII0XJxSM/wdrmWMruwOJnW05nWR1tpHJLSwBbf/Vl3Ro2eq7C7kA7wr0D+mlmwKtGuJ57mcOxjK2uU28z4vGNb86WBx7MTWH+0yLHfED/2cesrc+5u4C0CgNSYzAyrEuq26jsYfUrf86eK4p3ysd2NvoSKkKl19v2a5AIRq+ccM40JpvhJQrF1SV7uUDMzoBeBnmmFx/HnsH+og8m5kBaDD5qQSklyaF61L5ACeWVFlFYiXxp6hlcrdLCriHyc= wodeshijie@among.us
"""
let publicKey = try Xuanxue.PublicKey(sshString: publicKeyText)
guard publicKey.algorithm == .rsa,
publicKey.keySize == 2048
else {
fatalError("ASSERTION FAILED: key.algorithm == .rsa && key.keySize == 2048")
}let privateKeyText = """
-----BEGIN OPENSSH PRIVATE KEY-----
44CK5oiR55qE5LiW55WM44CL77yI6Iux6K+t77yaTWluZWNyYWZ077yJ77yM
5Y+I6K+R5b2T5Liq5Yib5LiW56We44CB6bqm5Z2X77yM5piv5b6u6L2v5peX
5LiLTW9qYW5nIFN0dWRpb3PlvIDlj5HnmoTmspnnm5LmuLjmiI/jgILmuLjm
iI/kuK3vvIznjqnlrrbog73lnKjkuIDkuKozROS4lueVjOWGheS4juaWueWd
l+aIlueUn+eJqei/m+ihjOS6pOS6kuOAgua4uOaIj+S4reeahOeJueiJsueO
qeazleWMheaLrOaOoue0ouS4lueVjOOAgemHh+mbhui1hOa6kOOAgeWQiOaI
kOeJqeWTgeWPiueUn+WtmOWGkumZqeetieOAguOAiuaIkeeahOS4lueVjOOA
i+acieWkmuenjeaooeW8j+OAguWFtuS4re+8jOS4pOS4quacgOS4u+imgeea
hOa4uOaIj+aooeW8j++8mueUn+WtmOS4juWIm+mAoOOAguWcqOeUn+WtmOao
oeW8j+S4re+8jOeOqeWutuW/hemhu+e7tOaMgeeUn+WRve+8jOWKquWKm+mB
v+WFjeWPl+S8pOOAgemlpemlv+WSjOatu+S6oe+8jOW5tuW8gOmHh+i1hOa6
kOS7peaJk+mAoOiHquW3seeahOS4lueVjO+8m+WcqOWIm+mAoOaooeW8j+S4
re+8jOeOqeWutuaLpeacieaXoOmZkOeahOi1hOa6kO+8jOWPr+S7peiHqueU
seWcsOWIm+S9nO+8jOS4lOS4jeS8muWPl+S8pOWSjOatu+S6oe+8jOS5n+WP
r+S7peWFjeS6jumlpemlv++8jOW5tuaLpeaciemjnuihjOiDveWKm+OAgiAK
-----END OPENSSH PRIVATE KEY-----
"""
let privateKey = try Xuanxue.PrivateKey(sshString: privateKeyText)
guard privateKey.algorithm == .rsa,
privateKey.keySize == 2048
else {
fatalError("ASSERTION FAILED: key.algorithm == .rsa && key.keySize == 2048")
}let encryptedKeyText = """
-----BEGIN OPENSSH PRIVATE KEY-----
... encrypted key content ...
-----END OPENSSH PRIVATE KEY-----
"""
let passphrase = Data("testpassword".utf8)
let privateKey = try Xuanxue.PrivateKey(sshString: encryptedKeyText, passphrase: passphrase)import Xuanxue
// Generate Ed25519 key (fastest, recommended for new keys)
let ed25519Key = try Xuanxue.PrivateKey.generateEd25519(comment: "user@host")
// Generate ECDSA key (P-256, P-384, or P-521)
let ecdsaKey = try Xuanxue.PrivateKey.generateECDSA(curve: .p256, comment: "user@host")
// Generate RSA key (2048, 3072, or 4096 bits)
let rsaKey = try Xuanxue.PrivateKey.generateRSA(keySize: 2048, comment: "user@host")
// Access the corresponding public key
let publicKey = ed25519Key.publicKeylet data = """
《我的世界》（英语：Minecraft），又译当个创世神、麦块，是微软旗下Mojang Studios开发的沙盒游戏。游戏中，玩家能在一个3D世界内与方块或生物进行交互。游戏中的特色玩法包括探索世界、采集资源、合成物品及生存冒险等。《我的世界》有多种模式。其中，两个最主要的游戏模式：生存与创造。在生存模式中，玩家必须维持生命，努力避免受伤、饥饿和死亡，并开采资源以打造自己的世界；在创造模式中，玩家拥有无限的资源，可以自由地创作，且不会受伤和死亡，也可以免于饥饿，并拥有飞行能力。
""".data(using: .utf8)!
let signature = privateKey.sign(data)
guard publicKey.verify(signature, for: data) else {
fatalError("signature verification failed")
}-
load OpenSSH Private keys
- load encrypted OpenSSH Private keys
- support for different KDFs (bcrypt, etc)
- load encrypted OpenSSH Private keys
-
load PEM Private keys
-
load OpenSSH Public Keys
- RSA Key Support
-
ssh-rsa: RSA with SHA-1 -
rsa-sha2-256: RSA with SHA-256 -
rsa-sha2-512: RSA with SHA-512
-
- ECDSA Key Support
-
ecdsa-sha2-nistp256 -
ecdsa-sha2-nistp384 -
ecdsa-sha2-nistp521
-
- ed25519 Key Support
- RSA Key Generation
- ECDSA Key Generation
- ed25519 Key Generation
- Sign data with Private Key
- Verify signature with Public Key
- bcrypt KDF support for encrypted keys