Contracts

Get the total number of deployed smart contracts

Returns the total number of deployed smart contracts.

Sample request

Plain

https://api.main.atgraphite.com/api
   ?module=contract
   &action=gettotalcontractcount
   &apikey=YourApiKeyToken

cURL

Sample response

{
    "status": "1",
    "message": "OK",
    "result": "9"
}

Get ABI for verified contract

Returns ABI for verified contract.

Sample request

Plain

https://api.main.atgraphite.com/api
   ?module=contract
   &action=getabi
   &address=0x0000000000000000000000000000000000001000
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
address*	address hex-string used for identifying contract

Sample response

{
    "status": "1",
    "message": "OK",
    "result": "[{\"constant\":false,\"inputs\":[{\"name\":\"voucher_token\",\"type\":\"bytes32\"}],\"name\":\"burn\",\"outputs\":[{\"name\":\"success\",\"type\":\"bool\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"constant\":true,\"inputs\":[{\"name\":\"voucher_token\",\"type\":\"bytes32\"}],\"name\":\"is_expired\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"},{\"constant\":false,\"inputs\":[{\"name\":\"voucher_token\",\"type\":\"bytes32\"}],\"name\":\"is_burnt\",\"outputs\":[{\"name\":\"\",\"type\":\"bool\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"},{\"inputs\":[{\"name\":\"voucher_token\",\"type\":\"bytes32\"},{\"name\":\"_lifetime\",\"type\":\"uint256\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"constructor\"}]"
}

Get contract deployed byte code

Returns deployed bytecode for a given contract address

Sample request

Plain

https://api.main.atgraphite.com/api
   ?module=contract
   &action=getbytecode
   &address=0x0000000000000000000000000000000000001000
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
address*	address hex-string used for identifying contract

Sample response

{
    "status": "1",
    "message": "OK",
    "result": "0x312f378576e12537b1243c15723a31231bf23123e23167e568c57fb45b12309f9989e99dc9899"
}

Get contract creation bytecode

Returns creation bytecode for a given contract address

Sample request

Plain

https://api.main.atgraphite.com/api
   ?module=contract
   &action=getcreationbytecode
   &address=0x0000000000000000000000000000000000001000
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
address*	address hex-string used for identifying contract

Sample response

{
    "status": "1",
    "message": "OK",
    "result": "0x312f378576e12537b1243c15723a31231bf23123e23167e568c57fb45b12309f9989e99dc9899"
}

Get contract source code for verified contract

Returns source code for verified contract.

Sample request

Plain

https://api.main.atgraphite.com/api
   ?module=contract
   &action=getsourcecode
   &address=0x0000000000000000000000000000000000001000
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
address*	address hex-string used for identifying contract

Sample response

{
    "status": "1",
    "message": "OK",
    "result": {
        "abi": "[{\n\"type\":\"event\",\n\"inputs\": [{\"name\":\"a\",\"type\":\"uint256\",\"indexed\":true},{\"name\":\"b\",\"type\":\"bytes32\",\"indexed\":false}],\n\"name\":\"Event\"\n}, {\n\"type\":\"event\",\n\"inputs\": [{\"name\":\"a\",\"type\":\"uint256\",\"indexed\":true},{\"name\":\"b\",\"type\":\"bytes32\",\"indexed\":false}],\n\"name\":\"Event2\"\n}, {\n\"type\":\"function\",\n\"inputs\": [{\"name\":\"a\",\"type\":\"uint256\"}],\n\"name\":\"foo\",\n\"outputs\": []\n}]\n",
        "compilerVersion": "v0.2.1-2016-01-30-91a6b35",
        "contractName": "Test",
        "optimizationUsed": "1",
        "sourceCode": "pragma solidity >0.4.24;\n\ncontract Test {\nconstructor() public { b = hex\"12345678901234567890123456789012\"; }\nevent Event(uint indexed a, bytes32 b);\nevent Event2(uint indexed a, bytes32 b);\nfunction foo(uint a) public { emit Event(a, b); }\nbytes32 b;\n}\n",
        "byteCode": "0x312f378576e12537b1243c15723a31231bf23123e23167e568c57fb45b12309f9989e99dc9899",
        "constructorArguments": "",
        "implementationAddress": null
    }
}

