Added "fraud_score" field to support PX12 database.

Author: ip2location

COPYING

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020 - 2024 IP2Location.com
+Copyright (c) 2020 - 2025 IP2Location.com
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

LICENSE.TXT

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020 - 2024 IP2Location.com
+Copyright (c) 2020 - 2025 IP2Location.com
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README

@@ -17,12 +17,12 @@ For more details, please visit:
     make
 
 ### Windows
-    Execute "vcvarsall.bat". (This file is part of Microsoft Visual C, not ip2location code) 
+    Execute "vcvarsall.bat". (This file is part of Microsoft Visual C, not ip2location code)
     nmake -f Makefile.win
 
 ### MacOS
     autoreconf -i -v --force
-    export CFLAGS=-I/usr/include/malloc 
+    export CFLAGS=-I/usr/include/malloc
     ./configure
     make
 
@@ -33,7 +33,7 @@ For more details, please visit:
 
 ## Sample BIN Databases
 
-* Download free IP2Proxy LITE databases at [https://lite.ip2location.com](https://lite.ip2location.com)  
+* Download free IP2Proxy LITE databases at [https://lite.ip2location.com](https://lite.ip2location.com)
 * Download IP2Proxy sample databases at [https://www.ip2location.com/ip2proxy/developers](https://www.ip2location.com/ip2proxy/developers)
 
 ## Methods
@@ -64,6 +64,7 @@ Below are the methods supported in this library.
 | IP2Proxy_get_last_seen                               | Return proxy last seen in days.                              |
 | IP2Proxy_get_threat                                  | Return security threat reported.                             |
 | IP2Proxy_get_provider                                | Return name of VPN provider if available.                    |
+| IP2Proxy_get_fraud_score                             | Return the potential risk score.                             |
 
 
 
@@ -73,14 +74,14 @@ Open and read IP2Proxy binary database. There are 3 modes:
 
 1. IP2Proxy_open("SAMPLE.BIN") - File I/O reading. Slower look, but low resource consuming.
 2. IP2Proxy_open_csv("SAMPLE.CSV") - CSV parsing. Slowest, but convenient to use.
-3. IP2Proxy_set_lookup_mode(IP2ProxyObj, IP2PROXY_SHARED_MEMORY) - Stores whole IP2Proxy database into system memory. Lookup is possible across all applications within the system.  Extremely resources 
-   consuming. Do not use this mode if your system do not have enough 
+3. IP2Proxy_set_lookup_mode(IP2ProxyObj, IP2PROXY_SHARED_MEMORY) - Stores whole IP2Proxy database into system memory. Lookup is possible across all applications within the system.  Extremely resources
+   consuming. Do not use this mode if your system do not have enough
    memory.
 4. IP2Proxy_set_lookup_mode(IP2ProxyObj, IP2PROXY_CACHE_MEMORY) - Caches database into memory for faster lookup. Required high memory.
 
 
 
 ## Support
 
-Email: [email protected].  
+Email: [email protected].
 URL: [https://www.ip2location.com](https://www.ip2location.com)

debian/changelog

@@ -1,5 +1,5 @@
-libip2proxy (4.1.2) jammy; urgency=medium
+libip2proxy (4.2.0) jammy; urgency=medium
 
   * Initial Release.
 
- -- IP2Location <[email protected]>  Mon, 24 Mar 2023 08:58:00 +0800
+ -- IP2Location <[email protected]>  Mon, 4 Feb 2025 13:58:32 +0800

debian/copyright

@@ -4,11 +4,11 @@ Upstream-Contact: IP2Location <[email protected]>
 Source: https://github.com/ip2location/ip2proxy-c.git
 
 Files: *
-Copyright: 2020 IP2Location <[email protected]>
+Copyright: 2025 IP2Location <[email protected]>
 License: MIT
 
 Files: debian/*
-Copyright: 2020 IP2Location <[email protected]>
+Copyright: 2025 IP2Location <[email protected]>
 License: MIT
 
 License: MIT

docs/source/code.md

@@ -53,4 +53,5 @@ Retrieve geolocation information for an IP address.
 | is_proxy         |     Determine whether if an IP address was a proxy or not. |
 | proxy_type       |     Type of proxy. |
 | provider         |     Name of VPN provider if available. |
+| fraud_score      |     Potential risk score (0 - 99) associated with IP address. |
 ```

docs/source/conf.py

@@ -6,7 +6,7 @@
 # -- Project information
 
 project = 'IP2Proxy C'
-copyright = '2024, IP2Location'
+copyright = '2025, IP2Location'
 author = 'IP2Location'
 
 release = '0.1.0'

docs/source/quickstart.md

@@ -26,8 +26,8 @@ This library can be compiled and installed in different platform. Please refer t
 ###  Debian
 
 ```bash
-curl -LO https://github.com/ip2location/ip2proxy-c/releases/download/4.1.2/ip2proxy-4.1.2.deb
-sudo dpkg -i ip2proxy-4.1.2.deb
+curl -LO https://github.com/ip2location/ip2proxy-c/releases/download/4.2.0/ip2proxy-4.2.0.deb
+sudo dpkg -i ip2proxy-4.2.0.deb
 ```
 
 
@@ -41,14 +41,14 @@ sudo apt install ip2proxy
 
 ### Windows
 ```bash
-    Execute "vcvarsall.bat". (This file is part of Microsoft Visual C, not ip2location code) 
+    Execute "vcvarsall.bat". (This file is part of Microsoft Visual C, not ip2location code)
     nmake -f Makefile.win
 ```
 
 ### MacOS
 ```bash
     autoreconf -i -v --force
-    export CFLAGS=-I/usr/include/malloc 
+    export CFLAGS=-I/usr/include/malloc
     ./configure
     make
 ```
@@ -64,7 +64,7 @@ You can query the geolocation information from the IP2Proxy BIN database as belo
 
 IP2Proxy *IP2ProxyObj = IP2Proxy_open("../data/SAMPLE.BIN");
 IP2ProxyRecord *record = IP2Proxy_get_all(IP2ProxyObj, "161.11.12.13");
-printf("%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n",
+printf("%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n",
 	record->country_short,
 	record->country_long,
 	record->region,
@@ -78,7 +78,8 @@ printf("%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n%s\n",
 	record->as_,
 	record->last_seen,
 	record->threat,
-	record->provider);
+	record->provider,
+	record->fraud_score);
 IP2Proxy_free_record(record);
 IP2Proxy_close(IP2ProxyObj);
 ```

ip2proxy.1

@@ -77,14 +77,15 @@ Query an IP address and display the country_short and city result
 	\- last_seen
 	\- threat
 	\- provider
-	
+    \- fraud_score
+
 \-n, \-\no-heading
     Suppress the heading display.
 
 .SH [AUTHORS]
 This tool was created by IP2Location (https://www.ip2location.com).
 
 .SH [COPYRIGHT AND LICENSE]
-Copyright 2001\-2024 IP2Location.com
+Copyright 2001\-2025 IP2Location.com
 
 This tool is licensed under MIT.

ip2proxy.c

@@ -76,6 +76,9 @@ static void print_usage(const char *argv0)
 "			provider\n"
 "			Name of VPN provider if available.\n"
 "\n"
+"			fraud_score\n"
+"			Potential risk score (0 - 99) associated with IP address.\n"
+"\n"
 "	-f, --format\n"
 "	Output format. Supported format:\n"
 "		- csv (default)\n"
@@ -103,7 +106,7 @@ static void print_usage(const char *argv0)
 
 static void print_version()
 {
-	printf("IP2Proxy version 4.1.2\n");
+	printf("IP2Proxy version 4.2.0\n");
 }
 
 static void print_footer(FILE *fout, const char *field, const char *format)
@@ -160,6 +163,7 @@ static void print_header(FILE *fout, const char *field, const char *format)
 		WRITE_HEADER("last_seen");
 		WRITE_HEADER("threat");
 		WRITE_HEADER("provider");
+		WRITE_HEADER("fraud_score");
 
 		if (*end == ',') {
 			start = end + 1;
@@ -186,7 +190,7 @@ static void print_record(FILE *fout, const char *field, IP2ProxyRecord *record,
 		if (strncmp(start, field_name, end - start) == 0) { \
 			const char *value = field; \
 			if (strcmp(value, NOT_SUPPORTED) == 0) { \
-				value = "N/A"; \
+				value = "NOT SUPPORTED"; \
 			} \
 			if (strcmp(format, "XML") == 0) { \
 				fprintf(fout, "<%s>%s</%s>", field_name, value, field_name); \
@@ -242,6 +246,7 @@ static void print_record(FILE *fout, const char *field, IP2ProxyRecord *record,
 		WRITE_FIELD("last_seen", record->last_seen);
 		WRITE_FIELD("threat", record->threat);
 		WRITE_FIELD("provider", record->provider);
+		WRITE_FIELD("fraud_score", record->fraud_score);
 
 		if (*end == ',') {
 			start = end + 1;
@@ -272,7 +277,7 @@ int main(int argc, char *argv[])
 	IP2ProxyRecord *record = NULL;
 	FILE *fout = stdout;
 
-	field = "ip,is_proxy,proxy_type,country_code,country_name,region_name,city_name,isp,domain,as_number,as_name,last_seen,threat,provider";
+	field = "ip,is_proxy,proxy_type,country_code,country_name,region_name,city_name,isp,domain,as_number,as_name,last_seen,threat,provider,fraud_score";
 
 	for (i = 1; i < argc; i++) {
 		const char *argvi = argv[i];