ProofedMesh/services/approval-service/internal/tlog/submitter.go

// Package tlog calls the transparency-log's POST /api/v1/log/entries
// endpoint. Idempotent on the server side: resubmitting the same
// (envelope, content_hash) returns the same log_index + inclusion proof.
// See DEV-600 and services/transparency-log for the server-side contract.
package tlog

import (
	"bytes"
	"context"
	"encoding/json"
	"errors"
	"fmt"
	"io"
	"net/http"
	"net/url"
	"time"

	"basicstack.de/proofedmesh/services/approval-service/internal/signer"
)

// InclusionProof mirrors the server-side ADR-0005 inclusion proof.
type InclusionProof struct {
	TreeSize          int64    `json:"tree_size"`
	TreeRootHash      string   `json:"tree_root_hash"`
	SignedTreeHeadRef string   `json:"signed_tree_head_ref"`
	Hashes            []string `json:"hashes"`
}

// Receipt is what the transparency-log hands back on a successful submit.
type Receipt struct {
	LogIndex       int64          `json:"log_index"`
	ContentHash    string         `json:"content_hash"`
	LoggedAt       time.Time      `json:"logged_at"`
	InclusionProof InclusionProof `json:"inclusion_proof"`
}

// ErrTLogUnavailable classifies connection errors and 5xx responses from
// the transparency-log. Callers (the HTTP /confirm handler) use this to
// decide between returning a logged approval and an attestation-pending
// one — the Approval row is persisted either way.
var ErrTLogUnavailable = errors.New("tlog: transparency-log unavailable")

// Client is the tlog submit client.
type Client struct {
	BaseURL     string
	HTTPClient  *http.Client
	TokenSource signer.TokenSource
}

type submitRequest struct {
	Envelope    signer.Envelope `json:"envelope"`
	ContentHash string          `json:"content_hash"`
}

// Submit sends env + its contentHash to the transparency-log. Returns the
// server receipt on 200/201 (idempotent repeat / fresh insert) and
// ErrTLogUnavailable on any transport-level or 5xx failure. All other
// non-2xx responses are reported with the raw status.
func (c Client) Submit(ctx context.Context, env signer.Envelope, contentHash string) (Receipt, error) {
	if c.BaseURL == "" {
		return Receipt{}, errors.New("tlog.Client: BaseURL is empty")
	}
	hc := c.HTTPClient
	if hc == nil {
		hc = &http.Client{Timeout: 10 * time.Second}
	}
	body, err := json.Marshal(submitRequest{Envelope: env, ContentHash: contentHash})
	if err != nil {
		return Receipt{}, fmt.Errorf("marshal submit: %w", err)
	}
	endpoint, err := url.JoinPath(c.BaseURL, "/api/v1/log/entries")
	if err != nil {
		return Receipt{}, fmt.Errorf("join tlog url: %w", err)
	}
	req, err := http.NewRequestWithContext(ctx, http.MethodPost, endpoint, bytes.NewReader(body))
	if err != nil {
		return Receipt{}, err
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Accept", "application/json")
	if c.TokenSource != nil {
		tok, err := c.TokenSource.Token(ctx)
		if err != nil {
			return Receipt{}, fmt.Errorf("token: %w", err)
		}
		if tok != "" {
			req.Header.Set("Authorization", "Bearer "+tok)
		}
	}
	resp, err := hc.Do(req)
	if err != nil {
		return Receipt{}, fmt.Errorf("%w: %v", ErrTLogUnavailable, err)
	}
	defer resp.Body.Close()
	raw, _ := io.ReadAll(io.LimitReader(resp.Body, 1<<20))
	switch {
	case resp.StatusCode == http.StatusOK, resp.StatusCode == http.StatusCreated:
		// ok
	case resp.StatusCode >= 500:
		return Receipt{}, fmt.Errorf("%w: status %d: %s", ErrTLogUnavailable, resp.StatusCode, truncate(raw, 256))
	default:
		return Receipt{}, fmt.Errorf("tlog: status %d: %s", resp.StatusCode, truncate(raw, 256))
	}
	var out Receipt
	if err := json.Unmarshal(raw, &out); err != nil {
		return Receipt{}, fmt.Errorf("decode receipt: %w", err)
	}
	if out.ContentHash != contentHash {
		return out, fmt.Errorf("tlog returned content_hash %q != sent %q", out.ContentHash, contentHash)
	}
	if out.LogIndex < 0 {
		return out, fmt.Errorf("tlog returned negative log_index %d", out.LogIndex)
	}
	return out, nil
}

func truncate(b []byte, n int) string {
	if len(b) <= n {
		return string(b)
	}
	return string(b[:n]) + "…"
}