@valora/viem-account-hsm-gcp

Use a Google Cloud HSM key to sign transactions with viem.

Installing the library

yarn add @valora/viem-account-hsm-gcp

Note: viem is a peer dependency, so make sure it's installed in your project.

Using the library

Simple usage

1import { createWalletClient, http } from 'viem'
2import { mainnet } from 'viem/chains'
3import { gcpHsmToAccount } from '@valora/viem-account-hsm-gcp'
4
5const account = await gcpHsmToAccount({
6  hsmKeyVersion:
7    'projects/your-gcp-project/locations/global/keyRings/your-keyring/cryptoKeys/your-hsm/cryptoKeyVersions/1',
8})
9
10const client = createWalletClient({
11  account,
12  chain: mainnet,
13  transport: http(),
14})
15
16// Test send a transaction to the HSM key (the HSM key needs to be funded)
17const hash = await client.sendTransaction({
18  to: account.address,
19  value: parseEther('0.001'),
20})

[!IMPORTANT]
Make sure the key in Google Cloud KMS is a secp256k1 key.

[!TIP] You don't have to use an HSM key, you can use a software key as well. See the Google Cloud KMS documentation for more information.

Resources

• viem
• @google-cloud/kms

Acknowledgements

This library is a port of @celo/wallet-hsm-gcp to viem.

Big thanks to the Celo team for the original implementation.

Contributing

• Reporting issues
• Submitting a pull request
• Publishing updates is done automatically via semantic-release. Remember to use conventional commits or your PR will be rejected (since merging it would mess up the changelog and version numbers).