ERC-8107 ENS 에이전트 신뢰 레지스트리 (ENS Trust Registry for Agent Coordination)
Review · 서명·인증 · 2025-12-16 작성
ENS 이름을 식별자로 삼아 에이전트 사이의 신뢰 보증을 온체인에 기록하고 신뢰 경로를 검증해 ERC-8001 다자 조율의 참가 자격을 가리게 하는 표준입니다.
왜 필요한가
ERC-8001은 여러 에이전트가 함께 움직이는 다자 조율의 최소 기능만 정의하고 평판과 신뢰 판단은 모듈로 미뤄 두었습니다. 그래서 조율을 시작하려는 에이전트는 "이 에이전트를 조율에 끼워도 되는가", "이 에이전트가 다른 에이전트를 보증한 판단을 믿어도 되는가"라는 질문에 답할 공통 방법이 없습니다. 중앙 등록 기관을 두면 처음 보는 에이전트와 신뢰를 시작하는 문제는 풀리지만 단일 운영 주체에 기대게 됩니다. 주소를 그대로 식별자로 쓰면 키를 바꿀 때 쌓아 온 신뢰 기록이 끊어지는 문제도 있습니다. 이 표준은 25년 넘게 검증된 OpenPGP의 웹 오브 트러스트(web of trust) 모델을 가져와, 키 교체에도 살아남는 ENS 이름을 식별자로 신뢰를 기록하고 경로를 따라 전파하게 합니다.
구현해야 하는 것
event NoncesInvalidated(bytes32 indexed trustorNode, uint64 newNonce): 트러스터가 미제출 attestation을 무효화할 때 발생합니다.event IdentityGateRemoved(address indexed coordinator, bytes32 indexed coordinationType): 신원 게이트가 제거될 때 발생합니다.function invalidateNonces(bytes32 trustorNode, uint64 newNonce) external: 논스 하한을 올려 서명됐지만 제출되지 않은 모든 attestation을 무효화합니다. 컨트롤러만 호출합니다.function getNonce(bytes32 trustorNode) external view returns (uint64): 트러스터의 현재 논스를 돌려줍니다.function removeIdentityGate(bytes32 coordinationType) external: 호출자의 해당 조율 타입 게이트를 제거합니다.function resolveAgent(bytes32 node) external view returns (address agent): 노드의 정방향 주소 레코드를 안전하게 읽어 에이전트 주소를 돌려주고 없으면 zero address를 돌려줍니다.
심층 설명
신뢰 레벨 4단계와 전이 규칙
레벨은 Unknown(0), None(1), Marginal(2), Full(3) 네 단계의 enum으로 고정됩니다. 각 레벨에 도달하는 길은 하나씩입니다. Marginal과 Full은 더 높은 논스를 가진 유효한 attestation으로만, None은 revokeTrust나 revokeTrustBatch로만 도달합니다. Unknown은 기본값이고 다시 지정할 수 없으며 한번 만들어진 관계는 저장소에서 지워지지 않습니다. 따라서 setTrust는 레벨이 Unknown이나 None인 attestation을 거부해야 합니다. 철회는 영구적이지 않아서 더 높은 논스의 새 attestation으로 None에서 Marginal이나 Full로 되돌릴 수 있습니다. 어떤 레벨 전이도 거부 플래그를 바꾸지 않고 거부 플래그 변경도 레벨을 바꾸지 않습니다.
OpenPGP 모델과의 차이
RFC 9580 OpenPGP 웹 오브 트러스트의 신뢰 레벨과 인증 경로 모델을 가져오되, 유효성 계산은 가져오지 않습니다. OpenPGP는 완전 신뢰 서명 하나 또는 부분 신뢰 서명 여러 개가 모이면 키를 유효하다고 보지만 verifyPath는 경로 하나만 검사하고 그 경로의 모든 간선이 minEdgeTrust를 충족해야 합니다. Marginal 보증 여러 개를 합산하는 규칙은 정의하지 않습니다. 대응 관계는 공개 키가 ENS 이름, 키 서명이 trust attestation, 소유자 신뢰 레벨이 TrustLevel enum, 키 유효성이 조율 참가 자격, 인증 경로가 에이전트들을 거치는 신뢰 사슬입니다.
철회와 거부는 별개의 판단
레코드마다 레벨과 독립된 거부(denial) 플래그가 있습니다. 철회는 자기 보증 하나, 즉 간선 하나만 지우므로 다른 에이전트의 보증을 거치는 경로는 그대로 유효합니다. 거부는 트러스터 자신의 판단 안에서 다른 에이전트의 보증까지 무시하고 그 상대를 막습니다. setTrust 계열은 거부 플래그를 바꾸면 안 되고 setDenial과 clearDenial은 레벨·만료 등 다른 저장 필드를 바꾸면 안 됩니다. 유효 거부는 범용 스코프 bytes32(0)의 플래그와 해당 스코프 플래그의 OR로 계산하며 스코프 플래그가 false라도 범용 true를 뒤집지 못합니다. clearDenial은 검토 시점의 expectedNonce를 받아 그 뒤 attestation이 기록됐으면 NonceChanged로 되돌리고 미제출 서명이 있을 수 있으면 먼저 invalidateNonces로 하한을 올린 뒤 검토하라고 권고합니다.
ENS 통합과 NameWrapper 처리
에이전트 식별자는 ERC-137 네임해시입니다. 래핑된 이름은 레지스트리의 owner가 NameWrapper 컨트랙트로 나오므로, controllerOf는 NameWrapper의 ownerOf가 가리키는 ERC-1155 보유자를 실제 컨트롤러로 풉니다. nameWrapper 주소는 배포 시 고정해야 하고 이후 변경을 허용하면 안 됩니다. 적대적 컨트랙트가 그 자리에 들어오면 모든 래핑 이름의 통제권을 주장할 수 있기 때문입니다. 래핑된 .eth 2차 이름은 NameWrapper 만료(보통 등록 만료에 90일 유예를 더한 시점)가 지나면 컨트롤러가 zero address가 되어 서명 권한을 잃지만 래핑되지 않은 이름은 만료 뒤에도 레지스트리 owner가 유지됩니다. 이름이 이전되면 새 컨트롤러가 기존 신뢰 관계를 물려받으므로, 중요한 스코프의 attestation에는 최대 90일의 짧은 만료를 권장합니다.
서명 권한과 운영자 권한의 분리
attestation은 이름 컨트롤러(controllerOf)가 서명해야 하고 컨트롤러가 컨트랙트면 ERC-1271로 검증합니다. 구현은 ECDSA 복구를 먼저 시도하고 high-s 가변 서명은 거부하며 실패하면 코드가 있는 컨트롤러에 한해 ERC-1271로 넘어갑니다. EIP-7702 위임으로 코드가 생긴 EOA를 바로 ERC-1271로 보내면 유효한 서명을 거부하게 되기 때문입니다. isApprovedForAll로 승인된 운영자는 revokeTrust와 revokeTrustBatch는 호출할 수 있지만 setDenial, clearDenial, invalidateNonces는 호출하면 안 됩니다. 거부는 보증 서명과 같은 수준의 권한이고 invalidateNonces는 모든 트러스티와 스코프의 미제출 attestation을 무효화하는 광역 효과이기 때문입니다. 유효한 setTrust 서명은 아무 주소나 제출할 수 있습니다.
경로 검증 파라미터와 게이트 제약
ValidationParams는 maxPathLength(1~10, 간선 수 기준이라 직접 신뢰는 길이 1), minEdgeTrust(Marginal 또는 Full만 허용), scope, enforceExpiry, requiredAnchors(최대 10개)로 구성됩니다. 기본값은 maxPathLength 5, minEdgeTrust Marginal, 범용 스코프, enforceExpiry true, 앵커 없음입니다. verifyPath와 setIdentityGate는 같은 루틴으로 이 제약을 검사합니다. setIdentityGate는 추가로 앵커가 있는데 maxPathLength가 2 미만인 게이트를 UnsatisfiableAnchors로 거부합니다. 중간 노드만 앵커를 충족할 수 있어 간선 하나짜리 경로는 앵커를 지날 수 없기 때문입니다. verifyPath는 이 추가 검사를 하지 않고 그런 파라미터에는 false를 반환합니다. 간선 검사, 검증자 거부 검사, 앵커 제약을 모두 통과해야 true이고 부분 성공은 없습니다.
ERC-8001 연동과 주소 해석
게이트는 (msg.sender, coordinationType) 키로 저장되어 호출자가 자기 네임스페이스를 가지므로 별도 인가가 필요 없고, 잘 알려진 조율 타입 상수를 선점당할 일도 없습니다. ERC-8001은 참가자를 주소로 식별하므로 노드의 정방향 addr 레코드가 이름과 주소를 잇습니다. resolveAgent는 리졸버에 50,000 가스만 전달하는 저수준 호출로 addr를 읽고, 리졸버가 revert하거나 32바이트 미만을 반환하거나 첫 워드의 상위 96비트가 0이 아니면 zero address를 반환하며 리졸버 때문에 revert하면 안 됩니다. 오프체인 리졸버(CCIP-Read)는 온체인 검증에 쓸 수 없으므로 온체인 게이트를 통과하려는 에이전트는 가스 한도 안에서 응답하는 온체인 addr 레코드를 게시해야 합니다. validateParticipantAddress는 경로 끝 노드가 참가자 주소로 해석되는지와 그 노드에 컨트롤러가 있는지도 확인합니다.
논스 규칙, 인터페이스 식별자, 제안 상태
논스는 트러스터 단위로 증가하며 새 attestation의 논스는 현재 논스보다 커야 하고 2**32보다 크게 건너뛰면 NonceJumpTooLarge로 거부됩니다. 철회만으로는 이미 서명했지만 제출되지 않은 attestation이 무효화되지 않으며 그 일은 invalidateNonces가 합니다. 인터페이스는 ERC-165로 탐지하고 ITrustRegistry의 식별자는 0x94f0ee34입니다. 이전 초안의 식별자 0x42b46ef5와 0x31f35e83에는 true를 반환하면 안 되고 이전 초안의 ITrustRegistryExtended(0x93e686a3)는 이번 판에서 정의하지 않습니다. 이 제안은 현재 Review 상태라 내용이 아직 바뀔 수 있습니다.