@rabbitio/ui-kit 1.0.0-beta.10 → 1.0.0-beta.11

package/src/swaps-lib/external-apis/swapProvider.js

@@ -0,0 +1,169 @@
+export class SwapProvider {
+    static COMMON_ERRORS = {
+        REQUESTS_LIMIT_EXCEEDED: "requestsLimitExceeded",
+    };
+
+    static NO_SWAPS_REASONS = {
+        TOO_LOW: "tooLow",
+        TOO_HIGH: "tooHigh",
+        NOT_SUPPORTED: "notSupported",
+    };
+
+    static CREATION_FAIL_REASONS = {
+        RETRIABLE_FAIL: "retriableFail",
+    };
+
+    static SWAP_STATUSES = {
+        WAITING_FOR_PAYMENT: "waiting_for_payment", // public +
+        CONFIRMING: "confirming",
+        PAYMENT_RECEIVED: "payment_received", // public +
+        EXCHANGING: "exchanging", // session full // public +
+        COMPLETED: "completed", // session full  // public +
+        REFUNDED: "refunded", // session full  // public +
+        EXPIRED: "expired", // public +
+        FAILED: "failed", // public +
+    };
+
+    /**
+     * @return {Promise<void>}
+     */
+    async initialize() {
+        throw new Error("Not implemented in base");
+    }
+
+    /**
+     * @return {number} milliseconds TTL
+     */
+    getSwapCreationInfoTtlMs() {
+        throw new Error("Not implemented in base");
+    }
+
+    /**
+     * Retrieves all deposit currencies supported by this swap provider.
+     * Returns one of SwapProvider.COMMON_ERRORS in case of processable fail.
+     *
+     * @return {Promise<({ result: true, coins: Coin[] }|{ result: false, reason: string })>}
+     */
+    async getDepositCurrencies() {
+        throw new Error("Not implemented in base");
+    }
+
+    /**
+     * Retrieves all withdrawable currencies supported by this swap provider.
+     * Returns one of SwapProvider.COMMON_ERRORS in case of processable fail.
+     *
+     * @param [exceptCurrency=null] {Coin|null}
+     * @return {Promise<({ result: true, coins: Coin[] }|{ result: false, reason: string })>}
+     */
+    async getWithdrawalCurrencies(exceptCurrency = null) {
+        throw new Error("Not implemented in base");
+    }
+
+    /**
+     * Retrieves URL for coin icon or fallback if not found.
+     *
+     * @param coin {Coin|string} coin or rabbit-format of coin ticker
+     * @return {string}
+     */
+    getIconUrl(coin) {
+        throw new Error("Not implemented in base");
+    }
+
+    /**
+     * Retrieves coin to USDT rate.
+     *
+     * @param coin {Coin}
+     * @return {{result: true, rate: string}|{result: false}}
+     */
+    async getCoinToUSDTRate(coin) {
+        throw new Error("Not implemented in base");
+    }
+
+    /**
+     * Retrieves estimation for swapping giving coins amount.
+     * null min or max signals there is no corresponding limitation. undefined means that the limits were not retrieved.
+     * For fail result on of SwapProvider.NO_SWAPS_REASONS or SwapProvider.COMMON_ERRORS reasons will be returned.
+     *
+     * @param fromCoin {Coin}
+     * @param toCoin {Coin}
+     * @param amountCoins {string}
+     * @param [fromCoinToUsdRate=null] pass if you want to increase the min amount returned
+     *        by provider with some fixed "insurance" amount to cover min amount fluctuations.
+     * @return {Promise<({
+     *            result: false,
+     *            reason: string,
+     *            smallestMin: (string|null|undefined),
+     *            greatestMax: (string|null|undefined),
+     *         }|{
+     *            result: true,
+     *            min: (string|null),
+     *            max: (string|null),
+     *            smallestMin: (string|null),
+     *            greatestMax: (string|null),
+     *            rate: (string|null),
+     *            durationMinutesRange: string,
+     *            [rawSwapData]: Object
+     *         })>}
+     */
+    async getSwapInfo(fromCoin, toCoin, amountCoins, fromCoinToUsdRate = null) {
+        throw new Error("Not implemented in base");
+    }
+
+    /**
+     * For fail result we return one of SwapProvider.CREATION_FAIL_REASONS or SwapProvider.COMMON_ERRORS.
+     *
+     * @param fromCoin {Coin}
+     * @param toCoin {Coin}
+     * @param amount {string}
+     * @param toAddress {string}
+     * @param refundAddress {string}
+     * @param rawSwapData {Object|null}
+     * @param clientIpAddress {string}
+     * @return {Promise<({
+     *                     result: true,
+     *                     swapId: string,
+     *                     fromCoin: Coin,
+     *                     fromAmount: string,
+     *                     fromAddress: string,
+     *                     toCoin: Coin,
+     *                     toAmount: string,
+     *                     toAddress: string,
+     *                     rate: string
+     *                 }|{
+     *                     result: false,
+     *                     reason: string,
+     *                     partner: string
+     *                 })>}
+     */
+    async createSwap(fromCoin, toCoin, amount, toAddress, refundAddress, rawSwapData = null, clientIpAddress) {
+        throw new Error("Not implemented in base");
+    }
+
+    /**
+     * Retrieves details and status for swaps by given ids.
+     * If some swap is not found by id then there is no item in return list.
+     *
+     * @param swapIds {string[]}
+     * @return {Promise<{result: false, reason: string}|{result:true, swaps: ExistingSwap[]}>}
+     */
+    async getExistingSwapsDetailsAndStatus(swapIds) {
+        throw new Error("Not implemented in base");
+    }
+
+    /**
+     * @param ticker {string}
+     * @return {Coin|null}
+     */
+    getCoinByTickerIfPresent(ticker) {
+        throw new Error("Not implemented in base");
+    }
+
+    /**
+     * @param asset {Coin}
+     * @param address {string}
+     * @return {boolean}
+     */
+    isAddressValidForAsset(asset, address) {
+        throw new Error("Not implemented in base");
+    }
+}

