Verify contract via similarity search

Starts a verification job that searches the Sourcify database for contracts whose runtime bytecode is similar to the contract deployed at the given address. The job will attempt to verify against each candidate until a match is found or the candidate list is exhausted.

POST /v2/verify/similarity/{chainId}/{address}

Verify contract via similarity search

cURL

curl --request POST \
  --url https://sourcify.dev/server/v2/verify/similarity/{chainId}/{address} \
  --header 'Content-Type: application/json' \
  --data '
{
  "creationTransactionHash": "0xb6ee9d528b336942dd70d3b41e2811be10a473776352009fd73f85604f5ed206"
}
'

202

{
  "verificationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Path Parameters

chainId · string · required

The chainId number of the EVM chain

Required string length: 1 - 20

Pattern: ^\d+$

Example:

"11155111"

address · string · required

Contract's 20 byte address in hex string with the 0x prefix. Case insensitive.

Required string length: 42

Pattern: (\b0x[a-fA-F0-9]{40}\b)

Example:

"0x2738d13E81e30bC615766A0410e7cF199FD59A83"

Body

application/json

creationTransactionHash · string

The hash of the transaction that created this contract. Optional.

Pattern: (\b0x[a-f0-9]{64}\b)

Example:

"0xb6ee9d528b336942dd70d3b41e2811be10a473776352009fd73f85604f5ed206"

Response

202

application/json

Successfully submitted the verification. The server started to process the verification.

You can follow the verification status via the returned verificationId at GET /v2/verify/{verificationId}

verificationId · string<uuid> · required