Skip to main content
이 페이지에서는 기본 설정을 넘어서는 릴리스별 및 운영 관련 세부 사항을 다룹니다. 먼저 CDR 클라이언트 설정부터 시작하세요.

​
DKG 상태와 DATA Foundation API 엔드포인트

SDK는 두 개의 백엔드에서 상태를 읽습니다: apiUrl은 필수 CDRClient 매개변수입니다. 이는 DATA Foundation API REST 엔드포인트의 베이스 URL이며, observer는 모든 DKG 읽기에 이를 사용합니다.
프로덕션 배포의 경우, 공유 엔드포인트가 아닌 본인의 Story 노드의 REST 게이트웨이를 apiUrl로 지정하세요. 네트워크별 값은 DATA Foundation API REST 엔드포인트를 참고하세요.
observer는 안정적인 Active 및 Ended 단계의 라운드에 대해 라운드 키 기반 DKG 스냅샷을 캐시하며, 진행 중인 요청을 중복 제거합니다. 활성 라운드 자체는 언제든 전환될 수 있기 때문에 항상 다시 가져옵니다.

​
임계값 튜닝

기본적으로 SDK는 부분 복호화를 결합할 때 네트워크 자체의 DKG 임계값을 사용합니다. 선택적 매개변수 minThresholdRatio(범위 [0, 1])를 통해 기준을 높일 수 있습니다:
실효 임계값은 max(network.threshold, ceil(participants * minThresholdRatio))가 됩니다.
1을 초과하는 값은 참여자보다 더 많은 부분 복호화를 요구하므로, collectPartials / accessCDR이 영원히 타임아웃됩니다. SDK는 이를 거부합니다.

​
컨트랙트 주소

현재 Aeneid 릴리스는 다음과 같은 핵심 시스템 주소를 사용합니다: SDK는 이미 이러한 주소를 알고 있습니다. DATA Foundation 라이선스 게이팅 조건 컨트랙트에 대해서는 DATA Foundation 라이선스 읽기 패턴의 작동 방식을 참고하세요.

​
릴리스 상태 및 가용성

  • Aeneid는 SDK의 현재 공개 테스트넷 릴리스입니다.
  • 기밀성은 DKG 임계값과 CDR 개요에서 설명된 검증자 / 엔클레이브 신뢰 가정에 의존합니다.
  • 가용성은 타임아웃 전에 응답하는 검증자가 충분한지에 따라 결정됩니다. 읽기가 임계값에 도달하지 못하면, 재시도하거나 timeoutMs를 늘리세요.
  • DKG 읽기는 apiUrl DATA Foundation API 엔드포인트가 올바르고 접근 가능한지에 따라 결정됩니다. 프로덕션 사용 시에는 신뢰할 수 있는 노드를 지정하세요.

​
현재 릴리스 노트

  • DATA Foundation 라이선스 게이팅 vault는 여전히 수동 조건 인코딩이 필요합니다.
  • CDR SDK는 IP를 WIP로 자동 래핑하거나, 라이선스 민팅을 위해 WIP를 자동 승인하지 않습니다.
  • accessCDR()은 매개변수가 생략된 경우 임시 키페어를 자동으로 생성하고 threshold를 조회할 수 있습니다.
  • createVault / readVault / createFileVault / readFileVault는 상위 레벨 별칭으로 사용할 수 있습니다.
  • getRegisteredValidators()는 등록이 완전히 비준된(status = Finalized) 검증자만 포함합니다.
  • accessCDR() 및 downloadFile()의 경우 timeoutMs: 120_000이 좋은 시작점입니다.