ARC-62 - ASA Circulating Supply

[cusma]

This ARC introduces a standard to extend the definition of circulating supply for Algorand Standard Assets (ASA) and its client-side retrieval. An Algorand Python reference implementation is suggested (available at ./assets/arc-0062).

For an initial discussion we should focus just on ./ARCs/arc-0062.md.

The majority of reference implementation assets are AlgoKit auto-generated files. In case you are interested in the reference implementation as well, the main files are the contract (source file here) and the tests (source files here).

[SilentRhetoric]

To enable the use case in which getter calls are made on-chain by another application (and not just simulated), would it be reasonable to include the following statement?

The arcXXX_get_circulating_supply method SHOULD not require more foreign references than can be provided on a single applicationCall transaction within the constraints of the Algorand Virtual Machine at the specified minimum AVM version.

This also raises another question, which is: Should the ARC require that its implementations specify the minimum AVM version required to call the method?

[cusma]

I think this is an implementation detail. I would rather add a recommendation for the reference implementation to use an AVM version that supports resource pooling. The specification of the method interface does not really care about how resources are populated (e.g. they could be added to the AppCall directly or provided somehow within the same Group Transaction).

Also, maybe it is worth adding a non normative section in Usage to suggest that, if the method is supposed to be called as C2C call, then the implementation should provide details about foreign resources required to caller apps.