RugShield 402가 Base 토큰 사전 검사 API를 공개했다

RugShield 402는 Base에서 탈중앙화 거래소(DEX) 토큰의 매매 위험을 검사하는 도구다. 제작자는 API와 에이전트 연동 기능을 공개했다. 토큰을 거래하기 전에 세금과 매도 제한, 유동성을 살펴보려는 에이전트 개발자에게 쓸 수 있다.

RugShield 402는 무엇을 검사하나?

자동화된 매매 전에 위험을 점검하는 장치라고 떠올리면 쉽다. RugShield 402는 매수·매도 주문을 시뮬레이션하고, 매매 세금과 코드상의 거래 제한을 확인한다. Base의 Aerodrome과 Uniswap v3 풀 유동성도 조회한다.

검사 결과에는 무엇이 담기나?

유료 POST /v1/scan은 토큰 주소와 체인 ID, 매도 시뮬레이션 여부를 입력받는다. 예시 요청은 다음과 같다.

{
 "token_address": "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed",
 "chain_id": 8453,
 "simulate_sell": true
}

응답에는 허니팟(매수는 가능하지만 매도하기 어렵게 만든 토큰) 여부, 매수·매도 세금, 유동성, 위험 점수와 추천 결과가 포함된다. 문서의 응답 예시는 다음과 같다.

{
 "token": "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed",
 "symbol": "DEGEN",
 "is_honeypot": false,
 "buy_tax_bps": 0,
 "sell_tax_bps": 0,
 "liquidity_usd": 68400,
 "risk_score": 0.02,
 "recommendation": "SAFE_TO_SWAP",
 "attestation": "rugshield_verified_8453_0x4ed4e8_1740000000",
 "timestamp": 1740000000
}

검사 한 번의 가격은 Base 메인넷에서 USDC 0.005달러다. 결제에는 HTTP 402와 EIP-712 전송 승인을 사용한다. 네트워크 식별자는 eip155:8453이며, USDC 주소는 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, 수신 주소는 0x73279fa4BadA7CAC888c62CDa4f5c8104765f6f1이다.

GET /health와 GET /.well-known/x402.json은 무료다. 전자는 컨테이너 상태 확인에, 후자는 x402 규격에 따른 기계 판독용 서비스 정보 제공에 쓰인다.

에이전트에 연결하려면 무엇이 필요한가?

문서는 Claude Desktop이나 Cursor의 MCP 설정에 다음 항목을 추가하도록 안내한다. 개인 키는 환경 변수 BUYER_PRIVATE_KEY에 넣는다.

{
 "mcpServers": {
 "rugshield": {
 "command": "node",
 "args": ["<PATH_TO_RUGSHIELD>/dist/mcp/server.js"],
 "env": {
 "BUYER_PRIVATE_KEY": "0x..."
 }
 }
 }
}

ElizaOS용 플러그인은 거래 실행 전에 /v1/scan을 호출하는 PRE_SWAP_RISK_CHECK 동작을 제공한다. Coinbase AgentKit 플러그인은 rugshield_pre_swap_check 액션 제공자를 제공한다.

RugShield 402에는 /health를 9분마다 호출하는 내부 하트비트 데몬이 있다. 외부에서 지연 없는 상태 확인을 구성하려면 UptimeRobot이나 Cron-Job.org 같은 서비스를 이용해 5~10분 간격으로 호출하라고 안내한다.

curl -s -X GET "https://rugshield-402.onrender.com/health" -H "User-Agent: UptimeRobot/2.0"

프로젝트 저장소에서 설정과 연동 정보를 확인할 수 있다. 문서는 검사 결과의 정확도나 위험 점수 산정 방식, 지원 토큰 범위를 밝히지 않는다.