Preflight Errors

Overview

Before PrivateACB runs an ACB or capital-gains calculation, it runs a preflight check — a quick dry-run of the calculation engine that surfaces problems while they’re still cheap to fix. If preflight finds a blocking issue, the asset’s row in the Asset Table shows an error indicator and the calculation is held back until you resolve it.

Preflight runs:

• When you click Calculate on an asset
• When the Asset Table refreshes (after import, after deletions, after market-data fetches)
• When you switch jurisdictions or methods that change what the engine needs

Preflight is read-only. It never modifies your database, never persists results, and never triggers exports. Its only job is to tell you “this asset isn’t ready for a real calculation, here’s why.”

Reading the Preflight Popover

Click the error indicator on any asset row to open the preflight popover. Each issue is structured the same way:

Field	What it tells you
Issue	A short description of what went wrong (e.g., “Cost basis is unknown for a transfer-in”)
Resolution	One or more concrete options for fixing the issue
Context	Optional structured data — e.g., the specific date and quantity, available wallets, a heuristic source hint

The popover header has a Copy button. Use it whenever you want to capture the full message as plain text — useful for support tickets, your own notes, or sharing with your accountant. The Copy button works on every preflight message, current and future.

Tip

The preflight popover is the canonical source of truth for why a calculation is blocked. The Asset Table row only shows that there’s an issue. Always click through to the popover before troubleshooting elsewhere.

After Upgrading PrivateACB

PrivateACB caches preflight results between app sessions to keep the dashboard fast. The cache is keyed by transaction state, not by app version — which means after you install a new version, your dashboard may briefly show preflight results that were generated by the previous build.

To force a fresh preflight after upgrading:

1. Click Calculate on the affected asset. This re-runs preflight and replaces the cached result.
2. Or re-import the source CSV. Importing invalidates the cache for all assets in the file and exercises any new import-time logic the upgrade introduced.

This is most relevant when an upgrade adds a new preflight check (such as the unmatched transfer-in check shipped in v2.8.x). Existing assets won’t surface the new check until the cache is refreshed.

Common Preflight Errors

Cost basis is unknown for a transfer-in

This error fires when PrivateACB sees a deposit or transfer-in for an asset, but the cost basis for those units cannot be established from the data you’ve imported. Most commonly:

• External wallet deposits — you transferred crypto into the exchange from a wallet whose history isn’t in your imports.
• Fork credits and airdrops — your exchange credited you with a new asset (e.g., post-Merge ETHW) without a purchase event.
• Manual self-transfers between exchanges — when only one side of the transfer was imported.

Without a cost basis, the engine can’t compute a gain or loss when you eventually dispose of these units, and any subsequent sale would silently understate the cost — so PrivateACB blocks the calculation rather than producing wrong numbers.

Heuristic source hints

When the deposit matches a date and asset that PrivateACB recognizes (for example, the ETHW airdrop on September 15, 2022), the popover shows a source hint like “Looks like an airdrop.” The hint is informational only — it doesn’t change what you need to do, but it can help you remember where the units came from. The list of recognized events grows over time; if your deposit isn’t recognized, you’ll see the error without a hint.

Resolution paths

The popover lists three resolution paths. Pick the one that matches what actually happened:

1. Edit your CSV to add a Purchase row

Most precise. Use this when you know what the units originally cost — for example, you have records from another exchange or wallet that wasn’t included in this import.

1. Open your CSV in a spreadsheet editor.
2. Add a row representing the original purchase, dated before the deposit, with type Purchase (or your exchange’s equivalent) and the actual cost in your reporting currency.
3. Re-import the modified file.

The cost basis flows naturally from the new row when ACB runs.

2. Re-import and reclassify the deposit as Income in Step 3

Use this when the units were genuinely income — an airdrop, fork credit, staking reward, mining reward, or any other receipt you didn’t pay for.

1. Re-run the import wizard for the affected file.
2. In Step 3 (Classification Review), change the row’s classification from Transfer (or Deposit) to Income.
3. Complete the import.

PrivateACB’s Income class admits the units into your pool at fair market value on the receipt date, with cost basis equal to that day’s market price. You’ll need market data for that date — Market Data tab → Fetch — and the calculation runs cleanly.

Caution

