maidsafe/autonomi stable-2026.1.1.1

2026.1.1.1

on GitHub

Binary Versions

• antnode: v0.4.14
• antctl: v0.14.1
• antctld: v0.14.1
• ant: v0.5.0
• evm-testnet: v0.1.18
• nat-detection: v0.2.22
• node-launchpad: v0.6.2

Binary Hashes

x86_64-pc-windows-msvc

x86_64-apple-darwin

aarch64-apple-darwin

x86_64-unknown-linux-musl

arm-unknown-linux-musleabi

armv7-unknown-linux-musleabihf

aarch64-unknown-linux-musl

Installation Options

macOS CLI Suite

Install ant, antnode, and antctl using the signed and notarized pkg installer.

Download the appropriate pkg file for your Mac:

• Apple Silicon (M1/M2/M3): 2026.1.1.1.autonomi.aarch64-apple-darwin.pkg
• Intel: 2026.1.1.1.autonomi.x86_64-apple-darwin.pkg

Double-click the downloaded file and follow the installation prompts.
The binaries will be installed to /usr/local/bin.

Verify the installation:

ant --version
antnode --version
antctl --version

macOS Node Launchpad App

Node Launchpad is a TUI application for managing Autonomi nodes.

Download the appropriate DMG file for your Mac:

• Apple Silicon (M1/M2/M3): 2026.1.1.1.node-launchpad.aarch64-apple-darwin.dmg
• Intel: 2026.1.1.1.node-launchpad.x86_64-apple-darwin.dmg

Open the DMG and drag Node Launchpad to your Applications folder.
The app will open Terminal and run the Node Launchpad TUI.

Windows CLI Suite

Install ant, antnode, and antctl using the signed MSI installer.

Download: 2026.1.1.1.autonomi.x86_64-pc-windows-msvc.msi

Double-click the downloaded file and follow the installation prompts.
The binaries will be installed to C:\Program Files\Autonomi\ and added to your PATH.

Verify the installation (open a new Command Prompt or PowerShell):

ant --version
antnode --version
antctl --version

Windows Node Launchpad App

Node Launchpad is a TUI application for managing Autonomi nodes.

Option 1: Direct MSIX Install

Download: 2026.1.1.1.node-launchpad.x86_64-pc-windows-msvc.msix

Double-click the downloaded file to install. The app will appear in your Start Menu.

Option 2: Install with Auto-Updates (Recommended)

Download: 2026.1.1.1.node-launchpad.x86_64-pc-windows-msvc.appinstaller

Double-click the .appinstaller file. This will install the app and enable automatic updates.
When a new version is released, you'll be prompted to update on app launch.

After installation, you can run Node Launchpad from the Start Menu or by typing node-launchpad.exe in any terminal.

Linux CLI Suite (Debian/Ubuntu)

Install ant, antnode, and antctl using the signed deb package.

Download the appropriate deb file for your architecture:

• x86_64 (AMD64): 2026.1.1.1.autonomi.x86_64-unknown-linux-musl.deb
• ARM64 (aarch64): 2026.1.1.1.autonomi.aarch64-unknown-linux-musl.deb
• ARMv7 (armhf): 2026.1.1.1.autonomi.armv7-unknown-linux-musleabihf.deb
• ARM (armel): 2026.1.1.1.autonomi.arm-unknown-linux-musleabi.deb

Import and trust the GPG signing key (first time only):

curl -fsSL https://raw.githubusercontent.com/maidsafe/autonomi/main/resources/keys/autonomi-signing-key.asc -o /tmp/autonomi-signing-key.asc
gpg --import /tmp/autonomi-signing-key.asc
echo 'D39ABED4DC364A8D0812F539C19B57B73D6EA0AB:6:' | gpg --import-ownertrust

Verify the signature:

gpg --verify 2026.1.1.1.autonomi.x86_64-unknown-linux-musl.deb.asc 2026.1.1.1.autonomi.x86_64-unknown-linux-musl.deb

Install the package:

sudo dpkg -i 2026.1.1.1.autonomi.x86_64-unknown-linux-musl.deb

The binaries will be installed to /usr/local/bin.

Verify the installation:

ant --version
antnode --version
antctl --version

Linux CLI Suite (Fedora/RHEL/CentOS)

Install ant, antnode, and antctl using the signed rpm package.

Download the appropriate rpm file for your architecture:

• x86_64: 2026.1.1.1.autonomi.x86_64-unknown-linux-musl.rpm
• ARM64 (aarch64): 2026.1.1.1.autonomi.aarch64-unknown-linux-musl.rpm
• ARMv7: 2026.1.1.1.autonomi.armv7-unknown-linux-musleabihf.rpm
• ARM: 2026.1.1.1.autonomi.arm-unknown-linux-musleabi.rpm

Import the GPG signing key (first time only):

curl -fsSL https://github.com/maidsafe/autonomi/raw/main/resources/keys/autonomi-signing-key.asc | gpg --import

Verify the signature (optional):

Download the .asc signature file alongside the rpm, then:

gpg --verify 2026.1.1.1.autonomi.x86_64-unknown-linux-musl.rpm.asc 2026.1.1.1.autonomi.x86_64-unknown-linux-musl.rpm

Install the package:

sudo rpm -i 2026.1.1.1.autonomi.x86_64-unknown-linux-musl.rpm

Or using dnf:

sudo dnf install ./2026.1.1.1.autonomi.x86_64-unknown-linux-musl.rpm

The binaries will be installed to /usr/local/bin.

Verify the installation:

ant --version
antnode --version
antctl --version

Merged Pull Requests

