Repository navigation
Releases
v1.0.0
v1.0.0 (2026-11-16)
Feat
- freeze the api at v1.0.0 (#159)
- base: purge on use only, a protected ResolveNextHop and BroadcastControlOn (#168)
- release: each release opens the vcpkg-registry port pr; readme gains the vcpkg route (#154)
Fix
- checks: take an unversioned clang++ only when it is clang 17 or newer (#182)
- checks: self-test under any clang, install the pinned clang for the api record (#180)
- base: connect a WifiLinkMonitor aggregated after the node initialized (#171)
Verify your download
Checksums (also the SHA256SUMS asset):
492959d3faa62684762819eebac21e7da5385351ba238ff9ffb7a3170e461d69 ns3-swarm-core-1.0.0.cdx.json
c7f11b1e1f7b1a666f424ea4a0bc96e27a4f7e5bc8d15edea5817be6932a60a7 swarm-core-1.0.0.tar.gz
sha256sum -c SHA256SUMS --ignore-missing # in the directory you downloaded to
Every asset carries signed SLSA build provenance (ns3-swarm-core-1.0.0.intoto.jsonl, and the Sigstore bundle ns3-swarm-core-1.0.0.sigstore.json) and is described by a CycloneDX SBOM (ns3-swarm-core-1.0.0.cdx.json). With the GitHub CLI, for any asset, e.g. swarm-core-1.0.0.tar.gz:
gh attestation verify swarm-core-1.0.0.tar.gz --repo swarm-routing/ns3-swarm-core --signer-workflow swarm-routing/.github/.github/workflows/reusable-release.yml
gh attestation verify swarm-core-1.0.0.tar.gz --repo swarm-routing/ns3-swarm-core --predicate-type https://cyclonedx.org/bom --signer-workflow swarm-routing/.github/.github/workflows/reusable-release.yml
gh attestation verify swarm-core-1.0.0.tar.gz --repo swarm-routing/ns3-swarm-core --bundle ns3-swarm-core-1.0.0.sigstore.json --signer-workflow swarm-routing/.github/.github/workflows/reusable-release.yml # offline
Built and signed by reusable-release.yml, run 43795857457.
v0.4.0
v0.4.0 (2026-11-15)
Feat
- model: reach a multi-interface peer by its canonical address through a peer map (#145)
- model: one OnTxFailure hook per Wi-Fi retry-limit drop, saying whether the lost frame was data (#144)
- core: core/ targets C++23, the standard of the ns-3 release swarm-core supports (#142)
- model: deferred-queue hold classes with their own cap and statistics, and expiry re-armed on requeue (#143)
- core: per-destination evaporation over chosen entries, and re-timing the last hop of a visited path (#140)
Verify your download
Checksums (also the SHA256SUMS asset):
9d552b4b8bb3afd3c2f2ab228838f203a0f462b481e7c61413e6e5224a881ecd ns3-swarm-core-0.4.0.cdx.json
28df546260152d6dae3440d6c367821b525ab40d6bf49050b8a1c75967e393ea swarm-core-0.4.0.tar.gz
sha256sum -c SHA256SUMS --ignore-missing # in the directory you downloaded to
Every asset carries signed SLSA build provenance (ns3-swarm-core-0.4.0.intoto.jsonl, and the Sigstore bundle ns3-swarm-core-0.4.0.sigstore.json) and is described by a CycloneDX SBOM (ns3-swarm-core-0.4.0.cdx.json). With the GitHub CLI, for any asset, e.g. swarm-core-0.4.0.tar.gz:
gh attestation verify swarm-core-0.4.0.tar.gz --repo swarm-routing/ns3-swarm-core --signer-workflow swarm-routing/.github/.github/workflows/reusable-release.yml
gh attestation verify swarm-core-0.4.0.tar.gz --repo swarm-routing/ns3-swarm-core --predicate-type https://cyclonedx.org/bom --signer-workflow swarm-routing/.github/.github/workflows/reusable-release.yml
gh attestation verify swarm-core-0.4.0.tar.gz --repo swarm-routing/ns3-swarm-core --bundle ns3-swarm-core-0.4.0.sigstore.json --signer-workflow swarm-routing/.github/.github/workflows/reusable-release.yml # offline
Built and signed by reusable-release.yml, run 43676757923.
v0.3.0
v0.3.0 (2026-11-14)
Feat
- core: core/ installs as the CMake package swarm-core, found with find_package (#137)
- core: a discrete-event testbench for protocol cores, trend tests without a simulator (#129)
- core: fuzzy composite link metric, a delay x stability rule table over hop count (#130)
- model: learn point-to-point neighbours from link state, beacons suppressed per interface (#123)
- core: energy-aware link metric, AntHocNet's energy metric bit for bit (#120)
- core: core/ as a cmake target, a
corecheck that builds it alone, and the docs at the state of main (#104)
Fix
- citation: render the ppsn 2004 paper as a conference paper in citation.cff (#105)
Verify your download
Checksums (also the SHA256SUMS asset):
b684fd7c9ee69e1e845876b31a84c85c12b160b458b09fa4b5f811255fba17e7 ns3-swarm-core-0.3.0.cdx.json
677dede53ed9c83d726f98816553a65d3ad9e7b62e02df318467a5438d492a05 swarm-core-0.3.0.tar.gz
sha256sum -c SHA256SUMS --ignore-missing # in the directory you downloaded to
Every asset carries signed SLSA build provenance (ns3-swarm-core-0.3.0.intoto.jsonl, and the Sigstore bundle ns3-swarm-core-0.3.0.sigstore.json) and is described by a CycloneDX SBOM (ns3-swarm-core-0.3.0.cdx.json). With the GitHub CLI, for any asset, e.g. swarm-core-0.3.0.tar.gz:
gh attestation verify swarm-core-0.3.0.tar.gz --repo swarm-routing/ns3-swarm-core --signer-workflow swarm-routing/.github/.github/workflows/reusable-release.yml
gh attestation verify swarm-core-0.3.0.tar.gz --repo swarm-routing/ns3-swarm-core --predicate-type https://cyclonedx.org/bom --signer-workflow swarm-routing/.github/.github/workflows/reusable-release.yml
gh attestation verify swarm-core-0.3.0.tar.gz --repo swarm-routing/ns3-swarm-core --bundle ns3-swarm-core-0.3.0.sigstore.json --signer-workflow swarm-routing/.github/.github/workflows/reusable-release.yml # offline
Built and signed by reusable-release.yml, run 43598871538.
v0.2.0
v0.2.0 (2026-11-13)
Feat
- base: node shutdown, crash and restart on swarmroutingbase, with a helper that scripts failures for every arm (#98)
- core: dedup history takes an optional entry lifetime next to the count cap (#94)
- base: a packet the wi-fi mac gave up on comes back to the protocol, with its previous hop (#95)
- base: defer is protected, so an adapter overriding routeinput holds its packets (#91)
Perf
- model: deferred queue without o(n²) rebuilds, cached ports, cancellable timers, a non-allocating wire path (#97)
Verify your download
Checksums (also the SHA256SUMS asset):
72b11af5c0f7a31ae29c36d4aa0799966928af57f1bc7457f4e8eb5352f4a7c0 ns3-swarm-core-0.2.0.cdx.json
b99800b29c579ab0f1b305b57816dfa4c773c3932de1e0c590055f46065dea73 swarm-core-0.2.0.tar.gz
sha256sum -c SHA256SUMS --ignore-missing # in the directory you downloaded to
Every asset carries signed SLSA build provenance (ns3-swarm-core-0.2.0.intoto.jsonl, and the Sigstore bundle ns3-swarm-core-0.2.0.sigstore.json) and is described by a CycloneDX SBOM (ns3-swarm-core-0.2.0.cdx.json). With the GitHub CLI, for any asset, e.g. swarm-core-0.2.0.tar.gz:
gh attestation verify swarm-core-0.2.0.tar.gz --repo swarm-routing/ns3-swarm-core --signer-workflow swarm-routing/.github/.github/workflows/reusable-release.yml
gh attestation verify swarm-core-0.2.0.tar.gz --repo swarm-routing/ns3-swarm-core --predicate-type https://cyclonedx.org/bom --signer-workflow swarm-routing/.github/.github/workflows/reusable-release.yml
gh attestation verify swarm-core-0.2.0.tar.gz --repo swarm-routing/ns3-swarm-core --bundle ns3-swarm-core-0.2.0.sigstore.json --signer-workflow swarm-routing/.github/.github/workflows/reusable-release.yml # offline
Built and signed by reusable-release.yml, run 43364656946.
v0.1.0
v0.1.0 (2026-11-11)
Feat
- observer: add swarm-core's router observer, its trace sources and counters (#44)
- model: the ns-3 glue: swarmroutingbase, deferredpacketqueue, link monitors, helpers (#30)
- core: the shared simulator-free primitives — visited path, LE wire helpers, pheromone table, ports (#27)
- ns3: swarm-core module skeleton with every org quality gate on (#13)
Perf
- core: flat per-destination pheromone rows, one-pass evaporation (#47)
Verify your download
Checksums (also the SHA256SUMS asset):
570381fa0d83014858064a4eb41c5eff4f3233fcca833f5f4038e4af9f952faa ns3-swarm-core-0.1.0.cdx.json
3fbeaeb99963890403b9ed02834ed2f1507b0f66e8d5bec237f8b5e32e3bb62f swarm-core-0.1.0.tar.gz
sha256sum -c SHA256SUMS --ignore-missing # in the directory you downloaded to
Every asset carries signed SLSA build provenance (ns3-swarm-core-0.1.0.intoto.jsonl, and the Sigstore bundle ns3-swarm-core-0.1.0.sigstore.json) and is described by a CycloneDX SBOM (ns3-swarm-core-0.1.0.cdx.json). With the GitHub CLI, for any asset, e.g. swarm-core-0.1.0.tar.gz:
gh attestation verify swarm-core-0.1.0.tar.gz --repo swarm-routing/ns3-swarm-core --signer-workflow swarm-routing/.github/.github/workflows/reusable-release.yml
gh attestation verify swarm-core-0.1.0.tar.gz --repo swarm-routing/ns3-swarm-core --predicate-type https://cyclonedx.org/bom --signer-workflow swarm-routing/.github/.github/workflows/reusable-release.yml
gh attestation verify swarm-core-0.1.0.tar.gz --repo swarm-routing/ns3-swarm-core --bundle ns3-swarm-core-0.1.0.sigstore.json --signer-workflow swarm-routing/.github/.github/workflows/reusable-release.yml # offline
Built and signed by reusable-release.yml, run 43038993842.