createIssuerHierarchy

PQSafe AgentPay API Reference v0.1.0

---

PQSafe AgentPay API Reference / createIssuerHierarchy

Function: createIssuerHierarchy()

createIssuerHierarchy(_params): Promise<IssuerHierarchy>

Defined in: pqsafe/agent-pay/src/sprint2/issuer.ts:184

Create a new issuer hierarchy with a fresh root key.

Sprint 3 implementation will:

1. Generate ML-DSA-87 root key (in HSM or software-dev-only mode).
2. Derive issuer address from root public key.
3. Generate first spend key (ML-DSA-65) + sign with root → certificate.
4. Store hierarchy in hosted issuer service.
5. Optionally register issuer address on Arbitrum registry.

Parameters

_params

apiKey

string

hsmProvider

"yubikey" | "aws-cloudhsm" | "google-cloud-kms" | "software-dev-only"

organizationName

string

serviceUrl

string

Returns

Promise<IssuerHierarchy>

Throws

‘Sprint 2 — implementation queued’ until Sprint 3 ships.