protocol

type Attestation struct {
	// ID is the unique attestation identifier
	ID core.ID `json:"id"`

	// Domain specifies what is being attested
	Domain Domain `json:"domain"`

	// SubjectID is what is being attested (request_id, session_id, or epoch)
	SubjectID core.ID `json:"subjectId"`

	// CommitRoot is the Merkle root being attested
	CommitRoot core.ID `json:"commitRoot"`

	// Epoch when attestation was created
	Epoch uint64 `json:"epoch"`

	// Signers are the node IDs that signed this attestation
	Signers []core.ID `json:"signers"`

	// Signature is the aggregated threshold signature
	Signature []byte `json:"signature"`

	// CreatedAt is when the attestation was created
	CreatedAt time.Time `json:"createdAt"`
}

type Domain string

type EpochBeaconAttestation struct {
	*Attestation
	Randomness core.ID `json:"randomness"`
}

type EquivocationEvidence struct {
	// NodeID of the equivocating node
	NodeID core.ID `json:"nodeId"`

	// First attestation
	First *Attestation `json:"first"`

	// Second conflicting attestation
	Second *Attestation `json:"second"`

	// DetectedAt is when the equivocation was detected
	DetectedAt time.Time `json:"detectedAt"`
}

type MerkleProof struct {
	// LeafIndex is the index of the leaf
	LeafIndex uint32 `json:"leafIndex"`

	// Siblings are the sibling hashes along the path
	Siblings []core.ID `json:"siblings"`

	// IsLeft indicates if the sibling is on the left at each level
	IsLeft []bool `json:"isLeft"`
}

type OracleCommit struct {
	// RequestID this commit is for
	RequestID core.ID `json:"requestId"`

	// MerkleRoot of all records
	MerkleRoot core.ID `json:"merkleRoot"`

	// RecordCount is the number of records
	RecordCount uint32 `json:"recordCount"`

	// Epoch when committed
	Epoch uint64 `json:"epoch"`

	// CommittedAt is when the commit was created
	CommittedAt time.Time `json:"committedAt"`
}

type OracleCommitAttestation struct {
	*Attestation
	RequestID core.ID `json:"requestId"`
}

type OracleRecord struct {
	// RecordID is the unique record identifier
	RecordID core.ID `json:"recordId"`

	// RequestID this record belongs to
	RequestID core.ID `json:"requestId"`

	// SubmitterID is the node that submitted this record
	SubmitterID core.ID `json:"submitterId"`

	// Data is the record payload
	Data []byte `json:"data"`

	// DataHash is the hash of the data
	DataHash core.ID `json:"dataHash"`

	// Signature from the submitter
	Signature []byte `json:"signature"`

	// CreatedAt is when the record was created
	CreatedAt time.Time `json:"createdAt"`
}

type OracleRequest struct {
	// ID is the deterministic request identifier
	// H("LUX:OracleRequest:v1" || service_id || session_id || step || retry || tx_id)
	ID core.ID `json:"id"`

	// ServiceID identifies the service
	ServiceID core.ID `json:"serviceId"`

	// SessionID identifies the session
	SessionID core.ID `json:"sessionId"`

	// StepIndex is the step number
	StepIndex uint32 `json:"stepIndex"`

	// RetryIndex for retry attempts
	RetryIndex uint32 `json:"retryIndex"`

	// TxID that triggered this request
	TxID core.ID `json:"txId"`

	// Kind of request (read or write)
	Kind RequestKind `json:"kind"`

	// Status of the request
	Status RequestStatus `json:"status"`

	// InputHash is the hash of request inputs
	InputHash core.ID `json:"inputHash"`

	// Records collected for this request
	Records []*OracleRecord `json:"records,omitempty"`

	// CommitRoot is the Merkle root of committed records
	CommitRoot core.ID `json:"commitRoot,omitempty"`

	// AttestationID is the attestation over the commit
	AttestationID core.ID `json:"attestationId,omitempty"`

	// CreatedAt is when the request was created
	CreatedAt time.Time `json:"createdAt"`

	// CommittedAt is when records were committed
	CommittedAt time.Time `json:"committedAt,omitempty"`
}

type Receipt struct {
	// ID is the unique receipt identifier
	ID core.ID `json:"id"`

	// SessionID this receipt belongs to
	SessionID core.ID `json:"sessionId"`

	// StepIndex is the step that generated this message
	StepIndex uint32 `json:"stepIndex"`

	// MessageHash is the hash of the relayed message
	MessageHash core.ID `json:"messageHash"`

	// SenderID is the sending node
	SenderID core.ID `json:"senderId"`

	// ReceiverID is the receiving node
	ReceiverID core.ID `json:"receiverId"`

	// Timestamp of relay
	Timestamp time.Time `json:"timestamp"`

	// Signature from the relay node
	Signature []byte `json:"signature"`
}

type ReceiptCommit struct {
	// SessionID this commit is for
	SessionID core.ID `json:"sessionId"`

	// MerkleRoot of all receipts
	MerkleRoot core.ID `json:"merkleRoot"`

	// ReceiptCount is the number of receipts
	ReceiptCount uint32 `json:"receiptCount"`

	// Epoch when committed
	Epoch uint64 `json:"epoch"`

	// CommittedAt is when the commit was created
	CommittedAt time.Time `json:"committedAt"`
}

type ReceiptProof struct {
	*MerkleProof
	Receipt *SignedReceipt `json:"receipt"`
}

type RequestKind uint8

type RequestStatus uint8

type SessionCompleteAttestation struct {
	*Attestation
	SessionID    core.ID `json:"sessionId"`
	OutputHash   core.ID `json:"outputHash"`
	OracleRoot   core.ID `json:"oracleRoot"`
	ReceiptsRoot core.ID `json:"receiptsRoot"`
}

type SignedReceipt struct {
	*Receipt

	// RelayNodeID is the node that relayed the message
	RelayNodeID core.ID `json:"relayNodeId"`

	// RelaySignature is the signature from the relay node
	RelaySignature []byte `json:"relaySignature"`
}