Uniswap V4: 후크를 사용하는 방법은 무엇입니까? (고급 기능)

Uniswap V4의 후크 이해

1. 후크는 Uniswap V4 풀에 직접 내장된 모듈식, 사용자 정의 가능한 논리 확장으로, 개발자가 스왑, 유동성 프로비저닝 및 수수료 징수 중 특정 지점에 사용자 정의 동작을 주입할 수 있도록 합니다.

2. V3의 정적 수수료 계층 또는 불변 풀 매개변수와 달리 V4에서는 핵심 프로토콜의 신뢰 최소화 설계를 변경하지 않고도 스왑 실행, 유동성 추가/제거 또는 수수료 수확과 같은 핵심 작업 전후에 후크를 실행할 수 있습니다.

3. 각 후크는 beforeSwap , afterSwap , beforeAddLiquidity 및 afterRemoveLiquidity 와 같은 필수 기능을 정의하는 IHook 인터페이스를 준수하는 별도의 스마트 계약으로 구현됩니다.

4. 풀은 지정된 후크 주소로 배포되어야 합니다. 일단 설정되면 풀이 다시 초기화되지 않는 한 후크를 변경할 수 없습니다. 이는 불변성과 감사 가능성을 보장하는 의도적인 제약입니다.

5. 후크 계약은 온체인에서 검증되며 DoS 벡터를 방지하고 간결하고 결정론적인 논리를 적용하기 위해 각 콜백에 대해 엄격한 가스 제한을 통과해야 합니다.

사용자 정의 후크 계약 배포

1. 개발자는 사용 사례와 관련된 필수 콜백에만 초점을 맞춰 IHook을 구현하는 Solidity 코드를 작성합니다. 예를 들어 가격 오라클 검증 후크는 오프체인 참조에서 0.5% 이상 벗어나는 거래를 거부하기 위해 beforeSwap 만 구현할 수 있습니다.

2. 후크 계약에는 호출자가 후크를 배포할 권한이 있는 경우 true를 반환하는 verifyHook 함수가 포함되어야 합니다. 배포는 종종 거버넌스 또는 다중 서명 지갑으로 제한됩니다.

3. 컴파일하려면 Uniswap의 검증된 컴파일러 설정과 호환되는 EVM 호환 바이트코드를 대상으로 해야 합니다. 편차가 있으면 풀 생성 중에 배포 실패가 발생합니다.

4. 성공적으로 배포되면 후크 주소가 토큰 주소, 수수료 계층 및 틱 간격과 함께 createPool 함수에 매개변수로 전달됩니다.

5. 일단 활성화되면 해당 풀과의 모든 상호 작용은 등록된 후크를 통해 자동으로 라우팅됩니다. 표준 트랜잭션 서명 외에는 사용자 측 구성이나 지갑 승인이 필요하지 않습니다.

실제 후크 사용 사례

1. 동적 수수료 조정 : 후크는 온체인 변동성 지표를 모니터링하고 높은 미끄러짐 상황에서 수수료 비율을 높이고, 안정이 재개되면 기본 요율로 되돌아갑니다.

2. 유동성 잠금 시행 : 유동성 제거 전 후크는 해당 포지션이 최소 72시간 동안 활성 상태인지 확인하고 단기 투기를 억제하기 위해 조기 종료를 거부합니다.

3. 규정 준수 필터링 : 온체인 KYC 오라클은 beforeAddLiquidity 내부에서 쿼리됩니다. 규제 기관이 허용하지 않은 주소는 참여가 거부됩니다.

4. 수수료 재분배 논리 : 각 스왑 후 후크는 수집된 수수료를 가로채고 실시간 APY 계산을 기반으로 스테이킹 보상 계약에 일부를 전달합니다.

5. 포지션 상태 모니터링 : afterSwap 중에 후크는 집중된 유동성 포지션의 업데이트된 LTV 비율을 계산하고 임계값이 위반되면 청산 신호를 트리거합니다.

후크 통합에 대한 보안 고려 사항

1. 후크는 풀의 전체 실행 컨텍스트를 상속합니다. 즉, 악의적이거나 버그가 있는 논리는 유동성을 동결시키고, 수수료를 낭비하거나, 틱 데이터 구조를 손상시킬 수 있습니다.

2. 재진입은 명시적으로 허용되지 않습니다. Uniswap V4 런타임은 후크 콜백에 대한 비재진입 항목을 강제하여 풀 상태 수정 함수에 대한 재귀 호출을 방지합니다.

3. 가스 사용량은 콜백당 200,000단위 미만으로 유지되어야 합니다. 이 한도를 초과하면 기본 스왑 또는 유동성 작업을 포함하여 전체 거래가 되돌려집니다.

4. 모든 후크 저장소 쓰기는 후크의 자체 계약 저장소에 격리됩니다. 풀 저장소에 대한 직접 액세스는 허용되지 않으므로 문제의 분리가 유지됩니다.

5. 후크에 의한 외부 호출은 체인링크 가격 피드 또는 ENS 확인자와 같은 사전 승인된 인터페이스로만 제한됩니다. 임의의 외부 계약 호출은 프로토콜 수준에서 차단됩니다.

자주 묻는 질문

Q: 단일 후크를 여러 Uniswap V4 풀에서 재사용할 수 있습니까? 예. 후크 계약은 IHook을 준수하고 각 풀 생성 중에 유효성 검사를 통과하는 한 여러 풀에서 참조할 수 있습니다.

Q: 풀이 배포된 후 후크를 업그레이드할 수 있습니까? 아니요. 후크 주소는 풀의 불변 초기화 매개변수에 포함됩니다. 업그레이드하려면 업데이트된 후크 주소를 사용하여 새 풀을 배포해야 합니다.

Q: 후크는 MetaMask 또는 Rabby와 같은 지갑의 프런트엔드 UI 동작에 영향을 줍니까? 직접적으로는 아닙니다. 지갑은 표준 스왑 인터페이스를 표시합니다. 그러나 후크가 조건부 되돌리기(예: 특정 주소에 대한 스왑 차단)를 도입하는 경우 dApp이 후크별 오류 구문 분석을 통합하지 않는 한 트랜잭션은 자동으로 실패합니다.

Q: 공개적으로 사용할 수 있는 공식 Uniswap 관리 후크가 있습니까? Uniswap Labs는 uniswap-v4-hooks 저장소 아래 GitHub에 기본 수수료 누산기 및 시간 고정 유동성 후크를 포함한 참조 구현을 게시했으며 모두 MIT 라이선스를 받고 감사를 받았습니다.