Resolve contract error names from WASM spec during invocation

[BlaineHeffron]

What

When a contract invocation fails, resolve the numeric error code (e.g. Error(Contract, #1)) to its human-readable name and documentation string from the contract's WASM spec, and display it directly next to the error code in the CLI output.

Before:
❌ error: transaction simulation failed: HostError: Error(Contract, #1)

Event log (newest first):
0: [Diagnostic Event] ...

After:
❌ error: transaction simulation failed: HostError: Error(Contract, #1)
NotFound: The requested resource was not found.

Event log (newest first):
0: [Diagnostic Event] ...

Why

Contract authors define error enums with meaningful names and documentation in their Soroban contracts (e.g. NotFound = 1 with doc "The requested resource was not found."), but the CLI only showed the raw numeric code #1. This made debugging contract failures unnecessarily difficult — users had to manually cross-reference error codes against the contract source. The WASM spec already contains this information; the CLI just wasn't using it.

This change handles all three error paths in contract invocation (first simulation, second simulation, and transaction submission), parses error codes from both the Display format (Error(Contract, #N)) and Debug format (Contract(N)), and searches all error enums in the spec rather than only the one named "Error" to support contracts with multiple error enums from dependencies.

Known limitations

• Error code extraction relies on string pattern matching against the RPC error message format (Contract, #N and Contract(N)). If the upstream error format changes, the parsing would need to be updated.
• The resolved error name is inserted before the event log by splitting at the first blank line (\n\n) in the error string. If the RPC response format changes to not include a blank line separator, the resolved name would fall back to appearing at the end of the message.
• Non-contract Soroban errors (Budget, Auth, etc.) are intentionally not resolved — only ScError::Contract(u32) codes are matched.

[Copilot]

Pull request overview

Enhances contract invoke error reporting by resolving ScError::Contract(u32) numeric codes into human-readable error names/docs from the contract WASM spec and inserting that detail into the CLI error output.

Changes:

• Map RPC failures during simulation/submission through an error “enhancer” that extracts contract error codes and injects resolved name/doc into the message.
• Add Spec::find_error_type_any to locate an error case by numeric value across all error enums in the spec.
• Update/extend tests to assert the new enriched error output behavior.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
cmd/soroban-cli/src/commands/contract/invoke.rs	Adds contract error-code extraction and error-message enhancement using the contract spec; adjusts error display formatting; adds unit tests for parsing.
cmd/crates/soroban-test/tests/it/integration/custom_types.rs	Updates integration test expectations to validate enriched error output and the returned detail string.
cmd/crates/soroban-spec-tools/src/lib.rs	Adds find_error_type_any to search all error enums for a matching numeric error code.

[leighmcculloch]

👏🏻 Very cool idea.