Authentication

client, err := phala.NewClient(
    phala.WithAPIKey("phak_your_api_key"),
)
if err != nil {
    log.Fatal(err)
}

export PHALA_CLOUD_API_KEY="phak_your_api_key"

// No WithAPIKey needed — reads from PHALA_CLOUD_API_KEY
client, err := phala.NewClient()
if err != nil {
    log.Fatal(err) // Fails if env var is also unset
}

client, err := phala.NewClient(
    phala.WithBearerToken(os.Getenv("PHALA_OIDC_TOKEN")),
    phala.WithWorkspace("my-workspace"),
)
if err != nil {
    log.Fatal(err)
}

client, err := phala.NewClient(
    phala.WithAPIKey("phak_your_api_key"),
    phala.WithBaseURL("https://custom-api.example.com/api/v1"),
)

client, err := phala.NewClient(
    phala.WithAPIKey("phak_your_api_key"),
    phala.WithHeader("X-Request-ID", "trace-abc123"),
    phala.WithHeader("X-Custom-Header", "my-value"),
)

client, err := phala.NewClient(
    phala.WithAPIKey("phak_your_api_key"),
    phala.WithAPIVersion("2026-05-22"),
)

transport := &http.Transport{
    TLSClientConfig: &tls.Config{MinVersion: tls.VersionTLS13},
}
httpClient := &http.Client{Transport: transport}

client, err := phala.NewClient(
    phala.WithAPIKey("phak_your_api_key"),
    phala.WithHTTPClient(httpClient),
)

client, err := phala.NewClient(
    phala.WithAPIKey("phak_your_api_key"),
    phala.WithUserAgent("my-automation/2.0"),
)