类
class	ISettlementPolicy
	Domain-owned policy hooks used by the common settlement pipeline. 更多...

class	PreparedApply
	Prepared domain mutation used to make settlement application atomic. 更多...

struct	RuleFilter
	Predicate selecting requests to which a rule applies. 更多...

class	Settlement
	Factory module for script-owned settlement protocol runtimes. 更多...

struct	SettlementBatchItemResult
	Indexed owning outcome for one independently committed settlement item. 更多...

struct	SettlementChainContext
	Bounded trigger-chain metadata carried by an owning settlement request. 更多...

class	SettlementContext
	Mutable calculation frame visible to policy and custom stage code. 更多...

class	SettlementPipeline
	Deterministically ordered, composable settlement pipeline. 更多...

struct	SettlementRandomDecision
	Caller-owned deterministic random decision recorded for replay and verification. 更多...

struct	SettlementRequest
	Domain-neutral input to one settlement operation. 更多...

struct	SettlementResult
	Complete observable outcome of one successful settlement. 更多...

struct	SettlementRule
	One owning, serializable projection of a buff/effect contribution. 更多...

class	SettlementRuleSet
	Validated immutable-style rule collection installable into pipelines. 更多...

struct	SettlementStageResult
	Explanation emitted for one executed stage. 更多...

枚举
enum class	StageKind : std::uint8_t { Validate , Decision , SourceModifiers , TargetMitigation , ArmorShield , Clamp , Apply , Trigger , Event }
	Kind of ordered calculation stage in a settlement pipeline. 更多...

enum class	SettlementDisposition : std::uint8_t { Applied , NoOp , Immune , Resisted , PartiallyApplied , Blocked , InvalidTarget }
	Semantic outcome of a completed settlement, distinct from its numeric amount. 更多...

enum class	SettlementTraceLevel : std::uint8_t { Off , Summary , Full }
	Amount of stage explanation retained by one settlement request. 更多...

enum class	RuleOperation : std::uint8_t { Add , Multiply , ResistFlat , ResistPercent , AbsorbFlat , ClampMaximum , Critical , Immune , Lifesteal , Reflect }
	Supported deterministic mutations of a settlement calculation. 更多...

函数
eve::Result< void >	validateSettlementRequest (const SettlementRequest &request)
	Validate the canonical semantic invariants of a settlement request.

const char *	stageKindName (StageKind kind) noexcept
	Return the stable lowercase spelling of a stage kind.

const char *	settlementDispositionName (SettlementDisposition disposition) noexcept
	Return the stable lowercase spelling of a settlement disposition.

EVENGINE_API_FOUNDATION eve::Result< std::string >	settlementResultCanonicalJson (const SettlementResult &result)
	Serialize the stable semantic fields of a settlement result as canonical JSON.

EVENGINE_API_FOUNDATION eve::Result< eve::ContentId >	settlementResultDigest (const SettlementResult &result, const eve::SnapshotHashProvider &hashProvider)
	Hash the canonical semantic representation of a settlement result.

EVENGINE_API_FOUNDATION eve::Result< std::vector< std::string > >	verifySettlementResult (const SettlementResult &expected, const SettlementResult &actual)
	Compare two settlement results and report stable field paths that differ.

EVENGINE_API_FOUNDATION eve::Result< std::string >	createSettlementReplayRecord (const SettlementRequest &request, eve::ContentId ruleDigest, const SettlementResult &result, const eve::SnapshotHashProvider &hashProvider)
	Serialize one replayable request with its rule and expected-result identities.

EVENGINE_API_FOUNDATION eve::Result< SettlementRequest >	settlementReplayRequest (std::string_view recordJson)
	Decode the request from a strict version-1 replay record.

EVENGINE_API_FOUNDATION eve::Result< std::vector< std::string > >	verifySettlementReplayRecord (std::string_view recordJson, eve::ContentId ruleDigest, const SettlementResult &actual, const eve::SnapshotHashProvider &hashProvider)
	Verify current rules and outcome against a strict replay record.

eve::Result< SettlementRuleSet >	projectEffectRules (const effects::EffectContainer &effects, std::string_view scope)
	Project active effect payloads into an owning settlement rule snapshot.

	Module_IMPL (Settlement, new Settlement())