Get Contract creator and creation transaction hash

Returns a contract's deployer address and transaction hash it was created, up to 5 at a time.

Sample request

Plain

https://api.main.atgraphite.com/api
   ?module=contract
   &action=getcontractcreation
   &contractaddresses=0xb83c27805aaca5c7082eb45c868d955cf04c337f,0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
contractaddresses*	the contract address, up to 5 at a time

Sample response

{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "contractAddress": "0xb83c27805aaca5c7082eb45c868d955cf04c337f",
            "contractCreator": "0x390dcfddebeff949b9862ec91d7be337b8995553",
            "txHash": "0x0dbad4991b6727df606650635c9e632dad8a92c6363c91652307680efd336c6e",
            "blockNumber": "15062235"
        },
        {
            "contractAddress": "0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45",
            "contractCreator": "0x6c9fc64a53c1b71fb3f9af64d1ae3a4931a5f4e9",
            "txHash": "0x7299cca7203f60a831756e043f4c2ccb0ee6cb7cf8aed8420f0ae99a16883a2b",
            "blockNumber": "13804681"
        }
    ]
}

Get contract addresses by contract method identifier

Returns a list of contract addresses by contract method identifier, sorted by creation block number

Sample request

Plain

https://api.main.atgraphite.com/api
   ?module=contract
   &action=getcontractsbymethod
   &methodid=0xa9059cbb
   &offset=0
   &limit=10
   &sort=asc
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
methodid*	the hex string representing the method id (4 bytes)
offset	skips the offset records before beginning to return the records, default value is 0
limit	the number of records displayed per page, default value is 10000
sort	the sorting preference, use asc to sort by ascending and desc to sort by descending, default value is asc

Sample response

{
    "status": "1",
    "message": "OK",
    "result": [
        "0x741b84be98a7181eb05d8d0fcc7ce285bc9e5c4a",
        "0xd9fdf6d8340df2c358e9e4f6aecc08b8373ae054",
        "0xca54e68e81915143f1fa261e253cf6777c36dbd4",
        "0xac331ff69d4cf665a54013c419bcafaf90f7e1d0",
        "0x32286efee48171b29e066ef8992bb3063231d61e",
        "0xa0eb9b10d9e24ed8e0910f204118f44af7bf7cb9",
        "0xe8df28ef22990009e1d247a329f8507ba4cfa58a",
        "0x5e6c18ceea41c161118b62c8737f5ba9400ba54f",
        "0x8e2b9e2764c213872b70af4586ea75a5627e4555",
        "0x158c14bbedb24398785553b9ec8c71387f52df44"
    ]
}

Get Contract destructor and destruction transaction hash

Returns a contract's destructor address and transaction hash it was destructed, up to 5 at a time.

Sample request

Plain

https://api.main.atgraphite.com/api
   ?module=contract
   &action=getcontractdestruction
   &contractaddresses=0x838e90a2f735276d8c7824c3858b7ceb3aa6b110,0x76173df7aceeeb990839dc0c359c4a3ec1e01da7
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
contractaddresses*	the contract address, up to 5 at a time

Sample response

{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "contractAddress": "0x838e90a2f735276d8c7824c3858b7ceb3aa6b110",
            "contractDestructor": "0x9b2c46642caf6b936dc0633da521f1e946b7e18f",
            "txHash": "0x3340c44ecdfc73450f030f01e4f95328d1df5cf11e2646f5b94325d68ecb97f1",
            "blockNumber": "55245"
        },
        {
            "contractAddress": "0x76173df7aceeeb990839dc0c359c4a3ec1e01da7",
            "contractDestructor": "0x3d0768da09ce77d25e2d998e6a7b6ed4b9116c2d",
            "txHash": "0x55cee382ac5ed2e48638db8fa1ae8df356a6f2d4190f270e9e8938648f8c84ad",
            "blockNumber": "55502"
        }
    ]
}

