Restrições de Campo e Faixas de Valores ​

Campos de Requisição (C→S) ​

• Não há wait nem lease infinitos. Os clientes oficiais arredondam frações de segundo para cima, validam o intervalo e retornam erro explícito antes de enviar, sem clamp. O lease padrão é 30 segundos.
• Na API oficial, wait é o limite total do acquire desde o início da chamada, passando por local queue, novas tentativas de conexão definitivamente não enviadas e write, até a resposta. Uma única monotonic operation deadline é criada; imediatamente antes do envio real, o writer grava no wait do frame o teto u8 dos segundos restantes. Assim, uma conexão tardia ou failover definitivamente não enviado não reinicia o server wait. Se a solicitação ainda estiver na queue na deadline, ela termina como timeout definitivamente não enviado; se até um byte puder ter sido enviado, fecha-se essa session exata e o resultado é Indeterminate. Somente um wait=0 original usa wire 0, e essa tentativa imediata tem uma I/O deadline finita separada para não aguardar indefinidamente um transport travado. Se um A já correlacionado pouco antes da deadline só for descoberto no gate de entrega do Ticket, o server waiter já foi resolvido: a session permanece aberta, o exact token conhecido recebe release compensatório e o resultado é Indeterminate. T/B correlacionados continuam sendo não aquisições definitivas.
• Para um wait=0 original, o comportamento wire e server continua sendo uma única tentativa imediata sem queue. Dentro de sua transport deadline separada de cinco segundos, uma falha definitivamente não enviada pode escolher outra conexão e tentar novamente com o mesmo owner. Depois que até um byte puder ter sido enviado, o acquire nunca é retransmitido.
• A API oficial exige min_work_budget, ausente do wire. Ele cobre trabalho crítico + pausa esperada + conclusão de commit/rollback DB, fica em 0..250 segundos e não excede o lease normalizado. Caso contrário, falha antes do envio com erro da classe UnsupportedDuration/InsufficientLease.
• O comprimento da chave é medido em bytes, não em caracteres — caracteres acentuados ocupam 2 bytes em UTF-8, então uma chave só de acentuados chega a 64 caracteres.
• owner é apenas ID de correlação da resposta, não autoridade. Reutilizá-lo não retorna active token nem renova lease. Requisições in-flight simultâneas do mesmo cliente usam valores não zero distintos; se o contador atingir 0 ou fizer wrap, clientes oficiais falham de modo fechado.
• Releases explícitos e compensatórios de token conhecido têm 5 segundos absolutos desde call/enqueue, incluindo reconexões e tentativas. R confirma sucesso; N significa já ausente ou token não atual. Sem resposta nunca presume sucesso; uma fila compensatória limitada cheia recorre à expiração do lease.
• bad_key cobre uma chave vazia, uma que excede 128 bytes, uma que contém espaço ou nova linha, e UTF-8 inválido, todos igualmente. Os clientes oficiais também nunca enviam \r — uma chave terminada em \r se tornaria silenciosamente uma chave diferente.

Campos de Resposta (S→C) ​

O servidor nunca emite token 0. Single usa contador durante a vida do processo; cluster usa contador replicado por consenso e falha fechado antes de overflow. Wall clock ou aleatoriedade não garantem monotonicidade após reinício.

Tamanhos de Cabeçalho Fixo ​

O trecho binário de tamanho fixo que vem logo após o op. Esses bytes podem conter 0x0A, então o parser precisa consumir exatamente essa quantidade antes de procurar a nova linha.

Bytes insuficientes resultam em E bad_request.

Tamanho do Quadro ​

O limite de 192B supera o maior quadro (146B), então um cliente conforme não o atinge. Após quadro estruturalmente inválido ou oversized, o framing deixa de ser confiável e a conexão é fechada.

Handshake de Autenticação ​

Veja Handshake de Autenticação para o procedimento completo.

Limites do servidor ​

O cliente não define diretamente estes valores, mas eles afetam seu comportamento.

Read buffer (4096B), batch de respostas (64), progress timeout de quadro client iniciado (5 s) e sweep de expiração single (5 s) são constantes de compilação. Cluster expiry usa deadline min-heap com validação de token, não scan completo. Veja Configuração.

A admissão de acquires, keys novas e waiters globais fecha em 90% do hard limit e só reabre abaixo de 75%. Assim, um acquire novo pode receber B antes do limite; a capacidade reservada para release e recuperação Raft é separada dessa histerese.

Resumo: Violação → Resposta ​

Para todos os motivos de erro e o tratamento da conexão, veja Resposta · Erro E.