Add EVMole integration for unverified contracts

[cdump]

Currently, abi.ninja is trying to use heimdall-rs for ABI extraction from unverified contracts.

I propose to add (or replace) it with EVMole, which has the following advantages:

• Better accuracy in function selectors extraction
• Significant improvement in accuracy for function arguments extraction
• Faster performance
• A JavaScript implementation with zero dependencies, allowing it to be embedded in abi.ninja without an external backend

It already has an online demo. You can see an example usage in the source code of that page (right inside the <script> tag).

My proposed logic for unverified contracts:

1. Load runtimeBytecode (requires an external RPC call to eth_getCode; 1rpc is used in the EVMole demo)
2. Get function selectors with the evmole.functionSelectors JS function (offline)
3. Resolve function selectors using an API, like https://openchain.xyz/signatures
4. For unresolved selectors from the previous step, extract arguments using evmole.functionArguments (offline)

What do you think about this?

[cdump]

@technophile-04 @portdeveloper what do you think about this?

[portdeveloper]

Hey I think it looks great but how many chains does EVMole support right now?

[cdump]

All EVM chains, because evmole doesn't interact with the chain, only the evm bytecode required

…

On Thu, Dec 19, 2024, 11:22 port ***@***.***> wrote: Hey I think it looks great but how many chains does EVMole support right now? — Reply to this email directly, view it on GitHub <#102 (reply in thread)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AADNWXYBIFZTRBTG6WG2OLT2GKM7JAVCNFSM6AAAAABI4DBS7OVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTCNRRGU2TQNY> . You are receiving this because you authored the thread.Message ID: ***@***.***>

[portdeveloper]

That definitely sounds interesting!

[portdeveloper]

Alright just checked how it works and it definitely is really cool!
Here is a random SE2 app i spinned up to test it. https://test-evmole.vercel.app/

I have some questions:
-> Is it possible for evmole to return function types?
-> Is it possible to get an abi-like result from evmole?

[cdump]

1. Are you talking about function return type (outputs in abi)? It's not extracted by evmole yet.

const info = contractInfo(code, { selectors: false, arguments: true, stateMutability: true });
const abi = info.functions.map((fn) => ({
  type: 'function',
  name: `func_${fn.selector}`,
  stateMutability: fn.stateMutability,
  outputs: [], // or undefined - not extracted by evmole
  inputs: [], // need to parse arguments string with some library or code
}));

I can't recommend any particular JS library for converting arguments into inputs, but I can say that this arguments string is constructed using the same rules as those used in function signature hashes. So, keccak('${functionName}(${evmoleArguments)')[:4] represents the function signature