72-wonderphi-ledger
Asset valuation: $3,600,000,000. 25 batch recipes for banking, finance, and accounting operations. Emit WonderPhi Compute plans; run across every CPU You have 500 contractors to send 1099-NEC forms to. You don't script a mail merge. You run:
Imagine the week five hundred contractor 1099-NEC forms come due. Nobody writes a mail merge or uploads a spreadsheet of names and taxpayer numbers to a form service. Someone points one Python script at a folder of JSON records, sets the tax year, and the script writes a plain-text plan. WonderPhi Compute reads that plan and renders every form, spreading the work across every available CPU core, until the output folder is full. That is the whole shape of WonderPhi Ledger.
It is a companion library to WonderPhi Compute: twenty-five batch recipes across eleven categories of banking, finance and accounting work. They cover cleaning and de-duplicating CSV exports, rendering invoices, statements, receipts, collection letters and wire instructions, OCR on receipt images, validating NACHA files record by record, screening every row against a local sanctions list, converting currencies from a rate table, categorising transactions by rule, building depreciation and amortisation schedules, and sealing a period's files into a timestamped audit trail. The generator uses only the Python standard library and never touches the compute engine. Nothing in it connects to a bank, opens a socket, or phones home. It reads a folder and writes a text file.
It is for the operations team that would rather own its batch than rent it: a perpetual release with no subscription, no telemetry and no forced updates, licensed to a single operator or organisation-wide across unlimited machines, VMs, containers and cloud instances. The buyer walks away with the recipe library and the plan format; the invention stays patent pending under Christopher Gabriel Brown.
Description
WonderPhi Ledger v1.0.0 — Batch Recipe Library for Banking, Finance & Accounting (SKU 2103)
Inventor: Christopher Gabriel Brown
Status: Patent pending — see the inventor’s patent portfolio for the full schedule of filings. All rights to seek additional patent protection are expressly reserved.
Version: 1.0.0 (perpetual release — no subscription, no renewal, no telemetry, no forced updates)
SKU: 2103
Licence variants: Retail Single-User (personal / single-operator) & Industrial Commercial (organisation-wide, unlimited machines / VMs / containers / cloud instances)
Overview
WonderPhi Ledger is a companion library to WonderPhi Compute . It contains 25 batch recipes that cover CSV reconciliation, PDF form generation, tax-form rendering, OCR extraction, ACH/NACHA validation, OFAC sanctions screening, FX conversion, categorisation, regulatory archival, and financial-schedule computation.
The library writes a plain-text WonderPhi Compute plan ( .plan.wpc.txt ); WonderPhi Compute runs that plan — dispatching every task across every available CPU core. Nothing in this library connects to a bank, opens a socket, or phones home. It reads a folder and writes a .txt . That is all.
Zero external Python dependencies. The generator uses the Python standard library only ( argparse , csv , json , hashlib , fnmatch , sys , pathlib , datetime , re ). Recipes drive well-known external tools — wkhtmltopdf , tesseract , LibreOffice soffice , certutil , and 7z — but never modify wpc.exe . The 10 Commandments stay intact.
Recipe Categories & Full Recipe Table
25 recipes across 11 categories. Every recipe uses the files input model — scan a folder for matching extensions.
Recipe Category Needs on PATH What It Does
CSV Normalisation & Cleanup (6 recipes)
csv-dedupe csv Python (stdlib) Remove duplicate rows keyed on (Date, Amount, Description)
csv-sort-date csv Python (stdlib) Sort each CSV ascending by the Date column
csv-total csv Python (stdlib) Sum the Amount column of each CSV — fast trial totals
csv-row-hash csv Python (stdlib) Content-addressable SHA-256 hash over each CSV’s data rows
csv-to-xlsx csv LibreOffice ( soffice ) Convert each CSV to XLSX via LibreOffice headless mode
csv-to-json csv Python (stdlib) Convert each CSV to a JSON array of per-row objects
Compliance / OFAC Sanctions Screening (1 recipe)
ofac-scan-csv compliance Python (stdlib) + SDN list via --tag Match every row in each CSV against a local SDN name list; emit hits
PDF Generation (6 recipes)
pdf-invoice-from-json pdf wkhtmltopdf + Python Render one invoice PDF per JSON record (invoice_id, bill_to, amount, due)
pdf-statement pdf wkhtmltopdf Render a monthly account-statement PDF per JSON record
pdf-receipt pdf wkhtmltopdf Render a purchase-receipt PDF per JSON record
pdf-payment-reminder pdf wkhtmltopdf Render a payment-reminder letter PDF per overdue-account JSON
pdf-collection-letter pdf wkhtmltopdf Render a formal collection-letter PDF per delinquent-account JSON
pdf-wire-instructions pdf wkhtmltopdf Render bank wire-transfer instructions PDF per beneficiary JSON
Tax Forms (2 recipes)
pdf-1099-nec tax wkhtmltopdf + Python Render a 1099-NEC PDF per contractor JSON — set --tag=year (fields: name, TIN, Box 1 Nonemployee Compensation)
pdf-w2 tax wkhtmltopdf + Python Render a W-2 PDF per employee JSON — set --tag=year (fields: name, SSN, wages, federal withholding)
OCR — Optical Character Recognition (2 recipes)
ocr-receipt-each ocr Tesseract OCR each receipt image to text (English language model)
ocr-invoice-each ocr Tesseract OCR each invoice/statement image to text with layout preservation (PSM 6)
ACH / NACHA Payment Files (2 recipes)
ach-nacha-validate ach Python (stdlib) Validate each NACHA/ACH file — 94-character record length, record-type sequence, block count
ach-nacha-summary ach Python (stdlib) Emit per-file summary: batches, entries, total debit, total credit
Reconciliation (1 recipe)
csv-reconcile-2way reconcile Python (stdlib) Find rows in each CSV not matched (by Amount) in a reference file specified via --tag
Currency / Foreign-Exchange Conversion (1 recipe)
csv-fx-convert fx Python (stdlib) + rates.csv via --tag Apply FX rate table (CSV of currency, rate) to the Amount column; produce AmountUSD
Rules-Based Categorisation (1 recipe)
csv-categorize-rules rules Python (stdlib) + rules.json via --tag Apply regex categorisation rules (JSON array of {match, category}) to the Description column
Tamper-Evident Regulatory Archival (1 recipe)
regulatory-hash archival certutil (built-in on Windows) SHA-256 hash each file with an audit-trail sidecar; consolidate into a timestamped AUDIT-TRAIL-{tag}.txt
Financial Schedules (2 recipes)
depreciation-schedule schedule Python (stdlib) Straight-line depreciation schedule per asset JSON (fields: cost, life_years) — outputs Year, BeginningBook, Depreciation, EndingBook
amortization-schedule schedule Python (stdlib) Loan amortisation schedule per loan JSON (fields: principal, apr, months) — outputs Month, Payment, Interest, Principal, Balance
Flag Meaning
--tag VALUE Value substituted for {tag} in commands — tax year, reference-file path, rates.csv path, SDN list path, period label, etc.
Input Type Glob Patterns Used By
CSV *.csv csv-dedupe, csv-sort-date, csv-total, csv-row-hash, csv-to-xlsx, csv-to-json, ofac-scan-csv, csv-reconcile-2way, csv-fx-convert, csv-categorize-rules
JSON *.json pdf-invoice-from-json, pdf-1099-nec, pdf-w2, pdf-statement, pdf-receipt, pdf-payment-reminder, pdf-collection-letter, pdf-wire-instructions, depreciation-schedule, amortization-schedule
Image / Receipt *.jpg , *.jpeg , *.png , *.pdf , *.tif , *.tiff , *.webp ocr-receipt-each, ocr-invoice-each
NACHA / ACH *.ach , *.nacha , *.txt ach-nacha-validate, ach-nacha-summary
Tool Purpose Recipes
Python 3.8+ (stdlib only) CSV parsing, JSON parsing, SHA-256 hashing, deduplication, sorting, reconciliation, FX conversion, categorisation, NACHA validation, depreciation & amortisation calculations csv-dedupe, csv-sort-date, csv-total, csv-row-hash, csv-to-json, ofac-scan-csv, csv-reconcile-2way, csv-fx-convert, csv-categorize-rules, ach-nacha-validate, ach-nacha-summary, depreciation-schedule, amortization-schedule, pdf-invoice-from-json, pdf-1099-nec, pdf-w2
wkhtmltopdf HTML-to-PDF rendering for invoices, statements, receipts, letters, forms, and wire instructions pdf-invoice-from-json, pdf-1099-nec, pdf-w2, pdf-statement, pdf-receipt, pdf-payment-reminder, pdf-collection-letter, pdf-wire-instructions
Tesseract OCR Optical character recognition (English) with standard and PSM 6 layout modes ocr-receipt-each, ocr-invoice-each
LibreOffice ( soffice ) Headless CSV-to-XLSX conversion csv-to-xlsx
certutil (Windows built-in) SHA-256 file hashing for tamper-evident regulatory archival regulatory-hash
7-Zip ( 7z ) Archive compression (referenced in documentation) Archival workflows
Plan-File Format
Every recipe emits a plan file beginning with the header # WPC v1 , followed by metadata comments ( recipe , desc , model , tag , tasks ) and one command line per input file. Plans that include a post-processing step (e.g. regulatory-hash ) insert a # --- barrier --- marker before the consolidation command. The plan is a pure text file — human-readable, auditable, and versionable — and is executed by wpc.exe .
Architectural Principles
- Library writes the plan; WonderPhi Compute runs the plan. Separation of generation and execution.
- No network. No telemetry. Nothing phones home. Nothing connects to a bank or external API.
- Never modifies wpc.exe . The constitutional 10 Commandments of WonderPhi Compute remain intact.
- Zero external Python dependencies. Standard library only — csv , json , hashlib , argparse , fnmatch , sys , pathlib , datetime , re .
- Self-contained one-liner templates. Each recipe’s command template is a standalone python -c one-liner or direct tool invocation, suitable for cmd.exe dispatch.
- Constitutional warranty. Every copy of WonderPhi Compute is governed by the 10 Commandments recorded in commandments.py . Any binary that fails the constitutional checksum at startup refuses to run.
Example Workflows
# Reconcile a bank export against the internal ledger python wpl-recipe.py csv-reconcile-2way .\bank_exports --tag .\internal_ledger.csv
# Apply FX rates to a folder of foreign-currency transactions python wpl-recipe.py csv-fx-convert .\eu_txns --tag rates.csv
# Generate 1099-NEC PDFs for 500 contractors python wpl-recipe.py pdf-1099-nec .\contractors --tag 2026
# OFAC-screen a customer CSV against a local SDN name list python wpl-recipe.py ofac-scan-csv .\customers --tag ofac_sdn.txt
# Compute straight-line depreciation schedules for a folder of asset JSONs python wpl-recipe.py depreciation-schedule .\assets
# Batch OCR paper receipts to text python wpl-recipe.py ocr-receipt-each .\receipts
# Validate a folder of NACHA files (94-char record length, sequence) python wpl-recipe.py ach-nacha-validate .\ach_pending
# Regulatory tamper-evident archive of a period’s records python wpl-recipe.py regulatory-hash .\q3_2026_records --tag 2026Q3
Depreciation & Amortisation Formulas
Schedule Method Formula Input JSON Fields Output CSV Columns
Depreciation Straight-line Annual = Cost ÷ Life_Years; EndingBook y = Cost − (y × Annual) cost , life_years (default 5) Year, BeginningBook, Depreciation, EndingBook
Amortisation Standard loan amortisation PMT = P × r × (1+r) n ÷ ((1+r) n − 1), where r = APR ÷ 12 ÷ 100 principal , apr , months Month, Payment, Interest, Principal, Balance
System Requirements
Requirement Detail
Licence Variant Scope Key Terms
Retail Single-User One individual — any and all machines personally owned or administered Perpetual, non-exclusive, non-transferable. No seat count, no activation, no telemetry. Source code may be read, studied, and modified for personal use. No redistribution; no SaaS / hosted use.
Industrial (Commercial) One organisation (legal entity on purchase receipt + wholly-owned subsidiaries) — unlimited machines, VMs, containers, cloud instances Perpetual, non-exclusive, non-transferable. Employees, contractors, and consultants may operate for the organisation’s benefit. Production and revenue-generating workloads permitted. No redistribution; no resale or white-label embedding (OEM licence available separately).
Both variants: governed by the laws of the State of Georgia, USA. Disputes resolved in state or federal courts in Gwinnett County, Georgia.
What Is in the Package
File Size Lines Description
wpl-recipe.py 18,540 bytes 375 The recipe generator — 25 recipes, CLI, plan emitter. Python 3.8+, stdlib only. Contains all command templates, file-scanning logic, and plan-file writer.
README.md 4,082 bytes 127 Full documentation: overview, recipe list, usage examples, CLI options, directory layout, system requirements.
INDEX.md 2,776 bytes 40 Recipe index table: all 25 recipes with category, input model, PATH dependencies, and descriptions.
LICENSE 4,919 bytes 127 WonderPhi Software Licence v1.0.0 — Retail Single-User. 9 sections covering grant, restrictions, IP, warranty, liability, termination, governing law.
LICENSE-INDUSTRIAL.txt 6,163 bytes 147 WonderPhi Software Licence v1.0.0 — Industrial (Commercial). Organisation-wide grant with OEM restriction.
release/wonderphi-ledger-v1.0.0.zip 9,719 bytes — Release archive.
Total package: 7 files · 48,112 bytes · 25 recipes · 11 categories · 0 external Python dependencies
How this is delivered
This package ships on a single Blu-ray disc, posted to the delivery address on your order. The archive on the disc is AES-256 encrypted; the passphrase is sent separately, by email, once the disc is despatched — so the disc alone is of no use to anyone who intercepts it.
Discs are despatched by tracked, signed-for post. Allow 5 business days for mastering and verification before despatch.
© 2026 Christopher Gabriel Brown. All rights reserved.
Photo
Footnotes
- Product number 8522.
- Family: wonderphi.
- Purchase: When you buy, you buy the use of that blueprint only.