Community라이팅 & 에디팅github.com

토큰-2022 통합 가드

솔라나 프로그램에서 악의적인 Token-2022 민트를 안전하게 소비할 수 있도록 보호하는 Anchor 가드 및 스캐너입니다. Anchor 1.0 + LiteSVM 기반으로 구축되었으며 Solana AI Kit와 함께 사용됩니다.

토큰-2022 통합 가드란 무엇인가요?

이 스킬은 솔라나 프로그램 개발자가 타사 Token-2022 민트를 안전하게 통합할 수 있도록 설계된 포괄적인 도구 및 패턴 모음입니다. Token-2022는 전송 수수료, 전송 훅, 영구 위임, 동결 등과 같은 확장 기능을 도입하여 프로그램의 가정을 깨뜨리고 자금 손실을 초래할 수 있습니다. 이 스킬은 민트를 스캔하고 위험을 식별하는 CLI(`t22-scan`), 온체인에서 위험한 확장 기능을 차단하는 Anchor 1.0 가드 프로그램, 그리고 LiteSVM 테스트를 통해 공격 시나리오를 증명하고 방어가 효과적으로 작동하는지 확인합니다. AMM, 볼트, 대출 시장, 에스크로, 스테이킹 등 Token-2022를 소비하는 모든 종류의 솔라나 프로그램에 적용 가능하며, 기본 거부(default-deny) 원칙과 함께 제공되는 비협상 규칙을 준수해야 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add mohit-1710/token2022-integration-guard

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Token-2022 통합 가드

작성자/검사자 vs 소비자. 이 키트의 token-2022 자료와 광범위한 토큰 확장 스킬(solana-token-extensions, token-2022-extensions)은 토큰의 작성자 — 확장 기능 선택, 민트 생성, 읽기 전용 민트 검사자 를 위한 것입니다. 이 스킬은 반대 측면입니다: 프로그램이 통제하지 않는 타사 민트를 안전하게 소비하는 방법입니다. 민트는 신뢰할 수 없는 입력입니다. 해당 스킬이 "통합자는 순 금액을 사용해야 합니다" 라고 말하는 곳에서, 이 스킬은 이를 강제하고 테스트합니다 — 지분-지급불능 문제를 증명하고 온체인에서 차단하는 가드 볼트입니다. 엄격하게 상호 보완적입니다; 함께 설치하십시오.

이 스킬을 사용해야 하는 경우

사용자가 Token-2022 민트의 소비 측에 있을 때 사용합니다:

  • AMM, 볼트, 대출 시장, 에스크로, 스테이킹 또는 결제 흐름에 Token-2022 지원 추가.
  • 특정 토큰을 상장/풀링/수락할지 결정("이 민트를 통합해도 안전한가?").
  • "맞지 않는" 지분/LP/에스크로 계산 디버깅(거의 항상 전송 수수료 버그).
  • Token-2022 안전성을 위해 SPL 토큰을 이동하는 Anchor/네이티브 프로그램 검토.
  • 적대적 민트에서도 통합이 살아남는다는 것을 증명하는 테스트 작성.

사용자가 확장 기능이 있는 토큰을 생성하려는 경우, 이는 발행자 측면입니다 — 핵심 token-2022 스킬을 참조하십시오.

한 문단 위협 모델

Token-2022 민트는 전송 동작을 변경하는 확장 기능을 가질 수 있습니다. 통합자는 민트 작성자가 적대적이라고 가정해야 합니다. 위험한 확장 기능: 전송 수수료는 입금된 금액을 보낸 금액보다 적게 만듭니다(1:1 지분 계산 깨짐); 전송 훅은 모든 전송 시 발행자가 제어하는 코드를 실행합니다(재진입, DoS, 계정 주입); 영구 위임자는 언제든지 귀하의 볼트에서 토큰을 이동/소각할 수 있습니다; 기본 계정 상태 = 동결은 새 토큰 계정을 사용 불가능하게 만듭니다; 기밀 전송은 실제 잔액을 회계에서 숨깁니다; 일시 중지 가능은 발행자가 귀하의 출금을 동결할 수 있게 합니다. 기본 거부(default-deny).

