본문으로 건너뛰기
Anon Wallet

PPOI 프록시

Railgun의 Private Proofs of Innocence(PPOI) 시스템은 쉴드된 자금을 언제 지출할 수 있는지 결정합니다. 규정 준수와 POI를 참고하십시오. 지갑은 자신의 노트의 PPOI 상태를 읽고 증명을 제출하기 위해 PPOI 집계기에 JSON-RPC 요청을 보냅니다. Anon의 앱은 이 요청을 집계기에 직접 보내지 않습니다. Anon의 PPOI 프록시로 보내며, 프록시가 이를 상위 집계기, 즉 Anon이 운영하지 않는 공개 Railgun PPOI 노드로 전달합니다. 프록시가 어느 집계기를 쓰는지는 서버 설정이므로 앱 업데이트 없이 바뀔 수 있습니다.

Private proofs on (default)
  Wallet --encrypted request------------> Relay ----> PPOI proxy ----> Upstream aggregator
  Wallet --global reads, your IP-------------------> PPOI proxy ----> Upstream aggregator
  Wallet --global reads, if the proxy fails-------------------------> Upstream aggregator

Private proofs off
  Wallet --every request, your IP------------------> PPOI proxy ----> Upstream aggregator
  Wallet --reads, if the proxy fails--------------------------------> Upstream aggregator
구간 운영 주체 수신하는 정보
릴레이(기본값은 relay.anon.inc) 기본적으로 Anon. 다른 릴레이를 설정하면 다른 운영자 사용자의 IP 주소, 각 요청의 시점과 크기, 그리고 요청이 증명 서비스를 위한 것이라는 사실. 요청을 읽을 수는 없습니다.
PPOI 프록시(proxy.anon.inc) Anon 메서드와 그 매개변수(조회 키에서 파생한 블라인드 커밋먼트 포함), 그리고 증명. 모든 직접 요청에서는 사용자의 IP 주소도 받습니다.
상위 집계기 제3자이며 Anon이 아님 프록시의 주소로부터 같은 메서드와 매개변수를 받습니다. 프록시는 앱의 헤더를 포함하지 않은 새 요청을 보냅니다. 앱이 대체 경로로 집계기에 요청하면 그 요청은 사용자의 기기에서 옵니다.

비공개 증명

Private proofs는 확장 프로그램과 모바일 앱 모두에서 Settings의 Connection privacy 아래에 있습니다. 기본값은 켜짐입니다. 변경 사항은 다음에 Anon을 열 때 적용됩니다.

Private proofs를 켜면 다음과 같습니다.

  • 블라인드 커밋먼트를 담은 요청, 모든 증명 제출, 그리고 앱이 전역 읽기로 분류하지 않은 모든 메서드는 Oblivious HTTP(OHTTP)로 암호화됩니다. 앱은 이 요청을 릴레이의 /ppoi/ohttp-configs와 /ppoi/gateway 경로를 통해 프록시 자체의 게이트웨이로 보냅니다. 게이트웨이의 키는 페이마스터의 키가 아닙니다. 앱은 게이트웨이의 키 구성이 앱에 고정된 키로 서명되었는지 확인합니다.
  • 프록시는 이 요청을 복호화하며, 사용자의 기기가 아니라 릴레이로부터 받습니다.
  • 네 가지 전역 읽기 요청에는 지갑에 관한 정보가 없습니다. 노드 상태, 가장 최근에 검증된 트랜잭션 ID, 그리고 두 가지 Merkle 루트 검사입니다. 이 요청은 사용자의 IP 주소와 함께 프록시로 직접 갑니다. 프록시가 응답하지 않으면 앱은 이 요청을 역시 사용자의 IP 주소와 함께 상위 집계기로 직접 보냅니다.
  • 암호화된 요청은 다른 경로로 다시 보내지 않습니다. 릴레이나 게이트웨이가 실패하면 요청이 실패하며, 앱은 이후 동기화 때 다시 요청합니다. 이런 실패가 연속으로 세 번 발생하면 앱은 증명 서비스에 연결할 수 없다고 알립니다.

