hathorlib blueprint move 2

[r4mmer]

Motivation

To be able to implement the blueprint simulator on hathorlib there is a significant amount of code that needs to be moved from hathor/ to hathorlib/.
Since moving this amount of code can cause instabilities we are breaking down these changes into more manageable and reviewable PRs.

This is the second PR in this sequence.

Acceptance Criteria

• Move nanocontracts exception hierarchy to hathorlib
• Move core types, decorators, and address utilities to hathorlib

Extra context

---

Important note about HathorError: NCFail MUST inherit from HathorError because NCFailsubclasses (e.g.,OCBInvalidScript, OCBPubKeyNotAllowed, NCInvalidSignature, NCInvalidPubKey) are raised during OnChainBlueprint verification (on_chain_blueprint_verifier.py) and propagate directly to vertex_handler.py:214where they are caught byexcept HathorError. If NCFaildid not inherit fromHathorError`, these exceptions would escape the catch block and cause unhandled errors.

Therefore, both NCFail and HathorError must be moved to hathorlib.

---

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

[github-actions]

Bencher Report

Branch	feat/hathorlib-blueprint-move-2
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.66 m (-3.20%) Baseline: 1.71 m	1.54 m (92.98%)	2.05 m (80.66%)

🐰 View full continuous benchmarking report in Bencher

[codecov]

Codecov Report

❌ Patch coverage is 91.30435% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 85.46%. Comparing base (ac98edd) to head (5fd4618).
⚠️ Report is 1 commits behind head on master.

Files with missing lines	Patch %	Lines
hathor/transaction/scripts/opcode.py	0.00%	1 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1606      +/-   ##
==========================================
- Coverage   85.58%   85.46%   -0.12%     
==========================================
  Files         449      449              
  Lines       33946    33537     -409     
  Branches     5309     5262      -47     
==========================================
- Hits        29051    28661     -390     
+ Misses       3872     3853      -19     
  Partials     1023     1023              

Flag	Coverage Δ
test-lib	85.46% <91.30%> (-0.12%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ 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.