dartssh2 2.17.0

SSH and SFTP client written in pure Dart, aiming to be feature-rich as well as easy to use.

2.17.0 - 2026-03-28

• Improved Web/WASM compatibility by updating SSHSocket conditional imports so web runtimes consistently use the web socket shim and avoid incorrect native socket selection #88. Thanks @vicajilau.
• Added local dynamic forwarding (SSHClient.forwardDynamic) with SOCKS5 NO AUTH + CONNECT, including configurable handshake/connect timeouts and connection limits.
• Added AES-GCM ([e-mail], [e-mail]) AEAD groundwork in transport and cipher negotiation; currently opt-in (not enabled by default yet). [e-mail] remains pending #26. Thanks @vicajilau.

2.16.0 - 2026-03-24

• BREAKING: Changed SSHChannelController.sendEnv() from void to Future<bool> to properly await environment variable setup responses and avoid race conditions with PTY requests #102. Thanks @itzhoujun and @vicajilau.
• Clarified shell stdio wiring for CLI-only usage and guarded example/shell.dart against missing local terminal handles (for example GUI-launched Windows .exe) #121. Thanks @bradmartin333 and @vicajilau.
• Added support for parsing legacy unencrypted EC PRIVATE KEY PEM format in SSHKeyPair.fromPem #109. Thanks @jooy2 and @vicajilau.
• Added SSHClient.runWithResult() to expose command output together with exitCode and exitSignal while keeping run() as a convenience API #99. Thanks @falrom and @vicajilau.
• Added non-breaking high-level SFTP download() / downloadTo() APIs and read pipeline tuning knobs (chunkSize, maxPendingRequests) for improved large-file throughput while preserving stream compatibility #124. Thanks @vicajilau.
• Made SFTP directory/file name parsing tolerant to malformed UTF-8 bytes to avoid FormatException on non-UTF-8 server filenames #95. Thanks @vicajilau.

2.15.0 - 2026-03-20

• Updated pointycastle dependency to ^4.0.0 #131. Thanks @vicajilau.
• Added foundational X11 forwarding support with session x11-req API, incoming x11 channel handling, and protocol tests #1. Thanks @vicajilau.
• Exposed SSH ident configuration from SSHClient #135. Thanks @Remulic and @vicajilau.
• Propagated the underlying exception in SSHAuthAbortError through reason for better diagnostics #133. Thanks @james-thorpe and @vicajilau.
• Accepted SSH-1.99-* server banners as SSH-2 compatible during version exchange and added regression tests #132. Thanks @james-thorpe and @vicajilau.
• Added SSH agent forwarding support ([e-mail]) with in-memory agent handling and RSA sign-request flag support #139. Thanks @Wackymax and @vicajilau.
• Normalized HTTP response line parsing in SSHHttpClientResponse to handle CRLF endings consistently and avoid trailing line-ending artifacts in parsed status/header fields #145. Thanks @vicajilau.
• Fixed SFTP packet encoding/decoding consistency: SftpInitPacket.decode now parses extension pairs correctly and SftpExtendedReplyPacket.encode now preserves raw payload bytes #145. Thanks @vicajilau.

2.14.0 - 2026-03-19

• Fixed SSH connections through bastion hosts where the target server sends its version string immediately upon connection (which is standard behavior per RFC 4253) #141. Thanks [@shihuili1218].
• Adds a new forwardLocalUnix() function, which is an equivalent of ssh -L localPort:remoteSocketPath #140. Thanks [@isegal].

2.13.0 - 2025-06-22

