Get the total number of deployed smart contracts
Returns the total number of deployed smart contracts.
Sample request
https://api.thespectre.io/api
?module=contract
&action=gettotalcontractcount
&apikey=YourApiKeyToken
Sample response
{
"status": "1",
"message": "OK",
"result": "9"
}
Get ABI for verified contract
Returns ABI for verified contract.
Sample request
https://api.thespectre.io/api
?module=contract
&action=getabi
&address=0x0000000000000000000000000000000000001000
&apikey=YourApiKeyToken
Request query parameters
| Parameter | Description |
|---|
| 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
https://api.thespectre.io/api
?module=contract
&action=getbytecode
&address=0x0000000000000000000000000000000000001000
&apikey=YourApiKeyToken
Request query parameters
| Parameter | Description |
|---|
| 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
https://api.thespectre.io/api
?module=contract
&action=getcreationbytecode
&address=0x0000000000000000000000000000000000001000
&apikey=YourApiKeyToken
Request query parameters
| Parameter | Description |
|---|
| 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
https://api.thespectre.io/api
?module=contract
&action=getsourcecode
&address=0x0000000000000000000000000000000000001000
&apikey=YourApiKeyToken
Request query parameters
| Parameter | Description |
|---|
| 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
https://api.thespectre.io/api
?module=contract
&action=getcontractcreation
&contractaddresses=0xb83c27805aaca5c7082eb45c868d955cf04c337f,0x68b3465833fb72a70ecdf485e0e4c7bd8665fc45
&apikey=YourApiKeyToken
Request query parameters
| Parameter | Description |
|---|
| 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
https://api.thespectre.io/api
?module=contract
&action=getcontractsbymethod
&methodid=0xa9059cbb
&offset=0
&limit=10
&sort=asc
&apikey=YourApiKeyToken
Request query parameters
| Parameter | Description |
|---|
| the hex string representing the method id (4 bytes) |
| skips the offset records before beginning to return the records, default value is 0 |
| the number of records displayed per page, default value is 10000 |
| 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
https://api.thespectre.io/api
?module=contract
&action=getcontractdestruction
&contractaddresses=0x838e90a2f735276d8c7824c3858b7ceb3aa6b110,0x76173df7aceeeb990839dc0c359c4a3ec1e01da7
&apikey=YourApiKeyToken
Request query parameters
| Parameter | Description |
|---|
| 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 |
|---|
| the address of the contract |
| |
| the compiler version for the contract |
| whether or not compiler optimizations were enabled |
| the source code of the contract |
| the EVM version for the contract |
| the number of optimization runs used during compilation |
Sample request (HTTP POST)
https://api.thespectre.io/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.thespectre.io/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
https://api.thespectre.io/api
?module=contract
&action=getcreationhistory
&contractaddress=0x3293d43cf57cdd7f78e8b193e6628939400b321d
&offset=0
&limit=10
&sort=desc
&apikey=YourApiKeyToken
Request query parameters
| Parameter | Description |
|---|
| 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
https://api.thespectre.io/api
?module=contract
&action=getdestructionhistory
&contractaddress=0x3293d43cf57cdd7f78e8b193e6628939400b321d
&offset=0
&limit=10
&sort=desc
&apikey=YourApiKeyToken
Request query parameters
| Parameter | Description |
|---|
| 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"
}
]
}
