{ "schemaVersion": "1.3", "name": "Jepeta Risk Guard", "agentId": "01a0b446-374c-7eb8-8fe8-cd1a9945ea70", "providerWallet": "0xefcb0359e2cd6d1ad92cbca1e41c8946b308d7df", "network": { "name": "Base", "chainId": 8453 }, "commerce": { "protocol": "Virtuals ACP v2", "offeringId": "01a0bb7b-be32-73e8-abe6-1385a115ac16", "offeringName": "token_risk_scan", "price": { "asset": "USDC", "amount": "0.03" }, "slaMinutes": 5, "requiredFunds": false, "directUrl": "https://app.virtuals.io/acp/agent/01a0b446-374c-7eb8-8fe8-cd1a9945ea70", "displayName": "Token Risk Scan" }, "purpose": "Machine-readable pre-trade ERC-20 risk screening for Base tokens.", "input": { "type": "object", "required": [ "tokenAddress" ], "properties": { "tokenAddress": { "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$", "description": "ERC-20 token contract address on Base chain 8453" } }, "additionalProperties": false }, "deliverable": { "type": "object", "required": [ "decisionVersion", "chainId", "tokenAddress", "policyVerdict", "hardBlockers", "reviewReasons", "reasonCodes", "trustSignals", "dataQuality", "sourceStatus", "securityContext", "marketContext", "holderContext", "evidence", "observedAt", "decisionSummary", "riskScore", "riskLevel", "honeypot", "dangerousPermissions", "liquidityRisk", "holderConcentration", "tradingActivity", "warnings", "summary", "baseEngineVersion", "historyContext" ], "properties": { "decisionVersion": { "type": "string" }, "chainId": { "type": "integer", "enum": [ 8453 ] }, "tokenAddress": { "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$" }, "policyVerdict": { "type": "string", "enum": [ "BLOCK", "REVIEW", "NO_HARD_BLOCK_DETECTED" ] }, "hardBlockers": { "type": "array", "items": { "type": "string" } }, "reviewReasons": { "type": "array", "items": { "type": "string" } }, "reasonCodes": { "type": "array", "items": { "type": "string" } }, "trustSignals": { "type": "array", "items": { "type": "string" } }, "dataQuality": { "type": "string", "enum": [ "HIGH", "MEDIUM", "LOW" ] }, "sourceStatus": { "type": "object", "required": [ "goPlus", "dexScreener" ], "properties": { "goPlus": { "type": "object", "required": [ "status", "required" ], "properties": { "status": { "type": "string" }, "required": { "type": "boolean" } }, "additionalProperties": false }, "dexScreener": { "type": "object", "required": [ "status", "required" ], "properties": { "status": { "type": "string" }, "required": { "type": "boolean" } }, "additionalProperties": false } }, "additionalProperties": false }, "securityContext": { "type": "object" }, "marketContext": { "type": "object" }, "holderContext": { "type": "object" }, "evidence": { "type": "array", "items": { "type": "object", "required": [ "source", "code", "signal", "value", "severity" ], "properties": { "source": { "type": "string" }, "code": { "type": "string" }, "signal": { "type": "string" }, "value": {}, "severity": { "type": "string", "enum": [ "BLOCKER", "HIGH", "MEDIUM", "INFO" ] } }, "additionalProperties": false } }, "observedAt": { "type": "string" }, "decisionSummary": { "type": "string" }, "riskScore": { "type": "number", "minimum": 0, "maximum": 100 }, "riskLevel": { "type": "string", "enum": [ "LOW", "MEDIUM", "HIGH", "CRITICAL" ] }, "honeypot": { "type": "boolean" }, "dangerousPermissions": { "type": "array", "items": { "type": "string" } }, "liquidityRisk": { "type": "string", "enum": [ "UNKNOWN", "LOW", "MEDIUM", "HIGH", "CRITICAL" ] }, "holderConcentration": { "type": "string" }, "tradingActivity": { "type": "string" }, "warnings": { "type": "array", "items": { "type": "string" } }, "summary": { "type": "string" }, "baseEngineVersion": { "type": "string" }, "historyContext": { "type": "object", "required": [ "observationNumber", "firstObservation", "previousObservedAt", "changedSincePrevious", "eventHash", "previousEventHash", "materialChanges", "riskScoreDelta", "liquidityUSDDelta", "maxHolderPercentDelta", "addedHardBlockers", "removedHardBlockers", "addedReviewReasons", "removedReviewReasons", "addedDangerousPermissions", "removedDangerousPermissions", "addedTrustSignals", "removedTrustSignals" ], "properties": { "observationNumber": { "type": "integer", "minimum": 1 }, "firstObservation": { "type": "boolean" }, "previousObservedAt": { "type": [ "string", "null" ] }, "changedSincePrevious": { "type": "boolean" }, "eventHash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "previousEventHash": { "type": [ "string", "null" ] }, "materialChanges": { "type": "array", "items": { "type": "string" } }, "riskScoreDelta": { "type": [ "number", "null" ] }, "liquidityUSDDelta": { "type": [ "number", "null" ] }, "maxHolderPercentDelta": { "type": [ "number", "null" ] }, "addedHardBlockers": { "type": "array", "items": { "type": "string" } }, "removedHardBlockers": { "type": "array", "items": { "type": "string" } }, "addedReviewReasons": { "type": "array", "items": { "type": "string" } }, "removedReviewReasons": { "type": "array", "items": { "type": "string" } }, "addedDangerousPermissions": { "type": "array", "items": { "type": "string" } }, "removedDangerousPermissions": { "type": "array", "items": { "type": "string" } }, "addedTrustSignals": { "type": "array", "items": { "type": "string" } }, "removedTrustSignals": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": false } }, "additionalProperties": false }, "dataSources": [ { "name": "GoPlus Security", "purpose": "Token security controls and honeypot signal" }, { "name": "DEX Screener", "purpose": "Matching Base pool liquidity and recent trading activity" } ], "safetyProperties": { "readOnlyAnalysis": true, "performsTrades": false, "movesBuyerFundsOutsideAcpEscrow": false, "unknownSecurityDataFailsClosed": true, "crossChainPoolMixing": false, "differentTokenFallback": false }, "failureSemantics": { "unsupportedOrInsufficientData": "No reassuring verdict is issued. The provider does not quote unsupported tokens.", "sourceOutage": "The provider retries a bounded number of times and does not fabricate missing values.", "incompleteData": "Unknown fields are surfaced explicitly and cannot produce a reassuring LOW classification." }, "engine": { "version": "2.0.0", "methodology": "Heuristic screening, not a smart-contract audit, safety guarantee, or investment recommendation." }, "endpoints": { "humanPreview": "https://eliber12.github.io/jepeta-core/", "previewApi": "https://aitgmgfumsdqecmanrab.supabase.co/functions/v1/jepeta-risk-scan", "openapi": "https://eliber12.github.io/jepeta-core/openapi.json", "llms": "https://eliber12.github.io/jepeta-core/llms.txt", "telegram": "https://t.me/jepeta_tools", "fullAgentGuide": "https://eliber12.github.io/jepeta-core/llms-full.txt", "agentsAlias": "https://eliber12.github.io/jepeta-core/agents.json" }, "resources": [ { "name": "free_base_token_risk_preview", "description": "Free pre-trade Base ERC-20 risk preview for agents. Supply one exact token contract address before a swap or buy.", "method": "GET", "url": "https://aitgmgfumsdqecmanrab.supabase.co/functions/v1/jepeta-risk-scan?tokenAddress={{tokenAddress}}", "params": { "type": "object", "required": [ "tokenAddress" ], "properties": { "tokenAddress": { "type": "string", "pattern": "^0x[a-fA-F0-9]{40}$", "description": "Exact Base ERC-20 token contract address to scan" } } } }, { "name": "sample_full_report", "description": "Real paid-deliverable shape captured from a live Jepeta scan; values are a dated sample and can change.", "method": "GET", "url": "https://eliber12.github.io/jepeta-core/sample-full-report.json" } ], "publicPreview": { "schemaVersion": "4.0.0", "limited": true, "method": "GET", "endpoint": "https://aitgmgfumsdqecmanrab.supabase.co/functions/v1/jepeta-risk-scan?tokenAddress={{tokenAddress}}", "decisionEnum": [ "PASS", "WARN", "BLOCK" ], "requiredFields": [ "schema_version", "chain_id", "token_address", "decision", "risk_score", "risk_level", "is_honeypot", "is_mintable", "buy_tax_percent", "sell_tax_percent", "top10_holder_concentration_percent", "top10_holder_count", "lp_locked_percent_observed", "lp_holder_sample_count", "liquidity_usd", "data_quality", "source_status", "warnings", "observed_at", "paid_report" ], "semantics": { "PASS": "No configured BLOCK or WARN condition was observed in the available data. PASS is not a safety guarantee.", "WARN": "One or more material risk or source-quality conditions require review before execution.", "BLOCK": "A configured hard blocker such as a GoPlus honeypot signal was observed." }, "rawMetrics": { "top10_holder_concentration_percent": "Sum of valid percentages in the up-to-10 holder records returned by GoPlus.", "lp_locked_percent_observed": "Sum of locked percentages among the up-to-10 LP-holder records returned by GoPlus. This is observed sample coverage, not a proof that all liquidity is locked.", "buy_tax_percent": "GoPlus buy tax converted to percent; null when unavailable.", "sell_tax_percent": "GoPlus sell tax converted to percent; null when unavailable.", "liquidity_usd": "Liquidity of the largest exact matching Base pair returned by DEX Screener; null when unavailable." }, "booleanGuarantees": { "is_honeypot": "Always boolean in a successful v4 response; if GoPlus cannot determine it, the endpoint returns 422 instead of false.", "is_mintable": "Always boolean in a successful v4 response; if GoPlus cannot determine it, the endpoint returns 422 instead of false." }, "paidOnlyFields": [ "dangerousPermissions", "liquidityRisk", "holderConcentration", "tradingActivity", "full evidence/history context" ], "rateLimit": { "serverSide": true, "clientWindow": "30 requests / 60 seconds per hashed client address", "tokenWindow": "20 requests / 60 seconds per token", "retryHeader": "Retry-After" }, "cache": { "ttlSeconds": 30, "purpose": "Protect upstream GoPlus and DEX Screener quotas and reduce repeated-token latency.", "responseHeader": "X-Jepeta-Cache: HIT | MISS" } }, "productLadder": [ { "name": "Free Preview", "status": "LIVE", "price": "Free", "delivery": "Public GET API / web scanner" }, { "name": "Full Report", "status": "LIVE", "price": "0.03 USDC", "delivery": "Virtuals ACP v2 / token_risk_scan" }, { "name": "Batch / API", "status": "PLANNED", "activationGate": "Enable only after repeated multi-token paid demand and measured unit economics." }, { "name": "Monitoring / Watchlist", "status": "PLANNED", "activationGate": "Enable after recurring risk-monitoring demand is observed." }, { "name": "Agent Subscription", "status": "PLANNED", "activationGate": "Enable after repeat buyers justify a recurring access package." } ] }