From 6b957d21159da507677e862789240bec7d9e2f42 Mon Sep 17 00:00:00 2001
From: Artur Kowalski <arturkowalski.90@gmail.com>
Date: Wed, 9 May 2018 12:53:32 +0200
Subject: [PATCH] prepare futurocoin

---
 .../batm/server/extensions/ICurrencies.java   |   1 +
 .../FuturocoinAddressValidator.java           |  34 +++++
 .../extra/futurocoin/FuturocoinExtension.java | 133 ++++++++++++++++++
 .../sources/FixPriceRateSource.java           |  50 +++++++
 .../futurocoin/sources/yobit/IYobitAPI.java   |  18 +++
 .../sources/yobit/YobitRateSource.java        |  49 +++++++
 .../futurocoin/sources/yobit/dto/Ticker.java  |  87 ++++++++++++
 .../sources/yobit/dto/YobitResponse.java      |  13 ++
 .../futurocoind/FuturocoinRPCWallet.java      | 100 +++++++++++++
 .../src/main/resources/fto.png                | Bin 0 -> 22187 bytes
 10 files changed, 485 insertions(+)
 create mode 100644 server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/FuturocoinAddressValidator.java
 create mode 100644 server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/FuturocoinExtension.java
 create mode 100644 server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/FixPriceRateSource.java
 create mode 100644 server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/yobit/IYobitAPI.java
 create mode 100644 server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/yobit/YobitRateSource.java
 create mode 100644 server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/yobit/dto/Ticker.java
 create mode 100644 server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/yobit/dto/YobitResponse.java
 create mode 100644 server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/wallets/futurocoind/FuturocoinRPCWallet.java
 create mode 100644 server_extensions_extra/src/main/resources/fto.png

