(Delphi DLL) Exporting and Importing Accumulated Entropy

When a system starts, a good established source of entropy may be lacking. The Fortuna algorithm keeps 32 internal entropy pools. When AddEntropy is called, it is added to these internal pools. (The details of the Fortuna algorithm can be read elsewhere.)

This example demonstrates how the entropy that has accumulated within the internal pools can be exported (such as when an application exits) and then imported when an application starts. (It is the application's job to persist the exported entropy to a database, file, etc.)

Importing entropy helps ensure an application is beginning with an adequate source of entropy for random number generation.

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Prng, Global;

...

procedure TForm1.Button1Click(Sender: TObject);
var
chilkatGlob: HCkGlobal;
success: Boolean;
fortuna: HCkPrng;
exportedEntropy: PWideChar;
fortuna2: HCkPrng;

begin
// All Chilkat classes can be unlocked at once at the beginning of a program
// by calling UnlockBundle.  It requires a Bundle unlock code.
chilkatGlob := CkGlobal_Create();
success := CkGlobal_UnlockBundle(chilkatGlob,'Anything for 30-day trial.');
if (success <> True) then
  begin
    Memo1.Lines.Add(CkGlobal__lastErrorText(chilkatGlob));
    Exit;
  end;

fortuna := CkPrng_Create();

// Generate random data and periodically add entropy...
success := CkPrng_AddEntropy(fortuna,CkPrng__getEntropy(fortuna,32,'hex'),'hex');
Memo1.Lines.Add(CkPrng__genRandom(fortuna,16,'hex'));
Memo1.Lines.Add(CkPrng__genRandom(fortuna,16,'hex'));
Memo1.Lines.Add(CkPrng__genRandom(fortuna,16,'hex'));
success := CkPrng_AddEntropy(fortuna,CkPrng__getEntropy(fortuna,16,'hex'),'hex');
Memo1.Lines.Add(CkPrng__genRandom(fortuna,16,'hex'));
Memo1.Lines.Add(CkPrng__genRandom(fortuna,16,'hex'));
Memo1.Lines.Add(CkPrng__genRandom(fortuna,16,'hex'));
success := CkPrng_AddEntropy(fortuna,CkPrng__getEntropy(fortuna,16,'hex'),'hex');
Memo1.Lines.Add(CkPrng__genRandom(fortuna,16,'hex'));
Memo1.Lines.Add(CkPrng__genRandom(fortuna,16,'hex'));
Memo1.Lines.Add(CkPrng__genRandom(fortuna,16,'hex'));
success := CkPrng_AddEntropy(fortuna,CkPrng__getEntropy(fortuna,16,'hex'),'hex');
Memo1.Lines.Add(CkPrng__genRandom(fortuna,16,'hex'));
Memo1.Lines.Add(CkPrng__genRandom(fortuna,16,'hex'));
Memo1.Lines.Add(CkPrng__genRandom(fortuna,16,'hex'));

exportedEntropy := CkPrng__exportEntropy(fortuna);
// The application would persist the exported entropy in some way,
// such as to a file, or to a database, etc.

// Create a new PRNG object and initialize the internal entropy pools
// with the previously exported entropy:
fortuna2 := CkPrng_Create();
success := CkPrng_ImportEntropy(fortuna2,exportedEntropy);

// Generate more random data, continuing to add entropy as we go along..
Memo1.Lines.Add(CkPrng__genRandom(fortuna2,16,'hex'));
Memo1.Lines.Add(CkPrng__genRandom(fortuna2,16,'hex'));
Memo1.Lines.Add(CkPrng__genRandom(fortuna2,16,'hex'));
success := CkPrng_AddEntropy(fortuna2,CkPrng__getEntropy(fortuna2,16,'hex'),'hex');
Memo1.Lines.Add(CkPrng__genRandom(fortuna2,16,'hex'));
Memo1.Lines.Add(CkPrng__genRandom(fortuna2,16,'hex'));
Memo1.Lines.Add(CkPrng__genRandom(fortuna2,16,'hex'));
success := CkPrng_AddEntropy(fortuna2,CkPrng__getEntropy(fortuna2,16,'hex'),'hex');
// ..

CkGlobal_Dispose(chilkatGlob);
CkPrng_Dispose(fortuna);
CkPrng_Dispose(fortuna2);

end;