Skip to content

Lab Contract Explorer page lists JSON, Python, and Java as Stellar CLI binding languages #3151

Open

Description

@kalepail

Note

Automated notice: Stellar Raven filed this issue from its automated evaluation pipeline. The issue includes evidence and a public source record. Please verify the live surface before you act.

Finding

The Lab Contract Explorer page gives a wrong list of Stellar CLI binding languages. It says the
CLI generates bindings in "TypeScript, JSON, Rust, Python, and Java".

The current CLI has no JSON bindings command. It does not generate Python or Java bindings. Those
commands exit with an error and point to an external plugin. The CLI generates Rust bindings. It
marks TypeScript bindings as deprecated in favor of the JavaScript Stellar SDK.

The Stellar CLI manual on the same site is correct. A reader who starts from the Lab page gets
the wrong list.

Evidence

Read-only reproduction:

curl -sS https://developers.stellar.org/docs/tools/lab/smart-contracts/contract-explorer.md | grep -n "Python, and Java"
stellar --version                      # stellar 30.0.1
stellar contract bindings --help
stellar contract bindings python; echo "exit=$?"   # not implemented; exit=1
stellar contract bindings json; echo "exit=$?"     # unrecognized subcommand; exit=2

The Lab Bindings tab shows the same sentence. Its source is
src/app/(sidebar)/smart-contracts/contract-explorer/components/Bindings.tsx in
stellar/laboratory.

Additional recorded evidence:

  • 2026-11-14 GET https://developers.stellar.org/docs/tools/lab/smart-contracts/contract-explorer.md returned HTTP 200. The Bindings section (line 84) says: "Bindings are a feature of the Stellar CLI that generate fully typed client libraries for your smart contracts, tailored to your chosen programming language, including TypeScript, JSON, Rust, Python, and Java."
  • Source: stellar/stellar-docs main 62f29bb, docs/tools/lab/smart-contracts/contract-explorer.mdx line 87. gh search code for the phrase in stellar/stellar-docs matches only this file.
  • Adjacent copy: stellar/laboratory default branch, src/app/(sidebar)/smart-contracts/contract-explorer/components/Bindings.tsx lines 8 to 11 show the same sentence in the Lab Bindings tab (file last changed 2026-07-29, f0103e70).
  • 2026-11-14 stellar 30.0.1 (latest release, published 2026-11-03): stellar contract bindings --help lists rust; typescript ("⚠️ Deprecated, use the JavaScript Stellar SDK instead"); and python, java, flutter, swift, php, kmp, each "(requires external plugin)". stellar contract bindings python and stellar contract bindings java print "binding generation is not implemented in the stellar-cli, but is available via the tool located here: https://github.com/lightsail-network/stellar-contract-bindings" and exit 1. stellar contract bindings json fails with "unrecognized subcommand 'json'" and exits 2.
  • CLI source: stellar/stellar-cli v30.0.1, cmd/soroban-cli/src/commands/contract/bindings.rs, enum Cmd has Rust, Typescript, Python, Java, Flutter, Swift, Php, and Kmp. No JSON variant. The six plugin variants carry "(requires external plugin)".
  • Same site, correct claim: GET https://developers.stellar.org/docs/tools/cli/stellar-cli.md (2026-11-14) lines 292 to 298 list typescript as deprecated and python, java, flutter, swift, php, and kmp as "requires external plugin". The resolved finding sd-052 fixed that manual on 2026-10-02.
  • 2026-11-14: a model answering from Stellar Docs search retrieved this Contract Explorer section and quoted it, attributed to the Lab Contract Explorer, as the CLI's binding language coverage (baseline run 2026-11-14T20-13-51-variantA, q-soroban-cli-bindings).
  • Classification: docs-content. The section undertakes to say which languages the CLI binding command covers and names one that does not exist and two that the CLI does not generate.
  • Affected golden case: eval/qa/corpus/battery/soroban/q-soroban-cli-bindings.json (key fact 3; no golden change). Ledger: .agents/rounds/2026-11-14-baseline-tuning/CASE-DEFECTS.md.

Recommendation

Replace the language list in the Bindings section with:

The Stellar CLI generates Rust bindings. It also generates TypeScript bindings, but that
command is deprecated in favor of the JavaScript Stellar SDK generator. Python, Java, Flutter,
Swift, PHP, and Kotlin Multiplatform bindings need an external plugin.

Optional: link the CLI manual section for the full command list. The same sentence in the Lab
Bindings.tsx component needs the same change.

Source Record

Raven recorded this finding as sd-110 (stellar-docs, discovered 2026-11-14).

Public source record: improvements/stellar-docs/sd-110-lab-contract-explorer-bindings-language-list.md

Immutable source snapshot: 06757beb0b74

Resolution Handoff

When you deploy a fix, link the resolving issue or pull request to the source record.
Then notify Raven through:

https://github.com/stellar-experimental/stellar-raven/issues/new?template=upstream-improvement-ready.yml&title=%5Bupstream-ready%5D%20sd-110%3A%20

Include the finding ID and the resolving issue or pull request.
Include the deployed version or timestamp. Include the smallest live recheck.
Raven verifies the live surface before it sets the finding to fixed-upstream.
An issue closure or merged pull request does not prove the fix.
A separate reviewer repeats the live check before Raven retires the active finding.
Raven keeps a commit-pinned snapshot when one is available.

Activity

  1. added
    ravenissues discovered by Stellar Raven QA passes
    on Nov 14, 2026
  2. stellar-doxie commented on Nov 14, 2026

    @stellar-doxie
    Contributor

    🤖 Automated message from the Stellar Triage Bot.

    Working this because the raven label called me in.

    I am checking the finding against stellar-cli 30.0.1 and the docs now.

  3. stellar-doxie commented on Nov 14, 2026

    @stellar-doxie
    Contributor

    🤖 Automated message from the Stellar Triage Bot.

    Working this because the raven label called me in.

    The finding is correct on stellar-cli 30.0.1. I opened #3153.

    • It corrects the binding language list on the Contract Explorer page.
    • It also fixes two pages that sent readers to stellar contract bindings for the JSON spec. They now name stellar contract info interface.
    • The same command on working-with-contract-specs.mdx stays with CLI commands on 8 pages fail with the current CLI: removed flags and subcommands #2973.
    • The Lab Bindings tab has the same sentence. That fix belongs in stellar/laboratory.
  4. gre3n3yes34 commented on Nov 14, 2026

    @gre3n3yes34
  5. gre3n3yes34 commented on Nov 14, 2026

    @gre3n3yes34
  6. gre3n3yes34 commented on Nov 14, 2026

    @gre3n3yes34
  7. gre3n3yes34 commented on Nov 14, 2026

    @gre3n3yes34
  8. gre3n3yes34 commented on Nov 14, 2026

    @gre3n3yes34
  9. stellar-doxie commented on Nov 14, 2026

    @stellar-doxie
    Contributor

    🤖 Automated message from the Stellar Triage Bot.

    Back on this because @gre3n3yes34 replied.

    @gre3n3yes34, this issue is about a mistake on a documentation page. It is not about your account.

    • This repository and this bot cannot send money or make deposits to a bank card or account.
    • For help with a deposit or withdrawal, contact the support team of your wallet or exchange.
    • Never share your secret key or recovery phrase. Be careful if someone offers to send you funds.

    Nothing changes for this issue. #3153 fixes the page and waits for a maintainer review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    ravenissues discovered by Stellar Raven QA passes

    Type

    No type

    Projects

    • Status
      No status

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions