v7

latestOpenAPI 3.1.0LGPL-3.0-or-laterraw.githubusercontent.com2026-04-27593295.9 KB

wallets

Register an external wallet address

Non-custodial wallet registration. The caller provides the on-chain address, the post-quantum public key, and a signature proving ownership. The custody service verifies that the public key matches the address and that the signature is valid over the deterministic challenge Keccak256('qustody:register:' + address). The custody service never holds private keys.

post/vault/accounts/{vaultAccountId}/wallets

Path parameters

vaultAccountIdstring uuid required

Headers

Idempotency-Keystring

Idempotency key for safe retries (required for POST/PUT)

Request body

assetIdstring uuid required

addressstring required

publicKeystring required

Hex-encoded post-quantum public key

signaturestring required

Hex-encoded post-quantum signature over the ownership challenge: Keccak256('qustody:register:' + lowercase_address). Proves the caller controls the private key for the given address.

labelstring

Response

Wallet registered

idstring uuid required

vaultIdstring uuid required

tenantIdstring uuid required

assetIdstring uuid required

addressstring required

publicKeystring

Hex-encoded post-quantum public key

labelstring

status'ACTIVE' | 'ARCHIVED' required

createdAtstring date-time required