앱은 증명과 페이마스터에 같은 릴레이를 사용합니다. 직접 릴레이를 설정하면 둘 다 그 릴레이로 옮겨 갑니다. 비공개 페이마스터 릴레이를 참고하십시오.

Private proofs를 끄면 모든 요청이 사용자의 IP 주소와 함께 https://proxy.anon.inc/v1/ppoi/rpc로 직접 갑니다. 여기서 읽기 요청이 실패하면 앱은 이를 사용자의 IP 주소와 함께 상위 집계기로 직접 보냅니다. 증명 제출은 프록시로만 가며 다른 주소로 다시 보내지 않습니다.

메서드

프록시는 앱에 필요한 메서드만 받습니다.

  • 읽기: ppoi_node_status, ppoi_pois_per_list, ppoi_merkle_proofs, ppoi_validate_poi_merkleroots, ppoi_validate_txid_merkleroot, ppoi_validated_txid;
  • 증명 제출: ppoi_submit_transact_proof, ppoi_submit_legacy_transact_proofs, ppoi_submit_single_commitment_proofs.

직접 경로는 Railscan이 읽는 ppoi_blocked_shields도 받습니다. 운영자용 메서드와 노드 간 메서드는 HTTP 403과 JSON-RPC 오류 -32601로 거부됩니다. 직접 경로는 Origin 헤더도 확인합니다. Anon 앱만 이 경로로 증명을 제출할 수 있습니다. 브라우저가 아닌 클라이언트는 어떤 Origin이든 보낼 수 있으므로 이 확인은 인증이 아닙니다.

프록시가 캐시하는 것

프록시는 일부 읽기 응답을 Anon이 운영하는 캐시에 저장합니다. 캐시 키는 메서드 이름과 요청 매개변수의 SHA-256 해시입니다. 프록시는 응답과 함께 메서드, 체인 ID, 응답이 바뀔 수 있는지 여부, 시각만 저장합니다. 매개변수는 저장하지 않습니다. 릴레이를 거친 요청과 직접 요청은 같은 캐시를 사용합니다.

응답 보관 기간
모든 상태가 Valid인 ppoi_pois_per_list 7일
ppoi_merkle_proofs 7일
true를 반환하는 ppoi_validate_poi_merkleroots 또는 ppoi_validate_txid_merkleroot 7일
ppoi_validated_txid 10초
그 밖의 모든 읽기 응답, 예를 들어 Valid가 아닌 상태나 false를 반환하는 검사 5분
Missing이 포함된 상태 응답 캐시하지 않음
ppoi_node_status, 모든 증명 제출, 모든 오류 캐시하지 않음

증명을 제출해도 캐시는 지워지지 않습니다. 증명을 기다리는 노트의 상태는 Missing이며 이 상태는 캐시되지 않으므로, 프록시는 이에 대해 항상 집계기에 다시 묻습니다.

캐시된 응답에는 사용자의 블라인드 커밋먼트가 들어 있을 수 있습니다. 해시된 키가 요청을 익명으로 만들지는 않습니다. 캐시를 읽을 수 있고 블라인드 커밋먼트를 아는 사람은 누구든 키를 계산할 수 있습니다.

증명 제출

프록시는 증명 제출을 도착하는 즉시 한 번 전달하며, 이에 대해 아무것도 저장하지 않습니다. 대기열이 없으며 나중에 증명을 전달하지도 않습니다.

  • 집계기가 증명을 수락하면 result 멤버 없이 응답합니다. 프록시는 앱이 이 응답을 성공으로 읽도록 "result": null을 추가합니다.
  • 집계기가 JSON-RPC 오류로 증명을 거부하면 프록시는 그 오류를 코드, 메시지, 데이터와 함께 반환합니다. 오류가 매우 크면 코드와 메시지만 반환합니다.
  • 집계기가 사용할 수 있는 응답을 주지 않으면(예: 시간 초과 후) 프록시는 JSON-RPC 오류 -32603과 메시지 upstream unavailable을 반환합니다.