운영 절차

  1. 먼저 스캔하십시오. 민트의 모든 확장 기능과 통합 영향도를 식별합니다. → scanning.md (실행 가능한 t22-scan CLI) 및 extension-risk-matrix.md (각 확장 기능의 의미).
  2. 프로필별로 결정하십시오. AMM, 볼트, 대출, 에스크로는 각자 허용하는 확장 기능이 다릅니다. 매트릭스 판정(ALLOW / HANDLE / REJECT)을 사용합니다.
  3. 프로그램을 강화하십시오. 지원하기로 선택한 모든 것에 패턴을 적용합니다:
  4. 테스트로 증명하십시오. 실제 Token-2022 프로그램을 로드하고 가드가 공격을 차단함을 단언하는 LiteSVM 테스트를 작성합니다. → testing.md
  5. 출처 인용 / 더 깊이 알아보기. → resources.md

라우팅 테이블

사용자가 다루는 경우…읽을 문서
"이 민트를 통합해도 안전한가?" / 토큰 스캔scanning.md, extension-risk-matrix.md
지분/LP/에스크로 금액 오류, "수수료가 내 입금을 먹고 있음"transfer-fee-accounting.md
전송 훅, 재진입, ExtraAccountMetaList, 전송 시 CPItransfer-hook-reentrancy.md
영구 위임, 동결 권한, 기본 동결, 환수permanent-delegate-and-freeze.md
"내 프로그램에서 위험한 민트를 어떻게 거부합니까?"extension-allowlist-pattern.md
Token-2022 에지 케이스 테스트 작성/실행testing.md
존재하는 확장 기능과 각각의 위험성extension-risk-matrix.md
출처, 감사, DEX 정책, 추가 자료resources.md

이 스킬에 포함된 항목

아티팩트경로설명
스캐너 CLItools/t22-scan/t22-scan <mint> --profile=vault → 확장 기능별 위험 판정 + CI용 종료 코드. 실제 메인넷 민트에 대해 검증됨.
가드 프로그램examples/guard/실제 Anchor 1.0 볼트: 온체인 확장 허용 목록 + 델타 측정 수수료 안전 입금 + 재진입 인식 출금.
공격 테스트examples/guard/tests/실제 spl_token_2022 프로그램을 로드하는 LiteSVM 테스트, 문제와 가드가 차단함을 증명.

명령어 및 에이전트

트리거기능
/scan-mint민트 주소를 스캔하고 선택한 프로필에 대한 통합자 위험을 보고합니다.
/audit-t22-integrationToken-2022 통합 버그에 대한 프로그램 소스 감사.
에이전트: token2022-integration-auditor구성된 민트를 스캔하고 프로그램에서 transfer vs transfer_checked, 금액 신뢰 계산, 누락된 확장 검사를 검색하는 집중 검토자를 생성합니다.

비협상 규칙 (모든 통합에 적용)

  • 기본 거부. 명시적으로 처리하지 않은 확장 기능은 모두 거부합니다. 알 수 없는 TLV = 거부.
  • 가치 입금에 amount 인수를 절대 신뢰하지 마십시오. 수신된 델타를 측정하십시오(reload() + 잔액 차이) 또는 수수료 구성을 읽고; 수신된 금액을 입금 처리하십시오.
  • 항상 transfer_checked (민트 + 소수점)를 사용하고, 더 이상 사용되지 않는 transfer는 사용하지 마십시오.
  • 토큰 프로그램을 고정하십시오. 공격자가 클래식 토큰 계정을 Token-2022 CPI에 혼합할 수 없도록 token::token_program / associated_token::token_program을 설정하십시오.
  • 상장 시에만이 아니라 사용 시에 다시 검증하십시오. 민트의 전송 훅 프로그램과 수수료는 변경될 수 있습니다.
  • 증명하십시오. 가드 없이는 실패하고 가드와 함께 통과하는 LiteSVM 테스트를 제공하십시오.

관련 스킬