メインコンテンツまでスキップ

QM3 Wallets — /api/qm3*

Multi-signature wallets for the QM3 surface. A wallet has multiple owners; a transition is initiated by one owner, then signed by enough co-owners (HMAC signatures) to clear its threshold before it executes. Admins create wallets; owners drive the pending-transition flow.

Source: shared/api-core/src/routes/qm3Wallets.ts.

Admin

MethodPathAuthNotes
POST/api/admin/qm3-walletsAdminCreate a wallet.
GET/api/admin/qm3-walletsAdminList wallets created on this domain.

Owner

MethodPathAuthNotes
GET/api/qm3/wallets/mineZID-boundWallets the signed-in user owns.
GET/api/qm3/wallets/:idZID-boundWallet detail + owners + pending count.
POST/api/qm3/wallets/:id/initiateZID-boundInitiate a pending transition (any owner).
GET/api/qm3/wallets/:id/pendingZID-boundList pending transitions.
POST/api/qm3/pending/:tid/signZID-boundAttach an HMAC signature to a pending tx.
POST/api/qm3/pending/:tid/cancelZID-boundCancel a pending tx (initiator only).
POST/api/qm3/pending/:tid/compute-sigZID-boundHelper — server-side derivation of the caller's HMAC.

ZID-bound = authenticated via authenticateZeqAuth; ownership of the wallet is checked per call.