docs: point all ladder entrypoints at modular amount ladder

Drop remaining check_goa_ladder / old-shim wording. Document ladder/
modules, goa-ladder as phase alias only, and max-ladder as wd+pay
max-search. Update admin-log goa-withdraw-ladder comments to prefer
taler-monitoring.sh ladder|max-ladder.
This commit is contained in:
Hernâni Marques 2026-07-19 14:27:14 +02:00
parent 4d606a6887
commit 0101ecb10d
No known key found for this signature in database
5 changed files with 30 additions and 22 deletions

View file

@ -1,31 +1,31 @@
#!/usr/bin/env bash
# check_amount_ladder.sh — generic withdraw/pay amount ladder (any Taler currency)
#
# Currency-agnostic bank landing ladder for GOA, TESTPAYSAN, KUDOS, …
# (formerly check_goa_ladder.sh; use phase ladder / max-ladder / goa-ladder).
# Orchestrator for the modular amount ladder:
# Phase A withdraw — this file (classic plan or max-search)
# Phase B pay — ladder/lib_pay.sh (classic list or max payable)
# Force-select — ladder/extract_rpubs.py
# See ladder/README.md.
#
# Flow (bank landings):
# 1) GET /intro/auto-account.json → personal *account-* (balance 0)
# 2) Mint pool withdrawals as explorer + confirm when selected
# 3) wallet-cli accept-uri only (no run-until-done)
# 4) bank confirm when selected; settle = balance + transfer_done
# 5) pay via free-amount template (GOA: goa-free) or private orders
#
# Modes (LADDER_MODE):
# classic — random strictly increasing rungs + pins 0, max-1, max (default 23)
# classic — default 23-rung withdraw + matching pay plan (pins 0, max-1, max)
# max — max-search: highest withdrawable AND highest payable
# (pay never exceeds wallet available; GOA uses public free-amount
# template goa-free by default)
#
# Phase A: withdraw. Phase B: pay (classic plan list, or max-search pay).
#
# Stacks auto-tune via bank /config max_wire + exchange min denom when possible.
#
# Usage:
# ./taler-monitoring.sh ladder
# ./taler-monitoring.sh max-ladder # LADDER_MODE=max (wd + pay hunt)
# ./taler-monitoring.sh ladder # classic
# ./taler-monitoring.sh max-ladder # LADDER_MODE=max
# ./taler-monitoring.sh goa-ladder # alias of ladder (phase name only)
# ./taler-monitoring.sh -d stage.lefrancpaysan.ch ladder
# LADDER_MODE=max LADDER_MAX_PROBES=32 ./taler-monitoring.sh ladder
# LADDER_MAX_AMOUNT=100 LADDER_STEPS=7 ./taler-monitoring.sh -d stage.lefrancpaysan.ch ladder
#
# Env: LADDER_MODE, LADDER_STEPS, LADDER_MAX_AMOUNT, LADDER_MIN_AMOUNT,
# LADDER_MAX_PROBES, LADDER_MAX_TOL_REL, LADDER_HIGH_RUNGS, LADDER_STACK_AUTO,