Batasan Field dan Rentang Nilai ​

Field request (C→S) ​

• Tidak ada wait/lease tanpa batas. Klien resmi membulatkan pecahan detik ke atas, memvalidasi rentang, dan mengembalikan error input eksplisit sebelum mengirim tanpa clamp. Lease default adalah 30 detik.
• Dalam API client resmi, wait adalah batas keseluruhan acquire sejak pemanggilan dimulai, mencakup local queue, retry koneksi yang pasti belum terkirim, write, dan respons. Satu monotonic operation deadline dibuat sekali saja; tepat sebelum benar-benar mengirim, writer memasukkan pembulatan ke atas u8 dari detik tersisa ke wait pada frame. Karena itu, koneksi yang terlambat atau failover yang pasti belum terkirim tidak dapat memulai ulang server wait. Saat deadline, request yang masih di queue berakhir timeout dan pasti belum terkirim; jika satu byte saja mungkin telah terkirim, session yang tepat itu ditutup dan hasilnya Indeterminate. Hanya wait=0 asli yang memakai wire 0, dan percobaan langsung ini memiliki I/O deadline terbatas tersendiri agar transport yang macet tidak ditunggu selamanya. Jika A yang telah berkorelasi tepat sebelum deadline baru ditemukan di gate penyerahan Ticket, server waiter sudah selesai: session tetap terbuka, exact token yang diketahui dilepas sebagai kompensasi, dan hasilnya Indeterminate. T/B yang berkorelasi tetap merupakan kegagalan memperoleh lock yang definitif.
• Untuk wait=0 asli, perilaku wire dan server tetap satu percobaan langsung tanpa queue. Dalam transport deadline lima detik yang terpisah, kegagalan yang pasti belum terkirim boleh memilih koneksi lain dan retry dengan owner yang sama. Setelah satu byte saja mungkin telah terkirim, acquire tidak pernah dikirim ulang.
• API klien resmi mewajibkan min_work_budget yang tidak ada di wire. Nilai ini mencakup critical work + perkiraan pause + penyelesaian DB commit/rollback, berada di 0..250 detik, dan tidak melebihi lease ternormalisasi. Pelanggaran gagal sebelum kirim dengan error kelas UnsupportedDuration/InsufficientLease.
• Panjang key dihitung dalam byte, bukan karakter — aksara Korea memakai 3 byte per karakter di UTF-8, jadi maksimal 42 karakter.
• owner hanya ID korelasi respons, bukan otoritas. Memakai ulang nilainya tidak mengembalikan active token atau memperbarui lease. Request in-flight bersamaan dari satu klien harus memakai nilai nonzero berbeda; saat counter menjadi 0 atau wrap, klien resmi fail-closed.
• Release eksplisit dan kompensasi untuk token yang sudah diketahui memiliki 5 detik absolut sejak call/enqueue, termasuk reconnect dan retry. R memastikan sukses; N berarti sudah hilang atau bukan token saat ini. Tanpa respons tidak pernah dianggap sukses; antrean kompensasi terbatas yang penuh bergantung pada lease expiry.
• bad_key mencakup key kosong, lebih dari 128 byte, mengandung spasi atau newline, dan UTF-8 yang tidak valid, semuanya sama. Klien resmi juga tidak pernah mengirim \r — key yang diakhiri \r akan diam-diam menjadi key yang berbeda.

Field respons (S→C) ​

Server tidak pernah menerbitkan token 0. Single memakai counter selama process lifetime saat ini; cluster memakai counter yang direplikasi konsensus dan fail-closed sebelum overflow. Wall clock atau acak tidak menjamin monotonisitas setelah restart.

Panjang header tetap ​

Bagian biner berpanjang tetap yang mengikuti op. Byte-byte ini bisa mengandung 0x0A, jadi parser harus mengonsumsi panjang ini sebelum mencari newline.

Jika byte-nya kurang, hasilnya E bad_request.

Ukuran frame ​

Batas 192B di atas frame terbesar (146B), sehingga klien patuh tidak akan mencapainya. Setelah frame cacat struktur atau oversized, framing tidak lagi dipercaya dan koneksi ditutup.

Auth handshake ​

Prosedur lengkapnya ada di Auth handshake.

Batas sisi server ​

Nilai ini tidak disetel langsung oleh klien, tetapi memengaruhi perilakunya.

Read buffer (4096B), batch respons (64), progress timeout frame client yang dimulai (5 detik), dan single expiry sweep (5 detik) adalah konstanta compile-time. Cluster expiry memakai deadline min-heap yang memvalidasi token, bukan scan penuh. Lihat Konfigurasi.

Admission semua acquire, key baru, dan semua waiter ditutup pada 90% hard limit dan baru dibuka setelah turun di bawah 75%. Karena itu acquire baru dapat menerima B sebelum batas; capacity cadangan untuk release dan pemulihan Raft terpisah dari hysteresis ini.

Ringkasan pelanggaran → respons ​

Daftar lengkap alasan error dan penanganan koneksinya ada di Response · Error E.