ERC-8444 에이전트 자원 온체인 가치 등록 (Agentic Resource Discovery (ARD) Onchain)
Draft · 기타 · 2026-10-12 작성
AI 에이전트가 사고파는 스킬, 작업 의뢰, 에이전트 신원을 온체인 주소에 묶어, 지갑 없는 일반 AI 클라이언트도 ARD 검색만으로 가격과 결제 방식을 확인할 수 있게 하는 온체인 가치 등록 표준입니다.
왜 필요한가
ARD(Agentic Resource Discovery)는 어떤 자원이 존재하고 누가 그렇다고 말하는지만 알려줍니다. 발행자가 도메인 아래 매니페스트에 MCP 서버나 에이전트, 스킬을 나열하면 레지스트리가 모아 검색하게 해 주지만 가격이나 결제 수단, 보증, 에스크로는 다루지 않고 신뢰도 도메인 소유에만 뿌리를 둡니다. 반면 실제로 돈을 받는 쪽은 이미 온체인 주소를 갖고 있습니다. 스킬 토큰은 호출이나 라이선스를 팔고 작업 의뢰 토큰은 토큰 안에 보증금을 에스크로로 걸어 두며 에이전트 신원은 주소에 묶여 활성화됩니다. 그런데 지갑이나 RPC 없이 자연어로만 검색하는 일반 AI 클라이언트는 이런 체인 위 가치 정보를 전혀 볼 방법이 없었습니다. 또한 도메인만 신뢰의 뿌리였기 때문에 키를 가진 적 없는 도메인도 가격을 주장할 수 있었고 토큰이 팔려 소유자가 바뀌어도 예전 설명이 그대로 노출되는 문제가 있었습니다.
구현해야 하는 것
event Registered(bytes32 indexed recordId, bytes32 indexed kind, address indexed target, uint256 id, address attestor, bytes32 descriptorHash, string descriptorURI, string urn);: 새 값 레코드가 등록될 때 발생합니다.event DescriptorUpdated(bytes32 indexed recordId, bytes32 descriptorHash, string descriptorURI, string urn);: 레코드의 디스크립터가 갱신될 때 발생합니다.event StatusChanged(bytes32 indexed recordId, Status status);: 레코드의 상태가 Active, Suspended, Retired 사이에서 바뀔 때 발생합니다.event DomainClaimed(bytes32 indexed domainHash, address indexed controller, string domain);: 어떤 주소가 도메인을 클레임했을 때 발생합니다.event DomainReleased(bytes32 indexed domainHash, address indexed controller);: 주소가 도메인 클레임을 해제했을 때 발생합니다.event KindRegistered(bytes32 indexed kind, address adapter, string uri);: 새 kind와 그 어댑터가 등록될 때 발생합니다.event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);: 레지스트리 인스턴스의 소유권이 넘어갈 때 발생합니다.function register(bytes32 kind, address target, uint256 id, bytes32 descriptorHash, string calldata descriptorURI, string calldata urn) external returns (bytes32 recordId);: 앵커에 대한 새 값 레코드를 등록합니다.function updateDescriptor(bytes32 recordId, bytes32 descriptorHash, string calldata descriptorURI, string calldata urn) external;: 레코드의 디스크립터 해시와 URI, URN을 갱신하고 호출자를 attestor로 기록합니다.function setStatus(bytes32 recordId, Status status) external;: 레코드의 상태를 Active, Suspended, Retired 사이에서 바꿉니다.function claimDomain(string calldata domain) external;: 호출자 주소로 도메인을 직접 클레임합니다.function claimDomainBySig(string calldata domain, address controller, uint256 nonce, uint256 deadline, bytes calldata signature) external;: EIP-712 서명으로 다른 주소를 대신해 도메인 클레임을 제출합니다.function releaseDomain(string calldata domain) external;: 호출자 주소의 도메인 클레임을 해제합니다.function registerKind(bytes32 kind, address adapter, string calldata uri) external;: 새 kind에 어댑터를 연결합니다. 인스턴스 owner만 호출할 수 있고 한 kind당 한 번만 가능합니다.function transferOwnership(address newOwner) external;: 레지스트리 인스턴스의 소유권을 다른 주소로 넘깁니다.function owner() external view returns (address);: 현재 인스턴스 owner 주소를 반환합니다.function recordIdOf(address target, uint256 id) external view returns (bytes32);: 앵커로부터 recordId를 계산해 반환합니다.function recordOf(bytes32 recordId) external view returns (Record memory);: 레코드의 전체 데이터를 반환합니다.function controllerOf(bytes32 recordId) external view returns (address);: 레코드 앵커의 현재 controller를 어댑터에서 조회해 반환합니다.function backed(bytes32 recordId) external view returns (bool);: 레코드 앵커가 backed 상태인지 어댑터에서 조회해 반환합니다.function anchorHintOf(bytes32 recordId) external view returns (bytes32);: 레코드 앵커의 해시 힌트(패키지 다이제스트 등)를 반환합니다.function claimsOf(bytes32 domainHash) external view returns (address[] memory);: 한 도메인을 클레임한 모든 주소 목록을 반환합니다.function hasClaim(bytes32 domainHash, address controller) external view returns (bool);: 특정 주소가 그 도메인을 클레임했는지 반환합니다.function domainHashOf(string calldata domain) external pure returns (bytes32);: 도메인 문자열의 해시를 계산해 반환합니다.function kindAdapter(bytes32 kind) external view returns (address);: 특정 kind에 연결된 어댑터 주소를 반환합니다.function nonces(address controller) external view returns (uint256);: 서명 기반 도메인 클레임에 쓰이는 주소별 현재 nonce를 반환합니다.function DOMAIN_SEPARATOR() external view returns (bytes32);: EIP-712 서명에 쓰이는 도메인 분리자를 반환합니다.function supportsInterface(bytes4 interfaceId) external view returns (bool);: ERC-165에 따라 이 컨트랙트가 특정 인터페이스를 지원하는지 반환합니다.function kind() external view returns (bytes32);: 이 어댑터가 담당하는 kind 식별자를 반환합니다.function exists(address target, uint256 id) external view returns (bool);: 해당 앵커가 실제로 존재하는지 반환합니다.function controllerOf(address target, uint256 id) external view returns (address);: 해당 앵커를 지금 통제하는 주소를 반환합니다.function backed(address target, uint256 id) external view returns (bool);: 해당 앵커가 지금 backed 상태인지 반환합니다.function anchorHint(address target, uint256 id) external view returns (bytes32);: 해당 앵커의 해시 힌트(패키지 다이제스트 등)를 반환합니다.
심층 설명
세 가지 설계 결정
이 ERC는 세 가지를 정합니다. 첫째, 가치의 뿌리는 결제의 뿌리와 같아야 하므로 주소를 유일한 루트로 삼고 도메인은 주소가 모으는 endorsement로 취급합니다. 둘째, ARD는 도메인 기반 URN으로 항목을 식별하지만 값 레코드는 실제로 돈과 에스크로, 신원이 붙는 앵커(CAIP-19 토큰 식별자 또는 CAIP-10 계정 식별자)로 식별하고 URN은 바인딩이 유효할 때만 그 앵커의 캐노니컬 이름이 되는 별칭입니다. 셋째, ARD의 type이 payload 형식을 말하는 반면 값 레코드의 kind는 거래에서 어느 편(제공, 요청, 주체, 색인)인지를 말하는 직교적인 개념입니다.
네 가지 종류(kind)
kind는 keccak256("ard-onchain.kind.<name>")으로 식별되는 값 포스처입니다. skill은 제공(공급) 측으로 토큰 결속 실행형 스킬 토큰을 앵커로 하고 토큰 소유자가 controller입니다. task는 수요 측 작업 의뢰로 토큰 결속 작업 의뢰 토큰을 앵커로 합니다. agent는 주체로서 주소(id=0) 자체를 앵커로 합니다. registry는 색인으로 0이 아닌 id를 가진 운영자 주소를 앵커로 합니다. 레지스트리 인스턴스는 이 네 kind를 모두 지원해야 하며 새 kind는 새로운 포스처에만 대응해야 하고 새 payload 형식 때문에 kind를 늘려서는 안 됩니다.
레코드 식별과 캐노니컬 URN
recordId는 keccak256(abi.encode(block.chainid, target, id))로 계산되며 하나의 앵커는 레코드를 하나만 가질 수 있습니다. 레코드의 동일성은 오직 앵커로 판단하며 URN으로는 판단하지 않습니다. controller가 등록, 갱신 시 URN을 줄 수 있지만 그 URN의 퍼블리셔 도메인과 현재 controller의 바인딩이 verified이고 그 도메인 매니페스트에 같은 identifier가 있을 때만 캐노니컬 이름이 됩니다. 게이트웨이는 자기 도메인 아래 urn:air:G:onchain:<앵커 인코딩> 형식의 별칭으로 레코드를 서빙하며 클라이언트는 identifier가 아니라 value:anchor로 레코드를 비교해야 합니다.
디스크립터의 세 멤버 분류와 해시
디스크립터는 ARD 항목에 value: 멤버를 더한 것으로, 멤버는 세 종류로 나뉩니다. 퍼블리케이션 멤버(@context, @id, identifier, trustManifest)는 누가 게시했는지에 속해 해시 대상이 아닙니다. 해석 멤버(value:anchor 등)는 리졸버가 계산해 붙이는 값으로 역시 해시되지 않습니다. 나머지 콘텐츠 멤버(displayName, type, url/data, description 등 ARD 기본 멤버와 value:kind 등 작성된 value 멤버)만 RFC 8785 JSON 정규화 후 SHA-256으로 해시되어 descriptorHash가 됩니다. 이 덕분에 게이트웨이 별칭 항목과 controller 자신의 항목이 같은 해시로 검증될 수 있습니다.
도메인 클레임과 바인딩 상태
주소는 claimDomain을 직접 호출하거나, EIP-712 서명(DomainClaim 타입, nonce와 deadline 포함)을 받아 claimDomainBySig로 도메인을 클레임합니다. 컨트랙트 계정은 ERC-1271로 검증됩니다. 레지스트리는 클레임만 기록하고 심판하지 않으므로 여러 주소가 같은 도메인을 클레임할 수 있습니다. 도메인이 /.well-known/ard.json의 value:controllers나 value:controller로 그 주소를 인정하면 바인딩은 verified가 되고 인정이 없으면 claimed, 클레임자가 여럿이고 그중 인정된 것이 있으면 나머지는 contested, 클레임이 없으면 unbound입니다. 인정이 사라지면 verified는 claimed나 contested로 내려가고 캐노니컬 URN은 stale이 됩니다.
레벨과 상태
레벨은 레코드가 없으면 L0(dormant, 값 멤버가 있어도 검증 불가), 레코드가 있고 상태가 Active면 L1(anchored), L1이면서 어댑터가 backed로 보고하고 앵커 힌트가 있는 kind는 value:provenance.packageDigest가 앵커 힌트와 같으면 L2(backed)입니다. 상태는 Active, Suspended, Retired 세 가지로 controller가 Active와 Suspended 사이를 오가거나 둘 중 하나에서 Retired로 보낼 수 있으며 Retired는 그 앵커를 쥔 이후의 모든 소유자에게 영구히 적용되는 종결 상태입니다. 레벨과 바인딩 상태는 서로 독립적입니다.
레지스트리와 kind 어댑터 인터페이스
register는 kind에 어댑터가 있고 descriptorHash가 0이 아니며 adapter.exists가 참이고 msg.sender가 adapter.controllerOf와 같으며 그 앵커에 레코드가 없을 때만 성립합니다. updateDescriptor와 setStatus는 레코드가 존재하고 Retired가 아니며 호출 시점에 어댑터가 보고하는 controller와 msg.sender가 같을 때만 허용됩니다. registerKind는 인스턴스 owner만 호출할 수 있고 이미 어댑터가 있는 kind에는 실패해 kind 테이블은 한 번만 쓸 수 있습니다. IARDKindAdapter는 kind, exists, controllerOf, backed, anchorHint 다섯 뷰 함수로 구성되며 절대 revert하지 않고 없는 앵커는 모두 거짓이나 0으로 보고해야 합니다. controller는 레지스트리에 저장되지 않고 매 호출마다 어댑터에서 다시 조회됩니다.
입양(adoption)과 리졸버 서빙 규칙, 그리고 아직 Draft
앵커의 control은 디스크립터를 바꿀 권한일 뿐 지금의 controller가 서빙되는 설명에 책임진다는 뜻은 아닙니다. 레코드는 마지막으로 디스크립터를 커밋한 attestor를 저장하고 attestor가 현재 controller와 같을 때만 adopted입니다. 토큰이 팔리거나 원치 않게 전송되면 레코드는 unadopted가 되어 리졸버가 검색 결과나 목록에 포함시키지 않아야 하며 새 controller가 updateDescriptor를 호출(같은 해시 재커밋도 허용)해야 다시 검색에 노출됩니다. 이 비교는 커밋 트랜잭션을 보낸 주소로만 판단하고 작성된 value:controller 멤버는 쓰지 않습니다. 이 ERC는 현재 Draft 상태로, 아직 확정되지 않았으며 앞으로 내용이 바뀌거나 중단될 수 있습니다.
쓸 때 주의할 점
- 소유권 이전 뒤 미입양 디스크립터: 앵커가 손을 바꿔도 디스크립터는 레코드 안에 그대로 남아, attestor 없이는 넘겨받은 쪽이 원치 않아도 예전 controller의 엔드포인트와 조건, 수취인을 계속 광고하게 됩니다. 리졸버는 attestor가 현재 controller일 때만 레코드를 서빙해야 하며 새 controller는 updateDescriptor로 입양하거나 교체해야 합니다. onchain 결제가 아닌 x402나 declared 레일은 디스크립터에 적힌 payee로 지급되므로 이 확인이 더 중요합니다.
- 디스크립터 치환: descriptorURI는 가져오기 편의를 위한 힌트일 뿐 신뢰 근거가 아닙니다. 리졸버는 가져온 디스크립터의 콘텐츠 해시가 레코드의 descriptorHash와 일치할 때만 받아들여야 하므로, 악의적인 호스트나 손상된 게이트웨이도 controller가 커밋한 내용을 몰래 바꿀 수 없습니다.
- 표시 이름 피싱: 이름, 설명, 심지어 trustManifest까지도 퍼블리셔가 임의로 작성하는 값입니다. 클라이언트는 앵커, 바인딩 상태, 레벨을 함께 보여주고 verified 바인딩만을 도메인 수준의 신뢰 신호로 다뤄야 합니다.
- 영구적인 폐기(Retired): 레코드를 Retired로 바꾸는 것은 되돌릴 수 없고 이후 그 앵커를 쥐는 모든 소유자에게 적용됩니다. 제공을 잠시 멈추고 싶은 controller는 Suspended를 써야 하고 구매자는 앵커를 인수하기 전에 레코드 상태를 확인해야 합니다.
- 도메인 탈취와 인정 만료: 도메인이 주인을 바꾸거나 매니페스트가 바뀌면 인정이 사라져 바인딩이 claimed나 contested로 내려가고 캐노니컬 URN이 stale이 됩니다. 바인딩이 비어 있던 동안 서빙된 내용은 바인딩이 돌아와도 소급해 유효해지지 않습니다.