docker-finance | modern accounting for the power-user

Dedicated to Michael Morgan: a beautiful, beautiful soul.

---

Internal signing keys:

  Aaron Fiore (sole author)

    - 518A22F85BEFD32BCC99C48603F90C4F35E0213E
    - 31ECA5C347A0CC0815EDE730A3EACCFCDA7E685E
    - C8187C585CB07A4DA81CC0F37318B50EBE9C0DA8

Internal repositories (rebased from):

  Staging:

    $ git log -n1 --pretty=format:"%H"
    c8e0cd66f6c89fa7b3c62f72fb524a4cc454b7b6

    $ git rev-list --max-parents=0 HEAD
    ac3863b8c234755855f1aea3a07a853122decdf2

  Private:

    $ git log -n1 --pretty=format:"%H"
    69bb3591eaa2990a9637832bb484690e00c4f926

    $ git rev-list --max-parents=0 HEAD
    a5c1cc9fb593c4cf09bc0adfef6cb6d2964511ae

container/src/hledger-flow/accounts/electrum/electrum-shared.bash

@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+
+# docker-finance | modern accounting for the power-user
+#
+# Copyright (C) 2021-2024 Aaron Fiore (Founder, Evergreen Crypto LLC)
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+#
+# "Libraries"
+#
+
+[ -z "$DOCKER_FINANCE_CONTAINER_REPO" ] && exit 1
+source "${DOCKER_FINANCE_CONTAINER_REPO}/src/hledger-flow/lib/lib_preprocess.bash" "$1" "$2"
+
+#
+# Implementation
+#
+
+[ -z "$global_year" ] && exit 1
+[ -z "$global_subaccount" ] && exit 1
+
+[ -z "$global_in_path" ] && exit 1
+[ -z "$global_out_path" ] && exit 1
+
+function parse()
+{
+  lib_preprocess::assert_header "transaction_hash,label,confirmations,value,fiat_value,fee,fiat_fee,timestamp"
+
+  gawk -v global_year="$global_year" -v global_subaccount="$global_subaccount" \
+    '{
+       if (NR<2 || $8 !~ global_year)
+         next
+
+       printf $1 OFS                   # transaction_hash
+       printf $2 OFS                   # label
+       printf $3 OFS                   # confirmations
+
+       # value (without fee)
+       direction=($4 ~ /^-/ ? "OUT" : "IN"); sub(/^-/, "", $4)
+       value=$4-$6  # Remove fee
+       printf("%.8f", value); printf OFS
+
+       sub(/^-/, "", $5)
+       printf("%.8f", $5); printf OFS  # fiat_value
+
+       printf("%.8f", $6); printf OFS  # fee
+       printf("%.8f", $7); printf OFS  # fiat_fee
+
+       # timestamp
+       sub(/ /, "T", $8)  # HACK: makes arg-friendly by removing space
+       cmd = "date \"+%F %T %z\" --date="$8 | getline date
+       printf date OFS
+
+       printf direction OFS
+       printf global_subaccount
+
+       printf "\n"
+
+    }' FS=, OFS=, "$global_in_path" >"$global_out_path"
+}
+
+function main()
+{
+  parse
+}
+
+main "$@"
+
+# vim: sw=2 sts=2 si ai et

container/src/hledger-flow/accounts/electrum/electrum-shared.rules

