Files
zeekayandHanzo Dev b55332704a feat: Hanzo Cloud SDK for Kotlin (generated from OpenAPI v8.0.0)
Coroutine-native client covering the full Hanzo /v1 cloud surface, for JVM and
Android. Generated with openapi-generator kotlin (library=jvm-okhttp4,
useCoroutines=true). Coordinate: ai.hanzo:sdk. Base URL: https://api.hanzo.ai.

Co-authored-by: Hanzo Dev <[email protected]>
2026-07-25 07:10:32 -07:00

2.0 KiB

SDKApi

All URIs are relative to https://api.hanzo.ai

Method HTTP request Description
kmsSdkSecretsOp POST /v1/sdk/secrets Enveloped secret + threshold-key operation

kmsSdkSecretsOp

kotlin.Any kmsSdkSecretsOp(kmsSdkEnvelope)

Enveloped secret + threshold-key operation

The SDK-facing native secrets plane. A single RPC endpoint: the body is a signed Envelope (ML-DSA-65 over the request), and the OPERATION is the signed `op` field — never the URL. Authorization is consensus-native: the caller's mnemonic-derived NodeID must be in the validator authority (reads: OpSecretGet 0x0040, OpSecretList 0x0042, OpVerify 0x0051) and, for writes (OpSecretPut 0x0041 — also the rotate op, OpSecretDelete 0x0043, OpSign 0x0050), additionally in the operator authority. Every envelope is verified for signature, wall-clock freshness (±5m), and replay (per-(NodeID,nonce) ledger) before dispatch. There is NO bearer token on this surface — the ML-DSA-65 envelope IS the credential.

Example

// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*

val apiInstance = SDKApi()
val kmsSdkEnvelope : KmsSdkEnvelope =  // KmsSdkEnvelope | 
try {
    val result : kotlin.Any = apiInstance.kmsSdkSecretsOp(kmsSdkEnvelope)
    println(result)
} catch (e: ClientException) {
    println("4xx response calling SDKApi#kmsSdkSecretsOp")
    e.printStackTrace()
} catch (e: ServerException) {
    println("5xx response calling SDKApi#kmsSdkSecretsOp")
    e.printStackTrace()
}

Parameters

Name Type Description Notes
kmsSdkEnvelope KmsSdkEnvelope

Return type

kotlin.Any

Authorization

No authorization required

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json