arbitration

type ArbitrationClaim struct {
	// PoolOutputSatoshis 是被托管资金池输出的聪数（uint64）；仲裁 candidate
	// 的输入金额必须与它一致。
	PoolOutputSatoshis uint64
	// PoolOutputLockingScript 是角色顺序固定 [Buyer, Seller, Arbiter] 的
	// 2-of-3 压缩公钥锁定脚本（恰好 105 字节）；三方公钥由它恢复。
	PoolOutputLockingScript []byte
	// RefundTemplateRaw 是规范未签名退款模板交易的原始字节；到期后买方凭它
	// 广播退款，仲裁方用它派生 refund_template_txid 与保留矿工费。
	RefundTemplateRaw []byte
	// PaymentAuthorizationCBOR 是买方签名的 exact Kind 5 付款授权子文档；
	// 目标序号与绝对卖方金额由此提供，绝不解码重编码。
	PaymentAuthorizationCBOR []byte
	// BuyerPaymentAuthorizationSignature 是买方对 WireSignatureInput(1, 5,
	// payment_authorization_cbor) 的统一消息签名。
	BuyerPaymentAuthorizationSignature []byte
}

type ArbitrationReceipt struct {
	// ArbitrationClaimID 路由本回执对应的托管记录（SHA-256(exact claim cbor)）；
	// 必须与验证时重算的 Claim ID 一致。
	ArbitrationClaimID protocol.ArbitrationClaimID
	// ArbiterAmountSatoshis 是分配给 output[2] 的冻结绝对仲裁费（单位
	// satoshi）；成功回执恒为正数。
	ArbiterAmountSatoshis uint64
	// ArbiterPaymentTransactionSignature 是仲裁方对独立重建付费 candidate 的
	// ForkID|All 原生交易签名；不能替代回执普通消息签名。
	ArbiterPaymentTransactionSignature []byte
}

type ArbitrationRequest struct {
	// ArbitrationClaimCBOR 是 exact 确定性 Claim 子文档字节；wire 不解码重编码，
	// arbitration_claim_id = SHA-256(该字段)。
	ArbitrationClaimCBOR []byte
	// SellerArbitrationClaimSignature 是卖方对 WireSignatureInput(1, 8,
	// arbitration_claim_cbor) 的统一消息签名；payload 不直接入签。
	SellerArbitrationClaimSignature []byte
	// ContentPayloadsCBOR 是确定性 CBOR payload 批次（attachment）：顺序与
	// 授权哈希一一对应，经买方已签 content_hashes_cbor 间接绑定。
	ContentPayloadsCBOR []byte
}

type ArbitrationResponse struct {
	// ArbitrationReceiptCBOR 是 exact 确定性回执子文档字节；wire 不解码重编码。
	ArbitrationReceiptCBOR []byte
	// ArbiterArbitrationReceiptSignature 是仲裁方对 WireSignatureInput(1, 9,
	// arbitration_receipt_cbor) 的统一消息签名，把 Claim ID、费用和交易签名绑定在一起。
	ArbiterArbitrationReceiptSignature []byte
}

type BuiltClaim struct {
	// Claim 是 ArbitrationClaimCBOR 背后的已解码、深拷贝 Claim 证据。
	Claim *ArbitrationClaim
	// ArbitrationClaimCBOR 是精确规范的五元 Claim 子文档字节。
	ArbitrationClaimCBOR []byte
	// ArbitrationClaimID = SHA-256(exact_claim_cbor)，Seller 与 Buyer 独立重建必得同一值。
	ArbitrationClaimID protocol.ArbitrationClaimID
	// Authorization 是 Claim 携带的已解码 Kind 5 付款授权（含目标序号与绝对卖方金额）。
	Authorization *content.PaymentAuthorization
}

type ContentRetrievalRequest struct {
	// ContentRetrievalRequestCBOR 是 exact 规范子文档
	// [arbitration_claim_id, retrieval_nonce]；它是买方唯一签署的对象，
	// 其 SHA-256 即 content_retrieval_request_id。
	ContentRetrievalRequestCBOR []byte
	// BuyerContentRetrievalRequestSignature 是买方对 WireSignatureInput(1, 10,
	// content_retrieval_request_cbor) 的统一消息签名。
	BuyerContentRetrievalRequestSignature []byte
}

type ContentRetrievalResponse struct {
	// ContentRetrievalResultCBOR 是 exact 规范结果子文档
	// [content_retrieval_request_id, result, branch_value]；判别值决定外层形状。
	ContentRetrievalResultCBOR []byte
	// ArbiterContentRetrievalResultSignature 是仲裁方对 WireSignatureInput(1, 11,
	// content_retrieval_result_cbor) 的统一消息签名（两分支同域）。
	ArbiterContentRetrievalResultSignature []byte
	// ContentPayloadsCBOR 仅 available 分支存在：exact content_payloads_cbor
	// attachment，经签名的 content_payloads_id 绑定；unavailable 分支禁止携带。
	ContentPayloadsCBOR []byte
}

type ContentRetrievalResult uint64

type ContentRetrievalUnavailableReason uint64

type DecodedContentRetrievalResult struct {
	// ContentRetrievalRequestID 必须等于 SHA-256(exact Kind 10 请求文档)，绑定本应答对应的请求。
	ContentRetrievalRequestID protocol.ContentRetrievalRequestID
	// Result 是分支判别值：0 unavailable / 1 available；未知值在严格解码时拒绝。
	Result ContentRetrievalResult
	// UnavailableReason 仅 Result == unavailable 时有意义：
	// 0 seller_arbitration_not_received / 1 not_ready / 2 custody_gone。
	UnavailableReason ContentRetrievalUnavailableReason
	// ContentPayloadsID 仅 Result == available 时有意义：
	// SHA-256(exact content_payloads_cbor)，逐字节绑定附件批次。
	ContentPayloadsID protocol.ContentPayloadsID
}

type VerifiedContentRetrievalResult struct {
	// ContentRetrievalRequestID 是已验证绑定的请求 ID（等于买方请求文档哈希）。
	ContentRetrievalRequestID protocol.ContentRetrievalRequestID
	// Available 报告分支结果：true 为可交付；false 表示 unavailable 分支，
	// 此时 Payloads/PayloadsCBOR 均为空且不产生任何付款状态变化。valid
	// unavailable 是协议结果，不是 transport/parser error。
	Available bool
	// UnavailableReason 仅 Available == false 时有意义：仲裁方给出的诚实原因，
	// 应用据此决定生成新 nonce、等待或终止。
	UnavailableReason ContentRetrievalUnavailableReason
	// PayloadsCBOR 是 exact content_payloads_cbor 字节；仅 available 分支非空。
	PayloadsCBOR []byte
	// Payloads 是按授权顺序深拷贝的 payload 内容；仅 available 分支非空。
	Payloads [][]byte
}

type VerifiedCustodiedContent struct {
	// ArbitrationClaimID 是重算并与回执比对一致的托管 Claim 身份。
	ArbitrationClaimID protocol.ArbitrationClaimID
	// PayloadsCBOR 是从托管 Kind 8 证据字节派生的唯一 payload 真值。
	PayloadsCBOR []byte
	// Payloads 是按授权顺序深拷贝的 payload 内容。
	Payloads [][]byte
	// Receipt 是已验证的 Kind 9 回执（Claim ID、正费用与交易签名绑定）。
	Receipt *ArbitrationReceipt
	// Request 是存储的 exact Kind 8 证据（深拷贝，只读使用）。
	Request *ArbitrationRequest
	// Response 是存储的 exact Kind 9 证据（深拷贝，只读使用）。
	Response *ArbitrationResponse
}