curl --request GET \
--url https://app.blockgence.com/v1/contract/{chain}/{addr} \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.blockgence.com/v1/contract/{chain}/{addr}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://app.blockgence.com/v1/contract/{chain}/{addr}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.blockgence.com/v1/contract/{chain}/{addr}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.blockgence.com/v1/contract/{chain}/{addr}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.blockgence.com/v1/contract/{chain}/{addr}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.blockgence.com/v1/contract/{chain}/{addr}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"detail": "<string>",
"error": "<string>"
}{
"detail": "<string>",
"error": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}{
"detail": "<string>",
"error": "<string>"
}{
"error": "source_unavailable",
"detail": "<string>",
"source": "<string>",
"reason": "<string>",
"retryable": true,
"chain": "<string>",
"primitive": "<string>",
"operation": "<string>",
"target": "<string>",
"http_status": 123,
"retry_after": 123,
"upstream_message": "<string>",
"source_fault": true,
"failure_cause": "<string>"
}Inspección de un contrato
Devuelve quién controla un contrato EVM y quién puede mover, acuñar o congelar sus fondos, leído en la red a un
bloque fijo. Cada afirmación cita en evidence el slot de storage, la llamada, el código o el log, con su
bloque y su fuente.
Campos principales:
account:contract,eoaoeoa_delegated(EIP-7702). Si la dirección no es un contrato, la respuesta termina ahí.proxy: el tipo de proxy, leído del storage (eip1967_transparent,eip1967_uups,eip1967_beacon,eip1967,zeppelinos,eip1822,eip1167_minimalosafe), la implementación y quién puede actualizarlo.abi: si el código de la implementación está verificado.getters: las funciones de autoridad (owner(),pendingOwner(),pauser()y similares) con lo que devuelven, ypaused.roles: los roles de AccessControl con sus miembros, cada uno confirmado conhasRolea ese bloque.accounts: las cuentas que controlan el contrato: EOA, Safe (con dueños y umbral), timelock o ProxyAdmin.privileged_functionsypowers: las funciones sensibles por categoría (upgrade,admin,pause,mint,freeze,seize,rescue,execute) y quién las tiene.basisdistingue un hecho (deterministic,role_admin,safe_owners,safe_module) de una pista por nombre (getter_name,role_name).authority_changes: los cambios de implementación, de admin, de dueño, de roles y de pausa desde la creación.simulation: quién pasa cada función sensible en una simulación al mismo bloque, comparado con una dirección de control sin permisos. Es una simulación, no un permiso: un revert nunca se lee como «no puede».summary,reasons,coverage,not_coveredydegraded_sources.
Para las marcas de seguridad de terceros, use GET /v1/security/{addr}.
No cubre, como hecho, quién puede llamar cada función según los modificadores del código (se da como pista o como simulación), los Diamonds (EIP-2535), el AccessManager de OpenZeppelin 5 ni los proxies con slots propios.
Errores: una red no EVM, una dirección inválida o un bloque futuro responden 400. En las redes donde no se
puede leer el estado de un bloque anterior, sin block se lee el estado actual (declarado en
coverage.state_note) y con block la respuesta es 503 sin cobro, nunca con el dato actual.
Costo: 10 créditos de base. Algunas operaciones cobran menos si reutilizan un resultado guardado; nunca más.
curl --request GET \
--url https://app.blockgence.com/v1/contract/{chain}/{addr} \
--header 'X-API-Key: <api-key>'import requests
url = "https://app.blockgence.com/v1/contract/{chain}/{addr}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://app.blockgence.com/v1/contract/{chain}/{addr}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.blockgence.com/v1/contract/{chain}/{addr}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://app.blockgence.com/v1/contract/{chain}/{addr}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://app.blockgence.com/v1/contract/{chain}/{addr}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.blockgence.com/v1/contract/{chain}/{addr}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"detail": "<string>",
"error": "<string>"
}{
"detail": "<string>",
"error": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}{
"detail": "<string>",
"error": "<string>"
}{
"error": "source_unavailable",
"detail": "<string>",
"source": "<string>",
"reason": "<string>",
"retryable": true,
"chain": "<string>",
"primitive": "<string>",
"operation": "<string>",
"target": "<string>",
"http_status": 123,
"retry_after": 123,
"upstream_message": "<string>",
"source_fault": true,
"failure_cause": "<string>"
}Autorizaciones
Encabezados
Parámetros de ruta
Parámetros de consulta
Modo evaluación, para analizar un incidente pasado sin información posterior. Con true, exige block (el anterior al hecho), no cita etiquetas de registros de incidentes ni etiquetas propias, y declara lo excluido en el campo eval_mode de la respuesta. Valor por defecto: false.
Respuesta
La inspección del contrato.