Skip to content

docs(xl1-testing): correct local-chain cadence, producer wallet, and REST reads - #95

Merged
arietrouw merged 1 commit into
developfrom
feature/xl1-testing-local-chain-corrections
Sep 25, 2026
Merged

arietrouw merged 1 commit into
developfrom
feature/xl1-testing-local-chain-corrections

Conversation

@arietrouw

Copy link
Copy Markdown
Member

Summary

Corrects skills/xl1-testing/local-chain.md against @xyo-network/xl1-cli 5.4.1 (bundled sources and live runs):

  • Block cadence replaces "every few hundred ms". Plain xl1 start with no config file uses the CLI's dev preset (500 ms producer check, 5 s heartbeat, 200 ms finalizer check). A config file that lists the actors falls back to the schema defaults (10 s check, 5 min heartbeat, 500 ms finalizer check), so an idle chain sits at block 2 and a transaction lands in ~0–10 s. Adds the test polling budget and the rule that producer and finalizer heartbeats must match.
  • Funding: the producer signs with the CLI's built-in development mnemonic (crane ribbon cook …, account 0 = 4e881c82…), not account 0 of test … junk; genesis still pays f39fd6e5…. --mnemonic replaces only the actor wallet; XL1_CHAIN__GENESIS_REWARD_ADDRESS moves the genesis funds.
  • Benign log lines: findBestHead … (no mempool actor), Producer … has insufficient stake (redeclaration timer), and [shadow] … anchor-present (no EVM).
  • REST readers: InPageGatewaysProvider transport="rest" needs a published-chain layout that plain xl1 start does not serve. Adds a recipe with @ariestools/aries-chain-serve, S3 publish bindings, publishOnFinalize, and mempool + indexer, and notes that the SimpleChainContractViewer pin fails with UnknownProviderError in 5.4.1.

Verification

  • --dump-config for the no-config, config-file, --mnemonic, and genesis-address variants.
  • Live chains on spare ports: dev preset (heartbeat every ~5 s, transfer finalized in 0.3 s); config-file actors (idle at block 2, transfers in 5–6 s); mempool added (no findBestHead); a 21-minute run (stake lines at 20 min); the REST recipe read back through getRestGateway; and the SimpleChainContractViewer pin (exit 70, UnknownProviderError).
  • node scripts/validate-skills.mjs skills, the schema-literal tests, and rendered Claude/Codex previews.

🤖 Generated with Claude Code

…REST reads

Verified against @xyo-network/xl1-cli 5.4.1 (bundled sources and live runs):

- Block cadence depends on how xl1 is launched. With no config file the
  CLI's dev preset checks every 500 ms and heartbeats every 5 s; a config
  file falls back to the schema defaults (10 s producer check, 5 min
  heartbeats), so an idle chain sits at block 2 and a transaction lands
  within ~0-10 s. Document both and the test polling budget.
- The producer signs with the built-in development mnemonic (account 0 =
  4e881c82...); genesis still pays account 0 of `test ... junk`.
  --mnemonic replaces only the actor wallet; XL1_CHAIN__GENESIS_REWARD_ADDRESS
  moves the genesis funds.
- Add the benign log lines a healthy dev chain prints (findBestHead without
  a mempool actor, insufficient stake, shadow anchor-present).
- Add a REST-reader recipe (aries-chain-serve + S3 publish bindings) and
  note that the SimpleChainContractViewer pin fails with UnknownProviderError.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@arietrouw
arietrouw merged commit 0867c08 into develop Sep 25, 2026
5 checks passed
@arietrouw
arietrouw deleted the feature/xl1-testing-local-chain-corrections branch September 25, 2026 02:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant