> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.
# CValidatorAction | Hyperliquid exchange
> Performs a validator-specific action on the Hyperliquid consensus layer. Available on Hyperliquid exchange via Chainstack JSON-RPC nodes.
You can only use this endpoint on the official Hyperliquid public API. It is not available through Chainstack, as the open-source node implementation does not support it yet. See [Hyperliquid methods](/docs/hyperliquid-methods) for the full availability breakdown.
This endpoint requires signature authentication. See our comprehensive [Authentication via Signatures guide](/docs/hyperliquid-authentication-guide) for implementation details.
Performs a validator-specific action on the Hyperliquid consensus layer.
## Parameters
### Required parameters
* `action` (object, required) — The action object containing:
* `type` (string) — Must be `"CValidatorAction"`
* `payload` (object) — Validator action payload
* `nonce` (number, required) — Current timestamp in milliseconds (must be recent)
* `signature` (object, required) — EIP-712 signature of the action
### Optional parameters
* `vaultAddress` (string, optional) — Address when trading on behalf of a vault or subaccount
## Returns
Returns an object with the action status:
* `status` — `"ok"` if request processed
* `response` — Contains action result data
## Example request
```shell cURL theme={"system"}
curl -X POST https://api.hyperliquid.xyz/exchange \
-H "Content-Type: application/json" \
-d '{
"action": {"type": "CValidatorAction"},
"nonce": 1234567890123,
"signature": {...}
}'
```
```python Python (hyperliquid-python-sdk) theme={"system"}
import eth_account
from hyperliquid.exchange import Exchange
from hyperliquid.utils import constants
# Load the validator signer wallet (keep the key out of source control).
wallet = eth_account.Account.from_key("0x_your_private_key")
# CValidatorAction is public-only — use the public Hyperliquid mainnet API.
exchange = Exchange(wallet, constants.MAINNET_API_URL)
# Register a validator.
result = exchange.c_validator_register(
node_ip="1.2.3.4",
name="my-validator",
description="My Hyperliquid validator",
delegations_disabled=False,
commission_bps=100,
signer="0x_validator_signer_address",
unjailed=True,
initial_wei=10000000000,
)
print(result)
# Update the validator profile.
exchange.c_validator_change_profile(
node_ip="1.2.3.4",
name="my-validator",
description="Updated description",
unjailed=True,
disable_delegations=False,
commission_bps=100,
signer=None,
)
# Unregister the validator.
exchange.c_validator_unregister()
```
```typescript TypeScript (@nktkas/hyperliquid) theme={"system"}
import * as hl from "@nktkas/hyperliquid";
import { privateKeyToAccount } from "viem/accounts";
// Load the validator signer wallet (keep the key out of source control).
const wallet = privateKeyToAccount("0x_your_private_key");
// CValidatorAction is public-only — HttpTransport defaults to the public Hyperliquid API.
const transport = new hl.HttpTransport();
const client = new hl.ExchangeClient({ transport, wallet });
await client.cValidatorAction({
changeProfile: {
node_ip: { Ip: "1.2.3.4" },
name: "my-validator",
description: "Updated description",
unjailed: true,
disable_delegations: false,
commission_bps: 100,
signer: null,
},
});
```
## Use case
* **C validator action** — Performs a validator-specific action on the Hyperliquid consensus layer.
Always ensure your system clock is synchronized. Nonce must be within a reasonable time window of the current server time or the request will be rejected.
## OpenAPI
````yaml openapi/hyperliquid_node_api/hypercore_exchange/exchange_c_validator_action.json post /exchange
openapi: 3.0.0
info:
title: Hyperliquid Exchange API
version: 1.0.0
description: >-
API for trading operations on Hyperliquid exchange. **IMPORTANT**: All
exchange endpoints require EIP-712 signatures for authentication. The
examples shown will not work without proper signing. See the [Hyperliquid
Python SDK](https://github.com/hyperliquid-dex/hyperliquid-python-sdk) for
implementation examples.
servers:
- url: https://api.hyperliquid.xyz
security: []
paths:
/exchange:
post:
tags:
- hyperliquid exchange
summary: C validator action
operationId: cValidatorAction
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
action:
type: object
properties:
type:
type: string
default: CValidatorAction
enum:
- CValidatorAction
description: Action type
register:
type: object
description: >-
Register a new validator (one of several possible
sub-actions: register, changeProfile, unregister)
properties:
profile:
type: object
properties:
node_ip:
type: object
description: 'Node IP object, e.g., {"Ip": "1.2.3.4"}'
name:
type: string
description: Validator display name
description:
type: string
description: Validator description
delegations_disabled:
type: boolean
description: Whether delegations are disabled
commission_bps:
type: integer
description: >-
Commission rate in basis points (e.g., 1000 =
10%)
signer:
type: string
description: Signer Ethereum address
unjailed:
type: boolean
description: Whether the validator starts unjailed
initial_wei:
type: integer
description: Initial self-delegation in wei
required:
- type
nonce:
type: integer
description: Current timestamp in milliseconds
signature:
type: object
description: EIP-712 signature of the action with r, s, v components
properties:
r:
type: string
description: ECDSA signature r component (hex string)
example: >-
0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
s:
type: string
description: ECDSA signature s component (hex string)
example: >-
0xfedcba0987654321fedcba0987654321fedcba0987654321fedcba0987654321
v:
type: integer
description: ECDSA recovery id (27 or 28)
example: 27
required:
- r
- s
- v
vaultAddress:
type: string
description: >-
Address when trading on behalf of a vault or subaccount
(optional)
nullable: true
required:
- action
- nonce
- signature
example:
action:
type: CValidatorAction
register:
profile:
node_ip:
Ip: 1.2.3.4
name: My Validator
description: A Hyperliquid validator node
delegations_disabled: false
commission_bps: 1000
signer: '0x1234567890abcdef1234567890abcdef12345678'
unjailed: false
initial_wei: 0
nonce: 1705234567890
signature:
r: >-
0x0000000000000000000000000000000000000000000000000000000000000000
s: >-
0x0000000000000000000000000000000000000000000000000000000000000000
v: 27
vaultAddress: null
responses:
'200':
description: Action result
content:
application/json:
schema:
type: object
properties:
status:
type: string
description: Request status
response:
type: object
description: Action response data
````