[dependabot]

Bumps the soroban-sdk-phase-protocol group with 2 updates in the /contracts/phase-protocol directory: soroban-sdk and soroban-token-sdk.

Updates soroban-sdk from 22.0.11 to 28.0.0

Release notes

Sourced from soroban-sdk's releases.

28.0.0

This is a release supporting Protocol 28. Upgrading requires changes to some contracts. See the migration guide for the full detail on each breaking change below.

Breaking changes

• Build contracts with stellar-cli v25.2.0 or newer. Spec shaking v2 is now always on, so the SDK emits a spec entry for every type and relies on the build system to strip the unreachable ones. Remove the experimental_spec_shaking_v2 feature from the soroban-sdk dependency, and remove any export = ... argument from contracttype, contracterror, and contractevent, which is now a compile error. Native builds and unit tests are unaffected. #1968
• Remove any lib = ... argument from contracttype, contracterror, and contractevent. It is now a compile error, and contractimport! always generates the full type definition instead of aliasing into another crate. #1951 #2000
• A contracttype struct can be read from stored data with extra or missing fields (CAP-86). A field missing from the map reads as None if it is an Option, and errors otherwise, and a map key that is not a field of the struct is ignored and dropped, where both used to panic. An Option field can now be added or removed without migrating everything already stored. Writing is unchanged and still writes every field. #2006
• Events no longer publish fields that are unset (CAP-86). In a contractevent with data_format = "map", a field whose value is void, or Option::None, is left out of the published map rather than written as a key with a void value. Any off-chain system consuming the events must tolerate the absent key. Keep publishing every field with #[contractevent(sparse = false)]. #2008
• Deploying and upgrading take a ContractExecutable (CAP-85). deploy_contract replaces deploy_v2, and update_current_contract replaces update_current_contract_wasm; the old ones still work but are deprecated. Wrap the Wasm hash in ContractExecutable::Wasm(...) to migrate. #2020
• Test snapshots change for tests that register contracts natively. Every natively registered contract now gets its own contract code entry rather than sharing one empty entry, so snapshot JSON files are regenerated on upgrade. For a test that depended on contracts sharing a code entry, upload the contract once with Env::upload and deploy it repeatedly instead. #2014
• The Approve event field expiration_ledger is renamed live_until_ledger, matching the name SEP-41 uses. Rename it wherever the event is constructed or matched on. #1985
• #[contractimpl(contracttrait)] on an impl block that does not implement a trait is now a compile error. It was accepted and silently did nothing. #1992
• Some test utilities now panic when called inside a contract function. Call them from the test, outside the contract. #2010

New features

• Protocol 28 support, with soroban-env-* at 28.0.2 and stellar-xdr at 28.0.0. #1986
• Manage contract executable references from a contract (CAP-85) with Env::executable_refs(), and deploy from one by passing ContractExecutable::ExternalRef. #2020
• Upload a natively defined contract in tests with Env::upload and Env::upload_at, making it possible to test a factory, or any other contract that deploys from an existing code entry, without needing to build the contract to Wasm. #2007
• Fuzz and property test with account addresses using the new ArbitraryAddressAccount prototype, which generates G... addresses so the account path of a contract gets exercised. ArbitraryAddress still generates contract addresses and is also named ArbitraryAddressContract. #2024
• Use SorobanArbitrary prototypes with proptest, now documented in testutils::proptest. #2011

Fixes

• MuxedAddress values from different Envs can be compared in tests. #2047
• BytesN<N> rejects an N larger than u32::MAX when converting from Bytes. #2050
• Generated and internal spec XDR statics are now private and hidden from docs. #2054 #2032

Full Changelog: stellar/rs-soroban-sdk@v27.0.6...v28.0.0

28.0.0-rc.2

This is a pre-release supporting Protocol 28, and follows v28.0.0-rc.1. Upgrading requires changes to some contracts. See the migration guide for the full detail on each breaking change, including those released in rc.1.