package/src/swaps-lib/models/existingSwap.js

@@ -0,0 +1,58 @@
+export class ExistingSwap {
+    /**
+     * @param swapId {string}
+     * @param status {SwapProvider.SWAP_STATUSES}
+     * @param createdAt {number}
+     * @param expiresAt {number}
+     * @param confirmations {number}
+     * @param rate {string}
+     * @param refundAddress {string}
+     * @param fromCoin {Coin}
+     * @param fromAmount {string}
+     * @param fromTransactionId {string}
+     * @param toCoin {Coin}
+     * @param toAmount {string}
+     * @param toTransactionId {string|null}
+     * @param toAddress {string}
+     * @param partner {string}
+     */
+    constructor(
+        swapId,
+        status,
+        createdAt,
+        expiresAt,
+        confirmations,
+        rate,
+        refundAddress,
+        payToAddress,
+        fromCoin,
+        fromAmount,
+        fromTransactionId,
+        fromTransactionLink,
+        toCoin,
+        toAmount,
+        toTransactionId,
+        toTransactionLink,
+        toAddress, // TODO: [refactoring, moderate] toAddress is not quite clear. How about recipientAddress? task_id=0815a111c99543b78d374217eadbde4f
+        partner
+    ) {
+        this.swapId = swapId;
+        this.status = status;
+        this.createdAt = createdAt;
+        this.expiresAt = expiresAt;
+        this.confirmations = confirmations;
+        this.rate = rate;
+        this.refundAddress = refundAddress;
+        this.payToAddress = payToAddress;
+        this.fromCoin = fromCoin;
+        this.fromTransactionId = fromTransactionId;
+        this.fromAmount = fromAmount;
+        this.fromTransactionLink = fromTransactionLink;
+        this.toCoin = toCoin;
+        this.toTransactionId = toTransactionId;
+        this.toTransactionLink = toTransactionLink;
+        this.toAmount = toAmount;
+        this.toAddress = toAddress;
+        this.partner = partner;
+    }
+}