Verify Contract (Standard JSON)

Submit a contract for verification via the Solidity standard JSON input, Vyper JSON input, or Fe JSON input (a Sourcify-defined format — Fe has no official compiler JSON interface).

There are no “single file” or “multi-part” verification endpoints because those are essentially wrappers around the Solidity compiler’s JSON interface. The verification frontend can provide files and settings options to resemble these.

You can optionally pass the creationTransactionHash to make Sourcify reliably fetching the creation bytecode. Otherwise, it will try to fetch it itself which is dependent on external services.

Note: The outputSelection field in the stdJsonInput.settings will be overridden during verification to ensure all necessary artifacts are generated.

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

cURL

Solidity Contract

curl --request POST \
  --url https://sourcify.dev/server/v2/verify/{chainId}/{address} \
  --header 'Content-Type: application/json' \
  --data '
{
  "stdJsonInput": {
    "language": "Solidity",
    "sources": {
      "contracts/Storage.sol": {
        "content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.0;\n\ncontract Storage {\n    uint256 number;\n\n    function setNumber(uint256 newNumber) public {\n        number = newNumber;\n    }\n\n    function getNumber() public view returns (uint256) {\n        return number;\n    }\n}\n"
      }
    },
    "settings": {
      "optimizer": {
        "enabled": false,
        "runs": 200
      }
    }
  },
  "compilerVersion": "0.8.7+commit.e28d00a7",
  "contractIdentifier": "contracts/Storage.sol:Storage",
  "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

stdJsonInput · object · required

Full standard JSON object to pass to the compiler.

Must include the language field inside the stdJsonInput object. Currently supports Solidity, Vyper, and Fe.

compilerVersion · string · required

Pattern: ^v?\d+\.\d+\.\d+.*$

Example:

"0.8.7+commit.e28d00a7"

contractIdentifier · string · required

The fully qualified file path and contract name to indicate which contract to verify, in the format path/to/file:ContractName.

Example:

"contracts/Storage.sol:Storage"

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