ERC-8121 체인 간 함수 호출 훅 (Cross-Chain Function Calls via Hooks)
Draft · 이름·메타데이터 · 2025-12-12 작성
메타데이터 값에 다른 체인의 특정 함수 호출 정보를 자기 설명적으로 담아, 클라이언트가 신뢰할 수 있는 다른 체인의 컨트랙트에서 데이터를 찾아오게 하는 표준입니다.
왜 필요한가
지금은 한 컨트랙트의 메타데이터 값이 다른 체인에 있는 진짜 데이터, 예를 들어 신원증명(PoP)이나 KYC 인증서를 가리키고 싶어도 이를 표준화된 방식으로 표현할 방법이 없습니다. 어떤 체인의 어떤 컨트랙트의 어떤 함수를 어떤 값으로 호출해야 하는지를 바이트나 문자열로 저장하고 문서 없이도 누구나 그대로 해석해 호출할 수 있게 하는 공통 형식이 없었습니다. 그 결과 체인 간 신원·자격 증명 조회는 프로젝트마다 임의의 방식으로 구현되고 AI 에이전트가 읽는 마크다운 같은 일반 텍스트에도 이런 호출 정보를 사람이 읽을 수 있는 형태로 담을 수 없었습니다. 또한 클라이언트가 호출 대상이 신뢰할 만한지 사전에 판단할 근거도 표준화되어 있지 않았습니다.
구현해야 하는 것
function hook( bytes4 functionSelector, string calldata functionSignature, string calldata functionCall, string calldata returnType, bytes calldata target ): 함수 셀렉터를 체크섬으로 포함해 호출할 함수, 매개변수 값, 반환형, 대상 체인·컨트랙트를 모두 지정하는 훅 구조입니다.function hook( string calldata functionSignature, string calldata functionCall, string calldata returnType, bytes calldata target ): 함수 셀렉터 없이 functionSignature를 첫 매개변수로 두는 훅 구조이며 셀렉터는 시그니처에서 계산합니다.
심층 설명
훅의 구성 요소
훅은 functionSelector(선택), functionSignature, functionCall, returnType, target 다섯 요소로 이루어집니다. functionSelector는 시그니처를 해시한 체크섬으로 타입 모호성을 막고 functionSignature는 명시적 타입이 있는 전체 함수 시그니처, functionCall은 값이 채워진 사람이 읽을 수 있는 호출 문자열, returnType은 ABI 디코딩용 반환 튜플 표기, target은 ERC-7930 상호운용 주소로 대상 체인과 컨트랙트를 지정합니다. 이 다섯 요소만으로 훅은 외부 문서 없이도 완전히 해석 가능합니다.
함수 호출 문자열 형식
functionCall은 Solidity 스타일 문법을 씁니다. 문자열 값은 단일 인용부호로 감싸고('value'), bytes·hex 값은 0x 접두사를 쓰며 숫자는 그대로 리터럴로 적고 배열은 대괄호([1,2,3]), 구조체·튜플은 소괄호(('alice', 42, true))로 표기합니다. 이 규칙으로 중첩 구조체를 포함한 복잡한 매개변수도 사람이 읽을 수 있는 한 줄 문자열로 표현할 수 있습니다.
bytes와 string 인코딩, 훅 식별
bytes 저장소에서는 훅을 ABI 인코딩해야 하며 셀렉터 포함 여부에 따라 keccak256("hook(bytes4,string,string,string,bytes)")의 0x037f43ed, 또는 keccak256("hook(string,string,string,bytes)")의 0x6113bfa3를 접두사로 씁니다. string 저장소에서는 "hook(...)" 형태의 리터럴 문자열로 씁니다. 파서는 "hook(" 뒤 첫 매개변수가 0x로 시작하는 8자리 16진수인지 여부로 셀렉터 포함 여부를 판별합니다.
훅 해석 절차(읽기)
클라이언트는 값의 접두사나 "hook(" 뒤 첫 매개변수로 형식을 감지하고 functionSelector·functionSignature·functionCall·returnType·target을 파싱합니다. 셀렉터가 있으면 functionSignature를 해시해 일치하는지 검증하고 불일치 시 거부합니다. target을 ERC-7930으로 디코딩해 체인과 주소를 얻고 대상이 신뢰할 만한지 확인하는 것이 권장(RECOMMENDED)됩니다. functionCall에서 함수명과 인자를 뽑아 functionSignature 타입으로 ABI 인코딩한 뒤, ERC-3668을 반드시 활성화한 상태로 대상 함수를 호출하고 결과를 받습니다. 대상이 신뢰되지 않으면 클라이언트는 훅을 해석하지 않을 수 있습니다(MAY).
쓰기 작업
쓰기도 읽기와 같은 흐름을 따르지만 결과를 조회하는 대신 서명된 트랜잭션을 네트워크에 제출해 블록에 포함시킵니다. 훅이 지정하는 함수, 매개변수, 대상 컨트랙트와 체인은 동일하게 쓰입니다.
셀렉터와 문자열을 함께 쓰는 이유
4바이트 셀렉터는 getData(bytes32)와 getData(bytes)처럼 문자열만으로는 구분되지 않는 타입을 명확히 가리고 문자열은 사람이 읽을 수 있게 합니다. 클라이언트는 셀렉터가 시그니처와 맞는지 검증해 불일치를 오류나 조작 시도로 거부할 수 있습니다. ERC-7930을 쓰는 이유는 체인 정보까지 포함해 훅이 완전한 크로스체인 호출 명세가 되게 하기 위함이며 returnType을 포함하는 이유는 클라이언트가 문서 없이도 반환값 형태를 예측하고 디코딩할 수 있게 하기 위함입니다.
ERC-3668 강제와 보안 고려사항
훅은 ERC-3668(CCIP-Read) 지원을 명시적으로 요구합니다. 일부 클라이언트는 기본적으로 ERC-3668을 꺼두지만 훅과 연결함으로써 전체 기능을 켜지 않고도 신뢰되는 훅 해석에 한해서만 선택적으로 켤 수 있습니다. 보안상 클라이언트는 신뢰 가능한 대상 주소 목록이나 제3자 레지스트리를 유지하고 신뢰되지 않는 대상에서는 해석을 실패시켜야(SHOULD) 합니다. 또한 훅이 다른 훅을 가리켜 무한 루프가 생기는 것을 막기 위해 해석 깊이를 3~5단계 정도로 제한하는 것이 권장됩니다.
상태: Draft
이 제안은 아직 Draft 상태로, 내용이 바뀌거나 중단될 수 있습니다.
쓸 때 주의할 점
- 대상 신뢰: 클라이언트는 신뢰 가능한 대상 컨트랙트 주소 목록을 직접 유지하거나 제3자 레지스트리를 이용해야 하고 신뢰되지 않는 대상을 해석할 때는 실패시켜야 합니다.
- 재귀적 훅: 훅이 다른 훅으로 이어져 무한 루프가 생기는 것을 막기 위해 해석 깊이를 제한해야 하며 3~5단계 정도가 합리적인 한도로 제시됩니다.