exchange

taler-exchange-helper-measure-tops-address-check (5837B)

---

 #!/bin/bash
 #
 #  This file is part of TALER
 #  Copyright (C) 2024, 2025 Taler Systems SA
 #
 #  TALER 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, or (at your option) any later version.
 #
 #  TALER 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
 #  TALER; see the file COPYING.  If not, If not, see <http://www.gnu.org/license>
 #
 
 # Hard error reporting on.
 set -eu
 
 # Exit, with error message (hard failure)
 function exit_fail() {
     echo " FAIL: " "$@" >&2
     EXIT_STATUS=1
     exit "$EXIT_STATUS"
 }
 
 CONF="$HOME/.config/taler-exchange.conf"
 VERBOSE=0
 
 while getopts 'ac:hirvV' OPTION;
 do
     case "$OPTION" in
         a)
             # Address data is required.
             echo "ADDRESS_LINES"
             echo "ADDRESS_COUNTRY"
             exit 0
             ;;
         c)
             # shellcheck disable=SC2034
             CONF="$OPTARG"
             ;;
         h)
             echo "This is a KYC measure program that sets up a measure to validate the address of the customer via Challenger."
             echo 'Supported options:'
             echo '  -a           -- show required attributes'
             # shellcheck disable=SC2016
             echo '  -c $CONF     -- set configuration'
             echo '  -h           -- print this help'
             echo '  -i           -- show required inputs'
             echo '  -r           -- show required context'
             echo '  -v           -- show version'
             echo '  -V           -- be verbose'
             exit 0
             ;;
         i)
             # Need context and current_rules.
             echo "attributes"
             echo "current_rules"
             exit 0
             ;;
         r)
             # Nothing needed from context
             exit 0
             ;;
         v)
             echo "$0 v0.0.2"
             exit 0
             ;;
         V)
             VERBOSE=1
             ;;
         ?)
         exit_fail "Unrecognized command line option"
         ;;
     esac
 done
 
 if [ 1 = "$VERBOSE" ]
 then
     echo "Running $0" 1>&2
 fi
 
 # See https://docs.taler.net/taler-kyc-manual.html#tsref-type-AmlProgramInput
 # for the full JSON with possible inputs.
 
 # First, extract inputs we need
 INPUTS=$(jq '{"current_rules":.current_rules,"attributes":.attributes}')
 
 # Get address data
 CUSTOMER_TYPE=$(echo "$INPUTS" | jq -r '.attributes.CUSTOMER_TYPE // null')
 case "$CUSTOMER_TYPE"
 in
     "NATURAL_PERSON")
         CONTACT_NAME=$(echo "$INPUTS" | jq -r '.attributes.FULL_NAME')
         ;;
     "LEGAL_ENTITY")
         BUSINESS_NAME=$(echo "$INPUTS" | jq -r '.attributes.COMPANY_NAME')
         CONTACT_PERSON=$(echo "$INPUTS" | jq -r '.attributes.CONTACT_PERSON_NAME // null')
         if [ "null" != "$CONTACT_PERSON" ]
         then
             CONTACT_NAME=$(echo -en "${BUSINESS_NAME}\nAttn. ${CONTACT_PERSON_NAME}")
         else
             CONTACT_NAME="$BUSINESS_NAME"
         fi
         ;;
     *)
         # Strange, we don't know. Let's try everything...
         CONTACT_NAME=$(echo "$INPUTS" | jq -r '.attributes.CONTACT_NAME // attributes.FULL_NAME // .attributes.COMPANY_NAME')
         ;;
 esac
 
 ADDRESS_LINES=$(echo "$INPUTS" | jq '.attributes.DOMICILE_ADDRESS')
 # We ONLY allow Swiss addresses
 ADDRESS_COUNTRY='"CH"'
 
 # Convert address data to Challenger format as best we can.
 ADDRESS=$(jq -n \
     --argjson contact_name \""$CONTACT_NAME"\" \
     --argjson address_lines "$ADDRESS_LINES" \
     --argjson address_country "$ADDRESS_COUNTRY" \
     '{"CONTACT_NAME":$contact_name,"ADDRESS_LINES":$address_lines,"ADDRESS_COUNTRY":$address_country,"read_only":true}')
 
 # Get current rules.
 CURRENT_RULES=$(echo "$INPUTS" | jq '.current_rules // null')
 # Get context values.
 EXPIRATION_TIME=$(echo "$INPUTS" | jq '.context.expiration_time // .current_rules.expiration_time // null')
 # Preserve successor measure.
 SUCCESSOR_MEASURE=$(echo "$INPUTS" | jq '.current_rules.successor_measure // null')
 CUSTOM_MEASURES=$(echo "$INPUTS" | jq '.context.custom_measures // null')
 
 # Define custom measure for address validation
 CUSTOM_AMEASURES=$(jq -n \
     --argjson address "$ADDRESS" \
     '{"custom-address-investigation":{"context":{"initial_address":$address},"check_name":"postal-registration","prog_name":"inform-investigate","operation_type":"DEPOSIT"}}')
 
 # Then trigger Challenger address check via oauth2, kyc-check-postal-registration
 NEW_RULES=$(echo "$CURRENT_RULES" | jq --argjson cm "$CUSTOM_MEASURES" '(.rules[] |= if (.measures[0]=="kyx" or .rule_name=="deposit-limit-zero" or .rule_name=="p2p-domestic-identification-requirement") then .measures=["custom-address-investigation"] else . end) | .custom_measures=$cm')
 
 # Replace all existing 'postal-registration' measures with 'custom-address-investigation'
 NEW_RULES=$(echo "$NEW_RULES" | jq --argjson cm "$CUSTOM_MEASURES" '(.rules[].measures[] |= if (. =="postal-registration") then "custom-address-investigation" else . end) | .custom_measures=$cm')
 
 # Finally, output the new rules.
 # See https://docs.taler.net/taler-kyc-manual.html#tsref-type-AmlOutcome
 # for the required output format.
 
 jq -n \
     --argjson et "$EXPIRATION_TIME" \
     --argjson sm "$SUCCESSOR_MEASURE" \
     --argjson nm '"custom-address-investigation"' \
     --argjson cm "$CUSTOM_MEASURES" \
     --argjson cma "$CUSTOM_AMEASURES" \
     --argjson nr "$NEW_RULES" \
     '{"new_measures":$nm,"new_rules":($nr+{"expiration_time":$et,"successor_measure":$sm,"custom_measures":({}+$nr.custom_measures+$cm+$cma)})}|del(..|nulls)'
 
 exit 0