Fix flaky localnet e2e tests

[gregnazario]

Description

Localnet CI has been red since early August because examples.read_aggregator assumed APT CoinInfo.supply is always a table-backed aggregator. Recent localnets store that supply as OptionalAggregator.integer instead:

aggregator not found in data: {'supply': {'vec': [{'aggregator': {'vec': []}, 'integer': {'vec': [{'value': '43510', ...}]}}]}}

This also hardens the e2e path against the historical flakes from #31 (faucet SEQUENCE_NUMBER_TOO_OLD and indexer lag).

Changes:

• RestClient.aggregator_value reads either OptionalAggregator variant (aggregator table or integer) and no longer mutates the path list.
• REST GETs/idempotent POSTs and faucet mint calls retry 429/5xx/transport errors; faucet also retries sequence-number races and serializes concurrent fund_account calls on the same client.
• RestClient.wait_until_ready polls ledger info so integration tests wait out localnet startup.
• Integration harness reloads example network config after setting env vars, and sets APTOS_INDEXER_URL=none (the previous APTOS_INDEXER_CLIENT env var was ignored).
• Sequential same-account faucet funding in large_package_publisher; longer indexer poll in transfer_coin.

Test Plan

• make lint
• make test (unit tests + behave specs)
• New unit tests for integer OptionalAggregator, HTTP 503 retry, faucet SEQUENCE_NUMBER_TOO_OLD retry, and wait_until_ready
• Localnet Tests workflow on this PR (make integration_test / make examples)

Related Links

• [Bug] Examples are flaky #31
• Recent Localnet Tests failure: test_read_aggreagtor on main after chore: update Python dependencies #127

  

[codecov]

Codecov Report

❌ Patch coverage is 79.77528% with 18 lines in your changes missing coverage. Please review.
✅ Project coverage is 93.07%. Comparing base (0831ae0) to head (0e7f3d1).

Files with missing lines	Patch %	Lines
aptos_sdk/async_client.py	79.77%	18 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #128      +/-   ##
==========================================
- Coverage   93.20%   93.07%   -0.14%     
==========================================
  Files          56       56              
  Lines        5183     5239      +56     
==========================================
+ Hits         4831     4876      +45     
- Misses        352      363      +11     

Flag	Coverage Δ		*Carryforward flag
v1-sdk	90.17% <79.77%> (-0.19%)	⬇️
v2-sdk	97.02% <ø> (ø)		Carriedforward from 0831ae0

*This pull request uses carry forward flags. Click here to find out more.

Files with missing lines	Coverage Δ
aptos_sdk/async_client.py	90.20% <79.77%> (-1.67%)	⬇️

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.