feat(nano): Improve Nano History HTTP API

[msbrogli]

Motivation

These changes are commonly used by dApp developers.

Acceptance Criteria

1. Add TransactionMetadata.nc_events: list[tuple[bytes, bytes]].
2. Add include_nc_logs: bool and include_nc_events: bool to the Nano History API.
3. Add include_nc_logs: bool and include_nc_events: bool to the Transaction API.
4. Add nc_args_decoded to the response in Nano History API.
5. Add nc_args_decoded to the response in Transaction API.
6. Introduce VertexHelper with method to_json(), .to_json_extended(), and decode_nc_args().

Checklist

• If you are requesting a merge into master, confirm this code is production-ready and can be included in future releases as soon as it gets merged

[msbrogli]

Should we add a limit to the number of stored events?

[glevco]

I don't think this should be stored in metadata since it's completely useless for most full nodes, we could either store it in files just like the nc logs, or for quicker solution, just ignore events and require blueprint devs to write logs when they write events — that is, events would not be available though the APIs, only logs

[glevco]

We can refactor this later.

[glevco]

Should we add a limit to the number of stored events?

This is also not problematic while OCB is restricted, so we should review for unreasonably large event generation. We can also improve it after removing it from metadata.

[github-actions]

Bencher Report

Branch	feat/nano/history-api-improvements
Testbed	ubuntu-22.04

Click to view all benchmark results

Benchmark	Latency	Benchmark Result minutes (m) (Result Δ%)	Lower Boundary minutes (m) (Limit %)	Upper Boundary minutes (m) (Limit %)
sync-v2 (up to 20000 blocks)	📈 view plot 🚷 view threshold	1.68 m (-3.19%) Baseline: 1.73 m	1.56 m (92.96%)	2.08 m (80.68%)

🐰 View full continuous benchmarking report in Bencher

[codecov]

Codecov Report

❌ Patch coverage is 77.57009% with 24 lines in your changes missing coverage. Please review.
✅ Project coverage is 86.12%. Comparing base (9f37644) to head (e3fcf65).
⚠️ Report is 3 commits behind head on master.

Files with missing lines	Patch %	Lines
hathor/transaction/json_serializer.py	67.69%	15 Missing and 6 partials ⚠️
hathor/transaction/resources/transaction.py	80.00%	0 Missing and 2 partials ⚠️
hathor/builder/builder.py	88.88%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1486      +/-   ##
==========================================
+ Coverage   86.10%   86.12%   +0.02%     
==========================================
  Files         439      440       +1     
  Lines       33891    33993     +102     
  Branches     5296     5315      +19     
==========================================
+ Hits        29183    29278      +95     
+ Misses       3687     3685       -2     
- Partials     1021     1030       +9     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.