Skip to content

add DVT relayer support to API mode docs #62

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tsudmi merged 2 commits into from
Mar 9, 2026
Merged

add DVT relayer support to API mode docs #62

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
415b9db
add DVT relayer support to API mode docs
ulieth Mar 6, 2026
3ec87f5
update oracles_exit_signature_shares to object with public_keys and e…
ulieth Mar 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 22 additions & 1 deletion operator/alternative-key-management/api-mode.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -103,13 +103,34 @@ Response:
"public_key": "0xPubKey1",
"deposit_signature": "0xDepositSig1",
"amount": 32000000000,
"exit_signature": "0xExitSig1"
"exit_signature": "0xExitSig1",
"oracles_exit_signature_shares": {
"public_keys": ["0xPubKeyShare1", "..."],
"encrypted_exit_signatures": ["0xExitSigShare1", "..."]
}
}
],
"validators_manager_signature": "0xManagerSig"
}
```

**Response fields:**

- `public_key` - Validator public key.
- `deposit_signature` - Deposit signature for the validator.
- `amount` - Deposit amount in Gwei.
- `exit_signature` - Exit signature for the validator.
- `oracles_exit_signature_shares` - Exit signature shares for oracle processing.
- `public_keys` - Validator public key shares.
- `encrypted_exit_signatures` - Exit signature shares, encrypted with oracle keys.
- `validators_manager_signature` - [EIP-712 ↗](https://eips.ethereum.org/EIPS/eip-712) signature from the Validators Manager wallet.

:::custom-info[DVT Relayer]
A regular relayer returns `exit_signature`, and the Operator Service splits it into shares and encrypts them with oracle keys. A DVT relayer handles this itself and returns ready-made `oracles_exit_signature_shares` instead.

Since DVT relayers collect signatures from multiple sidecars, `exit_signature`, `deposit_signature`, and `validators_manager_signature` may initially be returned empty. The Operator Service will automatically retry on the next block until all signatures are ready.
:::

### Validator Funding

**POST** `/fund`
Expand Down