Repository navigation
Releases
Forwiroh 0.2.0
Forwiroh 0.2.0
This release introduces an opaque Rust Forwiroh API with owned response models,
typed errors, and distinct tunnel and VPN session identifiers. New integrations
can use this facade without depending on Iroh endpoints, Tokio channels, or
internal state. Existing low-level Rust APIs remain available. Extensible Rust
enums are now non-exhaustive; existing exhaustive matches on Command and
TransportMode need a fallback arm. See the
Rust migration guide.
The control API adds api_info for version and capability discovery, canonical
command names, and machine-readable error codes. Control API v1 aliases and the
C ABI v1 remain supported. Swift gains typed identifiers and response models
while retaining its existing string methods. Frozen Rust, C, C++, Swift, and
socket consumers now guard compatibility in CI. See the
control API contract.
Policy editors can read a policy revision and apply a patch that preserves
untouched fields. Stale updates fail with policy_conflict; owned policy models
preserve unknown fields through decoding and encoding. Legacy policy setters
retain their existing schema and replacement behavior.
Tunnel stops are idempotent and reject requests for the wrong tunnel kind.
CLI approval and stop commands accept generated IDs that begin with a hyphen.
VPN commands honor explicit TUN selection and legacy packet-session aliases.
The C packet API validates receive-buffer capacity without consuming a packet
and adds functions that return detailed packet errors.
The Android JNI bridge uses the canonical declarations and packet-buffer size.
Rust and dependencies, the Android Gradle wrapper, and the Nix pin are updated.
Apple mobile builds include a libc compatibility pin. The apps and documentation
also use the refreshed Forwiroh cable logo.
Forwiroh 0.1.6
Forwiroh 0.1.6
Forwarding now reports when the remote TCP connection is ready and includes the
failure stage when setup fails. Embedded clients can show the Forwiroh error
when their local socket closes. A server that no longer trusts a device reports
that pairing is required.
Forwiroh can retry forward setup on a fresh QUIC connection if a cached
connection stalls. It retries before forwarding TCP payload and keeps unrelated
streams open. An approved re-pair refreshes the saved addresses for the same
endpoint identity and preserves the peer's permissions.
Embedders can use the released SwiftPM binaries with the existing C ABI. The
new forwarding diagnostics are available through the Swift SDK's event stream.
Forwiroh 0.1.5
Forwiroh 0.1.5
Windows SwiftPM SDK builds now cover amd64 and arm64. The release workflow builds
the Rust static library on each native Windows runner, then tests the unpacked
SDK and an external Swift consumer. The complete SwiftPM package includes both
Windows libraries alongside the Apple, Linux and Android variants.
Nix users can build the CLI and enter a development shell through the new flake.
A NixOS module provides programs.forwiroh options to install the CLI and run its
daemon as a systemd service with a configurable user, device name and state
directory.
Maintainers can use scripts/version.sh to show the current version or update
the workspace, lockfile and application versions together. Release notes and
scripts/check-release.py remain required before tagging.
Forwiroh 0.1.4
Forwiroh 0.1.4
Healthy idle TCP streams now stay open. The previous five-minute
application-idle cutoff is gone; a quiet stream lives as long as its QUIC
connection is healthy. QUIC keepalives run every 20 seconds and a 60-second
transport idle timeout still detects a dead peer, so stale sessions are never
kept forever. TCP half-close is preserved.
Peer dials are isolated per peer. A stalled handshake to one peer no longer
blocks connections to other peers, and shutdown cancels pending dials
immediately instead of waiting for the setup timeout.
Connection failures are now reported instead of only logged. Core events include
connecting and connection_error with the peer ID. disconnected now carries
the close reason and a connected flag that says whether another connection to
that peer remains active. Forward and SOCKS tunnel_error events identify the
peer and tunnel, so clients can explain a failure and decide when to reconnect.
Install the latest CLI on Linux, macOS or Android/Termux:
curl -fsSL https://github.com/trufae/forwiroh/releases/latest/download/install.sh | shOn Windows PowerShell:
irm https://github.com/trufae/forwiroh/releases/latest/download/install.ps1 | iexInstallers choose the architecture, pin one release and check the archive's
SHA-256 before replacing an existing executable. Downloads and installers have
checksums in CLI-SHA256SUMS.
forwiroh-android-debug.apk is an installable debug build of apps/android,
including arm64-v8a and x86_64 native libraries. It uses automatic debug signing;
no release signing key is needed. Smaller arm64-v8a and x86_64 debug APKs are
also included. Native libraries are compressed in the APK and extracted during
installation to keep downloads small. Their checksums are in ANDROID-SHA256SUMS.
The SwiftPM SDK archives and SHA256SUMS remain included, along with the
size-focused Rust builds using -Oz, full LTO, one code generation unit and
symbol stripping.
Forwiroh 0.1.2
Forwiroh 0.1.2
Standalone CLI downloads now cover Linux, Android, macOS and Windows, with
x86_64 and arm64 executables for each platform. Linux binaries are statically
linked with musl, including the Linux arm64 build. Windows uses an owner-only
named pipe for local daemon control and supports interactive pairing approval.
Install the latest CLI on Linux, macOS or Android/Termux:
curl -fsSL https://github.com/trufae/forwiroh/releases/latest/download/install.sh | shOn Windows PowerShell:
irm https://github.com/trufae/forwiroh/releases/latest/download/install.ps1 | iexInstallers choose the architecture, pin one release and check the archive's
SHA-256 before replacing an existing executable. Downloads and installers have
checksums in CLI-SHA256SUMS.
forwiroh-android-debug.apk is an installable debug build of apps/android,
including arm64-v8a and x86_64 native libraries. It uses automatic debug signing;
no release signing key is needed. Smaller arm64-v8a and x86_64 debug APKs are
also included. Native libraries are compressed in the APK and extracted during
installation to keep downloads small. Their checksums are in ANDROID-SHA256SUMS.
Size-focused Rust builds use -Oz, full LTO, one code generation unit and symbol
stripping. Linux, macOS and Windows CLI downloads use panic=abort; a panic
terminates the process. Android retains unwinding for standalone operation
without a Java application context. On
Apple Silicon, the CLI decreased from 16.7 MB to about 3.7 MB before compression.
Native library builds finish Rust LTO before linking into Swift or JNI, removing
embedded LLVM bitcode from packaged archives. Normal SDK releases retain panic
unwinding. The SwiftPM SDK archives and SHA256SUMS remain included.
Forwiroh 0.1.1
Forwiroh 0.1.1
Adds setPairingPolicy to the Swift SDK and pairing_policy to the command API. Embedded applications can restrict newly paired peers before inviting or connecting. The policy takes effect when the peer is saved, before it can access services, in both pairing directions. Existing peer policies are preserved. Set the default after each open; it lasts until shutdown.
Includes the asynchronous teardown test correction from main. Packaged consumers use prebuilt Apple, Linux and Android libraries without Cargo or binding generation.
Apple static-library headers now live under CForwiroh/, so Xcode can combine this SDK with other binary Swift packages without duplicate include/module.modulemap outputs.
Forwiroh 0.1.0
Forwiroh 0.1.0
First release of Forwiroh, with a reusable SwiftPM SDK for macOS, iOS, Linux,
and Android. Swift applications can embed the networking core without building
Rust or generating bindings.
The async API covers pairing and approval, peer permissions, TCP forwarding,
reverse forwarding, SOCKS, events, and VPN packet transport.
Downloads
Forwiroh-0.1.0-swiftpm.zip: complete offline SwiftPM package, including all
prebuilt libraries. Unpack it and add itsForwirohdirectory as a local
Swift package dependency.Forwiroh-0.1.0-swiftpm-remote.zip: smaller package that downloads the binary
assets from this release using verified checksums.ForwirohApple.xcframework.zip: macOS arm64/x86_64, iOS arm64, and iOS
simulator arm64/x86_64 static libraries and headers.ForwirohNative.artifactbundle.zip: Linux arm64/x86_64 glibc and musl, plus
Android arm64-v8a/x86_64 static libraries and headers.SHA256SUMS: SHA-256 checksums for the four ZIP assets.
Use a SwiftPM ZIP asset rather than GitHub's automatically generated source
archives. The source tag does not include the generated binary manifest.
Swift 6.2+ is required; deployment minimums are macOS 14, iOS 17, and Android API
28. Linux requires glibc 2.39 or musl on both architectures.
See the integration guide
for pmai setup, persistent mobile identities, Android JNI initialization, and
the Android certificate verifier dependency.
Validation and limitations
The release workflow runs Swift tests on macOS and Linux, builds external Swift
consumers, and checks iOS and Android cross-compilation. Android device runtime
testing remains outstanding. The host application owns system VPN integration
and background services; this release does not include signed application
installers.
The packaged droppingOwnerReleasesDirectoryWithEventReader test can fail
intermittently because it tries to reuse the state directory before deinitialization
has finished releasing its lock. The test's timing assumption is corrected on
main. Application callers should await node.close() before reusing a state
directory, as described in the integration guide.