update comment

1 files changed, 7 insertions, 2 deletions

diff --git a/ledger/ledgercore/statedelta.go b/ledger/ledgercore/statedelta.go
index 628c557ca..7bea4e833 100644
--- a/ledger/ledgercore/statedelta.go
+++ b/ledger/ledgercore/statedelta.go
@@ -149,9 +149,14 @@ type AssetResourceRecord struct {
 }
 
 // AccountDeltas stores ordered accounts and allows fast lookup by address
+// One key design aspect here was to ensure that we're able to access the written
+// deltas in a deterministic order, while maintaining O(1) lookup. In order to
+// do that, each of the arrays here is constructed as a pair of (slice, map).
+// The map would point the address/address+creatable id onto the index of the
+// element within the slice.
 type AccountDeltas struct {
-	// Actual data. If an account is deleted, `accts` contains a balance record
-	// with empty `AccountData`.
+	// Actual data. If an account is deleted, `accts` contains the NewBalanceRecord
+	// with an empty `AccountData` and a populated `Addr`.
 	accts []NewBalanceRecord
 	// cache for addr to deltas index resolution
 	acctsCache map[basics.Address]int