npm / @ardrive/turbo-sdk
@ardrive/turbo-sdk
What changed in @ardrive/turbo-sdk 1 to 2, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-26.
5 breaking1 new APIs and options1 behavior and defaults25 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@ardrive/turbo-sdk 213 changes
Breaking changes 4
The CLI's -m and --mnemonic option is removed from every command.
The exported Kyve TokenType is removed.
The kyve entry is removed from tokenTypes.
x402-fetch moves from a dependency to an optional peer dependency; callers using X402Funding or uploadRawX402Data must install it themselves, while other callers are unaffected.
New APIs and options 1
Adds support for solana-usdc (USDC SPL on Solana) as a token.
Fixes and other changes 8
An unreadable 4xx body after a payment is wrapped.
An abort is passed through only when the caller aborted.
uploadFile no longer pays again after a lost paid answer.
Keeps the payer's prompt out of the blockhash window.
Sends no payer signature on /sign.
Confirms against the wallet's blockhash instead of the SDK's.
Lets a Solana wallet adapter pay with USDC and ARIO.
The optional peer is required before uploadRawX402Data builds a signer, so a missing peer fails before signing.
@ardrive/turbo-sdk 119 changes
Breaking changes 1
Oversized single requests are refused instead of buffered, with the guard sized against the signed item.
Behavior and default changes 1
buy-name can carry the ANT's opening state.
Fixes and other changes 17
An ario checkout is sent to the Solana account uploads bill.
The signer reads an ario client's balance where the service bills it.
The x402 HTTPS check now exempts the IPv6 loopback.
Accepts the 201 response the service sends for a paid raw upload.
Keeps a settled payment settled.
Checks the signed size.
Names the stream factory when a retry is handed a used stream.
Fixes argument parsing when the CLI runs on Windows.
Auto mode chunks x402 items that exceed the single-request cap.
Reports x402 upload success only after the request succeeds.
A folder's on-demand top-up now includes its manifest.
Folder estimates no longer fall below the service price.
The on-demand ceiling is reported in whole tokens.
On-demand top-ups are sized to what the service charges.
Retries carry the paid upload id so the same upload is bought only once.
The single-request path is repaired, and uploads can be priced without sending them.
winstonCost is no longer typed on the data-item price.