docs(xl1-testing): correct local-chain cadence, producer wallet, and REST reads - #95
Merged
Merged
Conversation
…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>
This was referenced Sep 25, 2026
Merged
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Corrects
skills/xl1-testing/local-chain.mdagainst@xyo-network/xl1-cli5.4.1 (bundled sources and live runs):xl1 startwith 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.crane ribbon cook …, account 0 =4e881c82…), not account 0 oftest … junk; genesis still paysf39fd6e5….--mnemonicreplaces only the actor wallet;XL1_CHAIN__GENESIS_REWARD_ADDRESSmoves the genesis funds.findBestHead …(nomempoolactor),Producer … has insufficient stake(redeclaration timer), and[shadow] … anchor-present(no EVM).InPageGatewaysProvider transport="rest"needs a published-chain layout that plainxl1 startdoes not serve. Adds a recipe with@ariestools/aries-chain-serve, S3 publish bindings,publishOnFinalize, andmempool+indexer, and notes that theSimpleChainContractViewerpin fails withUnknownProviderErrorin 5.4.1.Verification
--dump-configfor the no-config, config-file,--mnemonic, and genesis-address variants.mempooladded (nofindBestHead); a 21-minute run (stake lines at 20 min); the REST recipe read back throughgetRestGateway; and theSimpleChainContractViewerpin (exit 70,UnknownProviderError).node scripts/validate-skills.mjs skills, the schema-literal tests, and rendered Claude/Codex previews.🤖 Generated with Claude Code