Skip to main content
Use Google Cloud KMS to sign Validator checkpoints with a private key held in Cloud HSM. This setup uses agent v4.0.0.

Create a signing key

Enable the Cloud KMS API in your Google Cloud project and sign in with a Google Cloud CLI identity that can create keys and manage key-level IAM bindings. Set the values below for your project and an HSM-supported location. Skip the key ring creation command if you already have a key ring. Google Cloud key creation guide
The Validator needs the full resource name of an enabled key version. Use version 1 for a newly created key. If you are using an existing key, set KEY_VERSION to the version that identifies your Validator.

Grant the Validator access

Set SERVICE_ACCOUNT_EMAIL to the service account the Validator will run as. Bind the signing role to the specific key so the Validator can fetch the public key and request signatures.
The agent uses Application Default Credentials (ADC). Attach the service account to the compute resource running the Validator. On GKE, configure Workload Identity Federation for the Validator’s Kubernetes service account to impersonate the Google Cloud service account. The credentials must be available inside the Validator process or container. Application Default Credentials · Workload Identity Federation for GKE

Configure the Validator

Add these flags to your Validator command using the full key version name from the previous step.
As Arg
For JSON configuration, add the validator block to your existing agent config and replace the example resource name with your key version name.
On EVM and Tron, if you leave the chain signer and defaultSigner unset, the Validator uses this key for its on-chain storage announcement. Fund that account with native tokens for gas. For other chains, configure a chain-specific transaction signer. Transaction signer configuration Choose checkpoint storage separately. The Validator guide uses Amazon S3 by default. For a Google Cloud deployment, you can use Google Cloud Storage with workload credentials.

Find the Validator’s EVM address

Use the same key version as the Validator. This command fetches its public key and derives the address using OpenSSL and Foundry’s cast.