Troubleshooting

Common client errors — wire, hash, session, API v1.4, and Protocol v2.

Wire / E18 — Init Failed

WARN

Got E18 or init with no JSON? Client is missing wire token (la_w) — use an official LibreAuth SDK.

E18 — legacy query-string client without wire · fix: switch to LibreAuth SDK
Point URL to https://libreauth.nutexe.dev/api/1.4/ (Enterprise) or https://libreauth.nutexe.dev/api/1.3/ (v1.3)
Do not hand-roll wire tokens — SDK generates fresh credentials per request
Non-init requests without wire → silent HTTP 404 (not JSON)

Hash Check Failed

WARN

Got {"success":false,"message":"E05"}? Client integrity check failed — exe MD5 does not match server whitelist. Response includes received_hash (compact rh on v1.4) with the MD5 the client sent.

Build release exe → compute MD5 (same file users run)
Client must send MD5 on every init (param hash or h)
On E05, read received_hash (rh on v1.4) and whitelist_count (wc) from the API response — or Panel → Settings → Config → Hash Management → Recent rejected MD5
Popup showing exe MD5 does not always mean E05 — client may fail to send hash (E04) or fail earlier (E18 wire, version)
Rebuild client after changing exe — old MD5 will fail
Contact your provider if the hash needs to be whitelisted

Full docs: Initialization → Common Errors · Access Controls · Anti-Tamper

// Windows — get MD5 of exe (PowerShell)
Get-FileHash -Algorithm MD5 ".\YourApp.exe"

INFO

รหัส E01–E18 และ dynamic codes (E1A7FF8, E1AA3B2, …): Error Codes (full reference)

E48E0A5 — Invalid license key (ไม่ใช่ Hash)

WARN

ได้ E48E0A5 หรือ UI เขียนว่า "ปฏิเสธตอน init" แต่ Discord โชว์ Hash ตรง? — นั่นคือ init ผ่านแล้ว คีย์ license ผิด

E48E0A5 = veil ของข้อความ Invalid license key (ไม่ใช่ E05)
Discord alert Hash ตรง / hashmatch = MD5 ถูกต้อง อยู่ใน whitelist แล้ว — ไม่ต้อง Add Hash ซ้ำ
ตรวจคีย์: ผิดตัวอักษร · หมดอายุ · ใช้ครบ max · คนละแอป · ยังไม่สร้างใน Panel → Licenses
แก้: สร้างคีย์ใหม่ใน Panel → Licenses แล้วใส่ใน client · หรือใช้ login username/password แทน license ตามที่แอปออกแบบ
ถ้าได้ E05 จริงค่อย Add MD5 จาก Discord / received_hash

ดูตาราง: Error Codes → Quick Lookup

File Download Failed

WARN

Download ล้มเหลว? ตรวจว่าไฟล์ตั้ง Public หรือ Authenticated — Authenticated ต้อง license/login ก่อน

Code	Fix
`E1A7FF8`	`init` → `license` → `file` · หรือเปลี่ยนไฟล์เป็น Public
`E1AA3B2`	Sequence ผิดบน v1.4 — ใช้ SDK ล่าสุด · ดู Sequence
`E77AC17`	ตรวจ `fileid` จาก Panel → Files → Copy ID

Full flows: Error Codes → File Download · API v1.4 Sequence

API / Client Errors

Code	Fix
Missing signature headers	Update SDK · verify Ed25519 public key from `init`
Signature verification failed	Update Ed25519 public key from `init` · rebuild client
E01 / E02	Wrong `name` or `ownerid`
invalidver	Client `ver` does not match expected app version
E18	Missing wire token — use official SDK
E04 / E05	Hash troubleshooting · init docs
E11	Update client SDK to send nonce on every request
E10	Session bound to IP — reconnect from same network
`Invalid session`	Call init again · Protocol v2 idle wipe (90s) — API v2
HWID mismatch	Request HWID reset from your provider or wait cooldown
Blacklisted	Machine ban (HWID and/or IP by scope) — ban scopes · HWID Bans

Machine Ban / Unban

Panel Ban machine scope controls HWID, IPs, and keys — user accounts stay active unless you ban them in Users. HWID only is recommended for VMs on the same router as your main PC.

To unban: HWID Bans → Unban (runs UnbanMachine() — HWID, related IPs, keys). Or click the Banned badge on a user row if their HWID was blacklisted.

Docs: HWID Bans · Users & Machines

API v1.4 Errors

Symptom	Cause	Fix
HTTP 404 on `/api/1.4/`	Not on Enterprise plan, wire failure, or outdated `client_build`	Upgrade to Enterprise · use official SDK · send `client_build` if min set
`Invalid sequence` / `E1AA3B2`	Wrong `seq` value	Use latest SDK · increment only after successful responses
Wire gate 404	Wire credentials invalid or expired	Use official SDK — do not hand-roll wire tokens
Compact parse errors	Client expects 1.3 full keys	Map `s/m/i/p/…` — see Compact keys
Changelog / sec_policy missing	Parsing 1.3 response shape	Read `cl`, `sp`, `ft`, `cp` from init

INFO

Full 1.4 guide: API v1.4 documentation

API v2 — Invalid session

WARN

License UI โชว์ Invalid session? ส่วนใหญ่คือ idle_ttl 90s — ไม่ใช่คีย์ผิด

เปิดแอป → Init สำเร็จ → ค้างหน้าใส่ License > ~90 วินาที → กด Login → เซิร์ฟตอบ Invalid session
SDK ล่าสุด: Login / License จะ Init ใหม่แล้ว retry อัตโนมัติหนึ่งครั้ง
ถ้ายังพัง: ตรวจ URL เป็น /api/v2/ · Enterprise plan · Hash Check ผ่านตอน Init · app_id/ownerid ตรงกับตอน Init
แยกจาก Invalid license key (คีย์ผิด) · Invalid mac / Invalid sequence (wire/crypto)

Docs: API Protocol v2 → Idle TTL · Error Codes → Protocol v2

API v2 — Init Ghost 404

WARN

Log: HTTP 404 Ghost — app name/ownerid not found หรือ HTTP 404 unsigned (Ghost/WAF) ตอน Init?

ตรวจ name = secret name จาก Manage Apps (ตรงตัวอักษร) + ownerid 10 ตัว
แอปต้อง enabled และแผนรองรับ API v2 (Enterprise)
ถ้า Init คนละแอปกับ Panel SELECT APP → Operations จะขึ้น “No devices”
หลัง auth แล้วเจอ 404 unsigned = มักเป็น WAF/path — ไม่ใช่ชื่อแอป

Docs: API Protocol v2 → Ghost · Error Codes