feat: Improve return type for toSignature

[SebastienGllmt]

Integrates wevm/abitype#255 into Viem to improve the return type of toSignature

This helps resolve these two discussions: #260 and #2706

A follow-up PR to this will have to be adding the option to pass the full signature to functions like getContractEvents and getAbiItem

---

PR-Codex overview

This PR focuses on improving the type safety and return types of the toSignature and normalizeSignature functions in the codebase, enhancing the handling of ABI signatures.

Detailed summary

• Updated toSignature to use generics for better return types.
• Enhanced normalizeSignature with stricter type definitions.
• Added detailed comments addressing limitations and expected behavior of signature normalization.
• Introduced new tests to validate the changes in type handling.

✨ Ask PR-Codex anything about this PR by commenting with /codex {your question}

[changeset-bot]

🦋 Changeset detected

Latest commit: ca1ca16

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
viem	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vercel]

@SebastienGllmt is attempting to deploy a commit to the Wevm Team on Vercel.

A member of the Team first needs to authorize it.

[SebastienGllmt]

There are multiple TODOs here and I'm not sure which one of these would have to be fixed to be considered good enough to merge (given that any type is better than no type, but the wrong type is also worse than no type)

I wanted to make the original commit for this PR contain as detailed information before we start truncating out cases to support the subset that makes sense

Here are the 4 options in increase level of work required (each option requires the previous option to be completed):

Option 1: we can make that the toSignature function only returns a type for AbiFunction | AbiEvent (since those cases are always correct) and then just return string otherwise (instead of trying to parse the string)

Option 2: we make string inputs work in some cases, but not all. This would require:
a. fixing the normalization of uint to uint256 (this is a bug in normalizeSignature and not in the type)
b. arguably, fixing the tuple(...) notation handling (but if the JS code is also wrong, no point in making the type match it)

Option 3: we try to make all valid string inputs work, but no guarantee on invalid inputs. This would require:
a. fixing tuple(uint) handling (maybe this is an abitype concern? However, this syntax isn't part of their human-readable string encoding)
b. adding proper trimming logic on whitespace

Option 4: make all string inputs work, and properly return never on invalid input

[SebastienGllmt]

note: this type (SignatureAbiItem) depends on wevm/abitype#255 getting merged and released

[SebastienGllmt]

Anything at all I can do to help move this forward?

[tmm]

Let's use AbiItem.getSignature from Ox.

@jxom and I are going to do a larger refactor in the new year that moves a lot of Viem's internals over to Ox, but can proxy from Ox for now.

[SebastienGllmt]

Just to make sure we're clear, ox also returns just string as the type of getSignature so it runs into the same issue this PR is trying to solve