AGENT SKILL
20-recovery-codec
暂无简介
- License 许可
- MIT
- 最近更新
- 2026-04-12
- Stars
- ★ 0
- Forks
- 0
02 资源文件 1
- 参考文档agents/openai.yaml118 B
03 SKILL.md 正文
20-recovery-codec
RecoveryCodec는 평문 JSON과 .dvn 파일 내용 간의 인코딩/디코딩 파이프라인을 구현하는 static utility 클래스다.
- 파이프라인 정의는 03-ssot §B를 따른다.
- HMAC 무결성 검증은 03-ssot §E를 따른다.
- SaveDataManager의 payload 포맷과 동일한 ComplexUtil 난독화를 사용한다.
Class Design
internal static class RecoveryCodec
- static utility (인스턴스 불필요).
- RecoveryManager에서만 호출한다.
- 외부 매니저가 직접 호출하지 않는다.
Public API
Encode
/// <summary>
/// 평문 JSON → .dvn 파일 내용 (v2: version header + obfuscated signed payload)
/// json 내부 account.socialUserId를 추출하여 HMAC 키에 사용한다.
/// </summary>
internal static string Encode(string json)
파이프라인 (v2):
1. json에서 account.socialUserId 추출
2. HMAC-SHA256(json, APP_SECRET + socialUserId) → hmac_hex_64
3. signedPayload = json + "\n" + hmac_hex_64
4. ComplexUtil.Encrypt_Base64(signedPayload) → obfuscated string
5. (char)0x02 + obfuscated string → final string
Decode
/// <summary>
/// .dvn 파일 내용 → 평문 JSON
/// v2: HMAC 무결성 검증 포함.
/// v1: 하위호환 (HMAC 없이 디코딩).
/// 실패 시 CommonResult 에러 반환.
/// </summary>
internal static CommonResult<string> Decode(string dvnContent)
파이프라인 (v2, version = 0x02):
1. version byte 파싱 (첫 바이트) → 0x02
2. ComplexUtil.Decrypt_Base64(payload) → signedPayload
3. signedPayload 분리: json + "\n" + hmac_hex_64
4. json에서 account.socialUserId 추출
5. HMAC 재계산 및 검증 → 불일치 시 RECOVERY_HMAC_FAILED
6. Return json
파이프라인 (v1 하위호환, version = 0x01):
1. version byte 파싱 → 0x01
2. ComplexUtil.Decrypt_Base64(payload) → json (HMAC 검증 없음)
3. Return json
Version Header
offset size description
──────────────────────────
0 1 DVN format version (0x01 or 0x02)
1 N ComplexUtil obfuscated Base64 payload
- version은 ASCII 문자가 아닌 raw byte다.
0x01: 레거시 (HMAC 없음). Decode만 허용.0x02: 현재 (HMAC 포함). Encode는 항상 0x02.- Encode 시
(char)0x02 + obfuscatedPayload로 조합한다. - Decode 시
dvnContent[0]으로 version을 읽고 분기한다.
Error Types
| 상황 | 에러 |
|---|---|
| version 미지원 | RECOVERY_UNSUPPORTED_VERSION |
| ComplexUtil 디코딩 실패 | RECOVERY_DECODE_FAILED |
| HMAC 불일치 (v2) | RECOVERY_HMAC_FAILED |
에러 타입의 정확한 이름/위치는 구현 시 COMMON_ERROR_TYPE 패턴을 따른다.
Implementation Location (3-path mirror)
3-path mirror 정책: devian-unity/04-package-policy, devian-unity/01-policy §SSOT 원칙
- RecoveryCodec:
- UPM (정본):
framework-cs/upm/com.devian.foundation/Samples~/MobilePackage/Runtime/Recovery/RecoveryCodec.cs - Packages (sync):
framework-cs/apps/UnityExample/Packages/com.devian.foundation/Samples~/MobilePackage/Runtime/Recovery/RecoveryCodec.cs - Assets/Samples (import):
framework-cs/apps/UnityExample/Assets/Samples/Devian Samples/{version}/MobilePackage/Runtime/Recovery/RecoveryCodec.cs
- UPM (정본):
asmdef:
Devian.Samples.MobilePackage.asmdef
Related
- 03-ssot — DVN 포맷 정본 (§E HMAC Integrity)
- 10-recovery-manager — RecoveryManager (호출자)
- 31-variable-complex — ComplexUtil 정본