diff --git a/server_extensions_api/src/main/java/com/generalbytes/batm/server/extensions/ICurrencies.java b/server_extensions_api/src/main/java/com/generalbytes/batm/server/extensions/ICurrencies.java
index 0548431..f4b8439 100644
--- a/server_extensions_api/src/main/java/com/generalbytes/batm/server/extensions/ICurrencies.java
+++ b/server_extensions_api/src/main/java/com/generalbytes/batm/server/extensions/ICurrencies.java
@@ -29,6 +29,7 @@ public interface ICurrencies {
     public static final String DASH = "DASH";
     public static final String DOGE = "DOGE";
     public static final String FLASH = "FLASH";// FLASH Coin
+    public static final String FTO = "FTO";
     public static final String MAX = "MAX";
     public static final String LEO = "LEO";
     public static final String NLG = "NLG";
diff --git a/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/FuturocoinAddressValidator.java b/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/FuturocoinAddressValidator.java
new file mode 100644
index 0000000..bf270d5
--- /dev/null
+++ b/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/FuturocoinAddressValidator.java
@@ -0,0 +1,34 @@
+package com.generalbytes.batm.server.extensions.extra.futurocoin;
+
+import com.generalbytes.batm.server.coinutil.AddressFormatException;
+import com.generalbytes.batm.server.coinutil.Base58;
+import com.generalbytes.batm.server.extensions.ICryptoAddressValidator;
+
+public class FuturocoinAddressValidator implements ICryptoAddressValidator {
+
+    @Override
+    public boolean isAddressValid(String address) {
+        if (address.startsWith("F") || address.startsWith("6")) {
+            try {
+                Base58.decodeToBigInteger(address);
+                Base58.decodeChecked(address);
+            } catch (AddressFormatException e) {
+                e.printStackTrace();
+                return false;
+            }
+            return true;
+        }else{
+            return false;
+        }
+    }
+
+    @Override
+    public boolean mustBeBase58Address() {
+        return true;
+    }
+
+    @Override
+    public boolean isPaperWalletSupported() {
+        return false;
+    }
+}
diff --git a/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/FuturocoinExtension.java b/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/FuturocoinExtension.java
new file mode 100644
index 0000000..df9c5be
--- /dev/null
+++ b/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/FuturocoinExtension.java
@@ -0,0 +1,133 @@
+/*************************************************************************************
+ * Copyright (C) 2014-2016 GENERAL BYTES s.r.o. All rights reserved.
+ *
+ * This software may be distributed and modified under the terms of the GNU
+ * General Public License version 2 (GPL2) as published by the Free Software
+ * Foundation and appearing in the file GPL2.TXT included in the packaging of
+ * this file. Please note that GPL2 Section 2[b] requires that all works based
+ * on this software must also be made publicly available under the terms of
+ * the GPL2 ("Copyleft").
+ *
+ * Contact information
+ * -------------------
+ *
+ * GENERAL BYTES s.r.o.
+ * Web      :  http://www.generalbytes.com
+ *
+ ************************************************************************************/
+package com.generalbytes.batm.server.extensions.extra.futurocoin;
+
+import com.generalbytes.batm.server.extensions.*;
+import com.generalbytes.batm.server.extensions.extra.futurocoin.sources.FixPriceRateSource;
+import com.generalbytes.batm.server.extensions.extra.futurocoin.sources.yobit.YobitRateSource;
+import com.generalbytes.batm.server.extensions.extra.futurocoin.wallets.futurocoind.FuturocoinRPCWallet;
+import com.generalbytes.batm.server.extensions.watchlist.IWatchList;
+
+import java.math.BigDecimal;
+import java.util.HashSet;
+import java.util.Set;
+import java.util.StringTokenizer;
+
+//import com.generalbytes.batm.server.extensions.extra.dogecoin.sources.chainso.ChainSoRateSource;
+//import com.generalbytes.batm.server.extensions.extra.dogecoin.wallets.blockio.BlockIOWallet;
+
+public class FuturocoinExtension implements IExtension{
+    @Override
+    public String getName() {
+        return "BATM Futurocoin extra extension";
+    }
+
+    @Override
+    public IExchange createExchange(String exchangeLogin) {
+        return null;
+    }
+
+    @Override
+    public IPaymentProcessor createPaymentProcessor(String paymentProcessorLogin) {
+        return null; //no payment processors available
+    }
+
+    @Override
+    public IWallet createWallet(String walletLogin) {
+        if (walletLogin !=null && !walletLogin.trim().isEmpty()) {
+            StringTokenizer st = new StringTokenizer(walletLogin,":");
+            String walletType = st.nextToken();
+
+            if ("futurocoind".equalsIgnoreCase(walletType)) {
+                String protocol = st.nextToken();
+                String username = st.nextToken();
+                String password = st.nextToken();
+                String hostname = st.nextToken();
+                String port = st.nextToken();
+                String accountName ="";
+                if (st.hasMoreTokens()) {
+                    accountName = st.nextToken();
+                }
+
+
+                if (protocol != null && username != null && password != null && hostname !=null && port != null && accountName != null) {
+                    String rpcURL = protocol +"://" + username +":" + password + "@" + hostname +":" + port;
+                    return new FuturocoinRPCWallet(rpcURL,accountName);
+                }
+            }
+
+        }
+        return null;
+    }
+
+    @Override
+    public ICryptoAddressValidator createAddressValidator(String cryptoCurrency) {
+        if (ICurrencies.FTO.equalsIgnoreCase(cryptoCurrency)) {
+            return new FuturocoinAddressValidator();
+        }
+        return null;
+    }
+
+    @Override
+    public IPaperWalletGenerator createPaperWalletGenerator(String cryptoCurrency) {
+        return null;
+    }
+
+    @Override
+    public IRateSource createRateSource(String sourceLogin) {
+        if (sourceLogin != null && !sourceLogin.trim().isEmpty()) {
+            StringTokenizer st = new StringTokenizer(sourceLogin, ":");
+            String exchangeType = st.nextToken();
+
+            if ("futurocoinfix".equalsIgnoreCase(exchangeType)) {
+                BigDecimal rate = BigDecimal.ZERO;
+                if (st.hasMoreTokens()) {
+                    try {
+                        rate = new BigDecimal(st.nextToken());
+                    } catch (Throwable e) {
+                    }
+                }
+                String preferedFiatCurrency = ICurrencies.USD;
+                if (st.hasMoreTokens()) {
+                    preferedFiatCurrency = st.nextToken().toUpperCase();
+                }
+                return new FixPriceRateSource(rate, preferedFiatCurrency);
+            } else if ("yobit".equalsIgnoreCase(exchangeType)) {
+                return new YobitRateSource();
+            }
+        }
+        return null;
+    }
+
+    @Override
+    public Set<String> getSupportedCryptoCurrencies() {
+        Set<String> result = new HashSet<String>();
+        result.add(ICurrencies.FTO);
+        return result;
+    }
+
+    @Override
+    public Set<String> getSupportedWatchListsNames() {
+        return null;
+    }
+
+    @Override
+    public IWatchList getWatchList(String name) {
+        return null;
+    }
+}
diff --git a/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/FixPriceRateSource.java b/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/FixPriceRateSource.java
new file mode 100644
index 0000000..849909f
--- /dev/null
+++ b/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/FixPriceRateSource.java
@@ -0,0 +1,50 @@
+package com.generalbytes.batm.server.extensions.extra.futurocoin.sources;
+
+import com.generalbytes.batm.server.extensions.ICurrencies;
+import com.generalbytes.batm.server.extensions.IRateSource;
+
+import java.math.BigDecimal;
+import java.util.HashSet;
+import java.util.Set;
+
+/**
+ * Created by woolly_sammoth on 11/12/14.
+ */
+public class FixPriceRateSource implements IRateSource {
+    private BigDecimal rate = BigDecimal.ZERO;
+
+    private String preferedFiatCurrency = ICurrencies.USD;
+
+    public FixPriceRateSource(BigDecimal rate, String preferedFiatCurrency) {
+        this.rate = rate;
+        if (ICurrencies.USD.equalsIgnoreCase(preferedFiatCurrency)) {
+            this.preferedFiatCurrency = ICurrencies.USD;
+        }
+    }
+
+    @Override
+    public Set<String> getCryptoCurrencies() {
+        Set<String> result = new HashSet<String>();
+        result.add(ICurrencies.FTO);
+        return result;
+    }
+
+    @Override
+    public BigDecimal getExchangeRateLast(String cryptoCurrency, String fiatCurrency) {
+        if (ICurrencies.FTO.equalsIgnoreCase(cryptoCurrency)) {
+            return rate;
+        }
+        return null;
+    }
+
+    @Override
+    public Set<String> getFiatCurrencies() {
+        Set<String> result = new HashSet<String>();
+        result.add(ICurrencies.USD);
+        return result;
+    }
+    @Override
+    public String getPreferredFiatCurrency() {
+        return preferedFiatCurrency;
+    }
+}
diff --git a/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/yobit/IYobitAPI.java b/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/yobit/IYobitAPI.java
new file mode 100644
index 0000000..731fcfd
--- /dev/null
+++ b/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/yobit/IYobitAPI.java
@@ -0,0 +1,18 @@
+package com.generalbytes.batm.server.extensions.extra.futurocoin.sources.yobit;
+
+import com.generalbytes.batm.server.extensions.extra.futurocoin.sources.yobit.dto.Ticker;
+import com.generalbytes.batm.server.extensions.extra.futurocoin.sources.yobit.dto.YobitResponse;
+
+import javax.ws.rs.GET;
+import javax.ws.rs.Path;
+import javax.ws.rs.PathParam;
+import javax.ws.rs.Produces;
+import javax.ws.rs.core.MediaType;
+
+@Path("/api/3/")
+@Produces(MediaType.APPLICATION_JSON)
+public interface IYobitAPI {
+    @GET
+    @Path("ticker/{cryptocurrency}_{fiatcurrency}")
+    YobitResponse getTicker(@PathParam("cryptocurrency") String cryptoCurrency, @PathParam("fiatcurrency") String fiatCurrency);
+}
\ No newline at end of file
diff --git a/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/yobit/YobitRateSource.java b/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/yobit/YobitRateSource.java
new file mode 100644
index 0000000..31a2542
--- /dev/null
+++ b/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/yobit/YobitRateSource.java
@@ -0,0 +1,49 @@
+package com.generalbytes.batm.server.extensions.extra.futurocoin.sources.yobit;
+
+import com.generalbytes.batm.server.extensions.ICurrencies;
+import com.generalbytes.batm.server.extensions.IRateSource;
+import com.generalbytes.batm.server.extensions.extra.bitcoin.sources.bity.IBity;
+import com.generalbytes.batm.server.extensions.extra.futurocoin.sources.yobit.dto.Ticker;
+import com.generalbytes.batm.server.extensions.extra.futurocoin.sources.yobit.dto.YobitResponse;
+
+import java.math.BigDecimal;
+import java.util.HashSet;
+import java.util.Set;
+
+public class YobitRateSource implements IRateSource {
+
+    private IYobitAPI api;
+
+    public YobitRateSource() {
+        api = RestProxyFactory.createProxy(IBity.class, "https://yobit.net");
+    }
+
+    @Override
+    public Set<String> getCryptoCurrencies() {
+        Set<String> result = new HashSet<String>();
+        result.add(ICurrencies.FTO);
+        return result;
+    }
+
+    @Override
+    public Set<String> getFiatCurrencies() {
+        Set<String> result = new HashSet<String>();
+        result.add(ICurrencies.USD);
+        return result;
+    }
+
+    @Override
+    public BigDecimal getExchangeRateLast(String cryptoCurrency, String fiatCurrency) {
+        if (!getFiatCurrencies().contains(fiatCurrency) || !getCryptoCurrencies().contains(cryptoCurrency)) {
+            return null;
+        }
+
+        YobitResponse response = api.getTicker(cryptoCurrency.toLowerCase(), fiatCurrency.toLowerCase());
+        return response.getFot_usd().getLast();
+    }
+
+    @Override
+    public String getPreferredFiatCurrency() {
+        return ICurrencies.USD;
+    }
+}
diff --git a/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/yobit/dto/Ticker.java b/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/yobit/dto/Ticker.java
new file mode 100644
index 0000000..f9579ab
--- /dev/null
+++ b/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/yobit/dto/Ticker.java
@@ -0,0 +1,87 @@
+package com.generalbytes.batm.server.extensions.extra.futurocoin.sources.yobit.dto;
+
+import java.math.BigDecimal;
+
+public class Ticker {
+    private BigDecimal high;
+    private BigDecimal low;
+    private BigDecimal avg;
+    private BigDecimal vol;
+    private BigDecimal vol_cur;
+    private BigDecimal last;
+    private BigDecimal buy;
+    private BigDecimal sell;
+    private long updated;
+
+    public BigDecimal getHigh() {
+        return high;
+    }
+
+    public void setHigh(BigDecimal high) {
+        this.high = high;
+    }
+
+    public BigDecimal getLow() {
+        return low;
+    }
+
+    public void setLow(BigDecimal low) {
+        this.low = low;
+    }
+
+    public BigDecimal getAvg() {
+        return avg;
+    }
+
+    public void setAvg(BigDecimal avg) {
+        this.avg = avg;
+    }
+
+    public BigDecimal getVol() {
+        return vol;
+    }
+
+    public void setVol(BigDecimal vol) {
+        this.vol = vol;
+    }
+
+    public BigDecimal getVol_cur() {
+        return vol_cur;
+    }
+
+    public void setVol_cur(BigDecimal vol_cur) {
+        this.vol_cur = vol_cur;
+    }
+
+    public BigDecimal getLast() {
+        return last;
+    }
+
+    public void setLast(BigDecimal last) {
+        this.last = last;
+    }
+
+    public BigDecimal getBuy() {
+        return buy;
+    }
+
+    public void setBuy(BigDecimal buy) {
+        this.buy = buy;
+    }
+
+    public BigDecimal getSell() {
+        return sell;
+    }
+
+    public void setSell(BigDecimal sell) {
+        this.sell = sell;
+    }
+
+    public long getUpdated() {
+        return updated;
+    }
+
+    public void setUpdated(long updated) {
+        this.updated = updated;
+    }
+}
diff --git a/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/yobit/dto/YobitResponse.java b/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/yobit/dto/YobitResponse.java
new file mode 100644
index 0000000..642a8e3
--- /dev/null
+++ b/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/sources/yobit/dto/YobitResponse.java
@@ -0,0 +1,13 @@
+package com.generalbytes.batm.server.extensions.extra.futurocoin.sources.yobit.dto;
+
+public class YobitResponse {
+    private Ticker fot_usd;
+
+    public Ticker getFot_usd() {
+        return fot_usd;
+    }
+
+    public void setFot_usd(Ticker fot_usd) {
+        this.fot_usd = fot_usd;
+    }
+}
diff --git a/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/wallets/futurocoind/FuturocoinRPCWallet.java b/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/wallets/futurocoind/FuturocoinRPCWallet.java
new file mode 100644
index 0000000..29b71c8
--- /dev/null
+++ b/server_extensions_extra/src/main/java/com/generalbytes/batm/server/extensions/extra/futurocoin/wallets/futurocoind/FuturocoinRPCWallet.java
@@ -0,0 +1,100 @@
+package com.generalbytes.batm.server.extensions.extra.futurocoin.wallets.futurocoind;
+
+import com.azazar.bitcoin.jsonrpcclient.BitcoinException;
+import com.azazar.bitcoin.jsonrpcclient.BitcoinJSONRPCClient;
+import com.generalbytes.batm.server.extensions.ICurrencies;
+import com.generalbytes.batm.server.extensions.IWallet;
+import java.math.BigDecimal;
+import java.net.MalformedURLException;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
+
+public class FuturocoinRPCWallet implements IWallet {
+
+    private static final Logger log = LoggerFactory.getLogger(FuturocoinRPCWallet.class);
+    private static final String CRYPTO_CURRENCY = ICurrencies.FTO;
+
+    public FuturocoinRPCWallet(String rpcURL, String accountName) {
+        this.rpcURL = rpcURL;
+        this.accountName = accountName;
+    }
+
+    private String rpcURL;
+    private String accountName;
+
+    @Override
+    public Set<String> getCryptoCurrencies() {
+        Set<String> result = new HashSet<String>();
+        result.add(CRYPTO_CURRENCY);
+        return result;
+
+    }
+
+    @Override
+    public String getPreferredCryptoCurrency() {
+        return CRYPTO_CURRENCY;
+    }
+
+    @Override
+    public String sendCoins(String destinationAddress, BigDecimal amount, String cryptoCurrency, String description) {
+        if (!CRYPTO_CURRENCY.equalsIgnoreCase(cryptoCurrency)) {
+            log.error("Futurocoind wallet error: unknown cryptocurrency.");
+            return null;
+        }
+
+        log.info("Futurocoind sending coins from " + accountName + " to: " + destinationAddress + " " + amount);
+        try {
+            String result = getClient(rpcURL).sendFrom(accountName, destinationAddress,amount.doubleValue());
+            log.debug("result = " + result);
+            return result;
+        } catch (BitcoinException e) {
+            e.printStackTrace();
+            return null;
+        }
+    }
+
+    @Override
+    public String getCryptoAddress(String cryptoCurrency) {
+        if (!CRYPTO_CURRENCY.equalsIgnoreCase(cryptoCurrency)) {
+            log.error("Futurocoind wallet error: unknown cryptocurrency.");
+            return null;
+        }
+
+        try {
+            List<String> addressesByAccount = getClient(rpcURL).getAddressesByAccount(accountName);
+            if (addressesByAccount == null || addressesByAccount.size() == 0) {
+                return null;
+            }else{
+                return addressesByAccount.get(0);
+            }
+        } catch (BitcoinException e) {
+            e.printStackTrace();
+            return null;
+        }
+    }
+
+    @Override
+    public BigDecimal getCryptoBalance(String cryptoCurrency) {
+        if (!CRYPTO_CURRENCY.equalsIgnoreCase(cryptoCurrency)) {
+            log.error("Futurocoind wallet error: unknown cryptocurrency: " + cryptoCurrency);
+            return null;
+        }
+        try {
+            double balance = getClient(rpcURL).getBalance(accountName);
+            return BigDecimal.valueOf(balance);
+        } catch (BitcoinException e) {
+            e.printStackTrace();
+            return null;
+        }
+    }
+
+    private BitcoinJSONRPCClient getClient(String rpcURL) {
+        try {
+            return new BitcoinJSONRPCClient(rpcURL);
+        } catch (MalformedURLException e) {
+            e.printStackTrace();
+        }
+        return null;
+    }
+}
diff --git a/server_extensions_extra/src/main/resources/fto.png b/server_extensions_extra/src/main/resources/fto.png
new file mode 100644
index 0000000000000000000000000000000000000000..350b38ac9e76810e6a85498c67957904b55ef064
GIT binary patch
literal 22187
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
Pp+#K2XsA=5WfS;+NDw)Y

literal 0
HcmV?d00001