Keys endpoint

KR

Single-call key generation

POST /api/v1/keys/generate returns spending and viewing keypairs plus a meta-address.

AR

Use output in next steps

Feed meta_address into the stealth create endpoint.

Endpoint

POST /api/v1/keys/generate

No request body is required.

Typical flow

01

Call the endpoint

Trigger key generation once per new recipient identity.

02

Store secrets securely

Persist spending_sk and viewing_sk in encrypted storage only.

03

Publish meta-address

Use meta_address with IPFS + ENS/SuiNS registration.

Example calls

cURL

curl -s -X POST https://backend.specterpq.com/api/v1/keys/generate | jq .

JavaScript

const res = await fetch("https://backend.specterpq.com/api/v1/keys/generate", {
  method: "POST"
});

const keys = await res.json();
console.log(keys.meta_address);

Response schema

spending_pkstringrequired

Hex-encoded spending public key.

spending_skstringrequired

Hex-encoded spending secret key (sensitive).

viewing_pkstringrequired

Hex-encoded viewing public key.

viewing_skstringrequired

Hex-encoded viewing secret key (sensitive).

meta_addressstringrequired

Hex-encoded SPECTER meta-address combining spending + viewing public keys.

view_tagintegerrequired

Base view tag derived from viewing public key bytes.

Warning

Never log or commit spending_sk or viewing_sk.

How `view_tag` is computed here

The endpoint computes view_tag from the viewing public key bytes (compute_view_tag(viewing.public.as_bytes())).

What this endpoint does not do

It does not persist key material to disk and does not register ENS/SuiNS records.