Class GovernanceArtifactSigner
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
recordAuditLedgerRecordoptionsCanonicalPayloadOptionshashAlgorithmstringmetadataIReadOnlyDictionary<string, string>
Returns
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
grantCapabilityGrantoptionsCanonicalPayloadOptionshashAlgorithmstringmetadataIReadOnlyDictionary<string, string>schemaVersionstring
Returns
Remarks
The grant schema version is applied as described for CreateUnsignedCapabilityGrant(CapabilityGrant, CanonicalPayloadOptions?, string?, string?).
Exceptions
- ArgumentException
schemaVersionis 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
receiptIDecisionReceiptoptionsCanonicalPayloadOptionshashAlgorithmstringmetadataIReadOnlyDictionary<string, string>
Returns
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
lifecycleEventDecisionReceiptLifecycleEventoptionsCanonicalPayloadOptionshashAlgorithmstringmetadataIReadOnlyDictionary<string, string>
Returns
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
envelopeGovernanceEmissionEnvelopeoptionsCanonicalPayloadOptionshashAlgorithmstringmetadataIReadOnlyDictionary<string, string>
Returns
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
entryGovernanceOutboxEntryoptionsCanonicalPayloadOptionshashAlgorithmstringmetadataIReadOnlyDictionary<string, string>
Returns
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
canonicalHashCanonicalPayloadHashkeyIdstringkeyVersionstringmetadataIReadOnlyDictionary<string, string>
Returns
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
recordAuditLedgerRecordoptionsCanonicalPayloadOptionshashAlgorithmstring
Returns
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
grantCapabilityGrantoptionsCanonicalPayloadOptionshashAlgorithmstringschemaVersionstring
Returns
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
schemaVersionis 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
receiptIDecisionReceiptoptionsCanonicalPayloadOptionshashAlgorithmstring
Returns
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
lifecycleEventDecisionReceiptLifecycleEventoptionsCanonicalPayloadOptionshashAlgorithmstring
Returns
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
envelopeGovernanceEmissionEnvelopeoptionsCanonicalPayloadOptionshashAlgorithmstring
Returns
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
entryGovernanceOutboxEntryoptionsCanonicalPayloadOptionshashAlgorithmstring
Returns
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
recordAuditLedgerRecordsigningServiceIGovernanceSigningServiceoptionsCanonicalPayloadOptionshashAlgorithmstringkeyIdstringkeyVersionstringmetadataIReadOnlyDictionary<string, string>requireSignatureboolcancellationTokenCancellationToken
Returns
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
grantCapabilityGrantsigningServiceIGovernanceSigningServiceoptionsCanonicalPayloadOptionshashAlgorithmstringkeyIdstringkeyVersionstringmetadataIReadOnlyDictionary<string, string>requireSignatureboolschemaVersionstringcancellationTokenCancellationToken
Returns
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
schemaVersionis StableArtifactsV1 and the grant carries a use limit that the version 1 payload cannot bind.- InvalidOperationException
requireSignatureis 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
receiptIDecisionReceiptsigningServiceIGovernanceSigningServiceoptionsCanonicalPayloadOptionshashAlgorithmstringkeyIdstringkeyVersionstringmetadataIReadOnlyDictionary<string, string>requireSignatureboolcancellationTokenCancellationToken
Returns
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
lifecycleEventDecisionReceiptLifecycleEventsigningServiceIGovernanceSigningServiceoptionsCanonicalPayloadOptionshashAlgorithmstringkeyIdstringkeyVersionstringmetadataIReadOnlyDictionary<string, string>requireSignatureboolcancellationTokenCancellationToken
Returns
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
envelopeGovernanceEmissionEnvelopesigningServiceIGovernanceSigningServiceoptionsCanonicalPayloadOptionshashAlgorithmstringkeyIdstringkeyVersionstringmetadataIReadOnlyDictionary<string, string>requireSignatureboolcancellationTokenCancellationToken
Returns
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
entryGovernanceOutboxEntrysigningServiceIGovernanceSigningServiceoptionsCanonicalPayloadOptionshashAlgorithmstringkeyIdstringkeyVersionstringmetadataIReadOnlyDictionary<string, string>requireSignatureboolcancellationTokenCancellationToken