앱은 이후 동기화 때 증명을 다시 제출합니다. 제출에는 속도 제한이 있습니다. 직접 경로에는 클라이언트별 제한과 전체 제한이 있으며, 프록시는 IP 주소 자체가 아니라 IP 주소의 키 기반 해시로 클라이언트를 구분합니다. 릴레이를 거치면 프록시가 요청을 누가 보냈는지 볼 수 없으므로 모든 사용자가 하나의 제한을 공유합니다. 제한을 넘은 요청은 HTTP 429와 JSON-RPC 오류 -32005를 받습니다.

비공개 수수료를 내는 경우, Anon의 페이마스터는 트랜잭션이 확정된 뒤 앱이 요청과 함께 보낸 증명도 집계기에 제출합니다. 페이마스터는 증명을 메모리에 보관하고, 5분마다 최대 1시간 동안 다시 시도한 다음 포기합니다. 이는 추가 경로이며 앱의 제출을 대체하지 않습니다.

집계기가 느릴 때

  • 프록시는 집계기를 최대 30초 기다립니다. 앱은 각 요청을 최대 60초 기다립니다.
  • 캐시에 있는 읽기는 캐시에서 응답합니다. 그 밖의 읽기는 upstream unavailable로 실패하며, 앱은 나중에 다시 시도합니다. 이때 직접 읽기는 위에서 설명한 대로 상위 집계기로 갑니다.
  • PPOI 검사를 기다리는 자금은 검사를 통과할 때까지 지출할 수 없는 상태로 남습니다. 증명 서비스에 연결할 수 없으면 앱은 대기 중인 쉴드를 Stuck으로 표시합니다. 규정 준수와 POI를 참고하십시오.

각 주체가 볼 수 있는 것

주체 Private proofs를 켠 경우 Private proofs를 끈 경우
릴레이 사용자의 IP 주소, 각 요청의 시점과 크기, 그리고 증명 서비스를 위한 요청이라는 사실 증명에는 사용되지 않음
PPOI 프록시(Anon) 모든 메서드와 그 매개변수. 사용자의 IP 주소는 네 가지 전역 읽기에서만 모든 메서드, 그 매개변수, 사용자의 IP 주소
상위 집계기(제3자) 프록시로부터 받은 모든 메서드와 그 매개변수. 사용자의 IP 주소는 앱이 전역 읽기에 대해 집계기로 대체 접속할 때만 프록시로부터 받은 모든 메서드와 그 매개변수. 앱이 읽기에 대해 집계기로 대체 접속할 때의 사용자의 IP 주소
  • Anon이 기본 릴레이와 프록시를 운영합니다. 페이마스터와 마찬가지로, 사용자의 IP 주소와 요청의 분리는 Anon이 두 서비스가 보는 정보를 결합하지 않는 데 달려 있습니다. 운영자를 분리하려면 사용자나 다른 주체가 운영하는 릴레이를 사용하십시오. 한계와 가정을 참고하십시오.
  • 클라이언트 헤더. 프록시는 암호화된 요청을 처리하기 전에 클라이언트 주소 헤더를 제거합니다. Cloudflare Workers로 실행되는 릴레이에 대한 Cloudflare 주의 사항은 이 경로에도 적용됩니다.
  • 로그. 프록시의 로그 줄에는 메서드와 결과가 적힙니다. 요청 매개변수는 들어 있지 않습니다. 집계기가 제출을 거부하면, 기록되는 응답 발췌에서 긴 16진수 값은 줄여서 남깁니다.
  • 지갑별 데이터. 지갑 동기화에서 설명한 이력 다운로드와 달리 이 요청은 사용자의 노트에 관한 것입니다. Private proofs는 프록시에 사용자의 IP 주소를 숨깁니다. 프록시나 상위 집계기에 요청 자체를 숨기지는 않습니다.