From 878cbb86cef154dffcb98cfb92f69002fa5f820d Mon Sep 17 00:00:00 2001
From: woodser <13068859+woodser@users.noreply.github.com>
Date: Sun, 10 Aug 2025 18:34:20 -0400
Subject: [PATCH] support Tron (TRX)

---
 .../haveno/asset/TronAddressValidator.java    | 104 ++++++++++++++++++
 .../main/java/haveno/asset/coins/Tron.java    |  28 +++++
 .../META-INF/services/haveno.asset.Asset      |   1 +
 .../java/haveno/asset/coins/TronTest.java     |  45 ++++++++
 .../java/haveno/core/locale/CurrencyUtil.java |   1 +
 .../src/main/java/haveno/desktop/images.css   |   4 +
 .../src/main/resources/images/trx_logo.png    | Bin 0 -> 11557 bytes
 7 files changed, 183 insertions(+)
 create mode 100644 assets/src/main/java/haveno/asset/TronAddressValidator.java
 create mode 100644 assets/src/main/java/haveno/asset/coins/Tron.java
 create mode 100644 assets/src/test/java/haveno/asset/coins/TronTest.java
 create mode 100644 desktop/src/main/resources/images/trx_logo.png

diff --git a/assets/src/main/java/haveno/asset/TronAddressValidator.java b/assets/src/main/java/haveno/asset/TronAddressValidator.java
new file mode 100644
index 0000000000..6125975621
--- /dev/null
+++ b/assets/src/main/java/haveno/asset/TronAddressValidator.java
@@ -0,0 +1,104 @@
+/*
+ * This file is part of Haveno.
+ *
+ * Haveno is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or (at
+ * your option) any later version.
+ *
+ * Haveno 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 Affero General Public
+ * License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with Haveno. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package haveno.asset;
+
+import java.math.BigInteger;
+import java.security.MessageDigest;
+import java.util.Arrays;
+
+/**
+ * Validates a Tron address.
+ */
+public class TronAddressValidator implements AddressValidator {
+
+    private static final String BASE58_ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
+    private static final byte MAINNET_PREFIX = 0x41;
+
+    public TronAddressValidator() {
+    }
+
+    @Override
+    public AddressValidationResult validate(String address) {
+        if (!isValidTronAddress(address)) {
+            return AddressValidationResult.invalidStructure();
+        }
+        return AddressValidationResult.validAddress();
+    }
+
+    /**
+     * Checks if the given address is a valid Solana address.
+     * 
+     * This code is AI-generated and has been tested with a variety of addresses.
+     * 
+     * @param addr the address to validate
+     * @return true if the address is valid, false otherwise
+     */
+    private static boolean isValidTronAddress(String address) {
+        if (address == null || address.length() != 34) return false;
+
+        byte[] decoded = decodeBase58(address);
+        if (decoded == null || decoded.length != 25) return false; // 21 bytes data + 4 bytes checksum
+
+        // Check checksum
+        byte[] data = Arrays.copyOfRange(decoded, 0, 21);
+        byte[] checksum = Arrays.copyOfRange(decoded, 21, 25);
+        byte[] calculatedChecksum = Arrays.copyOfRange(doubleSHA256(data), 0, 4);
+
+        if (!Arrays.equals(checksum, calculatedChecksum)) return false;
+
+        // Check mainnet prefix
+        return data[0] == MAINNET_PREFIX;
+    }
+
+    private static byte[] decodeBase58(String input) {
+        BigInteger num = BigInteger.ZERO;
+        BigInteger base = BigInteger.valueOf(58);
+
+        for (char c : input.toCharArray()) {
+            int digit = BASE58_ALPHABET.indexOf(c);
+            if (digit < 0) return null;
+            num = num.multiply(base).add(BigInteger.valueOf(digit));
+        }
+
+        // Convert BigInteger to byte array
+        byte[] bytes = num.toByteArray();
+        if (bytes.length > 1 && bytes[0] == 0) {
+            bytes = Arrays.copyOfRange(bytes, 1, bytes.length);
+        }
+
+        // Add leading zero bytes for '1's
+        int leadingZeros = 0;
+        for (char c : input.toCharArray()) {
+            if (c == '1') leadingZeros++;
+            else break;
+        }
+
+        byte[] result = new byte[leadingZeros + bytes.length];
+        System.arraycopy(bytes, 0, result, leadingZeros, bytes.length);
+        return result;
+    }
+
+    private static byte[] doubleSHA256(byte[] data) {
+        try {
+            MessageDigest sha256 = MessageDigest.getInstance("SHA-256");
+            return sha256.digest(sha256.digest(data));
+        } catch (Exception e) {
+            throw new RuntimeException(e);
+        }
+    }
+}
diff --git a/assets/src/main/java/haveno/asset/coins/Tron.java b/assets/src/main/java/haveno/asset/coins/Tron.java
new file mode 100644
index 0000000000..d358834eeb
--- /dev/null
+++ b/assets/src/main/java/haveno/asset/coins/Tron.java
@@ -0,0 +1,28 @@
+/*
+ * This file is part of Haveno.
+ *
+ * Haveno is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or (at
+ * your option) any later version.
+ *
+ * Haveno 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 Affero General Public
+ * License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with Haveno. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package haveno.asset.coins;
+
+import haveno.asset.Coin;
+import haveno.asset.TronAddressValidator;
+
+public class Tron extends Coin {
+
+    public Tron() {
+        super("Tron", "TRX", new TronAddressValidator());
+    }
+}
diff --git a/assets/src/main/resources/META-INF/services/haveno.asset.Asset b/assets/src/main/resources/META-INF/services/haveno.asset.Asset
index 3125ac64aa..a42480de1d 100644
--- a/assets/src/main/resources/META-INF/services/haveno.asset.Asset
+++ b/assets/src/main/resources/META-INF/services/haveno.asset.Asset
@@ -10,6 +10,7 @@ haveno.asset.coins.Litecoin
 haveno.asset.coins.Monero
 haveno.asset.coins.Ripple
 haveno.asset.coins.Solana
+haveno.asset.coins.Tron
 haveno.asset.tokens.TetherUSDERC20
 haveno.asset.tokens.TetherUSDTRC20
 haveno.asset.tokens.USDCoinERC20
diff --git a/assets/src/test/java/haveno/asset/coins/TronTest.java b/assets/src/test/java/haveno/asset/coins/TronTest.java
new file mode 100644
index 0000000000..dd70d2edea
--- /dev/null
+++ b/assets/src/test/java/haveno/asset/coins/TronTest.java
@@ -0,0 +1,45 @@
+/*
+ * This file is part of Haveno.
+ *
+ * Haveno is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or (at
+ * your option) any later version.
+ *
+ * Haveno 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 Affero General Public
+ * License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with Haveno. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package haveno.asset.coins;
+
+import haveno.asset.AbstractAssetTest;
+import org.junit.jupiter.api.Test;
+
+public class TronTest extends AbstractAssetTest {
+
+    public TronTest() {
+        super(new Tron());
+    }
+
+    @Test
+    public void testValidAddresses() {
+        assertValidAddress("TRjE1H8dxypKM1NZRdysbs9wo7huR4bdNz");
+        assertValidAddress("THdUXD3mZqT5aMnPQMtBSJX9ANGjaeUwQK");
+        assertValidAddress("THUE6WTLaEGytFyuGJQUcKc3r245UKypoi");
+        assertValidAddress("TH7vVF9RTMXM9x7ZnPnbNcEph734hpu8cf");
+        assertValidAddress("TJNtFduS4oebw3jgGKCYmgSpTdyPieb6Ha");
+    }
+
+    @Test
+    public void testInvalidAddresses() {
+        assertInvalidAddress("TJRyWwFs9wTFGZg3L8nL62xwP9iK8QdK9R");
+        assertInvalidAddress("TJRyWwFs9wTFGZg3L8nL62xwP9iK8QdK9X");
+        assertInvalidAddress("1JRyWwFs9wTFGZg3L8nL62xwP9iK8QdK9R");
+        assertInvalidAddress("TGzz8gjYiYRqpfmDwnLxfgPuLVNmpCswVo");
+    }
+}
diff --git a/core/src/main/java/haveno/core/locale/CurrencyUtil.java b/core/src/main/java/haveno/core/locale/CurrencyUtil.java
index 8d329324fe..58e7ab422b 100644
--- a/core/src/main/java/haveno/core/locale/CurrencyUtil.java
+++ b/core/src/main/java/haveno/core/locale/CurrencyUtil.java
@@ -203,6 +203,7 @@ public class CurrencyUtil {
         result.add(new CryptoCurrency("XRP", "Ripple"));
         result.add(new CryptoCurrency("ADA", "Cardano"));
         result.add(new CryptoCurrency("SOL", "Solana"));
+        result.add(new CryptoCurrency("TRX", "Tron"));
         result.add(new CryptoCurrency("DAI-ERC20", "Dai Stablecoin"));
         result.add(new CryptoCurrency("USDT-ERC20", "Tether USD"));
         result.add(new CryptoCurrency("USDT-TRC20", "Tether USD"));
diff --git a/desktop/src/main/java/haveno/desktop/images.css b/desktop/src/main/java/haveno/desktop/images.css
index cc388612b3..70ca246cd6 100644
--- a/desktop/src/main/java/haveno/desktop/images.css
+++ b/desktop/src/main/java/haveno/desktop/images.css
@@ -365,6 +365,10 @@
     -fx-image: url("../../images/sol_logo.png");
 }
 
+#image-trx-logo {
+    -fx-image: url("../../images/trx_logo.png");
+}
+
 #image-dark-mode-toggle {
     -fx-image: url("../../images/dark_mode_toggle.png");   
 }
diff --git a/desktop/src/main/resources/images/trx_logo.png b/desktop/src/main/resources/images/trx_logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..bb2ab5742131b3e24023b11289189cd5be46edf7
GIT binary patch
literal 11557
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

literal 0
HcmV?d00001