Class SystemRestoreFileExtensions
Extension methods for administratively restoring a deleted file.
Inherited Members
Namespace: Hiero
Assembly: Hiero.dll
Syntax
public static class SystemRestoreFileExtensions
Methods
| Edit this page View SourceSystemRestoreFileAsync(ConsensusClient, SystemRestoreFileParams, Action<IConsensusContext>?)
Undeletes a file from the network via Administrative Restore
Declaration
public static Task<TransactionReceipt> SystemRestoreFileAsync(this ConsensusClient client, SystemRestoreFileParams restoreParams, Action<IConsensusContext>? configure = null)
Parameters
| Type | Name | Description |
|---|---|---|
| ConsensusClient | client | The Consensus Node Client orchestrating the administrative command. |
| SystemRestoreFileParams | restoreParams | The parameters for the system restore operation, including the file address to restore. |
| Action<IConsensusContext> | configure | Optional callback method providing an opportunity to modify the execution configuration for just this method call. It is executed prior to submitting the request to the network. |
Returns
| Type | Description |
|---|---|
| Task<TransactionReceipt> | A transaction receipt indicating success of the file restoration. |
Examples
// Undo a previous SystemDeleteFileAsync within the grace window.
var receipt = await client.SystemRestoreFileAsync(new SystemRestoreFileParams
{
File = file
});
Console.WriteLine($"System restore status: {receipt.Status}");
Exceptions
| Type | Condition |
|---|---|
| ArgumentException | If required arguments are missing or invalid. |
| InvalidOperationException | If required context configuration is missing. |
| PrecheckException | If the gateway node refused the transaction. Only a code about the transaction itself proves it did not execute; any other code leaves the outcome unknown, so settle it by its transaction id on a mirror node rather than resubmitting it (see PrecheckException). |
| ConsensusException | If the outcome could not be confirmed: the transaction may have executed, so settle it by its transaction id on a mirror node rather than resubmitting it. |
| TransactionException | If the network rejected the restore request as invalid or had missing data. |