Class: Portage::Ucp::Manifest

Inherits:
Object
  • Object
show all
Defined in:
lib/portage/ucp/manifest.rb

Overview

Builds the /.well-known/ucp discovery document: protocol version, the business's advertised capabilities (only those the Adapter overrides — see Capability#advertised_for?), payment handlers, signing keys, and the services array (transport + endpoint, e.g. "mcp", endpoint: "https://...") a client needs to find where to actually connect. Signing keys are never generated here — see §9, consumer-provided only.

Constant Summary collapse

UCP_VERSION = 
"2026-04-08".freeze

Instance Method Summary collapse

Constructor Details

#initialize(adapter:, business: Portage::Ucp.configuration.business, registry: Portage::Ucp.configuration.registry, payment_handlers: Portage::Ucp.configuration.payment_handlers, signing_keys: Portage::Ucp.configuration.signing_keys, signer: Portage::Ucp.configuration.signer, services: Portage::Ucp.configuration.services) ⇒ Manifest

Returns a new instance of Manifest.

Parameters:

  • signer (#kid, #sign) (defaults to: Portage::Ucp.configuration.signer) —

    optional. Consumer-provided — the gem never generates or stores keys itself (§9). sign(canonical_json_string) must return raw signature bytes; kid identifies which entry in signing_keys verifies it (supports a current+next key set for rotation — the caller picks which signer/kid pair is "current"). Algorithm-agnostic by design: the gem doesn't dictate Ed25519 vs RSA.



21
22
23
24
25
26
27
28
29
30
31
32
 
# File 'lib/portage/ucp/manifest.rb', line 21

def initialize(adapter:, business: Portage::Ucp.configuration.business, registry: Portage::Ucp.configuration.registry,
               payment_handlers: Portage::Ucp.configuration.payment_handlers,
               signing_keys: Portage::Ucp.configuration.signing_keys, signer: Portage::Ucp.configuration.signer,
               services: Portage::Ucp.configuration.services)
  @adapter = adapter
  @business = business
  @registry = registry
  @payment_handlers = payment_handlers
  @signing_keys = signing_keys
  @signer = signer
  @services = services
end

Instance Method Details

#to_h ⇒ Object 



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
 
# File 'lib/portage/ucp/manifest.rb', line 34

def to_h
  payload = {
    ucp_version: UCP_VERSION,
    business: @business,
    services: @services,
    capabilities: @registry.advertised(@adapter).map do |capability|
      { name: capability.name, version: capability.version }
    end,
    payment_handlers: @payment_handlers,
    signing_keys: @signing_keys
  }
  return payload unless @signer

  payload.merge(signature: sign(payload))
end