Skip to main content

Module kernel

Module kernel 

Source
Available on crate feature payments only.
Expand description

Canonical commerce kernel contracts.

The kernel exposes protocol-neutral command types, state-transition errors, cross-protocol correlation, and backend-facing service traits used by ACP stable 2026-01-30 and AP2 v0.1-alpha (2026-03-22) adapters.

Modules§

commands
correlator
Kernel-mediated cross-protocol correlation.
errors
service

Structs§

BeginInterventionCommand
Canonical request to start an intervention flow.
CancelCheckoutCommand
Canonical request to cancel a checkout or transaction.
CommerceContext
Shared metadata supplied with canonical commerce commands.
CompleteCheckoutCommand
Canonical request to finalize checkout and produce an order.
ContinueInterventionCommand
Canonical request to resume or complete an intervention flow.
CreateCheckoutCommand
Canonical request to create a checkout session or AP2 cart negotiation.
DelegatePaymentAllowance
Canonical delegated-payment allowance preserved across protocol adapters.
DelegatePaymentCommand
Canonical request to tokenize or delegate a payment credential.
DelegatedPaymentResult
Canonical delegated-payment result returned by payment-token services.
DelegatedRiskSignal
Canonical risk signal attached to delegated-payment requests.
EvidenceLookup
Canonical lookup for one stored evidence artifact.
ExecutePaymentCommand
Canonical payment-execution request shared by ACP and AP2 adapters.
ListUnresolvedTransactionsRequest
Canonical request to list unresolved transactions.
LossyConversionError
Describes an unsafe cross-protocol conversion that the kernel refuses.
OrderUpdateCommand
Canonical order-state update emitted after checkout completion.
PaymentExecutionResult
Canonical payment execution result returned by payment backends.
ProtocolCorrelator
Cross-protocol correlator that routes ACP and AP2 adapters through the same canonical transaction ID and journal model.
StoreEvidenceCommand
Canonical request to persist one evidence artifact.
StoredEvidence
Stored evidence returned by the evidence store.
SyncPaymentOutcomeCommand
Canonical request to sync asynchronous payment outcomes back into the kernel.
TransactionLookup
Canonical lookup by transaction identifier and optional session identity.
UpdateCheckoutCommand
Canonical request to update checkout state before payment execution.

Enums§

PaymentExecutionOutcome
Canonical payment outcome type used by the execution service.
PaymentsKernelError
Local kernel errors that map into the ADK structured error envelope.
ProjectionResult
Result of a canonical projection attempt.
ProtocolOrigin
Describes the originating protocol for a correlation operation.
ProtocolRefKind
Describes a specific protocol reference slot in ProtocolRefs.

Traits§

DelegatedPaymentService
Backend-facing delegated-payment tokenization operations.
EvidenceStore
Raw evidence storage used to preserve immutable protocol artifacts.
InterventionService
Backend-facing intervention lifecycle operations.
MerchantCheckoutService
Backend-facing checkout operations shared by ACP and AP2 adapters.
PaymentExecutionService
Backend-facing payment execution operations shared by ACP and AP2 adapters.
TransactionStore
Durable structured transaction storage keyed by canonical transaction ID.