Núcleo 0.1.0 · contrato snapshot-2026-04-23 · atualizado em
Documentação do WATP
Esta página resume o que o protocolo WATP exige de quem troca mensagens por ele: o envelope, o cálculo do hash, a cadeia de cada negociação, o registro de nós, a assinatura, as pontes para outros protocolos e os limites desta versão. O texto completo do contrato está no repositório público.
O que vai no envelope?
Cada mensagem tem estes campos. Os nomes abaixo são os canônicos. O leitor também aceita prev_hash no lugar de previousHash. Dentro do payload, o canônico da quantidade é qty e o do preço é unit_price; o leitor aceita quantity e price como aliases. O esquema está em watp-message-envelope.schema.json.
| Campo | Obrigatório | Uso |
|---|---|---|
id | sim | idempotência e proteção contra replay |
negotiation_id | sim, exceto em HASH_INTEREST | a negociação a que a mensagem pertence |
type | sim | HASH_INTEREST, HASH_PROPOSAL, HASH_COUNTER, HASH_CONCLUDED, HASH_CANCELLED, HASH_WAITING_HUMAN |
payload | sim | item, sku, quantidade, preço e campos da negociação |
hash | sim | SHA-256 do texto canônico, em 64 caracteres hexadecimais |
previousHash | sim depois de HASH_INTEREST | o hash da mensagem anterior da negociação |
timestamp | sim | instante UTC com microssegundos |
sender | sim | o nó que emite |
Como o hash é calculado e a cadeia é conferida?
O hash é o SHA-256 do texto {"type":…,"payload":…,"previousHash":…,"timestamp":…}, nessa ordem, sem espaço. O payload entra com a ordem de chegada das chaves. Número inteiro sai sem casas decimais, como 100 e não 100.0. A fixture valid-hash-interest.json é a referência.
HASH_INTEREST abre a negociação. Os demais tipos continuam a partir do último hash: um previousHash que não é o último da negociação é recusado. Um hash já visto na negociação é repetição e não entra de novo. Um id já visto com o mesmo hash é reenvio e não é processado outra vez; o mesmo id com outro hash é conflito.
Quem pode entrar no registro de nós?
O registro guarda node_id, nome, URL e plataforma. A URL precisa ser pública e HTTPS, sem credencial, sem fragmento e sem query nos nós. Não são aceitos localhost, .local, .internal nem IPv4 privado (10, 127, 172.16 a 172.31, 192.168 e 169.254). A listagem mostra só os nós vistos nas últimas 26 horas, em ordem de node_id. Segundo o contrato congelado em 22 de abril de 2026, o registro é central e serve para a descoberta de nós.
Como o nó assina a mensagem?
O cabeçalho legado X-WATP-Node-Signature é sha256= seguido do HMAC-SHA256 do corpo bruto, com o segredo do par. A assinatura forte por nó é Ed25519 (RFC 8032) sobre três linhas: o texto WATP-ED25519-V1, o remetente e o hash. Como o remetente entra no texto assinado, a assinatura não serve para outro remetente. O contrato de abril de 2026 só tinha o HMAC; a assinatura Ed25519 é do núcleo em C desta versão, e o HMAC segue aceito para os nós que ainda não migraram.
Para quais protocolos o envelope tem ponte?
Cada ponte leva a negociação para um protocolo de comércio com agentes: A2A, AP2, UCP, ACP, x402, MPP, L402, AG-UI e OpenTelemetry. Cinco delas também leem de volta (A2A, AP2, UCP, AG-UI e OpenTelemetry). Na volta, o A2A remonta o envelope e passa pela mesma validação, e o mandato AP2, que é um JWS EdDSA assinado pela chave do nó, tem a assinatura e o checkout_hash conferidos. Os desafios de pagamento (x402, MPP e L402) só saem com um destino de recebimento configurado: a casa não tem carteira nem nó Lightning neste momento.
Conformidade e limites desta versão
O validador de conformidade lê as fixtures do repositório público e reproduz as mesmas linhas do validador de referência em JavaScript. Ele também confere os exemplos do esquema e os vetores de HMAC e de hash. O que esta versão ainda não faz está na lista abaixo, e o contrato público é direto sobre isso:
O WATP não é uma blockchain pública. O WATP é hoje uma rede federada de descoberta e negociação, onde cada negociação mantém sua própria cadeia de mensagens com hash.
WATP Contrato Real, congelado em 22 de abril de 2026
- Não há consenso entre nós e não há ledger público.
- A janela de tempo das mensagens novas não está no contrato e não é aplicada.
- O razão em jsonW é um arquivo por nó. A replicação entre nós ainda não existe.
- Os pagamentos reais (x402, MPP e L402) não estão ligados: falta o destino de recebimento.
- O runtime público do WATP ainda não foi publicado nesta versão.