Ethereum
이더리움(Ethereum) API는 이더리움 블록체인에서 스테이킹 서비스를 구현하기 위한 API 세트입니다. 스테이킹(Deposit), 언스테이킹(Withdrawal), 리워드 조회, 밸리데이터 상태 모니터링 등 스테이킹 전반의 라이프사이클을 지원합니다.
지원 네트워크
| 네트워크 | 설명 |
|---|---|
hoodi | 이더리움 테스트넷 |
스테이킹 라이프사이클
1. 스테이킹 요청 (Request Deposit)
↓
2. 트랜잭션 서명 (클라이언트)
↓
3. 트랜잭션 브로드캐스트 (Broadcast Transaction)
↓
4. 밸리데이터 활성화 대기 (Get Validators)
↓
5. 리워드 적립 & 조회 (Get Income)
↓
6. 언스테이킹 요청 (Request Withdraw)
↓
7. 출금 완료주요 기능
스테이킹 (Deposit)
- Request Deposit: 밸리데이터 키 할당 및 Deposit Data 생성
- Broadcast Transaction: 서명된 트랜잭션을 네트워크에 전송
- Get Transaction Receipt: 트랜잭션 상태 확인
밸리데이터 조회 (Validators)
- Get Validators: 출금 주소별 밸리데이터 목록 및 상태 조회
- Get Validator APR: 밸리데이터별 7일 APR 조회
- Get Key Statistics: 조직별 키 통계 조회
수익 조회 (Income)
- Get Daily Income: 일별 상세 수익 내역
- Get Monthly Income: 월별 집계 수익 내역
- Get Lifetime Income: 전체 기간 누적 수익 내역
언스테이킹 (Withdraw)
- Request Withdraw: 밸리데이터 자발적 종료(Voluntary Exit) 요청
밸리데이터 상태
Get Validators시 조회되는 밸리데이터의 상태의 정의는 다음과 같습니다.
| 상태 | 설명 |
|---|---|
pending_initialized | 예치 대기 중 |
pending_queued | 활성화 큐 대기 중 |
active_ongoing | 활성화 상태, 정상 운영 중 |
active_exiting | 종료 진행 중 |
active_slashed | 슬래싱됨 |
exited_unslashed | 정상 종료 |
exited_slashed | 슬래싱 후 종료 |
withdrawal_possible | 출금 가능 |
withdrawal_done | 출금 완료 |
수익 구성 요소
Get Daily/ Monthly/ Lifetime Income 시 조회되는 이더리움 스테이킹 수익은 다음 요소로 구성됩니다.
| 계층 | 구분 | 항목 | 설명 |
|---|---|---|---|
| Consensus Layer | Attestation | Head Reward | 체인 헤드 증명 보상 |
| Source Reward | 소스 체크포인트 증명 보상 | ||
| Target Reward | 타겟 체크포인트 증명 보상 | ||
| Proposer | Attestation Inclusion | 증명 포함 보상 | |
| Sync Inclusion | 동기화 위원회 포함 보상 | ||
| Slashing Inclusion | 슬래싱 증거 포함 보상 | ||
| Sync Committee | Reward | 동기화 위원회 참여 보상 | |
| Execution Layer | Transaction Fee | MEV 및 트랜잭션 수수료 (Wei) |
주의사항
사용자 편의와 자산 보안을 위해 아래 사항을 반드시 확인하시기 바랍니다.
-
Deposit Data 중복 제출 주의
이미 생성된
deposit data를 중복으로 제출할 경우, 예치된 32 ETH는 최초로 제출된 트랜잭션의 출금 주소(Withdrawal Address)로 반환됩니다. -
Fee Recipient(수수료 수령 주소) 자동 설정 안내
Fee Recipient는 블록 생성 시 발생하는 실행 레이어 리워드(MEV 및 트랜잭션 수수료)가 지급되는 주소입니다. 모든 밸리데이터의 Fee Recipient는 해당 밸리데이터의 출금 주소(Withdrawal Address)로 자동 설정되며,
Request-depositAPI 호출 시 별도의 파라미터를 입력받지 않습니다. 모든 리워드가 출금 주소로 귀속되어 자산을 안전하고 효율적으로 통합 관리할 수 있습니다.
Updated 17 days ago