Skip to content

docs(zone-sdk): update Zone SDK guides for logos-blockchain 0.3.2 - #563

Merged
kashepavadan merged 5 commits into
mainfrom
docs/zone-sdk-0.3.2
Oct 14, 2026
Merged

kashepavadan merged 5 commits into
mainfrom
docs/zone-sdk-0.3.2

Conversation

@kashepavadan

Copy link
Copy Markdown
Contributor

What this changes

Updates the three Zone SDK guides under docs/blockchain/zone-sdk/ for logos-blockchain 0.3.2, based on the upstream zone-sdk/BRIDGING.md and DECENTRALIZED_SEQUENCING.md at the 0.3.2 tag.

  • Inscribe data on-chain: adds the now-mandatory FundingConfig and a run step for finding the funding key; publish is async; drops MempoolPending; handles the new FinalizedOp variants. Removes references to logos-blockchain-node inscribe and the TUI Zone on master, both removed in 0.3.0. Fixes the clone steps, which changed into deployment/tui-zone before checking out the branch that contains it.
  • Bridge assets: channel notes replace the channel balance, withdrawals bundle a ChannelTransfer with the ChannelWithdraw, WithdrawInputs selects the notes, transfer_threshold replaces withdraw_threshold, and multi-sig withdrawals use prepare_atomic_withdraw / submit_atomic_bundle. Adds deposit pinning.
  • Round-robin rotation: ChannelUpdate is now an enum read via orphaned(); channel_config takes VerifiedChannelKeys and is async; multi-admin config uses prepare_channel_config / submit_channel_config; reference policies moved to tests/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 build passes.
  • vale --minAlertLevel=error reports no errors on the changed files.

🤖 Generated with Claude Code

- 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
kashepavadan requested a review from a team October 13, 2026 23:23

@kashepavadan kashepavadan left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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).

Comment thread docs/blockchain/zone-sdk/inscribe-data-on-chain-using-zone-sdk.md Outdated
Comment thread docs/blockchain/zone-sdk/bridge-assets-between-blockchain-and-zone.md Outdated
Co-authored-by: Daniel Kashepava <kashepavadan@users.noreply.github.com>
@kashepavadan
kashepavadan merged commit 49cc8db into main Oct 14, 2026
3 checks passed
@kashepavadan
kashepavadan deleted the docs/zone-sdk-0.3.2 branch October 14, 2026 00:55
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