ERC-7845 범용 오케스트레이터 RPC (Universal Orchestrator RPC)

Draft · 계정·지갑 · 2024-11-07 작성

지갑이나 음성 비서 같은 임의의 시스템이 "무엇을 하고 싶다"는 요청(문제)을 공통 형식으로 오케스트레이터에 보내고 실행할 트랜잭션 묶음(해법)을 돌려받는 요청·응답 데이터 규격을 정합니다.

왜 필요한가

여러 체인에 걸친 자산 이동이나 교환을 대신 설계해 주는 중개 시스템, 즉 오케스트레이터(Orchestrator)는 저마다 다른 모양의 요청 형식을 요구할 수 있습니다. 데이터 규격이 제각각이면 지갑이나 앱이 오케스트레이터마다 따로 연동 코드를 짜야 하고 오케스트레이터 간 상호운용도 어려워집니다. 원문은 인공지능 비서, 음성으로 조작하는 기기, 확장현실(XR) 플랫폼이 늘어나면서 오케스트레이터가 점점 많아질 것으로 보고 지갑이 보내는 요청 객체의 최소한의 모양과 요건을 표준화하자고 제안합니다. 이렇게 하면 온체인 트랜잭션을 직접 만들 줄 모르거나 블록 생성 구조를 깊이 알지 못하는 개발자도 탈중앙 앱을 더 쉽게 만들 수 있다는 것이 제안의 동기입니다.

심층 설명

요청 구조: RPC와 Problem

요청은 이더리움 JSON-RPC의 최상위 형태를 그대로 따릅니다. Rpc 객체는 id(임의 번호), jsonrpc(보통 "2.0"), method(기본값으로 orchestrator_findSolutions 사용 가능), params를 가지며 params는 Problem 배열로 필수입니다. Problem은 필수 속성이 actions 하나뿐인 의도적으로 성긴 구조로, 향후 네트워크 업그레이드나 다른 표준이 속성을 추가할 여지를 남겼습니다. 선택 속성 chainId를 생략하면 1(이더리움 메인넷)로 간주해야 합니다(MUST). 오케스트레이터의 외부 인터페이스는 JSON을 써야 하며 이 표준은 오케스트레이터 내부 자료구조나 통신 계층을 표준화하려는 것이 아닙니다.

Action: 무엇을 해 달라는 것인지

Action은 from(이 작업의 지갑 주소, 필수)과 towards(Asset 또는 Destination의 배열, 필수)로 대상을 정하고 with(지갑이 내놓을 의향이 있는 Offering 배열, 선택)로 지불 수단을 정합니다. with가 비어 있으면 오케스트레이터는 해당 주소의 모든 자산을 Offering 후보로 고려해야 합니다(MUST). type은 transfer, swap, call 같은 분류 힌트로, 없으면 transfer로 간주해야 합니다(MUST). functionCallName이 지정되면 스마트 컨트랙트 호출을 원하는 Action으로 볼 수 있고 functionCallData는 그 호출의 데이터입니다. functionCallData만 있고 functionCallName이 없으면 무시해야 합니다(SHOULD). deadline은 해법이 나와야 하는 시한을 지갑이 유닉스 타임스탬프로 정하는 선택 속성입니다.

Asset과 Destination: 체인 추상화와 고정 타깃

towards에는 두 종류가 올 수 있습니다. Asset은 symbol, address, chainId가 모두 선택이며 체인 추상화를 선호합니다. symbol이 없으면 address를 써야 하고 address가 없으면 네이티브 가스 토큰을 써야 하며(MUST), chainId가 없으면 오케스트레이터가 아무 체인의 대응 자산이나 자유롭게 써도 됩니다. 반면 Destination은 address와 chainId가 모두 필수로, 오케스트레이터의 해석이 개입해서는 안 되는(MUST NOT) 직접 지정 타깃에 씁니다. 참고 구현 예시에서도 Destination의 chainId를 137로 지정하면 작업이 그 체인에 고정됩니다.

Offering: 무엇을 얼마나 내놓을지

Offering은 요청자가 작업 해결을 위해 지갑에서 쓸 의향이 있는 자산입니다. symbol과 address는 지정하는 것이 바람직하며(SHOULD), symbol이 없으면 address를, address가 없으면 네이티브 가스 토큰을 써야 합니다(MUST). amount는 선택이고 number면 이더 단위, string이면 큰 수(BigNumber)용이며 없으면 해당 주소·심볼·네이티브 가스 단위의 최대값을 가정해야 합니다. chainId가 없을 때는 address를 쓰면 안 되고 symbol을 써야 하며 상위 Problem에도 chainId가 없으면 오케스트레이터가 아무 체인의 대응 자산이나 써서 작업을 성사시킬 수 있습니다. 이것이 이 제안이 말하는 체인 추상화(ChA) 동작입니다.

응답 구조: Solution과 Transaction

응답 Rpc의 id는 요청에서 받은 번호와 일치해야 하고(MUST), result는 Solution 배열입니다. Solution은 요청한 Problem과 같은 순서여야 하며(MUST), name(짧고 비기술적인 사용자 친화 이름, 필수), description(선택), transactions(필수), deadline(오케스트레이터가 정하는 실행 시한, 선택)을 가집니다. Transaction은 to(Destination 타입), chainId, amount가 필수이고 calldata는 선택입니다. 멀티체인 자산이 존재하므로 지갑이 어디서 자산을 보낼지 알아야 해서 Transaction의 chainId는 필수로 못 박았습니다. 가스 한도·추정 같은 파라미터는 해법을 실제 실행하는 쪽이 지갑이므로 지갑에 위임합니다.

설계 근거와 제안 상태

이 제안은 호환성을 위해 이더리움 JSON-RPC 래퍼를 그대로 쓰고 어떤 프로그래밍 언어에서도 다루기 쉽도록 인터페이스에 범용 원시 타입만 사용합니다. 용어도 비기술 어휘를 지향해 폭넓은 채택을 노립니다. 오케스트레이터마다 해석과 구현이 다를 것을 전제로, 필수(MUST)로 못 박은 부분은 보편적인 서비스 수준을 보장하려는 것입니다. 한편 이 문서는 현재 Draft(초안) 상태입니다. 내용이 앞으로 바뀔 수 있는 제안 단계이므로 구현 시 원문의 최신 상태를 확인해야 합니다.

쓸 때 주의할 점

ERC 원문 · ← ERCs