Note that any changes including breaking changes may be made until the stable release.

Breaking changes

• None

Fixes

• MuxedAddress values from different Envs can be compared in tests. Comparison now falls back to comparing serialized values when the object handles come from separate environments, matching every other SDK type. Such comparisons used to panic. Tests only. #2047
• BytesN<N> rejects an N larger than u32::MAX when converting from Bytes. On 64-bit hosts N was truncated to u32, so a Bytes of a different length could be accepted. Contracts built for Wasm were unaffected, where usize is 32 bits. #2050
• Generated spec XDR statics are now private and hidden from docs. The __SPEC_XDR_TYPE_*, __SPEC_XDR_EVENT_* and __SPEC_XDR_FN_* statics generated by contracttype, contracterror, contractevent and contractimpl, and the module wrapping the function one, no longer appear in the public API or in rustdoc. They exist only to place the contractspecv0 link section in the Wasm, and are __-prefixed #[doc(hidden)] internals nothing external is meant to reference. Rebuilt test Wasms are byte-identical. #2054 #2032

Docs

• The auth docs include a full custom account example, showing a contract account implementing CustomAccountInterface end to end. #2053
• Add AFL++ fuzzing examples #2016

... (truncated)

Commits

• 48d5067 Bump version to 28.0.0 (#2067)
• 3bb283c Fix contractimport! doc example and generated-client name in docs (#2056)
• 9bafcef Add migration docs for check auth contract executable changes (#2057)
• 5e875b5 Bump version to 28.0.0-rc.2 (#2055)
• f4f46a2 Reject oversized BytesN lengths in try_from Bytes (#2050)
• aa700d0 Make generated spec XDR statics private (#2054)
• b230e55 Add custom account example to auth docs (#2053)
• c632f79 Fix MuxedAddress comparison across environments in tests (#2047)
• 73a2a8c Fix duplicate banner on published docs index (#2039)
• a9b3c62 Improve the default example in the SDK docs (#2041)
• Additional commits viewable in compare view

Updates soroban-token-sdk from 22.0.11 to 28.0.0

Release notes

Sourced from soroban-token-sdk's releases.

28.0.0

This is a release supporting Protocol 28. Upgrading requires changes to some contracts. See the migration guide for the full detail on each breaking change below.

Breaking changes

• Build contracts with stellar-cli v25.2.0 or newer. Spec shaking v2 is now always on, so the SDK emits a spec entry for every type and relies on the build system to strip the unreachable ones. Remove the experimental_spec_shaking_v2 feature from the soroban-sdk dependency, and remove any export = ... argument from contracttype, contracterror, and contractevent, which is now a compile error. Native builds and unit tests are unaffected. #1968
• Remove any lib = ... argument from contracttype, contracterror, and contractevent. It is now a compile error, and contractimport! always generates the full type definition instead of aliasing into another crate. #1951 #2000
• A contracttype struct can be read from stored data with extra or missing fields (CAP-86). A field missing from the map reads as None if it is an Option, and errors otherwise, and a map key that is not a field of the struct is ignored and dropped, where both used to panic. An Option field can now be added or removed without migrating everything already stored. Writing is unchanged and still writes every field. #2006
• Events no longer publish fields that are unset (CAP-86). In a contractevent with data_format = "map", a field whose value is void, or Option::None, is left out of the published map rather than written as a key with a void value. Any off-chain system consuming the events must tolerate the absent key. Keep publishing every field with #[contractevent(sparse = false)]. #2008
• Deploying and upgrading take a ContractExecutable (CAP-85). deploy_contract replaces deploy_v2, and update_current_contract replaces update_current_contract_wasm; the old ones still work but are deprecated. Wrap the Wasm hash in ContractExecutable::Wasm(...) to migrate. #2020
• Test snapshots change for tests that register contracts natively. Every natively registered contract now gets its own contract code entry rather than sharing one empty entry, so snapshot JSON files are regenerated on upgrade. For a test that depended on contracts sharing a code entry, upload the contract once with Env::upload and deploy it repeatedly instead. #2014
• The Approve event field expiration_ledger is renamed live_until_ledger, matching the name SEP-41 uses. Rename it wherever the event is constructed or matched on. #1985
• #[contractimpl(contracttrait)] on an impl block that does not implement a trait is now a compile error. It was accepted and silently did nothing. #1992
• Some test utilities now panic when called inside a contract function. Call them from the test, outside the contract. #2010

New features

• Protocol 28 support, with soroban-env-* at 28.0.2 and stellar-xdr at 28.0.0. #1986
• Manage contract executable references from a contract (CAP-85) with Env::executable_refs(), and deploy from one by passing ContractExecutable::ExternalRef. #2020
• Upload a natively defined contract in tests with Env::upload and Env::upload_at, making it possible to test a factory, or any other contract that deploys from an existing code entry, without needing to build the contract to Wasm. #2007
• Fuzz and property test with account addresses using the new ArbitraryAddressAccount prototype, which generates G... addresses so the account path of a contract gets exercised. ArbitraryAddress still generates contract addresses and is also named ArbitraryAddressContract. #2024
• Use SorobanArbitrary prototypes with proptest, now documented in testutils::proptest. #2011

Fixes

• MuxedAddress values from different Envs can be compared in tests. #2047
• BytesN<N> rejects an N larger than u32::MAX when converting from Bytes. #2050
• Generated and internal spec XDR statics are now private and hidden from docs. #2054 #2032

Full Changelog: stellar/rs-soroban-sdk@v27.0.6...v28.0.0

28.0.0-rc.2

This is a pre-release supporting Protocol 28, and follows v28.0.0-rc.1. Upgrading requires changes to some contracts. See the migration guide for the full detail on each breaking change, including those released in rc.1.

Note that any changes including breaking changes may be made until the stable release.

Breaking changes

• None

Fixes

• MuxedAddress values from different Envs can be compared in tests. Comparison now falls back to comparing serialized values when the object handles come from separate environments, matching every other SDK type. Such comparisons used to panic. Tests only. #2047
• BytesN<N> rejects an N larger than u32::MAX when converting from Bytes. On 64-bit hosts N was truncated to u32, so a Bytes of a different length could be accepted. Contracts built for Wasm were unaffected, where usize is 32 bits. #2050
• Generated spec XDR statics are now private and hidden from docs. The __SPEC_XDR_TYPE_*, __SPEC_XDR_EVENT_* and __SPEC_XDR_FN_* statics generated by contracttype, contracterror, contractevent and contractimpl, and the module wrapping the function one, no longer appear in the public API or in rustdoc. They exist only to place the contractspecv0 link section in the Wasm, and are __-prefixed #[doc(hidden)] internals nothing external is meant to reference. Rebuilt test Wasms are byte-identical. #2054 #2032

Docs

• The auth docs include a full custom account example, showing a contract account implementing CustomAccountInterface end to end. #2053
• Add AFL++ fuzzing examples #2016

... (truncated)

Commits

• 48d5067 Bump version to 28.0.0 (#2067)
• 3bb283c Fix contractimport! doc example and generated-client name in docs (#2056)
• 9bafcef Add migration docs for check auth contract executable changes (#2057)
• 5e875b5 Bump version to 28.0.0-rc.2 (#2055)
• f4f46a2 Reject oversized BytesN lengths in try_from Bytes (#2050)
• aa700d0 Make generated spec XDR statics private (#2054)
• b230e55 Add custom account example to auth docs (#2053)
• c632f79 Fix MuxedAddress comparison across environments in tests (#2047)
• 73a2a8c Fix duplicate banner on published docs index (#2039)
• a9b3c62 Improve the default example in the SDK docs (#2041)
• Additional commits viewable in compare view