README
U
AeadMode
U
CipherAlgo
U
CompressedAlgo
U
DecryptResult
U
DecryptionBuilder
U
EncryptionBuilder
U
HashId
U
KeyGenBuilder
U
KeyRing
U
Pgp
U
PgpError
U
PrivateKey
U
PublicKey
U
RevocationReason
U
SecretSubkeyCert
U
SessionKey
U
SubkeyCert
U
UserIdBinding
U
VerifyStatus
V
DEFAULT_MAX_DECOMPRESSED_BYTES
V
build_pgp_mime_signed
V
decrypt_and_verify
V
decrypt_binary_with_password
V
decrypt_binary_with_private_key
V
decrypt_to_session_key
V
decrypt_with_password
V
decrypt_with_private_key
V
encrypt_to_recipients
V
encrypt_to_session_key
V
encrypt_with_password
V
encrypt_with_password_argon2
V
encrypt_with_password_v6
V
generate_ed25519_key
V
generate_ed25519_v6_key
V
generate_ed25519_v6_key_with_signing_subkey
V
generate_key
V
generate_revocation_certificate
V
generate_session_key
V
pgp
V
recover_session_key_with_key
V
recover_session_key_with_password
V
revoke_key
V
revoke_subkey
V
sign_and_encrypt
V
sign_cleartext
V
sign_cleartext_with
V
sign_detached
V
sign_inline
V
verify_cleartext
V
verify_detached
V
verify_inline
V
verify_key_signature
V
verify_pgp_mime_signed

#example/mailreader — 取回并解密验证 PGP 邮件(IMAP 收信)

与 example/mailer(发送)对称的收信端:登录 IMAP 邮箱 → 列出最近邮件 → 按 UID 取回全文 → 交 @mime.decrypt_mime 解密 + MIME 解析 + 验签 (gopenpgp 四态:Ok / NotSigned / NoVerifier / Failed)→ 输出正文并落盘附件。

实现范围见 docs/mail-fetch-plan.md(v1.1):IMAP4rev1 六命令子集 (LOGIN / ID / SELECT / FETCH / UID FETCH / LOGOUT),仅 INBOX,无 STARTTLS。协议客户端位于共享演示包 example/netmail,定位是演示与测试基建、不属于库 API (发布 API 中的邮件能力是 src/mime 解析验签 + src/mail 组装)。本 example 是薄壳 CLI。

#端到端闭环(推荐先跑)

./example/mailreader/e2e.sh               # 默认:IMAP 明文 143 + --allow-insecure
E2E_TUNNEL=1 ./example/mailreader/e2e.sh  # 隧道:本地 stunnel → IMAPS 993

脚本先用 example/mailer 给自己发一封新的签名+加密邮件(msmtp 经 TLS 提交), 再用 mailreader 列信、按 UID 取回、解密验签——发送端与接收端在一条命令里互证。前置:msmtp、~/.pgp-demo/ 下的密钥与凭据(见脚本头部的环境变量,均可覆盖)。

#双账号闭环(163 ↔ ProtonMail)

./example/mailreader/e2e_two_account.sh

用两把真实账号私钥跑三道门,全部经真实 SMTP/IMAP 与真实邮箱:

A→B 发送:A(163)私钥签名 → B(ProtonMail)公钥加密 → smtp.163.com:465 提交;断言产出的 PKESK 指向 B 的 cv25519 子钥(从 B 的密钥文件推导)。
A→A 闭环:A 签名+加密给自己 → 提交 → IMAPS 取回 → A 解密验签 (decrypt+verify OK)。
B→A 真实互通:取回 ProtonMail 自己产生、留在 INBOX 的回信,用 A 解密、用 B 公钥验签。

B 的私钥是 S2K 锁定的,本脚本只用其公钥部分(加密 + 验签),从不解锁; A 的私钥无口令。凭据同样只从 $CREDS_FILE 读,密钥路径全部可用环境变量覆盖。

#命令行

# 列出最近 5 封(UID 用于后续按信取回——序号跨会话会因删信平移)
IMAP_PASS=$(cat ~/.pgp-demo/smtp-pass) moon run example/mailreader -- \
  --imap-host 127.0.0.1 --imap-port 1143 \
  --user me@example.com --pass-env IMAP_PASS --last 5

# 按 UID 取回 + 解密 + 验签(附件落盘到 --out)
... --fetch 1730062003 \
    --keys my-private-key.asc --certs senders-public-key.asc \
    --out ~/fetched

#明文与 TLS(与发送侧同一条安全边界)

纯 MoonBit 不实现 TLS(见 README.mbt.md 安全声明),因此:

推荐真实路径:stunnel → IMAPS 993(TLS 由外部工具承担,与发送侧 msmtp 手-off 同构)。6 行配置:

client = yes
[imaps]
accept  = 127.0.0.1:1143
connect = imap.example.com:993
verifyChain = yes
CAfile  = /opt/homebrew/etc/openssl@3/cert.pem
checkHost = imap.example.com

明文直连 143 属显式 opt-in:非 localhost 的主机必须传 --allow-insecure,否则连接前直接拒绝(凭据不得默认明文过公网)。注意:邮件内容本身是端到端加密的,明文端口暴露的是凭据与元数据, 不是信件内容。
口令/授权码只从环境变量(--pass-env)读取,永不进 argv。