Class GovernanceArtifactSigner

Namespace

AsiBackbone.Core.Signing

Assembly

AsiBackbone.Core.dll

Provides provider-neutral helper methods for preparing and signing AsiBackbone governance artifacts.

public static class GovernanceArtifactSigner

Inheritance

object

GovernanceArtifactSigner

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Remarks

The helpers canonicalize and hash artifacts before optionally invoking IGovernanceSigningService. They do not verify signatures, persist records, provide immutable storage, or make tamper-evidence claims.

Methods

CreateSigningReadyAuditLedgerRecord(AuditLedgerRecord, CanonicalPayloadOptions?, string?, IReadOnlyDictionary<string, string>?)

Creates signing-ready metadata for a persistence-ready audit ledger record without invoking a signing provider.

public static SignedGovernanceArtifact<AuditLedgerRecord> CreateSigningReadyAuditLedgerRecord(AuditLedgerRecord record, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null, IReadOnlyDictionary<string, string>? metadata = null)

Parameters

record AuditLedgerRecord

options CanonicalPayloadOptions

hashAlgorithm string

metadata IReadOnlyDictionary<string, string>

Returns

SignedGovernanceArtifact<AuditLedgerRecord>

CreateSigningReadyDecisionReceipt(IDecisionReceipt, CanonicalPayloadOptions?, string?, IReadOnlyDictionary<string, string>?)

Creates signing-ready metadata for decision receipt without invoking a signing provider.

public static SignedGovernanceArtifact<IDecisionReceipt> CreateSigningReadyDecisionReceipt(IDecisionReceipt receipt, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null, IReadOnlyDictionary<string, string>? metadata = null)

Parameters

receipt IDecisionReceipt

options CanonicalPayloadOptions

hashAlgorithm string

metadata IReadOnlyDictionary<string, string>

Returns

SignedGovernanceArtifact<IDecisionReceipt>

CreateSigningReadyDecisionReceiptLifecycleEvent(DecisionReceiptLifecycleEvent, CanonicalPayloadOptions?, string?, IReadOnlyDictionary<string, string>?)

Creates signing-ready metadata for an decision receipt lifecycle event without invoking a signing provider.

public static SignedGovernanceArtifact<DecisionReceiptLifecycleEvent> CreateSigningReadyDecisionReceiptLifecycleEvent(DecisionReceiptLifecycleEvent lifecycleEvent, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null, IReadOnlyDictionary<string, string>? metadata = null)

Parameters

lifecycleEvent DecisionReceiptLifecycleEvent

options CanonicalPayloadOptions

hashAlgorithm string

metadata IReadOnlyDictionary<string, string>

Returns

SignedGovernanceArtifact<DecisionReceiptLifecycleEvent>

CreateSigningReadyGovernanceEmissionEnvelope(GovernanceEmissionEnvelope, CanonicalPayloadOptions?, string?, IReadOnlyDictionary<string, string>?)

Creates signing-ready metadata for a governance emission envelope without invoking a signing provider.

public static SignedGovernanceArtifact<GovernanceEmissionEnvelope> CreateSigningReadyGovernanceEmissionEnvelope(GovernanceEmissionEnvelope envelope, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null, IReadOnlyDictionary<string, string>? metadata = null)

Parameters

envelope GovernanceEmissionEnvelope

options CanonicalPayloadOptions

hashAlgorithm string

metadata IReadOnlyDictionary<string, string>

Returns

SignedGovernanceArtifact<GovernanceEmissionEnvelope>

CreateSigningReadyGovernanceOutboxEntry(GovernanceOutboxEntry, CanonicalPayloadOptions?, string?, IReadOnlyDictionary<string, string>?)

Creates signing-ready metadata for an outbox entry without invoking a signing provider.

public static SignedGovernanceArtifact<GovernanceOutboxEntry> CreateSigningReadyGovernanceOutboxEntry(GovernanceOutboxEntry entry, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null, IReadOnlyDictionary<string, string>? metadata = null)

Parameters

entry GovernanceOutboxEntry

options CanonicalPayloadOptions

hashAlgorithm string

metadata IReadOnlyDictionary<string, string>

Returns

SignedGovernanceArtifact<GovernanceOutboxEntry>

CreateSigningRequest(CanonicalPayloadHash, string?, string?, IReadOnlyDictionary<string, string>?)

