콘텐츠로 이동

검증자 보상

DoubleZero에 연결함으로써 DoubleZero 이용약관에 동의합니다

작동 방식

DoubleZero Edge에 리더 shred를 게시하는 검증자는 매 에포크마다 보상을 받습니다. 보상이 지급되기 전에 각 검증자는 Solana에서 ValidatorPublisherRewards 계정을 구성하여 보상이 어디로 전달되는지 등록해야 합니다. 해당 계정에는 다음이 저장됩니다:

  • 보상 민트 — 보상이 지급되는 토큰 2z (수동으로 변경하지 않는 한)
  • 보상 소유자 — 보상을 받는 Associated Token Account(ATA)를 소유하는 지갑

configure 명령은 이러한 필드를 설정하며, 이후 에포크 단위로 자동 지급이 이루어집니다. 나중에 configure를 다시 실행하여 어느 필드든 변경할 수 있습니다.

설정, 검증자 Mainnet-Beta 연결, 검증자 멀티캐스트 연결을 아직 완료하지 않았다면 먼저 완료하세요.

사전 요구 사항

  • 리더 shred를 게시하는 검증자 - 검증자 멀티캐스트 연결을 참조하세요.
  • 최신 doublezero-solana CLI: sudo apt update && sudo apt install doublezero-solana, 최소 0.5.6.
  • 검증자 신원 키페어에 대한 접근 권한 — 동일한 머신에 있거나 메시지에 서명할 수 있는 오프라인 환경에 보관.
  • 보상 ATA를 소유할 대상 지갑 공개키.

1. 보상 수령을 위한 구성

검증자 신원 키페어를 -k로 사용하여 configure를 실행합니다.

doublezero-solana shreds publisher-rewards configure \
    --node-id <ValidatorIdentity111111111111111111111111111> \
    --rewards-token-owner <Wallet567Identity111111111111111111111111111> \
    -k <path-to-validator-identity-keypair.json>
출력 예시 
Shred subscription - Configure Validator Publisher Rewards
Node ID:           ValidatorIdentity111111111111111111111111111
Rewards owner:     ValidatorIdentity111111111111111111111111111
Rewards mint:      J6pQQ3FAcJQeWPPGppWRb4nM8jU3wLyYbRrLh7feMfvd
Rewards ATA:       11111111111Pt3PatTj59dG5BhYuqPb9QJDUr1111111
Auth path:         direct
Configured validator publisher rewards: 41111111ntmoBTnvcKcP1g2a1111111HPoN3z5uf11111112jjzBJsr1B2JrTRff4dSGe1pdM1111111TMADi3Nz
Configured validator publisher rewards:는 블록 탐색기에서 확인할 수 있는 txt를 출력합니다.

플래그 설명
--node-id 검증자 노드 신원 공개키.
--rewards-token-owner 수령 ATA를 소유할 지갑.
--rewards-token-mint 보상이 수령될 지갑 토큰 2z. 지원되는 토큰에는 usdc와 wsol도 포함됩니다.
-k 검증자 신원 키페어 경로. 직접 경로에서는 키페어의 공개키가 --node-id와 일치해야 하며, 그렇지 않으면 오프체인 경로로 전환하라는 오류가 발생합니다.

ATA가 아직 존재하지 않는 경우 동일한 트랜잭션에서 자동으로 초기화됩니다.

오류가 반환되는 경우

-k 공개키가 --node-id와 일치하지 않는 경우

전달한 수수료 지불자 키페어가 검증자 신원이 아닙니다. 검증자 신원 키페어를 -k로 전달하거나, 오프체인 경로로 전환하세요.

2. 구성 확인

doublezero-solana shreds publisher-rewards show --node-id <NODE_ID>

이 명령은 Node ID, Rewards owner, Rewards mint, 확인된 ATA 주소, ATA 상태를 출력합니다. Resolved ATA는 보상 소유자 + 보상 민트에서 파생된 결정론적 주소이며, 매 에포크마다 보상이 입금되는 곳입니다.

부록: 오프체인 경로 대안

세 가지 하위 단계: 준비, 서명, 구성.

1. 오프체인 메시지 준비

어디서든 실행 가능합니다 — 읽기 전용이며 검증자 신원 키페어가 필요하지 않습니다. 서명할 16진수 블롭과 서명이 만료되는 절대 슬롯을 출력합니다.

