# jsonW 1.4.0: cifra em repouso, máscaras de documentos e perfis dos protocolos de agentes O arquivo .jsw pode ficar cifrado no disco, com a chave fora dele. CPF e CNPJ entram com máscara que recusa o valor inválido. E 49 objetos dos protocolos de agentes têm perfil provado com ida e volta. 15 de novembro de 2026 · jsonW 1.4.0 · https://jsonw.org/newsroom/versao-1-4-0-cifra-mascaras-perfis ## O que a 1.4.0 traz Três coisas. A cifra em repouso, para o arquivo que fica no disco. As máscaras de documentos de vários países, que recusam o valor inválido na gravação. E os perfis jsonW dos protocolos de agentes, com cada objeto amostrado e conferido. Quem não usa nenhuma delas não percebe diferença: um arquivo sem cifra e sem tipo novo sai byte a byte igual ao da 1.3.14. ## Cifra em repouso O arquivo .jsw pode ficar cifrado no disco (XChaCha20-Poly1305). A chave do tenant fica fora do arquivo: um arquivo com 64 caracteres hexadecimais, apontado por WJSW_CHAVE_ARQ ou pela opção --chave. Sem a chave, o arquivo cifrado não abre. ``` $ wjsw cifrar cifrado.jsw --chave chave.hex $ wjsw conferir cifrado.jsw FALHOU: arquivo cifrado: falta a chave do tenant (WJSW_CHAVE_ARQ ou credencial wjsw-chave) $ wjsw para-texto cifrado.jsw --chave chave.hex {id:1,cpf:"12345678909",cnpj:"11222333000181"} {id:2,cpf:"12345678909",cnpj:"11222333000181"}``` Saída real do wjsw 1.4.1. O cifrar não imprime nada. Sem a chave, o conferir sai com código 1. ## Máscaras de documentos Na coluna mascara(tipo), o jsonW aceita o documento com ou sem pontuação, grava a forma canônica e recusa o que não é válido. O arquivo de entrada clientes.jsw.txt traz o CPF e o CNPJ com pontuação; a gravação guarda só os dígitos. ``` $ wjsw de-texto "id:i64,cpf:mascara(cpf),cnpj:mascara(cnpj)" clientes.jsw.txt docs.jsw 2 linhas -> docs.jsw $ wjsw para-texto docs.jsw {id:1,cpf:"12345678909",cnpj:"11222333000181"} {id:2,cpf:"12345678909",cnpj:"11222333000181"} $ wjsw de-texto "id:i64,cpf:mascara(cpf),cnpj:mascara(cnpj)" invalido.jsw.txt inv.jsw valor 1 nao coube no esquema``` O último comando sai com código 1: o CPF 111.111.111-11 não é válido. Entre os tipos estão CPF, CNPJ, CEP, telefone, PIS, RENAVAM, IBAN, NIF de Portugal, SIREN e SIRET da França, EIN e SSN dos Estados Unidos, CURP e RFC do México, RUT do Chile e partita IVA da Itália. A lista está em mascara/wmascara.h. ## Perfis dos protocolos de agentes A pasta perfis/ tem um arquivo por protocolo, com o esquema jsonW de cada objeto: A2A, UCP, ACP, AP2, Verifiable Intent, x402, MPP, AG-UI e OpenTelemetry, além de L402 e PIX. Cada objeto tem amostra gravada e custódia conferida, e volta igual ao que entrou. ``` $ bash perfis/provar-perfis.sh bin/macos-arm64/wjsw | tail -1 perfis: 49 ok, 0 falhas``` ## Compatibilidade Medido com o mesmo esquema nas duas versões. O arquivo sem cifra gravado pela 1.4.1 saiu igual, byte a byte, ao gravado pela 1.3.14. A 1.3.14 não abre o arquivo cifrado: recusa com versao do jsonW desconhecida, em vez de ler o texto cifrado como se fosse dado. ``` $ wjsw para-texto cifrado.jsw # com o binário 1.3.14 versao do jsonW desconhecida``` ## Onde está Na ferramenta wjsw, na biblioteca e nos SDKs. No npm, npm install @wortictecnologia/jsonw@1.4.0. A 1.4.1, que corrige a visão por permissão, vem logo depois: veja o post da 1.4.1. Fonte: https://github.com/developer-wortic/jsonw/releases/tag/v1.4.0