Fuzz Testing tutorial blocked on macOS/Apple Silicon

[kaankacar]

What version are you using?

Stellar CLI v23.2.1, Rust nightly, macOS on Apple Silicon (ARM64)

What did you do?

Followed the Fuzz Testing tutorial and ran:

cargo +nightly fuzz run fuzz_target_1

Documentation URL: https://developers.stellar.org/docs/build/smart-contracts/example-contracts/fuzz-testing

What did you expect to see?

The fuzzer running successfully.

What did you see instead?

error: linking with `cc` failed: exit status: 1
ld: multiple errors: initializer pointer has no target...

This is a known ASAN (AddressSanitizer) linker issue on Apple Silicon. See rs-soroban-sdk issues #1355 and #1056. The tutorial provides no mention of this limitation, leaving macOS developers stuck with no workaround.

Fix: Add a troubleshooting note:

macOS Users: Fuzzing with AddressSanitizer may fail on Apple Silicon due to linker issues. Workarounds:

1. Use the thread sanitizer: cargo +nightly fuzz run fuzz_target_1 -- --sanitizer=thread
2. Use a Linux environment or devcontainer