2025-12-24 #3384 -- feat(client): using req/rsp DM as a fallback during mutable_data fetch [@maqi]
2026-01-05 #3388 -- refactor(evmlib): gas estimation [@mickvandijke]
2026-01-05 #3391 -- feat(node): remove peer when failed to fetch version [@maqi]
2026-01-07 #3376 -- feat: add developer query closest-peers [@mickvandijke]
2026-01-07 #3385 -- feat(ant): add developer node-version command [@mickvandijke]
2026-01-12 #3402 -- node(feature): approve merkle upload when node lacks network knowledge [@maqi]
2026-01-12 #3403 -- ci(fix): add disk space cleanup for Ubuntu CI runners [@maqi]
2026-01-13 #3398 -- fix(ci): add disk space cleanup step to prevent rust-cache failures [@vphongph]
2026-01-13 #3407 -- fix(autonomi): prevent double slashes in normalized archive paths [@b-zee]
2026-01-14 #3409 -- Client refactors [@grumbach]
2026-01-14 #3406 -- client(feat): improve merkle upload reliability with extended timeout and Kad fallback [@maqi]
2026-01-15 #3394 -- feat(ant): add developer get-quote command [@mickvandijke]
2026-01-19 #3404 -- docs(fix): use --release flag for antctl in documentation [@b-zee]
2026-01-19 #3410 -- refactor(ant-node): increase request timeout to 120 seconds [@mickvandijke]
2026-01-20 #3355 -- docs: improve ant-cli README with industry best practices [@Nic-dorman]
2026-01-21 #3415 -- refactor: upload flow [@grumbach] [BREAKING]
2026-01-21 #3417 -- fix(autonomi): catch error for GetVersion query [@mickvandijke]
2026-01-21 #3416 -- docs: add missing CLI options to ant-cli README [@maqi]
2026-01-23 #3419 -- feat: print information about gas costs [@grumbach]
2026-01-27 #3423 -- feat: local merkle pricing with the correct formula [@grumbach]
2026-01-27 #3422 -- Cli consistency fixes [@grumbach]
2026-01-27 #3421 -- ci: centralize binary build step [@RolandSherwin]
2026-01-28 #3432 -- feat: add multiple platform-native installation options [@jacderida]

Detailed Changes

API

Added

• BulkPaymentOption::ForceMerkle variant to force merkle tree payments regardless of chunk count.
• BulkPaymentOption::ForceRegular variant to force regular per-batch payments regardless of chunk
  count.
• BulkPaymentOption::is_force_merkle() method to check if the option forces merkle payment.
• BulkPaymentOption::is_force_regular() method to check if the option forces regular payment.
• Request/response direct message fallback for mutable data fetch operations (pointers, scratchpads,
  graph entries), improving reliability when KAD queries fail.
• MERKLE_PAYMENT_THRESHOLD constant is now publicly exported for use by consuming crates.

Changed

• The file_content_upload, file_content_upload_public, dir_content_upload, and
  dir_content_upload_public methods now require explicit selection of payment mode via the
  --merkle or --regular flags in the CLI, or ForceMerkle/ForceRegular variants in the API.
  [BREAKING]
• Client request timeout extended to 120 seconds to improve reliability on slower connections.
• Substream timeout increased to 120 seconds to match the request timeout.
• Cost estimation code improved for more accurate payment calculations.
• Upload flow refactored to centralise reporting and retry logic.

Fixed

• Double slashes in normalised archive paths are now prevented.
• GetVersion query errors are now properly caught and handled instead of propagating unexpected
  failures.

Network

Added

• DevGetClosestPeersFromNetwork query for developer analytics, allowing nodes to perform full
  network lookups rather than just returning local routing table entries. This query is only
  available when the developer feature is enabled.

Changed

• Request timeout increased to 120 seconds to improve reliability for slower network operations.
• Nodes now approve merkle uploads even when they lack full network knowledge (fewer than K_VALUE
  peers in routing table), improving upload success rates during network churn.

Fixed

• Peers are now removed from the routing table when version fetch operations fail, improving routing
  table accuracy.

Payments

Changed

• Gas estimation now uses EIP-1559 fee estimation for more accurate and predictable transaction
  costs.
• Gas cost information is now printed during payment operations, providing better visibility into
  transaction costs.
• Local merkle pricing now uses the correct formula for cost calculations.

Fixed

• Invalid gas cost aggregation corrected to provide accurate total cost reporting.

Ant Client

Added

• A developer subcommand adds various tools for querying the network.

Changed

• The file cost and file upload commands now require explicit selection of payment mode using
  --merkle or --regular flags. The previous automatic selection based on chunk-count threshold
  has been removed. [BREAKING]
• Improved consistency between cost estimation and upload commands.
• Payment selection logging improved to reduce confusion.

General

Added

• macOS signed and notarized pkg installer for the CLI suite (ant, antnode, antctl), providing
  a standard macOS installation experience with binaries installed to /usr/local/bin.
• Windows signed MSI installer for the CLI suite (ant, antnode, antctl), installing to
  C:\Program Files\Autonomi\ and adding binaries to PATH.
• Linux signed Debian package (.deb) for the CLI suite (ant, antnode, antctl) on
  Debian/Ubuntu systems, with support for x86_64, aarch64, armv7, and arm architectures. Includes
  detached GPG signature for verification.
• Linux signed RPM package (.rpm) for the CLI suite (ant, antnode, antctl) on
  Fedora/RHEL/CentOS systems, with the same architecture support and GPG signing as the Debian
  package.

Launchpad

Added

• macOS signed and notarized app bundle (.dmg) for Node Launchpad, allowing users to drag the
  application to their Applications folder for standard macOS app installation.
• Windows signed MSIX installer for Node Launchpad, with automatic update support via
  .appinstaller files and Start Menu integration.