Align to service contract: use blockchain.explorer_url; update test mock to match provided JSON; keep authenticity_verification_url from explorer_url

Author: maxsonferovante

certified_builder/solana_explorer_url.py

@@ -1,5 +1,5 @@
 def extract_solana_explorer_url(solana_response: dict) -> str:
-    # alteração: função isolada para extrair a URL do explorer da resposta do serviço
+    # alteração: extrai a URL do explorer do bloco "blockchain" conforme contrato oficial
     explorer_url = solana_response.get("blockchain", {}).get("explorer_url", "")
     return explorer_url
 

tests/test_certified_builder.py

@@ -84,15 +84,32 @@ def test_build_certificates(certified_builder, mock_participant, mock_certificat
     # comentário: mock do download de imagens e da resposta do serviço Solana para evitar chamada externa
     with patch('certified_builder.utils.fetch_file_certificate.fetch_file_certificate', side_effect=[mock_certificate_template, mock_logo]), \
          patch('certified_builder.certified_builder.CertificatesOnSolana.register_certificate_on_solana', return_value={
-             "status": "encontrado",
-             "explorer_url": "https://explorer.solana.com/tx/abc123?cluster=devnet",
+             # comentário: mock alinhado ao contrato atual do serviço
+             "status": "sucesso",
              "certificado": {
                  "event": "evento de teste",
-                 "uuid": "uuid-123",
                  "name": "user test",
                  "email": "[email protected]",
-                 "certificate_code": "ABC-123-XYZ",
-                 "time": "2025-10-31 12:05:38"
+                 "uuid": "uuid-123",
+                 "time": "2025-10-31 12:05:38",
+                 "json_canonico": {"fake": "data"},
+                 "hash_sha256": "deadbeef",
+                 "txid_solana": "fake_txid_abc123",
+                 "network": "devnet",
+                 "timestamp": "2025-10-31 12:05:39",
+                 "timestamp_unix": 1730366739
+             },
+             "blockchain": {
+                 "rede": "Solana Devnet",
+                 "explorer_url": "https://explorer.solana.com/tx/fake_txid_abc123?cluster=devnet",
+                 "verificacao_url": "http://localhost:8000/certificados/verify/fake_txid_abc123",
+                 "memo_program": "MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr"
+             },
+             "validacao": {
+                 "como_validar": "Recrie o JSON canonizado e compare o hash SHA-256",
+                 "json_canonico_string": "{}",
+                 "hash_esperado": "deadbeef",
+                 "comando_validacao": "printf '{}' | shasum -a 256"
              }
          }), \
          patch.object(certified_builder, 'save_certificate') as mock_save: