Update:

• fix: KeyPair.fromPublicKey now accepts any 32-byte public key, even if it is not a valid Ed25519 public key point (e.g., all zeros like GAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWHF). Such keypairs can still be used for address representation but will throw IllegalStateException when attempting to verify signatures.

Update:

• feat: add AUTH_CLAWBACK_ENABLED_FLAG to AccountFlag. (#743)
• fix: remove diagnosticEventsXdr from org.stellar.sdk.responses.sorobanrpc.Events. Use GetTransactionResponse.diagnosticEventsXdr and GetTransactionsResponse.Transaction.diagnosticEventsXdr instead. (#744)
• feat: add SEP-45 (Stellar Web Authentication for Contract Accounts) support. Check Sep45Challenge class for more details. (#746)
• chore: update outdated documentation.

Update:

• feat: add endLedger field to GetEventsRequest. (#739)

This release adds support for Protocol 23.

This release contains the exact same content as 2.0.0-beta3. Below is the changelog since 1.5.1.

Update:

• feat: add pollTransaction method to SorobanServer to poll transaction status with retry strategy. (#696)
• feat: implement message signing and verification according to SEP-53, check KeyPair.signMessage and KeyPair.verifyMessage for more details. (#698)
• feat: add isValidEd25519SecretSeed, isValidPreAuthTx and isValidSha256Hash to StrKey class, these functions can be used to validate the corresponding strkey. (#702)
• feat: add med25519 public key support to StrKey. (#702)
• feat: add liquidity pool and claimable balance support to StrKey. (#701)
• feat: add muxed account, liquidity pool and claimable balance support to Address class. (#703)
• feat(SorobanServer): add destinationMuxedId to InvokeHostFunctionOperationResponse.AssetContractBalanceChange. (#710 and (#705))
• feat(SorobanServer): add events field to GetTransactionsResponse.Transaction and GetTransactionResponse. (#707)
• feat(SorobanServer): add oldestLedger, latestLedgerCloseTime and oldestLedgerCloseTime fields to GetEventsResponse, and add transactionIndex and operationIndex fields to GetEventsResponse.EventInfo, check Stellar RPC release log for more information.
• feat(SorobanServer): add support for non-root authorization in SorobanServer#simulateTransaction. (#708)
• feat: add isValidSignedPayload to StrKey class, this function can be used to validate the ed25519 signed payload. (#712)
• feat: add signExtraSignersPayload to sign extra signers payloads in Transaction class. (#713)
• refactor: add balance id validation. (#722)
• fix: fix handling of transaction metadata versioning in AssembledTransaction class. (#723)
• refactor: add validation for asset issuer. (#725)
• refactor: add validation for liquidity pool ID length in TrustLineAsset. (#726)

Breaking changes:

• chore: upgrade generated XDR definitions to Protocol 23. (#699)
• refactor!: the following functions in StrKey are marked as deprecated, they will be removed in the next major release; please refer to the documentation for each function to see the corresponding replacement functions: (#702)
  • StrKey#encodeEd25519PublicKey(AccountID)
  • StrKey#encodeMuxedAccount(MuxedAccount)
  • StrKey#decodeMuxedAccount(String)
  • StrKey#encodeToXDRAccountId(String)
  • StrKey#encodeToXDRMuxedAccount(String)
• refactor!: rename readBytes to diskReadBytes and update related methods in SorobanDataBuilder. (#700)
• refactor(HorizonServer)!: remove numArchivedContracts and archivedContractsAmount from AssetResponse. (#704)
• refactor(SorobanServer)!: GetTransactionsResponse.Transaction#getDiagnosticEventsXdr() and GetTransactionsResponse.Transaction#parseDiagnosticEventsXdr() has been marked as deprecated, they will be removed in Stellar RPC soon, use GetTransactionsResponse.Transaction#getEvents() instead. (#706)
• refactor(SorobanServer)!: remove deprecated pagingToken field from GetEventsResponse.EventInfo. (#707)
• refactor(SorobanServer)!: inSuccessfulContractCall in GetEventsResponse.EventInfo has been marked as deprecated, it will be removed in the next release. (#707)
• feat: add org.stellar.sdk.SignerKey for enhanced signer key handling. (#712)
  • org.stellar.sdk.Signer and org.stellar.sdk.SignedPayloadSigner has been removed, use org.stellar.sdk.SignerKey instead.
  • The StrKey#encodeSignedPayload(SignedPayloadSigner) and StrKey#decodeSignedPayload(String) methods now operate on raw byte[] instead of the SignedPayloadSigner object to provide more flexibility.
  • KeyPair#fromXdrSignerKey() and KeyPair#getXdrSignerKey() have been removed, use org.stellar.sdk.SignerKey instead.
  • The type of TransactionPreconditions#extraSigners has been changed from List<org.stellar.sdk.xdr.SignerKey> to List<org.stellar.sdk.SignerKey>.
  • The type of SetOptionsOperation#signer has been changed from org.stellar.sdk.xdr.SignerKey to org.stellar.sdk.SignerKey.
  • The type of RevokeSignerSponsorshipOperation#signer has been changed from org.stellar.sdk.xdr.SignerKey to org.stellar.sdk.SignerKey.

Full Changelog: 1.5.0...2.0.0

Update

• fix: fix muxed account handling in Address class. (#733)

Full Changelog: 2.0.0-beta2...2.0.0-beta3

Update:

• refactor: add validation for asset issuer. (#725)
• refactor: add validation for liquidity pool ID length in TrustLineAsset. (#726)
• fix: isolate Kotlin dependency to test scope. (#731)

Full Changelog: 2.0.0-beta1...2.0.0-beta2

Update:

• feat: add isValidSignedPayload to StrKey class, this function can be used to validate the ed25519 signed payload. (#712)
• feat: add signExtraSignersPayload to sign extra signers payloads in Transaction class. (#713)
• refactor: add balance id validation. (#722)
• fix: fix handling of transaction metadata versioning in AssembledTransaction class. (#723)

Breaking changes:

• feat: add org.stellar.sdk.SignerKey for enhanced signer key handling. (#712)
  • org.stellar.sdk.Signer and org.stellar.sdk.SignedPayloadSigner has been removed, use org.stellar.sdk.SignerKey instead.
  • The StrKey#encodeSignedPayload(SignedPayloadSigner) and StrKey#decodeSignedPayload(String) methods now operate on raw byte[] instead of the SignedPayloadSigner object to provide more flexibility.
  • KeyPair#fromXdrSignerKey() and KeyPair#getXdrSignerKey() have been removed, use org.stellar.sdk.SignerKey instead.
  • The type of TransactionPreconditions#extraSigners has been changed from List<org.stellar.sdk.xdr.SignerKey> to List<org.stellar.sdk.SignerKey>.
  • The type of SetOptionsOperation#signer has been changed from org.stellar.sdk.xdr.SignerKey to org.stellar.sdk.SignerKey.
  • The type of RevokeSignerSponsorshipOperation#signer has been changed from org.stellar.sdk.xdr.SignerKey to org.stellar.sdk.SignerKey.

Full Changelog: 2.0.0-beta0...2.0.0-beta1

Update:

• fix: avoid unnecessary padding during writing and reading of XDR data. (#720)

Full Changelog: 1.5.0...1.5.1

Update:

• feat: add pollTransaction method to SorobanServer to poll transaction status with retry strategy. (#696)
• feat: implement message signing and verification according to SEP-53, check KeyPair.signMessage and KeyPair.verifyMessage for more details. (#698)
• feat: add isValidEd25519SecretSeed, isValidPreAuthTx and isValidSha256Hash to StrKey class, these functions can be used to validate the corresponding strkey. (#702)
• feat: add med25519 public key support to StrKey. (#702)
• feat: add liquidity pool and claimable balance support to StrKey. (#701)
• feat: add muxed account, liquidity pool and claimable balance support to Address class. (#703)
• feat(SorobanServer): add destinationMuxedId to InvokeHostFunctionOperationResponse.AssetContractBalanceChange. (#710 and (#705))
• feat(SorobanServer): add events field to GetTransactionsResponse.Transaction and GetTransactionResponse. (#707)
• feat(SorobanServer): add oldestLedger, latestLedgerCloseTime and oldestLedgerCloseTime fields to GetEventsResponse, and add transactionIndex and operationIndex fields to GetEventsResponse.EventInfo, check Stellar RPC release log for more information.
• feat(SorobanServer): add support for non-root authorization in SorobanServer#simulateTransaction. (#708)

Breaking changes:

• chore: upgrade generated XDR definitions to Protocol 23. (#699)
• refactor!: the following functions in StrKey are marked as deprecated, they will be removed in the next major release; please refer to the documentation for each function to see the corresponding replacement functions: (#702)
  • StrKey#encodeEd25519PublicKey(AccountID)
  • StrKey#encodeMuxedAccount(MuxedAccount)
  • StrKey#decodeMuxedAccount(String)
  • StrKey#encodeToXDRAccountId(String)
  • StrKey#encodeToXDRMuxedAccount(String)
• refactor!: rename readBytes to diskReadBytes and update related methods in SorobanDataBuilder. (#700)
• refactor(HorizonServer)!: remove numArchivedContracts and archivedContractsAmount from AssetResponse. (#704)
• refactor(SorobanServer)!: GetTransactionsResponse.Transaction#getDiagnosticEventsXdr() and GetTransactionsResponse.Transaction#parseDiagnosticEventsXdr() has been marked as deprecated, they will be removed in Stellar RPC soon, use GetTransactionsResponse.Transaction#getEvents() instead. (#706)
• refactor(SorobanServer)!: remove deprecated pagingToken field from GetEventsResponse.EventInfo. (#707)
• refactor(SorobanServer)!: inSuccessfulContractCall in GetEventsResponse.EventInfo has been marked as deprecated, it will be removed in the next release. (#707)

Update:

• feat: change XdrElement interface to public. (#694)