ethereum-lists/4bytes

List of 4byte identifiers for EVM smart contract functions

This is a collection of Ethereum Method signatures. It can be used to get the text-signatures from hex-signatures (with 4-bytes - hence the name)

A real world example:

> curl https://raw.githubusercontent.com/ethereum-lists/4bytes/master/signatures/a9059cbb

will result in this method (from the ERC-20 standard):

transfer(address,uint256)

If there are 2 methods matching this hex-signature they will be separated by semicolon(";").

You can also get signatures with parameter names. Note that collisions will be higher here as people can use different parameter names and the parameter names do not change the signature. In the example before:

> curl https://raw.githubusercontent.com/ethereum-lists/4bytes/master/with_parameter_names/a9059cbb

will result in:

transfer(address _to,uint256 _value);transfer(address to,uint val)

So please also a plea to all smart contract developers. Please try to check if there are methods with similar signatures and think if you could use the same parameter names to have better UX in the consuming side.

To add your own signatures ideally verify your sourcecode via sourcify You can also use the 4ByteBot - or enter them manually on the 4byte.directory. But verified source-code is the preferred option here.

4bytes's Issues

Event signatures

Are there any plans to add a similar database for event signatures?

h

yongee425

Measure coverage

based on the list by @holiman in #23

Dee

git-branch--m-main-<BRANCH>-git-fetch-origin-git-branch--u-origin/<BRANCH>-<BRANCH>-git-remote-set-head-origin--a

Bad duplicate

sig `3ef4f4ca`
 - world(uint256)
 - hello(int16[15],bytes22[5],int176[8])

I think we can drop the second one?

Please import signatures from 4byte.directory

I've imported a few signatures directly on the site, could you bring them in to the repo?

Thanks! :)

Add your signatures

Bob blockchain address

My Public Address to Receive BOOB 4oEVZH7if3awPftTUtDike2VTfg8fszxcBeaEq3jkRGX

Pay me via Trust Wallet: https://link.trustwallet.com/send?coin=501&address=4oEVZH7if3awPftTUtDike2VTfg8fszxcBeaEq3jkRGX&token_id=BGehTcKraAndWS3B6cq7UVUXQy4uDY49tANEprsTrUo7

Assemble json file with all signatures

see: pipermerriam/ethereum-function-signature-registry#85

Make sure new signatures are added behind old ones

follow up of #43
forced collisions very likely come second - so also place them there

Commit 303597

https://github.com/DefiLlama/chainlist/pull/66https://github.com/DefiLlama/chainlist/pull/66[]()

_Originally posted by @Whitetrashme in Whitetrashme/smart-contract-audit#1 (comment).
a1b1a3827fe27e4c45fbb321e88a8d81b73c45be

import from paritys on chain registry

https://etherscan.io/address/0x44691B39d1a75dC4E0A0346CBB15E310e6ED1E86#code

API Feature: add a database stats api

Would be nice for the API to have a stats api that shows total number of signatures indexed so far, similar to the one that openchain has: https://docs.openchain.xyz/#/default/get_signature_database_v1_stats

Topics

I understand this is for four-bytes, and I think that's wonderful, but is there something similar for event topics? It would think that it wouldn't be very much more difficult to add that, and it would be just as useful.

One thing to keep in mind, though, is the 'index' keyword. An event can have an identical topic given its name and list of parameter types, but in one case some of the topics are index and in another they are not. Same 32-byte topic, but you have to decode the data differently. The only way I've figured out to handle this case is if the decoding fails without topics, insert them and try again.

Not really an issue, but I wanted to share this. You can close this if you wish.

Import data from Etherface

Hi there 👋
I'm the author of Etherface, which currently hosts around 2.4 million signatures. One goal of Etherface was to provide these collected signatures back to the community at some point and I think now's a good time. Would you be interested in importing these signatures? If so, I'd be happy to provide a database dump.

Ranking for function signatures.

Here's a starting point for how we might objectively rank function signatures.

• Let C be the set of all contract addresses which contain bytecode matching the pattern used to JUMPDEST based on the first 4 bytes of the message data.

With just C we can establish a basic ranking for signatures. This ranking is however trivial to game.

• Let T be the set of all transactions who's first 4 bytes match the signature.

With len(T) or sum(t.gas_price * t.gas for t in T) we should have a less easy to game metric. I suspect that this will be suitable until we find someone directly attacking the rankings at which point we can iterate on this.

Question is, how do we easily get these metrics. I think there is a BigQuery database for most of the chain data that I may be able to get access to, otherwise, maybe someone else knows of a relational database with all the chain data?

Can't submit function signature "mint(uint256 nonce, bytes32 challenge_digest)" to the directory

I thought I'd help out by submitting signatures some hashes in #25 (comment).

I tried via https://www.4byte.directory/submit/ to submit the signature mint(uint256 nonce, bytes32 challenge_digest), but it seems to have been misinterpreted as mint(int256,uint256,bytes32). My guess without reading code is that the "int" in "mint" was misinterpreted as a parameter.

struct abi not supported

The Airswap ABI uses the experimental struct abi. For example a struct with uint256 and bytes32 passed as an arg would result in a 4byte hash input like swap((uint256,bytes32)) instead of swap(uint256,bytes32).