`init` fails to build contract clients due to soroban-sdk version conflict

[oceans404]

When running stellar scaffold init, the project initialization completes, but the contract client generation fails due to a Cargo dependency conflict between the generated project and the OpenZeppelin example contracts.

Steps to Reproduce:

1. After installing scaffold stellar dependencies, run stellar scaffold init my-project

2. Observe the output during the "Building contracts and generating client code" phase.

Actual Behavior:

The build fails to build contracts with a version selection error for soroban-sdk:

stellar-access v0.6.0 requires ^23.4.0.

The local package fungible-allowlist-example is locked to v23.1.0.

Expected Behavior:

The scaffolded project should have compatible version constraints so that cargo metadata and contract builds succeed out of the box.

Error Message

stellar scaffold init my-project
ℹ️  Creating new Stellar project in /Users/steph/Desktop/kb/build/scaffold-tutorial/my-project
Downloading theahaco/scaffold-stellar-frontend from GitHub to /Users/steph/Desktop/kb/build/scaffold-tutorial/my-project
  Done...                                                                                                                                    ℹ️  Successfully added OpenZeppelin example contract: nft-enumerable
ℹ️  Successfully added OpenZeppelin example contract: fungible-allowlist
ℹ️  Installing npm dependencies...
ℹ️  Building contracts and generating client code...
⚠️  Failed to build contract clients: `cargo metadata` exited with an error:     Updating git repository `https://github.com/OpenZeppelin/stellar-contracts`
    Updating crates.io index
    Updating crates.io index
error: failed to select a version for `soroban-sdk`.
    ... required by package `stellar-access v0.6.0 (https://github.com/OpenZeppelin/stellar-contracts?tag=v0.6.0#82f97111)`
    ... which satisfies git dependency `stellar-access` of package `fungible-allowlist-example v0.0.1 (/Users/steph/Desktop/kb/build/scaffold-tutorial/my-project/contracts/fungible-allowlist)`
versions that meet the requirements `^23.4.0` are: 23.5.1, 23.5.0, 23.4.1, 23.4.0

all possible versions conflict with previously selected packages.

  previously selected package `soroban-sdk v23.1.0`
    ... which satisfies dependency `soroban-sdk = "^23.1.0"` (locked to 23.1.0) of package `fungible-allowlist-example v0.0.1 (/Users/steph/Desktop/kb/build/scaffold-tutorial/my-project/contracts/fungible-allowlist)`

failed to select a version for `soroban-sdk` which could resolve this conflict

   


✅ Project successfully created at ...

[oceans404]

^ To work around this issue locally, I had to change my Cargo.toml file from

From

[workspace.dependencies.soroban-sdk]
version = "23.1.0"

[workspace.dependencies.stellar-access]
git = "https://github.com/OpenZeppelin/stellar-contracts"
tag = "v0.6.0"

[workspace.dependencies.stellar-macros]
git = "https://github.com/OpenZeppelin/stellar-contracts"
tag = "v0.6.0"

[workspace.dependencies.stellar-tokens]
git = "https://github.com/OpenZeppelin/stellar-contracts"
tag = "v0.6.0"

To

[workspace.dependencies]
soroban-sdk = "23.4.0"
stellar-access = { git = "https://github.com/OpenZeppelin/stellar-contracts", tag = "v0.6.0" }
stellar-macros = { git = "https://github.com/OpenZeppelin/stellar-contracts", tag = "v0.6.0" }
stellar-tokens = { git = "https://github.com/OpenZeppelin/stellar-contracts", tag = "v0.6.0" }

[oceans404]

I also had to change my environments.toml file because I was seeing client generation errors for 2/4 contracts whose OpenZeppelin contracts (Fungible and NFT) require extra metadata

• ❌ Failed to generate client for: fungible_allowlist_example
• ❌ Failed to generate client for: nft_enumerable_example

From

[development.contracts]
fungible_allowlist_example = { client = true, constructor_args = "--admin me --manager me --initial_supply 1000000000000000000000000" }
nft_enumerable_example = { client = true, constructor_args = "--owner me" }

To

[development.contracts]
# Added --name and --symbol
fungible_allowlist_example = { client = true, constructor_args = "--admin me --manager me --name \"MyToken\" --symbol \"MTK\" --initial_supply 1000000000000000000000000" }

# Added --name, --symbol, and --uri
nft_enumerable_example = { client = true, constructor_args = "--owner me --name \"MyNFT\" --symbol \"MNFT\" --uri \"https://example.com/metadata\"" }