• docs: Update NoPorts naming [#115]. @XavierChanth.
• Add parameter disableHostkeyVerification #123. Thanks @alexander-irion.
• Add support for server initiated re-keying #125. Thanks @MarBazuz.
• Add support for new algorithms "mac-sha2-256-96", "hmac-sha2-512-96", "[e-mail]", "[e-mail]" #126 #127. Thanks @reinbeumer.

2.12.0 - 2025-02-08

• Fixed streams and channel not closing after receiving SSH_Message_Channel_Close [#116]. [@cbenhagen].
• Fixed lint issues.
• Added tests.
• Updated dependencies.

2.11.0 - 2024-11-19

• Fixed Type 'Uint8' not found issue.

2.10.0 - 2024-08-29

• Improved Readme.
• Bug fix in SftpFileWriter for #50, #71, #100.
• Added DartShell product #101.
• Fixed dynamic return on SftpFileOpenMode in | operator #80.
• DCM updated.
• Fixed warnings related with new DCM version.
• Dependencies updated.
• Fixed Flutter 3.24 issue.

2.9.1-pre - 2023-04-02

• Make the type of SSHForwardChannel.sink to StreamSink<List<int>> to match its super class.
• Added SSHHttpClient for easy http request forwarding.

2.9.0-pre - 2023-03-31

• Better handling of channel close.
• Make SSHForwardChannel implement SSHSocket for better interoperability.

2.8.2 - 2023-03-07

• Make SftpFileWriter implement Future<void> for backward compatibility.

2.8.1 - 2023-03-07

• Export SftpFileWriter

2.8.0 - 2023-03-06

• SftpFile.write now returns a SftpFileWriter that can be used to control the writing process.
• Support SftpClient.statvfs and SftpFile.statvfs.
• Support automatic keepalive.

2.7.3

• Update README.md
• Move cli into separate package.
• Properly handle chunk read error during stream read.

2.7.2+3

• Update README.md

2.7.2+2

• Update README.md

2.7.2+1

• Update README.md

2.7.2

• Upgrade pinenacl to 0.5.0.
• Fix bug in exporting openssh private key to pem, thanks @PIDAMI

2.7.1

• Upgrade rsa authentication algorithm to rsa-sha2-256.

2.7.0

• Support encrypted RSA format private key

2.6.1

• Allow username with @ in dartssh2 command #24

2.6.0

• Allow ignoring stdout or stderr in SSHClient.run.
• Add SSHAuthFailError and SSHAuthAbortError.
• Fix file type detection.
• Fix empty identity handling #21
• Add connection reset handing.
• Add more tests

2.5.0

• Fix js import path #18.
• Ignore remote data after channel closed.

2.4.4

• Fix lint errors

2.4.3

• Remove unused dependencies
• Fix lint errors

2.4.2

• Fix null check error in kill() #17
• More examples in README.md

2.4.1

• More examples in README.md
• Limit the maximum size of channel packets

2.4.0

• Support session stdin streaming and EOF

2.3.1

• Support ssh v2 when version string does not contain CR #14, thanks @Migarl

2.3.1-pre

• Add remoteVersion field to SSHClient

2.3.0-pre

• Add description field in SSHChannelOpenError

2.2.0

• Update README.md
• Support export keypair to PEM

2.1.0-pre

• Update README.md
• Support loading OpenSSH encrypted pem files.

2.0.0-pre

• Implements local port forwarding
• Implements remote port forwarding
• Implements SFTP client
• More supported algorithms
• Added dartsftp command

1.2.0-pre

• Rework login logic.
• dartssh command now supports login with public key.

1.1.4-pre

• dartssh command now supports terminal window resize.

1.1.3-pre

• Add --verbose option in dartssh command.

1.1.2-pre

• Fix typos.

1.1.1-pre

• Organize exports.

1.1.0-pre

• Dependency update.
• Sound null safety.
• Replace deprecated pedantic with package:lints
• Fix crash running vim by @linhanyu. #1

1.0.4+4

• Increase test coverage and documentation.

1.0.3+3

• Fix tunneled WebSocket issue.

1.0.2+2

• Add example/README.md

1.0.1+1

• Add SSHTunneledSocketImpl, SSHTunneledWebSocketImpl, and SSHTunneledBaseClient.

1.0.0+0

• Initial release.