Reclassification is type-level, not row-level. Changing the classification in Step 3 flips every row of that type in the file. If your file mixes airdrops with self-transfers, use the CSV-edit path (option 1) instead so each row carries its own correct classification.

The tax meaning of reclassifying as Income depends on your jurisdiction:

• Canada: Income reported at FMV; future disposals use that FMV as the ACB.
• United States: Ordinary income at receipt; the receipt-date market price becomes your basis for capital-gains purposes.
• Australia: Ordinary income or CGT depending on the nature of the receipt; PrivateACB defaults to ordinary-income treatment.
• United Kingdom: Income tax at FMV on receipt; that FMV enters the Section 104 pool.

Confirm with a tax professional if you’re unsure whether the receipt is income in your jurisdiction.

3. Exclude the asset

Use this when you don’t intend to report the asset at all — for example, dust holdings or test-mode receipts you never disposed of.

Open the asset’s row in the ACB Calculator, click Exclude, and confirm. The asset stops appearing in calculations and reports until you restore it. See the Deletion Guide for details on the exclude-vs-delete distinction.

---

Insufficient quantity for a disposal

This error fires when a disposal (sale, trade-out, send) tries to consume more units than the engine has tracked into the pool by that date. Almost always one of:

• Missing earlier transactions — purchases made on an exchange you haven’t imported yet.
• Imported the same file twice with different deduplication — duplicates suppressed disposals or amplified them.
• Decimal precision issues at boundaries — extremely rare; PrivateACB uses an 8-decimal tolerance internally.

Open the ACB Summary report for the affected asset and walk forward through the transaction list. The first row where the running balance goes negative is where data is missing. Import the missing transactions, delete the old calculation, and recalculate.

This error has been around since the earliest versions of PrivateACB and is by far the most common preflight blocker after a fresh import.

---

Missing prices for required dates

PrivateACB needs a market price for every date on which a calculation needs to value a transaction — disposals always, and acquisitions when the receipt is income. If the price is missing, preflight blocks the calculation rather than guessing.

Resolution: go to the Market Data tab, select the affected asset and date range, and click Fetch. PrivateACB auto-routes between CoinGecko and CryptoCompare; for dates older than 365 days, CryptoCompare handles the lookup automatically.

If neither source has a price for the asset on the required date — for instance, a thinly-traded altcoin on a weekend — use the manual entry path on the Market Data tab to type in a rate from a third-party source (CoinMarketCap, the exchange’s own historical data, etc.).

See the Market Data Guide and Crypto Price Fetching Guide for the full workflow.

---

No lots in target wallet (US per-wallet only)

US-specific. When Account-by-Account Tracking is enabled (Treasury Decision 10000, in effect from 2025), each disposal must consume lots from the wallet it physically left. If preflight finds a disposal in a wallet with no acquired lots, it blocks the calculation.

This usually means a transfer between your own exchanges wasn’t matched — PrivateACB doesn’t know that the lots in Wallet A “moved” to Wallet B because the transfer rows weren’t paired up at import time.

See the US 1099-DA & Account-by-Account Guide for the full troubleshooting workflow, including how to add a manual transfer match or temporarily disable Account-by-Account Tracking to verify your data.

When the Preflight Check Doesn’t Run

If you click Calculate and nothing happens, preflight isn’t blocking — something earlier in the chain is. Verify in order:

1. Config Bar selections — jurisdiction, method, and at least one asset must be selected.
2. License status — calculations require an active license or a non-expired trial. Check Settings → License.
3. Active calculation in progress — if a previous calculation is still running, the Calculate button is disabled until it finishes or is cancelled.

See your jurisdiction’s calculation guide for the full Config Bar walkthrough — Canada, United States, Australia, United Kingdom.

Related Guides

• Canadian ACB Calculation — CRA workflow and troubleshooting
• US Tax Calculation — FIFO/LIFO/HIFO + wash sale + per-wallet
• Australian CGT Calculation — 50% discount, Q18 netting
• UK Capital Gains Calculation — Section 104 pool + matching rules
• Import Flow Guide — How transactions flow into PrivateACB
• Classification Review Guide — Step 3 of the import wizard
• Market Data Guide — Fetching exchange rates and crypto prices
• Error Reporting — Validation errors during CSV import

---

Last Updated: May 2026 PrivateACB Version: 2.8.1