Skip to main content
POST
Cooperative claim (reverse)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Swap id (ULID).

Body

application/json

Body of POST /v2/swap/reverse/{id}/claim — Boltz-shaped, camelCase. Sighash sourcing: callers may either send the raw unsigned tx (Boltz convention) — transaction (hex) + index — and the server computes the BIP-341 key-path sighash, or send signatureHash precomputed locally. The server prefers transaction when both are present. Missing both is 400 missing_sighash.

preimage
string
required

The 32-byte preimage that satisfies the swap's preimageHash. The maker uses this to settle the LN hold invoice.

pubNonce
string
required

The taker's MuSig2 pub nonce, 66 bytes hex.

index
integer<int32> | null

Input index in the claim transaction. Defaults to 0 — most cooperative claim txs only spend the single lockup input.

Required range: x >= 0
signatureHash
string | null

32-byte BIP-341 sighash the taker wants the maker to partial-sign. Optional when transaction is provided; required otherwise.

transaction
string | null

Hex-encoded unsigned claim transaction. If present, the server computes the sighash from this + index against the swap's persisted lockup output, and any signatureHash is ignored.

Response

Maker's pub nonce + partial signature.

Maker's partial-signature response on the cooperative claim/refund endpoints (submarine refund, reverse claim, reverse refund, chain claim, chain refund).

partialSignature
string
required

Maker's 32-byte partial signature, hex.

pubNonce
string
required

Maker's 66-byte MuSig2 pub nonce, hex.