Repository navigation
docs(zone-sdk): update Zone SDK guides for logos-blockchain 0.3.2 - #563
Conversation
- Inscription tutorial: add the now-mandatory `FundingConfig` and a `--funding-pk` run step, make `publish` async, drop `MempoolPending`, handle the new `FinalizedOp` variants, and remove references to the `inscribe` node subcommand and the TUI Zone on `master`, both removed in 0.3.0. Fix the clone steps, which changed into `deployment/tui-zone` before checking out the branch that contains it. - Bridging: channels now hold funds as channel notes, withdrawals bundle a `ChannelTransfer` with the `ChannelWithdraw`, `WithdrawInputs` picks the notes, `transfer_threshold` replaces `withdraw_threshold`, and multi-sig withdrawals use `prepare_atomic_withdraw` / `submit_atomic_bundle`. Add deposit pinning. - Round-robin rotation: `ChannelUpdate` is now an enum read through `orphaned()`, `channel_config` takes `VerifiedChannelKeys` and is async, multi-admin config uses `prepare_channel_config` / `submit_channel_config`, and the reference policies moved. Indent a callout that split a numbered list. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
kashepavadan
left a comment
There was a problem hiding this comment.
I followed the three changed Zone SDK pages end to end at e693c71ea7149dea1c91bd7678465f6e62cfffb2 on Ubuntu 24.04.
Inscribe data on-chain: I ran a fresh testnet node with logosctl 0.3.2 and blockchain_module 0.3.2 until it was Online, then mined until the PoWClaim key was funded. Next I cloned tui-zone-tutorial (with logos-blockchain#3812 merged) and filled in the skeleton with the code from the page, exactly as written. It builds with no warnings and matches tui-zone-solution apart from whitespace. The pow_status / auto_claim.targets and balance commands in Step 5 return what the page describes, including the 404 before funds arrive. cargo run --bin tui-sequencer -- --funding-pk … printed Ready., both messages were funded and published, and the channel was created on-chain within a few minutes. The one gap is the long wait before messages move to Finalized (inline comment).
Bridging and round-robin rotation: these are reference snippets rather than a runnable flow, so I compiled every snippet on both pages against the 0.3.2 tag, with stub inputs for the undefined variables. All of them compile except the VerifiedChannelKeys::from(...)? one (inline comment). I also checked the quoted defaults against the source: the 12% priority fee, the 30 s resubmit_interval, the 30-slot stale_refund_slots, and the policy file paths. All are correct. The bridging page still carries the 0.2.4 "withdrawals cannot be completed" warning, which is no longer true (inline comment).
Co-authored-by: Daniel Kashepava <kashepavadan@users.noreply.github.com>
What this changes
Updates the three Zone SDK guides under
docs/blockchain/zone-sdk/forlogos-blockchain0.3.2, based on the upstreamzone-sdk/BRIDGING.mdandDECENTRALIZED_SEQUENCING.mdat the0.3.2tag.FundingConfigand a run step for finding the funding key;publishis async; dropsMempoolPending; handles the newFinalizedOpvariants. Removes references tologos-blockchain-node inscribeand the TUI Zone onmaster, both removed in 0.3.0. Fixes the clone steps, which changed intodeployment/tui-zonebefore checking out the branch that contains it.ChannelTransferwith theChannelWithdraw,WithdrawInputsselects the notes,transfer_thresholdreplaceswithdraw_threshold, and multi-sig withdrawals useprepare_atomic_withdraw/submit_atomic_bundle. Adds deposit pinning.ChannelUpdateis now an enum read viaorphaned();channel_configtakesVerifiedChannelKeysand is async; multi-admin config usesprepare_channel_config/submit_channel_config; reference policies moved totests/src/cucumber/steps/zone/operations/policies.rs. Indents a callout that split a numbered list.Merge order
The inscription tutorial depends on the updated skeleton in logos-blockchain/logos-blockchain#3812. Merge them together.
This also overlaps with the 0.2.4-era fixes to the same pages on
dogfood/blockchain-reapply; resolve any conflict in favour of this branch.Checks
npm run buildpasses.vale --minAlertLevel=errorreports no errors on the changed files.🤖 Generated with Claude Code