枚举类型说明

◆ RuleOperation

enum class eve::settlement::RuleOperation : std::uint8_t

strong

Supported deterministic mutations of a settlement calculation.

枚举值
Add
Multiply
ResistFlat
ResistPercent
AbsorbFlat
ClampMaximum
Critical
Immune
Lifesteal
Reflect

在文件 SettlementRules.h 第 22 行定义.

◆ SettlementDisposition

enum class eve::settlement::SettlementDisposition : std::uint8_t

strong

Semantic outcome of a completed settlement, distinct from its numeric amount.

枚举值
Applied
NoOp
Immune
Resisted
PartiallyApplied
Blocked
InvalidTarget

在文件 Settlement.h 第 49 行定义.

◆ SettlementTraceLevel

enum class eve::settlement::SettlementTraceLevel : std::uint8_t

strong

Amount of stage explanation retained by one settlement request.

枚举值
Off
Summary
Full

在文件 Settlement.h 第 60 行定义.

◆ StageKind

enum class eve::settlement::StageKind : std::uint8_t

strong

Kind of ordered calculation stage in a settlement pipeline.

枚举值
Validate
Decision
SourceModifiers
TargetMitigation
ArmorShield
Clamp
Apply
Trigger
Event

在文件 Settlement.h 第 36 行定义.

函数说明

◆ createSettlementReplayRecord()

eve::Result< std::string > eve::settlement::createSettlementReplayRecord	(	const SettlementRequest &	request,
		eve::ContentId	ruleDigest,
		const SettlementResult &	result,
		const eve::SnapshotHashProvider &	hashProvider
	)

Serialize one replayable request with its rule and expected-result identities.

参数

request	Owning deterministic input, including recorded random decisions.
ruleDigest	Content identity of the validated rule snapshot used for execution.
result	Expected semantic outcome retained for detailed verification.
hashProvider	Explicit provider used to protect the expected result payload.

返回: Strict versioned replay-record JSON, or a structured failure. @cost Linear in request, trace, event payload, and derived request count plus hashing.

在文件 SettlementReplay.cpp 第 610 行定义.

引用了 eve::Result< T >::failure(), eve::detail::Id128< Tag >::format(), eve::InvalidArgument, eve::detail::Id128< Tag >::isNil(), eve::PreconditionViolation , 以及 request.

◆ Module_IMPL()

eve::settlement::Module_IMPL	(	Settlement	,
		new	Settlement()
	)

◆ projectEffectRules()

EVENGINE_API_FOUNDATION eve::Result< SettlementRuleSet > eve::settlement::projectEffectRules	(	const effects::EffectContainer &	effects,
		std::string_view	scope
	)

Project active effect payloads into an owning settlement rule snapshot.

参数

effects	Sole lifecycle owner inspected synchronously; no pointers are retained.
scope	Non-empty stable prefix distinguishing source, target, or domain containers.

返回: Validated rules for payloads containing settlement.rule, or a located diagnostic. @thread Call on the effect container's owning simulation thread. @reentrancy No callbacks are invoked. @cost Linear in active effect count and projected condition source length.

在文件 SettlementEffectProjection.cpp 第 109 行定义.

被这些函数引用 eve::card::CardEffectExecutor::applyImmediate() , 以及 eve::card::CardEffectExecutor::settle().

◆ settlementDispositionName()

EVENGINE_API_FOUNDATION const char * eve::settlement::settlementDispositionName ( SettlementDisposition disposition )

noexcept

Return the stable lowercase spelling of a settlement disposition.

返回: Borrowed non-null pointer to immutable process-lifetime storage. @ownership The returned static text is not caller-owned and must not be freed. @lifetime Valid for the lifetime of the process; copy it when storing it. @thread Thread-safe because the characters are immutable. @reentrancy Does not invoke callbacks.

在文件 Settlement.cpp 第 256 行定义.

引用了 Applied, Blocked, Immune, InvalidTarget, NoOp, PartiallyApplied , 以及 Resisted.

◆ settlementReplayRequest()

eve::Result< SettlementRequest > eve::settlement::settlementReplayRequest ( std::string_view recordJson )

Decode the request from a strict version-1 replay record.

返回: Owning request, or a located schema/version/type diagnostic.

