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).
운영 절차
- 먼저 스캔하십시오. 민트의 모든 확장 기능과 통합 영향도를 식별합니다.
→ scanning.md (실행 가능한
t22-scanCLI) 및 extension-risk-matrix.md (각 확장 기능의 의미). - 프로필별로 결정하십시오. AMM, 볼트, 대출, 에스크로는 각자 허용하는 확장 기능이 다릅니다. 매트릭스 판정(
ALLOW/HANDLE/REJECT)을 사용합니다. - 프로그램을 강화하십시오. 지원하기로 선택한 모든 것에 패턴을 적용합니다:
- 전송 수수료 → transfer-fee-accounting.md
- 전송 훅 → transfer-hook-reentrancy.md
- 영구 위임/동결 → permanent-delegate-and-freeze.md
- 온체인에서 기본 거부 허용 목록 강제 → extension-allowlist-pattern.md
- 테스트로 증명하십시오. 실제 Token-2022 프로그램을 로드하고 가드가 공격을 차단함을 단언하는 LiteSVM 테스트를 작성합니다. → testing.md
- 출처 인용 / 더 깊이 알아보기. → resources.md
라우팅 테이블
| 사용자가 다루는 경우… | 읽을 문서 |
|---|---|
| "이 민트를 통합해도 안전한가?" / 토큰 스캔 | scanning.md, extension-risk-matrix.md |
| 지분/LP/에스크로 금액 오류, "수수료가 내 입금을 먹고 있음" | transfer-fee-accounting.md |
| 전송 훅, 재진입, ExtraAccountMetaList, 전송 시 CPI | transfer-hook-reentrancy.md |
| 영구 위임, 동결 권한, 기본 동결, 환수 | permanent-delegate-and-freeze.md |
| "내 프로그램에서 위험한 민트를 어떻게 거부합니까?" | extension-allowlist-pattern.md |
| Token-2022 에지 케이스 테스트 작성/실행 | testing.md |
| 존재하는 확장 기능과 각각의 위험성 | extension-risk-matrix.md |
| 출처, 감사, DEX 정책, 추가 자료 | resources.md |
이 스킬에 포함된 항목
| 아티팩트 | 경로 | 설명 |
|---|---|---|
| 스캐너 CLI | tools/t22-scan/ | t22-scan <mint> --profile=vault → 확장 기능별 위험 판정 + CI용 종료 코드. 실제 메인넷 민트에 대해 검증됨. |
| 가드 프로그램 | examples/guard/ | 실제 Anchor 1.0 볼트: 온체인 확장 허용 목록 + 델타 측정 수수료 안전 입금 + 재진입 인식 출금. |
| 공격 테스트 | examples/guard/tests/ | 실제 spl_token_2022 프로그램을 로드하는 LiteSVM 테스트, 문제와 가드가 차단함을 증명. |
명령어 및 에이전트
| 트리거 | 기능 |
|---|---|
/scan-mint | 민트 주소를 스캔하고 선택한 프로필에 대한 통합자 위험을 보고합니다. |
/audit-t22-integration | Token-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 테스트를 제공하십시오.