ERC-7887 토큰화 금고 요청 취소 기능 (Cancelation for ERC-7540 Tokenized Vaults)

Draft · 금고·DeFi · 2025-02-18 작성

ERC-7540 비동기 토큰화 금고에서 대기 중인 예치나 상환 요청을 취소하고, 취소된 자산이나 지분을 돌려받을 수 있게 하는 확장 표준입니다.

왜 필요한가

ERC-7540 비동기 금고에 예치나 상환을 요청하면 자산이나 지분이 Pending 상태로 묶입니다. 장기 실물자산(real-world assets) 풀에서 상환하는 경우처럼 처리까지 오랜 시간이 걸릴 수 있는데, 기존 ERC-7540에는 이 요청을 되돌릴 방법이 없습니다. 사용자가 생각을 바꾸거나 처리가 지연되어도 자산을 빼낼 수 없어 자금이 장기간 묶이는 문제가 생깁니다. 이 표준은 요청을 취소하고 그 결과를 청구하는 절차를 추가해 이 문제를 해결합니다.

심층 설명

취소 요청의 세 단계

취소 요청은 제출 후 Pending, Claimable, Claimed 세 단계를 거칩니다. cancelDepositRequest 또는 cancelRedeemRequest를 호출하면 pendingCancelCancelDepositRequest 또는 pendingCancelRedeemRequest가 true가 되어 Pending 상태가 됩니다. 금고가 내부적으로 취소를 처리하면 claimableCancelDepositRequest 또는 claimableCancelRedeemRequest가 해당 금액만큼 늘어나 Claimable 상태가 됩니다. 이후 claimCancelDepositRequest 또는 claimCancelRedeemRequest를 호출해야 비로소 Claimed 상태가 되며 자산이나 지분이 이동합니다. Claim 단계는 건너뛸 수 없고, 같은 블록 안에서도 취소 호출과 청구 호출을 반드시 따로 해야 합니다. 금고가 먼저 토큰을 사용자에게 밀어 보내는 것(push)은 금지되며 사용자가 직접 당겨 받는 것(pull)만 허용됩니다. 다만 동기식 취소 흐름이라면 Pending을 거치지 않고 곧바로 Claimable로 넘어갈 수 있습니다.

취소 중에는 신규 요청이 차단됩니다

예치 취소 요청이 Pending 상태인 동안에는 같은 controller의 새로운 requestDeposit 호출이 반드시 revert되어야 합니다. 상환 취소 요청이 Pending인 동안에도 새로운 requestRedeem 호출은 마찬가지로 revert됩니다. 이 규칙은 취소가 대기 중인 상태에서 새 요청이 동시에 들어오는 복잡한 상태 조합을 아예 막기 위한 것으로, 통합 서비스가 금고의 현재 상태를 읽기 쉽게 만드는 데 목적이 있습니다.

controller와 operator 권한

cancelDepositRequest, claimCancelDepositRequest, cancelRedeemRequest 호출에서 controller는 반드시 msg.sender와 같아야 하며, 다른 주소가 대신 호출하려면 controller가 그 주소를 operator로 승인해 두어야 합니다. claimCancelRedeemRequest의 입력 파라미터 이름은 owner이지만 본문 설명에서는 동일하게 controller가 msg.sender와 같거나 승인된 operator여야 한다고 규정합니다.

네 가지 이벤트

CancelDepositRequest는 cancelDepositRequest 호출 시, CancelDepositClaim은 claimCancelDepositRequest 호출로 자산을 청구할 때 발생합니다. 마찬가지로 CancelRedeemRequest는 cancelRedeemRequest 호출 시, CancelRedeemClaim은 claimCancelRedeemRequest 호출로 지분을 청구할 때 발생합니다. 각 이벤트는 controller와 requestId를 기록하고, Claim 이벤트는 추가로 receiver와 실제 전달된 assets 또는 shares 수량을 기록합니다. sender는 실제로 함수를 호출한 주소로 controller와 다를 수 있습니다.

ERC-165 인터페이스 식별자

이 표준을 구현하는 컨트랙트는 ERC-165의 supportsInterface를 반드시 구현해야 합니다. 취소 기능이 있는 비동기 예치 금고는 interfaceID 0x8bf840e3에 대해 true를 반환해야 하고, 취소 기능이 있는 비동기 상환 금고는 0xe76cffc7에 대해 true를 반환해야 합니다. ERC-7540 자체가 완전 비동기, 부분 비동기, 완전 동기 흐름을 선택적으로 허용하기 때문에, 이 식별자로 통합 서비스가 하나의 컨트랙트가 어떤 흐름을 지원하는지 구분할 수 있습니다.

ERC-7540과의 하위 호환성

이 인터페이스는 ERC-7540과 완전히 하위 호환됩니다. 기존 ERC-7540 금고에 취소 관련 함수와 이벤트를 추가하는 형태이므로, 취소 기능을 지원하지 않는 기존 금고의 동작을 바꾸지 않습니다.

아직 Draft 상태인 제안입니다

이 문서는 현재 상태가 Draft로, 아직 내용이 바뀌거나 중단될 수 있는 제안 단계입니다.

ERC 원문 · ← ERCs