OpenAPI and improvements

[vsuharnikov]

OpenAPI & Finalization, BLS, Core Logic Improvements, and Cleanup

TL;DR

• Refactors NgState and fixes multiple liquid block / microblock edge cases
• Adds BLS-related types, validation improvements, and API exposure
• Improves OpenAPI + Swagger UI (accurate schemas, new endpoints, better UX)
• Fixes rollback, block duplication, and mining stability issues
• Adds extensive tests and removes obsolete code

Finalization & Core Logic

Finalization

• Correct finalization height and voting derived from the right liquid block
• Fixed block appending after finalization
• Added safeguards against applying the same block twice

NG State Refactoring

Refactored NgState:

• Cleanup and simplification
• Replaced Vector + List with VectorMap for microblocks
• Improved correctness of liquid block handling

Mining & Block Processing Fixes

• Fixed liquid block forging logic
• Miner now correctly forges after the right liquid block
• Fixed key block validation against latest removed microblock
• Prevented invalid states during microblock rollback
• Improved handling of endorsement-related mining issues

BLS & Cryptography

• BLS validation fixes and improvements
• Improvements to signature validation logic (including P-256 context where applicable)

Logging & Diagnostics

• Improved logging order and clarity
• Added additional logging
• Added filters for endorsements (excluding miner endorsements)

HTTP API

Fixed route matching: prevented fallback by throwing in TransactionId and BlockId matchers.

OpenAPI Updates

Added:

• Endpoints:
  • GET /blocks/height/finalized
  • GET /blocks/headers/finalized
  • GET /blocks/finalized/at/{height}
  • GET /generators/at/{height}
  • GET /addresses/bls/{address}
• Transactions & Types: CommitToGenerationTransaction, AssetPair, DebugStateHashes, BLS-related schemas
• Components: BlsPublicKey, BlsSignature, GeneratorIndex, BlockEndorsement, FinalizationVoting

Block & Snapshot Fields

Added:

• finalizationVoting to block headers
• nextCommittedGenerators to TransactionSnapshot

Debug State Hash Fields

Added:

• nextCommittedGeneratorsHash
• committedGeneratorBalancesHash

to:

• /debug/stateHash/last
• /debug/stateHash/{height}

Transaction Schema Improvements

• Refined transaction schemas to display precise types in Swagger UI (instead of generic object)
• Limited feeAssetId to:
  • InvokeExpressionTransaction
  • InvokeScriptTransaction
  • TransferTransaction
  • UpdateAssetInfoTransaction
• Corrected assetId-like field types
• Eliminated deprecated nullable
• Added documentation for /transactions/sign (new fields)
• General schema fixes and cleanup

Swagger UI Improvements

• Updated Swagger UI to 5.31.1
• Disabled server selection
• Disabled "Explore" functionality
• Enabled "Try it" mode by default
• Hide "Try it out" button

Tests

• Added extensive new tests:
  • Finalization scenarios
  • Miner behavior
  • Microblock handling
  • Balance validation
• Updated existing tests
• Backported MiningFailuresSuite
• Added multiple edge-case checks

Cleanup

• Removed obsolete code
• General refactoring and comments