ERC-7683 크로스체인 인텐트 (Cross Chain Intents)
Draft · 기타 · 2024-04-11 작성
체인을 넘나드는 인텐트(원하는 결과) 주문을 솔버가 읽을 수 있는 공통 형식으로 번역하는 리졸버(resolver) 표준입니다. 솔버는 리졸버만 검증하면 여러 인텐트 프로토콜의 주문을 수행할 수 있습니다.
왜 필요한가
체인을 넘나드는 거래에서는 사용자가 원하는 결과만 밝히고 솔버(solver)라는 전문 행위자가 필요한 실행을 대신한 뒤 대가를 받는 인텐트 방식이 쓰입니다. 그런데 주문을 솔버에게 보여 주는 공통 형식이 없으면 솔버의 유동성이 프로토콜별 통합으로 쪼개집니다. 솔버는 프로토콜마다 다른 페이로드 형식, 실행 절차, 결제 방식을 각각 구현해야 하므로 통합 비용이 늘고 공유 솔버 네트워크와 주문 배포 서비스가 약해지며 새로 나온 프로토콜은 경쟁력 있는 실행을 확보하기 어렵습니다. 한편 프로토콜 입장에서는 주문 생성, 자금 승인, 정산 검증, 가격 결정, 에스크로 우선인지 선체결(fill-first)인지 같은 설계가 서로 달라야 할 이유가 있어 전체 과정을 하나로 통일하기도 어렵습니다. 이 표준은 그 중간 지점을 잡아, 솔버가 주문을 소비하는 방식만 표준화하고 나머지 설계는 프로토콜의 자유에 맡깁니다.
구현해야 하는 것
function resolve(bytes calldata payload) external view returns (ResolvedOrder memory);: 프로토콜 고유 페이로드를 해석해 스텝, 변수, 결제, 가정으로 이루어진 ResolvedOrder를 돌려줍니다. 솔버가 eth_call로 호출합니다.function PaymentRecipient() external;: 솔버가 결제를 받고 싶은 계정을 값으로 정하는 변수 역할입니다.function PaymentChain() external;: 솔버가 결제를 받고 싶은 체인의 ID를 값으로 정하는 변수 역할입니다.function StepCaller(uint256 stepIdx) external;: stepIdx번 스텝을 실행할 때 쓸 호출자 계정을 값으로 정하는 변수 역할입니다.function ExecutionOutput(string calldata field, uint256 stepIdx) external;: stepIdx번 스텝의 실행에서 관측한 값(블록 번호, 타임스탬프, 실효 가스가격)을 담는 변수 역할입니다.function Witness(string calldata kind, bytes calldata data, uint256[] calldata variables) external;: kind가 가리키는 오프체인 절차를 data와 다른 변수 값으로 실행해 얻은 결과를 담는 변수 역할입니다.function Query(bytes calldata target, bytes4 selector, bytes[] calldata arguments, uint256 blockNumber) external;: target에 eth_call을 보내 돌려받은 값을 담는 변수 역할입니다. blockNumber가 없으면 최신 블록을 씁니다.function QueryEvents(bytes calldata emitter, bytes1 topicMatch, bytes32 topic0, bytes32 topic1, bytes32 topic2, bytes32 topic3, uint256 blockNumber) external;: emitter의 로그를 토픽으로 걸러 eth_getLogs로 조회한 결과를 담는 변수 역할입니다.function ERC20(bytes calldata token, bytes calldata sender, bytes calldata amountFormula, uint256 recipientVarIdx, uint256 onStepIdx, uint256 estimatedDelaySeconds) external;: onStepIdx번 스텝이 실행되면 sender가 amountFormula 이상의 token을 솔버가 정한 수취 주소로 지급해야 하는 결제입니다.function SpendsERC20(bytes calldata token, bytes calldata amountFormula, bytes calldata spender, bytes calldata recipient) external;: 호출이 caller의 토큰을 amountFormula까지 transferFrom으로 가져갈 수 있다는 속성입니다. 솔버는 잔고와 승인액을 준비해야 합니다.function SpendsGas(bytes calldata amountFormula) external;: 호출이 amountFormula까지 가스를 쓸 수 있다는 속성입니다. 솔버는 그 이상의 가스 한도로 실행해야 합니다.function TimingBounds(string calldata field, bytes calldata lowerBound, bytes calldata upperBound) external;: 호출이 포함될 때 block.number 또는 block.timestamp가 지정 범위 안이어야 한다는 속성입니다.function NeedsStep(uint256 stepIdx) external;: 이 호출이 stepIdx번 스텝에 하드 의존성이 있다는 속성입니다.function NeedsVariable(uint256 varIdx) external;: 이 호출이 varIdx번 변수에 하드 의존성이 있다는 속성입니다.function RevertPolicy(string calldata policy, bytes calldata expectedReason) external;: 호출이 expectedReason으로 시작하는 데이터로 되돌려지면 ignore(실행된 것으로 간주) 또는 abort(주문 전체 중단)로 처리한다는 속성입니다.function Constant(uint256 val) external;: 수식에서 상수 값을 나타냅니다.function Variable(uint256 varIdx) external;: 수식에서 varIdx번 변수를 참조합니다.
심층 설명
리졸버와 오프체인 resolve
프로토콜은 주문을 불투명한 페이로드(바이트열)로 배포하고 이를 해석하는 리졸버 컨트랙트를 온체인에 배포합니다. 솔버는 트랜잭션이 아니라 오프체인 eth_call로 resolve(payload)를 호출해 steps, variables, payments, assumptions 네 배열로 구성된 ResolvedOrder를 받습니다. 해석이 온체인 실행에 포함되지 않으므로 가스 비용 제약 없이 복잡한 디코딩과 검증이 가능합니다. 리졸버는 신뢰의 기준점입니다. 솔버 운영자는 감사, 바운티 등으로 검증한 리졸버 주소를 화이트리스트에 올리고 그 리졸버가 만들어 내는 지시를 신뢰합니다. 리졸버는 주문이 RevertPolicy에 명시된 경우에만 중단될 수 있음을 보증해야 하며 중단 정책이 발동하지 않는 한 실행을 시작한 솔버가 모든 요구사항을 이행하고 모든 결제를 받을 수 있어야 합니다.
Call 스텝과 속성
주문의 요구사항은 스텝 목록과 변수 목록으로 표현됩니다. 스텝은 Call이며 target(상호운용 주소), selector(4바이트 함수 선택자), arguments, attributes로 구성됩니다. 속성으로는 SpendsERC20(호출이 caller의 토큰을 amountFormula까지 transferFrom으로 가져갈 수 있고 솔버가 잔고와 allowance를 보장해야 함), SpendsGas(명시된 가스 한도 이상으로 실행해야 함, 없으면 다른 스텝 실행 전에 시뮬레이션으로 추정 가능), RevertPolicy(expectedReason 접두사와 일치하는 되돌림은 ignore 또는 abort로 처리하며 일치하는 정책 없는 되돌림은 금지), TimingBounds(실행 시점의 block.number 또는 block.timestamp가 하한과 상한 사이여야 함), NeedsStep과 NeedsVariable(하드 의존성 명시)이 있습니다. 하드 의존성은 순환이 없어야 하고 스텝은 의존 대상이 모두 성공적으로 실행된 뒤에만 실행할 수 있습니다.
일곱 가지 변수 역할
변수는 솔버가 정하는 값의 자리표시자이며 한 번 정한 값은 참조되는 모든 곳에서 일관되게 써야 합니다. PaymentRecipient와 PaymentChain은 솔버가 결제를 받고 싶은 계정과 체인 ID이고 StepCaller는 특정 스텝을 실행할 호출자 계정입니다. ExecutionOutput은 실행에서 관측한 값으로 block.number, block.timestamp, receipt.effectiveGasPrice 세 필드를 지원합니다. Witness는 kind가 가리키는 오프체인 절차를 data와 다른 변수 값으로 실행해 얻는 값입니다. Query는 target에 보낸 eth_call의 결과이며 호출이 되돌려지면 안 됩니다. QueryEvents는 eth_getLogs 결과를 EthLog 구조체(emitter, topics, data, blockNumber, transactionHash 등) 배열의 framed ABI 인코딩으로 담습니다. Query와 QueryEvents 모두 blockNumber를 생략하면 최신 블록을 씁니다.
ERC20 결제
주문에는 이행 대가로 이루어질 결제 목록이 들어갑니다. ERC20 결제의 매개변수는 token, sender, amountFormula, recipientVarIdx, onStepIdx, estimatedDelaySeconds입니다. onStepIdx번 스텝이 실행되면 amountFormula가 주는 금액 이상의 token이 sender로부터 지급되어야 하고 결제는 recipientVarIdx번 변수(PaymentRecipient 역할)의 주소 값으로, token이 가리키는 체인에서 전송되어야 합니다. 결제 지연은 높은 확신으로 estimatedDelaySeconds 이내여야 합니다. 수취 주소와 체인을 솔버가 변수로 직접 정하므로 솔버는 자신이 선호하는 곳에서 대가를 받을 수 있습니다.
값 표현과 framed ABI 인코딩
변수에 할당되는 값은 타입이 없고 ABI 인코딩과 정적·동적 크기 여부로만 표현되며 소비하는 문맥이 특정 타입으로 해석합니다(예: SpendsGas의 수식은 uint256). EVM에서 값은 framed ABI encoding으로 나타냅니다. 이는 빈 문자열과 값으로 이루어진 두 요소 튜플의 표준 ABI 인코딩, 즉 Solidity의 abi.encode("", value)가 만드는 바이트열입니다. 동적 크기 값이면 정해진 96바이트 접두사로 시작하고 나머지가 값 자체의 ABI 인코딩입니다. 정적 크기 값이면 32바이트 접두사(값 인코딩 길이에 32를 더한 수)와 0으로 채워진 32바이트 접미사 사이에 값의 인코딩이 들어갑니다. 호출 데이터는 4바이트 함수 선택자 뒤에 인수들의 ABI 인코딩을 이어 붙여 만듭니다.
명명된 가정과 암묵적 가정
리졸버가 스스로 검증할 수 없는 안전 조건은 name과 data를 가진 Assumption 구조체로 명시해 솔버에게 넘깁니다. 솔버는 주문을 이행하기 전에 화이트리스트 대조 등으로 이 가정을 검증해야 합니다. 기반 체인의 라이브니스와 검열 저항성, 그리고 SpendsERC20에 쓰이는 토큰의 라이브니스와 검열 저항성은 암묵적으로 가정될 수 있습니다. 특정 리졸버는 그 밖의 암묵적 가정(예: 특정 프로토콜의 보안)을 추가로 두고 문서화할 수 있으며 솔버는 리졸버를 신뢰하기 전에 그런 암묵적 가정을 모두 검토해야 합니다.
이전 초안에서 바뀐 점
초기 초안은 주문 인코딩(OnchainCrossChainOrder, GaslessCrossChainOrder), 온체인 피드(IOriginSettler.open), 체결 함수(IDestinationSettler.fill)까지 수명주기 전반을 표준화했습니다. 그러나 표준 타입이 구현별 필드로 매개변수화되어 있어 솔버가 결국 프로토콜별 하위 타입을 따로 지원해야 했습니다. maxSpent와 minReceived는 수익의 하한만 제공해 경계가 느슨하면 수익성 있는 주문이 체결되지 않을 수 있었습니다(최악의 경우 maxSpent가 UINT256_MAX). 또한 주문별 에스크로를 전제해 리소스 락 기반의 선체결 프로토콜과 맞지 않았고 큰 콜데이터 구조체와 Open 이벤트로 가스 오버헤드를 강요했습니다. 현재 설계는 표준화 경계를 솔버 대면 해석 인터페이스로 옮겨, 사용자 승인, 주문 생성, 정산 검증, 실행 순서에 대한 프로토콜의 유연성을 보존합니다.
Draft 상태와 의존 표준
이 제안은 2024년 4월 11일에 만들어졌고 현재 Draft 상태입니다. 아직 검토 단계라서 인터페이스와 명세가 바뀔 수 있고 진행이 멈출 수도 있습니다. 실제로 이전 초안에서 표준화 범위가 크게 바뀐 전례가 있으므로 구현 전에 최신 원문과 토론 스레드를 확인하는 편이 좋습니다. 또한 이 표준은 상호운용 주소를 정의하는 ERC-7930을 요구하므로 구현 시 해당 표준도 함께 봐야 합니다.
쓸 때 주의할 점
- 표준이 보증하는 범위: 이 표준은 프로토콜이 주문을 솔버에게 설명하는 방식만 표준화하며 주문을 최종 정산하는 프로토콜의 보안을 표준화하거나 보증하지 않습니다. 지시를 따르는 것이 안전한지는 리졸버 구현, 정산 컨트랙트, 관련 자산, 프로토콜이 쓰는 오프체인·크로스체인 시스템에 달려 있습니다.
- 암묵적 가정의 문서화: 리졸버 구현은 이 표준이 허용하는 범위를 넘어 의존하는 암묵적 가정을 문서화해야 합니다. 그래야 솔버와 감사자가 해석된 주문에 포함된 명시적 가정과 함께 평가할 수 있습니다.
- 위험 구간은 결제 확정까지: 솔버는 자본, 승인, 트랜잭션을 주문에 투입한 시점부터 기대한 결제가 최종 확정되어 쓸 수 있게 될 때까지 위험에 노출됩니다. 보안 분석은 프로토콜 상태, 체인 상태, 토큰 동작, 오라클 값, 권한, 메시지 전달 경로에 대한 적대적 변화까지 포함해 실행과 정산의 전 구간을 다뤄야 합니다.
- 감사의 초점: 감사는 리졸버 지시를 올바르게 따르는 솔버가 불안전한 위치로 유도될 수 있는지에 집중해야 합니다. 솔버 안전에 필요한 요구사항이 리졸버나 프로토콜에서 강제되거나 가정으로 드러나는지, 실행 스텝이 공개된 범위를 넘어 솔버 자산을 쓰거나 권한을 요구하거나 의무를 만들지 않는지, 솔버가 비용을 치른 뒤 결제 경로가 무효화될 수 없는지를 검증해야 합니다.