From a350df49d1d8fb22b90d23e16ad1b311192fceab Mon Sep 17 00:00:00 2001 From: ai-bot Date: Sun, 15 Nov 2026 10:30:01 +0000 Subject: [PATCH] Patch docs/spec.md --- docs/spec.md | 43 +++++++++++++++++++++++++++---------------- 1 file changed, 27 insertions(+), 16 deletions(-) diff --git a/docs/spec.md b/docs/spec.md index 69c0c91..17e40f0 100644 --- a/docs/spec.md +++ b/docs/spec.md @@ -88,31 +88,42 @@ Fees follow §3.2. ### 3.2 Fees (avgift) -A fee is entered on every transaction as an amount plus a currency (sats or NOK). Applied as: +A fee is entered in **sats only**. A kroner cost is not a fee in Skuld: the owner folds it into +the inngangsverdi or the utgangsverdi of the transaction, that is into the amount they type, and +Skuld never derives one from the other. -| Transaction | Fee in NOK | Fee in sats | -| --- | --- | --- | -| `trade` (buy) | added to the cost of the new lot | reduces the sats received; cost unchanged | -| `trade` (sell), `spend` | subtracted from the proceeds | increases the sats consumed at the same cost | -| `income` | subtracted from the taxable income value | reduces the sats received; income value unchanged | -| `transfer_out` | added to the cost of the destination lot | reduces the sats that arrive | -| `gift_received` | added to the cost of the new lot | reduces the sats received | -| `loss`, `gift_given` | no effect beyond being recorded | recorded, sats already leave the account | +| Transaction | Fee in sats | +| --- | --- | +| `trade` (buy) | reduces the sats received; the cost is unchanged, so the price per sat rises | +| `trade` (sell), `spend` | increases the sats consumed at the same cost | +| `income` | reduces the sats received; the income value is unchanged | +| `transfer_out` | taken on top of what is sent: it increases the sats consumed at the source and never reduces what arrives | +| `loss`, `gift_given` | recorded only, the sats already leave the account | -`Forvaltningskostnad` is not attached to an account and takes no fee at all (§3.10). +The fee of a `transfer_out` is shown on the `transfer_out` alone. The generated `transfer_in` +carries no fee at all (§3.3). -The fee section of the form is shown only for the types that take a fee: `trade`, `income`, -`spend`, `loss`, `transfer_out`, `transfer_in` and `gift_given`. It is hidden for -`gift_received` and `admin_cost`, and a fee sent for either of those two is rejected. +`gift_received` and `admin_cost` take no fee. The fee section of the form is shown only for +`trade`, `income`, `spend`, `loss`, `transfer_out` and `gift_given`, and a fee sent for any +other type is rejected. A fee that cannot be documented is not deductible, but Skuld does not try to judge that: it applies every fee it is given and the owner decides what to enter. ### 3.3 Internal transfers -`transfer_out` from account A to account B is **not** a realization. The consumed lots of A are -mirrored as new lots in B, keeping the original acquisition date and cost, plus the transfer -fee. A `transfer_in` row is generated automatically in B (see §7.4). +`transfer_out` from account A to account B is **not** a realization. + +- What the owner types as `Sendt` is exactly what arrives: the generated `transfer_in` in B gets + `leg_in_sats` equal to the sent amount, and no fee is ever subtracted from it. +- A fee in sats is taken on top, at A. A loses the sent sats plus the fee, B gains the sent + sats, and the fee sats leave the ledger altogether. +- The lots of A that the transfer consumed are mirrored as lots of B, keeping the acquisition + date and the cost per sat, so the bitcoin price of B's new lots is the price of the lots A + gave up. +- The mirrored lots cover exactly the sent amount. The share of the cost that belongs to the fee + sats leaves the ledger with them: Skuld books no gain and no loss for a fee. +- A `transfer_in` row is generated automatically in B and carries no fee (§7.4). ### 3.4 Income