Algokit dispenser stops working after localnet round 30,000

[tasosbit]

Update: This is related to the method algokit-utils-ts uses to find the dispenser account. It utilizes the Online attribute, which on localnet "disappears" after round 30,000.

---

We initially encountered this while developing Algoland, where we wanted an extended test suite to run with thousands of accounts participating in the VRF draw.

After a certain number of accounts (6-8K on my machine), localnet.context.generateAccount() fails:

Error retrieving LocalNet dispenser account; couldn't find the default account in KMD

The dispenser account seems to be lost after this, as all tests will fail immediately with the same error.

I have a simple repro repo here where the tests try to generate 20K accounts.

I'm not familiar enough with KMD (or how algokit uses it) to investigate what exactly got stuck

FYI this is not a blocker atmo, as we circumvented algokit-utils / KMD entirely for the algoland use case - we generate accounts with algosdk and store mnemonics in-memory. Thought to report as this will likely surface for other users as well

Not certain if this is the right repo to open in, feel free to move or ask me to recreate if it is in the wrong place

[tasosbit]

Found the issue. In algokit-utils-ts we do:

    const dispenser = await this.getWalletAccount('unencrypted-default-wallet', (a) => a.status !== 'Offline' && a.amount > 1_000_000_000)
    if (!dispenser) {
      throw new Error("Error retrieving LocalNet dispenser account; couldn't find the default account in KMD")
    }

Note the !Offline requirement. The default accounts in unencrypted-default-wallet have a vote-last-valid-round of 30K:

root@610831a11512:~# goal account list -w unencrypted-default-wallet
[online]	CXGC4W6M442HFERAL5UDOP5YDBB3YM43UHH2YL7XYXWTDDMHGKZ7SCFIPY	CXGC4W6M442HFERAL5UDOP5YDBB3YM43UHH2YL7XYXWTDDMHGKZ7SCFIPY	2000000000000000 microAlgos
[online]	PLAS2CIQ3PU37Q3S5YPKAGEUS5C7WSF2SRV223HRK5V4GCFE2543P2EB4U	PLAS2CIQ3PU37Q3S5YPKAGEUS5C7WSF2SRV223HRK5V4GCFE2543P2EB4U	4000000000000000 microAlgos
[online]	2UMD2NFV5GX2D5M3U7BVFYGLKF6WJI5EVUPLTG6ZW2WISWWDL2TWV4LI7A	2UMD2NFV5GX2D5M3U7BVFYGLKF6WJI5EVUPLTG6ZW2WISWWDL2TWV4LI7A	4000000000000000 microAlgos
root@610831a11512:~# goal account dump -a CXGC4W6M442HFERAL5UDOP5YDBB3YM43UHH2YL7XYXWTDDMHGKZ7SCFIPY -w unencrypted-default-wallet
{
  "addr": "CXGC4W6M442HFERAL5UDOP5YDBB3YM43UHH2YL7XYXWTDDMHGKZ7SCFIPY",
  "algo": 2000000000000000,
  "onl": 1,
  "sel": "oV8+bEiSIZn/8ImiQMTohoHYOF/GC3Hd0MP2vgA4RNA=",
  "stprf": "01i8cVwRvyLw9/0H064FcVG2ziTFhXmD8FrvRgtOjBl2UTOrCZUdOAZ1OuZL1A++zh8OqTLckmpRB45mUHIpsw==",
  "vote": "P76S6xZcQMQsgKt6+37nyVH3xsFoPMdfOc2d9hCO3Ok=",
  "voteKD": 10000,
  "voteLst": 30000
}

So after round 30K has elapsed, the dispenser account is still there but can not be found

[tasosbit]

From offline discussion: I would suggest changing the approach of selecting the dispenser to utilize the Genesis file instead of the current Online/min-balance approach

• Fetch localnet genesis file
• Look for the account with label/comment Wallet1
• Ask KMD for this key specifically

Aside from removing the dependency on the account being online (which underlies this bug) this would also:

• change the current approach which fetches all keys from KMD in order to select the right one. By default there should only be 3 keys in that wallet, but if there are (many) more this operation can take significant time.
• Deterministically "pin" the dispenser to the same account for each instance of the network. The previous code relied on KMD always returning the accounts in the same order - not sure if this is guaranteed / enforced.