Table of Contents

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
GovernanceArtifactSigner
Inherited Members

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>

CreateSigningReadyCapabilityGrant(CapabilityGrant, CanonicalPayloadOptions?, string?, IReadOnlyDictionary<string, string>?, string?)

Creates signing-ready metadata for a capability grant without invoking a signing provider.

public static SignedGovernanceArtifact<CapabilityGrant> CreateSigningReadyCapabilityGrant(CapabilityGrant grant, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null, IReadOnlyDictionary<string, string>? metadata = null, string? schemaVersion = null)

Parameters

grant CapabilityGrant
options CanonicalPayloadOptions
hashAlgorithm string
metadata IReadOnlyDictionary<string, string>
schemaVersion string

Returns

SignedGovernanceArtifact<CapabilityGrant>

Remarks

Exceptions

ArgumentException

schemaVersion is StableArtifactsV1 and the grant carries a use limit that the version 1 payload cannot bind.

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>

CreateUnsignedCapabilityGrant(CapabilityGrant, CanonicalPayloadOptions?, string?, string?)

Creates an unsigned wrapper for a capability grant.

public static SignedGovernanceArtifact<CapabilityGrant> CreateUnsignedCapabilityGrant(CapabilityGrant grant, CanonicalPayloadOptions? options = null, string? hashAlgorithm = null, string? schemaVersion = null)

Parameters

grant CapabilityGrant
options CanonicalPayloadOptions
hashAlgorithm string
schemaVersion string

Returns

SignedGovernanceArtifact<CapabilityGrant>

Remarks

The grant is wrapped under schemaVersion, which defaults to StableArtifactsV2 so MaxUseCount is part of the canonical payload. The returned Artifact carries that schema version and is the grant to transport.

Exceptions

ArgumentException

schemaVersion is StableArtifactsV1 and the grant carries a use limit that the version 1 payload cannot bind.

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>>

SignCapabilityGrantAsync(CapabilityGrant, IGovernanceSigningService, CanonicalPayloadOptions?, string?, string?, string?, IReadOnlyDictionary<string, string>?, bool, string?, CancellationToken)

Signs a capability grant after canonical payload hashing.

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

Parameters

grant CapabilityGrant
signingService IGovernanceSigningService
options CanonicalPayloadOptions
hashAlgorithm string
keyId string
keyVersion string
metadata IReadOnlyDictionary<string, string>
requireSignature bool
schemaVersion string
cancellationToken CancellationToken

Returns

ValueTask<SignedGovernanceArtifact<CapabilityGrant>>

Remarks

The grant is signed under schemaVersion, which defaults to StableArtifactsV2 so the issuer-bound MaxUseCount is covered by the signature. A grant created with another schema version is re-created under the requested one, and the returned Artifact is the grant that was signed.

Verifiers rebuild the payload with ProofPayloadOptions, so options must match what the relying party configures. Use CapabilityGrantToken to carry the result to a relying party.

Exceptions

ArgumentException

schemaVersion is StableArtifactsV1 and the grant carries a use limit that the version 1 payload cannot bind.

InvalidOperationException

requireSignature is true and the signing provider returned no signature.

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>>