Verify a contract with its source code and contract creation information

Verifies a contract with its source code.

Body parameters (json)

Parameter	Description
addressHash*	the address of the contract
name*	the name of the contract
compilerVersion*	the compiler version for the contract
optimization*	whether or not compiler optimizations were enabled
contractSourceCode*	the source code of the contract
evmVersion	the EVM version for the contract
optimizationRuns	the number of optimization runs used during compilation

Sample request (HTTP POST)

https://api.main.atgraphite.com/api
   ?module=contract
   &action=verifysourcecode
   &apikey=YourApiKeyToken

Body (json):

{
    "addressHash": "0x9271602210f21ab82999dd43792a12e63c6e3269",
    "name": "test_contract",
    "compilerVersion": "v0.2.1-2016-01-30-91a6b35",
    "optimization": true,
    "optimizationRuns": 200,
    "contractSourceCode": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.13; contract Counter { uint public count; function get() public view returns (uint) { return count; } function inc() public { count += 1; } function dec() public { count -= 1; }}"
}

Sample response

{
    "status": "1",
    "message": "OK",
    "result": {
        "abi": "[{\n\"type\":\"event\",\n\"inputs\": [{\"name\":\"a\",\"type\":\"uint256\",\"indexed\":true},{\"name\":\"b\",\"type\":\"bytes32\",\"indexed\":false}],\n\"name\":\"Event\"\n}, {\n\"type\":\"event\",\n\"inputs\": [{\"name\":\"a\",\"type\":\"uint256\",\"indexed\":true},{\"name\":\"b\",\"type\":\"bytes32\",\"indexed\":false}],\n\"name\":\"Event2\"\n}, {\n\"type\":\"function\",\n\"inputs\": [{\"name\":\"a\",\"type\":\"uint256\"}],\n\"name\":\"foo\",\n\"outputs\": []\n}]\n",
        "compilerVersion": "v0.2.1-2016-01-30-91a6b35",
        "contractName": "test_contract",
        "optimizationUsed": "0",
        "sourceCode": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.13; contract Counter { uint public count; function get() public view returns (uint) { return count; } function inc() public { count += 1; } function dec() public { count -= 1; }}",
        "byteCode": "0x312f378576e12537b1243c15723a31231bf23123e23167e568c57fb45b12309f9989e99dc9899",
        "constructorArguments": "",
        "implementationAddress": null
    }
}

Get supported compiler versions

Returns supported compiler versions.

Sample request (HTTP POST)

https://api.main.atgraphite.com/api
   ?module=contract
   &action=getcompilerversions
   &apikey=YourApiKeyToken

Sample response

{
    "status": "1",
    "message": "OK",
    "result": [
        "v0.8.10+commit.fc410830",
        "v0.8.11+commit.d7f03943",
        "v0.8.12+commit.f00d7308",
        "v0.8.13+commit.abaa5c0e",
        "v0.8.14+commit.80d49f37",
        "v0.8.15+commit.e14f2714",
        "v0.8.16+commit.07a7930e",
        "v0.8.17+commit.8df45f5f"
    ]
}

Get contract creation history

Returns a contract creation history (creator address, transaction hash and block number when it was created)

Sample request

Plain

https://api.main.atgraphite.com/api
   ?module=contract
   &action=getcreationhistory
   &contractaddress=0x3293d43cf57cdd7f78e8b193e6628939400b321d
   &offset=0
   &limit=10
   &sort=desc
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
contractaddress*	address hex-string used for identifying contract

Sample response