Creates a signing request from canonical payload hash metadata.

public static SigningRequest CreateSigningRequest(CanonicalPayloadHash canonicalHash, string? keyId = null, string? keyVersion = null, IReadOnlyDictionary<string, string>? metadata = null)

Parameters

canonicalHash CanonicalPayloadHash

keyId string

keyVersion string

metadata IReadOnlyDictionary<string, string>

Returns

SigningRequest

CreateUnsignedAuditLedgerRecord(AuditLedgerRecord, CanonicalPayloadOptions?, string?)

Creates an unsigned wrapper for a persistence-ready audit ledger record.

public static SignedGovernanceArtifact<AuditLedgerRecord> CreateUnsignedAuditLedgerRecord(AuditLedgerRecord record, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null)

Parameters

record AuditLedgerRecord

options CanonicalPayloadOptions

hashAlgorithm string

Returns

SignedGovernanceArtifact<AuditLedgerRecord>

CreateUnsignedDecisionReceipt(IDecisionReceipt, CanonicalPayloadOptions?, string?)

Creates an unsigned wrapper for decision receipt.

public static SignedGovernanceArtifact<IDecisionReceipt> CreateUnsignedDecisionReceipt(IDecisionReceipt receipt, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null)

Parameters

receipt IDecisionReceipt

options CanonicalPayloadOptions

hashAlgorithm string

Returns

SignedGovernanceArtifact<IDecisionReceipt>

CreateUnsignedDecisionReceiptLifecycleEvent(DecisionReceiptLifecycleEvent, CanonicalPayloadOptions?, string?)

Creates an unsigned wrapper for an decision receipt lifecycle event.

public static SignedGovernanceArtifact<DecisionReceiptLifecycleEvent> CreateUnsignedDecisionReceiptLifecycleEvent(DecisionReceiptLifecycleEvent lifecycleEvent, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null)

Parameters

lifecycleEvent DecisionReceiptLifecycleEvent

options CanonicalPayloadOptions

hashAlgorithm string

Returns

SignedGovernanceArtifact<DecisionReceiptLifecycleEvent>

CreateUnsignedGovernanceEmissionEnvelope(GovernanceEmissionEnvelope, CanonicalPayloadOptions?, string?)

Creates an unsigned wrapper for a governance emission envelope.

public static SignedGovernanceArtifact<GovernanceEmissionEnvelope> CreateUnsignedGovernanceEmissionEnvelope(GovernanceEmissionEnvelope envelope, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null)

Parameters

envelope GovernanceEmissionEnvelope

options CanonicalPayloadOptions

hashAlgorithm string

Returns

SignedGovernanceArtifact<GovernanceEmissionEnvelope>

CreateUnsignedGovernanceOutboxEntry(GovernanceOutboxEntry, CanonicalPayloadOptions?, string?)

Creates an unsigned wrapper for an outbox entry.

public static SignedGovernanceArtifact<GovernanceOutboxEntry> CreateUnsignedGovernanceOutboxEntry(GovernanceOutboxEntry entry, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null)

Parameters

entry GovernanceOutboxEntry

options CanonicalPayloadOptions

hashAlgorithm string

Returns

SignedGovernanceArtifact<GovernanceOutboxEntry>

SignAuditLedgerRecordAsync(AuditLedgerRecord, IGovernanceSigningService, CanonicalPayloadOptions?, string?, string?, string?, IReadOnlyDictionary<string, string>?, bool, CancellationToken)

Signs a persistence-ready audit ledger record after canonical payload hashing.

public static ValueTask<SignedGovernanceArtifact<AuditLedgerRecord>> SignAuditLedgerRecordAsync(AuditLedgerRecord record, IGovernanceSigningService signingService, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null, string? keyId = null, string? keyVersion = null, IReadOnlyDictionary<string, string>? metadata = null, bool requireSignature = true, CancellationToken cancellationToken = default)

Parameters

record AuditLedgerRecord

signingService IGovernanceSigningService

options CanonicalPayloadOptions

hashAlgorithm string

keyId string

keyVersion string

metadata IReadOnlyDictionary<string, string>

requireSignature bool

cancellationToken CancellationToken

Returns

ValueTask<SignedGovernanceArtifact<AuditLedgerRecord>>

