[isaacdoidge]

What

The examples now run as shipped:

• They default to Devnet.
• They take the network and an optional funded key from the environment.
• Without a key, each example except faucet.py funds one account from the faucet, and retries a TryLater answer
  a bounded number of times. With a key, only faucet.py calls the faucet.
• They need no sibling aptos-core checkout or Move toolchain.

A scheduled workflow runs all of them against Devnet.

Changes

• examples/common.py:
  • SUPRA_RPC_NODE_URL defaults to https://rpc-devnet.supra.com. SUPRA_FAUCET_URL defaults to the RPC URL.
  • SUPRA_EXAMPLES_PRIVATE_KEY (hex) is optional; an empty or whitespace-only value counts as unset.
  • fund_accounts with a key funds each account by transfer from the key's account. It first checks that the
    balance covers the amounts plus gas, and names the shortfall in SUPRA.
  • Without a key it funds a generated funder from the faucet and transfers from it. A TryLater answer is retried:
    at most 5 requests, with pauses of 5, 10, 20 and 40 s, failing after the fifth TryLater. Only the request is
    retried; after the faucet accepts one, the example waits once for its transaction and fails unless it ends in
    Success, so an accepted request is never repeated.
  • The balance check reserves 2,000 gas units per transfer. A transfer to a new account uses about 1,000 units on
    Devnet today and the SDK's max gas estimate is 1.5 times that; the check is made before sending.
  • It refuses chain ID 8 (Mainnet). It prints addresses, never keys.
• Compiled Move packages:
  • examples/move/packages.json holds the metadata and bytecode of hello_blockchain, moon_coin and
    upgrade_and_govern (genesis and upgrade). They are compiled from the Apache-2.0 sources at
    Entropy-Foundation/aptos-core tag aptosvm-v1.16_supra-v1.8.9.
  • compiled_package replaces the placeholder publisher address (32 random bytes, matched exactly) with the
    publisher's address.
  • your_coin.py, multisig.py and hello_blockchain.py publish these instead of shelling out to
    supra move tool compile.
• Per example:
  • transfer_coin.py funds the second account by transfer rather than with a second faucet call.
  • aiofiles is dropped: transfer_two_by_two.py reads its script with pathlib.
  • rotate_key.py no longer prints part of the private key.
  • simulate_transfer_coin.py sets an explicit max gas, so the estimate does not simulate a transfer that is
    expected to fail. It asserts that the first simulation reports a Fail status whose vm_status names
    ECOIN_STORE_NOT_PUBLISHED, which is how rc7 and v11.7.2 nodes report the abort.
  • fungible_asset.py (added by feat(client): add fungible asset balance, transfer, migration and transaction helpers #31) funds its account with the shared helper and runs in make examples.
  • automation.py uses a 3600 s duration, because a v11.7.2 localnet caps task duration at 7200 s. It retries
    registration and stop on ECYCLE_TRANSITION_IN_PROGRESS.
  • Every main is annotated, and mypy now covers examples/.
• pyproject.toml and uv.lock: aiofiles and the unreleased examples extra are removed. The lock was
  regenerated with uv 0.13.7, so its revision stays 5; the only change is aiofiles.
• Makefile: make examples refuses to start when SUPRA_RPC_NODE_URL is unset, empty or whitespace. It runs
  all 14 examples and fails at the end, listing the failed ones.
• .github/workflows/examples.yaml:
  • Runs daily and on workflow_dispatch only, so fork pull requests cannot start it.
  • contents: read; concurrency group examples-devnet, so two runs never send from the same account at once.
  • A first step receives the secret through env and writes only whether it is present (whitespace counts as
    absent). Without it the job skips with a notice.
  • setup-uv installs uv 0.13.7, and uv sync --frozen runs before the secret is in the environment. The step with
    the secret sets UV_FROZEN=1 and UV_NO_SYNC=1, so nothing is resolved, downloaded or installed while the key
    is present.
  • Actions are pinned as in checks.yaml.
• examples/README.md: networks, environment variables, funding and TryLater, how to run one or all examples,
  what each shows, and how packages.json was built.

Maintainers: create the repository secret SUPRA_EXAMPLES_PRIVATE_KEY, holding the hex Ed25519 private key of an
account funded on Devnet. A full run moves about 325 SUPRA from it.

Checks

• make fmt-check, make lint, make typecheck (44 files, examples included), make test-unit (332 tests, OK, 26
  node-backed skipped), make test-spec (248 scenarios), make build: pass. actionlint: clean.
• After merging master and the review fixes: make examples passed all 14 examples on a fresh
  supra_node_v12.0.0.rc7 localnet without a key. A whitespace-only SUPRA_RPC_NODE_URL makes make examples refuse
  (checked with make -n).
• Before the merge, all 13 examples then in the PR passed on a supra_node_v12.0.0.rc7 localnet and on a supra_node_v11.7.2 localnet, each with
  faucet funding and with a funded key: 52 runs. make examples passed on rc7 without and with a key, and on v11.7.2
  without one. The output of the keyed runs does not contain the key.
• packages.json is byte-identical to a fresh compile of the four packages from tag aptosvm-v1.16_supra-v1.8.9
  (and from the fork's later tags, whose sources are unchanged), compiled with the supra CLI of
  supra_node_v11.7.2.
• The workflow was not run, because it transacts on Devnet.

🤖 Generated with Claude Code