备注: Unknown fields are rejected; no gameplay state is mutated. @cost Linear in replay-record size.

在文件 SettlementReplay.cpp 第 636 行定义.

引用了 eve::Result< T >::failure() , 以及 root.

◆ settlementResultCanonicalJson()

eve::Result< std::string > eve::settlement::settlementResultCanonicalJson ( const SettlementResult & result )

Serialize the stable semantic fields of a settlement result as canonical JSON.

返回: Versioned canonical JSON, or a structured serialization failure.

备注: Stream-assigned event identity and sequence are intentionally excluded. @cost Linear in the result trace, event payload, and derived request count.

在文件 SettlementReplay.cpp 第 550 行定义.

引用了 eve::Result< T >::failure().

被这些函数引用 settlementResultDigest().

◆ settlementResultDigest()

eve::Result< eve::ContentId > eve::settlement::settlementResultDigest	(	const SettlementResult &	result,
		const eve::SnapshotHashProvider &	hashProvider
	)

Hash the canonical semantic representation of a settlement result.

参数

result	Result whose stable semantic fields are hashed.
hashProvider	Explicit digest provider shared with snapshot infrastructure.

返回: Content identity, or a structured failure when serialization or hashing fails. @cost Linear serialization plus the injected provider's hashing cost.

在文件 SettlementReplay.cpp 第 556 行定义.

引用了 eve::Result< T >::failure(), eve::PreconditionViolation , 以及 settlementResultCanonicalJson().

◆ stageKindName()

EVENGINE_API_FOUNDATION const char * eve::settlement::stageKindName ( StageKind kind )

noexcept

Return the stable lowercase spelling of a stage kind.

返回: Borrowed non-null pointer to immutable process-lifetime storage. @ownership The returned static text is not caller-owned and must not be freed. @lifetime Valid for the lifetime of the process; copy it when storing it. @thread Thread-safe because the characters are immutable. @reentrancy Does not invoke callbacks.

在文件 Settlement.cpp 第 241 行定义.

引用了 Apply, ArmorShield, Clamp, Decision, Event, kind, SourceModifiers, TargetMitigation, Trigger , 以及 Validate.

◆ validateSettlementRequest()

EVENGINE_API_FOUNDATION eve::Result< void > eve::settlement::validateSettlementRequest ( const SettlementRequest & request )

Validate the canonical semantic invariants of a settlement request.

参数

request Request to inspect without mutation.

返回: Success, or a structured diagnostic whose path is relative to the request root. @thread Thread-safe for an immutable request. @reentrancy Does not invoke callbacks. @cost Linear in recorded decisions and trigger-path length.

在文件 Settlement.cpp 第 40 行定义.

引用了 eve::Conflict, eve::Diagnostic::error(), eve::Result< T >::failure(), index, eve::InvalidArgument, path, previous, request, status , 以及 eve::Result< T >::success().

被这些函数引用 eve::settlement::SettlementPipeline::SettlementPipeline().

◆ verifySettlementReplayRecord()

eve::Result< std::vector< std::string > > eve::settlement::verifySettlementReplayRecord	(	std::string_view	recordJson,
		eve::ContentId	ruleDigest,
		const SettlementResult &	actual,
		const eve::SnapshotHashProvider &	hashProvider
	)

Verify current rules and outcome against a strict replay record.

返回: Deterministic field paths that differ; empty means equivalent.

备注: The record's stored result digest is checked before comparison. @cost Linear parse, canonicalization, recursive comparison, and hashing cost.

在文件 SettlementReplay.cpp 第 643 行定义.

引用了 eve::Applied, code, eve::HashMismatch, eve::NoOp, eve::detail::Id128< Tag >::parse(), eve::ParseError, eve::PreconditionViolation, root , 以及 eve::Status::success().

◆ verifySettlementResult()

eve::Result< std::vector< std::string > > eve::settlement::verifySettlementResult	(	const SettlementResult &	expected,
		const SettlementResult &	actual
	)

Compare two settlement results and report stable field paths that differ.

返回: Owning deterministic list of differing field paths; empty means equivalent. @cost Linear in both result traces, events, and derived request lists.

在文件 SettlementReplay.cpp 第 566 行定义.