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/ledger/ledger-shared.rules

@@ -0,0 +1,139 @@
+# 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 date,currency_,type,amount_,fees,txid,account_name,xpub,counter_symbol,countervalue_at_op,countervalue_at_export,direction
+
+date-format %Y-%m-%d %H:%M:%S
+description %date +0000
+
+account1 assets:ledger:%account_name:%currency_
+amount %amount_ %currency_
+
+comment type:%type, xpub:%xpub, txid:%txid, direction:%direction
+
+if %type ^OUT$
+  amount -%amount_ %currency_
+
+# Default equity (use custom rules for expenses)
+if %type ^IN$
+  account2 equity:ledger:%account_name:withdrawal:%currency_
+
+if %type ^OUT$
+  account2 equity:ledger:%account_name:deposit:%currency_
+
+if %type ^OUT$
+& %fees [1-9]
+  account3 assets:ledger:%account_name:%currency_
+  amount3 -%fees %currency_
+  account4 expenses:ledger:fees:%account_name:%currency_
+  amount4 %fees %currency_
+  comment type:%type, xpub:%xpub, txid:%txid, direction:%direction, taxed_as:SPEND
+  comment2
+  comment3 %date +0000,SPEND,ledger,%currency_,%fees,USD,,FEE
+# NOTE: comment3 apparently doesn't work (without comment2?) so use comment2 here.
+# NOTE: MAKE SURE TO USE comment3 FOR FEES IF YOU USE CUSTOM RULES!
+
+# Custom blockchain explorers are used for the following:
+
+#
+# NOTE: Most blockchains should work out-of-the-box (BTC, LTC, DASH, etc.) but
+#  the following must use the fetch impl or require custom rules (e.g., Cardano)
+#
+# TODO: support more blockchains as needed
+
+#
+# Algorand
+#
+
+if %currency_ ^ALGO$
+  skip
+
+#
+# Cardano
+#
+
+# TODO: Cardano fetch impl, then remove delegating/undelegating below
+#if %currency_ ^ADA$
+#  skip
+
+# Will be delegate-key amount, not pledged amount
+if %currency_ ^ADA$
+& %type ^DELEGATE$
+  amount -%amount_ %currency_
+  account2 equity:ledger:%account_name:deposit:stake_key_reg:%currency_
+  comment2 Stake key registration deposit
+
+if %currency_ ^ADA$
+& %type ^DELEGATE$
+& %fees [1-9]
+  account3 assets:ledger:%account_name:%currency_
+  amount3 -%fees %currency_
+  account4 expenses:ledger:fees:%account_name:%currency_
+  amount4 %fees %currency_
+  comment type:%type, xpub:%xpub, txid:%txid, direction:%direction, taxed_as:SPEND
+  comment3 %date +0000,SPEND,ledger,%currency_,%fees,USD,,FEE
+
+# Will be delegate-key amount, not pledged amount
+if %currency_ ^ADA$
+& %type ^UNDELEGATE$
+  amount 2 %currency_
+  amount2 -2 %currency_
+  account2 equity:ledger:%account_name:withdrawal:stake_key_reg:%currency_
+  account3 assets:ledger:%account_name:%currency_
+  amount3 -%amount_ %currency_
+  account4 expenses:ledger:fees:%account_name:%currency_
+  amount4 %amount_ %currency_
+  comment type:%type, xpub:%xpub, txid:%txid, direction:%direction, taxed_as:SPEND
+  comment2 Stake key registration withdrawal
+  comment3 %date +0000,SPEND,ledger,%currency_,%amount_,USD,,FEE
+
+#
+# Ethereum
+#
+
+if %currency_ ^ETH$
+  skip
+
+# Stablecoins
+if %currency_ (^DAI$|^USDC$|^USDT$|^GUSD$)
+  skip
+
+# ERC-20 TODO: expand as needed
+if %currency_ (^AAVE$|^SNX$|^NEXO$)
+  skip
+
+# Wrapped (ERC-20) TODO: expand as needed
+if %currency_ (^WETH$|^WBTC$)
+  skip
+
+# Aave aTokens TODO: expand as needed
+if %currency_ (^stkAAVE$|^aWETH$|^aSNX$|^aGUSD$)
+  skip
+
+# Compound cTokens TODO: expand as needed
+if %currency_ (^cETH$)
+  skip
+
+#
+# Tezos
+#
+
+# TODO: expand as needed
+if %currency_ ^XTZ$
+  skip
+
+# vim: sw=2 sts=2 si ai et