keys

Overview ¶

Package keys provides API key loading and management.

This package implements the api.KeyProvider interface for loading Turnkey API keys from the standard Turnkey CLI key storage location.

Key File Format ¶

Keys are stored in ~/.config/turnkey/keys/ with two files per key:

<key-name>.public  - Hex-encoded compressed public key
<key-name>.private - Format: "hexkey:p256" where hexkey is the private scalar

Loading Keys ¶

Load an API key using the FileKeyProvider:

provider := &keys.FileKeyProvider{KeyName: "my-key"}
apiKey, err := provider.GetAPIKey(context.Background())
if err != nil {
	log.Fatal(err)
}

Or directly load a key by name:

apiKey, err := keys.LoadAPIKeyFromFile("my-key")
if err != nil {
	log.Fatal(err)
}

Key Formats ¶

The private key format in .private file is "hexkey:curve" where:

• hexkey: Hex-encoded private key scalar (must be 64 hex characters for P-256)
• curve: Curve name (currently only "p256" is supported)