ERC-7794 크로스체인 그랜트 레지스트리 (Grant Registry)
Draft · 기타 · 2024-10-22 작성
여러 블록체인에 걸친 그랜트(지원금)의 등록, 참여자, 마일스톤, 자금 지급 상태를 하나의 레지스트리 컨트랙트에서 표준화된 이벤트로 추적하게 합니다.
왜 필요한가
그랜트 프로그램마다 인터페이스와 관리 방식이 제각각이어서 자금 지원자와 수혜자 모두 서로 다른 절차를 익혀야 하고, 여러 체인에 걸쳐 진행되는 그랜트의 데이터를 한곳에서 모으기 어렵습니다. 마일스톤 진행 상황이나 자금 지급 여부를 표준화된 방법으로 기록할 수 없어 투명성이 떨어지고, 프로그램 간 비교나 성과 분석도 힘듭니다. 수혜자 팀 구성이 바뀌어도 이를 온체인에서 일관되게 남길 방법이 없어 외부 프로토콜이 그랜트 데이터를 신뢰성 있게 활용하기도 어렵습니다.
구현해야 하는 것
event GranteeAdded(bytes32 indexed grantId, address indexed grantee);: 그랜트에 새 수혜자가 추가되었을 때 발생합니다.event GranteeRemoved(bytes32 indexed grantId, address indexed grantee);: 그랜트에서 수혜자가 제거되었을 때 발생합니다.event StartDateSet(bytes32 indexed grantId, uint256 startDate);: 그랜트의 시작일이 설정되었을 때 발생합니다.event MilestoneDateAdded(bytes32 indexed grantId, uint256 milestoneDate);: 그랜트에 새 마일스톤 날짜가 추가되었을 때 발생합니다.event MilestoneDateRemoved(bytes32 indexed grantId, uint256 milestoneDate);: 그랜트에서 마일스톤 날짜가 제거되었을 때 발생합니다.event DisbursementRemoved(bytes32 indexed grantId, uint256 milestoneDate);: 특정 마일스톤의 자금 지급 정보가 삭제되었을 때 발생합니다.event ExternalLinkAdded(bytes32 indexed grantId, string link);: 그랜트에 오프체인 문서 등 외부 링크가 추가되었을 때 발생합니다.event ExternalLinkRemoved(bytes32 indexed grantId, string link);: 그랜트에서 외부 링크가 제거되었을 때 발생합니다.function transferOwnership(bytes32 grantId, address newGrantManager) external;: 그랜트의 관리 권한을 새 grantManager 주소로 이전합니다.function addGrantee(bytes32 grantId, address grantee) external;: 그랜트에 새 수혜자 주소를 추가합니다.function removeGrantee(bytes32 grantId, address grantee) external;: 그랜트에서 수혜자 주소를 제거합니다.function setStartDate(bytes32 grantId, uint256 startDate) external;: 그랜트의 시작일을 설정합니다.function addMilestoneDate(bytes32 grantId, uint256 milestoneDate) external;: 그랜트에 새 마일스톤 날짜를 추가합니다.function removeMilestoneDate(bytes32 grantId, uint256 milestoneDate) external;: 그랜트에서 마일스톤 날짜를 제거합니다.function removeDisbursement(bytes32 grantId, uint256 milestoneDate) external;: 특정 마일스톤의 자금 지급 정보를 삭제합니다.function addExternalLink(bytes32 grantId, string memory link) external;: 그랜트와 관련된 오프체인 문서 URL 등 외부 링크를 추가합니다.function removeExternalLink(bytes32 grantId, uint256 index) external;: 배열 인덱스로 지정한 외부 링크를 제거합니다.function getGrant(bytes32 grantId) external view returns (Grant memory);: id, chainid, community 라벨이 담긴 그랜트의 불변 정보를 조회합니다.function getGrantManager(bytes32 grantId) external view returns (address);: 현재 그랜트 매니저의 주소를 조회합니다.
심층 설명
식별자와 데이터 구조 분리
그랜트는 id, chainid, community로 구성된 불변 식별 정보와, grantManager·grantees·마일스톤·디스버스먼트·외부 링크로 구성된 가변 정보로 나뉩니다. grantId는 id, chainid, community, block.timestamp를 keccak256으로 해시해 생성되므로 등록 시점마다 고유하게 결정됩니다. community는 빈 문자열일 수 없고 grantManager는 0 주소일 수 없으며, 이미 등록된 grantId는 다시 등록할 수 없습니다(GrantAlreadyRegistered).
그랜트 매니저 권한 모델
transferOwnership, addGrantee, removeGrantee, setStartDate, addMilestoneDate, removeMilestoneDate, addDisbursement, removeDisbursement, setDisbursementStatus, addExternalLink, removeExternalLink는 모두 현재 grantManager만 호출할 수 있습니다. 참조 구현의 _requireManager는 msg.sender가 grantManager와 다르면 InvalidGrantManager로 되돌립니다. 소유권은 transferOwnership으로 다른 주소에 넘길 수 있으며, 새 주소 역시 0 주소일 수 없습니다.
수혜자(그랜티) 관리
grantees는 EnumerableSet.AddressSet으로 관리되어 중복 추가를 막고 목록 조회와 삭제를 지원합니다. 이미 추가된 주소를 다시 addGrantee하면 GranteeAlreadyAdded, 존재하지 않는 주소를 removeGrantee하면 GranteeNotFound가 발생합니다. 0 주소는 그랜티로 추가할 수 없습니다.
마일스톤과 시작일
setStartDate로 그랜트 시작일을 기록하고, addMilestoneDate와 removeMilestoneDate로 EnumerableSet.UintSet에 마일스톤 날짜를 추가하거나 삭제합니다. 이미 존재하는 날짜를 다시 추가하면 MilestoneDateAlreadyAdded, 존재하지 않는 날짜를 삭제하거나 참조하면 MilestoneDateNotFound가 발생합니다. getMilestonesDates는 시작일과 마일스톤 날짜 배열을 함께 반환합니다.
마일스톤별 자금 지급(디스버스먼트)
addDisbursement는 특정 milestoneDate에 fundingToken과 fundingAmount를 기록하며 기존 값을 덮어씁니다. 호출 전 해당 milestoneDate가 그랜트에 존재해야 하며, 없으면 MilestoneDateNotFound가 발생합니다. setDisbursementStatus는 isDisbursed 플래그만 갱신해 실제 지급 여부를 표시하고, removeDisbursement는 해당 마일스톤의 디스버스먼트 데이터를 삭제합니다.
외부 링크를 통한 오프체인 연동
addExternalLink로 그랜트 관련 URL을 문자열 배열에 추가할 수 있으며 빈 문자열은 InvalidExternalLink로 거부됩니다. removeExternalLink는 배열 인덱스로 링크를 제거하는데, 참조 구현은 마지막 요소를 해당 인덱스로 옮기고 배열을 pop하는 방식으로 구현되어 있어 링크 순서가 보존되지 않습니다. 인덱스가 배열 범위를 벗어나면 InvalidIndex가 발생합니다.
오프체인 자금 지급 프로그램과의 모듈성
Rationale에 따르면 모든 그랜트 프로그램이 온체인으로 자금을 지급하지는 않으므로, 디스버스먼트 상태(isDisbursed)만 레지스트리에 기록하고 실제 지급은 외부 링크나 오프체인 절차로 처리할 수 있도록 설계되었습니다. 이로써 온체인 지급과 오프체인 지급 프로그램 모두 같은 레지스트리에서 상태를 추적할 수 있습니다.
표준 상태
이 ERC는 현재 Draft 상태로, 아직 커뮤니티 검토와 변경을 거치는 중인 제안입니다.