Release Notes
- Fixed Core Lightning Commando preflight errors in builds without Commando transport support to
report the unsupported operation instead of telling users to change the configured address.
- Fixed Core Lightning Commando
getinfo timeout and transport preflight failures to point at
config.address with node-health guidance instead of telling users to verify rune authorization,
while common Commando rune-denial wording such as "Not permitted", "access denied", and
"forbidden" now points at config.rune.
- Changed configured Core Lightning Commando connection create, update, and validation flows to
verify live reachability and getinfo rune authorization before persistence; unconfigured
CoreLN manual-import connections remain supported.
- Added capital gains
holding_period_term values to structured rows and a Holding Period Term
CSV column next to Holding Period Days, classifying rows as short-term or long-term under the
report's built-in more-than-one-year rule.
- Added Custom CSV
transfer_ref support for Deposit and Withdrawal imports so script-produced
non-BTC custodial movements, such as Gnosis Safe USDT withdrawals and ChainFlip USDT deposits, can
link as transfers without Ethereum indexing.
- Added first-class USDC asset catalog support with fixed 1:1 USD valuation and Circle issuer
metadata, matching the existing USD-pegged stablecoin handling.
- Added
clams update <version> for installing a specific tagged release,
including customer RC builds, plus clams update stable to return to the
latest public release.
- Fixed no-target
clams update for RC-channel installs and explicit RC
metadata-channel overrides to fail closed when RC metadata is unavailable
instead of falling back to the public stable installer.
- Added first-class USDT asset catalog support for Custom CSV imports, including optional network
attribution and fixed 1:1 USD valuation through existing report rate paths. Journal snapshots and
CLI journal/portfolio text output now preserve imported asset identity. Custom CSV trade mappings
can now provide network_asset to identify which trade side a network attribution describes;
ambiguous trade network attribution now fails closed instead of guessing.
- Fixed Custom CSV asset expansion edge cases so blank trade networks ignore
network_asset, trade
network_asset columns participate in header preflight, native parse_decimal values preserve
leading signs in numeric when comparisons only, duplicate rows use the last network sidecar
state in an import, asset-bearing canonical amount/fee fields require decimal_sats storage
precision and reject negative evaluated values before upsert, and direct USD-pegged assets do not
require rate provider pair metadata.
- Fixed balance-sheet tree text output so non-BTC asset amounts use native asset display precision
instead of the fixed BTC sats precision.
- Fixed BTC amount rendering from expanded journal snapshots so fractional-sat balances and entries
continue to display millisatoshi precision instead of rounding to whole sats.
- Fixed USD-pegged asset valuation so providers without supported-pair metadata route assets such as
USDT through USD before probing unsupported direct asset pairs.
- Fixed standalone capital-gains reports so BTC trades against USD-pegged assets such as USDT use
the pegged counter-asset proceeds instead of falling back to the hourly BTC-fiat market rate.
- Added structured Lightning proof diagnostics to
clams journals quarantined --proof-diagnostics output and
JSON/YAML clams journals quarantine show, including proof status for channel close txid, UTXO
origin/link, spent-input ownership, and HTLC witness/script evidence.
- Fixed
clams journals quarantined --proof-diagnostics --format csv output to keep quarantine rows for
reason codes that do not have Lightning proof diagnostics.
- Fixed global
-v/--verbose logging verbosity so it no longer changes clams journals quarantined
JSON/YAML/CSV output projections.
- Fixed Core Lightning pending
ONCHAIN channel sync to leave close proof absent instead of
aborting when the selected on-chain source cannot complete an outspend lookup.
- Fixed Lightning on-chain journaling to reject amount-only external-output inference, require
canonical/script evidence for external HTLC claims, and resolve multiple retained anchor/zero-fee
HTLC continuation outputs only when already-proved candidates have a unique exact input/output
amount bijection; duplicate, mixed, or fee-bearing ambiguity remains quarantined.
- Fixed selected-source canonical transaction script evidence to emit raw scriptSig/scriptPubKey
bytes instead of consensus-encoded scripts with CompactSize prefixes.
- Fixed anchor/zero-fee HTLC success and timeout journals to keep external HTLC
continuation outputs in Lightning when the spent close output and witness script prove the
channel, independent of output index, while leaving wallet fee inputs and change in wallet
accounting.
- Fixed untyped Core Lightning selected-source HTLC continuation transactions to use the same
close-output and witness proof before wallet residual accounting, post proven HTLC input/output
residuals as Lightning-funded on-chain fees, credit matching custodial deposit bridges from
proved HTLC capacity, group batched same-channel HTLC inputs before checking continuation output
capacity, leave close-sweep-funded remainder outputs in wallet accounting, and avoid spurious
journal quarantines when no HTLC transaction type hint is present.
- Fixed external HTLC continuation planning to require explicit continuation evidence, a P2WSH
script template, or cached delayed-to-local spender witness on retained outputs, ignoring
amount-only non-HTLC remainder outputs instead of treating them as missing-capacity or
ambiguous-output quarantines.
- Fixed external HTLC continuation journals to quarantine same-index outputs that already carry
canonical or graph evidence for a different channel.
- Fixed external HTLC continuation planning to quarantine generic continuation outputs that match
HTLC inputs from multiple proved channels instead of assigning them by channel iteration order.
- Added canonical on-chain script evidence fields for transaction inputs, outputs, and UTXOs, with
LMDB bincode compatibility for legacy Transaction and UTXO rows.
- Added canonical close metadata for transaction raw version/locktime/sequence proof and split
channel settlement receipt/local close fee fields; clams canonical channels JSON/YAML now shows
the split close amounts.
- Changed Core Lightning and LND on-chain hydration to use only the configured profile on-chain
source for Lightning candidate transactions, leaving evidence absent instead of falling back to
an implicit backend.
- Fixed LND close-output UTXO linkage so cooperative close outputs backed by the closed-channel
close txid and local receipt amount carry canonical channel proof, and improved HTLC continuation
planning to use later delayed-to-local spend witness evidence before quarantining otherwise
ambiguous generic P2WSH outputs.
Install clams 1.0.0-beta.13
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/clams-tech/releases/releases/download/clams-v1.0.0-beta.13/clams-installer.sh | sh
Install prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/clams-tech/releases/releases/download/clams-v1.0.0-beta.13/clams-installer.ps1 | iex"
Download clams 1.0.0-beta.13