{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "blockNumber": "18009592",
            "contractAddress": "0x3293d43cf57cdd7f78e8b193e6628939400b321d",
            "contractCreator": "0xd7bdff042c48ed3d5dd527301e8001d5860ae717",
            "txHash": "0x8fe362efc9a222c8f025f9663e88bdaf331acbcf538afc64499487dd185c76c0"
        },
        {
            "blockNumber": "17859733",
            "contractAddress": "0x3293d43cf57cdd7f78e8b193e6628939400b321d",
            "contractCreator": "0xd7bdff042c48ed3d5dd527301e8001d5860ae717",
            "txHash": "0xed5a6a39d95feafa537a104b311082348e1ea9e2cf9457bac4e1c4f31c45d198"
        },
        {
            "blockNumber": "17809911",
            "contractAddress": "0x3293d43cf57cdd7f78e8b193e6628939400b321d",
            "contractCreator": "0xd7bdff042c48ed3d5dd527301e8001d5860ae717",
            "txHash": "0x194b3bed50a6a68047b87c79e9829010011eb9e79768d1926169c676c81983b1"
        },
        {
            "blockNumber": "17565842",
            "contractAddress": "0x3293d43cf57cdd7f78e8b193e6628939400b321d",
            "contractCreator": "0xd7bdff042c48ed3d5dd527301e8001d5860ae717",
            "txHash": "0x8d54a2c20ac872db263d7a3615caff32313130dc765fa6f3706c467612474a63"
        },
        {
            "blockNumber": "17293429",
            "contractAddress": "0x3293d43cf57cdd7f78e8b193e6628939400b321d",
            "contractCreator": "0xd7bdff042c48ed3d5dd527301e8001d5860ae717",
            "txHash": "0x03fd065e38fd4ac05eab45d40cd8bee8878b7985b46fa5a680ea83b1920aa3e0"
        }
    ]
}

Get contract destruction history

Returns a contract destruction history (destructor address, transaction hash and block number when it was destructed)

Sample request

Plain

https://api.main.atgraphite.com/api
   ?module=contract
   &action=getdestructionhistory
   &contractaddress=0x3293d43cf57cdd7f78e8b193e6628939400b321d
   &offset=0
   &limit=10
   &sort=desc
   &apikey=YourApiKeyToken

cURL

Request query parameters

Parameter	Description
contractaddress*	address hex-string used for identifying contract

Sample response

{
    "status": "1",
    "message": "OK",
    "result": [
        {
            "blockNumber": "18009583",
            "contractAddress": "0x3293d43cf57cdd7f78e8b193e6628939400b321d",
            "contractDestructor": "0xd7bdff042c48ed3d5dd527301e8001d5860ae717",
            "txHash": "0xff59edcb5257f2fae321d4caaf52a1793d511c9460497be82fa1fbe456e27f7b"
        },
        {
            "blockNumber": "17859565",
            "contractAddress": "0x3293d43cf57cdd7f78e8b193e6628939400b321d",
            "contractDestructor": "0xd7bdff042c48ed3d5dd527301e8001d5860ae717",
            "txHash": "0xe31c4cce8b8b531f911880fb2bd978c42b6a3da8581c63309dc5174ecc5f5a1a"
        },
        {
            "blockNumber": "17809898",
            "contractAddress": "0x3293d43cf57cdd7f78e8b193e6628939400b321d",
            "contractDestructor": "0xd7bdff042c48ed3d5dd527301e8001d5860ae717",
            "txHash": "0xb928c47de5fc18e2a968f695d9c31e0d418d4a24968fa73e2d7313f73e713f30"
        },
        {
            "blockNumber": "17565798",
            "contractAddress": "0x3293d43cf57cdd7f78e8b193e6628939400b321d",
            "contractDestructor": "0xd7bdff042c48ed3d5dd527301e8001d5860ae717",
            "txHash": "0xd6a832782779c901802063b65e33f7da890c0d758ebc3f36a177875ca713dc1f"
        }
    ]
}