Validate the response.
Check contract version 1.0 and reject sample results in production. Preserve coverage, unknowns and rule identifiers alongside the indicators.
Use the same engine behind the website and Telegram checks. Start with a public identifier, then handle the returned evidence and uncertainty in your own application.
The hosted endpoint is POST /v1/check. Authenticate with an issued, scoped API key. Contact the team to arrange access.
The example checks Tether’s public TRON contract address as an address. It does not initiate a transaction.
Set ENGINE_API_KEY privately in your server environment. Set REQUEST_ID to a fresh UUID for a new request; reuse it only for an identical retry within 24 hours.
Keep subjects and context out of URL query strings, analytics and logs. Never submit a private key or seed phrase.
Discuss API accesscurl https://api.8thguard.com/v1/check \
--request POST \
--header "Authorization: Bearer $ENGINE_API_KEY" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: $REQUEST_ID" \
--data '{
"subject": {
"kind": "address",
"chain": "tron",
"value": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
},
"tier": "quick"
}'import { randomUUID } from "node:crypto";
const res = await fetch("https://api.8thguard.com/v1/check", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.ENGINE_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": randomUUID(),
},
body: JSON.stringify({
subject: { kind: "address", chain: "tron", value: "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" },
tier: "quick",
}),
});
if (!res.ok) throw new Error(`8thGuard check failed: ${res.status}`);
const report = await res.json();
// Reject sample results in production; inspect indicators, coverage and unknowns.
if (report.sample) throw new Error("Refusing sample record in production");import os, uuid, requests
response = requests.post(
"https://api.8thguard.com/v1/check",
headers={
"Authorization": f"Bearer {os.environ['ENGINE_API_KEY']}",
"Content-Type": "application/json",
"Idempotency-Key": str(uuid.uuid4()),
},
json={
"subject": {"kind": "address", "chain": "tron", "value": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"},
"tier": "quick",
},
timeout=20,
)
response.raise_for_status()
report = response.json()
assert not report.get("sample"), "Refusing sample record in production"Use address, transaction or contract with a chain such as tron or evm:1. The schema also recognises bitcoin, solana, xrpl and ton; coverage depends on the subject and configured sources.
An agent-controlled on-chain wallet is still an address on its actual chain. The separate agent kind uses chain: none for supplied agent context; it cannot prove identity or wallet control.
Optional context is a JSON object with string, integer or boolean values. The engine tiers are quick, review and business, subject to access. The web’s free preview is not a separate engine tier.
The source adapter exposes check_subject(kind, chain, value, context?). It passes the request to the engine and returns its structured response.
From an authorised repository checkout with the engine dependencies installed, launch the command shown here or add the JSON configuration to your MCP client. Supply ENGINE_BASE_URL=https://api.8thguard.com and your issued ENGINE_API_KEY through private process environment settings.
Run the adapter from an authorised source checkout. The HTTP check endpoint is not an MCP transport URL.
{
"mcpServers": {
"8thguard": {
"command": "uv",
"args": ["run", "--project", "apps/engine", "python", "-m", "eighthguard.mcp_front", "--transport", "stdio"],
"env": {
"ENGINE_BASE_URL": "https://api.8thguard.com",
"ENGINE_API_KEY": "<your-issued-api-key>"
}
}
}
}uv run --project apps/engine python -m eighthguard.mcp_front --transport stdio{
"kind": "address",
"chain": "tron",
"value": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"
}Check contract version 1.0 and reject sample results in production. Preserve coverage, unknowns and rule identifiers alongside the indicators.
401/403 indicate an access problem; 409 an idempotency conflict or request in progress; 429 a limit. A timeout or error is not a clean result.
Public verification returns the ID, product, issue time, hash and status. It does not return the report or validate a counterparty’s identity.
Your policy controls approvals and transaction permissions. Treat report text as data, never as an instruction to override your agent’s authorisation.
Test the payment flow with 0.25 test USDC on Base Sepolia. Test tokens have no monetary value. Real-money x402 payments remain closed.
The explicit test endpoint is POST /v1/testnet/x402/check. It returns an x402 v2 challenge with a nonce tied to your exact request and the accepted terms. Use the 8thGuard helper to sign that nonce; a generic client’s random nonce is not accepted.
A successful test returns the Watch contract with sample: true and an 8G-S- ID. If confirmation is pending, retry the same signed request. Never use a sample as a production decision.
Open the test payment pageRead current payment configurationRead the x402 protocol documentation
The source helper is eighthguard.x402_client.prepare_test_payment. It accepts your own signer; no private key is sent to 8thGuard. Full retry and request-binding instructions are in docs/payments/X402-TESTNET.md in the authorised source checkout.