@@ -0,0 +1,81 @@
+# docker-finance | modern accounting for the power-user
+#
+# Copyright (C) 2021-2024 Aaron Fiore (Founder, Evergreen Crypto LLC)
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+fields txid,label,confirmations,value_without_fee,fiat_value,fee,fiat_fee,timestamp,direction,subaccount
+
+# Electrum exports to localtime
+date-format %Y-%m-%d %H:%M:%S %z
+date %timestamp
+
+description %timestamp
+
+# Treat the Electrum 'label' field as notes
+comment txid:%txid, notes:%label, direction:%direction
+
+account1 assets:electrum:%subaccount:BTC
+amount %value_without_fee BTC
+
+if %direction ^OUT$
+  amount -%value_without_fee BTC
+
+#
+# Set account based 'label' keywords
+#
+
+# IN
+
+if %direction ^IN$
+  account2 equity:electrum:%subaccount:withdrawal:BTC
+
+if %direction ^IN$
+& %label (Income|Payment)
+  account2 income:electrum:%subaccount:BTC
+
+if %direction ^IN$
+& %label Gift
+  account2 income:electrum:%subaccount:gifts:BTC
+  comment2 %timestamp,GIFTIN,electrum,BTC,%value_without_fee,USD,%fiat_value,Unknown
+
+# OUT
+
+if %direction ^OUT$
+  account2 expenses:electrum:%subaccount:BTC
+  comment2 %timestamp,SPEND,electrum,BTC,%value_without_fee,USD,,
+
+if %direction ^OUT$
+& %label (Self|Equity transfer|Capital contribution)
+  account2 equity:electrum:%subaccount:deposit:BTC
+  comment2
+# NOTE: custom rule equity transfers should also clear comment2
+
+if %direction ^OUT$
+& %label Gift
+  account2 expenses:electrum:%subaccount:gifts:BTC
+  comment2 %timestamp,GIFT,electrum,BTC,%value_without_fee,USD,%fiat_value,Unknown
+
+# Fees
+if %direction ^OUT$
+& %fee [1-9]
+  account3 assets:electrum:%subaccount:BTC
+  amount3 -%fee BTC
+  account4 expenses:electrum:%subaccount:fees:BTC
+  amount4 %fee BTC
+  comment txid:%txid, notes:%label, taxed_as:SPEND
+  comment3 %timestamp,SPEND,electrum,BTC,%fee,USD,%fiat_fee,FEE
+# comment3 so account2 SPEND isn't overwritten, when applicable
+
+# vim: sw=2 sts=2 si ai et

container/src/hledger-flow/accounts/electrum/template/electrum-shared.bash

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+
+# docker-finance | modern accounting for the power-user
+#
+# Copyright (C) 2021-2024 Aaron Fiore (Founder, Evergreen Crypto LLC)
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+[ -z "$DOCKER_FINANCE_CONTAINER_REPO" ] && exit 1
+source "${DOCKER_FINANCE_CONTAINER_REPO}/src/hledger-flow/accounts/electrum/electrum-shared.bash"
+
+# vim: sw=2 sts=2 si ai et

container/src/hledger-flow/accounts/electrum/template/electrum-shared.rules

@@ -0,0 +1,20 @@
+# docker-finance | modern accounting for the power-user
+#
+# Copyright (C) 2021-2024 Aaron Fiore (Founder, Evergreen Crypto LLC)
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+include ../../../../../src/accounts/electrum/electrum-shared.rules
+
+# vim: sw=2 sts=2 si ai et

container/src/hledger-flow/accounts/electrum/template/electrum/wallet-1/1-in/mockup/2021/electrum-history.csv

@@ -0,0 +1,5 @@
+transaction_hash,label,confirmations,value,fiat_value,fee,fiat_fee,timestamp
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX0,Equity transfer (gemini:exchange),54321,2.34567890,108651.03,,,2022-01-01 01:01:01
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX1,Spending (Foo Bar LLC),43210,-1.2345678,-480044.02,0.00006789,2.63,2022-02-02 02:02:02
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX2,Equity transfer (coinbase:platform),4321,-0.98765432,-43437.73,0.00004567,2.01,2022-03-03 03:03:03
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX3,Income (Alice),321,0.78912345,36642.60,,,2022-04-04 04:04:04

container/src/hledger-flow/accounts/electrum/template/electrum/wallet-1/1-in/mockup/2022/electrum-history.csv

@@ -0,0 +1,5 @@
+transaction_hash,label,confirmations,value,fiat_value,fee,fiat_fee,timestamp
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX0,Equity transfer (gemini:exchange),54321,2.34567890,108651.03,,,2022-01-01 01:01:01
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX1,Spending (Foo Bar LLC),43210,-1.2345678,-480044.02,0.00006789,2.63,2022-02-02 02:02:02
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX2,Equity transfer (coinbase:platform),4321,-0.98765432,-43437.73,0.00004567,2.01,2022-03-03 03:03:03
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX3,Income (Alice),321,0.78912345,36642.60,,,2022-04-04 04:04:04