doublezero-solana shreds publisher-rewards prepare-offchain-message \
    --node-id <ValidatorIdentity111111111111111111111111111> \
    --rewards-token-owner <Wallet567Identity111111111111111111111111111> \
    --valid-for 1h
출력 예시

Hex message:    123457fc138f556a2578bdb079dc923342cc4e4a376683dc4c6cb923051e0be3
Deadline slot:  422954444

Sign with:
  solana sign-offchain-message 123457fc138f556a2578bdb079dc923342cc4e4a376683dc4c6cb923051e0be3 --keypair <validator-identity>

Then submit:
  doublezero-solana shreds publisher-rewards configure \
    --node-id ValidatorIdentity111111111111111111111111111 --rewards-token-mint J6pQQ3FAcJQeWPPGppWRb4nM8jU3wLyYbRrLh7feMfvd --rewards-token-owner Wallet567Identity111111111111111111111111111 \
    --deadline-slot 422954444 --signature <BASE58>
플래그 설명
--node-id 검증자 노드 신원 공개키.
--rewards-token-owner 수령 ATA를 소유할 지갑.
--rewards-token-mint 보상이 수령될 지갑 토큰 2z. 지원되는 토큰에는 usdc와 wsol도 포함됩니다.
--valid-for 현재 슬롯 기준 서명 유효 기간. <n>s, <n>m, 또는 <n>h를 허용합니다. 기본값: 1h.
--deadline-slot --valid-for의 대안: 인증이 만료되는 절대 슬롯. --valid-for와 상호 배타적입니다.
--json 사람이 읽을 수 있는 요약 대신 JSON({ hex, deadline_slot })을 출력합니다.

이 명령은 16진수로 인코딩된 인증 메시지, 확인된 마감 슬롯, 다음 두 단계를 위한 바로 실행 가능한 셸 스니펫을 출력합니다.

2. 메시지 서명

검증자 신원 키페어가 있는 머신에서:

solana sign-offchain-message <123457fc138f556a2578bdb079dc923342cc4e4a376683dc4c6cb923051e0be3> \
--keypair <path-to-validator-identity-keypair.json>

이 명령은 base58 서명을 출력합니다.

출력 예시

SignatureTBUwGq511mPLMCEE4f5fNsmX1PQrozXBBJeCdSrcbhqSX1MwFp8NsNZbhCNMZ1kPWakjsLL9e3GUxxp

3. configure 제출

수수료 지불자 지갑이 있는 머신에서:

doublezero-solana shreds publisher-rewards configure \
    --node-id <ValidatorIdentity111111111111111111111111111> \
    --rewards-token-owner <Wallet567Identity111111111111111111111111111> \
    --signature <SignatureTBUwGq511mPLMCEE4f5fNsmX1PQrozXBBJeCdSrcbhqSX1MwFp8NsNZbhCNMZ1kPWakjsLL9e3GUxxp> \
    --deadline-slot <DEADLINE_SLOT>

--signature와 --deadline-slot은 함께 전달해야 합니다. 값은 2b.i 및 2b.ii 단계에서 생성된 것과 일치해야 합니다.

ATA가 아직 존재하지 않는 경우 동일한 트랜잭션에서 자동으로 초기화됩니다.

출력 예시

Shred subscription - Configure Validator Publisher Rewards
Node ID:           ValidatorIdentity111111111111111111111111111
Rewards owner:     ValidatorIdentity111111111111111111111111111
Rewards mint:      J6pQQ3FAcJQeWPPGppWRb4nM8jU3wLyYbRrLh7feMfvd
Rewards ATA:       11111111111Pt3PatTj59dG5BhYuqPb9QJDUr1111111
Auth path:         offchain
Configured validator publisher rewards: 41111111ntmoBTnvcKcP1g2a1111111HPoN3z5uf11111112jjzBJsr1B2JrTRff4dSGe1pdM1111111TMADi3Nz

참고: 서명이 만료된 경우

각 오프체인 서명에는 마감 슬롯이 있습니다. prepare-offchain-message와 configure 사이에 너무 많은 시간이 경과하면 prepare-offchain-message를 다시 실행하고, 다시 서명하고, 다시 제출하세요. 기본 유효 기간은 1시간입니다 — 오프라인 서명 흐름에 더 많은 시간이 필요하다면 --valid-for 4h 또는 유사한 옵션으로 연장하세요.