Skip to content

Update docs for current Stellar CLI behavior#2618

Merged
ElliotFriend merged 1 commit into
stellar:mainfrom
ElliotFriend:raven/cli-drift-2598-2601
Jul 16, 2026
Merged

Update docs for current Stellar CLI behavior#2618
ElliotFriend merged 1 commit into
stellar:mainfrom
ElliotFriend:raven/cli-drift-2598-2601

Conversation

@ElliotFriend

Copy link
Copy Markdown
Contributor

Batch quick-fix for two Raven-reported CLI drift issues, verified against the current CLI and live network settings.

Changes

Removed network container subcommand (#2598)

stellar network container start no longer exists (removed in CLI v23.0.0; the current command is stellar container start <network>, verified against stellar container start --help). Updated the two live pages that still teach the old form:

  • docs/tools/lab/quickstart-with-lab.mdx
  • docs/build/guides/dapps/soroban-contract-init-template.mdx

The network container references in software-versions.mdx release notes and the install-cli video-tutorial label are historical/quoted content and intentionally left alone.

Deprecated contract optimize + stale max contract size (#2601)

  • Reworked the hello-world "Optimizing Builds" section: stellar contract optimize is deprecated, and stellar contract build now optimizes by default (--optimize, default true; pass --optimize=false to disable). Added a note about the deprecated standalone command for readers who encounter it elsewhere.
  • Noted in the build section that stellar contract build optimizes by default, since the "shortcut for cargo build" equivalence is no longer the whole story.
  • Corrected the maximum contract size claim: 64KB → 128KB, per live mainnet contract_max_size_bytes = 131072 (checked via stellar network settings --network mainnet), with a hedge that the value is network-configurable.

Closes #2598
Closes #2601

🤖 Generated with Claude Code

- Replace removed `stellar network container start` with the current
  `stellar container start` in the Lab quickstart and the contract init
  template guide
- Rework the hello-world "Optimizing Builds" section: `stellar contract
  optimize` is deprecated, and `stellar contract build` now optimizes by
  default
- Correct the maximum contract size in hello-world (64KB → 128KB, per
  live mainnet `contract_max_size_bytes` = 131072)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 15, 2026 14:14

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Updates documentation to match current Stellar CLI behavior.

Changes:

  • Replaces removed network container start commands.
  • Documents default build optimization and its disable flag.
  • Updates Mainnet’s configurable contract size limit to 128KB.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File Description
docs/tools/lab/quickstart-with-lab.mdx Updates the Testnet container command.
docs/build/smart-contracts/getting-started/hello-world.mdx Revises contract size and optimization guidance.
docs/build/guides/dapps/soroban-contract-init-template.mdx Updates the local container command.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@stellar-jenkins-ci

Copy link
Copy Markdown

@ElliotFriend ElliotFriend added the raven issues discovered by Stellar Raven QA passes label Jul 15, 2026
@ElliotFriend ElliotFriend changed the title 🛠️ Update docs for current Stellar CLI behavior Update docs for current Stellar CLI behavior Jul 15, 2026
@ElliotFriend
ElliotFriend requested a review from kaankacar July 15, 2026 14:38
@ElliotFriend
ElliotFriend merged commit da10b47 into stellar:main Jul 16, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

raven issues discovered by Stellar Raven QA passes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Replace the deprecated stellar contract optimize workflow Fix the removed stellar network container command

3 participants