container/src/hledger-flow/accounts/electrum/template/electrum/wallet-1/1-in/mockup/2023/electrum-history.csv

@@ -0,0 +1,5 @@
+transaction_hash,label,confirmations,value,fiat_value,fee,fiat_fee,timestamp
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX0,Equity transfer (gemini:exchange),54321,2.34567890,108651.03,,,2022-01-01 01:01:01
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX1,Spending (Foo Bar LLC),43210,-1.2345678,-480044.02,0.00006789,2.63,2022-02-02 02:02:02
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX2,Equity transfer (coinbase:platform),4321,-0.98765432,-43437.73,0.00004567,2.01,2022-03-03 03:03:03
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX3,Income (Alice),321,0.78912345,36642.60,,,2022-04-04 04:04:04

container/src/hledger-flow/accounts/electrum/template/electrum/wallet-1/electrum-wallet-1.rules

@@ -0,0 +1,20 @@
+# docker-finance | modern accounting for the power-user
+#
+# Copyright (C) 2021-2024 Aaron Fiore (Founder, Evergreen Crypto LLC)
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+include ../../electrum-shared.rules
+
+# vim: sw=2 sts=2 si ai et

container/src/hledger-flow/accounts/electrum/template/electrum/wallet-1/preprocess

@@ -0,0 +1 @@
+../../electrum-shared.bash

container/src/hledger-flow/accounts/electrum/template/electrum/wallet-2/1-in/mockup/2021/electrum-history.csv

@@ -0,0 +1,5 @@
+transaction_hash,label,confirmations,value,fiat_value,fee,fiat_fee,timestamp
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX4,Equity transfer (coinbase:platform),12345,1.23456789,20420.60,,,2023-01-01 01:01:01
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX5,Spending (ABC Inc.),11234,-0.1234567,-2929.03,0.00005678,1.34,2023-02-02 02:02:02
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX6,Equity transfer (gemini:exchange),1234,-0.89012345,-20886.15,0.00003456,0.81,2023-03-03 03:03:03
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX7,Income (Bob),123,0.78912345,21949.80,,,2023-04-04 04:04:04

container/src/hledger-flow/accounts/electrum/template/electrum/wallet-2/1-in/mockup/2022/electrum-history.csv

@@ -0,0 +1,5 @@
+transaction_hash,label,confirmations,value,fiat_value,fee,fiat_fee,timestamp
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX4,Equity transfer (coinbase:platform),12345,1.23456789,20420.60,,,2023-01-01 01:01:01
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX5,Spending (ABC Inc.),11234,-0.1234567,-2929.03,0.00005678,1.34,2023-02-02 02:02:02
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX6,Equity transfer (gemini:exchange),1234,-0.89012345,-20886.15,0.00003456,0.81,2023-03-03 03:03:03
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX7,Income (Bob),123,0.78912345,21949.80,,,2023-04-04 04:04:04

container/src/hledger-flow/accounts/electrum/template/electrum/wallet-2/1-in/mockup/2023/electrum-history.csv

@@ -0,0 +1,5 @@
+transaction_hash,label,confirmations,value,fiat_value,fee,fiat_fee,timestamp
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX4,Equity transfer (coinbase:platform),12345,1.23456789,20420.60,,,2023-01-01 01:01:01
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX5,Spending (ABC Inc.),11234,-0.1234567,-2929.03,0.00005678,1.34,2023-02-02 02:02:02
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX6,Equity transfer (gemini:exchange),1234,-0.89012345,-20886.15,0.00003456,0.81,2023-03-03 03:03:03
+XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX7,Income (Bob),123,0.78912345,21949.80,,,2023-04-04 04:04:04

container/src/hledger-flow/accounts/electrum/template/electrum/wallet-2/electrum-wallet-2.rules

@@ -0,0 +1,20 @@
+# docker-finance | modern accounting for the power-user
+#
+# Copyright (C) 2021-2024 Aaron Fiore (Founder, Evergreen Crypto LLC)
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+include ../../electrum-shared.rules
+
+# vim: sw=2 sts=2 si ai et

container/src/hledger-flow/accounts/electrum/template/electrum/wallet-2/preprocess

@@ -0,0 +1 @@
+../../electrum-shared.bash