SignDecisionReceiptAsync(IDecisionReceipt, IGovernanceSigningService, CanonicalPayloadOptions?, string?, string?, string?, IReadOnlyDictionary<string, string>?, bool, CancellationToken)

Signs decision receipt after canonical payload hashing.

public static ValueTask<SignedGovernanceArtifact<IDecisionReceipt>> SignDecisionReceiptAsync(IDecisionReceipt receipt, IGovernanceSigningService signingService, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null, string? keyId = null, string? keyVersion = null, IReadOnlyDictionary<string, string>? metadata = null, bool requireSignature = true, CancellationToken cancellationToken = default)

Parameters

receipt IDecisionReceipt

signingService IGovernanceSigningService

options CanonicalPayloadOptions

hashAlgorithm string

keyId string

keyVersion string

metadata IReadOnlyDictionary<string, string>

requireSignature bool

cancellationToken CancellationToken

Returns

ValueTask<SignedGovernanceArtifact<IDecisionReceipt>>

SignDecisionReceiptLifecycleEventAsync(DecisionReceiptLifecycleEvent, IGovernanceSigningService, CanonicalPayloadOptions?, string?, string?, string?, IReadOnlyDictionary<string, string>?, bool, CancellationToken)

Signs an decision receipt lifecycle event after canonical payload hashing.

public static ValueTask<SignedGovernanceArtifact<DecisionReceiptLifecycleEvent>> SignDecisionReceiptLifecycleEventAsync(DecisionReceiptLifecycleEvent lifecycleEvent, IGovernanceSigningService signingService, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null, string? keyId = null, string? keyVersion = null, IReadOnlyDictionary<string, string>? metadata = null, bool requireSignature = true, CancellationToken cancellationToken = default)

Parameters

lifecycleEvent DecisionReceiptLifecycleEvent

signingService IGovernanceSigningService

options CanonicalPayloadOptions

hashAlgorithm string

keyId string

keyVersion string

metadata IReadOnlyDictionary<string, string>

requireSignature bool

cancellationToken CancellationToken

Returns

ValueTask<SignedGovernanceArtifact<DecisionReceiptLifecycleEvent>>

SignGovernanceEmissionEnvelopeAsync(GovernanceEmissionEnvelope, IGovernanceSigningService, CanonicalPayloadOptions?, string?, string?, string?, IReadOnlyDictionary<string, string>?, bool, CancellationToken)

Signs a governance emission envelope after canonical payload hashing.

public static ValueTask<SignedGovernanceArtifact<GovernanceEmissionEnvelope>> SignGovernanceEmissionEnvelopeAsync(GovernanceEmissionEnvelope envelope, IGovernanceSigningService signingService, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null, string? keyId = null, string? keyVersion = null, IReadOnlyDictionary<string, string>? metadata = null, bool requireSignature = true, CancellationToken cancellationToken = default)

Parameters

envelope GovernanceEmissionEnvelope

signingService IGovernanceSigningService

options CanonicalPayloadOptions

hashAlgorithm string

keyId string

keyVersion string

metadata IReadOnlyDictionary<string, string>

requireSignature bool

cancellationToken CancellationToken

Returns

ValueTask<SignedGovernanceArtifact<GovernanceEmissionEnvelope>>

SignGovernanceOutboxEntryAsync(GovernanceOutboxEntry, IGovernanceSigningService, CanonicalPayloadOptions?, string?, string?, string?, IReadOnlyDictionary<string, string>?, bool, CancellationToken)

Signs an outbox entry after canonical payload hashing.

public static ValueTask<SignedGovernanceArtifact<GovernanceOutboxEntry>> SignGovernanceOutboxEntryAsync(GovernanceOutboxEntry entry, IGovernanceSigningService signingService, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null, string? keyId = null, string? keyVersion = null, IReadOnlyDictionary<string, string>? metadata = null, bool requireSignature = true, CancellationToken cancellationToken = default)

Parameters

entry GovernanceOutboxEntry

signingService IGovernanceSigningService

options CanonicalPayloadOptions

hashAlgorithm string

keyId string

keyVersion string

metadata IReadOnlyDictionary<string, string>

requireSignature bool

cancellationToken CancellationToken

Returns

ValueTask<SignedGovernanceArtifact<GovernanceOutboxEntry>>