WATP

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.

CampoObrigatórioUso
idsimidempotência e proteção contra replay
negotiation_idsim, exceto em HASH_INTERESTa negociação a que a mensagem pertence
typesimHASH_INTEREST, HASH_PROPOSAL, HASH_COUNTER, HASH_CONCLUDED, HASH_CANCELLED, HASH_WAITING_HUMAN
payloadsimitem, sku, quantidade, preço e campos da negociação
hashsimSHA-256 do texto canônico, em 64 caracteres hexadecimais
previousHashsim depois de HASH_INTERESTo hash da mensagem anterior da negociação
timestampsiminstante UTC com microssegundos
sendersimo 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